抖店开放平台

发布时间：2025-09-28 04:55

西装：叠放并放入防蛀衣架，保持平整，定期抖一抖灰尘。 #生活技巧# #衣物护理建议# #衣物分类存储#

更新时间：2025-06-10 13:56:02访问次数：7793

收藏文档

1.使用场景说明

本场景方案是面向即时零售商家（自研商家、软件服务商商家，软件服务商商家后都统一简称为ISV），从平台获取订单数据进行订单管理、发货等一系列即时零售配送业务场景。对应的效果如商家后台的【订单-订单管理】功能中点击发货填入对应的运单号。

目前即时零售支持四种配送模式：

此方案只进行即时配送发货的方案说明。

2.名词解释

名词

解释说明

服务包

服务包实体是抖音平台向商户提供的即配服务,包含了履约方式、履约承诺、履约服务费、赔付标准等信息。

自配送

自配送是指商家用自有运力或者三方运力发货，商家需对接平台回传运力状态和骑手位置，对比平台运力配送质量较低，用户体验较差。简称自配

平台配送

平台会调用聚合运力，对签约平台运力的商家提供优质的配送服务。平台将合作的三方运力全部对接进来，如顺丰、达达、蜂鸟、闪送等，再由平台提供标准的配送产品，商家接单后调度系统会从多个三方运力里匹配一个最佳的配送商来提供服务。

电子围栏

顺序连接地图上多个点形成的封闭图形，描述：

商家可以在怎样的范围内提供服务用户在什么位置能感知门店进行下单期望的位置配送能力是否可达，效率如何

3.【重要】发货前必读

3.1 签约配送服务包

从抖店商家后台可设置选择具体的发货方案后，需在抖店商家后台通过签约/切换配送包的方式来进行发货配置。具体路径为【商家后台 - 配送信息 - 签约/更换方案 - 选择“小时达”配送方案】。

3.2 自动接单

为了保障消费者的体验，提升商家的服务质量，目前对于即时订单默认开启自动接单功能。若需开启手动接单功能，需提交工单进行操作。

3.3 平台运力自动呼单

为了提升配送时效，在采用平台配送的方式下，平台提供自动呼单功能。可在子门店通过【订单管理】-【平台运力自动呼叫设置】，开启自动呼单。操作路径可参考下图

4.接口总览 & 交互流程图

4.1 即时配送发货总览

方案1 - 自配送

方案简介：商家拉取订单后通过自有运力发货（商家自配送发货）

以下为自配送的接口总览：

模块说明

是否必须接入

同步/异步

API/SPI中文名称

API/SPI英文名称

备注

订单管理

可选接入

同步

订单创建、取消等消息详见

需要什么消息在目录下自寻

必接

同步

订单列表查询

/order/searchList

判断订单类型：可以通过交易类型（trade_type）来判定，18=小时达（即时配送）判断签约的履约包（按需对接）：可以通过store_info.store_tag_map.delivery_service_pkg来判定履约包：2=自配服务包

必接

同步

订单详情查询

/order/orderDetail

接单/拒单

必接

同步

接单

/superm/acceptOrder

必接

同步

拒单

/superm/rejectOrder

订单发货（商家自配送发货）

必接

同步

首次发货接口

/order/logisticsAdd

必接

同步

详见4.3 订单解密章节

推荐接入

同步

重新发货接口

修改配送单号重新发货必须接入

/order/logisticsEdit

自配送信息回传

必接

同步

即时零售自配订单同步配送信息

/instantShopping/notifyDeliveryStatus

推荐接入

同步

回传商家拣货状态

/instantShopping/notifyPickingStatus

即时零售自配订单同步配送信息（位置）

必接

同步

即时零售自配订单同步配送信息（位置）

/instantShopping/reportRiderLocation

以下为自配送的接口交互流程图：

方案2 - 平台配送

方案简介：商家收到来单消息后手动呼叫抖音平台运力发货，具体实施有两种子方案

