搜索
EMS自助服务系统和大客户接口规范变更历史日期变更描述版本号变更人批准2013-03-18创建文档V0.9王一松1总体说明1.1接口目的本文包含了相关接口的数据格式、通讯格式。本文附录包含了接口使用的基础代码信息。该文档约束了中国邮政速递物流EMS自助服务系统和大客户的接口规范，文档内容需严格保密。1.2接口规范EMS自助服务系统和大客户接口建议采用http接口方式，同时支持webservice接口方式；http接口编码格式均为UTF-8格式。为保证单号正常获取，不影响用户使用。需在当天将打印后的数据更新到EMS自助服务系统（接口2.2）。2EMS自助服务客户端和大客户接口规范2.1根据大客户号、业务类型获取详情单号接口功能描述通过大客户号，业务类型获取详情单号服务端EMS自助服务系统客户端大客户系统接口方式HTTP接口地址=getBillNumBySys&xml=输入参数大客户号、密码、业务种类、获取数量输入参数格式定义使用BASE64加密输入参数！！！特别注意：单号是唯一的，获取后本地保存时必须作为唯一索引。！！！XML标记串：?xmlversion=1.0encoding=UTF-8?XMLInfosysAccount/sysAccount//大客户号，必填，代码调试期间请务必传入大客户号：A1234567890ZpassWord/passWord//大客户密码，必填，小写md5加密，e10adc3949ba59abbe56e057f20f883eappKey/appKey//对接方平台id，作为接口调用方的身份凭据，由接口提供方提供businessType/businessType//业务类型，必填，1为标准快递，4为经济快递（传数字）billNoAmount/billNoAmount需要详情单数量，最多输入100个/XMLInfo返回值格式定义使用BASE64加密返回值XML标记串：?xmlversion=1.0encoding=UTF-8?responseresult/result//是否执行成功，1是成功，0是失败errorDesc/errorDesc//错误原因描述assignIdsassignIdbillno/billno//详情单号/assignIdassignId....../assignId..........assignIds/response参考方法名getBillNoBySys(xml)Webservice_path实现类EmsPrintService备注2.2详情单打印信息更新到EMS自助服务系统接口功能描述将详情单打印信息更新到自助服务系统服务端EMS自助服务系统客户端大客户系统接口方式HTTP接口地址=updatePrintDatas&xml=输入参数大客户号、打印类型将详情单信息按照xml格式封装成一个字符串传入系统进行数据更新输入参数格式定义使用BASE64加密输入参数XML标记串：?xmlversion=1.0encoding=UTF-8?XMLInfosysAccount/sysAccount//大客户号，必填passWord/passWord//大客户密码，必填，小写md5加密，e10adc3949ba59abbe56e057f20f883eappKey/appKey//对接方平台id，作为接口调用方的身份凭据，由接口提供方提供printKind/printKind//打印类型，1为五联单打印，2为热敏打印，必填printDatasprintDatabigAccountDataId/bigAccountDataId//大客户数据的唯一标识，如某电商公司的配货单号，必填(订单如果打印条码,应为非13位数字)billno/billno//详情单号，和配货单号对应，必填（详情单号打印条形码必须128码）scontactor/scontactor//寄件人姓名scustMobile/scustMobile//寄件人联系方式1scustTelplus/scustTelplus//寄件人联系方式2(选填)scustPost/scustPost//寄件人邮编scustAddr/scustAddr//寄件人地址scustComp/scustComp//寄件人公司tcontactor/tcontactor//收件人姓名tcustMobile/tcustMobile//收件人联系方式1tcustTelplus/tcustTelplus//收件人联系方式2(选填)tcustPost/tcustPost//收件人邮编tcustAddr/tcustAddr//收件人地址tcustComp/tcustComp//收件人公司tcustProvince/tcustProvince//到件省tcustCity/tcustCity//到件市tcustCounty/tcustCounty//到件县weight/weight//寄件重量length/length//物品长度insure/insure保价，每件最高投保金额以人民币5万元为限insurance/insurance//保险fee/fee//小写金额，代收货款和收件人付费不保留小数点；标准快递和经济快递保留两位小数点feeUppercase/feeUppercase//大写金额（代收货款和收件人付费需要填写）businessType/businessType//业务类型，1为标准快递，2为代收货款，3为收件人付费，4为经济快递（传数字）cargoDesc/cargoDesc//内件信息，根据货品的实际情况填写（对个别已与EMS和买家达成协议的，可只写货号，不写实际货物名称）cargoType/cargoType//内件类型：（文件、物品）remark/remark//备注deliveryclaim/deliveryclaim//对揽投员的投递要求，填写客户的个性化投递要求productCode/productCode//产品代码blank1/blank1//预留字段1blank2/blank2//预留字段2blank3/blank3//预留字段3blank4/blank4//预留字段4blank5/blank5//预留字段5/printDataprintData……/printData......../printDatas/XMLInfo字段类型Limit说明订单信息scontactorVARCHAR2(50CHAR)NotNull寄件人姓名scustMobileVARCHAR2(20CHAR)NotNull寄件人联系方式1scustTelplusVARCHAR2(20CHAR)寄件人联系方式2scustPostVARCHAR2(6CHAR)NotNull寄件人邮编scustAddrVARCHAR2(200CHAR)NotNull寄件人地址scustCompVARCHAR2(50CHAR)寄件人公司tcontactorVARCHAR2(50NotNull收件人姓名CHAR)tcustPostVARCHAR2(6CHAR)NotNull收件人邮编tcustAddrVARCHAR2(200CHAR)NotNull收件人地址tcustCompVARCHAR2(50CHAR)收件人公司tcustMobileVARCHAR2(30CHAR)NotNull收件人联系方式1tcustTelplusVARCHAR2(30CHAR)收件人联系方式2tcustProvinceVARCHAR2(20CHAR)NotNull到件省tcustCityVARCHAR2(20CHAR)NotNull到件市tcustCountyVARCHAR2(20CHAR)NotNull到件县weightNUMBER(14,4)寄件重量lengthNUMBER(14,4)物品长度RemarkVARCHAR2(100CHAR)备注bigAccountDataIdVARCHAR2(30CHAR)NotNull大客户数据的唯一标识，如某电商公司的配货单号billnoVARCHAR2(20CHAR)NotNull详情单号customerDnVARCHAR2(30CHAR)大客户数据的客户订单号，主要是对于电商客户有用insureNUMBER(14,4)保价insuranceNUMBER(14,4)保险feeNUMBER(14,4)小写金额feeUppercaseVARCHAR2(20CHAR)大写金额deliveryclaimVARCHAR2(100CHAR)对揽投员的投递要求businessTypeVARCHAR2(10CHAR)业务种类cargoDescVARCHAR2(100CHAR)内件信息cargoTypeVARCHAR2(10CHAR)内件类型productCodeVARCHAR2(20CHAR)产品代码blank1VARCHAR2(100CHAR)预留字段1blank2VARCHAR2(100CHAR)预留字段2blank3VARCHAR2(100CHAR)预留字段3blank4VARCHAR2(100CHAR)预留字段4blank5VARCHAR2(100CHAR)预留字段5返回值格式定义使用BASE64加密返回值XML标记串：?xmlversion=1.0encoding=UTF-8?responseresult/result//是否执行成功，1是成功，0是失败errorDesc/errorDesc//错误原因描述/response参考方法名updatePrintEMSDatas(xml)Webservice_path实现类EmsPrintService备注3OCX接口3.1调用身份验证程序加载OCX过程中调用一次本方法即可，相当于登陆。功能描述大客户系统调用EMS自助服务系统OCX身份验证接口方式OCX接口地址EmsPrint.ocx（在EMS自助服务客户端安装根目录下）输入参数大客户号，密码(小写MD5加密)输入参数格式定义单个字符串，使用#%分隔不同参数参数示例：大客户号#%密码(小写MD5加密)A1234567890Z#%e10adc3949ba59abbe56e057f20f883e返回值格式定义单个字符串，使用#%分隔不同返回值字段返回值示例验证成功：1#%验证成功#%寄件城市验证失败：0#%错误代码#%错误信息参考方法名CheckID()错误信息定义0#%网络连接失败0#%该用户不存在0#%ocx版本不一致,请更新客户端并登录一次后使用0#%当前版本...0#%密码错误0#%其他错误#%错误信息备注3.2获取邮件号种类及邮件产品代码功能描述大客户系统调用EMS自助服务系统OCX打印详情单接口方式OCX接口地