50000+企业的共同选择
点三全渠道全链路ERP
400 8080 092
编辑:原创 时间:2026-07-06 16:34:26
获取电子面单并完成打印后,系统需要将运单号回传至抖店平台,完成订单履约的闭环。抖店订单发货接口体系支持整单发货、拆单发货、合单发货等多种业务场景,开发者需要根据商家的实际业务模式选择合适的接口组合。本文将深入解析抖店电子面单接口在发货环节的集成实践。
一、整单发货:最基础的履约场景
整单发货是最常见的发货场景——一个订单的所有商品打包在同一个包裹中发出。对应的接口为/order/logisticsAdd,请求1次接口成功后订单会流转到“已发货”状态。
调用该接口时,核心入参包括:order_id(父订单ID)、logistics_code(物流公司编码)、track_no(从电子面单取号接口获取的运单号)。系统需要确保运单号与物流公司编码的匹配关系正确,避免因信息不匹配导致物流轨迹无法正常同步。
二、拆单发货:多包裹场景的精细化处理
在电商业务中,拆单发货是常见场景——一个订单的商品可能分属不同仓库,或部分商品需要先发、部分商品需要延迟发货。抖店提供了两种拆单发货接口:
/order/logisticsAddMultiPack接口支持一个父订单发多个物流包裹,当子订单全部发货完毕后,主订单状态才会流转到“已发货”。
/order/logisticsAddSinglePack接口支持多个子订单发同一个物流包裹,适用于主订单下有多个子订单要分几次发货的场景。
在拆单发货场景下,系统需要维护父订单与各物流包裹之间的映射关系,并确保每个包裹都正确关联到对应的子订单列表。调用拆单发货接口时,入参需要明确指定本次发货覆盖的子订单ID列表,避免部分发货时遗漏或重复。
三、发货信息的修改与追加
在实际运营中,发货后可能因物流异常、快递员揽收失败等原因需要修改运单号。抖店提供了/order/logisticsEdit接口用于整单修改发货的物流信息,以及/order/logisticsEditByPack接口用于修改包裹级别的物流信息。
此外,对于已发货订单需要追加赠品或补发漏发商品的情况,开发者可使用手工单功能进行操作。手工单支持在已发货状态下追加新的物流包裹,无需解密用户隐私数据即可完成操作。
四、订单状态流转与消息推送
抖店平台提供了消息推送机制,当订单支付成功时,系统会触发doudian_trade_TradePaid消息推送。开发者可以通过订阅该消息,在订单支付成功后自动触发电子面单取号和发货流程,实现从支付到发货的全自动链路。
在订单状态管理方面,抖店订单分为父订单(店铺单)和子订单(SKU单)两个层级。父订单是用户一次提单中一个商家的所有商品组成的订单,子订单则是其中单个SKU的订单。开发者需要在系统设计中完整复现这一两层结构,确保状态流转的准确性。
五、非抖店订单(三方单)的取号与发货
抖店电子面单接口不仅支持抖店平台的原生订单,也支持非抖店订单(三方单)的取号。对于三方单场景,调用/logistics/newCreateOrder接口时,order_id字段传非抖店订单号,order_channel字段传54或按照接口文档中的要求来传。
这一能力使得已开通抖店电子面单服务的商家,可以将其他平台的订单也纳入抖店电子面单体系进行打单发货,实现多平台面单的统一管理。
六、常见发货限制与注意事项
在发货接口的调用中,开发者需注意以下限制:有价券订单无法调用面单取号接口,也无法通过发货接口进行发货;电子面单取号后,若需再次取号(如换快递公司),需传相同订单号及不同的包裹ID再次取号,否则系统会返回老的单号;只有抖音平台的订单才可以使用抖音电子面单,其他平台的订单使用抖音电子面单会报错。
点三深耕全渠道数据对接领域十余年,已全面适配抖店电子面单接口的整单发货、拆单发货、三方单取号等全场景。点三电商开放平台拥有订单状态自动流转、多包裹映射管理和消息推送实时响应等核心能力,帮助数千家企业实现高效的自动化发货,有需求可咨询点三客服或拨打点三客服热线18975154575免费获取接口文档。
最新文章