方式一（推荐）：签约平台配送，并使用抖音的自动呼单能力--适用于希望把配送全托管给抖音的商户，抖音可提供较为精准的时效计算方式二：签约平台配送，不使用抖音的自动呼单能力

以下为平台配送的接口总览：

模块说明

是否必须接入

API/消息中文名称

接口使用场景

API/消息英文名称

备注

订单管理

可选接入

订单创建、取消等消息详见

需要什么消息在目录下自寻

订单管理

必接

订单列表查询

订单管理

/order/searchList

判断订单类型：可以通过交易类型（trade_type）来判定，18=小时达（即时配送）判断签约的履约包（按需对接）：可以通过store_info.store_tag_map.delivery_service_pkg来判定履约包：1=平配服务包

必接

订单详情查询

订单管理

/order/orderDetail

必接

买家收货信息变更消息

订单管理

doudian_trade_TradeAddressChanged

自配送：消费者在白名单中的商家下单，才被允许修改联系方式（地址、电话、收件人）和时间。联系方式和时间的白名单为分开的两个，需要分开申请。呼叫运力节点前可以修改联系方式和时间平台配送：承运商为蜂鸟承运、达达的，配送完成前支持消费者修改联系方式（地址、电话、收件人）。呼叫运力节点前支持修改时间

必接

到家订单预计送达时效变更

订单管理

doudian_trade_TradeArrivalTimeModify

接单/拒单

必接

同步

接单

/superm/acceptOrder

必接

同步

拒单

/superm/rejectOrder

平台呼单

推荐接入

呼叫运力询价/取消呼叫运力询价

订单配送

/superm/getDispatcherInfo

必接

即时零售下发配送任务

订单配送

/instantShopping/createDelivery

只使用自动呼单非必接

必接

平台运力取消

订单配送

/instantShopping/cancelDelivery

在发单异常后，可调用此接口主动取消配送，再调用/instantShopping/createDelivery重新呼叫运力。只使用自动呼单非必接

配送设置

可选接入

新增自动呼叫运力配置

平配自动呼单设置

/superm/setStoreAutoCallRider

可选接入

查询自动呼叫运力配置

平配自动呼单设置

/superm/getStoreAutoCallRiderInfo

配送状态

可选接入

商家查询抖音配送信息

订单配送

/instantShopping/getDeliveryListByOrderId

可选接入

配送异常消息推送

订单配送

doudian_instantShopping_DeliveryException

doudian_instantShopping_DeliveryException的枚举值和相应推荐商家要进行的操作：

以上异常消息推送的时间线为：接单：10-02-04到店：01-20-21/22其他俩：03、101

可选接入

平台运力推送配送状态

订单配送/售后退货

doudian_instantShopping_DeliveryChange

以下为平台配送的接口交互流程图：

方案3 - 部分平配部分自配

方案简介：商家根据自身的运力情况，采用平台运力与自有运力相结合的方案，具体实施有两种子方案

按门店区分走自有运力还是抖音平台运力，采用抖音平台运力的门店可设置自动呼平台运力（也可以不走自动呼运力），不走平台运力的门店需要商家自己调发货接口处理按具体订单区分走自有运力还是抖音平台运力，需要商家根据实际情况调平台运力发货、或走自有运力发（比如平台配送运力不足的情况下调用自配送运力进行发货）

模块说明

是否必须接入

API/SPI中文名称

API/SPI英文名称

备注

订单管理

可选接入

订单创建、取消等消息详见

需要什么消息在目录下自寻

必接

订单列表查询

/order/searchList

判断订单类型：可以通过交易类型（trade_type）来判定，18=小时达（即时配送）判断签约的履约包（按需对接）：可以通过store_info.store_tag_map.delivery_service_pkg来判定履约包：1=平配服务包；2=自配服务包（快递履约，都被认定为自配服务包）

必接

订单详情查询

/retail/order/getOrder

接单/拒单

必接

接单

/superm/acceptOrder

必接

拒单

/superm/rejectOrder

订单发货（商家自配送发货）

必接

首次发货接口

/order/logisticsAdd

推荐接入

重新发货接口

