名称	类型	字段长度	是否必选	示例值	描述
logisticsId	String	64	true	LBX10231	菜鸟物流订单号
cpCode	String	64	true	SF	物流公司编号（针对老的快递业务，新业务全部是资源code:快递员是CP编码，其它是资源code）
dicCode	String	64	false	DCP00098765	菜鸟配送平台唯一包裹号
mailNo	String	64	false	20140804048802	运单号
orderno	String(64)		是		订单号
sourcesn	String(64)		是		来源订单号：拆单或取件时原订单号，若未拆单与orderno一致
ordertype	String(16)		是		订单类型：1.采购入库 2.销售出库 3.退货入库 4.取件 5.普通出库6.调拨 7.第三方运输订单 8客户调货出库 9.客户调货入库 10.网点取货 11.拒收入库12 B2B订单13 转批次出库 14转批次入库
bustype	String(16)		是		业务类型：入库订单：1 送货到仓库 2 提货 ; 出库订单：1 自提 2 网点 70 直配 调货：1.送货到HUB库 2.HUB库自提 普通出库：1.自提 2.送货 转批次 1
expno	String(64)		否		快递单号：自动分配的快递单号或客户生成的快递单号
orderdate	date		是		订单时间（格式：YYYY-MM-DD HH:MM:SS）
storecode	String(32)		是		仓库编码：按日日顺C码
province	String(64)		否		收货人所在省（省市区和国标码不可同时为空）
被动模式
notifyid	String(32)		是		消息ID，消息唯一码，不能重复。
notifytime	Date		是		消息通知时间 YYYY-MM-DD hh:mm:ss
butype	String(32)		是		通知类型，接口方法名
source	String(32)		是		来源，根据系统区分
type	String(16)		是		报文格式： Json或xml
sign	String(64)		是		签名
content	String		是		消息内容根据具体业务定义，加密后的报文需 URLEncoder
主动模式
notifytime	Date		是		消息通知时间 YYYY-MM-DD hh:mm:ss
outcode	String(32)		是		消息code，消息唯一码，不能重复
butype	String(32)		是		通知类型，接口方法名
source	String(32)		是		来源，根据系统区分
type	String(16)		是		报文格式： Json或xml
sign	String(64)		是		签名
content	String		是		消息内容根据具体业务定义，加密后的报文需 URLEncoder
notifyid	String(32)		是		消息ID，消息唯一码，不能重复

名称	类型	字段长度	是否必选	示例值	描述
success	boolean		true	true/false	是否成功
errorCode	String	64	false		错误码
errorMsg	String	64	false	系统异常	错误信息
被动模式
flag	String		是		T 成功 F 失败
response	String		否		根据业务数据定义
msg	String		否		处理描述
主动模式
flag	String		是		T 成功 F 失败
response	String		否		根据业务数据定义
msg	String		否		处理描述

