中国邮政国内小包综合服务平台订单接口规范v100Word文件下载.docx
《中国邮政国内小包综合服务平台订单接口规范v100Word文件下载.docx》由会员分享,可在线阅读,更多相关《中国邮政国内小包综合服务平台订单接口规范v100Word文件下载.docx(20页珍藏版)》请在冰豆网上搜索。
中国·
哈尔滨市南岗区西大直街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
电商标识,如“TAOBAO”(无需区分大小写)
2.1.2中国邮政发送给上游客户系统的参数
logistic_provider_id
TP编号
消息类型
消息正文的摘要
msg_type的值固定:
属性值
说明
默认消息格式
ORDERCREATE
创建订单
XML
UPDATE
订单更新(更新面单号、取消订单、接单、不接单、不揽收)
2.1.3消息格式
请求和响应的消息格式将全部是XML
2.2安全及数据完整性
1、以HTTPPOST方式发送,请求方法的编码格式:
“application/x-;
charset=GBK”;
2、用“logistics_interface”字段表示要发送的XML内容;
3、用“data_digest”字段进行签名验证。
签名使用MD5方式,对logistics_interface的内容进行签名。
原理为:
通知内容xml+parternID,然后进行MD5,转换为Base64字符串。
详细解释如下:
◆假设xml内容为:
<
RequestOrder>
<
/RequestOrder>
,partnered为123456
◆那么要签名的内容为<
123456,经过md5和base64后的内容就为LghTkEmsD2tbQ3fsIBRcBg==,方法如下:
MessageDigestmd5=MessageDigest.getInstance("
MD5"
);
BASE64Encoderbase64en=newBASE64Encoder();
Ret=base64en.encode(md5.digest((str+partnered).getBytes("
GBK"
)));
◆然后需要对xml内容(<
)进行URL编码(字符集为GBK),为:
%3Corder%3E%3C%2Forder%3E
◆同样需要对签名的字符串进行URL编码,LghTkEmsD2tbQ3fsIBRcBg==的内容为:
LghTkEmsD2tbQ3fsIBRcBg%3D%3D
◆最终要发送的数据为:
logistics_interface=%3Corder%3E%3C%2Forder%3E&
data_digest=LghTkEmsD2tbQ3fsIBRcBg%3D%3D&
msg_type=?
4、收到消息后,一定要验证数据是否完整及正确;
5、传输通道安全(https),目前不要求实现。
6、内容不正确?
请检查字符集是否为GBK;
所有的参数都是通过URL编码传送的,符合HTTP协议,注意客户端是否解码正确,有些控件已经自带URL解码功能,请开发人员注意。
2.3数据发送和接收处理流程
数据发送流程:
数字签名->
发送;
数据接收流程:
接收->
数字签名校验->
处理;
3接口描述
3.1订单接口
3.1.1字段含义
字段名
含义
类型
长度
是否为空
ecCompanyId
电商标识(如:
TAOBAO)
String
64
N
logisticProviderID
物流公司ID
customerId
客户标识
Y
txLogisticID
物流订单号
tradeNo
业务交易号(新业务类型待定:
252国内小包)
mailNo
物流运单号
orderType
订单类型(0-COD1-普通订单
3-退货单)
int
serviceType
服务类型(0-自己联系1-在线下单(上门揽收)4-限时物流8-快捷COD16-快递保障)
long
name
用户姓名
32
postCode
用户邮编
6
phone
用户电话,包括区号、电话号码及分机号,中间用“-”分隔;
Y
mobile
用户移动电话,手机和电话两者必需提供一个
prov
用户所在省
city
用户所在市县(区),市区中间用“,”分隔;
注意有些市下面是没有区
address
用户详细地址
256
sendStartTime
物流公司上门取货时间段,通过“yyyy-MM-ddHH:
mm:
ss”格式化,本文中所有时间格式相同。
timestamp
sendEndTime
goodsValue
商品金额,包括优惠和运费,但无服务费
itemName
商品名称
number
商品数量
itemValue
商品单价(单位:
分两位小数)
special
商品类型(保留字段,暂时不用)
remark
备注
512
totalServiceFee
总服务费[COD]:
(单位:
分)
buyServiceFee
买家服务费[COD]:
codSplitFee
物流公司分润[COD]:
weight
商品重量(单位:
克)
3.1.2请求格式
XML格式:
!
—订单基本信息-->
ecCompanyId>
TAOBAO<
/ecCompanyId>
logisticProviderID>
POSTB<
/logisticProviderID>
customerId>
a92266073246b3ed2a2f0ff4d0b2bf5e<
/customerId>
txLogisticID>
LP709<
/txLogisticID>
tradeNo>
25709<
/tradeNo>
mailNo>
124579546621<
/mailNo>
totalServiceFee>
3200<
/totalServiceFee>
codSplitFee>
2000<
/codSplitFee>
buyServiceFee>
1000<
/buyServiceFee>
orderType>
1<
/orderType>
serviceType>
0<
/serviceType>
—发货方信息-->
sender>
name>
张三<
/name>
postCode>
310013<
/postCode>
phone>
231234134<
/phone>
mobile>
/mobile>
prov>
浙江<
/prov>
city>
杭州,西湖区<
/city>
address>
华星科技大厦9层<
/address>
/sender>
--收货方信息-->
receiver>
李四<
100000<
北京<
北京市<
/receiver>
--物流公司上门取货时间段-->
sendStartTime>
2005-08-2408:
00:
00<
/sendStartTime>
sendEndTime>
2005-08-2412:
00<
/sendEndTime>
--商品信息-->
goodsValue>
1900<
/goodsValue>
items>
item>
itemName>
NokiaN73<
/itemName>
number>
2<
/number>
itemValue>
/itemValue>
/item>
NokiaN72<
/items>
special>
/special>
remark>
易碎品<
/remark>
weight>
10<
/weight>
3.1.3参数描述
订单创建信息由电商物流平台发送给中国邮政,电商物流平台以HTTPPOST方式发送消息,参数格式如下:
4.1.2节描述的XML字符串
logistics_interface的MD5签名
固定“ORDERCREATE”(不区分大小写)
固定为“TAOBAO”(不区分大小写)
3.1.4返回格式
返回标准的系统交互格式,详情见《4系统交互处理流程》
3.1.5补充信息
1、物流订单号在上游客户系统中要具有唯一性