- 1、本文档共22页,可阅读全部内容。
- 2、有哪些信誉好的足球投注网站(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
文件类别:技术规范 密级:协议发布
中国邮政国内小包综合服务平台(订单系统)
上游客户系统标准接口规范
版本号: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
您可能关注的文档
- 中国人民大学硕士学位生开题.doc
- 中国商业保理行业发展情况及主要的商业保理公司.doc
- 重庆南开中学高2017级高三(上)7月考试语文(含).doc
- 重庆轻轨施工组织设计.doc
- 中国社会主义市场经济概论及发展历程.docx
- 中国社区服务O2O调研观察之六:社区外卖.doc
- 重庆市大型商业建筑设计规范.doc
- 重庆市涪陵区到稻城亚丁自驾游攻略.doc
- 中国石油天然气股份有限公司河南销售分公司加油站SF双层油罐项目.doc
- 重庆市建筑工程计价定额.doc
- 2024至2030年中国人造棉面料行业投资前景及策略咨询报告.docx
- 重庆市渝中区遴选公务员2024年国家公务员考试考试大纲历年真题10340笔试历年典型考题及解题思路附.docx
- 2024至2030年中国甲基苯乙酮行业深度调研及发展预测报告.docx
- 2024至2030年中国羚羊角类饮片行业深度调查与前景预测分析报告.docx
- 重庆市面向中国农业大学定向选调2024届大学毕业生2024年国家公务员考试考试大纲历年真题14笔试历.docx
- 重庆市面向西北工业大学定向选调2024届大学毕业生00笔试历年典型考题及解题思路附答案详解.docx
- 中国不动杆菌感染治疗药行业市场现状分析及竞争格局与投资发展研究报告2024-2029版.docx
- 2024至2030年全球与中国ETL软件市场现状及未来发展趋势.docx
- 初中八年级(初二)生物下册期末考试1含答案解析.docx
- 干簧式继电器项目申请报告.docx
文档评论(0)