奇门白皮书-接口说明

更新时间：2024/08/05 访问次数：195297

5. 接口说明

5. 接口说明

注：所有非叶子节点下都可以增加remark和extendProps。

remark

<remark>备注，string(500)</remark>

extendProps使用key-value结构，

<extendProps>扩展属性
           <key1>value1</key1> 
           <key2>value2</key2>
            …
         </extendProps>

5.1 商品查询接口

5.1.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.singleitem.query。

奇门调用WMS的API名称：singleitem.query。

5.1.2 入参规范

<?xml version="1.0" encoding="utf-8"?>
<request>
  <ownerCode>货主编码, string (50) , 必填</ownerCode> 
  <itemCode>商品编码,  string (50) ,  必填</itemCode> 
<itemId>仓储系统商品编码, string (50) , 条件必填, 该字段是WMS分配的商品编号，WMS如果分配了商品编码，则后续的商品操作都需要传该字段，如果WMS不使用，WMS可以返回itemId=itemCode的值 </itemId>   
</request>

5.1.3 出参规范

<?xml version="1.0" encoding="utf-8"?>
<response>
  <flag>success|failure</flag> 
  <code>响应码</code> 
  <message>响应信息</message> 
  <item>
      <itemCode>商品编码,  string (50) ,  必填</itemCode> 
<itemId>仓储系统商品编码, string (50) , 条件必填, 该字段是WMS分配的商品编号，WMS如果分配了商品编码，则后续的商品操作都需要传该字段，如果WMS不使用，WMS可以返回itemId=itemCode的值 </itemId>  
<goodsCode>货号，string（50）</goodsCode>
      <itemName>商品名称,  string (200) , 必填</itemName> 
      <shortName>商品简称,  string (200) </shortName> 
<englishName>英文名, string (200) </englishName> 
<barCode>条形码,  string (500) , 可多个，用分号（;）隔开，必填</barCode>
      <skuProperty>商品属性 (如红色, XXL) ,  string (200) </skuProperty> 
      <stockUnit>商品计量单位,  string (50) </stockUnit> 
      <length>长 (厘米) ,  double (18, 2) </length> 
      <width>宽 (厘米) ,  double (18, 2) </width> 
      <height>高 (厘米) ,  double (18, 2) </height> 
      <volume>体积 (升) ,  double (18, 3) </volume> 
      <grossWeight>毛重 (千克) ,  double (18, 3) </grossWeight> 
      <netWeight>净重 (千克) ,  double (18, 3) </netWeight> 
      <color>颜色,  string (50) </color> 
      <size>尺寸,  string (50) </size> 
      <title>渠道中的商品标题, string (200) </title> 
      <categoryId>商品类别ID, string (50) </categoryId> 
      <categoryName>商品类别名称,  string (200) </categoryName> 
      <pricingCategory>计价货类, string (200) </pricingCategory> 
      <safetyStock>安全库存, int</safetyStock> 
      <itemType>商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) ,  string (10) , 必填,  (只传英文编码) </itemType> 
      <tagPrice>吊牌价, double (18, 2) </tagPrice> 
      <retailPrice>零售价, double (18, 2) </retailPrice> 
      <costPrice>成本价, double (18, 2) </costPrice> 
      <purchasePrice>采购价, double (18, 2) </purchasePrice> 
      <seasonCode>季节编码,  string (50) </seasonCode> 
      <seasonName>季节名称,  string (50) </seasonName> 
      <brandCode>品牌代码,  string (50) </brandCode> 
      <brandName>品牌名称,  string (50) </brandName> 
      <isSNMgmt>是否需要串号管理, Y/N (默认为N) </isSNMgmt> 
      <productDate>生产日期, string (10) , YYYY-MM-DD</productDate> 
      <expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate> 
      <isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为N) </isShelfLifeMgmt> 
      <shelfLife>保质期 (小时) , int</shelfLife> 
      <rejectLifecycle>保质期禁收天数, int</rejectLifecycle> 
      <lockupLifecycle>保质期禁售天数, int</lockupLifecycle>
      <adventLifecycle>保质期临期预警天数, int</adventLifecycle>
      <isBatchMgmt>是否需要批次管理, Y/N (默认为N) </isBatchMgmt> 
      <batchCode>批次代码, string (50) </batchCode> 
      <batchRemark>批次备注, string (200) </batchRemark> 
      <packCode>包装代码, string (50) </packCode> 
      <pcs>箱规, string(50)</pcs> 
      <originAddress>商品的原产地, string (50) </originAddress> 
      <approvalNumber>批准文号, string (50) </approvalNumber> 
      <isFragile>是否易碎品, Y/N,  (默认为N) </isFragile> 
      <isHazardous>是否危险品, Y/N,  (默认为N) </isHazardous>
      <isLiquid>是否液体, Y/N,  (默认为N) </isLiquid> 
      <remark>备注,  string (500) </remark> 
      <createTime>创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
      <updateTime>更新时间, string (19) , YYYY-MM-DD HH:MM:SS</updateTime> 
      <isValid>是否有效, Y/N (默认为Y) </isValid> 
      <isSku>是否sku, Y/N,  (默认为Y) </isSku> 
      <packageMaterial>商品包装材料类型, string (200) </packageMaterial>
      <extendProps>
        <key1>value1</key1> 
        <key2>value2</key2>
      </extendProps>
    </item>
</response>

5.2 商品同步接口

5.2.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.singleitem.synchronize。

奇门调用WMS的API名称：singleitem.synchronize。

注：奇门接口都是同步接口，响应成功表示商品已经同步成功，而不只是消息接收成功。

5.2.2 入参规范

<?xml version="1.0" encoding="utf-8"?>
<request>
  <actionType>add|update, 必填</actionType> 
  <warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode> 
  <ownerCode>货主编码, string (50) , 必填</ownerCode> 
  <supplierCode>供应商编码, string (50) </supplierCode> 
  <supplierName>供应商名称, string (200) </supplierName> 
   <item>
      <itemCode>商品编码,  string (50) ,  必填</itemCode> 
<itemId>仓储系统商品编码, string (50) , 条件必填, 该字段是WMS分配的商品编号，WMS如果分配了商品编码，则后续的商品操作都需要传该字段，如果WMS不使用，WMS可以返回itemId=itemCode的值 </itemId>  
<goodsCode>货号，string（50）</goodsCode>
      <itemName>商品名称,  string (200) , 必填</itemName> 
      <shortName>商品简称,  string (200) </shortName> 
<englishName>英文名, string (200) </englishName> 
<barCode>条形码,  string (500) , 可多个，用分号（;）隔开，必填</barCode>
      <skuProperty>商品属性 (如红色, XXL) ,  string (200) </skuProperty> 
      <stockUnit>商品计量单位,  string (50) </stockUnit> 
      <length>长 (厘米) ,  double (18, 2) </length> 
      <width>宽 (厘米) ,  double (18, 2) </width> 
      <height>高 (厘米) ,  double (18, 2) </height> 
      <volume>体积 (升) ,  double (18, 3) </volume> 
      <grossWeight>毛重 (千克) ,  double (18, 3) </grossWeight> 
      <netWeight>净重 (千克) ,  double (18, 3) </netWeight> 
      <color>颜色,  string (50) </color> 
      <size>尺寸,  string (50) </size> 
      <title>渠道中的商品标题, string (200) </title> 
      <categoryId>商品类别ID, string (50) </categoryId> 
      <categoryName>商品类别名称,  string (200) </categoryName> 
      <pricingCategory>计价货类, string (200) </pricingCategory> 
      <safetyStock>安全库存, int</safetyStock> 
      <itemType>商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) ,  string (10) , 必填,  (只传英文编码) </itemType> 
      <tagPrice>吊牌价, double (18, 2) </tagPrice> 
      <retailPrice>零售价, double (18, 2) </retailPrice> 
      <costPrice>成本价, double (18, 2) </costPrice> 
      <purchasePrice>采购价, double (18, 2) </purchasePrice> 
      <seasonCode>季节编码,  string (50) </seasonCode> 
      <seasonName>季节名称,  string (50) </seasonName> 
      <brandCode>品牌代码,  string (50) </brandCode> 
      <brandName>品牌名称,  string (50) </brandName> 
      <isSNMgmt>是否需要串号管理, Y/N (默认为N) </isSNMgmt> 
      <productDate>生产日期, string (10) , YYYY-MM-DD</productDate> 
      <expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate> 
      <isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为N) </isShelfLifeMgmt> 
      <shelfLife>保质期 (小时) , int</shelfLife> 
      <rejectLifecycle>保质期禁收天数, int</rejectLifecycle> 
      <lockupLifecycle>保质期禁售天数, int</lockupLifecycle>
      <adventLifecycle>保质期临期预警天数, int</adventLifecycle>
      <isBatchMgmt>是否需要批次管理, Y/N (默认为N) </isBatchMgmt> 
      <batchCode>批次代码, string (50) </batchCode> 
      <batchRemark>批次备注, string (200) </batchRemark> 
      <packCode>包装代码, string (50) </packCode> 
      <pcs>箱规, string(50)</pcs> 
      <originAddress>商品的原产地, string (50) </originAddress> 
      <approvalNumber>批准文号, string (50) </approvalNumber> 
      <isFragile>是否易碎品, Y/N,  (默认为N) </isFragile> 
      <isHazardous>是否危险品, Y/N,  (默认为N) </isHazardous>
      <isLiquid>是否液体, Y/N,  (默认为N) </isLiquid>
      <remark>备注,  string (500) </remark> 
      <createTime>创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
      <updateTime>更新时间, string (19) , YYYY-MM-DD HH:MM:SS</updateTime> 
      <isValid>是否有效, Y/N (默认为Y) </isValid> 
      <isSku>是否sku, Y/N,  (默认为Y) </isSku> 
      <packageMaterial>商品包装材料类型, string (200) </packageMaterial>
      <logisticsType>销售配送方式（0=自配|1=菜鸟）,  string (10) </logisticsType>
      <extendProps>
        <key1>value1</key1> 
        <key2>value2</key2>
      </extendProps>
    </item>
</request>

5.2.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<itemId>仓储系统商品Id, string (50) ,条件必填，当这个字段不为空的时候, 所有erp传输的时候都碰到itemid必传</itemId>

</response>

5.3 商品同步接口 (批量)

5.3.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.items.synchronize。

奇门调用WMS的API名称：items.synchronize。

5.3.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<actionType>add|update, 必填</actionType>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<items>

<item>

<supplierCode>供应商编码, string (50) </supplierCode>

<supplierName>供应商名称, string (200) </supplierName>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填, 条件为商品同步接口, 出参itemId不为空</itemId>

<goodsCode>货号，string（50）</goodsCode>

<itemName>商品名称, string (200) , 必填</itemName>

<shortName>商品简称, string (200) </shortName>

<englishName>英文名, string (200) </englishName>

<barCode>条形码, string (500) , 可多个，用分号（;）隔开，必填</barCode>

<skuProperty>商品属性 (如红色, XXL) , string (200) </skuProperty>

<stockUnit>商品计量单位, string (50) </stockUnit>

<length>长 (厘米) , double (18, 2) </length>

<width>宽 (厘米) , double (18, 2) </width>

<height>高 (厘米) , double (18, 2) </height>

<volume>体积 (升) , double (18, 3) </volume>

<grossWeight>毛重 (千克) , double (18, 3) </grossWeight>

<netWeight>净重 (千克) , double (18, 3) </netWeight>

<color>颜色, string (50) </color>

<size>尺寸, string (50) </size>

<title>渠道中的商品标题, string (200) </title>

<categoryId>商品类别ID, string (50) </categoryId>

<categoryName>商品类别名称, string (200) </categoryName>

<pricingCategory>计价货类, string (200) </pricingCategory>

<itemType>商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) , string (10) , 必填, (只传英文编码) </itemType>

<tagPrice>吊牌价, double (18, 2) </tagPrice>

<retailPrice>零售价, double (18, 2) </retailPrice>

<costPrice>成本价, double (18, 2) </costPrice>

<purchasePrice>采购价, double (18, 2) </purchasePrice>

<seasonCode>季节编码, string (50) </seasonCode>

<seasonName>季节名称, string (50) </seasonName>

