中国邮政国内小包综合服务平台订单接口规范v100Word文件下载.docx

1、中国哈尔滨市南岗区西大直街133号 传真：086-1变更历史日期变更描述变更者2014-3-2新建2015-11-17增加重量字段1 概述1.1文档目的本文档主要规范中国邮政国内小包综合服务平台与上游客户（如电商客户）系统的数据接口。1.2 技术支持本接口开发由黑龙江邮政易通信息网络有限责任公司提供支持，如有疑问请联系易通公司。3 参数、安全及数据完整性 2.1 参数定义 2.1.1 上游客户系统发送给中国邮政的参数 参数名称 用途 logistics_interface 消息内容 data_digest 消息签名 msg_type 消息类型 （无需区分大小写） ecCompanyId 电商标

2、识，如“TAOBAO” （无需区分大小写） 2.1.2 中国邮政发送给上游客户系统的参数 logistic_provider_id TP编号 消息类型 消息正文的摘要 msg_type的值固定：属性值 说明 默认消息格式 ORDERCREATE 创建订单 XML UPDATE 订单更新（更新面单号、取消订单、接单、不接单、不揽收） 2.1.3 消息格式 请求和响应的消息格式将全部是XML2.2 安全及数据完整性 1、 以HTTP POST方式发送，请求方法的编码格式：“application/x-; charset=GBK”；2、 用“logistics_interface”字段表示要发送的X

3、ML内容；3、 用“data_digest”字段进行签名验证。签名使用MD5方式，对logistics_interface的内容进行签名。原理为：通知内容xml+parternID，然后进行MD5，转换为Base64字符串。详细解释如下： 假设xml内容为： ， partnered为123456 那么要签名的内容为123456，经过md5和base64后的 内容就为LghTkEmsD2tbQ3fsIBRcBg= ,方法如下：MessageDigest md5 = MessageDigest.getInstance（MD5）;BASE64Encoder base64en = new BASE64

4、Encoder（）;Ret=base64en.encode（md5.digest（str+partnered）.getBytes（GBK） ）; 然后需要对xml内容（ 发送；数据接收流程：接收- 数字签名校验-处理；3 接口描述3.1 订单接口3.1.1字段含义字段名含义类型长度是否为空ecCompanyId电商标识（如：TAOBAO）String64NlogisticProviderID物流公司IDcustomerId客户标识YtxLogisticID物流订单号tradeNo业务交易号（新业务类型待定：252国内小包）mailNo物流运单号orderType订单类型（0-COD 1-普通订

5、单 3 - 退货单）intserviceType服务类型（0-自己联系 1-在线下单（上门揽收）4-限时物流 8-快捷COD 16-快递保障）longname用户姓名32postCode用户邮编6phone用户电话，包括区号、电话号码及分机号，中间用“-”分隔；Y mobile用户移动电话, 手机和电话两者必需提供一个prov用户所在省city用户所在市县（区），市区中间用“,”分隔；注意有些市下面是没有区address用户详细地址256sendStartTime物流公司上门取货时间段，通过“yyyy-MM-dd HH:mm:ss”格式化，本文中所有时间格式相同。timestampsendEn

6、dTimegoodsValue商品金额，包括优惠和运费，但无服务费itemName商品名称number商品数量itemValue商品单价（单位：分 两位小数）special商品类型（保留字段，暂时不用）remark备注512totalServiceFee总服务费COD：（单位：分）buyServiceFee买家服务费COD ：codSplitFee物流公司分润COD ：weight商品重量（单位：克）3.1.2请求格式XML格式：!订单基本信息-ecCompanyId TAOBAOlogisticProviderIDPOSTBcustomerIda92266073246b3ed2a2f0ff4

7、d0b2bf5etxLogisticIDLP709tradeNo25709mailNo124579546621totalServiceFee3200codSplitFee2000buyServiceFee1000orderType1serviceType0发货方信息-sendername张三postCode310013phone231234134mobile/mobileprov浙江city杭州,西湖区address华星科技大厦9层/sender-收货方信息-receiver李四100000北京北京市-物流公司上门取货时间段-sendStartTime2005-08-24 08:00:00se

8、ndEndTime2005-08-24 12:00 -商品信息-goodsValue1900itemsitemitemNameNokia N73number2itemValue/itemValue/itemNokia N72special/specialremark易碎品 weight103.1.3参数描述 订单创建信息由电商物流平台发送给中国邮政，电商物流平台以HTTP POST方式发送消息，参数格式如下：4.1.2节描述的XML字符串 logistics_interface的MD5签名 固定“ORDERCREATE” （不区分大小写） 固定为“TAOBAO”（不区分大小写） 3.1.4返回格式返回标准的系统交互格式，详情见4系统交互处理流程3.1.5补充信息1、物流订单号在上游客户系统中要具有唯一性