对接前言

1、文献参考链接

此文档基于奇门开发文档(仓储API),结合旺店通实际线上业务情景进行编写,奇门文档参考地址:https://open.taobao.com/docs/api_list.htm?spm=a219a.7629065.0.0.q7Vmwy&cid=20725

2、基础概念解析

2.1 拓展节点

奇门的非叶子节点下都提供扩展节点,如WMS与ERP有特殊业务需求,奇门标准的字段无法满足业务需求时,双方可以通过约定节点名称,使用扩展节点下发信息。

2.2 幂等处理

———摘自奇门技术文档

幂等处理机制为必要处理机制,除了奇门文档中所述的防止死循环外,现实业务也防止仓储系统(WMS)多次收单,以免造成多发货的情况。注意取消和推送的正向接口,WMS都需要支持幂等处理。

2.3 残次品仓

部分客户实际的业务中,可能会涉及到残次品仓的概念,基于仓储系统(WMS)对残次品的管理模式,旺店通系统(ERP)会进行不同的管理模式。

  1. 分仓管理

该情况仓储系统(WMS)残次品仓,可以直接与旺店通系统(ERP)对接。WMS提供一个残次仓库编码,ERP建立正常的奇门仓即可。

  1. 分货位管理
  • 实际场景:对仓储系统(WMS)回传给旺店通系统(ERP)中的货品数据进行解析,将残次品数据存放在残次品库中管理展示。
  • ERP操作:该情况残次品仓在旺店通系统(ERP)中会与一个正品仓进行映射匹配(映射的正品仓为客户实际的业务仓),不会单独进行使用。在客户业务中出现残次品数据时,对残次品数据进行管理。
  • 接口对接:残次品的解析规则是基于报文中的 inventoryType字段,“CC/JS/XS”解析为残次品,不回传或者“ZP”解析为正品。

3、业务与接口浅析

3.1 销售订单多物流回传

  • 业务场景:一单销售订单推给WMS之后,WMS分多个物流进行发货回传一单多物流单号到ERP。
  • 接口对接:仓储系统需要回传多个package给ERP系统,每个package都带有一个物流单号,ERP系统会在前端单据日志中记录多个物流单号。注意,多包裹不能有相同的物流单号,实际业务也不允许!

3.2 出入库单

  • 部分出入库:仓库回传的货品数量小于下发数量。例如一张单据计划入库100件,实际到货50件。
  • 分批出入库:仓库对某一单进行多次回传。例如一张单据计划出库100件,仓储系统分多次出掉这批货品(如分四次出库:每次数量分别为20,20,50,10)。
  • 批次出入库:仓储系统入/出库回传时,附带批次号、生产日期、有效期等信息。
  • 残次出入库:对残次品的存放进行处理,详情解析请见<前言2.3>。

3.3 字段与报文说明关系

示例报文为旺店通系统实际线上的报文示例(即,真实环境下所下发报文结构),WMS开发人员可以根据报文分析ERP所下发的节点信息情况,下发的节点信息说明详见[字段映射],内容包含字段的业务功能以及场景解释。供开发人员参考。