可对接的系统
电商平台
- Amazon SP-API（DE / FR / IT / ES）
- eBay API
- Shopify
- WooCommerce / 独立站自建
- Cdiscount（法国）
ERP / 仓储系统
- 店小秘
- 马帮 ERP
- 易仓 ERP
- 赛盒
- 自研系统（REST API 直连）
API 端点
| 端点 | 方法 | 用途 |
|---|---|---|
/v1/return-labels | POST | 创建退货面单，返回运单号与 PDF 地址 |
/v1/return-labels/{id} | GET | 查询面单状态与费用 |
/v1/return-labels/{id} | DELETE | 作废未使用面单 |
/v1/returns | GET | 退件列表（支持按状态、等级、国家筛选） |
/v1/returns/{rma} | GET | 退件详情：质检结果、照片、重量 |
/v1/returns/{rma}/decision | POST | 提交处置决策：退款 / 换货 / 再售 / 转运 / 处置 |
/v1/inventory | GET | 可用库存、库龄与状态分布 |
/v1/shipments | POST | 创建一件代发或转运出库单 |
/v1/statements | GET | 月度对账单导出（SKU 粒度） |
Webhook 事件
| 事件 | 触发时机 | 典型用途 |
|---|---|---|
label.created | 面单生成成功 | 通知买家、记录售后工单 |
return.received | 退件入仓扫码完成 | 更新售后状态、暂停退款倒计时 |
inspection.completed | 质检判定完成 | 触发退款、换货或重上架 |
return.disposed | 处置完成并出具证明 | 财务核销、EPR 申报 |
inventory.updated | 可用库存变化 | 同步前端库存，防超卖 |
exception.created | 异常工单创建 | 人工介入、与买家沟通 |
字段映射与编码规范
- RMA：建议采用「前缀-国家-流水号」结构，便于到仓自动匹配
- SKU：与你的主数据一致，支持多 SKU 合并退件
- 重量：统一 kg，保留两位小数，用于称重比对
- 等级：固定枚举 A / B / C / D / E，便于系统判断
- 原因码：使用结构化的原因枚举，避免自由文本无法归因
安全与权限
传输层 TLS 加密；API Key 按环境隔离（沙箱 / 生产）并支持轮换；权限按角色分配，操作留痕，可按需要提供访问日志。
上线流程
- 1申请沙箱获取测试 Key 与接口文档。
- 2联调面单创建 + 状态回调两条主链路跑通。1–3 天
- 3试运行首月真实数据验证，核对 SLA 与对账。
- 4转正式切换生产 Key，设定告警与重试策略。
相关服务与阅读
FAQ
常见问题
有 ERP 对接经验的团队通常 1–3 个工作日完成联调。全新自研系统一般 1 周内跑通。
有。提供测试 API Key 与沙箱数据，可完整模拟面单创建与状态回调，不产生真实费用。
入仓、质检完成、处置完成、面单作废、异常工单等，可按需要订阅。
标准限流为每分钟 600 次请求，批量操作建议使用批量端点；超限返回 429 并提示重试时间。
可以。支持导入 SKU 主数据、历史 RMA 与库存快照，便于对账与连续统计。
把你的退货数据发给我们，72 小时内拿到方案
告诉我们月退件量、主要品类与目标市场，我们会给出单件成本对比、再售率预估、仓库分配建议与系统对接路径。
信息仅用于本次方案沟通，不向第三方共享。