<brandCode>品牌代码, string (50) </brandCode>

<brandName>品牌名称, string (50) </brandName>

<isSNMgmt>是否需要串号管理, Y/N (默认为N) </isSNMgmt>

<productDate>生产日期, string (10) , YYYY-MM-DD</productDate>

<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate>

<isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为N) </isShelfLifeMgmt>

<rejectLifecycle>保质期禁收天数, int</rejectLifecycle>

<lockupLifecycle>保质期禁售天数, int</lockupLifecycle>

<adventLifecycle>保质期临期预警天数, int</adventLifecycle>

<isBatchMgmt>是否需要批次管理, Y/N (默认为N) </isBatchMgmt>

<batchCode>批次代码, string (50) </batchCode>

<batchRemark>批次备注, string (200) </batchRemark>

<packCode>包装代码, string (50) </packCode>

<pcs>箱规, string(50)</pcs>

<originAddress>商品的原产地, string (50) </originAddress>

<approvalNumber>批准文号, string (50) </approvalNumber>

<isFragile>是否易碎品, Y/N, (默认为N) </isFragile>

<isHazardous>是否危险品, Y/N, (默认为N) </isHazardous>

<remark>备注, string (500) </remark>

<createTime>创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

<updateTime>更新时间, string (19) , YYYY-MM-DD HH:MM:SS</updateTime>

<isSku>是否sku, Y/N, (默认为Y) </isSku>

<packageMaterial>商品包装材料类型, string (200) </packageMaterial>

<logisticsType>销售配送方式（0=自配|1=菜鸟）, string (10) </logisticsType>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</item>

</items>

</request>

5.3.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure，只要有一个失败flag就置为failure，如果是success，就忽略下面的items节点</flag>

<items>

<item>

<itemCode>没有同步成功的商品的编码，必填</itemCode>

</item>

</items>

</response>

5.4 组合商品接口

5.4.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.combineitem.synchronize。

奇门调用WMS的API名称：combineitem.synchronize。

5.4.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<itemCode>组合商品的ERP编码, string (50) , 必填</itemCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>后端商品编码，string（50），必填</itemId>

<quantity>组合商品中的该商品个数，int，必填</quantity>

</item>

</items>

</request>

5.4.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.5 创建前后端商品映射接口

5.5.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.itemmapping.create。

奇门调用WMS的API名称：itemmapping.create。

5.5.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<actionType>add|update, 必填</actionType>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<shopNick>店铺名称, string (50)</shopNick>

<itemSource>商品来源, string (50) </itemSource>

<itemId>后端商品编码，string（50），必填</itemId>

<shopItemId>店铺商品id，string（50），必填</shopItemId>

<skuId>商品skuId，string（50）</skuId>

</request>

5.5.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.6 前后端商品映射查询接口

5.6.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.itemmapping.query。

奇门调用WMS的API名称：itemmapping.query。

5.6.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemId>后端商品编码，string（50），必填</itemId>

<shopItemId>店铺商品id，string（50），必填</shopItemId>

<skuId>商品skuId，string（50）</skuId>

</request>

5.6.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<shopNick>店铺名称, string (50)</shopNick>

<itemSource>商品来源, string (50) </itemSource>

<itemId>后端商品编码，string（50），必填</itemId>

<shopItemId>店铺商品id，string（50），必填</shopItemId>

<skuId>商品skuId，string（50）</skuId>

</itemMapping>

</itemMappings>

</response>

5.7 入库单创建接口

5.7.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.entryorder.create。

奇门调用WMS的API名称：entryorder.create。

注：

1）调拨接口其实可以拆分为出库单创建+入库单创建，同时可以考虑使用该接口中的relatedOrders字段。

2）该接口以及后面的出库单创建、发货单创建都是同步接口，ERP调用创建接口后，WMS的响应报文success说明WMS已经将该入库单创建成功，而不仅仅是消息接收成功。而后面的confirm接口是回告ERP入库已经完成。

5.7.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<totalOrderLines>单据总行数，int，当单据需要分多个请求发送时，发送方需要将totalOrderLines填入，接收方收到后，根据实际接收到的条数和totalOrderLines进行比对，如果小于，则继续等待接收请求。如果等于，则表示该单据的所有请求发送完成。

</totalOrderLines>

<entryOrderCode>入库单号, string (50) , 必填</entryOrderCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<purchaseOrderCode>采购单号，string(50)，当orderType=CGRK时，使用</purchaseOrderCode>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<orderCreateTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</orderCreateTime>

<orderType>业务类型 (SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库，DBRK=调拨入库, QTRK=其他入库，B2BRK=B2B入库,XNRK=虚拟入库 string (50) , (只传英文编码) </orderType>

<orderType>关联的订单类型，CG=采购单，DB=调拨单, CK=出库单，RK=入库单，string (50) , (只传英文编码)</orderType>

<orderCode>关联的订单编号，string(50)</orderCode>

</relatedOrder>

</relatedOrders>

<expectStartTime>预期到货时间, string (19) , YYYY-MM-DD HH:MM:SS</expectStartTime>

<expectEndTime>最迟预期到货时间, string (19) , YYYY-MM-DD HH:MM:SS</expectEndTime>

<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO) 、HTKY=百世汇通、BSKY=百世快运、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦快运、RRS=日日顺、HTKY=极兔速递、DISTRIBUTOR_30464910=丰网速运、OTHER=其他(只传英文编码) </logisticsCode>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<supplierCode>供应商编码 string (50) </supplierCode>

<supplierName>供应商名称 string (200) </supplierName>

<operatorCode>操作员编码, string (50) </operatorCode>

<operatorName>操作员名称, string (50) </operatorName>

<operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>

<company>公司名称, string (200) </company>

<name>姓名, string (50) </name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) </mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) </province>

<city>城市, string (50) </city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) </detailAddress>

</senderInfo>

<company>公司名称, string (200) </company>

<name>姓名, string (50) </name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) </mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) </province>

<city>城市, string (50) </city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) </detailAddress>

</receiverInfo>

<remark>备注, string (500) </remark>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</entryOrder>

<outBizCode>外部业务编码, 消息ID, 用于去重，当单据需要分批次发送时使用 </outBizCode>

<orderLineNo>入库单的行号，string（50）</orderLineNo>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID,string(50)，条件必填</itemId>

<sn>商品序列号, string(50) </sn>

</snList>

<itemName>商品名称, string (200) </itemName>

<planQty>应收商品数量, int, 必填</planQty>

<skuProperty>商品属性, string (200) </skuProperty>

<purchasePrice>采购价, double (18, 2) </purchasePrice>

<retailPrice>零售价, double (18, 2) </retailPrice>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP</inventoryType>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<batchCode>批次编码, string (50) </batchCode>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</orderLine>

</orderLines>

</request>

5.7.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<entryOrderId>仓储系统入库单编码, string (50) </entryOrderId>

</response>

5.8 入库单确认接口

5.8.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.entryorder.confirm。

奇门调用ERP的API名称：entryorder.confirm。

5.8.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

</totalOrderLines>

<entryOrderCode>入库单编码, string (50) , 必填</entryOrderCode>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<entryOrderId>仓储系统入库单ID, string (50) , 条件必填</entryOrderId>

<entryOrderType>入库单类型，SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库, DBRK=调拨入库, QTRK=其他入库，B2BRK=B2B入库</entryOrderType>

<outBizCode>外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理, ,必填</outBizCode>

<confirmType>支持出入库单多次收货, int，

多次收货后确认时

0 表示入库单最终状态确认；

1 表示入库单中间状态确认；

每次入库传入的数量为增量，特殊情况，同一入库单，如果先收到0，后又收到1，允许修改收货的数量。

</confirmType>

<status>入库单状态, string (50) , 必填 (NEW-未开始处理, ACCEPT-仓库接单 , PARTFULFILLED-部分收货完成, FULFILLED-收货完成, EXCEPTION-异常, CANCELED-取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败) , (只传英文编码) </status>

<freight>快递费用 (元) , double (18, 2) </freight>

<operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS，(当status=FULFILLED, operateTime为入库时间) </operateTime>

<remark>备注, string (500) </remark>

</entryOrder>

<outBizCode>外部业务编码, 消息ID, 用于去重，当单据需要分批次发送时使用 </outBizCode>

<orderLineNo>单据行号，string（50）</orderLineNo>

<ownerCode>货主编码, string (50) </ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50) , 条件必填</itemId>

<sn>商品序列号, string(50) </sn>

</snList>

<itemName>商品名称, string (200) </itemName>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP, (收到商品总数=正品数+残品数+机损数+箱损数+废品数) </inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期，string（10）， YYYY-MM-DD</productDate>

<expireDate>商品过期日期，string（10），YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<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= 箱损,FP=废品,默认为ZP, (收到商品总数=正品数+残品数+机损数+箱损数+废品数) </inventoryType>

<actualQty>实收数量, int，要求batchs节点下所有的实收数量之和等于orderline中的实收数量</actualQty>

</batch>

</batchs>

<remark>备注, string (500) </remark>

</orderLine>

</orderLines>

</request>

5.8.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.9 入库单查询接口

5.9.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.entryorder.query。

奇门调用WMS的API名称：entryorder.query。

5.9.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<entryOrderCode>入库单编码, string (50) , 必填</entryOrderCode>

<entryOrderId>仓储系统入库单ID, string (50) , 条件必填</entryOrderId>

<pageSize>每页orderLine条数（最多100条），必填</pageSize>

</request>

5.9.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int，必填</totalLines>

<entryOrderCode>入库单编码, string (50) , 必填</entryOrderCode>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<entryOrderId>仓储系统入库单ID, string (50) , 条件必填</entryOrderId>

<entryOrderType>入库单类型，SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库, DBRK=调拨入库, QTRK=其他入库，B2BRK=B2B入库</entryOrderType>

<operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS，(当status=FULFILLED, operateTime为入库时间) </operateTime>

</entryOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50) , 条件必填</itemId>

<itemName>商品名称, string (200) </itemName>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP, (收到商品总数=正品数+残品数+机损数+箱损数+废品数)

</inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期，string（10）， YYYY-MM-DD</productDate>

<expireDate>商品过期日期，string（10），YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<remark>备注, string (500) </remark>

</orderLine>

</orderLines>

</response>

5.10 退货入库单创建接口

5.10.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.returnorder.create。

奇门调用WMS的API名称：returnorder.create。

注：该接口和入库单的区别就是该接口是从入库单接口中单独剥离出来的，专门处理退货引起的入库操作。

5.10.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<returnOrderCode>ERP的退货入库单编码, string (50) , 必填</returnOrderCode>

<ownerCode>货主编码, string (50)</ownerCode>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<orderType>单据类型, string (50)，THRK=退货入库，HHRK=换货入库 (只传英文编码)</orderType>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、（淘系）美家U选=MJYX、WXXSD=微信小商店、WXSPHXD=微信视频号小店、JDVMI=京东VMI、OTHERS=其他) </sourcePlatformCode>

<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName>

<shopNick>店铺名称, string (200) </shopNick>

<sellerNick>卖家名称, string (200) </sellerNick>

<orderFlag>用字符串格式来表示订单标记列表：比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL 等, 中间用“^”来隔开订单标记list (所有字母全部大写) ： VISIT=上门；SELLER_AFFORD=是否卖家承担运费 (默认是) ；SYNC_RETURN_BILL=同时退回发票；FETCH_RETURN=菜鸟大件上门取退；</orderFlag>

<preDeliveryOrderCode>原出库单号（ERP分配）, string(50) ,必填</preDeliveryOrderCode>

<preDeliveryOrderId>原出库单号（WMS分配）, string (50)，条件必填</preDeliveryOrderId>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<returnReason>退货原因, string (200) </returnReason>

<buyerNick>买家昵称, string (50) </buyerNick>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</senderInfo>

<remark>备注, string (500) </remark>

</returnOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填，条件为提供后端（仓储系统）商品编码的仓储系统</itemId>

<sn>商品序列号, string(50)</sn>

</snList>

<inventoryType>库存类型, string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP, </inventoryType>

<planQty>应收商品数量, int, 必填</planQty>

<batchCode>批次编码, string (50) </batchCode>

<productDate>生产日期, string (10) , YYYY-MM-DD</productDate>

