中国邮政国内小包综合服务平台订单接口规范v1.0.0资料.doc

文件类别：技术规范 密级：协议发布 中国邮政国内小包综合服务平台（订单系统） 上游客户系统标准接口规范 版本号：V1.0.0 文档编号： YT-NPP-API-01 编制单位： 国内小包项目组 编 制 人： 黄春凤 编制日期： 2014年3月2日 审 核 人： 徐黎春 审核日期： 2014年3月3日 批 准 人： 李传波 批准日期： 2014年5月8日 变更历史 日期 变更描述 变更者 2014-3-2 新建 黄春凤 2015-11-17 增加重量字段  目 录 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 接口描述 7 3.1 订单接口 7 3.1.1字段含义 7 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请求格式 12 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业务错误信息 21 4.5系统错误信息 21 5 其它问题和注意事项 22  概述 1.1文档目的 本文档主要规范中国邮政国内小包综合服务平台与上游客户（如电商客户）系统的数据接口。 1.2 技术支持 本接口开发由黑龙江邮政易通信息网络有限责任公司提供支持，如有疑问请联系易通公司。 3 参数、安全及数据完整性 2.1 参数定义 2.1.1 上游客户系统发送给中国邮政的参数 参数名称 用途 logistics_interface 消息内容 data_digest 消息签名 msg_type 消息类型 （无需区分大小写） ecCompanyId 电商标识，如“TAOBAO” （无需区分大小写） 2.1.2 中国邮政发送给上游客户系统的参数 参数名称 用途 logistics_interface 消息内容 logistic_provider_id TP编号 msg_type 消息类型 data_digest 消息正文的摘要 msg_type的值固定： 属性值 说明 默认消息格式 ORDERCREATE 创建订单 XML UPDATE 订单更新（更新面单号、取消订单、接单、不接单、不揽收） XML 2.1.3 消息格式 请求和响应的消息格式将全部是XML 2.2 安全及数据完整性 1、 以HTTP POST方式发送，请求方法的编码格式：“application/x-www-form-urlencoded; charset=GBK”； 用“logistics_interface”字段表示要发送的XML内容； 3、 用“data_digest”字段进行签名验证。签名使用MD5方式，对logistics_interface的内容进行签名。原理为：通知内容xml+parternID，然后进行MD5，转换为Base64字符串。 详细解释如下： ◆假设xml内容为： RequestOrder/RequestOrder， partnered为123456 ◆那么要签名的内容为RequestOrder/RequestOrder123456，经过md5和base64后的 内容就为LghTkEmsD2tbQ3fsIBRcBg== ,方法如下： MessageDigest md5 = MessageDigest.getInstance(MD5); BASE64Encoder base64en = new BASE64Encoder(); Ret=base64en.encode(md5.digest((str+partnered).getBytes(GBK)) ); ◆然后需要对xml内容（RequestOrder/RequestOrder）进行URL编码（字符集为GBK）， 为：%3Corder%3E%3C%2Forder%3E ◆同样需要对签名的字符串进行URL编码，LghTkEmsD2tbQ3fsIBRcBg==的内容为： LghTkEmsD2tbQ3fsIBRcBg%3D%3D ◆最终要发送的数据为： logi