中国邮政国内小包综合服务平台订单接口规范v100
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
文件类别：技术规范密级：协议发布
中国邮政国内小包综合服务平台（订单系统）上游客户系统标准接口规范
版本号：V1.0.0
变更历史
目录
1概述 (4)
1.1文档目的 (4)
1.2 技术支持 (4)
3 参数、安全及数据完整性 (4)
2.1 参数定义 (4)
2.1.1 上游客户系统发送给中国邮政的参数 (4)
2.1.2 中国邮政发送给上游客户系统的参数 (5)
2.1.3 消息格式 (5)
2.2 安全及数据完整性 (5)
2.3 数据发送和接收处理流程 (6)
3 接口描述 (6)
3.1 订单接口 (6)
3.1.1字段含义 (6)
3.1.2请求格式 (8)
3.1.3参数描述 (10)
3.1.4返回格式 (10)
3.1.5补充信息 (10)
3.2订单信息更新接口 (11)
3.2.1字段含义 (11)
3.2.2请求格式 (11)
3.2.3参数描述 (18)
3.2.4 补充信息 (18)
4系统交互处理流程 (19)
4.1 流程图 (19)
4.2格式 (19)
4.1.1 接口反馈结果 (19)
4.3补充信息 (20)
4.4业务错误信息 (20)
4.5系统错误信息 (21)
5 其它问题和注意事项 (21)
1概述
1.1文档目的
本文档主要规范中国邮政国内小包综合服务平台与上游客户（如电商客户）系统的数据接口。
1.2 技术支持
本接口开发由黑龙江邮政易通信息网络有限责任公司提供支持，如有疑问请联系易通公司。
3 参数、安全及数据完整性
2.1 参数定义
2.1.1 上游客户系统发送给中国邮政的参数
2.1.2 中国邮政发送给上游客户系统的参数
msg_type的值固定：
2.1.3 消息格式
请求和响应的消息格式将全部是XML
2.2 安全及数据完整性
1、以HTTP POST方式发送，请求方法的编码格式：“application/x-; charset=GBK”；
2、用“logistics_interface”字段表示要发送的XML内容；
3、用“data_digest”字段进行签名验证。签名使用MD5方式，对logistics_interface的内容进行签名。原理为：通知内容xml+parternID，然后进行MD5，转换为Base64字符串。详细解释如下：
◆假设xml内容为：
◆那么要签名的内容为
内容就为LghTkEmsD2tbQ3fsIBRcBg== ,方法如下：
MessageDigest md5 = MessageDigest.getInstance("MD5");
BASE64Encoder base64en = new BASE64Encoder();
Ret=base64en.encode(md5.digest((str+partnered).getBytes("GBK")) );
◆然后需要对xml内容（
为：%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字段含义
3.1.2请求格式
XML格式：