跳转到主要内容

如何将 WooCommerce 库存与 Qashier 同步

通过QashierHQ开始进行Woocommerce的库存整合

WooCommerce 库存同步会把 Qashier 的库存项目与你 WooCommerce 店铺中的某个产品（或产品变体）关联起来，让 Qashier POS 和 QashierHQ 显示该项目在 WooCommerce 中的实时库存数量。本文介绍如何在 WooCommerce 中创建 API 密钥、在 QashierHQ 中连接密钥、关联产品、在 POS 上查看库存，以及取消关联产品。

想在你的 WooCommerce 网站上接受 QashierPay 付款？请参阅如何安装和设置 QashierPay WooCommerce 插件 [SG/MY]。

适用范围：所有 Qashier 市场 · QashierHQ 和 Qashier POS · WooCommerce 库存集成（视你所在市场和订阅计划，包含在计划中或作为增值功能提供；请在 QashierHQ 的 Qashier 商城中查看） · 店铺已开启库存管理。

开始之前

  • 启用集成。在 QashierHQ 中，从左侧菜单打开 Qashier 商城，打开 WooCommerce 库存集成，然后点击立即启用（或按照你的订阅计划显示的提示操作）。如果你的店铺已在使用 Shopify 库存同步，或以小数数量销售产品，点击立即启用后会打开与 Qashier 客服的聊天窗口，而不会开启集成。请发送该聊天消息，向客服寻求帮助。

  • 一家店铺只能与 Shopify 或 WooCommerce 其中之一同步库存，不能同时使用两者。

  • 店铺已开启库存管理，并且你要关联的每个产品都已在产品管理中勾选追踪库存。请参阅如何在 QashierHQ 中追踪库存。

  • 你需要拥有 WordPress / WooCommerce 网站的管理员权限。

  • 与 WooCommerce 同步库存的店铺无法使用连锁店之间的库存申请和调拨功能。

第 1 部分：在 WooCommerce 中创建 API 密钥

以下步骤在你的 WooCommerce 后台中进行，而不是在 Qashier 中。不同版本的 WooCommerce 按钮名称可能略有不同。

  1. 登录你的 WordPress 后台。

  2. 在左侧菜单中，点击 WooCommerce > Settings（设置）。

  3. 打开 Advanced（高级）标签页，然后打开 REST API。

  4. 点击 Add key（添加密钥）。
    ​

  5. 输入 Description（描述），例如“Qashier”。

  6. 在 User（用户）下，选择该密钥所属的 WordPress 用户（通常默认选中第一个用户）。

  7. 将 Permissions（权限）设为 Read/Write（读/写）。

  8. 点击 Generate API key（生成 API 密钥）。
    ​

  9. 复制 Consumer key 和 Consumer secret，并妥善保存。请像对待密码一样对待它们：不要分享，也不要发布它们的截图。第 2 部分需要用到这两项。

第 2 部分：在 QashierHQ 中连接 WooCommerce

  1. 登录 QashierHQ，点击右上角的设置齿轮图标。在手机上，点击右上角的账户图标，然后选择设置。

  2. 在 Integrations（集成）下，点击 WooCommerce API。只有在为某家店铺启用集成后，此项才会出现。

  3. 在 Store（店铺）下，选择要连接的店铺。

  4. 输入你的 Woocommerce Domain（Woocommerce 域名）：即包含 https:// 的完整店铺地址，例如 https://yourstore.com。

  5. 将密钥粘贴到 Woocommerce Consumer Key。

  6. 将 secret 粘贴到 Woocommerce Consumer Secret，并在 Confirm Woocommerce Consumer Secret（确认 Woocommerce Consumer Secret）中再粘贴一次。

  7. 点击 Submit（提交）。

你应该看到：提示信息“Successfully updated woocommerce settings”（已成功更新 woocommerce 设置）。如需日后更换密钥，请打开同一页面，勾选 Reset Consumer Key & Secret（重置 Consumer Key 和 Secret），输入新的 key 和 secret，然后点击 Submit。

