BigSeller API对接指南

一、作用

API可以让现有业务数据进入你需要的系统和工作流程。

• 链接系统、减少重复整理

通过程序获取业务数据，按目标系统要求整理与映射

• 协同业务、衔接订单与库存

围绕订单传入、库存查询等需求设计业务闭环

• 支持分析、构建自己的报表

结合BI或智能体、生成适合团队的经营分析
 

二、什么是API

API 是让外部程序按约定访问业务能力和数据的接口。适合希望将 BigSeller 与财务软件、品牌自有网站、自建系统、数据看板或 AI 智能体连接起来的客户。

如果只是偶尔查看数据，可以先评估现有功能与导出方式；如果需要持续同步、跨系统处理或定时分析，再考虑 API 对接。
 

三、场景与应用案例

3.1 案例一：网站协同

品牌自有网站：衔接订单处理与可售库存
可参考：BigSeller与自建站对接流程

常见需求

• 品牌网站产生订单，希望在BigSeller统一处理，同时让网站获得约定仓库的可售库存

示例

• 消费者在网站下单后，对接程序校验商品和订单信息，再传入 BigSeller；网站按约定频次查询库存，结合安全库存规则调整展示数量。

接入前确认

• 订单写入接口权限
• SKU与仓库映射
• 重复订单识别
• 取消退款流程
• 库存锁扣/释放触发规则

验收重点

• 同一订单重复提交不会重复建单；无效 SKU 可定位；库存异常能报警。库存锁定、发货及状态回传以实际接口和业务规则为准；定时同步仍可能有延迟，不能保证零超卖。

 

3.2 案例二：财务协同

金蝶系统对接：把业务数据整理为财务可用的数据

常见需求

• 运营数据在 BigSeller，记账和财务分析在金蝶，希望减少人工导出、清洗和重复录入。

示例

• 每天获取约定范围内的订单、账单与钱包数据，按店铺、币种和业务日期整理，生成待核对的数据清单与差异表。

接入前确认

• 金蝶版本与开发能力
• 单据类型
• 科目映射
• 币种汇率
• 退款与费用口径
• 销售额、回库与利润分别定义，不能直接混用

验收重点

• 来源记录可追溯，金额与笔数能核对，重复运行不重复生成单据。如需 SKU 级应收数据，请先向客服确认是否已开放及适用范围。

 

3.3 案例三：智能体分析

经营分析助手：从提问到可追溯的日报

智能体对接

• 目前可通过 Codex、WorkBuddy、Claude、豆包等 AI 工具与智能体对接 BigSeller 业务数据，辅助生成经营分析与报表。对于支持 MCP 的工具，我们同时推荐通过 MCP 接入，让智能体按需获取业务数据；具体接入方式以所选工具的接口调用能力与运行环境为准。了解 MCP 的接入方式与操作步骤，请查看“MCP对接”

常见需求

• 负责人希望每天了解订单变化、重点店铺表现和库存风险，而不是反复整理多个表格

示例

• 每天汇总昨日订单，按店铺与币种比较近期表现，列出订单量变化较大的店铺；结合可用库存和销量数据，形成需关注的 SKU 清单。

接入前确认

• 可用字段
• 统计时区
• 订单状态
• 币种
• 退款处理
• 接收渠道
• 分析平台的数据使用范围

验收重点

• 数字由程序计算，报告注明数据时间和口径；拉取失败时明确提示缺失，不把缺失解释成零销售。自动分享到群需要额外配置消息渠道和权限。

 

四、如何申请与开通

从需求确认到正式开通，对接分为以下五个阶段。

• 第一步：确认需求

接口类型、字段数量、调用频次与业务目标。

• 第二步：提交账号信息

提供 您的BigSeller 账号，由对接方按流程生成 APP 密钥。

• 第三步：交付对接文档

取得账号对应的 API 文档，交给实施团队。

• 第四步：测试流程

按文档联调、连续运行，并核对数据与稳定性。

• 第五步：确认并付款

确认操作无问题后，按约定付款并办理后续开通。

 

五、价格与对接咨询

如需了解 API 对接业务，请直接联系您的 BigSeller 客户经理或官方客服
说明希望对接的系统、业务场景和所需数据
可提供具体需要对接的信息给客服人员，会根据您的需求定制接口，最终价格、币种、税费、套餐内容和有效期以正式报价为准。

您也可以通过飞书链接查看我们支持的 API 详情
BigSeller API
 

六、常见问题

Q1. 第一次咨询，需要准备哪些信息？

• 业务目标：要解决什么问题、希望得到什么结果。
• 数据范围：店铺、仓库、订单状态、历史时间和必需字段。
• 数据方向：只读取，还是需要传入订单或其他写入操作。
• 同步规模：每日数据量、执行频次、允许的延迟与峰值需求。
• 项目安排：技术联系人、期望上线时间、试用验收标准。

可直接将以上信息告知 BigSeller 客户经理或官方客服，协助评估对接方案。

Q2. 提供 BigSeller 账号时，需要提交登录密码吗？
申请对接时，需提供用于识别开通对象的 BigSeller 账号信息。普通咨询材料中不要填写登录密码、验证码或 APP 密钥。账号识别信息与密钥交付方式，应由官方对接人员说明。
拿到密钥后，将其存入受控的服务端配置或密钥管理工具，不要放入客户端可访问的网页代码、公开仓库或群聊截图。

Q3. 从申请到正式使用，需要多长时间？
对接周期取决于接口范围、目标系统条件、字段映射复杂度与测试情况，具体时间将在需求评估后确认。只读报表与涉及订单写入、财务映射的项目，实施工作量通常不同。
需求确认后，建议共同约定文档交付、首次联调、试运行和验收四个时间节点。

Q4. 试用时，怎么判断已经“对接成功”？
不能只看单次请求成功。建议验证：必需字段齐全、分页数据完整、样本与 BigSeller 一致、重复执行不会产生重复记录、异常后能恢复、约定频次下持续稳定。
若涉及订单传入或财务单据，还应核对业务状态、金额口径、幂等去重和回执。试用期限、额度及测试范围需提前确认。