中国邮政国内小包综合服务平台订单接口规范v100

合集下载

--检验检疫快件监管报文接口规范

--检验检疫快件监管报文接口规范

检验检疫快件监管报文接口规范1 报文版本说明2 传输报文标准CBECMESSAGE报文版本<CBECMESSAGE>为传输报文XML根节点名称,其中作为标识为DTC1.0版本,要求报文数据采用UTF-8字符编码集。

2.1.1 <MESSAGEHEAD>传输报文头描述2.1.2 <MESSAGEBODY>传输报文体描述<MESSAGEBODY>为待传输报文数据的父节点,要求MESSAGEBODY包括报文数据为XML格式(即存在唯一XML根节点),要求报文数据采用UTF-8字符编码集。

2.1.3 报文示例<?xml version=”1.0”encoding=”utf-8”?><CBECMESSAGE><MESSAGEHEAD><MESSAGEID>报文编号唯一标示(推荐使用GUID)</MESSAGEID ><MESSAGETYPE>报文类型</MESSAGETYPE><SENDERID>SENDERID</SENDERID><RECEIVERID>RECEIVERID</RECEIVERID><SENDTIME>yyyy-MM-ddTHH:mm:ss</SENDTIME></MESSAGEHEAD><MESSAGE BODY><BODYMASTER>表头</BODYMASTER>或者<BODYMASTERCIQ>表头</BODYMASTERCIQ>(一般进出口使用) 表体</MESSAGEBODY></CBECMESSAGE>3 一般快件出口业务数据规范商品清单报文3.1.1 国检表头3.1.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>3.1.1.2 XML格式<BODYMASTERCIQ><CUSTOMSCODE>主管海关代码</CUSTOMSCODE><ORDERNO>订单编号</ORDERNO><REG_NO>申报单位注册号</REG_NO><REG_NAME>申报单位名称</REG_NAME><APL_LINKMAN>申报单位联系人</APL_LINKMAN><APL_TEL>联系电话</APL_TEL><APL_PERSON_CODE>申报员代码</APL_PERSON_CODE><APL_DATE>申报(检)日期</APL_DATE><CORP_ATTR>企业性质代码</CORP_ATTR><FOREIGN_ASSET>是否外商投资财产</FOREIGN_ASSET><CONSIGNEE_CODE>收货人代码(企业)</CONSIGNEE_CODE><CONSIGNEE_CN>收货人中文(企业)</CONSIGNEE_CN><CONSIGNEE_EN>收货人英文(企业)</CONSIGNEE_EN><REC_NAME>收货人姓名(个人)</REC_NAME><REG_ID>订购人身份证号(个人)</REG_ID><REC_TEL>收货人电话(个人)</REC_TEL><REC_COMPANY_NAME>收货人公司名称</REC_COMPANY_NAME><REC_ADDRESS>收货人地址</REC_ADDRESS><REC_COUNTRY>收货国家</REC_COUNTRY><REC_CITY>收货地城市</REC_CITY><REC_PROVINCE>收货地省/州</REC_PROVINCE><REC_ZIP>收货地邮编</REC_ZIP><CONSIGNOR_CODE>发货人代码(企业)</CONSIGNOR_CODE><CONSIGNOR_CN>发货人中文(企业)</CONSIGNOR_CN><CONSIGNOR_EN>发货人英文(企业)</CONSIGNOR_EN><SENDER_TEL>发货人电话</SENDER_TEL><SENDER_COMPANY_NAME>发货人公司名</SENDER_COMPANY_NAME> <SENDER_ADDR>发货人地址</SENDER_ADDR><SENDER_ZIP>发货人邮编</SENDER_ZIP><SENDER_CITY>发货人城市</SENDER_CITY><SENDER_PROVINCE>发货人省/州名</SENDER_PROVINCE><SENDER_COUNTRY>发货人国家</SENDER_COUNTRY><CONVEY_CODE>运输工具代码</CONVEY_CODE><CONVEY_DETAIL>航次号</CONVEY_DETAIL><TONNAGE>运输工具吨位</TONNAGE><CONTRACT_NO>合同号</CONTRACT_NO><TRADE_CODE>贸易方式代码</TRADE_CODE><TRADE_AREA_CODE>贸易国代码</TRADE_AREA_CODE><PARENT_BL_NO>主提单/运单号码</PARENT_BL_NO><BL_NO>提单/运单号码</BL_NO><ARRIVE_DATE>到货日期</ARRIVE_DATE><DEPART_AREA_CODE>起运国代码</DEPART_AREA_CODE><LICENCE_NO>许可证号码</LICENCE_NO><UNLOAD_DATE>卸货日期</UNLOAD_DATE><DEPART_PORT>起运口岸代码</DEPART_PORT><ARRIVE_PORT>到达港代码</ARRIVE_PORT><DEST_PORT>到达口岸代码</DEST_PORT><COMPEN_VALID_DAYS>索赔有效期(天)</COMPEN_VALID_DAYS> <MID_PORT>中转港(经停口岸)代码</MID_PORT><DESTINATION>目的地(区)代码</DESTINATION><SPEC_CLAUSE>特殊条款</SPEC_CLAUSE><GOODS_PLACE>货物存放地点</GOODS_PLACE><ATTACH_DOC_CODES>随附单据代码串</ATTACH_DOC_CODES><DEST_ORG_CODE>目的机构代码</DEST_ORG_CODE><CHECK_ORG_CODE>施检机构代码</CHECK_ORG_CODE><CERT_TYPE_CODES>所需证书代码串</CERT_TYPE_CODES><CERT_ORIGINALS>所需证书正本份数串</CERT_ORIGINALS><DECL_TYPE_CODE>报检类别代码</DECL_TYPE_CODE><PURPOSE>用途代码</PURPOSE><MARKS_NUM>标记及号码</MARKS_NUM><CUSTOM_CODE>报关口岸代码</CUSTOM_CODE><BACK_TRANSPORT_FLAG>是否退运</BACK_TRANSPORT_FLAG><TRANS_MEANS_NAME>交通工具名称(船名)</TRANS_MEANS_NAME><ENT_SEND_NO>企业端唯一号</ENT_SEND_NO><CUS_CIQ_NO>关检号</CUS_CIQ_NO><CUS_CIQ_WORD>关检号密码</CUS_CIQ_WORD><SEND_TIME>发送时间</SEND_TIME><APL_CODE>申报企业注册号</APL_CODE><APL_NAME>申报企业注册名称</APL_NAME><CROSS_ORDER_ID>跨境平台订单号</CROSS_ORDER_ID><BUSINESS_ORDER_ID>电商平台订单号</BUSINESS_ORDER_ID><TRADE_CO>经营单位代码</TRADE_CO><TRADE_CNAME>经营单位名称</TRADE_CNAME><TRADE_TIME>交易时间</TRADE_TIME><CURRENCY>币种代码</CURRENCY><RATE>汇率</RATE><CARGO_DETAIL>货物详细货名</CARGO_DETAIL><TOTAL_PRICE>商品合计总价</TOTAL_PRICE><TOTAL_TAX>行邮税合计总价</TOTAL_TAX><EXPRESS_PRICE>快递运费</EXPRESS_PRICE><IEFLAG>进出口标识</IEFLAG><IEPORT>进出口岸代码(入境口岸)</IEPORT><APPROVE_CODE>审批号码</APPROVE_CODE><SUBSIDIARY>企业分号</SUBSIDIARY><ATTACH_DOC_CODES>随附单据代码串</ATTACH_DOC_CODES><CERT_COPIES>所需证书复印件份数串</CERT_COPIES><TECH_REG_CODE>组织机构代码</TECH_REG_CODE><CUSTOMDECL>报关地</CUSTOMDECL><DO_NO>提货单号</DO_NO><EXCHANGE_NOTE_CODES>换证凭单编号串</EXCHANGE_NOTE_CODES><EXCHANGE_NOTE_NUM>换证凭单份数串</EXCHANGE_NOTE_NUM><PACK_CAP_RESU_CODES>包装性能结果单编号串</PACK_CAP_RESU_CODES> <PACK_USE_RESU_CODES>包装使用结果单编号串</PACK_USE_RESU_CODES> <COMB_BATCH_NO>组批号</COMB_BATCH_NO><DEST_AREA_CODE>输往国家(贸易国)</DEST_AREA_CODE><EXCHANGE_RECORD><RESULT_CONTENT>厂检结果</RESULT_CONTENT><PROD_NO>生产批号</PROD_NO></EXCHANGE_RECORD></BODYMASTERCIQ>3.1.1.3 详细信息3.1.2 国检表体3.1.2.1 商品信息3.1.2.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>3.1.2.1.2 XML格式<GOODS_RECORD><SERIAL_NO>货物序号</SERIAL_NO><GOODS_CN>货物中文名称</GOODS_CN><GOODS_EN>货物英文名称</GOODS_EN><GOODS_MODEL>货物规格</GOODS_MODEL><HS_CODE>H.S.编码(税号)</HS_CODE><ORI_AREA_CODE>原产国代码</ORI_AREA_CODE><WEIGHT>重量</WEIGHT><WEIGHT_UNIT_CODE>重量单位代码</WEIGHT_UNIT_CODE><QUANTITY>数量</QUANTITY><QUANTITY_UNIT_CODE>数量单位代码</QUANTITY_UNIT_CODE><STD_QUANTITY>标准量</STD_QUANTITY><STD_UNIT>标准量单位代码</STD_UNIT><AMOUNT>金额(总价)</AMOUNT><MONEY_UNIT>货币单位代码</MONEY_UNIT><PACK_QUAN>包装数量</PACK_QUAN><PACK_KIND>包装类型代码</PACK_KIND><PRICE>单价</PRICE><WASTE_FLAG>废旧物品标识</WASTE_FLAG><PURPOSE_CODE>用途代码</PURPOSE_CODE><PROD_REG_NO>生产单位注册号</PROD_REG_NO><CIQ_CODE>CIQ代码</CIQ_CODE><AMOUNT_TAX>单项商品行邮税</AMOUNT_TAX><STD_WEIGHT>标准重量</STD_WEIGHT><STD_WEIGHT_UNIT_CODE>标准重量单位代码</STD_WEIGHT_UNIT_CODE><CONDITION_FLAG>验证条件标识</CONDITION_FLAG><CHECKUP_WORK_CODE>工作方式</CHECKUP_WORK_CODE><CHECKUP_TYPE_CODE>鉴重方式</CHECKUP_TYPE_CODE><INSP_MODE_CODE>检验方式</INSP_MODE_CODE><MANUF_REG_CNAME>生产商中文名</MANUF_REG_CNAME><COMBBATCH_NO>货物组批号</COMBBATCH_NO><GOODS_PROD_NO>生产批号</GOODS_PROD_NO><GOODS_NO>商品货号</GOODS_NO><MEASURE_TYPE_CODE>数重量单位类别</MEASURE_TYPE_CODE><LIMIT_RECORD><LIMIT_CODE>设限控制代码</LIMIT_CODE><REG_CODE>证书编号</REG_CODE><SEQ_NO>序号</SEQ_NO></LIMIT_RECORD><PACK_ADD_RECORD><MATERIAL_TYPE>材料种类</MATERIAL_TYPE><FACTORY>加工厂家</FACTORY><PACK_LONG>长</PACK_LONG><PACK_WIDE>宽</PACK_WIDE><PACK_HIGH>高</PACK_HIGH><MATTING_CODE>铺垫材料代码</MATTING_CODE><PACK_DICIMAL>辅包装件数</PACK_DICIMAL></PACK_ADD_RECORD></GOODS_RECORD>3.1.2.1.3 详细信息3.1.2.2 集装箱信息3.1.2.2.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>3.1.2.2.2 XML格式<DECL_CONTAINER><CONTAINER_MODEL_CODE>集装箱规格代码</CONTAINER_MODEL_CODE><CONTAINER_MODEL_NAME>集装箱规格名称</CONTAINER_MODEL_NAME><CONTAINER_QTY>集装箱数量</CONTAINER_QTY><CONTAINER_CODE>集装箱号码</CONTAINER_CODE><SEQ_NO>序号</SEQ_NO></DECL_CONTAINER>3.1.2.2.3 详细信息4 一般快件进口数据规范申报清单报文4.1.1 表头4.1.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>4.1.1.2 XML格式<BODYMASTER><ORDERNO>订单号</ORDERNO><CBECBILLNO>清单编码</CBECBILLNO><IEFLAG>进出口标识</IEFLAG><CROSS_ORDER_ID>跨境平台订单号</CROSS_ORDER_ID><REG_NO>申报单位注册号</REG_NO><REG_NAME>申报单位名称</REG_NAME><CARRIER_CODE>承运人代码</CARRIER_CODE><CARRIER_NAME>承运人名称</CARRIER_NAME><TRADE_CO >电商代码</TRADE_CO ><TRADE_CNAME>电商名称</TRADE_CNAME><APL_CODE>申报企业注册号</APL_CODE><APL_NAME>申报企业注册名称</APL_NAME><APL_LINKMAN>申报单位联系人</APL_LINKMAN><APL_TEL>联系电话</APL_TEL><CORP_ATTR>企业性质代码</CORP_ATTR><REG_ID>订购人身份证号</REG_ID><REC_NAME>收货人中文名</REC_NAME><REC_ENAME>收货人英文名</REC_ENAME><REC_TEL>收货人电话(个人)</REC_TEL><REC_CITY>收货地城市</REC_CITY><REC_PROVINCE>收货地省/州</REC_PROVINCE><REC_ADDRESS>收货人地址</REC_ADDRESS><APL_DATE>申报(检)日期</APL_DATE><CONSIGNOR_CN >发货人中文名</CONSIGNOR_CN ><CONSIGNOR_EN >发货人英文名</CONSIGNOR_EN ><SENDER_TEL>发货人电话</SENDER_TEL><SENDER_COUNTRY>发货人国家</SENDER_COUNTRY><SENDER_CITY>发货人城市</SENDER_CITY><SENDER_PROVINCE>发货人省/州名</SENDER_PROVINCE><TOTAL_PRICE >商品合计总价</TOTAL_PRICE ><CURRENCY>币种代码</CURRENCY><PARENT_BL_NO>主提单/运单号码</PARENT_BL_NO><BL_NO>提单/运单号码</BL_NO><CONVEY_DETAIL>航次号</CONVEY_DETAIL><ARRIVE_DATE>到货日期</ARRIVE_DATE><DEPART_AREA_CODE>启运国代码</DEPART_AREA_CODE><DEPART_PORT>起运口岸代码</DEPART_PORT><MID_PORT>经停口岸代码</MID_PORT><GOODS_PLACE>货物存放地点</GOODS_PLACE><IS_CONTAIN_GIFTS>是否包含赠品</IS_CONTAIN_GIFTS><CHECK_ORG_CODE>施检机构代码</CHECK_ORG_CODE><NOTE>备注说明</NOTE></BODYMASTER>4.1.1.3 详细信息4.1.2 表体4.1.2.1 商品信息4.1.2.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>4.1.2.1.2 XML格式<GOODS_RECORD><SERIAL_NO>序号</SERIAL_NO><GOODS_NO>商品货号</GOODSNO><GOODS_CN>货物中文名称</GOODS_CN><GOODS_EN>货物英文名称</GOODS_EN><HS_CODE>H.S.编码(税号)</HS_CODE><GOODS_MODEL>货物规格</GOODS_MODEL><GOODS_BRAND>货物品牌</GOODS_BRAND><ORI_AREA_CODE >原产国代码<ORI_AREA_CODE ><QUANTITY>数量</QUANTITY>< QUANTITY_UNIT_CODE >数量单位代码</ QUANTITY_UNIT_CODE ><WEIGHT>重量</WEIGHT><WEIGHT_UNIT_CODE>重量单位代码</WEIGHT_UNIT_CODE><PRICE>单价</PRICE><AMOUNT >金额(总价)</AMOUNT ><MONEY_UNIT >货币单位代码</MONEY_UNIT ><PACK_QUAN>包装数量</PACK_QUAN><PACK_KIND>包装类型代码</PACK_KIND><WASTE_FLAG>废旧物品标识</WASTE_FLAG><IS_CONTAIN_GIFTS>是否赠品</IS_CONTAIN_GIFTS></GOODS_RECORD>详细信息5 三单数据规范5.1订单信息报文5.1.1 表头5.1.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.1.2 XML格式<BODYMASTER><CUSTOMSCODE>主管海关代码</CUSTOMSCODE><BIZTYPE>业务类型</BIZTYPE><BIZTIME>业务时间</ BIZTIME><IEFLAG>进出口标示</IEFLAG><ECPCODE>电商平台海关注册码</ECPCODE><ECPNAME>电商平台名称</ECPNAME><CBECODE>跨境商户企业海关注册代码</ CBECODE><CBENAME>跨境商户企业名称</CBENAME><ORDERNO>订单编号</ORDERNO><CUSTOMER>客户姓名</CUSTOMER><CUSTOMERID>客户证件号码</CUSTOMERID><NOTE>备注</NOTE></BODYMASTER>5.1.1.3 详细信息5.1.2 表体5.1.2.1 商品信息列表5.1.2.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.1.2 XML格式<GOODSLIST><GOODSNO>商品货号</GOODSNO><GOODSNAME>商品名称</GOODSNAME><GOODSMODEL>商品规格类型</GOODSMODEL><BARCODE>商品条形码</ BARCODE><CODETS>海关10位商品编码</CODETS><COUNTRY>原产国</COUNTRY><CURRENCY>币制</ CURRENCY><UNIT>单位</UNIT><QUANTITY>数量</QUANTITY><PRICE>成交单价</PRICE><DISCOUNT>折扣浮动价格</DISCOUNT><FLAG>是否赠品</FLAG><TAXRATE>海关行邮税率</TAXRATE></GOODSLIST>5.1.2.1.3 详细信息(增加商品序号)5.1.2.2 订单费用节点5.1.2.2.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.2.2 XML格式<CHARGEDATA><CHARGE>总费用=商品货款+其他杂费+行邮税费</CHARGE><GOODSVALUE>商品货款</GOODSVALUE><OTHERVALUE>其他杂费=运费+保价费等</ OTHERVALUE><TAX>海关税费</TAX></CHARGEDATA>5.1.2.2.3 详细信息5.1.2.3 支付信息节点5.1.2.3.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.3.2 XML格式<PAYMENTDATA><PAYMENTCODE>支付企业代码,海关注册代码</PAYMENTCODE><PAYMENTNAME>支付企业名称</PAYMENTNAME><PAYMENTNO>支付交易号</PAYMENTNO></PAYMENTDATA>5.1.2.3.3 详细信息5.1.2.4 物流信息节点5.1.2.4.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.4.2 XML格式<LOGISTICSDATA><LOGISTICSCODE>物流企业代码,海关注册代码</LOGISTICSCODE><LOGISTICSNAME>物流企业名称</LOGISTICSNAME><LOGISTICSNO>物流电子运单号</LOGISTICSNO></LOGISTICSDATA>5.1.2.4.3 详细信息5.1.2.5 发货人信息节点5.1.2.5.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.5.2 XML格式<SHIPPERDATA><SHIPPER>发货人名称</SHIPPER><SHIPPERADDRESS>发货人地址</SHIPPERADDRESS><SHIPPERTELEPHONE>发货人电话</SHIPPERTELEPHONE><SHIPPERCOUNTRY>发货人所在国家(地区)代码</ SHIPPERCOUNTRY> </SHIPPERDATA>5.1.2.5.3 详细信息5.1.2.6 收货人信息节点5.1.2.6.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.2.6.2 XML格式<CONSIGNEEDATA><CONSIGNEE>收货人名称</CONSIGNEE><CONSIGNEEADDRESS>收货人地址</CONSIGNEEADDRESS><CONSIGNEETELEPHONE>收货人电话</CONSIGNEETELEPHONE><CONSIGNEECOUNTRY>收货人所在国家(地区)代码</ CONSIGNEECOUNTRY> </CONSIGNEEDATA>5.1.2.6.3 详细信息5.2支付信息报文5.1.3 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.4 XML格式<BODYMASTER><CUSTOMSCODE>主管海关代码</CUSTOMSCODE><BIZTYPE>业务类型</BIZTYPE>-<BIZTIME>业务时间</ BIZTIME><ORDERNO>订单编号</ORDERNO><PAYMENTCODE>支付企业代码,平台注册代码</PAYMENTCODE><PAYMENTNAME>支付企业名称</ PAYMENTNAME><PAYMENTNO>支付交易号</PAYMENTNO><CURRENCY>币制</CURRENCY><CHARGE>支付总费用</ CHARGE><GOODSVALUE>商品货款</GOODSVALUE><OTHERVALUE>其他杂费</OTHERVALUE><TAX>海关税费</TAX></BODYMASTER>5.1.5 详细信息5.3运单信息报文5.1.6 表头5.1.6.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.6.2 XML格式<BODYMASTER><CUSTOMSCODE>主管海关代码</CUSTOMSCODE><BIZTYPE>业务类型</BIZTYPE><BIZTIME>业务时间</BIZTIME><ORDERNO>订单编号</ORDERNO><LOGISTICSCODE>物流企业代码,平台注册代码</LOGISTICSCODE><LOGISTICSNAME>物流企业名称</LOGISTICSNAME><LOGISTICSNO>物流电子运单号</LOGISTICSNO></BODYMASTER>5.1.6.3 详细信息5.1.7 表体5.1.7.1 投递信息节点5.1.7.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.7.1.2 XML格式<DELIVERYDATA><FREIGHT>运费</FREIGHT><INSUREDFEES>保价费</INSUREDFEES><WEIGHT>毛重</WEIGHT><QUANTITY>商品数量(件数)</QUANTITY><TRAFNAME>运输工具名称</TRAFNAME><DESTPORTCODE>指运港代码</DESTPORTCODE><GOODSINFO>商品简要信息</GOODSINFO></DELIVERYDATA>5.1.7.1.3 详细信息5.1.7.2 发货人信息节点5.1.7.2.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.7.2.2 XML格式<SHIPPERDATA><SHIPPER>发货人名称</SHIPPER><SHIPPERADDRESS>发货人地址</SHIPPERADDRESS><SHIPPERTELEPHONE>发货人电话</SHIPPERTELEPHONE><SHIPPERCOUNTRY>发货人所在国家(地区)代码</SHIPPERCOUNTRY> </SHIPPERDATA>5.1.7.2.3 详细信息5.1.7.3 收货人信息节点5.1.7.3.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.7.3.2 XML格式<CONSIGNEEDATA><CONSIGNEE>收货人名称</CONSIGNEE><CONSIGNEEADDRESS>收货人地址</CONSIGNEEADDRESS><CONSIGNEETELEPHONE>收货人电话</CONSIGNEETELEPHONE><CONSIGNEECOUNTRY>收货人所在国家(地区)代码</CONSIGNEECOUNTRY> </CONSIGNEEDATA>5.1.7.3.3 详细信息5.4物流状态信息报文5.1.8 表头5.1.8.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>5.1.8.2 XML格式<BODYMASTER><COMPANYCODE>物流企业编码</COMPANYCODE><COMPANYNAME>物流企业名称</COMPANYNAME><LOGISTICSNO>物流运单号</LOGISTICSNO><LOGISSTATE>物流跟踪状态</LOGISSTATE><WEIGHT>重量(kg)</WEIGHT><PACKAGENO>件数</PACKAGENO><OPERATRIONTIME>操作时间</OPERATRIONTIME><CUSTOMSPLACE>场站代码</CUSTOMSOPLACE></BODYMASTER>5.1.8.3 详细信息6 商品备案业务数据规范6.1商品备案报文6.1.1 表头6.1.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>6.1.1.2 XML格式<BODYMASTER><REG_NO>申报单位注册号</REG_NO><REG_NAME>申报单位名称</REG_NAME><TRADE_CO>电商企业编码</TRADE_CO><TRADE_CNAME>电商企业名称</TRADE_CNAME><APL_CODE>申报企业代码</APL_CODE><APL_NAME>申报企业名称</APL_NAME><APL_DATE>申报日期</APL_DATE><IEFLAG>进出口标识</IE_FLAG><REMARK>备注</REMARK><SPECIAL_CLAUSE>特殊条款</SPECIAL_CLAUSE></BODYMASTER>6.1.1.3 详细信息6.1.2 表体6.1.2.1 商品信息6.1.2.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>6.1.2.1.2 XML格式<GOODS_RECORD><HS_CODE>海关10位商品编码</HS_CODE><GOODS_NO>预售商品货号</GOODS_NO><GOODS_NAME>上架品名</GOODS_NAME><GOODS_MODEL>规格型号</GOODS_MODEL><GOODS_BRAND>品牌</GOODS_BRAND><MEASUREUNIT>计量单位</MEASUREUNIT><RECORD_PRICE>备案价格</RECORD _PRICE><CURRENCY>币种代码</CURRENCY><ISINCLUDE_GIFT>是否赠品</ISINCLUDE_GIFT><LICENCE_IMG>有效证件(图片)</LICENCE_IMG><LICENCE_NO>有效证件号</LICENCE_NO><COUNTRY>生产国家和地区编码</COUNTRY><GOODS_SUPPLIER>供应商</GOODS_SUPPLIER><CERTIFICATIONQUALIFICARION>商品或生产企业取得的认证、注册、备案等资质</CERTIFICATIONQUALIFICARION><THIRDPARTYCERTIFICATIONQUALIFICARION>商品或生产企业取得的认证、注册、备案等资质</THIRDPARTYCERTIFICATIONQUALIFICARION><GOOSDESCRIPTIONCN>产品说明的中文对照资料</GOOSDESCRIPTIONCN><CONSUMERWARNING>消费警示</CONSUMERWARNING><OTHERPROOFMATERIAL>其他可提供的证明材料</OTHERPROOFMATERIAL></GOODS_RECORD>6.1.2.1.3 详细信息7 系统回执7.1 回执报文7.1.1 报文结构报文结构采用XML标准设计,<xml version=“1.0” encoding=“UTF-8”>7.1.2 XML格式<BODYMASTER><MESSAGEID>报文编号</MESSAGEID><MESSAGETYPE>报文类型</MESSAGETYPE><CHKFLAG>状态标示</CHKFLAG><CHKMARK>状态说明</CHKMARK><NOTICEDATE>业务时间</NOTICEDATE><CBECBILLNO>清单编号</CBECBILLNO ></BODYMASTER>7.1.3 详细信息7.2出口快件业务状态标识7.3入境快件业务状态标识7.4商品备案业务状态标识8 报文类型对照。

