背景
云订货

云订货订单需发货必须要满足以下条件:

• flow_status="pending_deliver"(待发货),即订单流程状态为待发货状态;
• complete_status="0"(进行中),即订单完成状态为进行中;
• deliver_status="0"(未发货)或者"3"(部分发货),即订单发货状态为未发货状态或者部分发货状态;

云订货支持部分发货,可以先生成不同的包裹,按包裹发货.

云商城

云商城订单需发货必须要满足以下条件:

• complete_status="0"(进行中),即订单完成状态为进行中;
• deliver_status="0"(未发货),即订单发货状态为未发货状态;
• pay_status="1"(已支付)或者 pay_status="0"(未支付)并且pay_type_id="GRP"(货到付款),即订单状态为已支付或者是未付款(货到付款)
• is_sh_ship="false" 是否屏蔽发货,false代表买家没有申请退款退货,可发货;

云商城订单现阶段只支持整单发货

API名称	API描述
qianmi.cloudshop.logistics.address.search	查询商家地址库列表
qianmi.cloudshop.logistics.companies.get	查询商家常用的物流公司列表
qianmi.cloudshop.logistics.online.send	通用订单在线发货处理（整单发货）,云订货和云商城整单发货均可调用
qianmi.cloudshop.d2c.logistics.send	云商城(D2C)订单发货处理（仅云商城整单发货）
qianmi.cloudshop.d2p.trade.pack	（云订货(D2P)订单出库生成包裹单,(可选),可不生成包裹直接调用部分发货接口进行发货
qianmi.cloudshop.d2p.logistics.packs.get	（根据云订货(D2P)订单获取包裹列表
qianmi.cloudshop.d2p.logistics.send	云订货(D2P)订单发货处理(支持部分发货)

第一步:获取待发货订单(仅自营订单)

1:通过查询订单接口,参考订单同步文档,根据发货条件,筛选待发货订单,到ISV工具软件.

2:通过消息服务获取增量订单到ISV工具软件

第二步:获取商家常用物流公司列表及地址库列表

1:调用qianmi.cloudshop.logistics.address.search接口获取商家地址库信息保存到ISV工具软件中,并可根据增删改接口进行同步.

2:商家将千米标准物流公司添加到自己常用列表中,即产生一个商家常用物流公司列表(code编码一致),调用qianmi.cloudshop.logistics.companies.get接口商家已添加的常用物流公司列表.

第三步:判断订单发货条件

根据Trade中site字段判断销售渠道是云订货还是云商城,在根据上面的发货条件进行判断.

第四步:发货处理

1:云商城订单发货为整单发货,可调用通用整单发货接口qianmi.cloudshop.logistics.online.send和云商城专用发货接口qianmi.cloudshop.d2c.logistics.send

2:云订货订单如果整单发货可以调用通用整单发货接口qianmi.cloudshop.logistics.online.send

3:云订货订单如果要拆单发货(部分发货),可以先调用打包接口qianmi.cloudshop.d2p.trade.pack生成包裹(该步骤可选),再调用qianmi.cloudshop.d2p.logistics.send云订货部分发货接口

4:company_id为发货必填的物流公司编号,卖家物流公司信息LogistisCompany中的ID字段(非code字段)

随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。

近一年来，电子面单的普及已是大势所趋。究其原因，是因为电子面单具备的独特优势：

1:效率高

• 提升打印效率：电子面单的打印效率是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促；
• 提高发货效率：电子面单不需要把快递单和定单信息逐一匹配操作，在订单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升；减少了手写“大头笔”等动作，提高了分拣效率；提高了分拣的准确性；

2:成本低

• 电子面单的纸张是0.1元/张，成本比传统纸质面单0.2-0.3元降低了一大半；
• 降低快递公司作业成本，如取消抽单和手写大头笔，单位时间内的揽货可以提升一倍以上；

2:数据准确完整

• 减少了手写“大头笔”等动作，数据直接来源订单中,并且提高了分拣效率；提高了分拣的准确性；

为了更好地支持第三方电子面单打印工具接入,千米网提供了相关接口支持,相关步骤如下:

1:调用qianmi.cloudshop.logistics.companies.info.list接口,同步千米官方标准物流公司信息到打单工具中.

2:将LogisticsCompanyInfo中code字段(物流公司编码)与打单工具中的快递公司唯一编码做一一映射.

3:批量抓取待发货订单中的收件人信息,商家选择快递公司模板进行打单操作.