先判断你要对接什么
API 可以理解为两个系统之间的业务通道，让另一个系统自动查询商品、提交订单和获取发货结果。普通顾客在商城网页购买，不需要自己配置 API。
本目录介绍的是你的商城向客户或店铺供货。如果你想把别人的商品导入自己的商城，请看对接上游商品与目录。
按使用场景选择教程
| 你要做的事 | 看哪篇教程 | 从哪里开始 |
|---|---|---|
| 自己写程序，或为另一套系统接入商城商品 | 商城开放 API | 商城后台“对接管理 → 客户 API 授权” |
| 通过阿奇索让店铺订单向商城采购 | 阿奇索商城供货接入 | 商城后台“对接管理 → 电商渠道供货” |
| 通过闲管家的虚拟货源服务向商城采购 | 闲管家虚拟货源接入 | 商城后台“对接管理 → 电商渠道供货” |
三个入口使用的路径、凭据和签名规则不同，不能把一套密钥或示例直接填到另一套接口中。
店主先完成这些准备
- 确定由哪个商城客户账户采购。准备可用商品、正确规格和该账户的采购价格。
- 在对应授权页面启用权限，核对自动授权开关和客户的单独授权。不要以为能登录商城就一定有 API 权限。
- 给采购账户准备足够的商城余额。渠道供货采购会按商城校验后的价格扣余额，不是自动扣店铺平台的货款。
- 按所选教程填写连接地址和凭据，映射商品、规格以及充值账号等必填字段。
- 先用一笔小额测试订单核验扣款、订单关联、交付和重复请求，再批量经营。
给技术人员的接入要求
- 使用具体教程中的当前接口路径、金额单位、签名和错误处理，不要使用来源不明的旧示例。
- 密钥只能保存在服务端；不要写进网页 JavaScript、截图、公开工单或商品详情。
- 创建订单超时后先按原业务单号查单。结果未知时不能不断更换单号重新购买，否则可能重复扣款。
- 退款要按对应接口支持范围和商城审核流程处理，不要把“已申请”显示成“已退款”。
官网的授权、安装 Agent 和后台内部接口用于平台运维，不是客户采购 API。商城开放 API 也不等于第三方平台的官方全部功能。
怎么确认真正接通
同时检查第三方店铺记录和商城订单：商品规格一致、只扣一次余额、能读取最终交付内容，失败时有明确原因。仅测试“连接成功”或能读到商品列表，还不代表下单发货已经完成。