接 BigCommerce:拉订单进来,推履约出去
从 BigCommerce 设置 → API 复制 Store hash 和 Access Token,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。
BigCommerce 连接器把您 BigCommerce 店铺的订单拉进 OMS,再把履约推回 BigCommerce;还能把产品和库存更新推出去,让两边的订单、发货与库存保持同步。
前置条件#
- 一个 BigCommerce 店铺,且能进该店铺的 设置 → API。
- 有在 BigCommerce → 设置 → API 里创建 API 账号的权限。
- API 账号必须授予 Orders、Products、Inventory 权限——没有这些权限,连接器拉不到订单,也推不了产品与库存更新。
拿凭证#
- 在 BigCommerce 里去 设置 → API,创建一个 API 账号。
- 创建账号时确认包含 Orders、Products、Inventory 三个权限——连接器三个都需要。
- 复制该 API 账号的 Access Token 并妥善保存——下一步要把它粘进 Integration。
- 在该 API 账号的 API 路径里找到 Store hash。路径形如 https://api.bigcommerce.com/stores/abc123def/v3——/stores/ 后面的部分就是 Store hash,本例中是 abc123def。只复制这一部分。
填进 Integration#
- 打开 Integration → 连接器市场 → BigCommerce → 新建连接。
- Store hash:只粘贴 API 路径里的 store hash,例如 abc123def。不要粘贴完整网址——这个字段只填 hash 本身,它决定这个连接属于哪个店铺。
- Access token:粘贴您从 BigCommerce → 设置 → API 的 API 账号复制的 Access Token。两个字段都必填。Token 加密存储,永不回显。
测试连接#
点测试连接。测试会用您填的 Store hash 和 Access Token 去访问您的 BigCommerce 店铺,确认凭证可用。通过说明店铺找对了、Token 也被接受。失败时先记下报错、对照下面的常见问题排查,再改其他设置。
配 Mapping / 选模板#
选 BigCommerce 标准模板。它在 BigCommerce 与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态。激活前先看映射预览,重点确认每个 BigCommerce SKU 都配到了正确的 OMS 产品。
激活#
激活后,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 店铺里下一单(或等下一笔客户订单),然后手动拉一次并看 运行监控 / 日志。店铺出单后,新订单就会出现。