快件信息跟踪查询规范

快件信息跟踪查询规范

快件寄递状态分类与代码(工作组讨论稿)编制说明2016年5月一、任务来源为了规范快件的寄递状态分类与代码,促进行业的健康发展,国家邮政局于2015年9月立项开展快件寄递状态分类与代码规范(以下简称“本规范”)的编制工作。

二、目的和意义近年来,随着经济社会的快速发展,电子商务的迅速崛起,人们生活水平的不断提高,我国快递业进入了一个高速发展时期。

快递业作为国民经济中的重要服务行业,在人们日常工作和生活中扮演着越来越重要的角色,快递行业成为关系国计民生的重要行业。

快件历经收寄、分拣、运输、投递多个环节才能最终到达用户手中,此过程需要多个部门的协作配合,部门之间数据交换需求旺盛。

准确及时的描述快件实际运递信息,每个快件都做到可查询,可追溯,不论对于最终用户还是对于快递企业都具有非常重要的意义。

目前对于快件的寄递状态没有统一的标准,《快件寄递状态分类与代码》标准的制定,有利于加强快件寄递全流程的管理,有利于维护快件寄递市场秩序,有利于各个企业之间信息的交换,有利于邮政监管部门对于快递企业进行动态管理;有利于电子数据交换标准接口的制定,有利于实现邮政业与交通、电子商务、制造业等关联产业的联动发展。

