自配送-回传配送信息接口
收藏接口说明
创建运单
- 若商家在抖音平台选择了“自配送”，则支持第三方平台帮商家发起聚合配送，但是需要调用此接口回传配送信息，包括骑手信息、配送状态、骑手位置轨迹等。
- 需要在商家接单以后才允许创建运单，否则接口会报错处理。
回传配送状态
- 需要先回传“1=骑手已接单”，再回传其他状态。如果未传1直接传其他状态，接口会报错。
- 如果仅回传配送状态，则回传“4=骑手已送达”不会驱动订单完成，在C端仍会展示为【配送中】，直到1）用户点击确认收货，2）8小时后自动完单，或3）平台收到连续回传的骑手经纬度信息，才会展示为订单完成。
- 回传“4=骑手已送达”之前的各运单状态时，支持因更换骑手等原因更新骑手姓名与手机号，需要保证骑手姓名和手机号为非空的有效值才能更新成功。
回传骑手经纬度/轨迹
- 请您务必确保回传经纬度信息的准确性和实时性
- 当您在behavior字段回传【3=骑手已取货】状态后，请尽量每30秒左右回传一次更新的经纬度信息，至少保证每分钟回传一次，以确保用户端信息展示的实时性。
- 建议过滤掉两个时间点未发生变化的经纬度，避免产生没有实际意义的垃圾数据。
- 上报经纬度时经度+纬度+采集时间必须同时存在有效值
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/fulfilment/distribution/order/sync_status/ |
| HTTP Method | POST |
| Scope | life.capacity.order_delivery |
| 权限要求 | 订单配送 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
behavior必填Enum
1=骑手已接单;
2=骑手已到店;
3=骑手已取货（配送中）;
4=骑手已送达;
5=运单取消
(允许跨状态回传，例如1->3，跳过2)
展开子属性
order_id必填String
订单ID
three_source必填Enum
三方配送商标示
0=顺丰同城；1=新达达；2=蜂鸟配送；3=美团配送；4=闪送；5=点我达；6=UU跑腿；8=信天翁；10=365跑腿；11=曹操跑腿；12=爱跑腿；13=快跑者；14=极客快送；15=同达；16=生活半径；17=临趣；18=趣送；19=快服务；20=菜鸟新联盟；21=风先生；22=来答配送；23=好急跑腿；24=送个东西跑题；25=靠谱送；26=快男跑腿；27=裹小递
7=其他；1000=商家自配送
展开子属性
accept_timeInt64
骑手接单时间戳 秒
rider_flow_timeInt64
骑手信息采集时间戳（经纬度若给值需要采集时间必须是有效值）
rider_latDouble
骑手纬度 GCJ02坐标系 （经纬度若给值需要采集时间必须是有效值）
rider_lngDouble
骑手经度，GCJ02坐标系（经纬度若给值需要采集时间必须是有效值）
rider_nameString
骑手姓名
rider_phoneString
骑手电话
1. 禁止回传无法联系到骑手或门店商家的虚假电话号
2. 配送过程中如果发生骑手变更，此字段支持更换骑手电话
3. 格式要求
1）移动电话：11位连续数字；
2）隐私号：11位数字主机号+3或4位分机号，建议用英文逗号“,”分隔，英文“-”或“_”也可兼容；
3）400电话：400开头的10位连续数字，不要加分隔符；
4）固定电话：3位区号加8位电话；4位区号加7或8位电话；无区号的7位或8位电话。完整电话号内不要加分隔符；
rider_phone_typeInt64
骑手电话类型,0是真实号，1是隐私号，默认为0
three_delivery_idString
三方配送商物流单号，字段不为空时长度必须小于32位
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/fulfilment/distribution/order/sync_status/' \ --header 'access-token: douyin.CzDj0kd9MJnkiLpBwSWyIOEv1EeCxdya0nJ6ZMFW6GIBcDwPX5UhOffpZADC' \ --header 'Content-Type: application/json' \ --header 'Cookie: passport_csrf_token=da01964a4a24244c5cff287b3fbefd93; passport_csrf_token_default=da01964a4a24244c5cff287b3fbefd93' \ --data-raw '{ "order_id": "8000007372302629122", "rider_phone": "123241289303", "three_source": 7, "behavior": 2, "accept_time": 1669344364 }'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20241202235118D0853B7399D436DA4D18", "now": 1733154678 }, "data": { "error_code": 0, "description": "" } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 3110201 | 发运单之前，需要完成订单接单 | |
| 200 | 3110202 | 未找到运单 | |
| 200 | 3110203 | 只能操作商家自配送的订单 | |
| 200 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