修改配送单号重新发货必须接入

/order/logisticsEdit

订单解密（商家自配送发货）

必接

详见4.3 订单解密章节

自动呼叫运力设置（平台运力发货）

必接

新增自动呼叫运力配置

开启后新订单由平台按照商家配置自动呼叫运力并发货，无需商家手动操作

/superm/setStoreAutoCallRider

必接

查询自动呼叫运力配置

/superm/getStoreAutoCallRiderInfo

订单发货（平台运力发货）

推荐接入

呼叫运力询价/取消呼叫运力询价

/superm/getDispatcherInfo

推荐接入

呼叫运力并发货/重新发货

用户拒收/骑手丢件等需二次配送的场景可走手动呼叫运力流程兜底

/instantShopping/createDelivery

推荐接入

取消呼叫运力

/instantShopping/cancelDelivery

运力状态（平台运力发货）

可选接入

运力配送状态查询接口

/instantShopping/getDeliveryListByOrderId

可选接入

运力配送状态变更消息

doudian_instantShopping_DeliveryChange

4.2 订单解密【小时达自配送打通必接】

4.2.1 对接流程注意事项

获取方式一:订单可直接获取隐私号https://op.jinritemai.com/docs/api-docs/1033/2739获取方式二:如需获得用户明文地址①可通过解密获得用户明文地址及隐私号，使用平台解密能力(得到用户敏感信息电话、地址、姓名),得到隐私号https://op.jinritemai.com/docs/api-docs/15/982 ②限制订单状态非【待支付部分支付交易关闭交易完成】 ③需入云《抖店云开发者解密入云配置指南（对外）》,且受平台解密数量限制解密额度会随着订单数量进行实时调整,与待发货订单一致(虚拟号与真实号码都会占用解密额度)④商家过多、过快点击订单解密,或者对"已完成"、"已取消"订单解密,会命中风控规则,冻结解密额度详见《商家订单解密行为规范》

4.3.2 常见问题

隐私号打不通怎么办/如何获取电话号明文(非必接)？①先走报备流程https://op.jinritemai.com/docs/api-docs/15/15/1550②再走解密接口可获得该订单的明文手机号https://op.jinritemai.com/docs/api-docs/15/982完成技术对接后,商家使用隐私号前,需联系平台按抖店id添加白名单隐私号使用注意事项①隐私号仅在订单状态已取消,未支付状态情况下不允许查看看,平自配均可获取,售后场景可正常获取②虚拟号获取后的过期时间为【订单完成+48小时】③隐私号还没失效的话，重新调用不会重新生成。失效后重新调用会生成新的

5.订单流转状态

6.常见问题

