[点晴永久免费OA]c-wms3.0对外接口

当前位置：点晴教程→点晴OA办公管理信息系统 →『经验分享&问题答疑』

admin

2022年7月11日 10:8 本文热度 1136

1.c-wms3.0接口

更新日志

2020.12.31 更新库存盘点通知接口和库存异动通知接口的outbizcode赋值逻辑

1.1接口概述及对接方案

ERP和WMS都只会提供一个服务接收地址
商品接口、5个订单下发接口、库存查询接口都是ERP调用wms
库存异动、盘点通知、5个订单确认接口接口由WMS调用ERP
ERP调用WMS接口时根据method来区分不同的api,WMS回调时也是如此

1.2接口规范

接口遵循REST规范，使用HTTP POST + XML方式进行通讯
标准协议的HTTP入口地址为：http://c-wms.iask.in:8765/api/edi/qimen/service(测试环境)
上位系统发给C-WMS：http://c-wms.iask.in:8765/api/edi/qimen/service?method=[C-WMS_API]&timestamp=[2015-02-01 00:00:00] &format=xml&app_key=[appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[customerId]
C-WMS发给上位系统： http://xxxERP/xxxservice?method=[ERP_API] &timestamp=[2015-02-01 00:00:00]&format=xml&app_key=[appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[customerId]

1.3通信协议

请求参数:
请求参数包含URL中带的系统参数和BODY中带的相关业务参数，以下是系统参数

参数	参数说明	类型	约束
`method`	C-WMS相关的业务接口名称，如商品信息同步的请求，method= item.synchronize	string	必须
`format`	报文格式,当前仅支持xml	`string`	必填
`app_key`	应用接入时申请的appkey	`string`	必填
`v`	版本号	`string`	必填
`sign`	根据秘钥算出来的签名	`string`	必填
`sign_method`	参数加密方法,md5	`string`	必填
`customerId`	客户账号	`string`	必填
`timestamp`	当前时间	`string`	必填
`partner_id`	合作伙伴id	`string`	选填

响应参数:

参数	参数说明	类型	约束
flag	success	failure	string
code	返回状态码	string	必填
message	返回状态描述	string	必填

1.4签名算法

输入参数
method=singleitem.synchronize
timestamp=2020-12-14 18:54:36
format=xml
app_key=20201015001
v=2.0
sign_method=md5
customerId=BJMG
partner_id=top-sdk-java-20190305

body=<request><actionType>ADD</actionType><item><barCode>0001</barCode><itemCode>0001</itemCode><itemName>0001</itemName><itemType>ZP</itemType><stockUnit>个</stockUnit></item><ownerCode>BJMG</ownerCode><warehouseCode>OTHER</warehouseCode></request>

首字母升序排序
app_key=20201015001
customerId=BJMG
format=xml
method=singleitem.synchronize
partner_id=top-sdk-java-20190305
sign_method=md5
timestamp=2020-12-14 18:54:36
v=2.0
连接字符串
连接参数名与参数值,并在首尾加上secret，此处假设secret=20201015001，如下：
20201015001app_key20201015001customerIdBJMGformatxmlmethodsingleitem.synchronizepartner_idtop-sdk-java-20190305sign_methodmd5timestamp2020-12-14 18:54:36v2.0{body}20201015001
其中：{body}用请求中的body数据代替,替换后为:

20201015001app_key20201015001customerIdBJMGformatxmlmethodsingleitem.synchronizepartner_idtop-sdk-java-20190305sign_methodmd5timestamp2020-12-14 18:54:36v2.0<request><actionType>ADD</actionType><item><barCode>0001</barCode><itemCode>0001</itemCode><itemName>0001</itemName><itemType>ZP</itemType><stockUnit>个</stockUnit></item><ownerCode>BJMG</ownerCode><warehouseCode>OTHER</warehouseCode></request>20201015001

32位大写md5值
32位大写MD5值-> 7D006A88F6D542FE79BCEE7911F191B2
验证方式注意复制时请去掉最后的回车换行 http://tool.chinaz.com/tools/md5.aspx
拼装url请求
http://c-wms.iask.in:8765/api/edi/qimen/service?app_key=20201015001&method=singleitem.synchronize&v=2.0&sign=7D006A88F6D542FE79BCEE7911F191B2&timestamp=2020-12-14+18%3A54%3A36&partner_id=top-sdk-java-20190305&format=xml&sign_method=md5&customerId=BJMG
注意:
URL需要做URL Encoding处理。
请求和响应的消息主体使用XML格式。

1.5名称解释

正向调用指ERP调用WMS接口
反向调用指WMS调用ERP接口

1.6反向接口

QimenController

2.接口说明

2.1单商品同步接口

接口说明

正向接口
method=singleitem.synchronize
接口返回的itemId不要存储，减少耦合度，下单接口传商品编码，WMS自行匹配

测试类

SingleItemTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request>
	<actionType>add|update, 必填, 可以填add 系统自动会根据是否存在进行新增或者修改</actionType>
	<warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>
	<ownerCode>货主编码, string (50) , 必填</ownerCode>
	<supplierCode>供应商编码, string (50) 若传值会匹配系统客户中对应的供应商，若未匹配到，直接新增到客户表中；若未传值则使用系统默认供应商 </supplierCode>  
    <supplierName>供应商名称, string (200) </supplierName> 
	<item>
		<barCode>条形码,  string (500) , 可多个，用分号（;）隔开，必填</barCode>
		<itemCode>商品编码,  string (50) ,  必填</itemCode>
		<goodsCode>货号,  string (50) </goodsCode>
		<itemName>商品名称,  string (200) , 必填</itemName>
		<itemType>商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) ,  string (10) , 必填,  (只传英文编码) </itemType>
		<stockUnit>商品计量单位,  string (50),不填系统默认 个</stockUnit>
		<skuProperty>商品属性 (如红色, XXL) ,  string (200) </skuProperty>
		<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>  
        <categoryName>商品类别名称,  string (200) </categoryName>  
        <tagPrice>零售价, double (18, 2) </tagPrice>  
        <retailPrice>零售价, double (18, 2) </retailPrice>  
        <costPrice>成本价, double (18, 2) </costPrice>  
        <purchasePrice>采购价, double (18, 2) </purchasePrice>
        <seasonName>季节名称,  string (50) </seasonName>
        <brandName>品牌名称,  string (50) </brandName>
        <isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为 N) 新增支持 修改不支持</isShelfLifeMgmt>
        <shelfLife>保质期 (小时) , int 新增支持 修改不支持</shelfLife>
        <isSNMgmt>是否需要串号管理, Y/N (默认为 N) 新增支持 修改不支持</isSNMgmt>
        <rejectLifecycle>保质期禁收天数, int 新增支持 修改不支持</rejectLifecycle> 
        <lockupLifecycle>保质期禁售天数, int 新增支持 修改不支持</lockupLifecycle>
        <adventLifecycle>保质期临期预警天数, int 新增支持 修改不支持</adventLifecycle>
        <isBatchMgmt>是否需要批次管理, Y/N (默认为 N) 新增支持 修改不支持</isBatchMgmt>
        <approvalNumber>批准文号, string (50) </approvalNumber> 
        <isFragile>是否易碎品, Y/N, (默认为 N) </isFragile> 
        <isHazardous>是否危险品, Y/N, (默认为 N) </isHazardous>
	</item>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<code>200</code>
	<flag>success</flag>
	<itemId>wms的商品id,  string (50) 不建议保存到erp</itemId>
</response>

2.2批量商品同步接口

接口说明

正向接口
method=items.synchronize

测试类

ItemsSynchronizeTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request>
	<actionType>add|update, 必填 可以填add 系统自动会根据是否存在进行新增或者修改</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>
			<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> 
			<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> 
			<seasonName>季节名称, string (50) </seasonName> 
			<brandName>品牌名称, string (50) </brandName> 
			<isSNMgmt>是否需要串号管理, Y/N (默认为 N) 新增支持 修改不支持</isSNMgmt> 
			<isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为 N) 新增支持 修改不支持</isShelfLifeMgmt> 
			<shelfLife>保质期 (小时) , int 新增支持 修改不支持 </shelfLife> 
			<rejectLifecycle>保质期禁收天数, int  新增支持 修改不支持</rejectLifecycle> 
			<lockupLifecycle>保质期禁售天数, int  新增支持 修改不支持</lockupLifecycle>
			<adventLifecycle>保质期临期预警天数, int  新增支持 修改不支持</adventLifecycle>
			<isBatchMgmt>是否需要批次管理, Y/N (默认为 N) 新增支持 修改不支持</isBatchMgmt> 
			<approvalNumber>批准文号, string (50) </approvalNumber> 
			<isFragile>是否易碎品, Y/N, (默认为 N) </isFragile> 
			<isHazardous>是否危险品, Y/N, (默认为 N) </isHazardous>
			<remark>备注, string (500) </remark> 
			<isSku>是否 sku, Y/N, (默认为 Y) </isSku> 
			<extendProps>扩展属性
				<key1>value1</key1> 
				<key2>value2</key2> 
			</extendProps> 
		</item>
	</items>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure，只要有一个失败 flag 就置为 failure，如果是 success，就忽略
	下面的 items 节点</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<items>
		<item>
			<itemCode>没有同步成功的商品的编码，必填</itemCode>
			<message>出错信息</message>
		</item>
	</items>
</response>

2.3入库单创建接口

接口说明

正向接口
method=entryorder.create
接口中supplierCode代表供应商编码

测试类

EntryOrdercreateTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<entryOrder> 
		<entryOrderCode>入库单号, string (50) , 必填</entryOrderCode> 
		<ownerCode>货主编码, string (50) , 必填</ownerCode> 
		<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>
		<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=日日顺、
		OTHER=其他(只传英文编码) 如果没有购买OMS系统请不要传OTHER，可以传其他自定义的</logisticsCode>
		<logisticsName>物流公司名称, string (200) </logisticsName> 
		<expressCode>运单号, string (50) </expressCode> 
		<supplierCode>供应商编码 string (50) 根据供应商编码匹配客户表中的供应商，如果未匹配到使用默认。正式使用中需要先在wms导入供应商的资料</supplierCode> 
		<supplierName>供应商名称 string (200) </supplierName> 
		<operatorCode>操作员编码, string (50) </operatorCode> 
		<operatorName>操作员名称, string (50) </operatorName> 
		<remark>备注, string (500), 若整单验收时有填写备注，则覆盖原有备注，否则保留下发时的备注</remark> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</entryOrder> 
	<orderLines> 
		<orderLine> 
			<outBizCode>外部业务编码, 消息 ID, 用于去重，当单据需要分批次发送时使用
			</outBizCode>
			<orderLineNo>入库单的行号，string（50）</orderLineNo>
			<ownerCode>货主编码, string (50) , 必填</ownerCode> 
			<itemCode>商品编码, string (50) , 必填</itemCode>
			<snList>
				<sn>商品序列号, string(50) </sn>
			</snList>
			<itemName>商品名称, string (200) </itemName> 
			<planQty>应收商品数量, int, 必填, 支持小数, 保留6位</planQty>  
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType> 
			<extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
				<key1>value1</key1> 
				<key2>value2</key2> 
			</extendProps>
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<entryOrderId>仓储系统入库单编码, string (50) </entryOrderId>
</response>