第 3 部分：将 Qashier 产品与 WooCommerce 产品关联

  1. 在 QashierHQ 中，在产品与库存下，点击库存 / 原料。停留在库存标签页，并选择你已连接的店铺。

  2. 点击页面顶部的配置 Woocommerce 商品 ID。只有在所选店铺已保存第 2 部分的设置后，此按钮才会出现。

  3. 选择你要关联的 Qashier 产品。

  4. 在 WooCommerce 中找到该产品的 ID：打开 Products（产品），搜索该产品，将鼠标悬停在产品上即可看到“ID: …”。
    ​

  5. 回到 QashierHQ，在 Woocommerce 商品 ID 下输入该 ID，然后点击 GET PRODUCT DATA（获取产品数据）。
    ​

  6. 选择加载出来的产品。如果该 WooCommerce 产品有变体（例如尺码），请选择与此 Qashier 项目完全对应的变体。

  7. 点击 Confirm（确认）。
    ​

你应该看到：该 Qashier 产品已完成关联，并显示 WooCommerce 的实时库存数量。

警告：每个 WooCommerce 产品或变体只能关联一个 Qashier 库存项目。将一个 WooCommerce 产品关联到多个 Qashier 项目，会导致 WooCommerce 中的库存数量出错。

在 Qashier POS 上查看库存数量

  1. 在 POS 主画面上，点击库存管理。

  2. 列表会显示每个已关联项目的 WooCommerce Product Id（产品 ID）。

  3. 点击某个项目以加载其在 WooCommerce 中的实时库存，显示为“… 现货”。如果显示 N.A.，表示无法获取库存数量：请检查该项目是否已关联，以及终端是否在线。

取消关联 WooCommerce 产品

  1. 在 QashierHQ 中，在产品与库存下，点击库存 / 原料，然后点击已关联的项目。

  2. 在详情面板中，点击库存（Woocommerce）旁边的取消关联图标。其提示文字为取消关联 Woocommerce 商品。

  3. 在提示弹窗中，点击确认。

你应该看到：提示信息“Successfully unlinked … from Woocommerce”（已成功将 … 从 Woocommerce 取消关联）。该项目会恢复使用 Qashier 自身的库存数量。

同步的内容

对于每个已关联的项目，Qashier 会在 Qashier POS 和 QashierHQ 上显示 WooCommerce 中的实时库存数量。未关联的项目继续使用 Qashier 自身的库存数量。如需了解门店销售和库存操作如何影响 WooCommerce 中的数量，请联系 Qashier 客服。

如果出现问题

症状

可能原因

解决方法

点击 GET PRODUCT DATA 后显示“Product Not Found.”（找不到产品）

你输入的是 SKU，或 ID 有误

使用在 WooCommerce > Products 中将鼠标悬停在产品上时显示的数字产品 ID

没有配置 Woocommerce 商品 ID按钮

该店铺未保存第 2 部分的设置，或选中了其他店铺

选择已连接的店铺；在设置 > Integrations > WooCommerce API 中检查域名、key 和 secret

设置中没有 WooCommerce API 项

尚未为任何店铺启用该集成，或店铺正在使用 Shopify 同步

在 Qashier 商城中启用，或联系客服

商城打开了聊天窗口，而不是显示立即启用

店铺正在使用 Shopify 库存同步或小数产品数量

发送该聊天消息，向客服寻求帮助。一家店铺不能同时与 Shopify 和 WooCommerce 同步库存。

弹窗提示在 Woocommerce 中找不到该库存项目

已关联的产品或变体在 WooCommerce 中被删除

点击取消关联；在关联到新产品之前，该项目会使用 Qashier 的库存

POS 上显示 N.A.

终端离线，或该项目已不再关联

检查网络连接，以及 QashierHQ 中的关联情况

如果问题仍然存在，请联系 Qashier 客服。

相关文章

最后核实：2026年9月25日 · 适用市场：所有市场

这是否解答了您的问题？