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

1、文件类别：技术规范文件类别：技术规范 密级：协议发布密级：协议发布 中国邮政国内小包综合服务平台（订单系统） 上游客户系统标准接口规范 版本号：版本号：V1.0.0 文档编号：文档编号： YT-NPP-API-01YT-NPP-API-01 编制单位：编制单位：国内小包项目组国内小包项目组 编编 制制 人：人： 黄春凤黄春凤编制日期：编制日期：20142014 年年 3 3 月月 2 2 日日 审审 核核 人：人：徐黎春徐黎春审核日期：审核日期：20142014 年年 3 3 月月 3 3 日日 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 2 / 23 批批 准准 人：人：李传波李传波批准日期：批准日期：20142014 年年 5 5 月月 8 8 日日 Copyright 2001-2014, HLJ Post YiTong Info-net Co.,Ltd. 网址：http:/www.e- 电话：086-0451-86292464 地址：中国哈尔滨市南岗区西大直街 133 号 传真：086-0451-86292461 中国邮政国内小包综合服务平台订单接口规范 v1.0.

2、0 3 / 23 变更历史变更历史 日期日期变更描述变更描述变更者变更者 2014-3-2 新建黄春凤 2015-11-17 增加重量字段 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 4 / 23 目目 录录 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

3、.4 业务错误信息21 4.5 系统错误信息21 5 其它问题和注意事项其它问题和注意事项22 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 5 / 23 1 1概述概述 1.1 文档目的文档目的 本文档主要规范中国邮政国内小包综合服务平台与上游客户（如电商客户）系统的数 据接口。 1.2 技术支持技术支持 本接口开发由黑龙江邮政易通信息网络有限责任公司提供支持，如有疑问请联系易通 公司。 3 3 参数、安全及数据完整性参数、安全及数据完整性 2.1 参数定义参数定义 2.1.1 上游客户系统发送给中国邮政的参数上游客户系统发送给中国邮政的参数 参数名称 用途 logistics_interface 消息内容 data_digest 消息签名 msg_type 消息类型 （无需区分大小写） ecCompanyId 电商标识，如“TAOBAO” （无需 区分大小写） 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 6 / 23 2.1.2 中国邮政发送给上游客户系统的参数中国邮政发送给上游客户系统的参数 参数名称 用途 logistics_interface 消息内容

4、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” ； 2、 用“logistics_interface”字段表示要发送的XML内容； 3、 用“data_digest”字段进行签名验证。签名使用MD5方式，对logistics_interface的 内容进行签名。原理为：通知内容xml+parternID，然后进行MD5，转换为Base64字符串。 详细解释如下： 假设xml内容为： ， partnered为123456 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 7

5、/ 23 那么要签名的内容为123456，经过md5和base64后 的内容就为LghTkEmsD2tbQ3fsIBRcBg= ,方法如下： MessageDigest md5 = MessageDigest.getInstance(“MD5“); BASE64Encoder base64en = new BASE64Encoder(); 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、收到消息后，一定要验证数据是否

6、完整及正确； 5、传输通道安全（https） ，目前不要求实现。 6、内容不正确？请检查字符集是否为GBK；所有的参数都是通过URL编码传送的，符合HTTP 协议，注意客户端是否解码正确，有些控件已经自带URL解码功能，请开发人员注意。 2.3 数据发送和接收处理流程数据发送和接收处理流程 数据发送流程：数字签名- 发送； 数据接收流程：接收- 数字签名校验-处理； 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 8 / 23 3 3 接口描述接口描述 3.1 订单接口订单接口 3.1.1 字段含义字段含义 字段名含义类型长度是否为 空 ecCompanyId电商标识（如：TAOBAO）String64N logisticProviderID物流公司 IDString64N customerId客户标识String64Y txLogisticID物流订单号String64N tradeNo业务交易号（新业务类型待定：业务交易号（新业务类型待定：252 国内小包）国内小包） String64Y mailNo物流运单号String64N orderType订单类型(0-COD 1-

7、普通订单 3 - 退货单) intN serviceType服务类型(0-自己联系 1-在线下单 （上门揽收）4-限时物流 8-快捷 COD 16-快递保障) longN name用户姓名String32N postCode用户邮编String6N phone用户电话，包括区号、电话号码及 分机号，中间用“-”分隔； String32Y mobile用户移动电话, 手机和电话两者必需 提供一个 String32Y prov用户所在省String32N city用户所在市县（区） ，市区中间用 “,”分隔；注意有些市下面是没有 String32N 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 9 / 23 区 address用户详细地址String256N sendStartTimetimestampY sendEndTime 物流公司上门取货时间段，通过 “yyyy-MM-dd HH:mm:ss”格式化， 本文中所有时间格式相同。 timestampY goodsValue商品金额，包括优惠和运费，但无 服务费 longN itemName商品名称String256N num

8、ber商品数量intN itemValue商品单价（单位：分 两位小数）longN special商品类型（保留字段，暂时不用）intY remark备注String512Y totalServiceFee总服务费COD：（单位：分）longY buyServiceFee买家服务费COD ：（单位：分）longY codSplitFee物流公司分润COD ：（单位：分） longY weight商品重量（单位：克）longN 3.1.2 请求格式请求格式 XML格式： TAOBAO POSTB a92266073246b3ed2a2f0ff4d0b2bf5e LP07082300225709 2007082300225709 124579546621 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 10 / 23 3200 2000 1000 1 0 张三 310013 231234134 13575745195 浙江 杭州,西湖区 华星科技大厦9层 李四 100000 231234134 13575745195 北京 北京市 华星科技大厦9层 2005-08-24 08:00

9、:00 2005-08-24 12:00:00 1900 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 11 / 23 Nokia N73 2 2 Nokia N72 1 2 0 易碎品 10 3.1.3 参数描述参数描述 订单创建信息由电商物流平台发送给中国邮政，电商物流平台以HTTP POST方式发送消息， 参数格式如下： 参数名称 用途 logistics_interface 4.1.2节描述的XML字符串 data_digest logistics_interface的MD5签名 msg_type 固定“ORDERCREATE” (不区分大小写) ecCompanyId 固定为“TAOBAO”(不区分大小写) 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 12 / 23 3.1.4 返回格式返回格式 返回标准的系统交互格式，详情见4 系统交互处理流程 3.1.5 补充信息补充信息 1、物流订单号在上游客户系统中要具有唯一性 2、卖家发货后，电商物流平台实时发送订单到邮政物流公司，这是系统交互，跟后面的业 务处理是分开的； 3.23.2 订单信息更新接口订单信息更新接口 3.2.1 字段含义字段含义 字段名含义类型长度 是否 为空 logisticProviderID 物流公司编号 String64N ecCompanyId 电商标识；如淘宝的消 息， 此字段填写为 “TAOBAO” ； String64Y txLogisticID 物流平台的物流号 （不能为空） String64N fieldName 可更新字段： 1、mailNo； 2、weight； 3、status String64N fieldValue 字段新值 String64N fieldList (field1. .20) remark 取消订单、不接单、 不揽收时， 此字段用于填写原因 String215Y 注：可以同时更新多笔订单，但最多不超过20个； status 字段可选值： 中国邮政国内小包综合服务平台订单接口规范 v1.0.0 13 / 23 名称 说明 WITHDRAW 取消订单 ACCEPT 接单成功 UNACCEPT 接单失败 NOT_

《中国邮政国内小包综合服务平台订单接口规范v1.0.0.精讲》由会员jiups****uk12分享，可在线阅读，更多相关《中国邮政国内小包综合服务平台订单接口规范v1.0.0.精讲》请在金锄头文库上搜索。