2.4入库单确认接口

接口说明

反向接口
method=entryorder.confirm
wms支持按收货单反馈（多次反馈）和按订单维度反馈（一次反馈）默认按收货单反馈，如需按订单反馈联调时请提出
如果是按收货单反馈需要支持冥等性,通过outBizCode来记录已反馈的
如果是按订单反馈,在接收到多次反馈时需要判断自己的状态如果是已确认,应该反馈成功

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<entryOrder> 
		<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> 
		<operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS，(当
		status=FULFILLED, operateTime 为实收时间) </operateTime>
		奇门接入白皮书
		<remark>备注, string (500)</remark> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</entryOrder> 
	<orderLines> 
		<orderLine> 
			<outBizCode>外部业务编码, 消息 ID, 用于去重，当单据需要分批次发送时使用
			</outBizCode>
			<orderLineNo>单据行号，string（50）</orderLineNo>
			<ownerCode>货主编码, string (50) </ownerCode>
			<itemCode>商品编码, string (50) , 必填</itemCode>
			<snList>
				<sn>商品序列号, string(50) </sn>
			</snList>
			<itemName>商品名称, string (200) </itemName> 
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为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>
			<batchs>
				<!-- 同一行号下多批次支持-->
				<batch>
					<batchCode>批次编号，string(50)</batchCode> 
					<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
					<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate> 
					<produceCode>生产批号，string(50)，</produceCode>
					<inventoryType>库存类型, string (50), ZP=正品,CC=残次,默认为ZP</inventoryType>
					<actualQty>实收数量, int，要求 batchs 节点下所有的实收数量之和等于
					orderline 中的实收数量</actualQty>
				</batch>
			</batchs>
			<remark>备注, string(500)</remark> 
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
</response>

2.5退货单创建接口

接口说明

正向接口
method=returnorder.create

测试类

ReturnOrdercreateTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<returnOrder> 
		<returnOrderCode>ERP 的退货入库单编码, string (50) , 必填</returnOrderCode>
		<ownerCode>货主编码, string (50) , 必填</ownerCode>
		<warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需 ERP 指定仓储编
		码的情况填 OTHER</warehouseCode>
		<orderType>单据类型, string (50)，THRK=退货入库，HHRK=换货入库 (只传英文
		编码)</orderType> 
		<sourcePlatformCode>订单来源平台编码, string (50),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=
			阿里巴巴、POS=POS 门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微
		店、PDD=拼多多、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=同时退回发票；</orderFlag> 
        原出库单号, string (50)</preDeliveryOrderCode>
		<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=日日顺、
		OTHER=其他，必填, (只传英文编码) </logisticsCode>
		<logisticsName>物流公司名称, string (200) </logisticsName> 
		<expressCode>运单号, string (50) </expressCode> 
		<returnReason>退货原因, string (200), 1010201=商品问题、1010202=发货问题、1010203=物流问题、1010204=客户问题、1010205=其他问题</returnReason> 
		<buyerNick>买家昵称, string (50) </buyerNick> 
		<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> 
		</senderInfo> 
		<remark>备注, string (500), 若整单验收时有填写备注，则覆盖原有备注，否则保留下发时的备注 </remark> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</returnOrder> 
	<orderLines> 
		<orderLine> 
			<orderLineNo>单据行号，string（50）</orderLineNo>
			<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode> 
			<ownerCode>货主编码, string (50) , 必填</ownerCode> 
			<orderFlag>用字符串格式来表示订单标记列表：比如 VISIT^ 
				SELLER_AFFORD^SYNC_RETURN_BILL 等, 中间用“^”来隔开 订单标记 list (所有字母
				全部大写) ： VISIT=上门；SELLER_AFFORD=是否卖家承担运费 (默认是) ；
			SYNC_RETURN_BILL=同时退回发票；</orderFlag>
			<returnReason>退货原因, string (200) </returnReason>
			<itemCode>商品编码, string (50) , 必填</itemCode> 
			<itemId>仓储系统商品编码, string (50) , 条件必填，条件为提供后端（仓储系统）商
			品编码的仓储系统</itemId>
			<snList>
				<sn>商品序列号, string(50)</sn>
			</snList>
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType> 
			<planQty>应收商品数量, long, 必填</planQty> 
			<batchCode>批次编码, string (50) </batchCode> 
			<productDate>生产日期, string (10) , YYYY-MM-DD</productDate> 
			<expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate> 
			<produceCode>生产批号, string (50) </produceCode>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<returnOrderId>仓储系统退货单编码, string (50) </returnOrderId> 
