商品配送商家
自有业务系统需要与线上订单、配送数据打通，并希望减少人工登记环节的商品配送商家。
- 需要订单自动进入自身系统
- 需要配送进度自动回传
- 需要对账所需的订单明细数据
服务流程
商家授权 → API 对接 → 订单同步 → 配送状态回传
四个环节依次推进，每个环节都有明确的输入与输出，商家可随时核对。
-
第一步01
商家授权
商家在授权页面确认授权后，本服务获取用于调用接口的授权凭证。凭证按有效期定期更新；未完成授权时，本服务不读取、不处理任何商家数据。授权范围以商家确认的内容为准，商家可随时撤回授权。
输入：商家确认授权、授权范围输出：接口调用凭证（有效期管理） -
第二步02
API 对接
按接口文档约定完成字段映射、鉴权与签名配置，并进行连通性测试。测试通过后，商家系统即具备接收订单数据、回写订单状态的能力。本环节由双方技术人员共同完成，接口调用地址、凭证与字段以双方确认的接口文档为准。
输入：商家系统接口信息、接口文档输出：联通性测试通过的接口通道 -
第三步03
订单同步
订单产生后，订单数据经接口进入本服务完成接收与处理，并推送至商家业务系统；订单接单、备货、发货等状态变更同步回写，双方数据保持一致。同步过程中的每一次调用都会记录在同步日志中，出现异常时记录失败原因并按规则重试。
输入：订单数据（订单号、商品、金额、时间等）输出：商家系统可见的订单记录与状态 -
第四步04
配送状态回传
配送呼叫发起后，骑手接单、到店、配送中、送达（或异常）等节点状态经回调接收，并实时回传至商家系统与下单侧，商家无需人工登记配送进度。配送完成后，订单明细数据可按周期输出，用于商家对账与核对。
输入：配送节点状态回调输出：状态回写结果、对账所需订单明细
接口构成
主要接口与调用方向
下表列出本服务涉及的主要接口及其调用方向，用于说明订单数据与状态数据在各方之间的流转路径。
| 接口名称 | 请求方式 | 调用方向 | 用途说明 |
|---|---|---|---|
| 订单接收 | POST /api/order/receive | 抖音“即送” → 本服务 | 接收订单数据，包括订单号、下单时间、商品明细、金额、收货信息等字段 |
| 订单推送 | POST /api/order/push | 本服务 → 商家系统 | 将订单数据推送至商家业务系统，供商家接单、备货、发货 |
| 订单状态同步 | POST /api/order/status | 本服务 → 商家系统 | 订单接单、发货、完成、取消等状态变更回写 |
| 配送呼叫 | POST /api/delivery/create | 本服务 → 配送服务方 | 按订单发起配送呼叫，传递取货地址与收货信息 |
| 配送状态回调 | POST /api/delivery/callback | 配送服务方 → 本服务 | 接收骑手接单、到店、配送中、送达、异常等节点状态 |
| 商品信息同步 | POST /api/goods/sync | 本服务 ⇄ 商家系统 | 商品名称、规格、价格、库存数量的同步与更新 |
| 对账数据查询 | POST /api/order/settle | 本服务 → 商家系统 | 按时间范围输出订单明细数据，供商家核对 |
| 联通性自检 | GET /api/ping | 商家系统 → 本服务 | 用于对接联调与日常链路检查，仅返回状态信息，不涉及业务数据 |
说明：上表接口路径为对接示例，正式接口地址、字段定义与鉴权方式以双方确认的接口文档为准。
服务对象
服务面向哪些对象
抖音“即送”入驻商户
已在抖音“即送”完成入驻、需要订单处理与配送对接技术支持的商户。
- 需要订单数据接收与状态同步
- 需要配送呼叫与状态回传
- 需要商品信息与在售信息保持一致