国际在线产品-新版国际在线发运系统API规范

1国际在线产品-新版国际在线发运系统API规范21E邮宝、e包裹、e特快、e速宝API综述...........................................................................11.1业务简介.......................................................................................................................11.2适用范围.......................................................................................................................11.3API功能域分类...........................................................................................................11.4API开发说明...............................................................................................................12E邮宝、e包裹、e特快、e速宝API规范...........................................................................12.1SHIP（发运服务）......................................................................................................12.1.1运单信息接收服务...........................................................................................22.1.2运单信息验证服务...........................................................................................92.1.3运单信息取消服务.........................................................................................102.1.4运单信息查询服务.........................................................................................102.2TRACK（跟踪信息服务）.......................................................................................112.2.1实时跟踪信息查询.........................................................................................112.3RATE(费率服务)........................................................................................................112.3.1国际E邮宝费率计算....................................................................................112.4Address(地址服务).....................................................................................................122.4.1国内地址行政区划查询.................................................................................122.5LABEL(标签服务).....................................................................................................132.5.1标签静态文件下载服务.................................................................................132.5.2批量获取标签服务.........................................................................................142.5.3批量获取标签服务（增强版）.....................................................................153附录.........................................................................................................................................163.1附录一：集成及用户权限验证方法.........................................................................163.2附录二：国家和地区名称以及邮编规则.................................................................163.3附录三：澳大利亚-州列表.......................................................................................173.4附录四：版本信息更新记录.....................................................................................1811E邮宝、e包裹、e特快、e速宝API综述1.1业务简介E邮宝、E包裹、E特快、E速宝API提供在线的运单生成、标签打印、全程跟踪等信息服务，覆盖运单的完整生命周期。1.2适用范围具备一定软件开发能力并拥有自建订单系统的大中小型B2C、C2C商家，可根据自身情况，进行个性化的开发，以达到API系统对接的目的。API基于HTTP协议实现，需要双方系统能够通过internet互联，并使用http方式进行通讯。本文档描述不涉及具体的开发语言，集成过程可使用合适的编程技术，实现基于http的数据交换方式。1.3API功能域分类API数量较多，在后续建设过程中可能不断增加，但总体可划分几个域进行完善和扩充：SHIP(发运服务)、TRACK（跟踪信息服务）、RATE（费率服务）、ADDRESS（地址服务）、LABEL（标签服务）。1.4API开发说明接口入网参数version（版本号）和authenticate（授权码）在一些接口是必填项，具体请参照附录一：集成及用户权限验证方法如果您在开发中出现：商品名称填写中文，但返回错误还是提示“商品中文名称不能为空，且必须包含至少2个汉字”时，请检查在调用api接口时所用的编码方式必须为UTF-8。2E邮宝、e包裹、e特快、e速宝API规范2.1SHIP（发运服务）发运服务域包含与运单信息相关的服务，主要包括运单信息接收服务、运单信息验证服务、运单信息取消服务、运单信息查询服务。22.1.1运单信息接收服务资源地址：方法：POSTE邮宝、E包裹、E特快、E速宝(永兴专线)传送内容：XML格式的订单信息，示例：?xmlversion=1.0encoding=UTF-8?ordersxmlns:xsi=!--客户订单号--operationtype0/operationtype!--业务类型（默认0）--producttype0/producttype!--产品种类（默认0）--customercodedeve360/customercode!--客户代码--vipcode00000000000001/vipcode!--大客户代码--clcttype1/clcttype!--揽收类型上门或者自送--podfalse/pod!--电子签收--untreadAbandoned/untread!--退回--volweight123/volweight!--体积重量--startdate2011-03-01T22:22:22/startdate!--起始预约时间--enddate2011-03-11T02:22:11/enddateprintcode01/printcodesender!--寄件人地址，英文--nameWangLin/namepostcode100055/postcodephone2131231/phonemobile1123333333313/mobilecountryCN/countryprovince441402/provincecity441402/citycounty441402/countycompanyTeamsun/company3streetLotusStreet/[e-mail]/email/senderreceivernameTom.k/namepostcode10005/postcodephone1111111/phonemobile212-222-0111/mobilecountryUNITEDSTATESOFAMERICA/countryprovinceLA/provincecitySanFrancisco/citycountySt./countystreetLotusStreet/street/receivercollect!--揽收地址，中文--name王大琳/namepostcode100067/postcodephone123456-908-098/phonemobile1233333333333/mobilecountryCN/countryprovince441402/provincecity441402/citycounty441402/countycompany/street莲花池东路126号/[e-mail]/email/collectitemsi