教学中心 / 集成指南
连接 BigSeller（ERP）
BigSeller 是还没直连的店铺（Shopee、Lazada、TikTok Shop、Shopline、LINE MyShop……）的数据桥梁。接上后，SellerTiger 每天自动拉取 商品 → 库存 → 订单 → 结算（只读）。
能拿到什么
- 数据： 商品和图片、库存和每日库存快照、订单（按更新时间增量）、结算明细。覆盖 BigSeller 管理的所有店铺。
- 频率： 默认每天 06:00（曼谷时间），可在 数据中心 → 订单 → BigSeller 改成每小时 / 每周 / 关闭，或点 立即运行。
- 第一次： 拉最近 60 天，会比较慢（见下面的限流）。中途断了下次会接着跑。
- 锁定： BigSeller 连接期间，BigSeller 的手动导入被锁定（避免重复）；直连的店铺（如 Shopify）BigSeller 不再写入它的订单。
- SellerTiger 绝不修改 BigSeller 里的订单、库存或价格。
开始之前
- 谁来做： SellerTiger 里「设置」4 级权限的人（默认创始人）。
- BigSeller 的 API 是付费、需审批的服务。 BigSeller 没有可以自助开通的开放平台：要联系 BigSeller（你的客户经理或客服）申请「API 接入服务」。通过后，BigSeller 会发给你一份《API 接口说明文档》，开头的 接入凭证 里有 app_id 和 app_key。（2026-10-17 核对 BigSeller 官方博客：API 接入服务需要联系 BigSeller 申请。）
- 不要升级 BigSeller 套餐来「提速」。 BigSeller 接口是每个接口每秒 1 次，和套餐无关；SellerTiger 已经按这个速度自动排队。
- SellerTiger 必须用 https 地址打开（app.sellertiger.com），授权跳转才会成功。
第 1 步 · 凭证：把 app_id 和 app_key 填进 SellerTiger
- 找到 BigSeller 发来的 API 文档开头的 接入凭证：
app_id和app_key。 - SellerTiger → 设置 → 连接与授权 → 「ERP 与财务」→ BigSeller。
- 在 密钥 里：
- app_id → 填到
bigseller_app_key一栏 → 保存 - app_key（签名密钥）→ 填到
bigseller_app_secret一栏 → 保存 - 两栏不要填反。 保存后每行显示「已在这里填写」和打码的前后几位。
- app_id → 填到
- 点 测试连接：显示
keys saved — not authorized yet是正常的，下一步去授权。
第 2 步 · 加密 / Webhook：不需要
第 3 步 · 权限：由 BigSeller 按你申请的接入范围开通
如果某类数据（例如结算）一直为空，请让 BigSeller 确认你的 API 接入范围包含它。
第 4 步 · 回调：自动
回调地址 https://app.sellertiger.com/api/bigseller/callback 由 SellerTiger 自动带上，不需要在 BigSeller 填。
第 5 步 · 授权：去 BigSeller 同意
- 同一窗口往下到 BigSeller 授权与同步，点 去 BigSeller 授权。
- 在 BigSeller 页面登录并同意。自动回到 SellerTiger，提示授权成功。
- 授权链接 15 分钟内有效、只能用一次；超时就再点一次。
成功的样子：状态 已授权、「令牌有效至 X（自动续期）」，连接与授权里的 BigSeller 图标变成 已连接。令牌 7 天有效，剩不到 12 小时时自动续期，不用管。
第 6 步 · 开启同步
- 点 立即同步全部，提示「已开始同步（商品 → 库存 → 订单 → 结算）」。
- 进度和结果在 数据中心 → 订单 → BigSeller（ERP 过渡） 看：上次运行、记录数、近 7 天格子。
- 完成后看 订单 和 库存：订单带店铺和平台，库存数和 BigSeller 一致；业务总览的 GMV 不再是 0。
- 订单里出现「在订单里发现但未在品牌与渠道登记」的店铺时，点 去登记 把它加为销售渠道。
为什么第一次很慢
BigSeller 每个接口每秒只能调 1 次。SellerTiger 每次调用间隔 1 秒多、按顺序跑，遇到「请求太频繁」会自动等一会再试（最多 4 次）。60 天约 6,000 单的结算明细大约要十几分钟。之后每天的增量很小。这不是套餐问题，升级 BigSeller 套餐也不会变快。
没有 API 时：用 BigSeller 导出文件
在申请 API 期间，可以从 BigSeller 导出文件再导入：数据中心 → 订单 → BigSeller → 自己上传 → 订单（BigSeller：订单 → 订单处理 → 导出 → 按 SKU 导出）、库存、商品 SKU、停售清单、结算明细。API 接上后导入会被锁定，创始人可以补导 API 接入前的历史。
解除授权
窗口里点 解除授权，确认「解除后 BigSeller 不再自动同步，导入恢复可用」。已同步的数据保留。
常见问题
| 你看到的提示 / 错误码 | 原因 | 怎么办 |
|---|---|---|
| 测试显示 keys saved — not authorized yet | 密钥已保存，还没授权 | 点 去 BigSeller 授权 |
| 40101002（签名错误） | 两栏填反了，或复制时带了空格 | app_id 填 bigseller_app_key，app_key 填 bigseller_app_secret，重新保存 |
| 40101003（授权码无效） | 授权链接超过 15 分钟或用过了 | 再点 去 BigSeller 授权 |
| 40101005 / 40101009（令牌过期） | 令牌到期 | 会自动刷新；仍失败就重新授权 |
| 10100002 / 40101014（请求太频繁 / 系统忙） | BigSeller 每秒 1 次限流 | 不用处理，SellerTiger 会自动重试；第一次同步请耐心等 |
| BigSeller 登录失败，请检查账号后重新连接 | 授权回调失败 | 确认用的是有 API 权限的 BigSeller 主账号，重新授权 |
| 当前不是 https 地址，无法跳转授权 | 用 http 或本机地址打开 SellerTiger | 用 https://app.sellertiger.com 打开再授权 |
| 还没配置：请先填好凭证 | 没填密钥就点了授权 | 先完成第 1 步 |
| 这个来源已通过 API 自动同步，这段期间不能手动导入 | API 已连接，导入被锁 | 不用导入；历史由创始人用 补导 |
| 数据中心显示「连续失败 n 次」 | 授权过期或 BigSeller 接口报错 | 悬停看原因；重新授权后 立即运行 |
| 少了某家店铺的订单 | 店在 BigSeller 里没绑定，或这家店已直连 | 在 BigSeller 绑定；直连的店由直连提供订单 |
还需要帮助？
在 SellerTiger 中打开在 SellerTiger 里点右下角的耳机按钮，询问 AI 助手或提交工单。