三、目标和主要内容本项目旨在深入了解个快递企业的快件寄递处理流程的基础上,了解邮快件寄递状态信息。

对寄递状态信息进行归类,梳理分析行业内外对于寄递状态信息的使用现状和应用需求,结合已有标准中对于寄递状态信息的相关规定,对快件寄递状态进行分类,对分类信息进行科学编码,形成邮政行业的快件寄递状态分类与代码规范。

为推进行业信息化建设、实现科学化管理提供支撑,推进行业内外的互连互通,促进行业的长期健康发展。

四、规范编制原则1.严格遵照邮件和快件服务相关的法律法规、规章标准邮件和快递服务相关的法律法规、国家标准、行业标准以及部门规章等都是本标准编制的重要参考基础,本标准内容须与行业相关标准保持协调一致。

因此,在本规范编制过程中,项目组对邮件和快递服务相关的法律法规、规章标准进行了深入研究。

国家邮政局关于印发《邮件快件包装操作规范备案管理规定(试行)》的通知-国邮发〔2022〕12号

国家邮政局关于印发《邮件快件包装操作规范备案管理规定(试行)》的通知-国邮发〔2022〕12号

国家邮政局关于印发《邮件快件包装操作规范备案管理规定(试行)》的通知正文:----------------------------------------------------------------------------------------------------------------------------------------------------国家邮政局关于印发《邮件快件包装操作规范备案管理规定(试行)》的通知国邮发〔2022〕12号各省、自治区、直辖市邮政管理局,中国邮政集团有限公司,各快递企业总部:为规范邮件快件包装操作规范备案管理工作,加强邮件快件包装操作规范化建设,推进邮件快件包装减量化、标准化和循环化,根据《邮件快件包装管理办法》,国家邮政局制定了《邮件快件包装操作规范备案管理规定(试行)》,现印发给你们,请遵照执行。

