1.    背景

极兔国际新物流对接

沟通渠道

微信群【智汇创想&极兔国际】---确定好开发人员后进群

api文档：http://47.57.3.201/yunlu-developer-document/

账号信息（正式环境账号，测试前请先沟通）

域名：https://api.yl-scm.com/

key:bda57020d8902331d0a578da15aa9000
customerid:SJ00021237
eccompanyid:LianHeChuangX  

2.    功能设计

1）预生成

接口：

东南亚在线下单接口：https://api.yl-scm.com/yunlu-order-web/order/orderAction!createOrder.action

欧美在线下单接口：https://api.yl-scm.com/yl-crs-openplatform-api/europe/order/create

重要参数说明：

txlogisticid，传系统订单号
mailno，运单号，不填
oldtxlogisticid，原始订单号，不填
oldmailno，原始运单编号，不填

ordertype，订单类型，传1

servicetype，服务类型，传1

sender，发件人信息，传回邮地址信息

receiver，收件人信息，传订单信息

sendstarttime，取货开始时间，传订单时间当天早上8点

sendendtime，取货截至时间，传订单时间当天晚上20点

weight，重量，优先取物流申报规则中设置的重量，再取产品信息中的包裹重，最后取产品信息中的毛重

goodstype，产品类型，传值根据物流属性api配置中的设置进行传值

产品配置逻辑：【IrobotBox-物流商API管理-物流属性API配置】中，将1开头的传值给goodstype，传值为物流属性CODE；

用户配置逻辑：配置产品物流属性，形成ERP产品物流属性和物流商之间的映射关系

其它常规字段，取产品信息中数据即可，不重复罗列，不清楚及时沟通

2）取消预生成

接口：

在线取消订单接口：https://api.yl-scm.com/yunlu-order-web/order/orderAction!cancelOrder.action

【客户订单-清空订单和包裹追踪号】操作时，执行

3）获取面单

接口：

电子面单打印接口：https://api.yl-scm.com/yunlu-order-web/rotaPrin/rotaPrintAction!getPrintUrl.action

printmode，传2，2为批量打印，减少请求次数，防止物流商限制

4）获取追踪号

接口：

订单信息查询接口：https://api.yl-scm.com/yunlu-order-web/order/orderAction!queryOrderInfo.action

txlogisticid，物流订单号，保存到物流商单号字段中
endTrackingNo，末端追踪号，保存到追踪号字段中

5）运输方式API管理

api地址，根据产品配置api地址，api地址只是域名部分，也就是https://api.yl-scm.com

市场，不同的市场预生成地址不同，也就是除去域名的后半部分

关税支付方式，选择第三方，传1，不选择默认传1

• #50729 11876【客户订单】运输方式API中，市场选择【东南亚】后手动预生成追踪号
• #50730 11876【客户订单】运输方式API中，市场选择【欧美】后自动预生成追踪号
• #50731 11876【客户订单】清空订单和包裹追踪号，调用取消接口，清除后台追踪号
• #50732 11876【客户订单】清空订单包裹追踪号后，重新预生成，获取新的追踪号
• #50733 11876【客户订单】运输方式中，面单选择物流商面单，在包裹页面，打印默认面单
• #50734 11876【客户订单】海关编码，未生包预生成，优先取产品海关编码
• #50735 11876【客户订单】海关编码，已生包预生成，取包裹海关编码
• #50736 11876【客户订单】预生成取值逻辑验证，申报规则中配置产品长宽高，预生成取值产品单个包装尺寸的长宽高
• #50737 11876【客户订单】预生成取值逻辑验证，订单存在多个产品，则取产品单个包装尺寸最大值
• #50738 11876【客户订单】预生成取值逻辑验证，预报的运输方式中，有配置申报规则，则优先取申报规则中设置的币种
• #50739 11876【客户订单】预生成取值逻辑验证，运输方式中，没有配置申报规则，则取订单的币种
• #50740 11876【客户订单】预生成取值逻辑验证，运输方式中，有配置申报规则，则优先取申报规则中配置的申报重量
• #50741 11876【客户订单】预生成取值逻辑验证，运输方式中，没有配置申报规则，则取包裹申报重量
• #50742 11876【客户订单】订单未生成包裹，运输方式未配置申报规则，按产品维度，则取单个产品毛重
• #50743 11876【客户订单】订单未生成包裹，运输方式未配置申报规则，按订单维度，订单存在多个产品取值逻辑
• #50744 11876【客户订单】当前运输方式有配置申报规则，则优先取申报规则中的申报价格
• #50745 11876【客户订单】当前运输方式没有配置申报规则，则优先取包裹中的报关价格
• #50746 11876【客户订单】订单未生成包裹，运输方式未配置申报规则，则取订单产品中的报关价
• #50747 11876【客户订单】产品链接，取申报规则中配置的链接