一、基础发货逻辑

对于实物类商品，消费者付款以后需要商家线下物流发货。

1. 订单状态为“买家已付款等待卖家发货状态”，这时卖家可以进行订单发货，生成运单号后，通过物流接口回传运单号和物流公司信息，接口调用成功平台系统会推进交易订单状态进入卖家已发货状态，消费者也能在卖家中心查看到物流单号信息。

2. 并不是所有订单都需要发货，一般实物类商品需要通过物流发货送到消费者，其他类型订单是否需要发货以及发货方式以各行业类目要求为准。

3. 平台官方支持的物流公司可通过接口获取，如使用的物流公司不在枚举值内，可以使用 “code：OTHER” 进行发货处理。

二、相关API

三、整单发货场景

第一步：获取待发货的订单

调用taobao.trades.sold.get，入参加入status=” WAIT_SELLER_SEND_GOODS”，可以搜索出来所有待发货的订单,如下图。

第二步：判断子订单是否已关闭或退款

通过订单查询接口查询子订单状态 或者 查询RDS订单推送中交易订单状态。

第一种情况：如果子订单中存在已关闭的订单（即orders.status=” TRADE_CLOSED”），则需要用户在自己本地的 ERP系统中标记一下该子订单中的商品，防止在发货的时候，仍然把该笔子订单对应的货物发给买家；

第二种情况：如果子订单中存在正在退款的订单（即orders.refund_status=” WAIT_SELLER_AGREE”），该订单需要 等待退款完成后，再发货；否则发货的时候，就会默认成为卖家拒绝退款

除以上基础步骤外，为保障最大化的数据准确性，减少因数据同步不及时导致的仓储&履约损失。针对退款数据的校验方案请参见：退款数据处理方案。

第三步：发货处理

调用 alibaba.ascp.logistics.offline.send 或 taobao.logistics.online.send 对订单进行发货。这两个接口仅是发货方式的区别，前者为自行联系物流发货，后者为在线下单。

1）当订单是货到付款订单时（即type=”cod”，交易接口查询得到），只能调用taobao.logistics.online.send进行发货处理 。

2）company_code 为物流公司代码，可通过 taobao.logistics.companies.get 获取。

3）无需物流订单只能用虚拟发货处理：taobao.logistics.dummy.send (无需物流（虚拟）发货处理)，订单是否需要虚拟发货，可以通过接口 taobao.trade.fullinfo.get（获取单笔交易的详细信息） shipping_type字段进行判断。

4）时效保障（is_lgtype），一口价订单只能走线下发货：alibaba.ascp.logistics.offline.send( 自己联系物流发货 )

5）家装物流订单发货： alibaba.ascp.logistics.offline.send (家装发货接口)，调用 taobao.trade.fullinfo.get 接口，入参父字段 service_orders（服务子订单列表），根据返回其子字段 tmser_spu_code（家装干支装服务）判断。

若为下列其中之一，即为家装订单：(家装干线服务");("家装干支服务");("家装干支装服务");("卫浴大件干线");("卫浴大件干支");("卫浴大件安装");("地板干线");("地板干支");("地板安装");("灯具安装");("卫浴小件安装");//618新增8类16种("集成吊顶大件干线")("集成吊顶大件干支")("集成吊顶大件安装")("涂料干线")("瓷砖干线")("油漆干线")("涂料干支")("瓷砖干支")("油漆干支")("涂料安装")("瓷砖安装")("油漆安装")("浴霸安装")("墙纸安装")("电子门锁安装")("集成吊顶小件安装")

6）海外集运订单不能使用用无需物流发货，需要使用wlb接口taobao.wlb.import.threepl.offline.consign( 3PL直邮线下发货 )进行发货。

7）保税订单商家不需要自己发货，仓库会发货的。

8）taobao.logistics.online.confirm 非发货API ,仅在使用 taobao.logistics.online.send 发货未输入运单号out_sid的前提下需要使用。

四、拆单/子订单发货场景

1. 业务流程

2. 实施方案

详细方案请查看文档：订单全链路白皮书。

1）接口调用逻辑

taobao.logistics.online.send( 在线订单发货处理（支持货到付款）)

alibaba.ascp.logistics.offline.send( 自己联系物流发货 )

如果需要拆单发货 ，入参传入 sub_tid （需要拆单发货的子订单集合，针对的是一笔交易下有多个子订单需要分开发货的场景；1次可传人多个子订单号，子订单间用逗号隔开；为空表示不做拆单发货）。

2）订单管理的影响

① 拆单发货的订单比普通订单增加了部分发货的状态SELLER_CONSIGNED_PART和是否为多笔订单的标识为is_part_consign

需要开发者注意的是：

a.为了防止开发者漏单，搜索“未发货订单”会把“部分发货”的订单也搜索出来，需要开发者对返回订单的is_part_consign做判断；

b.消息服务 中，子订单也会单独的发送消息，希望开发者关注；

c.关联子订单号(bind_oid)，这些关联子订单要和当前子订单放在一起发货，才能发货成功。比如：你在页面买了一台电脑，同时赠送了一个3年质保服务。质保服务就是这台电脑的关联子订单。质保服务要电脑一起发货的。

② 子订单独立的物流及关联信息，包含bind_oid(关联子订单号)，consign_time（发货时间），shipping_type（发货类型），logistics_company（物流公司），invoice_no（子订单运单号），ERP根据需要做单独处理。

3）发货管理的影响

① 物流发货必须要传入父子订单和拆单标识；

② 物流单查询和物流流转信息的查询必须传入父子订单号；

③ taobao.logistics.dummy.send（无需物流（虚拟）发货处理）不支持拆单发货。