简要描述:
- 库存异地通知
接口说明:
- 1.1接口描述:WMS调用奇门的接口,将库存异动信息信息回传给ERP
- 1.2接口说明:库存异动信息信息回传给ERP,ERP自行处理
- 1.3接口方法: taobao.qimen.stockchange.report
接口版本:
| 版本号 | 制定人 | 制定日期 | 修订日期 |
|---|---|---|---|
| 1.0.0 | 石明科 | 2020-08-07 | 2020-08-07 |
请求头:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型,统一是 application/xml |
请求参数:
公共请求参数
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| appkey | app_key | 是 | String | 应用接入时申请的 appkey | |
| 接口方法 | method | 是 | String | ERP 相关的业务接口名称,如商品信息同步的请求,method= taobao.qimen.item.synchronize | |
| 协议版本号 | v | 是 | String | 版本号 默认请传3.0 | |
| content 格式 | format | 是 | String | 目前支持 XML | |
| 加密令牌 | sign | 是 | String | 根据 url 和密钥计算的结果 | |
| 加密方法 | sign_method | 是 | String | md5 | |
| 用户id | customerid | 是 | String | WMS 颁发给用户的 ID | |
| 请求时间 | timestamp | 是 | String | yyyy-MM-dd HH:mm:ss 格式 |
request
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| item 信息 | items | 否 | Item[] | item |
| 扩展属性 | extendProps | 否 | Map | 扩展属性 |
item
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 货主编码 | ownerCode | 是 | String | 货主编码 |
| 仓库编码 | warehouseCode | 是 | String | 仓库编码 |
| 单据编码 | orderCode | 是 | String | 引起异动的单据编码 |
| 单据类型 | orderType | 否 | String | 单据类型(JYCK=一般交易出库单;HHCK=换货出库;BFCK=补发出库;PTCK=普通出库单;DBCK=调拨出库;B2BRK=B2B入 库;B2BCK=B2B出库;QTCK=其他出库;SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK= 调拨入库;QTRK= 其他入 库;XTRK= 销退入库;HHRK= 换货入库;CNJG= 仓内加工单) |
| 外部业务编码 | outBizCode | 是 | String | 外部业务编码(消息ID;用于去重;用来保证因为网络等原因导致重复传输;请求不会被重复处理) |
| 商品编码 | itemCode | 是 | String | 商品编码 |
| 仓储系统商品ID | itemId | 否 | String | 仓储系统商品ID |
| 库存类型 | inventoryType | 否 | String | 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存) |
| 商品变化量 | quantity | 是 | int | 商品变化量(可为正为负) |
| 批次编码 | batchCode | 否 | String | 批次编码 |
| 商品生产日期 | productDate | 否 | String | 商品生产日期(YYYY-MM-DD) |
| 商品过期日期 | expireDate | 否 | String | 商品过期日期(YYYY-MM-DD) |
| 生产批号 | produceCode | 否 | String | 生产批号 |
| 异动时间 | changeTime | 否 | String | 异动时间(YYYY-MM-DD HH:MM:SS) |
| batchs | batchs | 否 | Batch[] | batchs |
| 备注 | remark | 否 | String | 备注 |
| isLocked | isLocked | 否 | String | isLocked |
batch
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 批次编号 | batchCode | 否 | String | 批次编号 |
| 生产日期 | productDate | 否 | String | 生产日期(YYYY-MM-DD) |
| 过期日期 | expireDate | 否 | String | 过期日期(YYYY-MM-DD) |
| 生产批号 | produceCode | 否 | String | 生产批号 |
| 库存类型 | inventoryType | 否 | String | 库存类型(ZP=正品;CC=残次;JS=机损 XS= 箱损;ZT=在途库存) |
| 异动数量 | quantity | 否 | int | 异动数量(要求batchs节点下所有的异动数量之和等于orderline中的异动数量) |
返回参数:
response
| 参数名 | 类型 | 说明 |
|---|---|---|
| flag | String | 响应结果:success |
| code | String | 响应码 |
| message | String | 响应信息 |
| requestId | String | 查询返回的唯一编码 |
请求示例(xml)
<?xml version="1.0" encoding="utf-8"?>
<request>
<items>
<item>
<ownerCode>货主编码, string (50) , 必填</ownerCode>
<warehouseCode>仓库编码, string (50),必填</warehouseCode>
<orderCode>引起异动的单据编码,string(50),必填</orderCode>
<orderType>单据类型 ,string(50),JYCK= 一般交易出库单,HHCK= 换货出 库 ,BFCK= 补发出库 PTCK=普通出库单,DBCK=调拨出库 ,QTCK=其他出库, SCRK=生产入库,LYRK=领用入库,CCRK=残次品入库,CGRK=采购入库 ,DBRK= 调 拨入库 ,QTRK= 其他入库 ,XTRK= 销退入库 HHRK= 换货入库 CNJG= 仓内加工单 ZTTZ=状态调整单</orderType>
<outBizCode>外部业务编码, 消息 ID, 用于去重,用来保证因为网络等原因导致重复 传输,请求不会被重复处理,必填</outBizCode>
<itemCode>商品编码, string (50) , 必填</itemCode>
<itemId>仓储系统商品 ID, string (50),条件必填</itemId>
<inventoryType>库存类型,string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结</inventoryType>
<isLocked>库存是否冻结, Y|N</isLocked>
<quantity>商品变化量,int,必填,可为正为负</quantity>
<batchCode>批次编码, string (50)</batchCode>
<productDate>商品生产日期 YYYY-MM-DD</productDate>
<expireDate>商品过期日期 YYYY-MM-DD</expireDate>
<produceCode>生产批号, string (50)</produceCode>
<changeTime>异动时间, string (19) , YYYY-MM-DD HH:MM:SS</changeTime>
<batchs>
<!-- 同一商品下多批次支持-->
<batch>
<batchCode>批次编号,string(50)</batchCode>
<productDate>生产日期,string(10),YYYY-MM-DD</productDate>
<expireDate>过期日期,string(10),YYYY-MM-DD</expireDate>
<produceCode>生产批号,string(50),</produceCode>
<inventoryType>库存类型,string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结</inventoryType>
<quantity>异动数量, int,要求 batchs 节点下所有的异动数量之和等于 orderline 中的异动数量</quantity>
</batch>
</batchs>
<remark>备注, string (500)</remark>
</item>
</items>
</request>
返回示例(xml):
正确时返回:
<response>
<flag>success</flag>
<code>0</code>
<message>invalid appkey</message>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</response>错误时返回:
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</error_response>备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-07 14:48 作者:石明科