国家邮政局2022年3月3日邮件快件包装操作规范备案管理规定(试行)第一条为规范邮件快件包装操作规范备案管理工作,加强邮件快件包装操作规范化建设,推进邮件快件包装减量化、标准化和循环化,根据《邮件快件包装管理办法》制定本规定。

第二条本规定适用于邮政企业、快递企业、经营邮政通信业务的企业(以下统称寄递企业)制修订邮件快件包装操作规范、备案及相应的监督管理。

第三条国务院邮政管理部门和省、自治区、直辖市邮政管理机构以及按照国务院规定设立的省级以下邮政管理机构(以下统称邮政管理部门)负责邮件快件包装操作规范备案的监督管理工作。

第四条跨省、自治区、直辖市经营的寄递企业总部企业,向国家邮政局备案本企业的邮件快件包装操作规范。

跨省经营的品牌寄递企业在省、自治区、直辖市的区域管理机构和省内经营的寄递企业,按照所在地省、自治区、直辖市邮政管理局要求报送备案。

第五条邮件快件包装操作规范备案坚持公平、公开、公正和高效、便利的原则。

第六条邮政管理部门可以组织寄递企业、行业组织、社会环保组织、科研院所等专家,组建邮政业生态环保专家组,为邮件快件包装操作规范备案审查提供专业支持。

