EMS自助服务系统和大客户接口规范V0.9(取单号打印后回传数据)22要点.docx

《EMS自助服务系统和大客户接口规范V0.9(取单号打印后回传数据)22要点.docx》由会员分享，可在线阅读，更多相关《EMS自助服务系统和大客户接口规范V0.9(取单号打印后回传数据)22要点.docx（9页珍藏版）》请在优知文库上搜索。

1、passworda大许户密码，必地，小写md5itl密，el0adc3949ba59abbe56e057f20f883eVaPPKeyvappKey对接方平台Id,作为接口调用方的身份凭据，由接口供应方供应VbUSineSST/pevbusineSSIyPe业务类型.必填.1为标准快递.4为经济快递（传数字）VbiIINOAmOUntvbillNoAmount3SJ惮情单数量，多入100个返回值格式定义运用BASE64加宙返回值XM1.标记率：V?XmIVerSiOn=1.0encoding=UTF-8?VreSUIt/result/是否执行胜利,1是胜利，0是失败VerrorDeSe错误缘由

2、描述VbillnOvbillno详情单号参考方法名getBIIINoBySys(xml)WebSerVieJPath308zkwebSerViCeS/getPrintDatas?WSdlWeb$ervice_name实现美EmsPrintService备注2.2详情单打印信息更新到EMS自助服务系统接口功能描述将详情能打印信息更新到自助服务系统朦务EMS自助股务系统客户人客户系统接口方式Insurance/insurance保Pvfee小与金额,代收贷款和收件人付的不保制小散点：标准快递和经济快递保留两位小数点VfeeUPPerCaSe大?j金颔（代牧货款和收件人付费须要埴写业务类型,1为标准

3、快递.2为代收贷款.3为收件人忖费,4为经济快递（传数字,）内件估息.依拉，货品的实际状况填写（财个别己与EMS和买家达成协议的,可只写货号，不写实际法制名称VCargOTyPevcargoType内件类型：（文件、物品）/备注VdeIiVeryCIaimvdeliverdaim对榄投员的投递要求,城写客户的特性化投递要求VProdUCtCOdevprOdUCtCode产品代码v心Iank1预留字段1vblank2预留字段2/预留字段3Vblank4vblank4预傍字段4vblank5预曲字段5字段【类型IIimit说明信息ScontactorVARCHAR2(50CHAR)NotNuII寄

4、件人姓名SCustMobiIeVARCHAR2(2OCHAR)NotNull寄件人联系方式1ScustTeIpIusVARCHAR2(2OCHAR)寄件人联系方式2SCUStPOStVARCHAR2(6CHAR)NotNull寄件人邮编ScustAddrVARCHAR2(200CHAR)NotNull寄件人地址ScustCompVARCHAR2(5OCHAR)寄件人公司tcontactorVARCHAR2(5ONotNull收件人姓名CHAR)tcuStPostVARCHAR2(6CHAR)NotNull收件人邮编tcustAddrVARCHAR2(200CHAR)NotNull收件人地址tc

5、ustCompVARCHAR2(5OCHAR)收件人公MIcustMobiIeVARCHAR2(3OCHAR)NotNull收件人联系方式1tcustTelplusVARCHAR2(3OCHAR)收件人联系方式2IcustProvinceVARCHAR2(2OCHAR)NotNull到件省tcustCityVARCHAR2(2OCHAR)NotNull到件市tcustCountyVARCHAR2(20CHAR)NotNull到件县weightNUMBER(14,4)寄件重量lengthNUMBER(14,4)物品长度RemarkVARCHAR2(100CHAR)备注bigAccountData

6、IdVARCHAR2(3OCHAR)NotNull大客户数据的唯一标识，如某电商公M的配货单号billnoVARCHAR2(2OCHAR)NotNull详情单号CustomerDnVARCHAR2(30CHAR)大客户数据的客户Ir单号，主要是对于电商客户有用insureNUMBER(14,4)保价insuranceNUMBER(14,4)保险feeNUMBER(14,4)小写金额feeUppercaseVARCHAR2(20CHAR)大写金额deliveryclaimVARCHAR2(100CHAR)对揽投员的投递要求businessTypeVARCHAR2(10CHAR)业务种突Cargo