<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

</orderLine>

</orderLines>

</request>

5.10.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<returnOrderId>仓储系统退货单编码, string (50) </returnOrderId>

</response>

5.11 退货入库单确认接口

5.11.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.returnorder.confirm。

奇门调用ERP的API名称：returnorder.confirm。

5.11.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<returnOrderCode>退货单编码, string (50) , 必填</returnOrderCode>

<returnOrderId>仓库系统订单编码, string (50) , 条件必填</returnOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<outBizCode>外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理</outBizCode>

<orderType>单据类型, string（50）,THRK=退货入库单，HHRK=换货入库 </orderType>

<orderConfirmTime>确认入库时间, string (19) ,YYYY-MM-DD HH:MM:SS</orderConfirmTime>

<returnReason>退货原因, string (200) </returnReason>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</senderInfo>

<remark>备注, string (500) </remark>

支持退货入库单多次入库, int，

多次收货后确认时

0 表示入库单最终状态确认；

1 表示入库单中间状态确认；

</confirmType>

</returnOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填 (条件为菜鸟仓) </itemId>

<sn>商品序列号, string(50) </sn>

</snList>

<inventoryType>库存类型, string (50) , ZP=正品, CC=残次, JS=机损, XS=箱损,FP=废品,默认为ZP</inventoryType>

<planQty>应收商品数量, int</planQty>

<actualQty>实收商品数量, int, 必填</actualQty>

<batchCode>批次编码, string (50) </batchCode>

<productDate>生产日期, string (10) , YYYY-MM-DD</productDate>

<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<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=箱损,FP=废品,默认为ZP</inventoryType>

<actualQty>实收数量, int，要求batchs节点下所有的实收数量之和等于orderline中的实收数量</actualQty>

</batch>

</batchs>

<qrCode>商品的二维码（类似电子产品的SN码），用来进行商品的溯源，多个二维码之间用分号（;）隔开</qrCode>

</orderLine>

</orderLines>

</request>

5.11.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.12 退货入库单查询接口

5.12.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.returnorder.query。

奇门调用WMS的API名称：returnorder.query。

5.12.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<returnOrderCode>退货单编码, string (50) , 必填</returnOrderCode>

<returnOrderId>仓库系统订单编码, string (50) , 条件必填</returnOrderId>

<pageSize>每页orderLine条数（最多100条），必填</pageSize>

</request>

5.12.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int，必填</totalLines>

<returnOrderCode>退货单编码, string (50) , 必填</returnOrderCode>

<returnOrderId>仓库系统订单编码, string (50) , 条件必填</returnOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>单据类型, string（50）,THRK=退货入库单，HHRK=换货入库 </orderType>

<orderConfirmTime>确认入库时间, string (19) ,YYYY-MM-DD HH:MM:SS</orderConfirmTime>

<returnReason>退货原因, string (200) </returnReason>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</senderInfo>

<remark>备注, string (500) </remark>

</returnOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填 (条件为菜鸟仓) </itemId>

<inventoryType>库存类型, string (50) , ZP=正品, CC=残次, JS=机损, XS=箱损,FP=废品, 默认为ZP</inventoryType>

<planQty>应收商品数量, int</planQty>

<actualQty>实收商品数量, int, 必填</actualQty>

<batchCode>批次编码, string (50) </batchCode>

<productDate>生产日期, string (10) , YYYY-MM-DD</productDate>

<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<qrCode>商品的二维码（类似电子产品的SN码），用来进行商品的溯源，多个二维码之间用分号（;）隔开</qrCode>

</orderLine>

</orderLines>

</response>

5.13 出库单创建接口

5.13.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.stockout.create。

奇门调用WMS的API名称：stockout.create。

注：该接口和发货单的区别是，发货单创建是和订单相关的发货操作，而该接口是普通的货品出库，和订单无关。

5.13.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

</totalOrderLines>

<deliveryOrderCode>出库单号（ERP分配）, string (50) , 必填</deliveryOrderCode>

<targetEntryOrderCode>关联的入库单号（ERP分配）, string (50)</targetEntryOrderCode>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、(淘系)美家U选=MJYX、WXXSD=微信小商店、WXSPHXD=微信视频号小店、JDVMI=京东VMI、OTHERS=其他) </sourcePlatformCode>

<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName>

<orderType>出库单类型, string (50) , 必填, PTCK=普通出库单，DBCK=调拨出库，B2BCK=B2B出库，SCCK=生产出库，QTCK=其他出库，CGTH=采购退货出库单,XNCK=虚拟出库单</orderType>

<orderType>关联的订单类型，CG=采购单，DB=调拨单, CK=出库单，RK=入库单，VIPDG = 唯品会JIT业务送仓单，string (50) , (只传英文编码)</orderType>

<orderCode>关联的订单编号，string(50)</orderCode>

</relatedOrder>

</relatedOrders>

<warehouseCode>出库仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<warehouseName>出库仓库名称, string (50) </warehouseName>

<targetWarehouseCode>入库仓库编码, string (50) ，统仓统配等无需ERP指定仓储编码的情况填OTHER</targetWarehouseCode>

<targetWarehouseName>入库仓库名称, string (50) </targetWarehouseName>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<createTime>出库单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填 </createTime>

<scheduleDate>要求出库时间, string (10) , YYYY-MM-DD</scheduleDate>

<shippingTime>送货时间, string (10) , YYYY-MM-DD HH:MM:SS</shippingTime>

<receivingTime>到货时间, string (10) , YYYY-MM-DD HH:MM:SS</receivingTime>

<logisticsName>物流公司名称（包括干线物流公司等）, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<supplierCode>供应商编码 string (50) </supplierCode>

<supplierName>供应商名称 string (200) </supplierName>

<company>公司名称, string (200) </company>

<name>姓名, string (50) </name>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) </mobile>

<id>证件号，string(50)</id>

<carNo>车牌号，string(50)</carNo>

</pickerInfo>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , </name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , </mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , </province>

<city>城市, string (50) , </city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) </detailAddress>

<id>证件号，string(50)</id>

</senderInfo>

<company>公司名称, string (200) </company>

<name>姓名（注：当出库为调拨出库时，这里填写为目标仓库编码）, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

<id>证件号，string(50)</id>

</receiverInfo>

<remark>备注, string (500) </remark>

</deliveryOrder>

<outBizCode>外部业务编码, 消息ID, 用于去重，当单据需要分批次发送时使用 </outBizCode>

<orderLineNo>单据行号，string（50）</orderLineNo>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) ,条件必填</itemId>

<itemName>商品名称, string (200) </itemName>

<brandCode>品牌代码, string (50) </brandCode>

<brandName>品牌名称, string (50) </brandName>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP</inventoryType>

<planQty>应发商品数量, int, 必填</planQty>

<retailPrice>零售价, double (18, 2)</retailPrice>

<actualPrice>实际成交价, double (18, 2)</actualPrice>

<purchasePrice>采购价, double (18, 2) </purchasePrice>

<batchCode>批次编码，仓配的批次编码，和生产批号不同, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号，产品的生产批次, string (50) </produceCode>

</orderLine>

</orderLines>

</request>

5.13.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId>

<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

</response>

5.14 出库单确认接口

5.14.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.stockout.confirm。

奇门调用ERP 的API名称：stockout.confirm。

5.14.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

</totalOrderLines>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>出库单类型, string (50)，PTCK=普通出库单，DBCK=调拨出库，B2BCK=B2B出库，QTCK=其他出库，，CGTH=采购退货出库单，必填</orderType>

<status>出库单状态, string (50) (NEW-未开始处理, ACCEPT-仓库接单 , PARTDELIVERED-部分发货完成, DELIVERED-发货完成, EXCEPTION-异常, CANCELED-取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败) , (只传英文编码) </status>

<outBizCode>string (50) , 外部业务编码, 外部业务编码, 同一请求的唯一性标示编码。ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理，条件必填，条件为一单需要多次确认时 </outBizCode>

<confirmType>支持出库单多次发货, int，

多次发货后确认时

0 表示发货单最终状态确认；

1 表示发货单中间状态确认；

</confirmType>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>

</deliveryOrder>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<packageCode>包裹编号, string (50) </packageCode>

<length>包裹长度 (厘米) , double (18, 2) </length>

<width>包裹宽度 (厘米) , double (18, 2) </width>

<height>包裹高度 (厘米) , double (18, 2) </height>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<volume>包裹体积 (升, L) , double (18, 3) </volume>

<type>包材型号, string (50) </type>

<quantity>包材的数量, int</quantity>

</packageMaterial>

</packageMaterialList>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<quantity>包裹内该商品的数量, int, 必填</quantity>

</item>

</items>

</package>

</packages>

<outBizCode>外部业务编码, 消息ID, 用于去重，当单据需要分批次发送时使用 </outBizCode>

<orderLineNo>单据行号，string（50）</orderLineNo>

<itemCode>商品编码, string (50) ，必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<sn>商品序列号, string(50)</sn>

</snList>

<itemName>商品名称, string (200) </itemName>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP</inventoryType>

<actualQty>实发商品数量, int，必填</actualQty>

<batchCode>批次编号，string(50)，</batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

<produceCode>生产批号，string(50)，</produceCode>

<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= 箱损,FP=废品,默认为ZP</inventoryType>

<actualQty>实发数量, int，要求batchs节点下所有的实发数量之和等于orderline中的实发数量</actualQty>

</batch>

</batchs>

</orderLine>

</orderLines>

</request>

5.14.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.15 出库单查询接口

5.15.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.stockout.query。

奇门调用WMS 的API名称：stockout.query。

5.15.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<pageSize>每页orderLine条数（最多100条），必填</pageSize>

</request>

5.15.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int，必填</totalLines>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>出库单类型, string (50)，PTCK=普通出库单，DBCK=调拨出库，B2BCK=B2B出库，QTCK=其他出库，CGTH=采购退货出库单，必填</orderType>

<status>出库单状态, string (50) , 必填 (NEW-未开始处理, ACCEPT-仓库接单 , PARTDELIVERED-部分发货完成, DELIVERED-发货完成, EXCEPTION-异常, CANCELED-取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败) , (只传英文编码) </status>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>

</deliveryOrder>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode>

<packageCode>包裹编号, string (50) </packageCode>

<length>包裹长度 (厘米) , double (18, 2) </length>

<width>包裹宽度 (厘米) , double (18, 2) </width>

<height>包裹高度 (厘米) , double (18, 2) </height>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<volume>包裹体积 (升, L) , double (18, 3) </volume>

<type>包材型号, string (50) </type>

<quantity>包材的数量, int</quantity>

</packageMaterial>

</packageMaterialList>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<quantity>包裹内该商品的数量, int, 必填</quantity>

</item>

</items>

</package>

</packages>

<orderLineNo>单据行号，string（50）</orderLineNo>

<itemCode>商品编码, string (50) ，必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<itemName>商品名称, string (200) </itemName>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损，G=特殊品(百世物流),FP=废品,默认为ZP</inventoryType>

<actualQty>实发商品数量, int，必填</actualQty>

<batchCode>批次编号，string(50)，</batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

<produceCode>生产批号，string(50)，</produceCode>

</orderLine>

</orderLines>

</response>

5.16 发货单创建接口

5.16.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.deliveryorder.create。

奇门调用WMS的API名称：deliveryorder.create。

注：该接口和出库单创建接口的区别是该接口处理订单引起的发货，而出库单只处理和订单无关的出库。

5.16.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<preDeliveryOrderCode>原出库单号（ERP分配）, string (50) , 条件必填，条件为换货出库</preDeliveryOrderCode>

<preDeliveryOrderId>原出库单号（WMS分配）, string (50) , 条件必填，条件为换货出库</preDeliveryOrderId>

