物流发货
1、使用场景
买家购买商品后,卖家通过 发货API,将淘宝已付款待发货的订单同步为已发货状态。
2、相关API
API名称 | 描述 |
taobao.logistics.online.send | 在线订单发货处理(支持货到付款) |
taobao.logistics.offline.send | 自己联系物流(线下物流)发货 |
taobao.logistics.online.confirm | 确认发货通知接口 |
taobao.logistics.companies.get | 获取物流公司和运单号 |
taobao.logistics.consign.resend | 修改物流公司和运单号 |
taobao.trades.sold.get | 查询卖家已卖出的交易数据(根据创建时间) |
taobao.trades.sold.increment.get | 查询卖家已卖出的增量交易数据(根据修改时间) |
3、操作步骤
@
第一步:获取待发货的订单
调用taobao.trades.sold.get,入参加入status=” WAIT_SELLER_SEND_GOODS”,可以搜索出来所有待发货的订单,如下图。
FAQ
第二步:判断子订单是否已关闭或退款
第一种情况:如果子订单中存在已关闭的订单(即orders.status=” TRADE_CLOSED”),则需要用户在自己本地的 ERP系统中标记一下该子订单中的商品,防止在发货的时候,仍然把该笔子订单对应的货物发给买家;
第二种情况:如果子订单中存在正在退款的订单(即orders.refund_status=” WAIT_SELLER_AGREE”),该订单需要 等待退款完成后,再发货;否则发货的时候,就会默认成为卖家拒绝退款
第三步:发货处理
调用 taobao.logistics.offline.send 或 taobao.logistics.online.send 对订单进行发货。这两个接口仅是发货方式的区别,前者为自行联系物流发货,后者为在线下单,具体使用何种方式,可自行选择。需注意问题:
1)当订单是货到付款订单时(即type=”cod”,交易接口查询得到),只能调用taobao.logistics.online.send进行发货处理 。
2)company_code 为物流公司代码,可通过 taobao.logistics.companies.get 获取
3)taobao.logistics.online.confirm 非发货API ,仅在使用 taobao.logistics.online.send 发货未输入运单号out_sid的前提下需要使用
4)如拆单发货,除tid、out_sid、company_code 3参数外,还需加sub_tid 和 is_split 两个参数 。sub_tid 表示子订单号(即oid),查询订单时可获取,is_split 输入1表示拆单。更多拆单说明可参考://open.taobao.com/doc/detail.htm?id=101521
- 关于此文档暂时还没有FAQ