任务描述
需求描述
1. 需求概述
1.1. 背景
Tophatter合作物流商，彗吉科技物流，支持合单功能，即同一买家从不同卖家购买产品，使用彗吉科技物流发货，可以合单，降低物流成本
此需求需对接订单和物流，这是物流部分，订单部分为：
10249 【订单】Tophatter平台合单标识对接
订单物流需配合调试
2. 功能设计
2.1. 预报
2.1.1 需求说明
接口链接：https://x-port.com.cn/api/v2/m/e/orders/create_cb
1）在物流商运输方式中，添加彗吉科技物流
2）需要添加的参数为：
api名称；---文本框
是否激活；---复选框
密钥；---文本框
3）预报后
3.1）如果返回的结果为0，表示预报成功；将返回的logistics_order_id保存到物流商单号中，并增加一条日志：订单【********】预生成成功,物流API【***】,物流商单号【***】,等待物流商返回审核结果,版本【**】,预生成策略名称【***】,预生成策略编号【*】
3.1.1）异步获取追踪号，获取追踪号接口：https://x-port.com.cn/api/v2/m/l/orders/status；
3.1.1.1）当接口返回状态为“init”时，忽略，继续异步获取追踪号；
3.1.1.2）当接口返回状态为“reviewing”时，忽略，继续异步获取追踪号；
3.1.1.3）当接口返回状态为“rejected”时，表示审核失败，将description展示在错误信息中，停止异步获取追踪号，清空物流商单号，调用https://x-port.com.cn/api/v2/m/e/order/cancel_bind_lo取消预报；
3.1.1.4）当接口返回状态为“pending_pick_up”时，表示审核成功，将返回的barcode保存到追踪号中，停止异步获取追踪号；
3.1.1.5）接口返回其他状态时，忽略，不管审核成功还是失败，异步队列已停止，不会获取到其他状态；
3.2）如果返回的结果不为0，表示预报失败，将返回的msg和data错误信息拼接后，提示出来；
2.1.2 原型界面
2.2. 查询物流单状态
2.2.1 需求说明
接口链接：https://x-port.com.cn/api/v2/m/l/orders/status；
如上3.1.1异步获取追踪号的时候调用
2.3. 获取面单
2.3.1 需求说明
接口链接：https://x-port.com.cn/api/v2/m/l/orders/labels
通过订单号，获取面单
2.4. 取消预报
2.4.1 需求说明
接口链接：https://x-port.com.cn/api/v2/m/e/order/cancel_bind_lo
如上3.1.1.3审核失败时，取消预报使用
验收标准
api文档：https://thoughts.teambition.com/share/60474dc2b3dab9004210b146#title=Open_Merchant_API
测试信息
账号：XportTest71
AccessToken: GxX2+DpX9Ktze9+yLO0PU02pxJzsisSHHZz1PbQMA9c=
customerid=1 ordercode=202112211610885141,接口耗时0.074538秒 请求参数：{
"service_number":1,
"order_ids":["2021122118"],
"platform":"TOPHATTER",
"pick_up_address":{
"lang":"zh",
"country":"CHN",
"state":"广东",
"city":"深圳",
"street":"龙岗",
"street_detail":"坂田",
"zipcode":"581000",
"first_name":"名称",
"last_name":"名称",
"phone":"13112345678"
},
"customs":[
{"order_id": "2021122118","name_en": "Irobotbox","name_loc": "中文","type": "normal","weight": 30.000,"value": "5.00","currency": "USD","code": "5619335"}
]
} 响应参数：{"code":500,"msg":"The order[2021122118] is not found","data":null}