<orderType>出库单类型, string (50) , 必填, JYCK=一般交易出库单, HHCK=换货出库单, BFCK=补发出库单，QTCK=其他出库单</orderType>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<orderFlag>订单标记，用字符串格式来表示订单标记列表：比如COD, 中间用“^”来隔开，string (200) ， COD =货到付款 , LIMIT=限时配送 , PRESELL=预售 , COMPLAIN=已投诉 , SPLIT=拆单, EXCHANGE=换货, VISIT=上门 , MODIFYTRANSPORT=是否可改配送方式, 是否可改配送方式默认可更改 , CONSIGN =物流宝代理发货, 自动更改发货状态 SELLER_AFFORD =是否卖家承担运费默认是, 即没 , FENXIAO=分销订单，TCPS=区域零售</orderFlag>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、(淘系)美家U选=MJYX、WXXSD=微信小商店、WXSPHXD=微信视频号小店、AKC=爱库存、JDVMI=京东VMI、OTHERS=其他) </sourcePlatformCode>

<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName>

<createTime>发货单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填 </createTime>

<placeOrderTime>前台订单 (店铺订单) 创建时间 (下单时间) , string (19) , YYYY-MM-DD HH:MM:SS, 必填</placeOrderTime>

<payTime>订单支付时间, string (19) , YYYY-MM-DD HH:MM:SS</payTime>

<payNo>支付平台交易号, string(50), 淘系订单传支付宝交易号</payNo>

<serviceCode>服务编码, string (50)， NCWLJH=集包, 条件必填，条件为集包订单发货</serviceCode>

<operatorCode>操作员 (审核员) 编码, string (50) </operatorCode>

<operatorName>操作员 (审核员) 名称, string (50) </operatorName>

<operateTime>操作 (审核) 时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填</operateTime>

<shopNick>店铺名称, string (200) , 必填</shopNick>

<sellerNick>卖家名称, string (200) </sellerNick>

<buyerNick>买家昵称, string (200) </buyerNick>

<totalAmount>订单总金额 (元) , double (18, 2) , 订单总金额=应收金额+已收金额=商品总金额-订单折扣金额+快递费用</totalAmount>

<itemAmount>商品总金额 (元) , double (18, 2) </itemAmount>

<discountAmount>订单折扣金额 (元) , double (18, 2) </discountAmount>

<freight>快递费用 (元) , double (18, 2) </freight>

<arAmount>应收金额 (元) , 消费者还需要支付多少（货到付款时消费者还需要支付多少约定使用这个字段）, double (18, 2) </arAmount>

<gotAmount>已收金额 (元) , 消费者已经支付多少, double (18, 2) </gotAmount>

<serviceFee>COD服务费, double (18, 2) </serviceFee>

<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO) 、HTKY=百世汇通、BSKY=百世快运、BSKY=百世快运、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦快运、RRS=日日顺、 KYE=跨越物流、HTKY=极兔速递、DISTRIBUTOR_30464910=丰网速运、OTHER=其他，必填, (只传英文编码) </logisticsCode>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode> (面单号前置的情况)

<logisticsAreaCode>快递区域编码, 大头笔信息, string (50) </logisticsAreaCode>

<scheduleType>投递时延要求,int, 1=工作日,2=节假日,101=当日达,102=次晨达,103=次日达, 104=预约达</scheduleType>

<scheduleDay>要求送达日期, string (10) , YYYY-MM-DD</scheduleDay>

<scheduleStartTime>投递时间范围要求 (开始时间) , string (8) , HH:MM:SS</scheduleStartTime>

<scheduleEndTime>投递时间范围要求 (结束时间) , string (8) , HH:MM:SS</scheduleEndTime>

<deliveryType>发货服务类型，PTPS（普通配送），LLPS（冷链配送），HBP(环保配),YZD(圆准达),string(50)</deliveryType>

</deliveryRequirements>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</senderInfo>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<idType>收件人证件类型，string (50)， 1-身份证 2-军官证 3-护照 4-其他</idType>

<idNumber>收件人证件号码，string (50) </idNumber>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</receiverInfo>

<invoiceFlag>是否需要发票, Y/N, 默认为N</invoiceFlag>

<type>发票类型, string (50) , INVOICE=普通发票，VINVOICE=增值税普通发票, EVINVOICE=电子增票, 条件必填 (条件为invoiceFlag为Y) </type>

<header>发票抬头, string (200) , (条件为invoiceFlag为Y) </header>

<taxNumber>税号,string(50)</taxNumber>

<amount>发票总金额, double (18, 2) , (条件为invoiceFlag为Y) </amount>

<content>发票内容,string(500) ，不推荐使用</content>

<items>

<item>

<itemName>商品名称, string (50)</itemName>

<unit>商品单位, string (50)</unit>

<price>商品单价, double (18, 2)</price>

<amount>金额, double (18, 2)</amount>

</item>

</items>

</detail>

</invoice>

</invoices>

<insuranceFlag>是否需要保险, Y/N, 默认为N</insuranceFlag>

<type>保险类型, string (50) </type>

<amount>保险金额, double (18, 2) </amount>

</insurance>

<buyerMessage>买家留言, string (500) </buyerMessage>

<sellerMessage>卖家留言, string (500) </sellerMessage>

<remark>备注，string（500）</remark>

</deliveryOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<payNo>支付平台交易号, string(50), 淘系订单传支付宝交易号</payNo>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) ,条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<itemName>商品名称, string (200) </itemName>

<extCode>交易平台商品编码, string (50) </extCode>

<planQty>应发商品数量, int, 必填</planQty>

<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额</retailPrice>

<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice>

<discountAmount>单件商品折扣金额, double (18, 2) </discountAmount>

<batchCode>批次编码, string (50) </batchCode>

<produceCode>生产批号，string(50)，</produceCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

</orderLine>

</orderLines>

</request>

5.16.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId>

<warehouseCode>仓库编码（统仓统配使用），string(50)</warehouseCode>

<logisticsCode>物流公司编码（统仓统配使用）,string(50)</logisticsCode>

<deliveryOrders>----拆单

<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId>

<warehouseCode>仓库编码（统仓统配使用），string(50)</warehouseCode>

<logisticsCode>物流公司编码（统仓统配使用），string(50)</logisticsCode>

<orderLineNo> 行号，string(50)</orderLineNo>

<itemCode>ERP商品编码，string(50)</itemCode>

<itemId>WMS商品编码，string(50)</itemId>

<quantity>数量，string(50)</quantity>

</orderLine>

</orderLines>

<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

</deliveryOrder>

</deliveryOrders>

</response>

5.17 发货单创建接口（批量）

5.17.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.deliveryorder.batchcreate。

奇门调用WMS的API名称：deliveryorder.batchcreate。

5.17.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<order>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<preDeliveryOrderCode>原出库单号（ERP分配）, string (50) , 条件必填，条件为换货出库</preDeliveryOrderCode>

<preDeliveryOrderId>原出库单号（WMS分配）, string (50) , 条件必填，条件为换货出库</preDeliveryOrderId>

<orderType>出库单类型, string (50) , 必填, JYCK=一般交易出库单, HHCK=换货出库单, BFCK=补发出库单，QTCK=其他出库单</orderType>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、(淘系)美家U选=MJYX、OTHERS=其他)</sourcePlatformCode>

<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName>

<createTime>发货单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填 </createTime>

<placeOrderTime>前台订单 (店铺订单) 创建时间 (下单时间) , string (19) , YYYY-MM-DD HH:MM:SS, 必填</placeOrderTime>

<payTime>订单支付时间, string (19) , YYYY-MM-DD HH:MM:SS</payTime>

<payNo>支付平台交易号, string(50), 淘系订单传支付宝交易号</payNo>

<serviceCode>服务编码, string (50)， NCWLJH=集包, 条件必填，条件为集包订单发货</serviceCode>

<operatorCode>操作员 (审核员) 编码, string (50) </operatorCode>

<operatorName>操作员 (审核员) 名称, string (50) </operatorName>

<operateTime>操作 (审核) 时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填</operateTime>

<shopNick>店铺名称, string (200) , 必填</shopNick>

<sellerNick>卖家名称, string (200) </sellerNick>

<buyerNick>买家昵称, string (200) </buyerNick>

<totalAmount>订单总金额 (元) , double (18, 2) , 订单总金额=应收金额+已收金额=商品总金额-订单折扣金额+快递费用</totalAmount>

<itemAmount>商品总金额 (元) , double (18, 2) </itemAmount>

<discountAmount>订单折扣金额 (元) , double (18, 2) </discountAmount>

<freight>快递费用 (元) , double (18, 2) </freight>

<arAmount>应收金额 (元) , 消费者还需要支付多少（货到付款时消费者还需要支付多少约定使用这个字段）, double (18, 2) </arAmount>

<gotAmount>已收金额 (元) , 消费者已经支付多少, double (18, 2) </gotAmount>

<serviceFee>COD服务费, double (18, 2) </serviceFee>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) </expressCode> (面单号前置的情况)

<logisticsAreaCode>快递区域编码, 大头笔信息, string (50) </logisticsAreaCode>

<scheduleType>投递时延要求,int, 1=工作日,2=节假日,101=当日达,102=次晨达,103=次日达, 104=预约达</scheduleType>

<scheduleDay>要求送达日期, string (10) , YYYY-MM-DD</scheduleDay>

<scheduleStartTime>投递时间范围要求 (开始时间) , string (8) , HH:MM:SS</scheduleStartTime>

<scheduleEndTime>投递时间范围要求 (结束时间) , string (8) , HH:MM:SS</scheduleEndTime>

<deliveryType>发货服务类型，PTPS（普通配送），LLPS（冷链配送），HBP(环保配),string(50)</deliveryType>

</deliveryRequirements>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</senderInfo>

<company>公司名称, string (200) </company>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<idType>收件人证件类型，string (50)， 1-身份证 2-军官证 3-护照 4-其他</idType>

<idNumber>收件人证件号码，string (50) </idNumber>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</receiverInfo>

<invoiceFlag>是否需要发票, Y/N, 默认为N</invoiceFlag>

<type>发票类型, string (50) , INVOICE=普通发票，VINVOICE=增值税普通发票, EVINVOICE=电子增票, 条件必填 (条件为invoiceFlag为Y) </type>

<header>发票抬头, string (200) , (条件为invoiceFlag为Y) </header>

<taxNumber>税号,string(50)</taxNumber>

<amount>发票总金额, double (18, 2) , (条件为invoiceFlag为Y) </amount>

<content>发票内容,string(500) ，不推荐使用</content>

<items>

<item>

<itemName>商品名称, string (50)</itemName>

<unit>商品单位, string (50)</unit>

<price>商品单价, double (18, 2)</price>

<amount>金额, double (18, 2)</amount>

</item>

</items>

</detail>

</invoice>

</invoices>

<insuranceFlag>是否需要保险, Y/N, 默认为N</insuranceFlag>

<type>保险类型, string (50) </type>

<amount>保险金额, double (18, 2) </amount>

</insurance>

<buyerMessage>买家留言, string (500) </buyerMessage>

<sellerMessage>卖家留言, string (500) </sellerMessage>

<remark>备注，string（500）</remark>

</deliveryOrder>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) ,条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<itemName>商品名称, string (200) </itemName>

<extCode>交易平台商品编码, string (50) </extCode>

<planQty>应发商品数量, int, 必填</planQty>

<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额</retailPrice>

<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice>

<discountAmount>单件商品折扣金额, double (18, 2) </discountAmount>

<batchCode>批次编码, string (50) </batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

</orderLine>

</orderLines>

</order>

</orders>

</request>

5.17.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure，只要有一个失败flag就置为failure，如果是success，就忽略下面的orders节点</flag>

<order>

<deliveryOrderCode>出错的出库单号, string (50) , 必填</deliveryOrderCode>

</order>

</orders>

</response>

5.18 发货单创建结果通知接口（批量）

5.18.1 接口介绍

用于异步化的批量发货单创建结果通知。（如菜鸟发货单批量创建结果的返回）

WMS调用的奇门API名称：taobao.qimen.deliveryorder.batchcreate.answer。

奇门调用ERP的API名称：deliveryorder.batchcreate.answer。

5.18.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<order>

<deliveryOrderCode>发货单号, string (50) </deliveryOrderCode>

<flag>success|failure</flag>

<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId>

<warehouseCode>仓库编码（统仓统配使用），string(50)</warehouseCode>

<logisticsCode>物流公司编码（统仓统配使用）,string(50)</logisticsCode>

</orderInfo>

<deliveryOrders>----拆单

<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId>

<warehouseCode>仓库编码（统仓统配使用），string(50)</warehouseCode>