7、DescVARCHAR2(100CHAR)内件信息CargoTypeVARCHAR2(10CHAR)内件类型ProductCodeVARCHAR2(2OCHAR)产品代码blanklVARCHAR2(100CHAR)预留字段1bank2VARCHAR2(100CHAR)预留字段2bank3VARCHAR2(100CHAR)预留字段3blank4VARCHAR2(100CHAR)按留字段4blank5VARCHAR2(100CHAR)预留字段5返回值格式定义运用BASE64加密送回值XM1.标记串:VreSUIt/result是否执行胜利,1是胜利，。是失败VerrOrDeSCverrorDes

8、c错俣缘由描述参考方法名UpdatePrintEMSDatas(XmI)Webservice-path:8081/ZkwebservicesgetPrintDatas?WSdlWebservicejame实现类EmsPrintService备注3OCX接口3.1 调用身份验证程序加OCX过程中用一次本方法即可，相当于登陆.功能描述大客户系统周用EMSfI助服务系统OCX身价验证接口方式OCX接口地址EmsPrint.Ocx（在EMS自助服务客户端安装根节目下）入套数大客户号,密码（小写MD5加密）入数格式定义单个字符串，运用#%分不同介数黎裁示例：大客户密码(小写MD5加密)A12345678

9、90Z#%el0adc3949ba59abbe56e057f20f883e返回值格式定义单个字符串.运用分不同返回值字段返回值示例验证胜利：1#%验证胜利#%寄件城市胎证失败：0#%错误代码#%错误信息金号方法名CheckID()储谀信总定义0跳网络连接失败0耽该用户不存在0tcx版本不一样,请更新客户端并登录一次后运用0叭当前版本.。峨诙码错误。的其他错误得错误信息备注3.2 获得邮件号种类及邮件产品代码功能描述大客户系统调用EMS自助眼务系统OCX打印详情单接口方式OCX接口地址EmsPrint-Ocx（在EMS自助版务客户那安装根书目下）,入套皴%ead开头,e11d结尾.参数字段以T分

10、l拼接的字符串,空值也须要用T占位.拼接完成后将整个字符中传入接口入套数格式定义字符串，！ead开头，end结尾.各字段值运用*|（英文SHl）分篇.拼接完成后运用整个字符串作为接口介敷.空值也殖要用T占位buslnessType-业务类型,1为标准快递，2为代收货款,3为收件人付费,4为经济快递，不行传空cargo_type-内件性质.3为物品1为文件,传空默认为物品tcustProvince到件省tcustCity-到件市tcustCounty到件县.入示例headbusinessfype|cargo_typetcustProvinceItcustCityItcustCountyend返回

11、值格式定义单个字符申运用舔分隔不同返回值字段返回值参数格式如下：I咻单号类型叫产品代码返回值说明地号类型：1、标快单号（11开头,2、经快单号51开头）参考方法名getprtlnfo(prtData)错误信息定义E007：请验证账号后迳用EOllt参数格误E999：错误信息（其他怖误）备注3.3 大客户系统调用客户端OCX打印详情单功能描述大客户系统调用EMS自助眼务系统。CX打印详情单接口方式OCX接口地址EmsPrint-Ocx（在EMS自助服务客户那安装根书目下）入数,headl开头，e11d,结尾,参数字段以T分隔拼接的字符小，空值也须要用T占位.拼接完成后将整个字符串传入接口入参数格

12、式定义字符*,head开头，end结尾.各字段值运用1（英文竖立）分拼接完成后运用At字符串作为接口敷空值也须要用T占位businessType-业务类型,1为标准快逆,2为代收货款，3为收件人付费，4为经济快递，不行传空billnoType-弗号类蟹,1为标快,2为经快，“业务类里”为“代收货款二“收件人付费”时不行传空Billno-详情单号（运单号、邮件号）dateType-时间类Sb1为收寄时间；2为打卬时间：可传空Procdate-收寄时间或打印时间,形式如“YYYY-MM-DDhh:mi:ss”,可精确到“秒”时间类型为空时,本值可为空也可进行传（ft.Scontactor寄件人姓名SCustMobiIe-寄件人联系方式1ScustTeIpIus-寄件人联系方式2（选WI）SCUStPOSt寄件人眺编ScustAddr-寄件人地址tcontactor-收件人姓名tcustMobile-收件人联系方式1tcustTelplus-收件人联系方式2（选填）tcustPost一收件人邮编tcustAddr收件人地址tcustProvince到件省