XML

                           

	<Order>

  <orderno>订单号</orderno>

  <sourcesn>拆单时原订单号，若未拆单与orderno一致</sourcesn>

  <ordertype>订单类型：1.采购入库 2.销售出库 3.退货入库 4.取件 5.普通出库（自提）

   6.调拨 7.第三方运输订单  8客户调货</ordertype>

  <bustype>业务类型：入库订单：1 送货到仓库 70 提货 ;出库订单：1 自提

   2 网点 70 直配 调货：1.送货到HUB库 2.HUB库自提</bustype>

  <expno>快递单号：自动分配的快递单号或客户生成的快递单号</expno>

  <orderdate>订单时间（格式：YYYY-MM-DD HH:MM:SS）</orderdate>

  <storecode>仓库编码：按日日顺C码</storecode>

  <province>收货人所在省</province>

  <city>收货人所在市</city>

  <county>收货人所在县/区</county>

  <addr>详细地址</addr>

  <gbcode>国标码：六位国标码</gbcode>

  <name>送达方姓名：收货人姓名</name>

  <mobile>联系电话</mobile>

  <tel>固定电话</tel>

  <postcode>邮政编码</postcode>

  <deldate>预约时间：预约送货时间</deldate>

  <insdate>预约时间：预约安装时间</insdate>

  <reorder>前续订单号：关联单号</reorder>

  <freight>运费</freight>

  <billsum>订单总金额</billsum>

  <billowe>代收金额：应收欠款</billowe>

  <paystate>付款状态：P1-已付款，P2-代收货款</paystate>

  <paytime>付款时间</paytime>

  <paytype>支付类别（如支付宝、现金、银联等) </paytype>

  <isinv>是否需要开具发票：1.是 2.否</isinv>

  <invtype>发票类型</invtype>

  <invrise>发票抬头</invrise>

  <taxbearer>纳税人登记号</taxbearer>

  <recaddr>发票地址</recaddr>

  <recacc>发票开户行帐号</recacc>

  <recbank>发票开户行</recbank>

  <sname>发货人姓名</sname>

  <sprovince>发货人所在省</sprovince>

  <scity>发货人所在市</scity>

  <scounty>货人所在县/区</scounty>

  <saddr>详细地址</saddr>

  <smobile>发货人联系电话</smobile>

  <stel>发货人固定电话</stel>

  <busflag>订单标记 1送装一体 2.只配送 3.开箱验货</busflag>

  <remark>备注</remark>

  <attributes>属性备注</attributes>

  <remark1>备用字段</remark1>

  <remark2>备用字段</remark2>

  <remark3>备用字段</remark3>

  <remark4>备用字段</remark4>

  <remark5>备用字段</remark5>

  <remark6>备用字段</remark6>

  <remark7>备用字段</remark7>

  <remark8>备用字段</remark8>

  <items>

    <Item>

      <itemno>行号：订单中有多行物料时，物料所在的行数</itemno>

  <storagetype>批次 产品状态:10 正品 21 不良 22 破箱 40 样品 L0礼品

      </storagetype>           

      <productcode>客户产品编码</productcode>

      <hrcode>海尔产品编码 日日顺物流生成</hrcode>

      <prodes>产品描述</prodes>

      <volume>体积</volume>

      <weight>重量</weight>

      <number>数量</number>

      <unprice>单价</unprice>

      <reitem>前续订单行号(关联行号)</reitem>

      <attributes><sn>个性化条码</sn> </attributes>

      <remark1>备用</remark1>

      <remark2>备用</remark2>

    </Item>

    <Item>

      <itemno>行号：订单中有多行物料时，物料所在的行数</itemno>

  <storagetype>批次 产品状态:10 正品 21 不良 22 破箱 40 样品 L0礼品

      </storagetype>

      <productcode>客户产品编码</productcode>

      <hrcode>海尔产品编码 日日顺物流生成</hrcode>

      <prodes>产品描述</prodes>

      <volume>体积</volume>

      <weight>重量</weight>

      <number>数量</number>

      <unprice>单价</unprice>

      <reitem>前续订单行号(关联行号)</reitem>

      <attributes><sn>个性化条码</sn> </attributes>

      <remark1>备用</remark1>

      <remark2>备用</remark2>

    </Item>

  </items>

</Order>


	


                       

JSON

XML

JSON

XML

                           

	1)       通讯约定：使用HTTP POST方式进行通讯，参数做encode(URL转码)。


	2)       参数大小写约定：没有强制要求的地方，统一使用小写。


	3)       编码约定： UTF-8。


	4)       参数约定：支持JSON或XML，默认入驻时提交的设置。


	5)       签名约定：对通讯的业务参数（content，下文会提到）进行校验，签名生成公式：base64(MD5(content+keyValue))，keyValue由VOM在发布服务时指定。


	6)       消息去重约定：在主动模式下，外部系统通过下发字段中的notifyid（下文会提到）去重，VOM若收到重复的notifyid，可以认为该消息是重复下发。同样，被动模式下VOM通过回传唯一的outcode(下文会提到)去重。


	7)       时间约定：时间格式使用 YYYY-MM-DD HH:mm:ss 的格式，精确到秒。


	8)       Content-Type约定：普通接口：text/html;