<logisticsCode>物流公司编码（统仓统配使用），string(50)</logisticsCode>

<orderLineNo> 行号，string(50)</orderLineNo>

<itemCode>ERP商品编码，string(50)</itemCode>

<itemId>WMS商品编码，string(50)</itemId>

<quantity>数量，string(50)</quantity>

</orderLine>

</orderLines>

<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime>

</deliveryOrder>

</deliveryOrders>

</order>

</orders>

</request>

5.18.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.19 发货单确认接口

5.19.1 接口介绍

场景说明：仓库出库单发货完成后, 把出库单和包裹信息回传给ERP, ERP自行决定如何处理。

WMS调用的奇门API名称：taobao.qimen.deliveryorder.confirm。

奇门调用ERP的API名称： deliveryorder.confirm。

5.19.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=补发出库，QTCK=其他出库单,必填</orderType>

<outBizCode>string (50) , 外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理，条件必填，条件为一单需要多次确认时 </outBizCode>

<confirmType>支持出库单多次发货, int，

多次发货后确认时

0 表示发货单最终状态确认；

1 表示发货单中间状态确认；

</confirmType>

<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>

<operatorCode>当前状态操作员编码, string (50) </operatorCode>

<operatorName>当前状态操作员姓名, string (50) </operatorName>

<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>

<storageFee>仓储费用，double (18, 2) </storageFee>

<header>发票抬头, string (200) </header>

<amount>发票金额, double (18, 2) </amount>

<content>发票内容, string(500) </content>

<items>

<item>

<itemName>商品名称, string (50)</itemName>

<unit>商品单位, string (50)</unit>

<price>商品单价, double (18, 2)</price>

<amount>金额, double (18, 2)</amount>

</item>

</items>

</detail>

<code>发票代码, string(50)，纳税企业的标识</code>

<number>发票号码, string(50)，纳税企业内部的发票号</number>

</invoice>

</invoices>

</deliveryOrder>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) , 必填</expressCode>

<packageCode>包裹编号, string (50) </packageCode>

<length>包裹长度 (厘米) , double (18, 2) </length>

<width>包裹宽度 (厘米) , double (18, 2) </width>

<height>包裹高度 (厘米) , double (18, 2) </height>

<theoreticalWeight>包裹理论重量 (千克) , double (18, 3) </theoreticalWeight>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<volume>包裹体积 (升, L) , double (18, 3) </volume>

<invoiceNo>发票号, string (500) </invoiceNo>

<type>包材型号, string (50) </type>

<quantity>包材的数量, int</quantity>

</packageMaterial>

</packageMaterialList>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<quantity>包裹内该商品的数量, int, 必填</quantity>

</item>

</items>

</package>

</packages>

<orderLineNo>单据行号，string（50）</orderLineNo>

<orderSourceCode>平台交易订单编码, string (50) </orderSourceCode>

<subSourceCode>平台交易子订单编码, string (50) </subSourceCode>

<ownerCode>货主编码, string (50) </ownerCode>

<itemCode>商品编码, string (50) </itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<sn>商品序列号, string(50)</sn>

</snList>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<ownerCode>货主编码，string(50)</ownerCode>

<itemName>商品名称, string (200) </itemName>

<extCode>交易平台商品编码, string (50) </extCode>

<planQty>应发商品数量, int</planQty>

<actualQty>实发商品数量, int</actualQty>

<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额</retailPrice>

<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice>

<discountAmount>单件商品折扣金额, double (18, 2) </discountAmount>

<batchCode>批次编号，string(50)，</batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

<produceCode>生产批号，string(50)，</produceCode>

<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=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<actualQty>实发数量, int，要求batchs节点下所有的实发数量之和等于orderline中的实发数量</actualQty>

</batch>

</batchs>

<qrCode>商品的二维码（类似电子产品的SN码），用来进行商品的溯源，多个二维码之间用分号（;）隔开</qrCode>

</orderLine>

</orderLines>

</request>

5.19.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.20 发货单确认接口 (批量)

5.20.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.deliveryorder.batchconfirm。

奇门调用ERP的API名称： deliveryorder.batchconfirm。

5.20.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<order>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=补发出库，QTCK=其他出库单,必填</orderType>

<confirmType>支持出库单多次发货, int，

多次发货后确认时

0 表示发货单最终状态确认；

1 表示发货单中间状态确认；

</confirmType>

<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>

<operatorCode>当前状态操作员编码, string (50) </operatorCode>

<operatorName>当前状态操作员姓名, string (50) </operatorName>

<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>

<storageFee>仓储费用，double (18, 2) </storageFee>

<header>发票抬头, string (200) </header>

<amount>发票金额, double (18, 2) </amount>

<content>发票内容, string(500) </content>

<items>

<item>

<itemName>商品名称, string (50)</itemName>

<unit>商品单位, string (50)</unit>

<price>商品单价, double (18, 2)</price>

<amount>金额, double (18, 2)</amount>

</item>

</items>

</detail>

<code>发票代码, string(50)，纳税企业的标识</code>

<number>发票号码, string(50)，纳税企业内部的发票号</number>

</invoice>

</invoices>

</deliveryOrder>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) , 必填</expressCode>

<packageCode>包裹编号, string (50) </packageCode>

<length>包裹长度 (厘米) , double (18, 2) </length>

<width>包裹宽度 (厘米) , double (18, 2) </width>

<height>包裹高度 (厘米) , double (18, 2) </height>

<theoreticalWeight>包裹理论重量 (千克) , double (18, 3) </theoreticalWeight>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<volume>包裹体积 (升, L) , double (18, 3) </volume>

<invoiceNo>发票号, string (500) </invoiceNo>

<type>包材型号, string (50) </type>

<quantity>包材的数量, int</quantity>

</packageMaterial>

</packageMaterialList>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<quantity>包裹内该商品的数量, int, 必填</quantity>

</item>

</items>

</package>

</packages>

<orderLineNo>单据行号，string（50）</orderLineNo>

<orderSourceCode>平台交易订单编码, string (50) </orderSourceCode>

<subSourceCode>平台交易子订单编码, string (50) </subSourceCode>

<subDeliveryOrderId>WMS发货单拆单子发货单号, string (50) </subDeliveryOrderId>

<itemCode>商品编码, string (50) </itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<sn>商品序列号, string(50)</sn>

</snList>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<ownerCode>货主编码，string(50)</ownerCode>

<itemName>商品名称, string (200) </itemName>

<extCode>交易平台商品编码, string (50) </extCode>

<planQty>应发商品数量, int</planQty>

<actualQty>实发商品数量, int</actualQty>

<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额</retailPrice>

<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice>

<discountAmount>单件商品折扣金额, double (18, 2) </discountAmount>

<batchCode>批次编号，string(50)，</batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

<produceCode>生产批号，string(50)，</produceCode>

<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=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<actualQty>实发数量, int，要求batchs节点下所有的实发数量之和等于orderline中的实发数量</actualQty>

</batch>

</batchs>

<qrCode>商品的二维码（类似电子产品的SN码），用来进行商品的溯源，多个二维码之间用分号（;）隔开</qrCode>

</orderLine>

</orderLines>

</order>

</orders>

</request>

5.20.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure，只要有一个失败flag就置为failure，如果是success，就忽略下面的orders节点，只要有failure，WMS重发该报文</flag>

</response>

5.21 发货单查询接口

5.21.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.deliveryorder.query。

奇门调用WMS的API名称： deliveryorder.query。

5.21.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<orderCode>发库单号, string (50) ,必填</orderCode>

<orderId>仓储系统发库单号, string (50) ，条件必填</orderId>

< orderSourceCode >交易单号</ orderSourceCode >

<pageSize>每页orderLine条数（最多100条）</pageSize>

</request>

5.21.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int</totalLines>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=补发出库，必填</orderType>

<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>

<operatorCode>当前状态操作员编码, string (50) </operatorCode>

<operatorName>当前状态操作员姓名, string (50) </operatorName>

<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>

<header>发票抬头, string (200) </header>

<amount>发票金额, double (18, 2) </amount>

<content>发票内容, string(500) </content>

<items>

<item>

<itemName>商品名称, string (50)</itemName>

<unit>商品单位, string (50)</unit>

<price>商品单价, double (18, 2)</price>

<amount>金额, double（18，2）</amount>

</item>

</items>

</detail>

<code>发票代码, string(50)，纳税企业的标识</code>

<number>发票号码, string(50)，纳税企业内部的发票号</number>

</invoice>

</invoices>

</deliveryOrder>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) , 必填</expressCode>

<packageCode>包裹编号, string (50) </packageCode>

<length>包裹长度 (厘米) , double (18, 2) </length>

<width>包裹宽度 (厘米) , double (18, 2) </width>

<height>包裹高度 (厘米) , double (18, 2) </height>

<theoreticalWeight>包裹理论重量 (千克) , double (18, 3) </theoreticalWeight>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<volume>包裹体积 (升, L) , double (18, 3) </volume>

<invoiceNo>发票号, string (500) </invoiceNo>

<type>包材型号, string (50) </type>

<quantity>包材的数量, int</quantity>

</packageMaterial>

</packageMaterialList>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<quantity>包裹内该商品的数量, int, 必填</quantity>

</item>

</items>

</package>

</packages>

<orderLineNo>单据行号，string（50）</orderLineNo>

<orderSourceCode>平台交易订单编码, string (50) </orderSourceCode>

<subSourceCode>平台交易子订单编码, string (50) </subSourceCode>

<itemCode>商品编码, string (50) </itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<ownerCode>货主编码，string(50)</ownerCode>

<itemName>商品名称, string (200) </itemName>

<extCode>交易平台商品编码, string (50) </extCode>

<planQty>应发商品数量, int</planQty>

<actualQty>实发商品数量, int</actualQty>

<batchCode>批次编号，string(50)，</batchCode>

<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>

<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>

<produceCode>生产批号，string(50)，</produceCode>

<qrCode>商品的二维码（类似电子产品的SN码），用来进行商品的溯源，多个二维码之间用分号（;）隔开</qrCode>

</orderLine>

</orderLines>

</response>

5.22 订单SN通知接口

5.22.1 接口介绍

场景说明：在出库、发货、入库等场景下，ERP和WMS之间同步操作的SN列表。

WMS调用的奇门API名称：taobao.qimen.order.sn.report。

奇门调用ERP的API名称： order.sn.report。

5.22.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<pageSize>每页记录的条数, int, 必填</pageSize>

<order>

<orderCode>单据编号, string (50) , 必填</orderCode>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<ownerCode>货主编码, string (50) </ownerCode>

<orderType>单据类型, JYCK= 一般交易出库单，HHCK= 换货出库，BFCK= 补发出库， PTCK=普通出库单，DBCK=调拨出库，B2BCK=B2B出库，QTCK=其他出库， SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库，B2BRK=B2B入库，DBRK= 调拨入库，QTRK= 其他入库，XTRK= 销退入库，THRK=退货入库，HHRK= 换货入库，CNJG= 仓内加工单，CGTH=采购退货出库单, 必填</orderType>

</order>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<sn>商品序列号, string(50), 必填</sn>

</item>

</items>

</request>

5.22.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.23 发货单SN通知接口

5.23.1 接口介绍

场景说明：仓库出库单后, 把SN信息回传给ERP。

WMS调用的奇门API名称：taobao.qimen.sn.report。

奇门调用ERP的API名称： sn. report。

5.23.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<pageSize>每页记录的条数, int, 必填</pageSize>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<ownerCode>货主编码, string (50) </ownerCode>

<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=补发出库，PTCK=普通出库单，DBCK=调拨出库，QTCK=其他出库，B2BCK=B2B出库，必填</orderType>

</deliveryOrder>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>商品仓储系统编码, string (50)</itemId>

<sn>商品序列号, string(50), 必填</sn>

</item>

</items>

</request>

5.23.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.24 订单流水查询接口

5.24.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.orderprocess.query。

奇门调用WMS的API名称： orderprocess.query。

5.24.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<orderType>单据类型, string (50) ，JYCK= 一般交易出库单，HHCK= 换货出库，BFCK= 补发出库，PTCK=普通出库单，DBCK=调拨出库，QTCK=其他出库，B2BRK=B2B入库，B2BCK=B2B出库，CGRK=采购入库，DBRK= 调拨入库，QTRK= 其他入库，XTRK= 销退入库，HHRK= 换货入库，CNJG= 仓内加工单</orderType>

