开发文档
库存业务
1.3.1 场景介绍
1.3.1.1 增量
对于白天营业中库存的变动（对于变动可能是增加库存，也可能是减少库存），增量的实时同步到ReX平台。这里强调需要尽量实时的同步到ReX平台，如果延迟比较大的话出现超卖的概率会非常高，尤其是做活动期间的爆品或者库存数量不多的SKU。
1.3.1.2 全量
对于新品，ERP需要保障新品在上线之前把对应的销售库存传输到ReX平台。
对于日结之后的全量覆盖，日结之后商家ERP中的库存是最准确的，为了保障第二天开始销售的库存是准确的，需要商家日结之后全量的覆盖一次库存。在技术实现上如果能识别出来动销品的话，则只需要把有动销的商品的销售库存覆盖即可，减少数据通信的量，如果识别不出来，则把全部线上商品的销售库存覆盖。
1.3.2 业务流程
1.3.3 接口说明
需要对接接口：alibaba.wdk.stock.publish(五道口库存发布接口）
| batch_stock_publish_dto结构字段说明 |
||||||
| 字段名称 |
字段简称 |
是否必填 |
类型 |
示例1 |
字段说明 |
|
| update_type |
更新类型 |
必填 |
int |
1 |
全量1，增量2 :全量是覆盖；增量是累加 |
|
| bill_no |
外部单据号 |
必填 |
varchar |
10220181026002240275203 |
外部单据号，这个单据号需要全局唯一，对于相同的单据号ReX库存中心在处理的时候会做幂等操作，所以同一个单据第二次操作是不会做任何业务操作。一般可以使用商家的业务单据流水号。 |
|
| bill_type |
外部单据类型 |
必填 |
int |
9001 |
外部单据类型; 由ReX开放平台技术支持统一分配，每个商家唯一分配一个 |
|
| publish_source |
发布来源 |
|
varchar |
RT |
发布来源，填写分配给商家的商家编码 |
|
| warehouse_code |
仓编码 |
|
varchar |
CSOS01102 |
ReX中台分配的门店CODE |
|
| shop_code |
经营店编码 |
必填 |
varchar |
CSOS01102 |
ReX中台分配的门店CODE |
|
| operator |
操作者 |
必填 |
varchar |
NRNR |
单据的操作人员 |
|
| channel_source_id |
渠道店编号 |
必填 |
varchar |
185267192 |
渠道店编号（ReX中台分配的门店渠道ID，纯数字的。） |
|
| channel_source_type |
渠道店类型 |
必填 |
varchar |
4 |
渠道店类型，这里固定填4，代表是淘鲜达业务渠道类型 |
|
| batch_stock_publish_dto.stock_publish_dtos字段说明。 |
||||||
| 字段名称 |
字段简称 |
是否必填 |
类型 |
示例1 |
字段说明 |
|
| sku_code |
商品编码 |
必填 |
varchar |
98426 |
商品编码，最大支持20个不重复商品，商家的单据中商品列表可能会多余20个，此时需要对商家的单据进行拆分。 |
|
| quantity |
更新数量 |
必填 |
varchar |
59 |
库存更新数量(当主单据类型update_type为1时按照此值做销售库存全量覆盖；当update_type为2时按照商家传递的正负值做销售库存的增减) |
|
| order_no |
订单号（商品粒度） |
必填 |
varchar |
10218106044001 |
订单号（商品粒度）;每条商品明细的子单据号，一定要保障全局唯一，否则系统处理会出现异常。一般可以采用bill_no+skucode的形式来保障。 |
|
| order_type |
订单类型 |
必填 |
varchar |
|
||
| order_desc |
订单描述 |
|
varchar |
|
子订单描述 |
|
1.3.4 使用说明
在ReX中台商家门店视角portal后台，访问商品库存策略页面，路径为门店视角—库存策略管理—商品库存策略，如下图所示，安全保留量+APP可售库存=erp实际库存，增量库存同步时可观察同步前后的APP可售库存变化量