charset=utf-8


	9)       字段类型约定：需要严格依据字段表格中给出的参数格式和大小进行开发，避免类型不匹配或参数大小预留不够导致溢出。


	10)   字段解析约定：参数字段中的必选字段是每次调用接口时都要求必须传入的。而可选字段会根据业务场景需求有差别（在某些特殊业务场景下，可选也有可能是必选）。所以仓库需根据实际业务场景，支持解析可选字段。在开发时，不应该认为可选字段，就不预留或不处理。


	content 加密协议：AES加密协议


	模式字段键值对用&符号链接

                       

JSON

XML

接口类名	消息响应格式
名称	类型	可选/必选	备注
flag	String	必选	T 成功  F 失败
业务参数
response	String	可选	根据业务数据定义
msg	String	可选	处理描述

JSON

XML

                           11111111111111
                       

JSON

XML

JSON

XML

                           123343545454
                       

JSON

                            1233435
                        

XML

                           4323443243
                       

JSON

XML

                           

	<Order>


	  <orderno>订单号</orderno>


	  <sourcesn>拆单时原订单号，若未拆单与orderno一致</sourcesn>


	  <ordertype>订单类型：1.采购入库 2.销售出库 3.退货入库 4.取件 5.普通出库（自提）


	   6.调拨 7.第三方运输订单  8客户调货</ordertype>


	  <bustype>业务类型：入库订单：1 送货到仓库 70 提货 ;出库订单：1 自提 


	   2 网点 70 直配 调货：1.送货到HUB库 2.HUB库自提</bustype>


	  <expno>快递单号：自动分配的快递单号或客户生成的快递单号</expno>


	  <orderdate>订单时间（格式：YYYY-MM-DD HH:MM:SS）</orderdate>


	  <storecode>仓库编码：按日日顺C码</storecode>


	  <province>收货人所在省</province>


	  <city>收货人所在市</city>


	  <county>收货人所在县/区</county>


	  <addr>详细地址</addr>


	  <gbcode>国标码：六位国标码</gbcode>


	  <name>送达方姓名：收货人姓名</name>


	  <mobile>联系电话</mobile>


	  <tel>固定电话</tel>


	  <postcode>邮政编码</postcode>


	  <deldate>预约时间：预约送货时间</deldate>


	  <insdate>预约时间：预约安装时间</insdate>


	  <reorder>前续订单号：关联单号</reorder>


	  <freight>运费</freight>


	  <billsum>订单总金额</billsum>


	  <billowe>代收金额：应收欠款</billowe>


	  <paystate>付款状态：P1-已付款，P2-代收货款</paystate>


	  <paytime>付款时间</paytime>


	  <paytype>支付类别（如支付宝、现金、银联等) </paytype>


	  <isinv>是否需要开具发票：1.是 2.否</isinv>


	  <invtype>发票类型</invtype>


	  <invrise>发票抬头</invrise>


	  <taxbearer>纳税人登记号</taxbearer>


	  <recaddr>发票地址</recaddr>


	  <recacc>发票开户行帐号</recacc>


	  <recbank>发票开户行</recbank>


	  <sname>发货人姓名</sname>


	  <sprovince>发货人所在省</sprovince>


	  <scity>发货人所在市</scity>


	  <scounty>货人所在县/区</scounty>


	  <saddr>详细地址</saddr>


	  <smobile>发货人联系电话</smobile>


	  <stel>发货人固定电话</stel>


	  <busflag>订单标记 1送装一体 2.只配送 3.开箱验货</busflag>


	  <remark>备注</remark>


	  <attributes>属性备注</attributes>


	  <remark1>备用字段</remark1>


	  <remark2>备用字段</remark2>


	  <remark3>备用字段</remark3>


	  <remark4>备用字段</remark4>


	  <remark5>备用字段</remark5>


	  <remark6>备用字段</remark6>


	  <remark7>备用字段</remark7>


	  <remark8>备用字段</remark8>


	  <items>


	    <Item>


	      <itemno>行号：订单中有多行物料时，物料所在的行数</itemno>


	   <storagetype>批次 产品状态:10 正品 21 不良 22 破箱 40 样品 L0礼品


	      </storagetype>           


	      <productcode>客户产品编码</productcode>


	      <hrcode>海尔产品编码 日日顺物流生成</hrcode>


	      <prodes>产品描述</prodes>


	      <volume>体积</volume>


	      <weight>重量</weight>


	      <number>数量</number>


	      <unprice>单价</unprice>


	      <reitem>前续订单行号(关联行号)</reitem>


	      <attributes><sn>个性化条码</sn> </attributes>


	      <remark1>备用</remark1>


	      <remark2>备用</remark2>


	    </Item>


	    <Item>


	      <itemno>行号：订单中有多行物料时，物料所在的行数</itemno>


	   <storagetype>批次 产品状态:10 正品 21 不良 22 破箱 40 样品 L0礼品


	      </storagetype>


	      <productcode>客户产品编码</productcode>


	      <hrcode>海尔产品编码 日日顺物流生成</hrcode>


	      <prodes>产品描述</prodes>


	      <volume>体积</volume>


	      <weight>重量</weight>


	      <number>数量</number>


	      <unprice>单价</unprice>


	      <reitem>前续订单行号(关联行号)</reitem>


	      <attributes><sn>个性化条码</sn> </attributes>


	      <remark1>备用</remark1>


	      <remark2>备用</remark2>


	    </Item>


	  </items>


	</Order>

                       

