中国邮政国内小包服务订单规范详解.docx

密级：协议公布文献类别：技术规范中国邮政国内小包综合服务平台（订单系统）上游客户系统原则接口规范版本号：V1.0.0文档编号：YT-NPP-API-Oi编制单位：国内小包项目组编制人,黄春凤编制日期：2023年3月2日审核人，徐黎春审核日期，2023年3月3日批准人：李传波同意日期：2023年5月8日©Copyright2023-2023,HLJPostYiTongInfo-netCo.,Ltd.:086-变更历史日期变更描述变更者2023-3-2新建黄春凤2023-11-17增长重量字段1 概述错误!未定义书签。1.1 文档目的错误!未定义书签。1.2 技术支持错误!未定义书签。3参数、安全及数据完整性错误!未定义书签。2.1 参数定义错误!未定义书签。2.1.1 上游客户系统发送给中国邮政的参数错误!未定义书签。2.1.2 中国邮政发送给上游客户系统的参数错误!未定义书签。2.1.3 消息格式错误!未定义书签。2.2 安全及数据完整性错误!未定义书签。2.3 数据发送和接受处理流程错误!未定义书签。2.4 描述错误!未定义书签。3.1订单接口错误!未定义书签。字段含义错误!未定义书签。祈求格式错误!未定义书签。参数描述错误!未定义书签。返回格式错误!未定义书签。补充信息错误!未定义书签。2.5 2订单信息更新接口错误!未定义书签。字段含义错误!未定义书签。祈求格式错误!未定义书签。参数描述错误!未定义书签。3.2.4补充信息错误!未定义书签。4系统交互处理流程错误!未定义书签。4.1 流程图错误!未定义书签。4.2 格式错误!未定义书签。4.2.1 接口反馈成果错误!未定义书签。4.3 补充信息错误!未定义书签。4.4 业务错误信息错误!未定义书签。4.5 系统错误信息错误!未定义书签。5其他问题和注意事项错误!未定义书签。1概述1.1 文档目的本文档重要规范中国邮政国内小包综合服务平台与上游客户（如电商客户）系统的数据接口。1.2 技术支持本接口开发由黑龙江邮政易通信息网络有限责任企业提供支持，如有疑问请联络易通企业。3参数、安全及数据完整性2.1 参数定义2.1.1 上游客户系统发送给中国邮政的参数参数名称用途logistics_interface消息内容data_digest消息签名msg_type消息类型（无需辨别大小写）OcCompanyId电商标识，如“TA0BA0”（无需辨别大小写）2.1.2 中国邮政发送给上游客户系统的参数参数名称用途logistics_interface消息内容Iogistic_provider_idTP编号msg_type消息类型data_digest消息正文口勺摘要msg_type的值固定:属性值阐明默认消息格式Ordercreate创立订单XMLupdate订单更新（更新面单号、取消订单、接单、不接单、不揽收）XML2.1.3 消息格式祈求和响应的消息格式将所有是XML2.2 安全及数据完整性1、以POST方式发送，祈求措施聆J编码格式：“application-form-urIencoded;Charset=GBK”；2、用“IogisticsJnterface”字段表达要发送BXML内容；3、用“data_digest”字段进行签名验证。签名使用MD5方式，对IOgiStics_interface的）内容进行签名。原理为：告知内容xml+parternID,然后进行MD5,转换为Base64字符串。详细解释如下:假设xm内容为：<RequestOrder><RequestOrder>,Partnered为123456那么要签名的内容为<RequestOrder></ReqUeStorder>123456,通过md5和base64后的内容就为LghTkEnISD2tbQ3fsIBRcBg=,措施如下：MessageDigestmd5=MessageDigest.getlnstance(,MD5,*);BASE64Encoderbase64en=newBASE64Encoder();Ret=base64en.encode(md5.digest(str+artnered).getBytes("GBKu)；然后需要对Xml内容(<RequestOrderX/ReqUeStorder>)进行URL编码(字符集为GBK),为：%3Corder%3E%3C%2Forder%3E同样需要对签名口勺字符串进行URL编码，LghTkEnISD2tbQ3fSlBRcBg二的内容为：1.ghTkEmsD2tbQ3fsIBRcBg%3D%3D最终要发送的数据为：Iogistics_interface=%3Corder%3E%3C%2Forder%3E&data_digest=1.ghTkEmsD2tbQ3fslBRcBg%3D%3Dftmsgtype=?4、收到消息后，一定要验证数据与否完整及对的；5、传播通道安全(s),目前不规定实现。6、内容不对的？请检查字符集与否为GBK；所有的参数都是通过URL编码传送的，符合协议，注意客户端与否解码对的，有些控件已经自带URL解码功能，请开发人员注意。2.3 数据发送和接受处理流程数据发送流程：数字签名->发送；数据接受流程：接受-数字签名校验-处理;3接口描述3.1订单接口3.1.1字段含义字段名含义类型向度与否为空ecCompanyld电商标识（如：TAOBAO）String64NIogisticProviderID物流企业IDString64NCuslomerId客户标识String64YtxLogisticID物流订单号String64NtradeNo业务交易号（新业务类型待定I252国内小包）String64YmailNo物流运单号String64NOrderType订单类型（O-COD1一般订单3-退货单）intNServiceType服务类型（0-自己联络I-在线下单（上门揽收）4-限时物流8-快捷COD16-快递保障）longNname顾客姓名String32NpostCode顾客String6Nphone顾客，包括区号、号码及分机号，中间用分隔；String32Ymobile顾客移动，和两者必需提供一种String32Yprov顾客所在省String32Ncity顾客所在市县（区），市区中间用分隔；注意有些市下面是没有区String32Naddress顾客详细地址String256NSendStartTime物流企业上门取货时间段，通过"yyyy-MM-ddHH:mm:ss”格式化，本文中所有时间格式相似。timestampYSendEndTimetimestampYgoodsValue商品金额，包括优惠和运费，但无服务费longNitemName商品名称String256Nnumber商品数量intNitemValue商品单价（单位：分两位小数）longNspecial商品类型（保留字段,临时不用）intYremark备注String512YIotalServiceFee总服务费COD：（单位：分）longYbuyServiceFee买家服务费COD：（单位：分）longYCodSplitFee物流企业分润COD：（单位：分）longYweight商品重量（单位：克）longN3.1.2祈求格式XML格式:<RequestOrder><!一订单基本信息一>CecCompanyId>TAOBAO<ecCompanyId><logisticProviderID>POSTB<1ogisticProviderID><customerld>ab3ed2a2f0ff4d0b2bf5e<customerld><txLogisticID>LP09<txLogisticID><tradeNo>5709</tradeNo><mailNo><mailNo><totalServiceFee>3200<totalServiceFee><codSplitFee>2023<codSplitFee><buyServiceFee>1000<buyServiceFee><orderType>l<orderType><serviceType>O</serviceType><!一发货方信息一><sender><name>张三<name><postCode>310013<postCode><phone></phone><mobile><mobile><prov>浙江<prov><city>杭州，西湖区<city><address华星科技大厦9层<address><!一收货方信息一><receiver><name>李四<name><postCode>100000<postCode><phone></phone><mobile><mobile><prov>北京<prov><city>北京市<city><address>华星科技大厦9层"address<receiver>Q一物流企业上门取货时间段一><sendStartTime>2023-08-2408:00:00<sendStartTime><sendEndTime>2023-08-2412:00:00<sendEndTime><!商品信息一><goodsValue>1900<goodsValue><items><item><itemName>NokiaN73<itemName><number>2</number><itemValue>2<itemValue><item><item><itemName>NokiaN72<itemName><number>K/number><itemValue>2<itemValue><item><items><special>O<special><remark>易碎品</remark><weight>10</weight><RequestOrder>3.1.3 参数描述订单创立信息由电商物流平台发送给中国邮政，电商物流平台以PoST方式发送消息，参数格