<orderCode>单据号, string (50) , 必填</orderCode>

<orderId>仓储系统单据号, string (50) ，条件必填 </orderId>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<ownerCode>货主编码, string (50) </ownerCode>

</request>

5.24.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<orderCode>单据号, string (50) , 必填</orderCode>

<orderId>仓储系统单据号, string (50) ，条件必填 </orderId>

<warehouseCode>仓库编码, string (50) </warehouseCode>

<processStatus>单据状态，string (50) ,NEW=新增， ACCEPT=仓库接单, PRINT = 打印, PICK=捡货, CHECK = 复核, PACKAGE= 打包, WEIGH= 称重, READY=待提货， DELIVERED=已发货，EXCEPTION =异常，CLOSED= 关闭, CANCELED= 取消, REJECT=仓库拒单, REFUSE=客户拒签, CANCELEDFAIL=取消失败，SIGN=签收，TMSCANCELED=快递拦截， TMSCANCELFAILED=快递拦截失败, PARTFULFILLED-部分收货完成, FULFILLED-收货完成，PARTDELIVERED=部分发货完成， OTHER=其他，必填 (只传英文编码) </processStatus>

<operatorCode>该状态操作员编码, string (50) </operatorCode>

<operatorName>该状态操作员姓名, string (50) </operatorName>

<operateTime>该状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS ，必填</operateTime>

<operateInfo>操作内容, string (200) </operateInfo>

<remark>备注, string (500) </remark>

</process>

</processes>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</orderProcess>

</response>

5.25 订单状态查询接口（批量）

5.25.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.orderstatus.batchquery。

奇门调用WMS的API名称： orderstatus.batchquery。

5.25.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<startTime>订单最后操作时间（查询起始时间点），string (50)，YYYY-MM-DD hh:mm:ss，必填</startTime>

<endTime>订单最后操作时间（查询截止时间点），默认当前时间，string (50)，YYYY-MM-DD hh:mm:ss</endTime>

<currentPage>当前第几页，从1开始，int，必填</currentPage>

<pageSize>页面大小，建议不超过100条，int，必填</pageSize>

</request>

5.25.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<order>

<orderCode>单据号, string (50) , 必填</orderCode>

<orderId>仓储系统单据号, string (50) ，条件必填 </orderId>

< orderSourceCode>交易单号</ orderSourceCode>

</ orderSourceCodes >

<warehouseCode>仓库编码, string (50) </warehouseCode>

<processStatus>当前单据状态，string (50) ,NEW=新增， ACCEPT=仓库接单, PRINT = 打印, PICK=捡货, CHECK = 复核, PACKAGE= 打包, WEIGH= 称重, READY=待提货， DELIVERED=已发货，EXCEPTION =异常，CLOSED= 关闭, CANCELED= 取消, REJECT=仓库拒单, REFUSE=客户拒签, CANCELEDFAIL=取消失败，SIGN=签收，TMSCANCELED=快递拦截，PARTFULFILLED-部分收货完成, FULFILLED-收货完成，PARTDELIVERED=部分发货完成， OTHER=其他，必填 (只传英文编码) </processStatus>

<operatorCode>该状态操作员编码, string (50) </operatorCode>

<operatorName>该状态操作员姓名, string (50) </operatorName>

<operateTime>该状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS ，必填</operateTime>

<operateInfo>操作内容, string (200) </operateInfo>

</order>

</orders>

</response>

5.26 订单流水通知接口

5.26.1 接口介绍

场景说明：仓库仓内操作状态回传给ERP, 比如打包操作完成时, 回传一个打包完成的状态给到ERP, ERP自行决定如何处理。

WMS调用的奇门API名称：taobao.qimen.orderprocess.report。

奇门调用ERP的API名称： orderprocess.report。

5.26.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<order>

<orderCode>单据号, string (50) , 必填</orderCode>

<orderId>仓储系统单据号, string (50) ，条件必填 </orderId>

<orderType>单据类型, string (50) , JYCK= 一般交易出库单，HHCK= 换货出库，BFCK= 补发出库，PTCK=普通出库单，DBCK=调拨出库，B2BRK=B2B入库，B2BCK=B2B出库，QTCK=其他出库，SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库，DBRK= 调拨入库，QTRK= 其他入库，XTRK= 销退入库，HHRK= 换货入库，CNJG= 仓内加工单，BIGTOBCK=大B2B出库</orderType>

<warehouseCode>仓库编码, string (50) </warehouseCode>

</order>

<processStatus>单据状态，string (50) , ACCEPT=仓库接单, PARTFULFILLED-部分收货完成, FULFILLED-收货完成, PRINT = 打印, PICK=捡货, CHECK = 复核, PACKAGE= 打包, WEIGH= 称重, READY=待提货， DELIVERED=已发货, REFUSE=买家拒签，EXCEPTION =异常，CLOSED= 关闭, CANCELED= 取消, REJECT=仓库拒单，SIGN=签收，SENDTMS=下发配，TMSFINISH=配完结，TMSCANCELED=快递拦截，OTHER=其他，PARTDELIVERED=部分发货完成， TMSCANCELFAILED=快递拦截失败, 必填 (只传英文编码) </processStatus>

<operatorCode>当前状态操作员编码, string (50) </operatorCode>

<operatorName>当前状态操作员姓名, string (50) </operatorName>

<expressCode>运单号, string (50) </expressCode>

<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS </operateTime>

<operateInfo>操作内容, string (500) </operateInfo>

<remark>备注, string (500) </remark>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</process>

</request>

5.26.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure </flag>

</response>

5.27 订单异常通知接口

5.27.1 接口介绍

场景说明：仓库仓内操作异常状态回传给ERP, ERP自行决定如何处理。

WMS调用的奇门API名称：taobao.qimen.orderexception.report。

奇门调用ERP的API名称： orderexception.report。

5.27.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<messageId>异常消息ID, string (50)，必填</messageId>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>菜鸟出库单号, string (50) , 必填</deliveryOrderId>

<orderType>出库单类型, string (50) , 必填, JYCK=一般交易出库单, HHCK=换货出库单, BFCK=补发出库单，QTCK=其他出库单</orderType>

<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO) 、HTKY=百世汇通、BSKY=百世快运、BSKY=百世快运、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦快运、RRS=日日顺、HTKY=极兔速递、DISTRIBUTOR_30464910=丰网速运、OTHER=其他，必填, (只传英文编码) </logisticsCode>

<expressCode>运单号, string (50) </expressCode>

<messageType>异常信息类型，101=系统报缺（有商品信息），102=实物报缺（有商品信息），201=配送延迟，202=拒收退件，203=包裹丢失</messageType>

<messageDesc>异常消息描述, string (50) </messageDesc>

<remark>备注, string (19)</remark>

<createTime>发货单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填 </createTime>

<orderLineNo>单据行号，string（50）</orderLineNo>

<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode>

<subSourceOrderCode>交易平台子订单编码, string (50) </subSourceOrderCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) ,条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<planQty>应发商品数量, int, 必填</planQty>

<exceptionQty>异常商品数量, int, 必填</exceptionQty>

</orderLine>

</orderLines>

</request>

5.27.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure </flag>

</response>

5.28 退货异常包裹单通知接口

5.28.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.returnapply.report。

奇门调用ERP的API名称：returnapply.report。

5.28.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<shopCode>ERP店铺编码, string (50) , 必填</shopCode>

<orderCode>ERP的退货单或退货申请编码, string (50) , 必填</orderCode>

<orderId>仓库系统的退货单或退货申请编码, string (50) , 条件必填</orderId>

<createDate>退货回告创建时间, string (19) , 必填</createDate>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) , 必填</expressCode>

<name>姓名, string (50) , 必填</name>

<zipCode>邮编, string (50) </zipCode>

<tel>固定电话, string (50) </tel>

<mobile>移动电话, string (50) , 必填</mobile>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) , 必填</province>

<city>城市, string (50) , 必填</city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) , 必填</detailAddress>

</receiverInfo>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填 </itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品</inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<itemStatus>商品状态，string（50），ZC=正常，PS=破损</itemStatus>

<remark>备注, string (500) ,</remark>

</item>

</items>

</request>

5.28.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.29 退货包裹状态通知接口

5.29.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.returnpackage.report。

奇门调用ERP的API名称：returnpackage.report。

5.29.2 入参规范

<order>

<orderCode>退货包裹交接单编码, string (50) , 必填</orderCode>

<returnOrderCode>退货单编码</returnOrderCode>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<outBizCode>外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理。必填</outBizCode>

<orderType>单据类型, string（50）,THPL=退货包裹交接单</orderType>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

</order>

<logisticsCode>承运商编码string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO) 、HTKY=百世汇通、BSKY=百世快运、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦快运、RRS=日日顺、HTKY=极兔速递、DISTRIBUTOR_30464910=丰网速运、OTHER=其他，必填, (只传英文编码) </logisticsCode>

<logisticsName>物流公司名称, string (200) </logisticsName>

<expressCode>运单号, string (50) , 不必填</expressCode>

<weight>包裹重量 (千克) , double (18, 3) </weight>

<signUserName>签收人姓名, string (50) ，必填</signUserName>

<signTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</signTime>

<Status>状态, sign-已签收string (50) </Status>

<Remarks>备注, string (500) ,</Remarks>

</package>

</packages>

</request>

5.29.1 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.30 发货单缺货通知接口

5.30.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.itemlack.report。

奇门调用ERP的API名称：itemlack.report。

5.30.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<deliveryOrderCode>ERP的发货单编码, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓库系统的发货单编码, string (50) , 条件必填</deliveryOrderId>

<createTime>缺货回告创建时间, string (19) , 必填</createTime>

<outBizCode>外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理, string (50) , 必填, </outBizCode>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填 </itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品</inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<planQty>应发商品数量, int, 必填</planQty>

<lackQty>缺货商品数量, int, 必填</lackQty>

<reason>缺货原因 (系统报缺, 实物报缺) , string (500) </reason>

</item>

</items>

</request>

5.30.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.31 发货单缺货查询接口

5.31.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.itemlack.query。

奇门调用WMS的API名称：itemlack.query。

5.31.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>

<pageSize>每页orderLine条数（最多100条），必填</pageSize>

</request>

5.31.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int，必填</totalLines>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<deliveryOrderCode>ERP的发货单编码, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>仓库系统的发货单编码, string (50) , 条件必填</deliveryOrderId>

<createTime>缺货回告创建时间, string (19) , 必填</createTime>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品编码, string (50) , 条件必填 </itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品</inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<planQty>应发商品数量, int, 必填</planQty>

<lackQty>缺货商品数量, int, 必填</lackQty>

<reason>缺货原因 (系统报缺, 实物报缺) , string (500) </reason>

</item>

</items>

</response>

5.32 单据取消接口

5.32.1 接口介绍

场景介绍：ERP主动发起取消某些创建的单据, 如入库单、出库单、退货单等, 所有的场景。

ERP调用的奇门API名称：taobao.qimen.order.cancel。

奇门调用WMS的API名称：order.cancel。

5.32.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<ownerCode>货主编码, string (50) </ownerCode>

<orderCode>单据编码, string (50) ，必填</orderCode>

<orderId>仓储系统单据编码, string (50) ，条件必填 </orderId>

<orderType>单据类型, JYCK= 一般交易出库单，HHCK= 换货出库，BFCK= 补发出库 PTCK=普通出库单，DBCK=调拨出库，B2BRK=B2B入库，B2BCK=B2B出库，QTCK=其他出库， SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库，DBRK= 调拨入库，QTRK= 其他入库，XTRK= 销退入库，THRK=退货入库，HHRK= 换货入库，CNJG= 仓内加工单，CGTH=采购退货出库单</orderType>

<cancelReason>取消原因, string (500) </cancelReason>

</request>

5.32.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.33 单据挂起（恢复）接口

5.33.1 接口介绍

场景介绍：ERP主动发起挂起（恢复）某些创建的单据，如入库单、出库单、退货单等。

ERP调用的奇门API名称：taobao.qimen.order.pending。