JSON

XML

                           

	

		<Order>
	
	

		  <orderno>订单号</orderno>
	
	

		  <storecode>仓库编码：按日日顺C码</storecode>
	
	

		  <province>收货人所在省</province>
	
	

		  <city>收货人所在市</city>
	
	

		  <county>收货人所在县/区</county>
	
	

		  <addr>详细地址</addr>
	
	

		  <gbcode>国标码：六位国标码</gbcode>
	
	

		  <name>送达方姓名：收货人姓名</name>
	
	

		  <mobile>联系电话</mobile>
	
	

		  <tel>固定电话</tel>
	
	

		  <postcode>邮政编码</postcode>
	
	

		  <deldate>预约时间：预约送货时间</deldate>
	
	

		  <insdate>预约时间：预约安装时间</insdate>
	
	

		  <reorder>前续订单号：关联单号</reorder>
	
	

		  <freight>运费</freight>
	
	

		  <billsum>订单总金额</billsum>
	
	

		  <billowe>代收金额：应收欠款</billowe>
	
	

		  <paystate>付款状态：P1-已付款，P2-代收货款</paystate>
	
	

		  <paytime>付款时间</paytime>
	
	

		  <paytype>支付类别（如支付宝、现金、银联等) </paytype>
	
	

		  <isinv>是否需要开具发票：1.是 2.否</isinv>
	
	

		  <invtype>发票类型</invtype>
	
	

		  <invrise>发票抬头</invrise>
	
	

		  <taxbearer>纳税人登记号</taxbearer>
	
	

		  <recaddr>发票地址</recaddr>
	
	

		  <recacc>发票开户行帐号</recacc>
	
	

		  <recbank>发票开户行</recbank>
	
	

		  <sname>发货人姓名</sname>
	
	

		  <sprovince>发货人所在省</sprovince>
	
	

		  <scity>发货人所在市</scity>
	
	

		  <scounty>货人所在县/区</scounty>
	
	

		  <saddr>详细地址</saddr>
	
	

		  <smobile>发货人联系电话</smobile>
	
	

		  <stel>发货人固定电话</stel>
	
	

		  <busflag>订单标记 1送装一体 2.只配送 3.开箱验货</busflag>
	
	

		  <remark>备注</remark>
	
	

		  <attributes>属性备注</attributes>
	
	

		  
	
	

		</Order>
	

                       

JSON

XML

                           23113
                       

JSON

标识	类型	说明
S01	系统错误	非法的XML格式
S02	系统错误	非法的数字签名
S03	系统错误	非法的物流公司
S04	系统错误	非法的通知类型
S05	系统错误	非法的通知内容