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

测试信息

• #38003 对接慧吉科技物流预生成功能
• #38004 对接慧吉科技物流转单号功能
• #38005 对接慧吉科技物流面单下载功能
• #38006 对接慧吉科技物流删除订单功能