奇门调用WMS的API名称：order.pending。

5.33.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<actionType>操作类型，string（50），必填，pending=挂起，restore=恢复

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<ownerCode>货主编码, string (50) </ownerCode>

<orderCode>单据编码, string (50) ，必填</orderCode>

<orderId>仓储系统单据编码, string (50) ，条件必填 </orderId>

<orderType>单据类型, JYCK= 一般交易出库单，HHCK= 换货出库，BFCK= 补发出库 PTCK=普通出库单，DBCK=调拨出库，B2BRK=B2B入库，B2BCK=B2B出库，QTCK=其他出库， SCRK=生产入库，LYRK=领用入库，CCRK=残次品入库，CGRK=采购入库，DBRK= 调拨入库，QTRK= 其他入库，XTRK= 销退入库，THRK=退货入库， HHRK= 换货入库 CNJG= 仓内加工单</orderType>

<reason>挂起（恢复）原因, string (500) </reason>

</request>

5.33.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.34 库存查询接口（多商品）

5.34.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.inventory.query。

奇门调用WMS的API名称： inventory.query。

5.34.2 入参规范

<warehouseCode>仓库编码, string (50) </warehouseCode>

<ownerCode>货主编码，string（50）</ownerCode>

<itemCode>商品编码，string（50），必填</itemCode>

<itemId>仓储系统商品ID, string (50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

</criteria>

</criteriaList>

</request>

5.34.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<items>

<item>

<warehouseCode>仓库编码, string (50) </warehouseCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,FP=废品</inventoryType>

<quantity>未冻结库存数量，int，必填</quantity>

<lockQuantity>冻结库存数量，int，必填 </lockQuantity>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

</item>

</items>

</response>

5.35 库存查询接口（多条件）

5.35.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.stock.query。

奇门调用WMS的API名称： stock.query。

5.35.2 入参规范

<warehouseCode>仓库编码, string (50) </warehouseCode>

<ownerCode>货主编码，string（50）</ownerCode>

<itemCode>商品编码，string（50）</itemCode>

<itemId>仓储系统商品ID, string (50) </itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,FP=废品,默认为查所有类型的库存</inventoryType>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<type>库存查询类型（菜鸟业务使用）， 1- 汇总库存，不区分批次和渠道 2- 批次库存，库存按商品批次维度划分 3- 渠道库存，库存按渠道维度划分（当前业务不支持批次库存和渠道库存共存，批次库存无渠道属性，渠道库存无批次属性）</type>

<channelCode>渠道编码（菜鸟业务使用），TB=淘系，OTHERS=其他，string（50），菜鸟业务使用</channelCode>

</extendProps>

</request>

5.35.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<items>

<item>

<warehouseCode>仓库编码, string (50) </warehouseCode>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,FP=废品</inventoryType>

<quantity>未冻结库存数量，int，必填</quantity>

<lockQuantity>冻结库存数量，int，必填 </lockQuantity>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

<channelCode>渠道编码，TB=淘系，OTHERS=其他，string（50）</channelCode>

</extendProps>

</item>

</items>

</response>

5.36 仓库查询接口

5.36.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.warehouseinfo.query。

奇门调用WMS的API名称： warehouseinfo.query。

5.36.2 入参规范

<ownerCode>货主编码，string（50）</ownerCode>

</request>

5.36.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<ownerCode>货主编码，string（50）</ownerCode>

<ownerName>货主名称，string（50）</ownerName>

<warehouseCode>仓库编码，string（50）</warehouseCode>

<warehouseName>仓库名称，string（50）</warehouseName>

<province>省份，string（15）</province>

<city>城市，string（15）</city>

<area>地区，string（15）</area>

<town>乡镇，string（15）</town>

<detailAddress>详细地址，string（50）</detailAddress>

<name>仓库名称，string（50）</name>

<tel>仓库电话，string（20）</tel>

<mobile>负责人手机，string（20）</mobile>

<status>仓库状态，string（20）</status>

</WarehouseInfos>

</warehouseInfos>

</response>

5.37 仓库同步接口

5.37.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.warehouseinfo.synchronize。

奇门调用WMS的API名称： warehouseinfo.synchronize。

5.37.2 入参规范

<ownerCode>货主编码，string（50）</ownerCode>

<ownerName>货主名称，string（50）</ownerName>

<warehouseCode>仓库编码，string（50）</warehouseCode>

<warehouseName>仓库名称，string（50）</warehouseName>

<province>省份，string（15）</province>

<city>城市，string（15）</city>

<area>地区，string（15）</area>

<town>乡镇，string（15）</town>

<detailAddress>详细地址，string（50）</detailAddress>

<name>仓库名称，string（50）</name>

<tel>仓库电话，string（20）</tel>

<mobile>负责人手机，string（20）</mobile>

<status>仓库状态，string（20）</status>

</warehouseInfo>

</warehouseInfos>

</request>

5.37.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<warehouseInfos>//同步失败的仓库编码，全部成功则不需要返回该字段

<warehouseCode>仓库编码，string（50）</warehouseCode>

</warehouseInfo>

</warehouseInfos>

</response>

5.38 库存盘点通知接口

5.38.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.inventory.report。

奇门调用ERP的API名称： inventory.report。

5.38.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<pageSize>每页记录的条数, int, 必填</pageSize>

<warehouseCode>仓库编码, string (50) , 必填</warehouseCode>

<checkOrderCode>盘点单编码, string（50），必填</checkOrderCode>

<checkOrderId>仓储系统的盘点单编码, string（50），条件必填</checkOrderId>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<checkTime>盘点时间，string(19)，string (19) , YYYY-MM-DD HH:MM:SS </checkTime>

<adjustType>库存变化原因：CHECK=盘点 ADJUST=调整</adjustType>

<outBizCode>外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理, 必填</outBizCode>

<remark>备注, string (500)</remark>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,FP=废品,默认为ZP</inventoryType>

<quantity>盘盈盘亏商品变化量，int，必填，盘盈为正数，盘亏为负数</quantity>

<totalQty>盘点商品总量(为该sku的指定库存类型货品总数)，int</totalQty>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<snCode>商品序列号</snCode>

<remark>备注, string (500) </remark>

</item>

</items>

</request>

5.38.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.39 库存盘点查询接口

5.39.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.inventorycheck.query。

奇门调用WMS的API名称：inventorycheck.query。

5.39.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码, string (50) </ownerCode>

<warehouseCode>仓库编码, string (50)</warehouseCode>

<checkOrderCode>盘点单编码, string（50），必填</checkOrderCode>

<checkOrderId>仓储系统的盘点单编码, string（50），条件必填</checkOrderId>

<pageSize>每页orderLine条数（最多100条），必填</pageSize>

</request>

5.39.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<totalLines>orderLines总条数，int，必填</totalLines>

<warehouseCode>仓库编码, string (50) , 必填</warehouseCode>

<checkOrderCode>盘点单编码, string（50），必填</checkOrderCode>

<checkOrderId>仓储系统的盘点单编码, string（50），条件必填</checkOrderId>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<checkTime>盘点时间，string(19)，string (19) , YYYY-MM-DD HH:MM:SS </checkTime>

<remark>备注, string (500)</remark>

<items>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,FP=废品,默认为ZP</inventoryType>

<quantity>盘盈盘亏商品变化量，int，必填，盘盈为正数，盘亏为负数</quantity>

<totalQty>盘点商品总量(为该sku的指定库存类型货品总数)，int</totalQty>

<batchCode>批次编码, string (50) </batchCode>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<snCode>商品序列号</snCode>

<remark>备注, string (500) </remark>

</item>

</items>

</response>

5.40 仓内加工单创建接口

5.40.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.storeprocess.create。

奇门调用WMS的API名称：storeprocess.create。

5.40.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<processOrderCode>加工单编码, string (50) , 必填</processOrderCode>

<warehouseCode>仓库编码, string (50)，必填，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>

<orderType>单据类型 CNJG=仓内加工作业单, 必填</orderType>

<orderCreateTime>加工单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填</orderCreateTime>

<planTime>计划加工时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填</planTime>

<serviceType>加工类型:1:仓内组合加工 2:仓内组合拆分, 必填</serviceType>

<planQty>成品计划数量</planQty>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

<remark>备注, string (500) </remark>

<item>

<itemCode>erp系统商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50) , 条件必填</itemId>

<ownerCode>货主编码，string(50)</ownerCode>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP</inventoryType>

<productDate>商品生产日期，string（10），YYYY-MM-DD</productDate>

<expireDate>商品过期日期，string（10），YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<remark>备注, string (500) </remark>

</item>

</materialitems>

<item>

<itemCode>erp系统商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID, string (50) ,条件必填</itemId>

<ownerCode>货主编码，string(50)</ownerCode>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,FP=废品,默认为ZP</inventoryType>

<productDate>商品生产日期，string（10），YYYY-MM-DD</productDate>

<expireDate>商品过期日期，string（10），YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<remark>备注, string (500) </remark>

</item>

</productitems>

</request>

5.40.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

<processOrderId>仓储系统处理单ID</processOrderId>

</response>

5.41 仓内加工单确认接口

5.41.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.storeprocess.confirm。

奇门调用ERP的API名称：storeprocess.confirm。

5.41.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<ownerCode>货主编码，string(50)</ownerCode>

<processOrderCode>加工单编码, string (50) , 必填</processOrderCode>

<processOrderId>仓储系统加工单ID, string (50) , 条件必填</processOrderId>

<outBizCode>外部业务编码, 一个合作伙伴中要求唯一多次确认时, 每次传入要求唯一 (一般传入WMS损益单据编码) , 必填</outBizCode>

<orderType>单据类型，string(50)，CNJG=仓内加工作业单, 必填</orderType>

<orderCompleteTime>加工单完成时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填</orderCompleteTime>

<actualQty>实际作业总数量</actualQty>

<extendProps>扩展属性

<key1>value1</key1>

<key2>value2</key2>

</extendProps>

<remark>备注, string (500) </remark>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID,string（50），条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,默认为ZP, </inventoryType>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<batchCode>批次编码, string (50) </batchCode>

<remark>备注, string (500) </remark>

</item>

</materialitems>

<item>

<itemCode>商品编码, string (50) , 必填</itemCode>

<itemId>仓储系统商品ID,string(50)，条件必填</itemId>

<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,FP=废品,FP=废品,默认为ZP</inventoryType>

<productDate>商品生产日期 YYYY-MM-DD</productDate>

<expireDate>商品过期日期YYYY-MM-DD</expireDate>

<produceCode>生产批号, string (50) </produceCode>

<batchCode>批次编码, string (50) </batchCode>

<remark>备注, string (500) </remark>

</item>

</productitems>

</request>

5.41.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.42 库存异动通知接口

5.42.1 接口介绍

WMS调用的奇门API名称：taobao.qimen.stockchange.report。

奇门调用ERP的API名称：stockchange.report。

5.42.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<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=在途库存,FP=废品,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>

<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=冻结,FP=废品</inventoryType>

<quantity>异动数量, int，要求batchs节点下所有的异动数量之和等于orderline中的异动数量</quantity>

</batch>

</batchs>

<remark>备注, string (500) </remark>

</item>

</items>

</request>

5.42.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.43 店铺同步接口

5.43.1 接口介绍

ERP调用的奇门API名称：taobao.qimen.shop.synchronize。

奇门调用WMS的API名称：shop.synchronize。

5.43.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<actionType>add|update, 必填</actionType>

<shop>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、(淘系)美家U选=MJYX、OTHERS=其他) </sourcePlatformCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>

<shopCode>ERP店铺编码, string (50) , 必填</shopCode>

<shopName>ERP店铺名称，string (50) </shopName>

<platformShopCode>平台店铺Id（如淘宝店铺Id）, string (50) </platformShopCode>

<platformShopName>平台店铺名称（如淘宝店铺名称）, string (50) </platformShopName>

<zipCode>邮编, string (50) </zipCode>

<province>省份, string (50) </province>

<city>城市, string (50) </city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) </detailAddress>

</shopAddress>

</shop>

</request>

5.43.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.44 发货单波次通知接口

5.44.1 接口介绍

该接口用来给ERP或者OMS回传波次号及对应的发货单号，以支持商家货票同行、波次内包裹的处理等需求。

