省仓JITX对接白皮书
文档版本更新记录
| 版本号 | 时间 | 更新内容 |
|---|---|---|
| 1.0 | 2020年4月2日 | 创建 |
一、省仓JITX方案
1. 名词解释
| 电商仓：为电商业务提供发货服务的仓库（在接口中warehouse_type=0） |
| 门店仓：指品牌的线下门店（在接口中warehouse_type=1） |
| 省仓：在全国各个区域为门店进行配货的区域仓库（部分供应商电商仓和省仓为同一物理仓，在接口中warehouse_type=2） |
2. 背景
JITX门店业务开展过程中，很多供应商希望对接省仓，但是省仓无法满足JIT的发货时效，只能发JITX订单，该方案旨在供应商把各仓库库存同步至唯品会，唯品会根据各个仓库库存直接下发JITX订单，该方案无需供应商进行寻仓，也不会出现JIT订单。
3.省仓JITX的注意事项
1.省仓支持一仓发全国
2.省仓JITX订单与普通JITX订单一样，不支持拆单
3.供应商同时有多个省仓库存，可以提前指定唯品会生成订单后扣减库存的顺序，由供应链同学进行配置。
4.省仓JITX单独一个档期，订单之间可以互相改派，但需要注意的是，省仓有新的订单转入或者转出的时候会有库存的变动，需要及时将最新的库存更新平台。
二、省仓JITX对接流程图
库存对接参考：库存对接白皮书
JITX常规对接参考：JITX对接白皮书
1.省仓库存同步整体对接流程变化
2.接口变动如下
2.1 获取合作编码信息接口getCooperationNoList
出参新增枚举值
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jitx_subtype | String | 否 | JITX子类型，0-仅门店；1-仅省仓； |
2.1 获取可用JITX仓库配置getWarehouses
出参新增枚举值
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| warehouse_type | String | 是 | 仓库类型 (省仓：2 店仓：1 存储仓库：0) |
2.2 实时销售订单查询getInventoryOccupiedOrders
出参新增字段
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| warehouse_flag | Integer | 否 | 仓库编码标识 0：全国逻辑仓或7大仓；1：省仓 默认为全国逻辑仓或7大仓 |
用法：若为省仓的时效订单，warehouse_flag=1，warehouse=省仓编码，供应商需要根据此标示占用省仓的库存。
2.3 已取消订单查询getInventoryCancelledOrders
出参新增字段
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| warehouse_flag | Integer | 否 | 仓库编码标识 0：全国逻辑仓或7大仓；1：省仓 默认为全国逻辑仓或7大仓 |
用法：若为省仓的时效订单，warehouse_flag=1，warehouse=省仓编码，供应商需要根据此标示释放省仓的库存占用。
2.4 商品库存查询getSkuStock
出参新增字段
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| warehouse_flag | Integer | 否 | 仓库编码标识 0：全国逻辑仓或7大仓；1：省仓 默认为全国逻辑仓或7大仓 |
用法：通过此接口可以查询唯品会占用的库存（购物车和未支付订单占用），如果供应商采用共享库存的模式，需要再同步其他平台的时候扣减唯品会占用的库存，避免超卖。如果供应商既做门店JITX也做省仓JITX，接口会返回多条数据，全国逻辑仓一条，省仓有几个就返回几条。
2.5 更新商品库存updateInventory
入参新增字段
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| warehouse_flag | Integer | 否 | 仓库编码标识 0：全国逻辑仓或7大仓；1：省仓 默认为全国逻辑仓或7大仓 |
用法：供应商id、常态合作编码、仓码和条码唯一确定一个商品，这4个参数必传。省仓更新库存warehouse字段传省仓编码（省仓仓库编码通过getWarehouses 获取省仓类型），同时传warehouse_flag=1。