</response>

2.6退货单确认接口

接口说明

反向接口
method=returnorder.confirm

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<returnOrder> 
		<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> 
		<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=日日顺、
		OTHER=其他， (只传英文编码) </logisticsCode>
		<logisticsName>物流公司名称, string (200) </logisticsName> 
		<expressCode>运单号, string (50) </expressCode> 
		<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> 
		</senderInfo> 
		<remark>备注, string(500)</remark> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</returnOrder> 
	<orderLines> 
		<orderLine> 
			<orderLineNo>单据行号，string（50）</orderLineNo>
			<sourceOrderCode>交易平台订单, string (50) </sourceOrderCode> 
			<itemCode>商品编码, string (50) , 必填</itemCode> 
			<itemId>仓储系统商品编码, string (50) , 条件必填 (条件为菜鸟仓) </itemId>
			<snList>
				<sn>商品序列号, string(50) </sn>
			</snList>
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为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> 
			<batchs>
				<!-- 同一行号下多批次支持-->
				<batch>
					<batchCode>批次编号，string(50)</batchCode> 
					<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
					<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate> 
					<produceCode>生产批号，string(50)，</produceCode>
					<inventoryType>库存类型, string(50), ZP=正品, CC=残次,默认为ZP</inventoryType> 
					<actualQty>实收数量, int，要求 batchs 节点下所有的实收数量之和等于
					orderline 中的实收数量</actualQty>
				</batch>
			</batchs>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

2.7出库和发货单合一创建接口

接口说明

正向接口
method=mixorder.create
建议大家对接此接口可以一次满足出库单和发货单2个接口的功能
当orderType是发货单的业务类型时收货人不会新增到系统里对应系统中2C订单不允许部分发货
当orderType时出库单的业务类型时收货人会新增到客户表里对应系统中2B订单允许部分发货

测试类

DeliveryOrderTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<deliveryOrder> 
		<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode> 
		<orderType>出库单类型, string (50) , 必填, 
			发货单(JYCK=一般交易出库单, HHCK=换货出库单, BFCK=补发出库单) 
			出库单(PTCK=普通出库单，DBCK=调拨出库 ，B2BCK=B2B 出库，SCCK=生产出库，CGTH=采购退货出库单,XNCK=虚拟出库单)
			混合接口不要传QTCK=其他出库，否则WMS分不清是那种订单
			</orderType> 
		<warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需 ERP 指定仓储编码
		的情况填 OTHER</warehouseCode>
		<orderFlag>订单标记 ，用字符串格式来表示订单标记列表： 比如 COD, 中间用“^”
			来隔开，string (200) ， COD =货到付款 , LIMIT=限时配送 , PRESELL=预售 , 
			PRESELLREST=预售尾款, COMPLAIN=已投诉 , SPLIT=拆单, EXCHANGE=换货, 
			VISIT=上门 , MODIFYTRANSPORT=是否可改配送方式, 是否可改配送方式 默认可更
			改 , CONSIGN =物流宝代理发货, 自动更改发货状态 SELLER_AFFORD =是否卖家承担运
			费 默认是, 即没 , FENXIAO=分销订单，TCPS=区域零售，PRESELLCONSIGN=预售极
		速达订单</orderFlag> 
		<sourcePlatformCode>订单来源平台编码, string (50) , 必填,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=阿里巴巴、POS=POS 门店、MIA=蜜芽、GW=商家官网、CT=村
		淘、YJWD=云集微店、PDD=拼多多、OTHERS=其他(只</sourcePlatformCode> 
		<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName> 
		<createTime>发货单创建时间, string (19) , YYYY-MM-DD HH:MM:SS, 必填
		</createTime> 
        <scheduleDate>指配日期, string (19) , YYYY-MM-DD </scheduleDate>
		<placeOrderTime>前台订单 (店铺订单) 创建时间 (下单时间) , string (19) , YYYYMM-DD HH:MM:SS, 必填</placeOrderTime> 
		<payTime>订单支付时间, string (19) , YYYY-MM-DD HH:MM:SS</payTime> 
		<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=日日顺、OTHER=其他，必填, (只传英文编码) 如果没有购买OMS系统请不要传OTHER，可以传其他自定义的</logisticsCode>
		<logisticsName>物流公司名称, string (200) </logisticsName> 
		<expressCode>运单号, string (50) </expressCode> (面单号前置的情况) 
		<logisticsAreaCode>快递区域编码, 大头笔信息, string (50) </logisticsAreaCode> 
		<deliveryRequirements> 
			<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> 
		<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> 
		</senderInfo>
		<receiverInfo>
			<!--收件人信息-->
			<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> 
		<buyerMessage>买家留言, string (500) </buyerMessage> 
		<sellerMessage>卖家留言, string (500) </sellerMessage> 
		<remark>备注，string（500）</remark>
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
			<printData>打印相关特殊信息,例如pdf的url或者pdf的base64</printData>
		</extendProps> 
	</deliveryOrder> 
	<orderLines> 
		<orderLine> 
			<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=残次,默认ZP</inventoryType>
			<itemName>商品名称, string (200) </itemName> 
			<planQty>应发商品数量, int, 必填</planQty> 
			<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额
			</retailPrice> 
			<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice> 
			<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
			<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate> 
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId> 
	<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
</response>

2.8出库单创建接口

接口说明

正向接口
method=stockout.create
对应系统中2B订单
会根据receiverInfo中的客户信息自动新增客户如果只有名称,wms的客户名称、编码、公司名称保持一致。如果公司名称和客户名称同时有值，客户编码和公司名称的值都为公司名称。

测试类

StockOutcreateTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request>
	<deliveryOrder>
		<deliveryOrderCode>出库单号（ERP 分配）, string (50) , 必填
		</deliveryOrderCode>
		<sourcePlatformCode>订单来源平台编码, string (50) , 必填,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=阿里巴巴、POS=POS 门店、MIA=蜜芽、GW=商家官网、CT=村
		淘、YJWD=云集微店、PDD=拼多多、OTHERS=其他, (只</sourcePlatformCode>
		<sourcePlatformName>订单来源平台名称, string (200) </sourcePlatformName>
		<orderType>出库单类型, string (50) , 必填, PTCK=普通出库单，DBCK=调拨出库 ，
			B2BCK=B2B 出库，SCCK=生产出库，QTCK=其他出库，CGTH=采购退货出库
		单,XNCK=虚拟出库单</orderType>
		<warehouseCode>出库仓库编码, string (50)，必填 ，统仓统配等无需 ERP 指定仓储
		编码的情况填 OTHER</warehouseCode>
		<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>
		<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=日日顺、
		OTHER=其他 ，(只传英文编码) 如果没有购买OMS系统请不要传OTHER，可以传其他自定义的</logisticsCode>
		<logisticsName>物流公司名称（包括干线物流公司等）, string (200) 
		</logisticsName>
		<expressCode>运单号, string (50) </expressCode>
		<supplierCode>供应商编码 string (50) </supplierCode>
		<supplierName>供应商名称 string (200) </supplierName>
		<transportMode>送货方式（到仓自提，快递，干线物流、汽运、空运）</transportMode>
		<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>
		</senderInfo>
		<receiverInfo>
			<!--收件人信息-->
			<code>收货人编码, string (200) </code>
			<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>
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
			<printData>打印相关特殊信息,例如pdf的url或者pdf的base64</printData>
		</extendProps> 
	</deliveryOrder>
	<orderLines>
		<orderLine>
			<outBizCode>外部业务编码, 消息 ID, 用于去重，当单据需要分批次发送时使用</outBizCode>
			<orderLineNo>单据行号，string（50）</orderLineNo>
			<ownerCode>货主编码, string (50) , 必填</ownerCode>
			<itemCode>商品编码, string (50) , 必填</itemCode>
			<itemId>仓储系统商品编码, string (50) ,条件必填</itemId>
			<itemName>商品名称, string (200) </itemName>
			<inventoryType>库存类型, string(50), ZP=正品, CC=残次,默认为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>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>		
        </orderLine>
    </orderLines>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId> 
	<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
</response>

2.9出库单确认接口

接口说明

反向接口
method=stockout.confirm

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<deliveryOrder> 
		<deliveryOrderCode>出库单号, string(50), 必填</deliveryOrderCode> 
		<deliveryOrderId>仓储系统出库单号, string(50), 条件必填</deliveryOrderId> 
		<warehouseCode>仓库编码, string(50), 必填</warehouseCode>
		<shopNick>店铺名称, string(50)</shopNick>
		<shopCode>ERP 店铺编码, string(50), 必填</shopCode>
		<orderType>出库单类型, string(50), PTCK=普通出库单,DBCK=调拨出库,B2BCK=B2B出库,QTCK=其他出库,CGTH=采购退货出库单,必填</orderType> 
		<status>出库单状态, string(50), NEW-未开始处理, ACCEPT-仓库接单, PARTDELIVERED-部分发货完成, DELIVERED-发货完成,
            EXCEPTION-异常, CANCELED-取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败,只传英文编码</status> 
		<subOrderType>出库单确认其他出库单的子类型，用于orderType设置为其他出库单时设置, string(50)</subOrderType>
		<outBizCode>外部业务编码, string(50), 同一请求的唯一性标示编码。ISV对于同一请求，分配一个唯一性的编码。
            用来保证因为网络等原因导致重复传输，请求不会被重复处理，条件必填，条件为一单需要多次确认时</outBizCode> 
		<confirmType>支持出库单多次发货, int, 多次发货后确认时,0表示发货单最终状态确认,1表示发货单中间状态确认</confirmType> 
		<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=日日顺、OTHER=其他,(只传英文编码)</logisticsCode>
		<logisticsName>物流公司名称, string(200)</logisticsName> 
		<expressCode>运单号, string(50)</expressCode> 
		<orderConfirmTime>订单完成时间, string(19), YYYY-MM-DD HH:MM:SS</orderConfirmTime> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</deliveryOrder> 
	<packages> 
		<package> 
			<logisticsName>物流公司名称, string(200)</logisticsName> 
			<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=日日顺、OTHER=其他,(只传英文编码)</logisticsCode>
			<expressCode>运单号, string(50)</expressCode> 
			<packageCode>包裹编号, string(50)</packageCode> 
			<weight>包裹重量(千克), double(18,3)</weight> 
			<volume>包裹体积(升/L), double(18,3)</volume> 
			<items> 
				<item> 
					<itemCode>商品编码, string(50) , 必填</itemCode> 
					<itemId>商品仓储系统编码, string(50)</itemId> 
					<quantity>包裹内该商品的数量, int, 必填</quantity> 
				</item> 
			</items> 
			<extendProps>
				<packageNumber>int 原箱件数即内箱数</packageNumber> 
			</extendProps> 
		</package> 
	</packages> 
	<orderLines>
		<orderLine> 
			<outBizCode>外部业务编码, 消息ID, 用于去重,当单据需要分批次发送时使用</outBizCode>
			<orderLineNo>单据行号, string（50）</orderLineNo>
			<itemCode>商品编码, string(50), 必填</itemCode> 
			<itemId>商品仓储系统编码, string(50)</itemId>
			<snList>
				<sn>商品序列号, string(50)</sn>
			</snList>
			<itemName>商品名称, string(200)</itemName>
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType>
			<actualQty>实发商品数量, int, 必填</actualQty> 
			<batchCode>批次编号, string(50)</batchCode> 
			<productDate>生产日期, string(10), YYYY-MM-DD</productDate> 
			<expireDate>过期日期, string(10), YYYY-MM-DD</expireDate> 
			<batchs>
				<!-- 同一行号下多批次支持-->
				<batch>
					<batchCode>批次编号, string(50)</batchCode> 
					<productDate>生产日期, string(10), YYYY-MM-DD</productDate> 
					<expireDate>过期日期, string(10), YYYY-MM-DD </expireDate> 
					<produceCode>生产批号, string(50)</produceCode>
					<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType>
					<actualQty>实发数量, int, 要求batchs节点下所有的实发数量之和等于orderline中的实发数量</actualQty>
				</batch>
			</batchs>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>	
		</orderLine> 
	</orderLines>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

2.10发货单创建接口

接口说明

正向接口
method=deliveryorder.create
对应系统中2C订单

测试类

DeliveryOrderTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<deliveryOrder> 
		<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode> 
		<orderType>出库单类型, string (50) , 必填, 
			JYCK=一般交易出库单, HHCK=换货出库单, BFCK=补发出库单
			不要传QTCK=其他出库，否则WMS分不清是那种订单
			</orderType> 
		<warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需 ERP 指定仓储编码
		的情况填 OTHER</warehouseCode>
		<orderFlag>订单标记 ，用字符串格式来表示订单标记列表： 比如 COD, 中间用“^”
			来隔开，string (200) ， COD =货到付款 , LIMIT=限时配送 , PRESELL=预售 , 
			PRESELLREST=预售尾款, COMPLAIN=已投诉 , SPLIT=拆单, EXCHANGE=换货, 
			VISIT=上门 , MODIFYTRANSPORT=是否可改配送方式, 是否可改配送方式 默认可更
			改 , CONSIGN =物流宝代理发货, 自动更改发货状态 SELLER_AFFORD =是否卖家承担运
			费 默认是, 即没 , FENXIAO=分销订单，TCPS=区域零售，PRESELLCONSIGN=预售极
		速达订单</orderFlag> 
		<sourcePlatformCode>订单来源平台编码, string (50) , 必填,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=阿里巴巴、POS=POS 门店、MIA=蜜芽、GW=商家官网、CT=村
		淘、YJWD=云集微店、PDD=拼多多、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> 
		<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=日日顺、OTHER=其他，必填, (只传英文编码) 如果没有购买OMS系统请不要传OTHER，可以传其他自定义的</logisticsCode>
		<logisticsName>物流公司名称, string (200) </logisticsName> 
		<expressCode>运单号, string (50) </expressCode> (面单号前置的情况) 
		<logisticsAreaCode>快递区域编码, 大头笔信息, string (50) </logisticsAreaCode> 
		<deliveryRequirements> 
			<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> 
		<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> 
		</senderInfo>
		<receiverInfo>
			<!--收件人信息-->
			<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> 
		<buyerMessage>买家留言, string (500) </buyerMessage> 
		<sellerMessage>卖家留言, string (500) </sellerMessage> 
		<remark>备注，string（500）</remark>
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
			<printData>{"pdfUrl":"http://xxx.pdf"}</printData>
		</extendProps> 
	</deliveryOrder> 
	<orderLines> 
		<orderLine> 
			<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=残次,默认为ZP</inventoryType>
			<itemName>商品名称, string (200) </itemName> 
			<planQty>应发商品数量, int, 必填</planQty> 
			<retailPrice>零售价, double (18, 2) , 零售价=实际成交价+单件商品折扣金额
			</retailPrice> 
			<actualPrice>实际成交价, double (18, 2) , 必填</actualPrice> 
			<batchCode>批次编码, string (50) </batchCode>
			<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
			<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>	 
		</orderLine> 
	</orderLines> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response> 
	<flag>success|failure</flag> 
	<code>响应码</code> 
	<message>响应信息</message> 
	<deliveryOrderId>出库单仓储系统编码, string (50) </deliveryOrderId> 
	<createTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
</response>

2.11发货单确认接口

接口说明

反向接口
method=deliveryorder.confirm

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<remark>备注, string (500) </remark>
	<deliveryOrder> 
		<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode> 
		<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId> 
		<warehouseCode>仓库编码, string (50)，必填 </warehouseCode> 
		<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=
		补发出库</orderType>
		<status>出库单状态, string (50) (NEW-未开始处理, ACCEPT-仓库接单 , 
			PARTDELIVERED-部分发货完成, DELIVERED-发货完成, EXCEPTION-异常, 
			CANCELED-取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败) , (只传英
		文编码) </status> 
		<outBizCode>string (50) , 外部业务编码, 消息 ID, 用于去重, ISV 对于同一请求，分
		配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理，条 件必填，条件为一单需要多次确认时 </outBizCode> 
		<confirmType>支持出库单多次发货, int，
			多次发货后确认时
			0 表示发货单最终状态确认；
			1 表示发货单中间状态确认；
		</confirmType>
		<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime> 
		<operatorName>当前状态操作员姓名, string (50) </operatorName> 
		<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime> 
		<extendProps>扩展属性
			<erpProps>erp特有参数,传什么返回什么</erpProps>
		</extendProps> 
	</deliveryOrder> 
	<packages> 
		<package> 
			<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=日日顺、
			OTHER=其他，必填, (只传英文编码) </logisticsCode>
			<logisticsName>物流公司名称, string (200) </logisticsName> 
			<expressCode>运单号, string (50) , 必填</expressCode> 
			<packageCode>包裹编号, string (50) </packageCode> 
			<weight>包裹重量 (千克) , double (18, 3) </weight> 
			<volume>包裹体积 (升, L) , double (18, 3) </volume> 
			<items> 
				<item> 
					<itemCode>商品编码, string (50) , 必填</itemCode> 
					<itemId>商品仓储系统编码, string (50)</itemId> 
					<quantity>包裹内该商品的数量, int, 必填</quantity> 
				</item> 
			</items> 
			<extendProps>
				<packageNumber>int 原箱件数即内箱数</packageNumber> 
			</extendProps> 
		</package> 
	</packages>
	<orderLines>
		<orderLine> 
			<orderLineNo>单据行号，string（50）</orderLineNo>
			<ownerCode>货主编码, string (50) </ownerCode>
			<itemCode>商品编码, string (50) </itemCode> 
			<itemId>商品仓储系统编码, string (50)</itemId>
			<snList>
				<sn>商品序列号, string(50)</sn> 
			</snList>
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType>
			<ownerCode>货主编码，string(50)</ownerCode>
			<itemName>商品名称, string (200) </itemName> 
			<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> 
			<batchs>
				<!-- 同一行号下多批次支持-->
				<batch>
					<batchCode>批次编号，string(50)</batchCode> 
					<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
					<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate> 
					<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType>
					<actualQty>实发数量, int，要求 batchs 节点下所有的实发数量之和等于
					orderline 中的实发数量</actualQty>
				</batch>
			</batchs>
            <extendProps>扩展属性
                <erpProps>erp特有参数,传什么返回什么</erpProps>
			</extendProps>
		</orderLine> 
	</orderLines>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

2.12 调拨单创建接口

接口说明

正向接口
method=transferorder.create

接口入参

<request>
	<ownerCode>货主编码, string (50) , 必填</ownerCode>
	<erpOrderCode>外部 ERP,string(50),必填</erpOrderCode>
	<fromStoreCode>出库仓编码,string(50),必填</fromStoreCode>
	<toStoreCode>入库仓编码,string(50),必填</toStoreCode>
	<expectStartTime>期望调拨开始时间,string(50)</expectStartTime>
	<transferItems>
		<transferItem>
			<scItemCode>货品编码,string(50),必填</scItemCode>
			<count>数量,string(50),必填</count>
			<inventoryType>库存类型(ZP-正常品,CC-残次品),必填,</inventoryType>
		</transferItem>
	</transferItems>
</request>

响应报文

<response>
	<flag>响应结果:success|failure,必填</flag>
	<code>响应码,string(50)</code>
	<message>响应信息, string(100)</message>
	<transferexecuteInfo>
		<ownerCode>货主编码, string (50) , 必填</ownerCode>
		<transferOrderCode>调拨单号,string(50)</transferOrderCode>
		<expectOutStoreTime>预计出库时间,string(50)</expectOutStoreTime>
		<expectInStoreTime>预计入库时间,string(50)</expectInStoreTime>
	</transferexecuteInfo>
</response>

2.13 调拨单通知接口

接口说明

反向接口
method=transferorder.report

接口入参

<request>
	<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>

响应报文

<response>
	<flag>响应结果:success|failure,必填</flag>
	<code>响应码,string(50)</code>
	<message>响应信息,string(100)</message>
</response>

2.14取消接口

接口说明

正向接口
method=order.cancel

测试类

OrderCancelTest

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<warehouseCode>仓库编码, string(50), 必填, 统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>
	<ownerCode>货主编码, string(50), 必填</ownerCode> 
	<orderCode>单据编码, string(50), 必填</orderCode> 
	<orderId>仓储系统单据编码, string(50), 条件必填</orderId>
	<orderType>单据类型, 必填, SCRK=生产入库,CGRK=采购入库,LYRK=领用入库,CCRK=残次品入库,
        DBRK=调拨入库,QTRK=其他入库,B2BRK=B2B入库,THRK=退货入库,HHRK=换货入库,TXRK=销退入库
        JYCK=一般交易出库单,HHCK=换货出库,BFCK=补发出库,B2BCK=B2B出库,PTCK=普通出库单,DBCK=调拨出库,
        CGTH=采购退货出库单,SCCK=生产出库,XNCK=虚拟出库单,LYCK=领用出库,QTCK=其他出库</orderType> 
	<cancelReason>取消原因, string(500)</cancelReason> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

2.15库存查询接口

接口说明

正向接口
method=inventory.query
为了避免客户大批量调用此接口造成系统压力，后期会做限流控制。所以请上游系统在开发时此接口时不要无限制的调用，比如可以在库存有变动时再调用。

接口入参

<?xml version="1.0" encoding="UTF-8"?>
<request>
	<criteriaList>
		<criteria>
			<warehouseCode>仓库编码, string (50) ，必填</warehouseCode>
			<ownerCode>货主编码，string（50），必填</ownerCode>
			<itemCode>商品编码，string（50），必填</itemCode>
			<itemId>仓储系统商品ID, string (50)，条件必填</itemId>
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType> 
		</criteria>
	</criteriaList>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
	<items> 
		<item> 
			<warehouseCode>仓库编码, string (50) </warehouseCode> 
			<itemCode>商品编码, string (50) , 必填</itemCode> 
			<itemId>仓储系统商品 ID, string (50)，条件必填</itemId> 
			<inventoryType>库存类型，string (50) , ZP=正品, CC=残次</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>

2.16库存异动通知接口

接口说明

反向接口
method=stockchange.report

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<items>
		<item> 
			<ownerCode>货主编码, string (50) , 必填</ownerCode>
			<warehouseCode>仓库编码, string (50)，必填 </warehouseCode> 
			<orderCode>引起异动的单据编码，string（50），必填 </orderCode>
			<outBizCode>外部业务编码, 消息 ID, 用于去重，用来保证因为网络等原因导致重复
			传输，请求不会被重复处理，必填 orderCode-itemCode-inventoryType</outBizCode>
			<itemCode>商品编码, string (50) , 必填</itemCode> 
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次</inventoryType>
			<quantity>商品变化量，int，必填，可为正为负</quantity> 
			<batchCode>批次编码, string (50) </batchCode>
			<productDate>商品生产日期 YYYY-MM-DD</productDate> 
			<expireDate>商品过期日期 YYYY-MM-DD</expireDate> 
			<changeTime>异动时间, string (19) , YYYY-MM-DD HH:MM:SS, (单据完成时间)</changeTime>
			<batchs>
				<!-- 同一商品下多批次支持-->
				<batch>
					<batchCode>批次编号，string(50)</batchCode> 
					<productDate>生产日期，string(10)，YYYY-MM-DD</productDate> 
					<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate> 
					<inventoryType>库存类型, string(50), ZP=正品,CC=残次</inventoryType> 
					<quantity>异动数量, int，要求 batchs 节点下所有的异动数量之和等于 orderline
					中的异动数量</quantity>
				</batch>
			</batchs>
			<remark>备注, string (500) </remark> 
		</item> 
	</items>
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

2.17库存盘点通知接口

接口说明

反向接口
method=inventory.report
如果要支持SN，请使用页面的SN损益功能

接口入参

<?xml version="1.0" encoding="utf-8"?>
<request> 
	<totalPage>总页数, int,必填</totalPage> 
	<currentPage>当前页, 从 1 开始,int， 必填</currentPage> 
	<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 对于同一请求，分配一个唯一性的
		编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理, 必填
		checkOrderCode-itemCode-inventoryType-batchCode-productDate
	</outBizCode> 
	<remark>备注, string (500)</remark> 
	<items> 
		<item> 
			<itemCode>商品编码, string (50) , 必填</itemCode> 
			<inventoryType>库存类型, string(50), ZP=正品,CC=残次,默认为ZP</inventoryType>
			<quantity>盘盈盘亏商品变化量，int，必填，盘盈为正数，盘亏为负数</quantity>
			<batchCode>批次编码, string (50) </batchCode> 
			<productDate>商品生产日期 YYYY-MM-DD</productDate> 
			<expireDate>商品过期日期 YYYY-MM-DD</expireDate> 
			<snCode>商品序列号</snCode> 
			<remark>备注, string (500) </remark> 
		</item> 
	</items> 
</request>

响应报文

<?xml version="1.0" encoding="utf-8"?>
<response>
	<flag>success|failure</flag>
	<code>响应码</code>
	<message>响应信息</message>
</response>

3.联调流程

3.1联系c-wms联调人员获取一下信息

wms_api_url:http://c-wms.iask.in:8765/api/edi/qimen/service
url中app_key:
url中secret:
url中customerId:
报文中warehouseCode:
报文中ownerCode:
erp_api_url:erp提供

3.2开始联调

该文章在 2022/7/11 10:54:38 编辑过

关键字查询

wms

对外

接口

正在查询...

点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。

点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理，结合码头的业务特点，围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体，是物流码头及其他港口类企业的高效ERP管理信息系统。

点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。

点晴免费OA是一款软件和通用服务都免费，不限功能、不限时间、不限用户的免费OA协同办公管理系统。