接口说明

创建运单

若商家在抖音平台选择了“自配送”，则支持第三方平台帮商家发起聚合配送，但是需要调用此接口回传配送信息，包括骑手信息、配送状态、骑手位置轨迹等。
需要在商家接单以后才允许创建运单，否则接口会报错处理。
若商家门店在抖音选择“快送”配送方案，在订单配送过程中，可能会出现因运力不足无法呼叫到骑手的情况，平台会通过配送状态变更消息Webhook通知开发者运单降级或取消，商家此时可以通过该接口自行发起自配送并回传自配送信息。

回传配送状态

当订单在未回传状态“1=骑手已接单”情况下回传2、3、4、5状态，则自动补偿状态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

调用https://open.douyin.com/oauth/client_token/生成的token

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	3000001	以实际错误信息为准
200	5000001	服务器打瞌睡了，请稍后再试。

开发者文档

自配送-回传配送信息接口

接口说明

创建运单

回传配送状态

回传骑手经纬度/轨迹

基本信息

请求参数

响应参数

错误码

自配送-回传配送信息接口在线调试

接口说明

创建运单

回传配送状态

回传骑手经纬度/轨迹

基本信息

请求参数

响应参数

错误码

自配送-回传配送信息接口