简要描述:

  • 库存异地通知

接口说明:

  • 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   作者:石明科