中国邮政中邮小包提交物流信息V6-1

中国邮政中邮小包提交物流信息V6-1

S03 S04 S05 S06 S12 S14 S15
非法的物流公司/仓储公司 非法的通知类型(version 版本信息不正确) 非法的消息类型 系统异常,请重试 非法的电商标识 非法特殊字符,如+号等 非法寄达国编码
3.2 标识 B00 B01 B02 B03 B05 B06 B07 B08 B98
的参数都是通过 URL 编码传送的, 符合 HTTP 协议, 注意客户端是否解码正确, 有些控件已经自带 URL 解码功能,请开发人员注意。
2.3
数据发送和接收处理流程
数据发送流程(即电商发送):压缩(可选) BASE64 编码(可选)数字
签名发送;
数据接收流程(即电商接收):接收数字签名校验 BASE64 解码(可选) 解压(可选)处理;
标准返回报文......................................................................................................... 6 2.1 2.2 系统错误码............................................................................................... 6 业务错误码............................................................................................... 7
logisticsEventsRequest logisticsEvent eventHea der eventType
实体对象
请求报头 事件体 事件类型(事件描述) 事 件 【 LOGISTICS_BATCH_S 基 END】 :批次 础 信 事件发生时间 息 【发送报文的系统时间】 体 yyyy-MM-ddHH:mm:ss 事件源【电商平台】 事件接收方【CPG】 内件名称(中文)

中国移动数据业务实时计费接口规范-v100集采版

中国移动数据业务实时计费接口规范-v100集采版