针对上报骑手位置的接口/instantShopping/reportRiderLocation，上报频率有规定吗？请保证至少每5分钟上报一次。若回传信息不及时/不准确，将会导致商家被落罚。对于平台运力取消接口/instantShopping/cancelDelivery，是否有什么调用时间限制（在什么时间点可以取消）？平配：只有顺丰UU支持送达前取消，其他配送商都只支持取货前取消。因为一开始也不知道会发单到哪个配送商，所以是否能取消要看调用接口的返回结果自配：商家自己控制，支持送达前取消，在回传状态的时候回传300：取消配送我配送服务包选了快递包裹，可以发即时物流吗？不可以，平台对快递包裹和即时物流有不一样的业务配送逻辑和治理规则。配送服务包与实际履约方式不一致，将会导致无法正常在平台上完成订单或者受到平台的落罚。我配送服务包选了即时物流，可以发快递包裹吗？不可以，平台对快递包裹和即时物流有不一样的业务配送逻辑和治理规则。配送服务包与实际履约方式不一致，将会导致无法正常在平台上完成订单或者受到平台的落罚。自配送发货后，还可以取消配送吗？取消配送后，再想给这笔订单配送怎么办？在送达前，在调用/instantShopping/notifyDeliveryStatus可以取消配送。如果想要继续发货，需要调用/order/logisticsAdd重新创单，再调用相应接口回传配送状态和骑手位置。自配送时，针对/order/logisticsAdd，company_code该怎么填写？请参照/order/logisticsCompanyList接口中获取物流商编码不在列表中的即配厂商，如何进行入驻？可以前往开放平台工单中心提交工单咨询（选择【即时零售】），或扫码加入开发者交流群调用/order/logisticsAdd时，报错{"code":50002,"msg":"业务处理失败","sub_code":"isv.business-failed:60072","sub_msg":"该店铺无默认发货地址，请前往抖店PC端「订单-发货管理-物流工具-地址库管理」设置后再操作发货","data":null,"log_id":"xxx"}，该怎么处理？在调用/order/logisticsAdd时，字段store_id填写门店id，即可解决该问题系统中报“物流单号收件人电话及地址与该订单买家电话及地址均不一致”错误，怎么解决？平台会校验订单及物流单关联的电话及地址是否一致，防止不校准下发运单后到了末端派送环节出现无法派送或者需要转运的情况。若出现这个情况，请商家检查是否填写错了单号/手机号/地址。/order/logisticsAdd接口is_refund_reject个is_reject_refund字段应用场景是什么？只有在发货时涉及售前退款申请才会用到这个字段，字段非必填，正常发货不传即可。true表示拒绝待处理的退款，并继续发货；不传或为false表示有退款需要处理，拒绝发货；is_refund_reject和is_reject_refund随机使用一个即可。即时自配送时，若某节点缺失，需要如何回传状态？节点缺失后，根据商户实际作业情况，选择实际的业务作业节点，映射匹配回传。即时自配送时，若两个操作节点为同一时间发生，是否可回传相同的时间戳？可以，建议错开一定时间，并需要做好同步失败的重试机制。即时自配送时，节点上报顺序、时间是否有要求？需在真实作业发生时及时回传节点更新，需要按顺序上报节点状态变化。注意不可按照时间逆序上报。（如10点到店，取货时间不得早于10点）即时自配送时，若某骑手轨迹点回传失败，如何处理？骑手信息回传需做好重试机制，保证在失败时可以重试传入上一个位置坐标。即时自配送时，若某次轨迹打点未能从外部成功获取，如何处理？可传入骑手最后一次成功同步的坐标。即时自配送时，回传的坐标点如何取值？需要传入骑手真实所在的坐标，不可传入商户门店地址（骑手到店时）、用户收货地址（送达时），另外需注意坐标准确度与坐标系标准。即时自配送时，骑手信息涉及隐私保护如何处理？姓名可传入如「王骑士」、「王女士」等，联系方式可传入隐私号并保证接通率。目前对于物流发货，平台的治理标准是怎样的？https://school.jinritemai.com/doudian/web/article/aHuV4AnyAEWD针对即时单，平台配送怎么收费？可参考【对外版】抖音生活服务-配送服务方案OnePage针对即时单和预约单，商家可以参考哪个时间进行备货和发配送？/order/orderDetail中，可以参考receipt_time_map中的枚举值，知道建议的开始备货时间、最晚备货完成时间、发配送时间。/order/orderDetail中的receipt_time_map，枚举值的计算逻辑是怎样的？最晚备货完成时间（LatestCompletionTime）：即时单：尽快送达时间

网址：抖店开放平台 https://www.yuejiaxmz.com/news/view/1342402

⬅️上一篇：邂逅星悦时光给城市精英的N种园林

➡️下一篇：Vala联手河南汽车产业投资集团

抖店开放平台

1.使用场景说明

2.名词解释

3.【重要】发货前必读

3.1 签约配送服务包

3.2 自动接单

3.3 平台运力自动呼单

4.接口总览 & 交互流程图

4.1 即时配送发货总览

方案1 - 自配送

方案2 - 平台配送

方案3 - 部分平配部分自配

4.2 订单解密【小时达自配送打通必接】

4.2.1 对接流程注意事项

4.3.2 常见问题

5.订单流转状态

6.常见问题

相关内容

随便看看

最新动态分享

热点动态分享

专题

推荐动态分享