- 翻译公司资讯
-
世联翻译公司完成平台接入技术规范中文翻译
发布时间：2018-09-19 10:47 点击：
世联翻译公司完成平台接入技术规范中文翻译
1. 前言本文档目的是定义BSP企业服务平台的通用对外服务接口，以便快速集成大客户自有的系统，从而打通大客户与顺丰系统之间的信息流，实现整体物流供应链的一体化，进而达到顺丰与客户的双赢。2. 接口规范说明 接口规范说明通用对外服务接口统一使用UTF-8编码的XML报文，接口通信协议支持WEBSERVICE、HTTP/POST、FTP三种协议，当前主要使用WEBSERVICE协议方式。通用对外服务接口分为主动接入与对外推送两类接口，基于FTP协议的对外推送类接口无需对应的响应报文，其他均存在对应的请求与响应报文；以下定义了通用对外服务接口报文需要遵循的格式与规则：. 请求报文：<Request service="服务名" lang="zh-CN"><Head>客户卡号,校验码</Head><Body>请求数据XML</Body></Request>关键规则：a) service 属性与HEAD元素预先定义了服务名，客户卡号及检验码，结合请求的客户IP地址可以满足只要通过预解析HEAD元素就能够进行系统功能权限的验证，无功能权限情况下无需进一步解析Body内部数据，大大提高了拦截非法访问的性能；b) 客户卡号与校验码统一使用顺丰分配的客户卡号与校验码；c) lang属性用于支持国际化请求，缺省值为zh-CN。. 响应报文：<Response service="服务名"><Head>OK|ERR</HEAD><BODY>正常响应数据XML</BODY><ERROR code="NNNN">错误详细信息</ERROR></Response>关键规则：a) Head元素值为OK或ERR；OK代表交易正常，ERR代表发生系统或业务异常；对于批量交易场景，部分交易异常必须返回OK值，且必须在返回BODY中标识出发生异常的交易记录，避免下次全部重发；BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 42013 年 06 月 01 日b) Head元素值为OK时返回BODY元素，为ERR时返回ERROR元素；BODY与ERROR元素不能同时存在；c) ERROR元素中的code属性值为四位数字，错误编码的描述请参考文档的最后一个部分。. 批量交易记录数限制为20条以下（参考顺丰网站），特定业务可以自定义不支持批量交易或小于20的批量记录数限制。. 请求或正常响应数据XML中数据元素的定义需遵循将必要字段（包含有默认值的字段），可选字段及扩展字段进行分开定义的原则，同时字段尽量通过元素的属性进行定义，字段值限制在200字符以下（50个汉字以下）；必要字段使用数据元素本身的属性进行定义，可选项字段在数据元素下定义“数据元素名+Option”元素并通过其属性进行定义，扩展字段使用数据元素下保留元素<Extra>的属性进行定义；必要字段的数目尽量控制在10个以下；如：<Order id="XXXX" …><OrderOption payment="XXXX" …/><Extra e1="XXXX" …/></Order>OrderOption元素的属性及值由具体的业务数据定义；Extra 元素最大支持20个属性，属性名为e1,…,e20,只支持字符串值。. 尽量通过客户个性化服务配置的方式减少接口报文需要传递的字段量，如在订单报文中加入发货点代码的方式，可以在后台基于客户+发货点代码的方式配置月结账号等等数据，避免在接口报文中传递附加的月结账号。. 请求与响应报文元素命名采用大写字母开头的单词序列，如“OrderResponse”；属性名统一使用小写，如“orderid”；子元素在定义表格中一律使用“/”径表示，如“outeTrackingResponse/Route”；通用对外服务接口当前已经定义了快递类服务接口，其参考地址参见：Http://bsp-oip/sf-express.com/bsp-ois/ws/expressService3. 快递类服务 递类服务 接口3.1. 下订单（含筛选）3.1.1. 功能描述下单接口根据客户需要，可提供以下三个功能：1） 客户系统向顺丰下发订单。2） 为订单分配运单号。BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 52013 年 06 月 01 日3） 筛单。3.1.2. 接口主信息定义服务名称OrderService批量交易限制不支持接口类型接入协议类型WEBSERVICE接口方法public String sfexpressService(String XML);数据元素<请求>Order必要字段名类型（约束）默认值描述order rder idString(64) String(64)String(64) String(64) String(64) String(64)客户 订单号， 订单号， 订单号， 订单号， 建议 英文字母 英文字母 英文字母 英文字母 +YYMMDD +YYMMDD +YYMMDD +YYMMDD（日 期） +流水号，如： 流水号，如： 流水号，如： TB1207300000001 TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001 TB1207300000001 TB1207300000001express_type express_typeexpress_type express_type express_type express_type express_typeString( String(String( String( 5)标准快递 标准快递快件产品类别 快件产品类别 快件产品类别1标准快递 标准快递2顺丰特惠 顺丰特惠j_company j_companyj_company j_company j_companyString(100) String(100)String(100) String(100) String(100) String(100)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方公司名称 寄件方公司名称 寄件方公司名称 寄件方公司名称 寄件方公司名称 寄件方公司名称 寄件方公司名称 , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示 如果不提 如果不提 如果不提 如果不提 供，将 从系统配置获取 从系统配置获取 从系统配置获取 从系统配置获取j_contact j_contactj_contact j_contact j_contactString(30) String(30)String(30) String(30) String(30) String(30)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方联系人 寄件方联系人 , _SYSTEM_SYSTEM _SYSTEM _SYSTEM_SYSTEM表示如果不提供， 表示如果不提供， 将从系统配置获取 将从系统配置获取 将从系统配置获取 将从系统配置获取j_tel j_telj_telString(2 String(2String(2 String(2 String(20)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方联系电话 寄件方联系电话 寄件方联系电话 寄件方联系电话 寄件方联系电话 寄件方联系电话 寄件方联系电话 , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不 表示如果不 表示如果不 表示如果不 表示如果不 提 供，将从系统配置获取 供，将从系统配置获取 供，将从系统配置获取 供，将从系统配置获取 供，将从系统配置获取j_address j_addressj_address j_address j_addressString(150) String(150)String(150) String(150) String(150) String(150)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方详细地址 寄件方详细地址 寄件方详细地址 寄件方详细地址 寄件方详细地址 寄件方详细地址 寄件方详细地址 ，包括省市区 ，包括省市区 ，包括省市区 ，包括省市区 ，包括省市区 ，包括省市区 ，示例：“ ，示例：“ ，示例：“ ，示例：“ ，示例：“ 广东 省深圳市福田区 省深圳市福田区 省深圳市福田区 省深圳市福田区 省深圳市福田区 省深圳市福田区 省深圳市福田区 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 新洲十一街万基商务大厦 10 楼” , _SYSTEM_SYSTEM _SYSTEM _SYSTEM 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 表示如果不提供，将从系 统配置获取 统配置获取d_company _company _company _companyString(100) String(100)String(100) String(100) String(100) String(100)到件方公司名称 到件方公司名称 到件方公司名称d_contact d_contactd_contact d_contact d_contactString(30) String(30)String(30) String(30) String(30) String(30)到件方联系人 到件方联系人 到件方联系人d_tel d_teld_telString(2 String(2String(2 String(2 String(20)到件方联系电话 到件方联系电话 到件方联系电话d_address d_addressd_address d_address d_addressString(150) String(150)String(150) String(150) String(150) String(150)到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 到件方详细地址，示例：“ 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 广东省深圳市福田 区新洲十一街万基商务大 新洲十一街万基商务大 新洲十一街万基商务大 新洲十一街万基商务大 新洲十一街万基商务大 厦10 楼”parcel_quantity parcel_quantityparcel_quantity parcel_quantity parcel_quantity parcel_quantity parcel_quantity parcel_quantityNumber(5) Number(5)Number(5) Number(5) Number(5)1包裹数， 如果生成运单 号码 ，需要提供此项。 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 一个包裹对应运单号，数据必须准确 。pay_method pay_methodpay_method pay_method pay_method pay_methodNumber umber umber(1)(1)_SYSTEM _SYSTEM_SYSTEM _SYSTEM付款方式： 1: 寄方付 2: 收方付 3: 第三方 付，默认为 ，默认为 ，默认为 1。_SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 将从系统配置获取 将从系统配置获取 将从系统配置获取 将从系统配置获取j_province j_provincej_province j_province j_province j_provinceString StringString String(30)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方所在省份字段填写要求：必须是标准的省名称谓 省名称谓 如：广东省 如：广东省 如：广东省j_city j_cityj_city j_cityString StringString String(100)(100) (100)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方所属城 寄件方所属城 寄件方所属城 市名称 市名称字段填写要求：必须是标准的城市称谓 字段填写要求：必须是标准的城市称谓 字段填写要求：必须是标准的城市称谓 如： 深圳市d_province d_provinced_province d_province d_province d_provinceString StringString String(30)到件方所在省份字段填写要求：必须是标准的 省名称谓 省名称谓 如：广东省 如：广东省 如：广东省d_city d_cityd_city d_cityString StringString String(100)(100) (100)到件方所属城市名称 件方所属城市名称 件方所属城市名称 件方所属城市名称字段填写要求：必须是标准的城市称谓 字段填写要求：必须是标准的城市称谓 字段填写要求：必须是标准的城市称谓 如： 深圳市数据元素<响应>OrderResponse字段名类型（约束）是否非空描述orderid rderid rderidString(64) String(64)String(64) String(64) String(64) String(64)否订单号mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)运单号 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔 ，可多个单号如子母件以逗分隔BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 62013 年 06 月 01 日originc origincoriginc originc ode odeString(10) String(10)String(10) String(10) String(10) String(10)否原寄地代码 原寄地代码destc destcdestc ode odeString(10) String(10)String(10) String(10) String(10) String(10)否目的地代码 目的地代码filter_result filter_resultfilter_result filter_result filter_result filter_result filter_resultNumber(2) Number(2)Number(2) Number(2) Number(2)筛单结果： 1-人工确认， 人工确认， 人工确认， 人工确认， 人工确认， 2-可收派 3-不可 以收派remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范围， 收方超范围， 收方超范围， 收方超范围， 2-派方超范围， 派方超范围， 派方超范围， 3-其他原因 其他原因3.1.3. 可选字段信息数据元素Order/OrderOption字段名类型（约束）描述custid custidcustid custidString(20) String(20)String(20) String(20) String(20) String(20)月结卡号 月结卡号 _SYSTEM _SYSTEM _SYSTEM _SYSTEM _SYSTEM 可配置template templatetemplate template templateString StringString String(30)(30) (30)模板选择 模板选择j_shippercode j_shippercodej_shippercode j_shippercode j_shippercode j_shippercode j_shippercodeString(30) String(30)String(30) String(30) String(30) String(30)寄件 方代码 方代码d_deliverycode d_deliverycoded_deliverycode d_deliverycode d_deliverycode d_deliverycode d_deliverycode d_deliverycodeString(30 String(30String(30 String(30 String(30 )到件 方代码 方代码cargo cargocargoString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个货物 名称，可有多个， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔， 如果有多个货物以逗号分隔如：“手机 如：“手机 如：“手机 ,IPAD, ,IPAD, ,IPAD, 充电器“ 充电器“ 充电器“ 需生成电子运单，此字段必传 需生成电子运单，此字段必传 需生成电子运单，此字段必传 需生成电子运单，此字段必传 需生成电子运单，此字段必传 需生成电子运单，此字段必传 需生成电子运单，此字段必传cargo_count cargo_countcargo_count cargo_count cargo_count cargo_countString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)货物数量，多个时以逗号分隔且与 货物数量，多个时以逗号分隔且与 cargo cargo cargo中描述的货 物相对应 物相对应如： 2,1,32,1,3 2,1,3cargo_unit cargo_unitcargo_unit cargo_unit cargo_unit cargo_unitString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)货物单位，多个时以逗号 货物单位，多个时以逗号 分隔，且与 cargo cargo cargo中描述的货 物相对应 物相对应如：个 ,台,本cargo_weight cargo_weightcargo_weight cargo_weight cargo_weight cargo_weight cargo_weightString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)货物重量，多个时以逗号分隔且与 货物重量，多个时以逗号分隔且与 cargo cargo cargo中描述的货 物相对应 物相对应如： 1.5,1.0,3.01.5,1.0,3.0 1.5,1.0,3.0 1.5,1.0,3.0 1.5,1.0,3.0 1.5,1.0,3.0cargo_amount cargo_amountcargo_amount cargo_amount cargo_amount cargo_amount cargo_amountString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)货物 单价 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 ，多个货物时以逗号分隔且与 cargo cargo cargo中描述的货 物相对应 物相对应如： 1000,2000,15001000,2000,1500 1000,2000,1500 1000,2000,1500 1000,2000,1500 1000,2000,1500 1000,2000,1500 1000,2000,1500cargo_total_weight cargo_total_weightcargo_total_weight cargo_total_weight cargo_total_weight cargo_total_weight cargo_total_weight cargo_total_weight cargo_total_weight cargo_total_weightNumber(10,2) Number(10,2)Number(10,2) Number(10,2) Number(10,2) Number(10,2) Number(10,2)订单货物总重量，位 订单货物总重量，位 订单货物总重量，位 订单货物总重量，位 订单货物总重量，位 KG ，如果提供此值， 如果提供此值， 如果提供此值， 如果提供此值， 必须 >0sendstarttime sendstarttimesendstarttime sendstarttime sendstarttime sendstarttime sendstarttimedat e要求上门取件开始时间，格式：YYYY-MM-DD HH24:MM:SS，示例：2012-7-30 09:30:00,默认为系统收到订单的系统时间mailno mailnomailno mailnoString( String(String( String( 400 4000)运单号 ， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况， 一个订单只能有主号如果是子母的情况请以，分 请以，分隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 隔，主单在第一个位置如 “755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789755123456789,001123456789,002123456789 755123456789,001123456789,002123456789755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 755123456789,001123456789,002123456789 “remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)备注数据元素OrderOption/AddedService字段名类型（约束）描述name ame（定义对应关系） （定义对应关系） （定义对应关系） （定义对应关系） （定义对应关系）String(20) String(20)String(20) String(20) String(20) String(20)增值服务名 增值服务名 ，如 CODCOD 等value valuevalueString(30) String(30)String(30) String(30) String(30) String(30)增值 服务增值 服务增值 服务1BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 72013 年 06 月 01 日增值服务传值说明:服务NAME说明备注代收货款CODvalue为货款，value1为客户编码保价INSUREvalue为声明价值MSGMSGvalue为手机号码包装费PKFEEvalue为包装费费用SMSSMSvalue为手机号码,且与收件方的手机号相同.value1 为个性化文字。特殊保价SINSUREvalue为服务费。特殊配送SDELIVERYvalue为服务费。特殊增值服务费SADDSERVICEvalue 为服务费3.1.4. 扩展字段信息遵循扩展字段规范3.1.5. 应用场景XML实例. 场景1场景描述：客户下单请求XML：<Request service= Request service= Request service= Request service= Request service= Request service= Request service= Request service= ”OrderSerOrderSer OrderSerOrderSer OrderSer vice vice ” lang="zh lang="zh lang="zh lang="zh -CN" CN"><Head> <Head><Head> <Head>j_custidj_custid j_custid j_custid j_custid（客户卡号 客户卡号 ）,checkwork ,checkwork ,checkwork ,checkwork ,checkwork （校验码 校验码 ）</Head> </Head> </Head> </Head><B ody>ody> ody><O rder rder rder orderid orderid orderid orderid=”订单号 ” express_type express_type express_type express_type express_type express_type =”快件类型 快件类型 ” j_company j_company j_company j_company j_company=” 寄件方公司名称 寄件方公司名称 寄件方公司名称 ” j_contact j_contactj_contact j_contact j_contact =”寄件方联系人 寄件方联系人 寄件方联系人 寄件方联系人 ” j_tel j_tel j_tel=”联系电话 联系电话 联系电话 ” j_address j_addressj_address j_address j_address =”寄件地址 寄件地址 ” d_company d_company d_company d_company d_company=”到件方公司名 到件方公司名 到件方公司名 到件方公司名 称” d_contact d_contact d_contact d_contact d_contact=”到件方联系人 到件方联系人 到件方联系人 到件方联系人 ” d_teld_tel d_tel =”联系电话 联系电话 ” d_addressd_address d_address d_address d_address =”到件方地址 到件方地址 到件方地址 ” parce parceparce l_quantity l_quantity l_quantity l_quantity l_quantity =”包裹数 包裹数 ” pay_method=pay_method= pay_method= pay_method= pay_method= pay_method= ”付款方式 付款方式 ”><O rderOptionrderOption rderOption rderOption rderOption rderOption custid= custid= custid= custid=”月结卡号 月结卡号 月结卡号 ” j_shippercode=”寄件方代码” d_deliverycode=”到件方代码” cargo cargo cargo=”货物名称 货物名称 ” cargo_total_weightargo_total_weight argo_total_weight argo_total_weight argo_total_weight argo_total_weight argo_total_weight argo_total_weightargo_total_weight argo_total_weight=”总重量 总重量 ” insurance_amount insurance_amount insurance_amount insurance_amountinsurance_amount insurance_amount insurance_amount insurance_amount insurance_amount=”申明价值 申明价值 申明价值 ” sendstarttime sendstarttimesendstarttime sendstarttime sendstarttime sendstarttime sendstarttime =”要求上门收件时间 要求上门收件时间 要求上门收件时间 要求上门收件时间 ” mailnomailno mailno mailno=”运单号 运单号 ” remarkremark remark remark=”备注 ”><AddedService name= <AddedService name=<AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= ”增值服务 增值服务 增值服务 1” value= value= value=value=”值 1” value value value1=”值 2” valuevalue valuevalue2=”值 3” value value value3=”值 4” value valuevalue 4=”值 5”/><! -- ...... // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService>// <AddedService> // <AddedService> 可有多个 可有多个 -- ></OrderOptionOrderOption OrderOption OrderOption OrderOption OrderOption >value1 value1value1 value1String(30) String(30)String(30) String(30) String(30) String(30)增值 服务增值 服务增值 服务2value2 value2value2 value2String(30) String(30)String(30) String(30) String(30) String(30)增值 服务增值 服务增值 服务3value3 value3value3 value3String(30) String(30)String(30) String(30) String(30) String(30)增值 服务增值 服务增值 服务4value4 value4value4 value4String(30) String(30)String(30) String(30) String(30) String(30)增值 服务增值 服务增值 服务5BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 82013 年 06 月 01 日<Extra <Extra<Extra <Extra e1= ”扩展字段 扩展字段 ” e2=”扩展字段 扩展字段 ” e3=”扩展字段 扩展字段 ” e4=”扩展字段 扩展字段 ” e5=”扩展字段 扩展字段 ” e6=”扩展字 扩展字 段” e7=”扩展字段 扩展字段 ” e8= e8=”扩展字段 扩展字段 ” e9= e9=”扩展字段 扩展字段 扩展字段 ” e10= e10= ”扩展字段 扩展字段 扩展字段 ” e11=e11=e11= ”扩展字段 扩展字段 ” e12= e12= ”扩展字 扩展字 段” e13= e13= ”扩展字段 扩展字段 扩展字段 ” e14=e14=e14= ”扩展字段 扩展字段 ” e1 5= ”扩展字段 扩展字段 ” e16= e16= ”扩展字段 扩展字段 扩展字段 ” e17=e17= e17=”扩展字段 扩展字段 ” e18= e18=e18=”扩展 字段 ” e19=e19= e19=”扩展字段 扩展字段 ” e20= e20=e20=”扩展字段 扩展字段 ”/></Order> </Order></Order> </Order> </Order></Body> ody></ RequestRequest Request Request >响应XML：订单处理成功： 订单处理成功： 订单处理成功：<Response <Response<Response <Response <Response service=service= service= service= service=”OrderService OrderServiceOrderService OrderService OrderService OrderService OrderService”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head><Body> <Body><Body> <Body><O rderrder rderResponseResponse Response Response Response orderid= orderid= orderid= orderid=orderid=”订单号 订单号 ” mailno=mailno= mailno= mailno= ”主单 ,子单 1, 子单 2, …,子单 n” originCode=originCode= originCode= originCode=originCode= originCode= originCode=”原寄 地代码 ” destCode= destCode= destCode= destCode= destCode=”目的地代码 目的地代码 目的地代码 ” filter_result=”筛单结果 筛单结果 ” remark= remark= remark=remark= ”备注 ”/></Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>订单处理失败： 订单处理失败： 订单处理失败：<Response service= <Response service=<Response service= <Response service= <Response service= <Response service= <Response service= <Response service= <Response service= <Response service=”OrderService OrderServiceOrderService OrderService OrderService OrderService OrderService”><Head> ERR</<Head>ERR</Head><Head> ERR</<Head> ERR</<Head> ERR</<Head> ERR</<Head> ERR</<Head> ERR</<Head>ERR</<ERROR code="NNN <ERROR code="NNN<ERROR code="NNN <ERROR code="NNN <ERROR code="NNN <ERROR code="NNN <ERROR code="NNN <ERROR code="NNN <ERROR code="NNNN"> 错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.2. 订单发货确认3.2.1. 功能描述该接口用于客户在确定将货物交付给顺丰托运后，将运单上的一些重要信息，如快件重量、寄件时间，通过此接口发送给顺丰。3.2.2. 接口主信息定义服务名称OrderConfirmService批量交易限制不支持接口类型接入协议类型WEBSERVICE接口方法public String sfexpressService(String XML);数据元素<请求>OrderConfirm必要字段名类型（约束）默认值描述orderid rderid rderidString(64) String(64)String(64) String(64) String(64) String(64)订单号mailno ailno ailnoString(20) String(20)String(20) String(20) String(20) String(20)运单号数据元素<响应>OrderConfirmResponse字段名类型（约束）是否非空描述orderid orderidorderid orderidSt ring(64)ring(64) ring(64) ring(64) ring(64)否订单号mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)否运单号res_status res_statusres_status res_status res_status res_statusNumber NumberNumber Number(1)备注 1-订单号与运不匹配 订单号与运不匹配 订单号与运不匹配 订单号与运不匹配 订单号与运不匹配2 成功BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 92013 年 06 月 01 日3.2.3. 可选字段信息数据元素OrderConfirm/OrderConfirmOption字段名类型（约束）描述weight weightweight weightNumber(10,2) Number(10,2)Number(10,2) Number(10,2) Number(10,2) Number(10,2) Number(10,2)订单重量，位 订单重量，位 订单重量，位 订单重量，位 KGvo lumelume lumeString(100) String(100)String(100) String(100) String(100) String(100)托寄物的 托寄物的 长，宽高以逗号分隔 长，宽高以逗号分隔 长，宽高以逗号分隔 长，宽高以逗号分隔 长，宽高以逗号分隔 长，宽高以逗号分隔 ，单位 CM ，精确到小数点 ，精确到小数点 ，精确到小数点 ，精确到小数点 1位。3.2.4. 扩展字段信息遵循扩展字段规范3.2.5. 应用场景XML实例. 场景1场景描述：请求XML：<Request service= Request service= Request service= Request service= Request service= Request service= Request service= Request service= ”OrderConfirmServiceOrderConfirmService OrderConfirmServiceOrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService” lang="zh lang="zh lang="zh lang="zh -CN"CN" ><Head> <Head><Head> <Head>custidcustid custid custid（客户卡号 客户卡号 客户卡号 ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校验码 校验码 ）</Head></Head> </Head> </Head><B ody>ody> ody><Order Order OrderConfirmConfirm Confirm Confirm orderid rderid rderid =”订单号 订单号 ” mailnoailno ailno =”运单号 ”><OrderConfirmOption w <OrderConfirmOption w<OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w <OrderConfirmOption w eighteight eight =”快件 重量 ” volume=volume= volume=volume= volume=”托寄物的长，宽，高”/><Extra <Extra <Extra <Extra e1 =”扩展字段 扩展字段 ” e2=”扩展字段 扩展字段 ” e3=”扩展字段 扩展字段 ” e4=”扩展字段 扩展字段 ” e5=”扩展字段 扩展字段 ” e6=”扩展字 扩展字 段” e7=”扩展字段 扩展字段 ” e8= ”扩展字段 扩展字段 ” e9= ”扩展字段 扩展字段 扩展字段 ” e10=10= ”扩展字段 扩展字段 扩展字段 ” e11=11= ”扩展字段 扩展字段 ” e12=12= ”扩展字 扩展字 段” e13=13= ”扩展字段 扩展字段 扩展字段 ” e14=14= ”扩展字段 扩展字段 ” e15=15= ”扩展字段 扩展字段 ” e16=16= ”扩展字段 扩展字段 扩展字段 ” e17= 17=”扩展字段 扩展字段 ” e18= ”扩展 字段 ” e19= 19=”扩展字段 扩展字段 ” e20= 20=”扩展字段 扩展字段 ”/></Order /Order /Order Confirm Confirm Confirm Confirm></Body>Body> Body></ RequestRequest Request Request >响应XML：订单确认成功： 订单确认成功： 订单确认成功：<Response <Response<Response <Response <Response service=service= service= service= service=”Orde OrdeOrderConfirmServicerConfirmService rConfirmService rConfirmService rConfirmService rConfirmService rConfirmService rConfirmService ”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head><Body> <Body><Body> <Body><OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse OrderConfirmResponse orderid= orderid= orderid= orderid= ”订单号 订单号 ” mailno= mailno=mailno= mailno= ”运单号” remark= remark= remark= remark=”备注 ”/></Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>订单 确认 失败： 失败：<Response <Response<Response <Response <Response service=service= service= service= service=”OrderConfirmService OrderConfirmServiceOrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService OrderConfirmService ”><Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head><ERROR code=" <ERROR code="<ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" NNN NNNN"> 错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 102013 年 06 月 01 日3.3. 订单筛选3.3.1. 功能描述客户系统通过此接口向顺丰企业服务平台发送自动筛单请求，用于判断客户的收、派地址是否属于顺丰的收派范围。系统会根据收派双方的地址自动判断是否在顺丰的收派范围内。如果属于范围内则返回可收派，否则返回不可收派。3.3.2. 接口主信息定义服务名称OrderFilterService批量交易限制<=5笔接口类型接入协议类型WEBSERVICE接口方法public String sfexpressService(String XML);数据元素<请求>OrderFilter必要字段名类型（约束）默认值描述filter_type filter_typefilter_type filter_type filter_type filter_typeNumber NumberNumber Number(1)(1)1筛单类别： 筛单类别： 1-自动筛单（系统根据 自动筛单（系统根据 自动筛单（系统根据 自动筛单（系统根据 自动筛单（系统根据 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 地址库进行判断，并返回结果）， 2-可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 可人工筛单（系统首先根据地址库 判断，如果无法自动是否收 判断，如果无法自动是否收 判断，如果无法自动是否收 判断，如果无法自动是否收 判断，如果无法自动是否收 判断，如果无法自动是否收 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 派，系统将生成需要人工判断的任 务，后续由人工处理 务，后续由人工处理 务，后续由人工处理 务，后续由人工处理 ，处理结束 ，处理结束 后，顺丰可主动推送给客户系统 后，顺丰可主动推送给客户系统 后，顺丰可主动推送给客户系统 后，顺丰可主动推送给客户系统 后，顺丰可主动推送给客户系统 后，顺丰可主动推送给客户系统 ）orderid orderidorderid orderidString StringString String(64)(64) (64)如果filter_type=2 filter_type=2filter_type=2 filter_type=2 filter_type=2 filter_type=2 filter_type=2 ， 则必须提供 则必须提供客户 订单号 订单号d_address d_addressd_address d_address d_addressString StringString String(150)(150) (150)到件方详细地址， 到件方详细地址， 到件方详细地址， 到件方详细地址， 需要包括省市 需要包括省市 需要包括省市 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 区，如：广东省深圳市福田新洲 十一街万基商务大厦。 十一街万基商务大厦。 十一街万基商务大厦。 十一街万基商务大厦。 十一街万基商务大厦。数据元素<响应>OrderFilterResponse字段名类型（约束）是否非空描述orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)订单号 ，如果需要顺丰提供人工筛 ，如果需要顺丰提供人工筛 单，需要提供此项值 单，需要提供此项值 单，需要提供此项值 单，需要提供此项值filter ilter ilter_r esultesult esultNumber(2) Number(2)Number(2) Number(2) Number(2)否筛单结果： 筛单结果： 筛单结果： 筛单结果： 筛单结果： 1-人工确认， 人工确认， 人工确认， 人工确认， 人工确认， 2-可收派 可收派 可收派 3-不可以收派 不可以收派 不可以收派origin originorigin origincode odeString(10) String(10)String(10) String(10) String(10) String(10)原寄地代码 原寄地代码dest destdestcode odeString(10) String(10)String(10) String(10) String(10) String(10)目的地代码 ,如果可收派，此项不能 为空remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范围， 2-派方超范围， 3-其他原因 其他原因3.3.3. 可选字段信息数据元素OrderFilter/OrderFilterOption字段名类型（约束）默认值描述j_telString(20)寄件方电话countryString (50)CN寄件人所在国家BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 112013 年 06 月 01 日provinceString (30)寄件人所在省份，必须是标准的省名称称谓，示例：“广东省”（省字不要省略）cityString (100)寄件方所属城市名称，必须是标准的城市称谓，示例：“深圳市”（市字不要省略）countyString (30)寄件人所在县/区，必须是标准的县/区称谓，示例：“福田区”（区字不要省略）d_countryString(50)CN到件方国家d_provinceString (30)到件方所在省份，必须是标准的省名称称谓，示例：“广东省”（省字不要省略）d_cityString (100)到件方所属城市名称，必须是标准的城市称谓，示例：“深圳市”（市字不要省略）d_countyString (30)到件方所在县/区，必须是标准的县/区称谓，示例：“福田区”（区字不要省略）j_addressString(150)寄件方详细地址，示例：“广东省深圳市福田区新洲十一街万基商务大厦10楼”d_telString(23)到件方电话3.3.4. 扩展字段信息无。3.3.5. 应用场景XML实例. 场景1场景描述：请求XML：<Request service= Request service= Request service= Request service= Request service= Request service= Request service= Request service= ”OrderFilter rderFilterrderFilter rderFilter rderFilter rderFilterServiceService Service Service ” lang="zh lang="zhlang="zh lang="zh lang="zh-CN" CN"><Head> <Head><Head> <Head>j_custidj_custid j_custid j_custid j_custid（客户卡号 客户卡号 ）,checkwork ,checkwork ,checkwork ,checkwork ,checkwork （校验码 校验码 ）</Head> </Head> </Head> </Head><B ody>ody> ody><O rderFilter rderFilter rderFilter rderFilter rderFilter rderFilter filter_type filter_type filter_type filter_type filter_typefilter_type =”筛单类别 筛单类别 ” orderid orderidorderid orderidorderid=”订单号 订单号 ” d_address d_address d_address d_address d_address=”到件方地址 到件方地址 到件方地址 ”><OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption <OrderFilterOption j_tel j_telj_tel =”寄件方电话 寄件方电话 寄件方电话 ” j_addressj_addressj_address j_addressj_address j_address =”寄件方地址 寄件方地址 寄件方地址 ” d_tel d_teld_tel =”到件方电话 到件方电话 到件方电话 ”/></ OrderFilter rderFilter rderFilter rderFilter rderFilter ><! -- ...... // 最多包括 最多包括 5个<OrderFiler OrderFiler OrderFiler OrderFiler OrderFiler >-- ></Body>Body> Body></ RequestRequest Request Request >响应XML：筛单处理成功： 筛单处理成功： 筛单处理成功：<Response <Response<Response <Response <Response service=service= service= service= service=”OrderFilter rderFilter rderFilter rderFilter rderFilter Service Service Service Service”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head><Body> <Body><Body> <Body><OrderFilter <OrderFilter<OrderFilter <OrderFilter <OrderFilter <OrderFilter <OrderFilterResponseResponse Response Response Response orderid rderid rderid =”订单号 订单号 ” filter_result=”是否可收派 是否可收派 是否可收派 ” originorigin origin origincode ode=”原寄地 原寄地 代码 ” destdest destcode ode=”目的地代码 目的地代码 目的地代码 ” remark remark remark =”备注 ”/>...</Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 122013 年 06 月 01 日筛单处理失败： 单处理失败： 单处理失败：<Response <Response<Response <Response <Response service=service= service= service= service=”OrderFilter rderFilter rderFilter rderFilter rderFilter Service Service Service Service”><Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head><ERROR code="NNN"> <ERROR code="NNN"><ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN"> <ERROR code="NNN">错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.4. 人工筛选结果推送3.4.1. 功能描述如果客户通过订单筛选接口得到的反馈结果为：3-待确认时，如果订单筛选时，提供了订单号且apply_type=2，当完成人工筛单时，顺丰系统将人工筛单的结果推送给客户系统。请客户系统提供一个符合以下规范的HTTP URL，以便顺丰向客户系统推送人工筛单数据。1）顺丰以HTTP POST的方式向客户系统推送数据。2）请求方法的编码格式：“application/x-www-form-urlencoded; charset=UTF-8”3）推送的筛单结果以XML格式，通过POST方式发送给客户系统。4）一个POST方法最多推送5条筛单数据。5）对xml内容进行URL编码（字符集为UTF-8）。6）客户系统在接收到请求后，需要先对收到的内容进行URL解码，得到相应的XML。然后从XML中获取相应的筛单数据。7）在客户系统正确处理XML信息后，向顺丰返回响应信息，考虑到处理的效率，筛单推送认为批量成功或失败。3.4.2. 接口主信息定义服务名称OrderFilterPushService批量交易限制<=5笔接口类型推送协议类型HTTP接口方法无数据元素<请求>OrderFilterResult必要字段名类型（约束）默认值描述orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)订单号 ，如果需要顺丰提供人 ，如果需要顺丰提供人 工筛单，需要提供此项值 工筛单，需要提供此项值 工筛单，需要提供此项值 工筛单，需要提供此项值 工筛单，需要提供此项值filter ilter ilter_resultesult esultNumber(2) Number(2)Number(2) Number(2) Number(2)否筛单结果： 2-可收派 3-不 可以收派 可以收派origin originorigin origincode odeString(10) String(10)String(10) String(10) String(10) String(10)原寄地代码 原寄地代码dest destdestcode odeString(10) String(10)String(10) String(10) String(10) String(10)目的地代码 ,如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 项不能为空 项不能为空remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范围， 收方超范围， 收方超范围， 收方超范围， 收方超范围， 收方超范围， 2-派方超范 派方超范 派方超范 派方超范 围， 3-其他原因 其他原因 其他原因mailno mailnomailno mailnoString( String(String( String( 30 )运单号数据元素<响应>OrderFilterResultResponse字段名类型（约束）是否非空描述orderid orderidorderid orderidString( String(String( String( 4000 4000 )否成功接收的人工筛单 订单号 订单号 ， 如果有多个订单号，以逗分 如果有多个订单号，以逗分 隔，如 ”123,124123,124 123,124 123,124 ”orderid orderidorderid orderid _error rrorString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)未成功接收的人工筛单 订未成功接收的人工筛单 订号，如果有多个订单以逗 号，如果有多个订单以逗BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 132013 年 06 月 01 日号分隔，如 号分隔，如 号分隔，如 号分隔，如 号分隔，如 ”123,124 123,124 123,124 123,124” ，这 部分订单的筛数据顺丰会定 部分订单的筛数据顺丰会定 时重发。 时重发。3.4.3. 可选字段信息无3.4.4. 扩展字段信息无3.4.5. 应用场景XML实例. 场景1场景描述：请求XML：<Re quest service= quest service= quest service= quest service= quest service= quest service= quest service= ”OrderFilterPushServiceOrderFilterPushService OrderFilterPushServiceOrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService ”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head><Body> <Body><Body> <Body><OrderFilter OrderFilter OrderFilter OrderFilter OrderFilter OrderFilterResultResult Result Result orderid rderid rderid =”订单号 订单号 ” filter_result=”是否可收派 是否可收派 是否可收派 是否可收派 ” origin origin origin codeode =”原寄地代 原寄地代 码” destCode destCode destCode destCode =”目的地代码 目的地代码 目的地代码 ” remarkremark remark remark=”备注 ”/><! -- ...//...// ...// 最多包括 最多包括 5个<OrderFilter OrderFilter OrderFilter OrderFilter OrderFilter OrderFilterResult>Result> Result> Result> -- ></Body> </Body></Body> </Body></Re </Re</Requestquest quest >响应XML：成功响应： 成功响应：<Response <Response<Response <Response <Response serser vice= vice= vice=”OrderFilterPushService OrderFilterPushServiceOrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head></Response> </Response></Response> </Response> </Response> </Response>失败响应 失败响应 ：<Response <Response<Response <Response <Response service=service= service= service= service=”OrderFilterPushService OrderFilterPushServiceOrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService OrderFilterPushService”><Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head><ERROR code=" <ERROR code="<ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" NNNN NNNN "> 错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.5. 路由查询3.5.1. 功能描述提供客户系统通过接口查询客户通过顺丰承运的运单路由的功能，支持单个或批量运单路由查询的功能，批量查询中，最多不能超过10个运单号。同一批次，只允许查询同一种语言的运单路由。BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 142013 年 06 月 01 日路由查询接口支持两类查询方式：1） 根据运单号查询：查询请求中提供客户卡号与运单号，系统将验证客户卡号与所有请求运单号的归属关系，系统只返回具有正确归属关系的运单路由信息。2） 根据订单号查询：查询请求中提供客户卡号与订单号，系统将验证客户卡号与所有请求订单号的归属关系，对于归属关系正确的订单号，找到对应的运单号，然后返回订单对应运单号的路由信息。适用于通过企业服务平台下发过订单的客户。3.5.2. 接口主信息定义服务名称RouteService批量交易限制<=10笔接口类型接入协议类型WEBSERVICE接口方法public String sfexpressService(String xml);数据元素<请求>RouteRequest必要字段名类型（约束）默认值描述tracking_type tracking_typetracking_type tracking_type tracking_type tracking_type tracking_typeNumber(2) Number(2)Number(2) Number(2) Number(2)1查询类别 查询类别 , tracking_typetracking_type tracking_type tracking_type tracking_type tracking_typetracking_type tracking_type字段说明： 字段说明： 1-根据运单号查 根据运单号查 根据运单号查 根据运单号查 询， orderorder order 节点中 节点中 track_number track_numbertrack_number track_number track_number track_number track_number将被当作运单 将被当作运单 将被当作运单 将被当作运单 号处理， 号处理， 2-根据订单号查询， 根据订单号查询， 根据订单号查询， 根据订单号查询， 根据订单号查询， order orderorder 节点中 节点中 track_number track_numbertrack_number track_number track_number track_number track_number将被当作订单 将被当作订单 将被当作订单 将被当作订单 号处理track tracktrack ing ing_n umberumber umberString StringString String(4000 4000 )查询号 , 如果 tracking_type=1 tracking_type=1tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 ，则此值 ，则此值 为运单号。如果 为运单号。如果 为运单号。如果 tracking_type=2 tracking_type=2tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 ，则此值 ，则此值 为订单号 为订单号如果有多个单号，以逗分 如果有多个单号，以逗分 如果有多个单号，以逗分 如果有多个单号，以逗分 如果有多个单号，以逗分 如果有多个单号，以逗分 隔，如 ”123,124,125123,124,125 123,124,125 123,124,125 123,124,125 123,124,125 ”数据元素<响应>RouteResponse字段名类型（约束）是否非空描述mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)否运单号orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)订单号数据元素<响应>RouteResponse/Route字段名类型（约束）是否非空描述accept ccept ccept_timeimeDate DateDate否路由发生的时间 路由发生的时间 路由发生的时间accept ccept ccept_addressddress ddress ddressString(100) String(100)String(100) String(100) String(100) String(100)否路由发生的地点 路由发生的地点 路由发生的地点remark remarkremark remarkString(150) String(150)String(150) String(150) String(150) String(150)否具体描述 具体描述op code odeString(20) String(20)String(20) String(20) String(20) String(20)操作码3.5.3. 可选字段信息无BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 152013 年 06 月 01 日3.5.4. 扩展字段信息无3.5.5. 应用场景XML实例. 场景1场景描述：根据运单号查询请求XML：<Request service= Request service= Request service= Request service= Request service= Request service= Request service= Request service= ”RouteService outeServiceouteService outeService outeService outeService ” lang="zh lang="zh lang="zh lang="zh -CN" CN"><Head> <Head><Head> <Head>custidcustid custid custid（客户卡号 客户卡号 客户卡号 ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校验码 校验码 ）</Head></Head> </Head> </Head><B ody>ody> ody><R outeoute outeRequestRequest Request Request tracking_typetracking_type tracking_type tracking_type tracking_typetracking_type tracking_type tracking_type=”查询类别 查询类别 查询类别 ” tracking_number tracking_numbertracking_number tracking_number tracking_number tracking_number tracking_number tracking_number =”单号 1,单号 2,…,单号 n”/></Body>Body> Body></ RequestRequest Request Request >响应XML：路由查询成功： 路由查询成功： 路由查询成功：<Response service= <Response service=<Response service= <Response service= <Response service= <Response service= <Response service= <Response service= <Response service= <Response service=”RouteService” outeService” outeService” outeService” outeService” outeService” ><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head><Body> <Body><Body> <Body><R outeoute outeResponseResponse Response Response Response mailno= mailno= mailno= mailno=”运单号 运单号 ” orderid= orderid= orderid= orderid= ”订单号 订单号 ”><R oute oute oute accept_time=”路由发生时间 路由发生时间 路由发生时间 ” accept_address=”路由发生地点 路由发生地点 路由发生地点 路由发生地点 ” remark remark remark =”详细说明 详细说明 ” opCode= opCode=opCode= opCode= ”操作码 操作码 ”/><! -- ...... // 可包括多个 可包括多个 可包括多个 <Route> oute>oute> -- ></ RouteResponseRouteResponse RouteResponse RouteResponse RouteResponse RouteResponse RouteResponse ><! -- ...... // 最多包括 最多包括 10个<RouteResponseRouteResponse RouteResponse RouteResponse RouteResponse RouteResponse RouteResponse >-- ></Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>路由查询 路由查询 失败： 失败：<Response <Response<Response <Response <Response service=service= service= service= service=”RouteService outeService outeService outeService outeService outeService”><Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head><ERROR code=" <ERROR code="<ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" NNNN NNNN "> 错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>失败响应： 失败响应：<Response <Response<Response <Response <Response service=service= service= service= service=”RouteService outeService outeService outeService outeService outeService”><Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head><ERROR code=" <ERROR code="<ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" <ERROR code=" NNNN NNNN "> 错误详细信息 错误详细信息 错误详细信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.6. 路由推送3.6.1. 功能描述BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 162013 年 06 月 01 日该接口用于向客户系统定时推送运单的路由信息。需要客户系统提供一个符合以下规范的HTTP URL，以便顺丰向客户系统推送路由数据。推送方式为增量推送，对于同一个运单的路由，不重复推送。1） 顺丰以HTTP POST的方式向客户系统推送数据。2） 请求方法的编码格式：“application/x-www-form-urlencoded; charset=UTF-8”3） 推送的路由数据以XML格式，通过POST方式发送给客户系统。4） 一个POST方法最多推送10条路由数据。5） 对xml内容进行URL编码（字符集为UTF-8）。6） 客户系统在接收到请求后，需要先对收到的内容进行URL解码，得到相应的XML。然后从XML中获取相应的路由信息。在客户系统正确处理XML信息后，向顺丰返回响应信息，考虑到处理的效率，路由推送认为批量成功或失败。3.6.2. 接口主信息定义服务名称RoutePushService批量交易限制<=10笔接口类型推送协议类型HTTP接口方法无数据元素<请求>WaybillRoute必要字段名类型（约束）默认值描述idNumber(15)路由编号，每一个id代表一条不同的路由mailnoString(20)否运单号orderidString(64)订单号accept_timeDate否路由产生时间accept_addressString(100)否路由发生城市remarkString(300)否路由说明opcodeString(20)操作码数据元素<响应>WaybillRouteResponse字段名类型（约束）是否非空描述idString(4000)否成功接收的路由编号，如果有多个路由编号，以逗号分隔，如“123,124,125“id_errorString(4000)否未成功接收的路由编号，如果有多个路由编号，以逗号分隔，如“123,124,125“，这部分路由编号，顺丰会定时重发3.6.3. 可选字段信息无BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 172013 年 06 月 01 日3.6.4. 扩展字段信息无3.6.5. 应用场景XML实例. 场景1场景描述：请求XML：<Request service= Request service= Request service= Request service= Request service= Request service= Request service= Request service= ”RoutePushServiceRoutePushService RoutePushServiceRoutePushService RoutePushService RoutePushService RoutePushService RoutePushService RoutePushService ” lang="zh lang="zh lang="zhlang="zh lang="zh-CN" CN"><Head> <Head><Head> <Head>custidcustid custid custid（客户卡号 客户卡号 客户卡号 ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校验码 校验码 ）</Head></Head> </Head> </Head><B ody>ody> ody><WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute id=id= ”路由编号 路由编号 ” mailno=mailno= mailno= mailno= ”运单号 运单号 ” orderid=orderid= orderid= orderid= orderid=”订单号 订单号 ” accept_time=”路由发生时 路由发生时 间” accept_address=”路由发生地点 路由发生地点 路由发生地点 ” remark remark remark =”详细说明 详细说明 详细说明 ” opcode=”操作码 ”/><! -- //...//... //... 最多 10 个<Waybill<Waybill<Waybill <Waybill<Waybill <WaybillRoute>Route> Route> Route>-- ></Body>Body> Body></ RequestRequest Request Request >响应XML：<Response <Response<Response <Response <Response service=service= service= service= service=”RoutePushService RoutePushServiceRoutePushService RoutePushService RoutePushService RoutePushService RoutePushService RoutePushService RoutePushService”><Head> <Head><Head> <Head>OK </Head></Head> </Head> </Head></Response> </Response></Response> </Response> </Response> </Response>4. 附录4.1. 原因代码表原因代码描述分类 61** 缺少必要参数6101请求数据缺少必选项缺少必要参数6102寄件方公司名称为空关键字段校验不合法6103寄方联系人为空6104寄方所在省为空6105寄方所在城市为空6106寄件方详细地址为空6107到件方公司名称为空6108到件方联系人为空6109到件方所在省为空6110到件方所在城市为空6111到件方地址为空6112到件方国家不能为空6113到件方所在省份不能为空6114必须提供客户订单号6115到件方所属城市名称不能为空BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 182013 年 06 月 01 日6116到件方所在县/区不能为空6117到件方详细地址不能为空6118订单号不能为空6119到件方联系电话不能为空6120快递类型不能为空6121寄件方联系电话不能为空6122筛单类别不合法6123运单号不能为空6124付款方式不能为空6125需生成电子运单,货物名称等不能为空6126月结卡号不合法6127增值服务名不能为空6128增值服务名不合法8*** 功能校验8000报文 参数不合法参数无效8001IP未授权参数无效8002服务（功能）未授权8003查询单号超过最大限制8004路由查询条数超限制8005查询次数超限制8006已下单，无法接收订单确认请求8007此订单已经确认，无法接收订单确认请求8008此订单人工筛单还未确认，无法接收订单确认请求8009此订单不可收派, 无法接收订单确认请求。8010此订单未筛单, 无法接收订单确认请求。8011不存在该客户卡号与运单号绑定关系8012不存在该客户卡号与订单号绑定关系8013未传入查询单号8014校验码错误8015未传入运单号信息8016重复下单8017订单号与运单号不匹配8018未获取到订单信息8019订单已确认8020不存在该订单跟运单绑定关系BSP-企业服务平台接入技术规范顺丰集团资讯科技本部研发中心 192013 年 06 月 01 日8021客户卡号为空8022校验码为空8023服务名为空8024未下单8025未传入服务或不提供该服务8026不存在的客户8027不存在的业务模板8028客户未配置此业务8029客户未配置默认模板8030未找到这个时间的合法模板8031数据错误，未找到模板8032数据错误，未找到业务配置8033数据错误，未找到业务属性8034重复注册人工筛单结果推送8035生成电子运单，必须存在运单号8036注册路由推送必须存在运单号4*** 系统校验4001系统发生数据错误或运行时异常4002报文解析错误Unitrans世联翻译公司在您身边,离您近的翻译公司,心贴心的专业服务,专业的全球语言翻译与信息解决方案供应商,专业翻译机构品牌。无论在本地,国内还是海外,我们的专业、星级体贴服务，为您的事业加速！世联翻译公司在北京、上海、深圳等国际交往城市设有翻译基地，业务覆盖全国城市。每天有近百万字节的信息和贸易通过世联走向全球！积累了大量政商用户数据，翻译人才库数据，多语种语料库大数据。世联品牌和服务品质已得到政务防务和国际组织、跨国公司和大中型企业等近万用户的认可。 专业翻译公司,北京翻译公司,上海翻译公司,英文翻译,日文翻译,韩语翻译,翻译公司排行榜,翻译公司收费价格表,翻译公司收费标准,翻译公司北京,翻译公司上海。
