英国 OnBuy 商城 API 对接需要准备什么

一、什么是英国 OnBuy 商城 API 对接

英国 OnBuy 商城 API 对接，是指卖家通过应用程序接口（Application Programming Interface），将自身的 ERP 系统、WMS（仓储管理系统）或自建订单处理系统与 OnBuy 平台服务器进行数据互联的技术过程。该机制允许系统在无需人工干预的情况下，自动同步商品库存、价格变动、订单详情及物流追踪号。对于日单量超过 50 单或拥有多店铺运营需求的中国跨境卖家而言，API 对接是实现精细化运营和避免超卖风险的核心基础设施。

A13127668619

二、主要使用场景

1. 外贸工厂与品牌方：当工厂直接运营 OnBuy 店铺时，需通过 API 将内部 ERP 中的实时库存映射至前台，防止因线下 B2B 订单与线上 B2C 订单冲突导致的缺货罚款。

2. 专业 OnBuy 卖家：适用于需要批量上架数千个 SKU、自动抓取竞争对手价格调整策略，以及自动回传 Royal Mail、Yodel 等英国本土物流商追踪号的场景。

3. 代运营服务商：为多个卖家提供管理服务时，利用 API 集中管理不同店铺的后台数据，提升人效比。

三、常见问题与注意事项

• 前置资质硬性要求：在申请 API 密钥（API Keys）前，卖家必须已完成 OnBuy 卖家账户注册，并通过身份验证（KYC）。未激活的店铺或处于审核期的账户无法生成有效的 Client ID 和 Secret Key。
• 沙箱环境测试：OnBuy 提供独立的沙箱（Sandbox）环境。严禁直接在正式环境（Production）进行代码调试，否则可能产生虚假订单或导致真实库存被错误锁定。务必先在沙箱完成“创建产品 - 模拟下单 - 回传运单”的全流程测试。
• 频率限制（Rate Limits）：OnBuy API 对请求频率有严格限制（通常为每分钟特定次数，具体视端点而定）。高并发时段若未设置重试机制（Retry Logic），极易触发 429 错误导致数据同步中断。建议在代码中增加队列缓冲机制。
• 数据格式规范：英国市场对 VAT（增值税）显示要求严格。API 传输的价格字段必须明确区分含税价与不含税价，且货币单位必须统一为 GBP，否则会导致 Listing 下架或合规风险。
• 物流回传时效：根据 OnBuy 平台规则，订单生成后需在规定时间内通过 API 回传有效追踪号。延迟回传不仅影响账号绩效指标（KPIs），还可能触发买家退款保护机制。

四、总结

英国 OnBuy 商城 API 对接是卖家从“手工铺货”迈向“自动化运营”的关键一步。建议中国卖家在技术对接前，先详细阅读 OnBuy 开发者文档（Developer Portal），确认自身 ERP 系统是否支持自定义 API 插件。若缺乏技术开发能力，应优先选择已获 OnBuy 官方认证的第三方 ERP 解决方案（如 Linnworks、Storefeeder 等），以降低开发成本并确保数据交互的稳定性。