中国移动通信企业标准QB-╳╳-╳╳╳-╳╳╳╳中国移动数据业务实时计费接口规范C h i n a M o b i l e O n l i n e C h a r g i n gI n t e r f a c e S p e c i f i c a t i o n f o r D a t aS e r v i c e版本号:1.0.0╳╳╳╳-╳╳-╳╳发布╳╳╳╳-╳╳-╳╳实施目录前言................................................................... III1.范围 (1)2.规范性引用文件 (1)3.术语、定义和缩略语 (2)4.数据业务实时计费方案 (3)4.1.方案概述 (3)4.2.Charging Characteristics字段 (5)4.3.数据业务实时计费漫游地解决方案 (6)5.实时计费流程 (6)5.1.流量计费类业务实时计费流程 (9)5.1.1.非内容计费类业务实时计费流程 (9)5.1.2.内容计费类业务实时计费流程 (11)5.2.时长计费类业务实时计费流程 (15)5.3.费率改变控制流程 (18)5.4.余额不足控制流程 (19)5.4.1.用户上线过程中发现余额不足 (19)5.4.2.用户使用数据业务过程中发现余额不足 (20)5.4.3.BOSS通过FUA指示重定向 (22)5.5.用户充值成功业务放通流程(可选) (24)5.6.HLR/HSS与BOSS中用户计费方式不一致流程(转离线计费) (25)5.7.用户不存在控制流程 (25)5.8.禁止用户使用业务流程 (26)5.9.条件改变触发上报控制流程 (27)5.9.1.SGSN/S-GW的IP地址改变 (27)5.9.2.PDP上下文/EPS承载的QOS改变 (28)5.9.3.无线接入技术改变 (29)5.10.异常流程 (30)5.11.PCC引入后实时计费流程 (32)5.12.其他流程 (34)6.DCCA协议定义 (35)6.1.协议结构 (35)6.2.协议格式 (35)6.2.1.消息头格式 (35)6.2.2.AVP头格式 (37)6.2.3.AVP数据格式 (38)6.3.消息列表 (40)7.Diameter协议命令集 (41)R/CCA (41)R (41)A (52)7.2.RAR/RAA (60)7.2.1.RAR (60)7.2.2.RAA (62)7.3.ASR/ASA (63)7.3.1.ASR (63)7.3.2.ASA (64)7.4.CER/CEA (65)7.4.1.CER (65)7.4.2.CEA (65)7.5.DWR/DWA (66)7.5.1.DWR (66)7.5.2.DWA (66)7.6.DPR/DPA (67)7.6.1.DPR (67)7.6.2.DPA (67)8.接口消息定义 (67)8.1.Service-Information参数定义 (67)R消息中的PS-Information参数定义 (67)A消息中的PS-Information参数定义 (72)8.2.Origin-Host参数定义 (73)8.2.1.网络侧Origin-Host参数定义 (73)8.2.2.BOSS侧Origin-Host参数定义 (73)8.3.AVP定义说明 (74)R消息中的AVP定义说明 (75)A消息中的AVP定义说明 (76)8.4.AVP Flag置位说明 (77)8.4.1.IETF 定义的AVP Flag置位说明 (77)8.4.2.3GPP定义的AVP Flag置位说明 (78)8.5.Result-Code定义说明 (80)8.5.1.Result-Code参数定义说明 (80)8.5.2.Result-Code场景举例 (86)8.6.PS-Free-Format-Data取值说明 (86)8.7.Service-Context-Id编码说明 (87)8.7.1.网络侧Service-Context-Id编码说明 (87)8.7.2.BOSS侧Service-Context-Id编码说明 (87)9.网络侧设备功能要求 (88)9.1.GGSN、PGW功能要求 (88)9.2.其他网元改造要求 (89)10.接口要求 (89)10.1.协议接口要求 (89)10.2.Diameter路由管理要求 (89)10.3.物理接口要求 (90)10.4.接口性能要求 (90)11.编制历史 (90)前言本标准依据3GPP等国际标准规范,结合中国移动其他企业标准,基于中国移动数据业务实时计费的实际需求,对GGSN、P-GW设备与业务支撑系统之间的实时计费接口提出规定,供中国移动内部和厂商共同使用,为设备引进、设备互通、网络规划、工程建设、运行维护及设备开发方面提供技术依据。

快递公司单号查询接口编码说明

快递公司单号查询接口编码说明

快递公司编码说明以下是快递鸟API接口对外开放的部分快递公司编码的列表,接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。

如:EMS物流单号应选择快递公司编码(EMS)、德邦物流单号应选择快递公司编码(DBL)、天天快递物流单号应选择快递公司编码(HHTT)、圆通速递物流单号应选择快递公司编码(YTO)、中通速递快递物流单号应选择快递公司编码(ZTO)、亚马逊物流单号应选择快递公司编码(AMAZON)、顺丰物流单号应选择快递公司编码(SF)、百世快运物流单号应选择快递公司编码(BTWL)、宅急送物流单号应选择快递公司编码(ZJS)。

适用于即时查询API接口和订阅推送API接口。

如果在下面没有找到您所要的快递公司,请添加在群共享文件下载。

国内快递查询接口编码国际快递查询接口转运查询接口快递查询接口应用场景查询订单的物流信息可实现需求1.App中直接集成实现快递物流信息查询Api接口2.在微信公众号中,根据用户输入的订单号,我们的后台识别订单号并根据快递鸟查询快递Api接口,实现自动查询的功能3.等等申请Key按照你的信息,依次把信息填写完整,点击提交申请即可。

