JITX对接白皮书
文档版本更新记录
| 版本号 | 时间 | 更新内容 |
|---|---|---|
| 1.0 | 2019年 | 创建 |
| 1.1 | 2020年3月2日 | 改仓接口上线 |
| 1.2 | 2022年6月17日 | 补充一单多包说明 |
| 1.3 | 2022年8月31日 | 补充补寄订单说明 |
1. JITX业务介绍
在JIT 采购档期下，对符合条件的订单，支持供应商直接发货给客户。 
2. JITX API调用流程图
库存
需要将时效订单的库存预占转换为JITX订单的库存预占，逻辑变动详见红色标记部分，未标记部分与JIT流程相同。 
订单
3. JITX业务接口列表
| 接口说明 | 接口链接 | 注意事项 |
|---|---|---|
| 多仓场景中获取供应商仓库在唯品会平台的代码、仓库名称和地址信息，寻仓和发货回写反馈仓码时需使用此接口返回的仓码 | 获取可用JITX仓库配置 | 禁止使用ERP本地仓库代码。 |
| 轮询该接口获取所有待寻仓订单 | 获取待寻仓订单 | 当拉到status_list=ROLLBACK状态的待寻仓订单，说明该订单已经转为JIT，需要释放此部分待寻仓订单的库存占用。 |
| 反馈寻仓结果 | 反馈寻仓结果 | 需要在30分钟内反馈待寻仓订单的发货仓仓码，超时未反馈或反馈仓库不在待寻仓订单的仓库列表（available_warehouses）中，待寻仓订单都将会判定为JIT订单 |
| 拉取订单接口 | 拉取订单接口 | 接口入参查询的订单时间为最后更新时间；JITX没有单独的取消单接口和修改订单接口，需要通过轮询该接口获取订单的最新状态和明细；当接口中的订单为禁发状态（is_forbidden_delivery=1），需要将禁发的订单hold住，直到状态变为“非禁发”。 |
| 获取运单号接口 | 获取运单号订单接口 | 当需要一单多包时，master_transport_no字段必须传入主运单号，packages字段必须传入自定义包裹号，自定义包裹号在同一订单内不可重复 |
| 获取补寄订单运单号接口 | 获取补寄订单运单号接口 | 当order_type=5时，必须使用此接口获取补寄订单号 |
| 获取面单 | 获取面单 | 该接口提供html和json两种面单格式供选择，html格式自带面单模板，可以通过接口获取模板和面单数据直接打印面单；JSON格式需要供应商&ISV依据唯品会面单模板要求绘制模板，并通过接口获取面单数据，然后打印面单。详情可参考JITX面单标准。 |
| 新增/修改原始条形码和序列号,每次调用将覆盖之前的记录 | 新增/修改原始条形码和序列号 | 用于防伪码/唯一码等身份对接 |
| 查询商品身份码 | 查询商品身份码 | 用于防伪码/唯一码等对接 |
| 发货服务 | 发货服务 | 回写时需使用唯品会指定的运单号（随JITX订单下发及一单多包所获取的子运单号）和仓码，禁止供应商自行向承运商下单回写平台。详见【JITX合包】对接白皮书 |
| 创建改仓工单 | 创建改仓工单 | 发货回写后不支持改仓；申请改仓后，10分钟后可通过获取改仓工单接口获取改仓结果；改仓没有次数限制；改仓后会下发新的运单号需要使用新的运单号进行发货回写 |
| 获取改仓工单 | 获取改仓工单 | 申请改仓后，10分钟后可通过获取改仓工单接口获取改仓结果 |
| 创建发货重置工单 | JitX发货重置创建接口 | “已发货”状态才可以发货重置 |
| 获取发货重置工单 | 获取发货重置工单 | 申请改仓后，10分钟后可通过获取发货重置工单接口获取发货重置结果 |
4. 常见问题
| 问题 | 解决办法 |
|---|---|
| 为何获取不到赠品订单 | 检查cooperation_nos入参是否有值，有的话要加上赠品的合作编码，或者不传该参数 |
| 为何获取不到换货订单 | 检查order_types入参是否有值，有的话要加上2和4，或者不传该参数 |
| 为何获取不到禁发订单 | 检查is_forbidden_delivery入参是否有值，有的话要加上1，或者不传该参数 |
| 为何获取不到补寄订单 | 检查order_types入参是否有值，有的话要加上5，或者不传该参数。另外，补寄订单没有合作编码，所以不能传cooperation_nos获取 |
| 补寄订单要运单号要如何获取 | 通过接口getRedeliverTransportNoVop获取，可不受限于当前唯品会仓码 |
| 补寄订单如何回传发货 | 通过接口jitXShip回传，delivery_warehouse不校验 |