WMS调用的奇门API名称：taobao.qimen.wavenum.report。

奇门调用ERP的API名称：wavenum.report。

5.44.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<waveNum>波次号，string（18），必填</waveNum>

<order>

<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>

<deliveryOrderId>出库单仓储系统编码, string (50)</deliveryOrderId>

<num>波次中的次序号, string (50)</num>

</order>

</orders>

</request>

5.44.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.45 调拨单创建接口

5.45.1 接口介绍

这个接口用来创建调拨协同单。

ERP调用的奇门API名称：taobao.qimen.transferorder.create。

奇门调用WMS的API名称：transferorder.create。

5.45.2 入参规范

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<erpOrderCode>外部ERP,string(50),必填</erpOrderCode>

<fromStoreCode>出库仓编码,string(50),必填</fromStoreCode>

<toStoreCode>入库仓编码,string(50),必填</toStoreCode>

<expectStartTime>期望调拨开始时间,string(50)</expectStartTime>

<attributes>扩展属性,string(500)</attributes>

<scItemCode>货品编码,string(50),必填</scItemCode>

<count>数量,string(50),必填</count>

<inventoryType>库存类型(1:可销售库存.101:残次),必填,</inventoryType>

</transferItem>

</transferItems>

</request>

5.45.3 出参规范

<flag>响应结果:success|failure,必填</flag>

<code>响应码,string(50)</code>

<message>响应信息, string(100)</message>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<transferOrderCode>调拨单号,string(50)</transferOrderCode>

<expectOutStoreTime>预计出库时间,string(50)</expectOutStoreTime>

<expectInStoreTime>预计入库时间,string(50)</expectInStoreTime>

</transferExecuteInfo>

</response>

5.46 调拨单查询接口

5.46.1 接口介绍

这个接口用来查询调拨协同单。

ERP调用的奇门API名称：taobao.qimen.transferorder.query。

奇门调用WMS的API名称：transferorder.query。

5.46.2 入参规范

<transferOrderCode>调拨单号,string(50),必填</transferOrderCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

</request>

5.46.3 出参规范

<flag>响应结果:success|failure,必填</flag>

<code>响应码,string(50)</code>

<message>响应信息,string(100)</message>

<transferOrderCode>调拨单号,string(50)</transferOrderCode>

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<erpOrderCode>外部ERP订单号,string(50)</erpOrderCode>

<orderStatus>订单状态,string(50)</orderStatus>

<items>

<item>

<scItemCode>货品编码,string(50)</scItemCode>

<inventoryType>库存类型(1:可销售库存.101:残次)</inventoryType>

<planCount>计划调拨数量,int</planCount>

<outCount>实际出库数量,int</outCount>

<inCount>实际入库数量,int</inCount>

</item>

</items>

</transferOrderDetail>

</response>

5.47 调拨单通知接口

5.47.1 接口介绍

这个接口用来创建调拨协同单。

WMS调用的奇门API名称：taobao.qimen.transferorder.report。

奇门调用ERP的API名称：transferorder.report。

5.47.2 入参规范

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<transferOrderCode>调拨单号,string(50),必填</transferOrderCode>

<erpOrderCode>外部ERP,string(50),必填</erpOrderCode>

<orderStatus>订单状态,0:已下单 10:部分出库未入库 20:部分出库部分入库 30:全部出库未入库 40:全部出库部分入库 100:全部出库全部入库 -100:已取消</orderStatus>

<items>

<item>

<scItemCode>货品编码, string(50)</scItemCode>

<inventoryType>库存类型(1:可销售库存.101:残次) </inventoryType>

<outCount>实际出库数量,int</outCount>

<inCount>实际入库数量,int</inCount>

</item>

</items>

</request>

5.47.3 出参规范

<flag>响应结果:success|failure,必填</flag>

<code>响应码,string(50)</code>

<message>响应信息,string(100)</message>

</response>

5.48 渠道间库存规则设置接口

5.48.1 接口介绍

这个接口用来创建库存规则。

ERP调用的奇门API名称：taobao.qimen.inventoryrule.create。

奇门调用WMS的API名称：inventoryrule.create。

5.48.2 入参规范

<ownerCode>货主编码, string (50) , 必填</ownerCode>

<itemCode>货品编码, string(50)</itemCode>

<channelCode>实际出库数量,int</channelCode>

<ratio>实际入库数量,int</ratio>

</channelRatioRules>

</inventoryRules>

</request>

5.48.3 出参规范

<flag>响应结果:success|failure,必填</flag>

<code>响应码,string(50)</code>

<message>响应信息,string(100)</message>

</response>

5.49 库存汇总报表查询接口

5.49.1 接口介绍

这个接口用来查询库存汇总报表。

ERP调用的奇门API名称：taobao.qimen.inventorysum.query。

奇门调用WMS的API名称：inventorysum.query。

5.49.2 入参规范

<ownerCode>货主编码，string（50）</ownerCode>

<itemName>商品名称（最好支持模糊查询）</itemName>

<categoryId>商品类别ID, string (50) </categoryId>

<categoryName>商品类别名称, string (200) </categoryName>

<itemId>仓储系统商品编码, string (50)</itemId>

</request>

5.49.3 出参规范

<flag>success|failure</flag>

<items>

<item>

</item>

</items>

</response>

5.50 订单出库统计查询接口

5.50.1 接口介绍

这个接口用来创建库存规则。

ERP调用的奇门API名称：taobao.qimen.deliveryordersum.query。

奇门调用WMS的API名称：deliveryordersum.query。

5.50.2 入参规范

<downloadEndTime>订单下载结束时间</downloadEndTime>

<sourcePlatformCode>订单来源平台编码(TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、TGC=淘工厂、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、YZ=有赞、DY=抖音、KS=快手、TXP=淘小铺、FX=分销、XHS=小红书、DW=得物、DWZF=得物直发、TMGJ=天猫国际、MAOCHAO=天猫超市、DYGX=抖音供销、猫享-考拉自营平台=MX、WPHMP=唯品会集市、KLZF=考拉直发、DYXD=抖音小店、线下店铺=OFFLINE、XHS=小红书、KSDF=快手代发、BDJK=百度健康、WXXD=微信小店、WD=微店、HWSC=华为商城、DYDF=抖音代发、DYCS=抖音超市、(淘系)美家U选=MJYX、OTHERS=其他)</sourcePlatformCode>

<deliveryEndTime>出库结束时间</deliveryEndTime>

<downloadStartTime>订单下载开始时间</downloadStartTime>

<pageSize>每页显示条数(必填)</pageSize>

<payEndTime>支付结束时间</payEndTime>

<payStartTime>支付开始时间</payStartTime>

<deliveryStartTime>出库开始时间</deliveryStartTime>

<ownerCode>货主编码，string（50）</ownerCode>

</request>

5.50.3 出参规范

<flag>success|failure</flag>

<printQty>打印订单数量</printQty>

<weightQty>称重出库数量</weightQty>

<wayQty>在途订单数量</wayQty>

<lockQty>锁定订单数量</lockQty>

<signQty>签收订单数量</signQty>

<handQty>交接订单数量</handQty>

<collectQty>揽收订单数量</collectQty>

<cancelQty>取消订单数量</cancelQty>

<downloadQty>下载订单数量</downloadQty>

<effectQty>有效订单数量</effectQty>

<reviewQty>复核订单数量</reviewQty>

</response>

5.51 心跳接口

5.51.1 接口介绍

奇门调用ERP（WMS）的API名称：taobao.qimen.service.heartbeat。

这个接口用来判断erp（wms）的服务可用状态。

5.51.2 入参规范

<?xml version="1.0" encoding="utf-8"?>

<serialNumber>序列号，string（18），必填</serialNumber>

</request>

5.51.3 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success，必填</flag>

<code>入参的序列号，必填</code>

<message>接收到请求的系统时间，string（19），YYYY-MM-DD hh:mm:ss，必填 </message>

</response>

5.52 供应商信息同步接口

奇门调用ERP（WMS）的API名称：taobao.qimen.supplier.synchronize。

这个接口用来同步供应商信息。

5.52.1 入参规范

<?xml version="1.0" encoding="utf-8"?>

<actionType>add|update, 必填</actionType>

<supplierCode>供应商编码 string (50), 必填 </supplierCode>

<supplierName>供应商名称 string (200) , 必填</supplierName>

<name>联系人姓名, string (50) </name>

<tel>联系电话, string (50) </tel>

<email>电子邮箱, string (50) </email>

<countryCode>国家二字码，string（50）</countryCode>

<province>省份, string (50) </province>

<city>城市, string (50) </city>

<area>区域, string (50) </area>

<town>村镇, string (50) </town>

<detailAddress>详细地址, string (200) </detailAddress>

<remark>备注, string (500) </remark>

</request>

5.52.2 出参规范

<?xml version="1.0" encoding="utf-8"?>

<flag>success|failure</flag>

</response>

5.53 配送公司信息查询

5.53.1 接口使用说明

ERP调用该接口，通过货主查询订购的配送公司信息

5.53.2 接口介绍

ERP调用的奇门API名称：taobao.qimen.expressinfo.query。

奇门调用WMS的API名称：expressinfo.query。

5.53.3 入参规范

<ownerCode>货主编码,string(50)</ownerCode>

<expressCode>配送资源编码,string(50)</expressCode>

</request>

5.53.4 出参规范

<flag>success|failure，必填</flag>

<expressCode>配送资源编码,string(50),必填

</expressCode>

<expressName>配送资源名称,string(50),必填</expressName>

<brandCode>配送公司品牌编码,string(50),必填

</brandCode>

<brandName>配送公司品牌名称,string(50),必填</brandName>

<status>状态,string(50),1=启用,0=停用，必填</status>

</expressInfo>

</expressInfos>

</response>

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

商家经营工具-开发指引

奇门白皮书-接口说明

5. 接口说明

5.1 商品查询接口

5.1.1 接口介绍

5.1.2 入参规范

5.1.3 出参规范

5.2 商品同步接口

5.2.1 接口介绍

5.2.2 入参规范

5.2.3 出参规范

5.3 商品同步接口 (批量)

5.3.1 接口介绍

5.3.2 入参规范

5.3.3 出参规范

5.4 组合商品接口

5.4.1 接口介绍

5.4.2 入参规范

5.4.3 出参规范

5.5 创建前后端商品映射接口

5.5.1 接口介绍

5.5.2 入参规范

5.5.3 出参规范

5.6 前后端商品映射查询接口

5.6.1 接口介绍

5.6.2 入参规范

5.6.3 出参规范

5.7 入库单创建接口

5.7.1 接口介绍

5.7.2 入参规范

5.7.3 出参规范

5.8 入库单确认接口

5.8.1 接口介绍

5.8.2 入参规范

5.8.3 出参规范

5.9 入库单查询接口

5.9.1 接口介绍

5.9.2 入参规范

5.9.3 出参规范

5.10 退货入库单创建接口

5.10.1 接口介绍

5.10.2 入参规范

5.10.3 出参规范

5.11 退货入库单确认接口

5.11.1 接口介绍

5.11.2 入参规范

5.11.3 出参规范

5.12 退货入库单查询接口

5.12.1 接口介绍

5.12.2 入参规范

5.12.3 出参规范

5.13 出库单创建接口

5.13.1 接口介绍

5.13.2 入参规范

5.13.3 出参规范

5.14 出库单确认接口

5.14.1 接口介绍

5.14.2 入参规范

5.14.3 出参规范

5.15 出库单查询接口

5.15.1 接口介绍

5.15.2 入参规范

5.15.3 出参规范

5.16 发货单创建接口

5.16.1 接口介绍

5.16.2 入参规范

5.16.3 出参规范

5.17 发货单创建接口 （批量）

5.17.1 接口介绍

5.17.2 入参规范

5.17.3 出参规范

5.18 发货单创建结果通知接口 （批量）

5.18.1 接口介绍

5.18.2 入参规范

5.18.3 出参规范

5.19 发货单确认接口

5.19.1 接口介绍

5.19.2 入参规范

5.19.3 出参规范

5.17 发货单创建接口（批量）

5.18 发货单创建结果通知接口（批量）

5.25 订单状态查询接口（批量）