登录成功后,就可以看到ID和key等信息,有这些信息就可以请求查询等其他的接口Api快递查询Api接口接口文档及各开发语言Demo查询Api接口定义系统级输入参数参数名称类型必须要求说明RequestData String R 请求内容,JSON或XML格式,须和DataType一致EBusinessID String R 用户IDRequestType String R 请求指令类型:1002DataSign String R 数据内容签名DataType String O 请求、返回数据类型:1-xml,2-json;默认为xml格式应用级输入参数参数名称类型必须要求说明OrderCode varchar(50) O 订单编号ShipperCode varchar(10) R 快递公司编码LogisticCode varchar(50) R 物流单号返回结果参数参数名称类型必须要求说明EBusinessID Int R 电商用户IDOrderCode Varchar(50) O 订单编号ShipperCode varchar(10) R 快递公司编码LogisticCode Varchar(50) R 物流运单号Success Bool R 成功与否Reason Varchar(50) O 失败原因State Int R 物流状态1:已取件2:在途中3:签收Traces Varchar(Max) R 物流轨迹详情物流轨迹详情参数名称类型必须要求说明AcceptTime DateTime R 时间AcceptStation Varchar(50) R 描述Remark Varchar(150) O 备注请求JSON参数{"OrderCode" : "","ShipperCode" : "SF","LogisticCode" :}响应JSON参数{"EBusinessID" : "1109259","OrderCode" : "","ShipperCode" : "SF","LogisticCode" : ,"Success" : true,"State" : 3,"Reason" : null,"traces" : [{"AcceptTime" : "2014/06/25 08:05:37","AcceptStation" : "正在派件..(派件人:邓裕富,电话深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 04:01:28","AcceptStation" : "快件在深圳集散中心 ,准备送往下一站深圳 [深圳市]", "Remark" : null}, {"AcceptTime" : "2014/06/25 01:41:06","AcceptStation" : "快件在深圳集散中心 [深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:18:58","AcceptStation" : "已收件[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:55:28","AcceptStation" : "快件在深圳 ,准备送往下一站深圳集散中心 [深圳市]", "Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "派件已签收[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "签收人是:已签收[深圳市]","Remark" : null}]}查询Api接口使用以Java开发语言为例,进行展开importimportimportimportimportimportimportimportimportimportimport/**** 快递鸟物流轨迹即时查询接口** @技术QQ群* @see* @copyright: 深圳市快金数据技术服务有限公司** DEMO中的电商ID与私钥仅限测试使用,正式环境请单独注册账号* 单日超过500单查询量,建议接入我方物流轨迹订阅推送接口** ID和Key请到官网申请:*/public class KdniaoTrackQueryAPI {//DEMOpublic static void main(String[] args) {KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();try {String result = api.getOrderTracesByJson("ANE", );} catch (Exception e) {e.printStackTrace();}}//电商IDprivate String EBusinessID="请到快递鸟官网申请;//电商加密私钥,快递鸟提供,注意保管,不要泄漏private String AppKey="请到快递鸟官网申请;//请求urlprivate String ReqURL=;/*** Json方式查询订单物流轨迹* @throws Exception*/public String getOrderTracesByJson(String expCode, String expNo) throws Excepti on{String requestData= "{'OrderCode':'','ShipperCode':'" + expCode + "','Logis ticCode':'" + expNo + "'}";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "1002");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "2");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** XML方式查询订单物流轨迹* @throws Exception*/public String getOrderTracesByXml() throws Exception{String requestData= "<?xml version=\"1.0\" encoding=\"utf-8\" ?>"+"<Content>"+"<OrderCode></OrderCode>"+"<ShipperCode>SF</ShipperCode>"++"</Content>";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "1002");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "1");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** MD5加密* @param str 内容* @param charset 编码方式* @throws Exception*/@SuppressWarnings("unused")private String MD5(String str, String charset) throws Exception { MessageDigest md = MessageDigest.getInstance("MD5");md.update(str.getBytes(charset));byte[] result = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i < result.length; i++) {int val = result[i] & 0xff;if (val <= 0xf) {sb.append("0");}sb.append(Integer.toHexString(val));}return sb.toString().toLowerCase();}/*** base64编码* @param str 内容* @param charset 编码方式* @throws UnsupportedEncodingException*/private String base64(String str, String charset) throws UnsupportedEncodingExc eption{String encoded = base64Encode(str.getBytes(charset));return encoded;}@SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodin gException{String result = URLEncoder.encode(str, charset);return result;}/*** 电商Sign签名生成* @param content 内容* @param keyValue Appkey* @param charset 编码方式* @throws UnsupportedEncodingException ,Exception* @return DataSign签名*/@SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception{if (keyValue != null){return base64(MD5(content + keyValue, charset), charset);}return base64(MD5(content, charset), charset);}/*** 向指定 URL 发送POST方法的请求* @param url 发送请求的 URL* @param params 请求的参数集合* @return远程资源的响应结果*/@SuppressWarnings("unused")private String sendPost(String url, Map<String, String> params) {OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try {URL realUrl = new URL(url);HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();// 发送POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);// POST方法conn.setRequestMethod("POST");// 设置通用的请求属性conn.setRequestProperty("accept", "*/*");conn.setRequestProperty("connection", "Keep-Alive");conn.setRequestProperty("user-agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");conn.setRequestProperty("Content-Type", "application/x-www-form-urlenco ded");conn.connect();// 获取URLConnection对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");if (params != null) {StringBuilder param = new StringBuilder();for (Map.Entry<String, String> entry : params.entrySet()) {if(param.length()>0){param.append("&");}param.append(entry.getKey());param.append("=");param.append(entry.getValue());}out.write(param.toString());}// flush输出流的缓冲out.flush();// 定义BufferedReader输入流来读取URL的响应in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8")); String line;while ((line = in.readLine()) != null) {result.append(line);}} catch (Exception e) {e.printStackTrace();}//使用finally块来关闭输出流、输入流finally{try{if(out!=null){out.close();}if(in!=null){in.close();}catch(IOException ex){ex.printStackTrace();}}return result.toString();}private static char[] base64EncodeChars = new char[] { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H','I', 'J', 'K', 'L', 'M', 'N', 'O', 'P','Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X','Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f','g', 'h', 'i', 'j', 'k', 'l', 'm', 'n','o', 'p', 'q', 'r', 's', 't', 'u', 'v','w', 'x', 'y', 'z', '0', '1', '2', '3','4', '5', '6', '7', '8', '9', '+', '/' };public static String base64Encode(byte[] data) {StringBuffer sb = new StringBuffer();int len = data.length;int i = 0;int b1, b2, b3;while (i < len) {b1 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b1 & 0x3) << 4]); sb.append("==");break;}b2 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);sb.append("=");break;}b3 = data[i++] & 0xff;sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]); sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]); sb.append(base64EncodeChars[b3 & 0x3f]);}return sb.toString();}}其他Api接口,请转到快递鸟具体查看相关文档。

(技术规范标准)PONEMS北向接口功能及技术规范

(技术规范标准)PONEMS北向接口功能及技术规范

- 1 -中国电信PON EMS北向接口功能及技术规范(V1.0)2010年12月- 2 -前言本标准主要参照相关国际标准、国内行业标准、企业标准,现有的PON设备、PON EMS及PON EMS 北向接口技术资料,结合PON EMS与OSS系统对接的实际情况和具体要求编制而成。

本标准主要用于规范PON EMS与OSS系统间的北向接口功能、参数、协议及对相关系统的技术要求等内容。

本标准包括四部分:(1)PON EMS北向接口功能及技术规范——业务开通分册(2)PON EMS北向接口功能及技术规范——综合测试分册(3)PON EMS北向接口功能及技术规范——综合告警分册(4)PON EMS北向接口功能及技术规范——综合信息查询分册本标准由中国电信集团公司组织制定。

本标准包含中国电信的专利等知识产权,相关厂商需经中国电信授权方可使用本标准。

本标准起草单位:中国电信北京研究院- 3 -目录1范围..................................................................... - 5 -2规范性引用文件........................................................... - 5 -3术语、定义和缩略语....................................................... - 5 -3.1术语和定义.................................................................................................................. - 5 -3.2缩略语.......................................................................................................................... - 6 - 4接口规范概述............................................................. - 8 -4.1业务开通接口规范(I1接口).................................................................................. - 9 -4.2综合告警接口规范(I2接口).................................................................................. - 9 -4.3综合测试接口规范(I3接口).................................................................................. - 9 -4.4综合信息查询接口规范(I5接口)........................................................................ - 10 - - 4 -1范围本标准规定了PON EMS与OSS系统之间的北向接口功能要求、接口参数、接口协议、对相关系统的技术要求等内容,本标准适用于PON网络网管系统(EMS),用于指导PON EMS与OSS系统北向接口的设计、开发和测试。

中央业务平台数据下发接口规范(doc 29页)

中央业务平台数据下发接口规范(doc 29页)

中央业务平台数据下发接口规范(doc 29页)中国移动一级经营分析系统中央业务平台数据下发接口规范飞信分册V1.0中国移动通信有限公司2007年07月文档变更记录序号变更内容说明版本号修订日期生效日期1 文档建立 1.0 2007-07-032007年7月目录1总则 (1)1.1背景 (1)1.2目的 (1)1.3适用范围 (1)1.4起草单位 (1)1.5解释权 (1)1.6参考文档 (1)1.7缩略语 (2)1.8约定 (2)2接口说明 (5)2.1接口双方责任 (5)2.1.1源数据提供方的责任 (5)2.1.2数据接收方的责任 (5)2.2接口文件命名规则 (5)2.2.1中央业务平台列表 (5)2.2.2接口单元编码规则 (6)2.2.3文件分类及命名规则 (6)2.2.4文件命名说明 (9)2.3接口文件设计 (10)2.3.1设计原则 (10)2.3.2接口文件格式 (11)2.4数据质量保障 (12)2.4.1数据转换规则 (12)2.4.2文件级校验 (14)2.4.3数据异常处理机制 (15)2.4.4系统及时性要求 (15)2.5文件目录及维护 (15)2.5.1文件目录的划分 (15)2.6文件的保存期 (17)3接口数据 (18)3.1数据接口 (18)3.1.1日活跃用户明细 (19)3.1.2月活跃用户明细 (22)3.1.3日用户开通/关闭操作记录 (24)3.1.4飞信用户登录信息 (27)3.1.5飞信用户好友明细 (31)3.2字典接口 (33)3.2.1飞信字典定义 (34)3.2.2飞信字典代码定义 (36)4附录:省份编码 (38)1总则1.1背景为方便各省经营分析系统共享和利用各中央业务平台产生的大量信息资源,为各省公司的市场经营、决策管理提供及时、准确、科学的数据和应用支撑,特制定本规范。

1.2目的➢制订全国统一的接口规范,由一级经营分析系统将中央业务平台相关数据分发各省经营分析系统;➢各省经营分析系统根据此接口规范获取中央业务平台数据,并依据规定的数据格式入库存储,开展后续应用分析。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 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 消息格式请求和响应的消息格式将全部是XML2.2 安全及数据完整性1、以HTTP POST方式发送,请求方法的编码格式:“application/x-; charset=GBK”;2、用“logistics_interface”字段表示要发送的XML内容;3、用“data_digest”字段进行签名验证。

签名使用MD5方式,对logistics_interface的内容进行签名。

原理为:通知内容xml+parternID,然后进行MD5,转换为Base64字符串。

详细解释如下:◆假设xml内容为: <RequestOrder></RequestOrder>, partnered为123456◆那么要签名的内容为<RequestOrder></RequestOrder>123456,经过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◆最终要发送的数据为: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格式:<RequestOrder><!—订单基本信息--><ecCompanyId >TAOBAO</ecCompanyId><logisticProviderID>POSTB</logisticProviderID><customerId>a92266073246b3ed2a2f0ff4d0b2bf5e</customerId> <txLogisticID>LP709</txLogisticID><tradeNo>25709</tradeNo><mailNo>124579546621</mailNo><totalServiceFee>3200</totalServiceFee><codSplitFee>2000</codSplitFee><buyServiceFee>1000</buyServiceFee><orderType>1</orderType><serviceType>0</serviceType><!—发货方信息--><sender><name>张三</name><postCode>310013</postCode><phone>231234134</phone><mobile></mobile><prov>浙江</prov><city>杭州,西湖区</city><address>华星科技大厦9层</address></sender><!--收货方信息--><receiver><name>李四</name><postCode>100000</postCode><phone>231234134</phone><mobile></mobile><prov>北京</prov><city>北京市</city><address>华星科技大厦9层</address></receiver><!--物流公司上门取货时间段--><sendStartTime>2005-08-24 08:00:00</sendStartTime> <sendEndTime>2005-08-24 12:00:00 </sendEndTime><!--商品信息--><goodsValue>1900</goodsValue><items><item><itemName>Nokia N73</itemName><number>2</number><itemValue>2</itemValue></item><item><itemName>Nokia N72</itemName><number>1</number><itemValue>2</itemValue></item></items><special>0</special><remark>易碎品</remark>< weight>10</ weight ></RequestOrder>3.1.3参数描述订单创建信息由电商物流平台发送给中国邮政,电商物流平台以HTTP POST方式发送消息,参数格式如下:参数名称用途logistics_interface 4.1.2节描述的XML字符串data_digest logistics_interface的MD5签名msg_type 固定“ORDERCREATE” (不区分大小写) ecCompanyId 固定为“TAOBAO”(不区分大小写)3.1.4返回格式返回标准的系统交互格式,详情见《4系统交互处理流程》3.1.5补充信息1、物流订单号在上游客户系统中要具有唯一性2、卖家发货后,电商物流平台实时发送订单到邮政物流公司,这是系统交互,跟后面的业务处理是分开的;3.2订单信息更新接口3.2.1字段含义注:可以同时更新多笔订单,但最多不超过20个;status字段可选值:3.2.2请求格式XML格式:<UpdateInfo><logisticProviderID>POSTB</logisticProviderID><ecCompanyId>TAOBAO</ecCompanyId><fieldList><field><txLogisticID> LP709</txLogisticID> <fieldName>mailNo</fieldName><fieldValue>32323232</fieldValue><remark></remark></field><field><txLogisticID>LP709</txLogisticID><fieldName>weight</fieldName><fieldValue>10</fieldValue><remark></remark></field><field><txLogisticID>LP709</txLogisticID><fieldName> status</fieldName><fieldValue> ACCEPT </fieldValue><remark></remark></field><field><txLogisticID>LR123</txLogisticID><fieldName>status</fieldName><fieldValue>WITHDRAW</fieldValue><remark>没货</remark></field><field><txLogisticID>LR456</txLogisticID><fieldName>status</fieldName><fieldValue>ACCEPT</fieldValue></field><field><txLogisticID>LR456</txLogisticID> <fieldName>mailNo</fieldName><fieldValue>45875213</fieldValue><remark></remark></field><field><txLogisticID>LR719</txLogisticID> <fieldName>status</fieldName><fieldValue>UNACCEPT</fieldValue><remark>B04</remark></field><field><txLogisticID>LR529</txLogisticID> <fieldName>status</fieldName><fieldValue>NOT_SEND</fieldValue><remark>不送了</remark></field><field><txLogisticID>LP542</txLogisticID> <fieldName>status</fieldName><fieldValue>ACCEPT</fieldValue><remark> </remark></field><field><txLogisticID>LP289</txLogisticID> <fieldName>mailNo</fieldName><fieldValue>87561245</fieldValue></field></fieldList></UpdateInfo>注:1、面单号更新,可以是电商物流平台发送给邮政物流公司,也可以是邮政物流公司发送给电商物流平台。

相关文档
最新文档