用户手册
帮助中心/用户手册/接 BigCommerce:拉订单进来,推履约出去

接 BigCommerce:拉订单进来,推履约出去

最后更新 2026-11-01

从 BigCommerce 设置 → API 复制 Store hash 和 Access Token,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。

BigCommerce 连接器把您 BigCommerce 店铺的订单拉进 OMS,再把履约推回 BigCommerce;还能把产品和库存更新推出去,让两边的订单、发货与库存保持同步。

BigCommerce 接入步骤:先拿凭证,再测试,再配 Mapping,最后激活。

前置条件#

  • 一个 BigCommerce 店铺,且能进该店铺的 设置 → API。
  • 有在 BigCommerce → 设置 → API 里创建 API 账号的权限。
  • API 账号必须授予 Orders、Products、Inventory 权限——没有这些权限,连接器拉不到订单,也推不了产品与库存更新。

拿凭证#

  1. 在 BigCommerce 里去 设置 → API,创建一个 API 账号。
  2. 创建账号时确认包含 Orders、Products、Inventory 三个权限——连接器三个都需要。
  3. 复制该 API 账号的 Access Token 并妥善保存——下一步要把它粘进 Integration。
  4. 在该 API 账号的 API 路径里找到 Store hash。路径形如 https://api.bigcommerce.com/stores/abc123def/v3——/stores/ 后面的部分就是 Store hash,本例中是 abc123def。只复制这一部分。

填进 Integration#

  1. 打开 Integration → 连接器市场 → BigCommerce → 新建连接。
  2. Store hash:只粘贴 API 路径里的 store hash,例如 abc123def。不要粘贴完整网址——这个字段只填 hash 本身,它决定这个连接属于哪个店铺。
  3. Access token:粘贴您从 BigCommerce → 设置 → API 的 API 账号复制的 Access Token。两个字段都必填。Token 加密存储,永不回显。

测试连接#

点测试连接。测试会用您填的 Store hash 和 Access Token 去访问您的 BigCommerce 店铺,确认凭证可用。通过说明店铺找对了、Token 也被接受。失败时先记下报错、对照下面的常见问题排查,再改其他设置。

配 Mapping / 选模板#

选 BigCommerce 标准模板。它在 BigCommerce 与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态。激活前先看映射预览,重点确认每个 BigCommerce SKU 都配到了正确的 OMS 产品。

BigCommerce 订单往返:订单进来,履约、产品和库存回去。

激活#

激活后,Integration 按您设的频率拉 BigCommerce 新订单,把带追踪号的履约推回 BigCommerce,并把产品和库存更新推出去。先在 运行监控 / 日志里盯几单,确认无误再放手跑。

常见问题#

测试失败:Token 不被接受

连接里的 Access Token 错了或已失效——比如复制不完整,或它所属的 API 账号已不是现在用的那个。BigCommerce 不认的 Token,每个请求都会在门口被挡下。

去 BigCommerce → 设置 → API,打开您的 API 账号,重新完整复制 Access Token,粘进连接的 Access token 字段。保存后重新测试。

同步被挡:API 账号缺权限

凭证能进店铺,但 API 账号没有拿到连接器需要的全部权限。没有 Orders 权限拉不了订单;没有 Products 或 Inventory,产品与库存更新推不出去。

去 BigCommerce → 设置 → API 检查 API 账号:确认 Orders、Products、Inventory 三个都在。如果新建了带齐权限的 API 账号,记得把它的 Access Token 也更新进连接。保存后重新测试。

测试找不到店铺

Store hash 字段填错了。最常见的是把完整 API 路径或完整网址粘进了字段,而不是只填 hash 本身;或者用了另一个店铺的 hash——不管哪种,连接指向的店铺都和您的 Token 对不上。

去 BigCommerce → 设置 → API,打开您的 API 账号,看它的 API 路径:只复制 /stores/ 后面的部分——例如 https://api.bigcommerce.com/stores/abc123def/v3 里的 abc123def。把连接里的 Store hash 换成这个值,保存后重新测试。

连接正常但没有订单进来

连接本身没问题——测试能通过——只是您的 BigCommerce 店铺还没有新订单,没东西可拉。

在您的 BigCommerce 店铺里下一单(或等下一笔客户订单),然后手动拉一次并看 运行监控 / 日志。店铺出单后,新订单就会出现。