- 行業(yè)新聞
-
上海翻譯公司完成平臺(tái)接入技術(shù)規(guī)范中文翻譯
發(fā)布時(shí)間：2018-09-17 08:56 點(diǎn)擊：
上海翻譯公司完成平臺(tái)接入技術(shù)規(guī)范中文翻譯
1. 前言本文檔目的是定義BSP企業(yè)服務(wù)平臺(tái)的通用對(duì)外服務(wù)接口，以便快速集成大客戶(hù)自有的系統(tǒng)，從而打通大客戶(hù)與順豐系統(tǒng)之間的信息流，實(shí)現(xiàn)整體物流供應(yīng)鏈的一體化，進(jìn)而達(dá)到順豐與客戶(hù)的雙贏。2. 接口規(guī)范說(shuō)明 接口規(guī)范說(shuō)明通用對(duì)外服務(wù)接口統(tǒng)一使用UTF-8編碼的XML報(bào)文，接口通信協(xié)議支持WEBSERVICE、HTTP/POST、FTP三種協(xié)議，當(dāng)前主要使用WEBSERVICE協(xié)議方式。通用對(duì)外服務(wù)接口分為主動(dòng)接入與對(duì)外推送兩類(lèi)接口，基于FTP協(xié)議的對(duì)外推送類(lèi)接口無(wú)需對(duì)應(yīng)的響應(yīng)報(bào)文，其他均存在對(duì)應(yīng)的請(qǐng)求與響應(yīng)報(bào)文；以下定義了通用對(duì)外服務(wù)接口報(bào)文需要遵循的格式與規(guī)則：. 請(qǐng)求報(bào)文：<Request service="服務(wù)名" lang="zh-CN"><Head>客戶(hù)卡號(hào),校驗(yàn)碼</Head><Body>請(qǐng)求數(shù)據(jù)XML</Body></Request>關(guān)鍵規(guī)則：a) service 屬性與HEAD元素預(yù)先定義了服務(wù)名，客戶(hù)卡號(hào)及檢驗(yàn)碼，結(jié)合請(qǐng)求的客戶(hù)IP地址可以滿(mǎn)足只要通過(guò)預(yù)解析HEAD元素就能夠進(jìn)行系統(tǒng)功能權(quán)限的驗(yàn)證，無(wú)功能權(quán)限情況下無(wú)需進(jìn)一步解析Body內(nèi)部數(shù)據(jù)，大大提高了攔截非法訪(fǎng)問(wèn)的性能；b) 客戶(hù)卡號(hào)與校驗(yàn)碼統(tǒng)一使用順豐分配的客戶(hù)卡號(hào)與校驗(yàn)碼；c) lang屬性用于支持國(guó)際化請(qǐng)求，缺省值為zh-CN。. 響應(yīng)報(bào)文：<Response service="服務(wù)名"><Head>OK|ERR</HEAD><BODY>正常響應(yīng)數(shù)據(jù)XML</BODY><ERROR code="NNNN">錯(cuò)誤詳細(xì)信息</ERROR></Response>關(guān)鍵規(guī)則：a) Head元素值為OK或ERR；OK代表交易正常，ERR代表發(fā)生系統(tǒng)或業(yè)務(wù)異常；對(duì)于批量交易場(chǎng)景，部分交易異常必須返回OK值，且必須在返回BODY中標(biāo)識(shí)出發(fā)生異常的交易記錄，避免下次全部重發(fā)；BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 42013 年 06 月 01 日b) Head元素值為OK時(shí)返回BODY元素，為ERR時(shí)返回ERROR元素；BODY與ERROR元素不能同時(shí)存在；c) ERROR元素中的code屬性值為四位數(shù)字，錯(cuò)誤編碼的描述請(qǐng)參考文檔的最后一個(gè)部分。. 批量交易記錄數(shù)限制為20條以下（參考順豐網(wǎng)站），特定業(yè)務(wù)可以自定義不支持批量交易或小于20的批量記錄數(shù)限制。. 請(qǐng)求或正常響應(yīng)數(shù)據(jù)XML中數(shù)據(jù)元素的定義需遵循將必要字段（包含有默認(rèn)值的字段），可選字段及擴(kuò)展字段進(jìn)行分開(kāi)定義的原則，同時(shí)字段盡量通過(guò)元素的屬性進(jìn)行定義，字段值限制在200字符以下（50個(gè)漢字以下）；必要字段使用數(shù)據(jù)元素本身的屬性進(jìn)行定義，可選項(xiàng)字段在數(shù)據(jù)元素下定義“數(shù)據(jù)元素名+Option”元素并通過(guò)其屬性進(jìn)行定義，擴(kuò)展字段使用數(shù)據(jù)元素下保留元素<Extra>的屬性進(jìn)行定義；必要字段的數(shù)目盡量控制在10個(gè)以下；如：<Order id="XXXX" …><OrderOption payment="XXXX" …/><Extra e1="XXXX" …/></Order>OrderOption元素的屬性及值由具體的業(yè)務(wù)數(shù)據(jù)定義；Extra 元素最大支持20個(gè)屬性，屬性名為e1,…,e20,只支持字符串值。. 盡量通過(guò)客戶(hù)個(gè)性化服務(wù)配置的方式減少接口報(bào)文需要傳遞的字段量，如在訂單報(bào)文中加入發(fā)貨點(diǎn)代碼的方式，可以在后臺(tái)基于客戶(hù)+發(fā)貨點(diǎn)代碼的方式配置月結(jié)賬號(hào)等等數(shù)據(jù)，避免在接口報(bào)文中傳遞附加的月結(jié)賬號(hào)。. 請(qǐng)求與響應(yīng)報(bào)文元素命名采用大寫(xiě)字母開(kāi)頭的單詞序列，如“OrderResponse”；屬性名統(tǒng)一使用小寫(xiě)，如“orderid”；子元素在定義表格中一律使用“/”徑表示，如“outeTrackingResponse/Route”；通用對(duì)外服務(wù)接口當(dāng)前已經(jīng)定義了快遞類(lèi)服務(wù)接口，其參考地址參見(jiàn)：Http://bsp-oip/sf-express.com/bsp-ois/ws/expressService3. 快遞類(lèi)服務(wù) 遞類(lèi)服務(wù) 接口3.1. 下訂單（含篩選）3.1.1. 功能描述下單接口根據(jù)客戶(hù)需要，可提供以下三個(gè)功能：1） 客戶(hù)系統(tǒng)向順豐下發(fā)訂單。2） 為訂單分配運(yùn)單號(hào)。BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 52013 年 06 月 01 日3） 篩單。3.1.2. 接口主信息定義服務(wù)名稱(chēng)OrderService批量交易限制不支持接口類(lèi)型接入協(xié)議類(lèi)型WEBSERVICE接口方法public String sfexpressService(String XML);數(shù)據(jù)元素<請(qǐng)求>Order必要字段名類(lèi)型（約束）默認(rèn)值描述order rder idString(64) String(64)String(64) String(64) String(64) String(64)客戶(hù) 訂單號(hào)， 訂單號(hào)， 訂單號(hào)， 訂單號(hào)， 建議 英文字母 英文字母 英文字母 英文字母 +YYMMDD +YYMMDD +YYMMDD +YYMMDD（日 期） +流水號(hào)，如： 流水號(hào)，如： 流水號(hào)，如： TB1207300000001 TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001 TB1207300000001 TB1207300000001express_type express_typeexpress_type express_type express_type express_type express_typeString( String(String( String( 5)標(biāo)準(zhǔn)快遞 標(biāo)準(zhǔn)快遞快件產(chǎn)品類(lèi)別 快件產(chǎn)品類(lèi)別 快件產(chǎn)品類(lèi)別1標(biāo)準(zhǔn)快遞 標(biāo)準(zhǔn)快遞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寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示 如果不提 如果不提 如果不提 如果不提 供，將 從系統(tǒng)配置獲取 從系統(tǒng)配置獲取 從系統(tǒng)配置獲取 從系統(tǒng)配置獲取j_contact j_contactj_contact j_contact j_contactString(30) String(30)String(30) String(30) String(30) String(30)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方聯(lián)系人 寄件方聯(lián)系人 , _SYSTEM_SYSTEM _SYSTEM _SYSTEM_SYSTEM表示如果不提供， 表示如果不提供， 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取j_tel j_telj_telString(2 String(2String(2 String(2 String(20)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) 寄件方聯(lián)系電話(huà) , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不 表示如果不 表示如果不 表示如果不 表示如果不 提 供，將從系統(tǒng)配置獲取 供，將從系統(tǒng)配置獲取 供，將從系統(tǒng)配置獲取 供，將從系統(tǒng)配置獲取 供，將從系統(tǒng)配置獲取j_address j_addressj_address j_address j_addressString(150) String(150)String(150) String(150) String(150) String(150)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方詳細(xì)地址 寄件方詳細(xì)地址 寄件方詳細(xì)地址 寄件方詳細(xì)地址 寄件方詳細(xì)地址 寄件方詳細(xì)地址 寄件方詳細(xì)地址 ，包括省市區(qū) ，包括省市區(qū) ，包括省市區(qū) ，包括省市區(qū) ，包括省市區(qū) ，包括省市區(qū) ，示例：“ ，示例：“ ，示例：“ ，示例：“ ，示例：“ 廣東 省深圳市福田區(qū) 省深圳市福田區(qū) 省深圳市福田區(qū) 省深圳市福田區(qū) 省深圳市福田區(qū) 省深圳市福田區(qū) 省深圳市福田區(qū) 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 新洲十一街萬(wàn)基商務(wù)大廈 10 樓” , _SYSTEM_SYSTEM _SYSTEM _SYSTEM 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 表示如果不提供，將從系 統(tǒng)配置獲取 統(tǒng)配置獲取d_company _company _company _companyString(100) String(100)String(100) String(100) String(100) String(100)到件方公司名稱(chēng) 到件方公司名稱(chēng) 到件方公司名稱(chēng)d_contact d_contactd_contact d_contact d_contactString(30) String(30)String(30) String(30) String(30) String(30)到件方聯(lián)系人 到件方聯(lián)系人 到件方聯(lián)系人d_tel d_teld_telString(2 String(2String(2 String(2 String(20)到件方聯(lián)系電話(huà) 到件方聯(lián)系電話(huà) 到件方聯(lián)系電話(huà)d_address d_addressd_address d_address d_addressString(150) String(150)String(150) String(150) String(150) String(150)到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 到件方詳細(xì)地址，示例：“ 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 廣東省深圳市福田 區(qū)新洲十一街萬(wàn)基商務(wù)大 新洲十一街萬(wàn)基商務(wù)大 新洲十一街萬(wàn)基商務(wù)大 新洲十一街萬(wàn)基商務(wù)大 新洲十一街萬(wàn)基商務(wù)大 廈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包裹數(shù)， 如果生成運(yùn)單 號(hào)碼 ，需要提供此項(xiàng)。 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 一個(gè)包裹對(duì)應(yīng)運(yùn)單號(hào)，數(shù)據(jù)必須準(zhǔn)確 。pay_method pay_methodpay_method pay_method pay_method pay_methodNumber umber umber(1)(1)_SYSTEM _SYSTEM_SYSTEM _SYSTEM付款方式： 1: 寄方付 2: 收方付 3: 第三方 付，默認(rèn)為 ，默認(rèn)為 ，默認(rèn)為 1。_SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 表示如果不提供， 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取 將從系統(tǒng)配置獲取j_province j_provincej_province j_province j_province j_provinceString StringString String(30)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方所在省份字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的省名稱(chēng)謂 省名稱(chēng)謂 如：廣東省 如：廣東省 如：廣東省j_city j_cityj_city j_cityString StringString String(100)(100) (100)_SYSTEM _SYSTEM_SYSTEM _SYSTEM寄件方所屬城 寄件方所屬城 寄件方所屬城 市名稱(chēng) 市名稱(chēng)字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 如： 深圳市d_province d_provinced_province d_province d_province d_provinceString StringString String(30)到件方所在省份字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的 省名稱(chēng)謂 省名稱(chēng)謂 如：廣東省 如：廣東省 如：廣東省d_city d_cityd_city d_cityString StringString String(100)(100) (100)到件方所屬城市名稱(chēng) 件方所屬城市名稱(chēng) 件方所屬城市名稱(chēng) 件方所屬城市名稱(chēng)字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 字段填寫(xiě)要求：必須是標(biāo)準(zhǔn)的城市稱(chēng)謂 如： 深圳市數(shù)據(jù)元素<響應(yīng)>OrderResponse字段名類(lèi)型（約束）是否非空描述orderid rderid rderidString(64) String(64)String(64) String(64) String(64) String(64)否訂單號(hào)mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)運(yùn)單號(hào) ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔 ，可多個(gè)單號(hào)如子母件以逗分隔BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 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)篩單結(jié)果： 1-人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 2-可收派 3-不可 以收派remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范圍， 收方超范圍， 收方超范圍， 收方超范圍， 2-派方超范圍， 派方超范圍， 派方超范圍， 3-其他原因 其他原因3.1.3. 可選字段信息數(shù)據(jù)元素Order/OrderOption字段名類(lèi)型（約束）描述custid custidcustid custidString(20) String(20)String(20) String(20) String(20) String(20)月結(jié)卡號(hào) 月結(jié)卡號(hào) _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)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)貨物 名稱(chēng)，可有多個(gè)， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔， 如果有多個(gè)貨物以逗號(hào)分隔如：“手機(jī) 如：“手機(jī) 如：“手機(jī) ,IPAD, ,IPAD, ,IPAD, 充電器“ 充電器“ 充電器“ 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳 需生成電子運(yùn)單，此字段必傳cargo_count cargo_countcargo_count cargo_count cargo_count cargo_countString(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)貨物數(shù)量，多個(gè)時(shí)以逗號(hào)分隔且與 貨物數(shù)量，多個(gè)時(shí)以逗號(hào)分隔且與 cargo cargo cargo中描述的貨 物相對(duì)應(yīng) 物相對(duì)應(yīng)如： 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)貨物單位，多個(gè)時(shí)以逗號(hào) 貨物單位，多個(gè)時(shí)以逗號(hào) 分隔，且與 cargo cargo cargo中描述的貨 物相對(duì)應(yīng) 物相對(duì)應(yīng)如：個(gè) ,臺(tái),本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)貨物重量，多個(gè)時(shí)以逗號(hào)分隔且與 貨物重量，多個(gè)時(shí)以逗號(hào)分隔且與 cargo cargo cargo中描述的貨 物相對(duì)應(yīng) 物相對(duì)應(yīng)如： 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)貨物 單價(jià) ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 ，多個(gè)貨物時(shí)以逗號(hào)分隔且與 cargo cargo cargo中描述的貨 物相對(duì)應(yīng) 物相對(duì)應(yīng)如： 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要求上門(mén)取件開(kāi)始時(shí)間，格式：YYYY-MM-DD HH24:MM:SS，示例：2012-7-30 09:30:00,默認(rèn)為系統(tǒng)收到訂單的系統(tǒng)時(shí)間mailno mailnomailno mailnoString( String(String( String( 400 4000)運(yùn)單號(hào) ， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況， 一個(gè)訂單只能有主號(hào)如果是子母的情況請(qǐng)以，分 請(qǐng)以，分隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 隔，主單在第一個(gè)位置如 “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)備注數(shù)據(jù)元素OrderOption/AddedService字段名類(lèi)型（約束）描述name ame（定義對(duì)應(yīng)關(guān)系） （定義對(duì)應(yīng)關(guān)系） （定義對(duì)應(yīng)關(guān)系） （定義對(duì)應(yīng)關(guān)系） （定義對(duì)應(yīng)關(guān)系）String(20) String(20)String(20) String(20) String(20) String(20)增值服務(wù)名 增值服務(wù)名 ，如 CODCOD 等value valuevalueString(30) String(30)String(30) String(30) String(30) String(30)增值 服務(wù)增值 服務(wù)增值 服務(wù)1BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 72013 年 06 月 01 日增值服務(wù)傳值說(shuō)明:服務(wù)NAME說(shuō)明備注代收貨款CODvalue為貨款，value1為客戶(hù)編碼保價(jià)INSUREvalue為聲明價(jià)值MSGMSGvalue為手機(jī)號(hào)碼包裝費(fèi)PKFEEvalue為包裝費(fèi)費(fèi)用SMSSMSvalue為手機(jī)號(hào)碼,且與收件方的手機(jī)號(hào)相同.value1 為個(gè)性化文字。特殊保價(jià)SINSUREvalue為服務(wù)費(fèi)。特殊配送SDELIVERYvalue為服務(wù)費(fèi)。特殊增值服務(wù)費(fèi)SADDSERVICEvalue 為服務(wù)費(fèi)3.1.4. 擴(kuò)展字段信息遵循擴(kuò)展字段規(guī)范3.1.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：客戶(hù)下單請(qǐng)求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（客戶(hù)卡號(hào) 客戶(hù)卡號(hào) ）,checkwork ,checkwork ,checkwork ,checkwork ,checkwork （校驗(yàn)碼 校驗(yàn)碼 ）</Head> </Head> </Head> </Head><B ody>ody> ody><O rder rder rder orderid orderid orderid orderid=”訂單號(hào) ” express_type express_type express_type express_type express_type express_type =”快件類(lèi)型 快件類(lèi)型 ” j_company j_company j_company j_company j_company=” 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) 寄件方公司名稱(chēng) ” j_contact j_contactj_contact j_contact j_contact =”寄件方聯(lián)系人 寄件方聯(lián)系人 寄件方聯(lián)系人 寄件方聯(lián)系人 ” j_tel j_tel j_tel=”聯(lián)系電話(huà) 聯(lián)系電話(huà) 聯(lián)系電話(huà) ” j_address j_addressj_address j_address j_address =”寄件地址 寄件地址 ” d_company d_company d_company d_company d_company=”到件方公司名 到件方公司名 到件方公司名 到件方公司名 稱(chēng)” d_contact d_contact d_contact d_contact d_contact=”到件方聯(lián)系人 到件方聯(lián)系人 到件方聯(lián)系人 到件方聯(lián)系人 ” d_teld_tel d_tel =”聯(lián)系電話(huà) 聯(lián)系電話(huà) ” d_addressd_address d_address d_address d_address =”到件方地址 到件方地址 到件方地址 ” parce parceparce l_quantity l_quantity l_quantity l_quantity l_quantity =”包裹數(shù) 包裹數(shù) ” pay_method=pay_method= pay_method= pay_method= pay_method= pay_method= ”付款方式 付款方式 ”><O rderOptionrderOption rderOption rderOption rderOption rderOption custid= custid= custid= custid=”月結(jié)卡號(hào) 月結(jié)卡號(hào) 月結(jié)卡號(hào) ” j_shippercode=”寄件方代碼” d_deliverycode=”到件方代碼” cargo cargo cargo=”貨物名稱(chēng) 貨物名稱(chēng) ” 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=”申明價(jià)值 申明價(jià)值 申明價(jià)值 ” sendstarttime sendstarttimesendstarttime sendstarttime sendstarttime sendstarttime sendstarttime =”要求上門(mén)收件時(shí)間 要求上門(mén)收件時(shí)間 要求上門(mén)收件時(shí)間 要求上門(mén)收件時(shí)間 ” mailnomailno mailno mailno=”運(yùn)單號(hào) 運(yùn)單號(hào) ” remarkremark remark remark=”備注 ”><AddedService name= <AddedService name=<AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= <AddedService name= ”增值服務(wù) 增值服務(wù) 增值服務(wù) 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> 可有多個(gè) 可有多個(gè) -- ></OrderOptionOrderOption OrderOption OrderOption OrderOption OrderOption >value1 value1value1 value1String(30) String(30)String(30) String(30) String(30) String(30)增值 服務(wù)增值 服務(wù)增值 服務(wù)2value2 value2value2 value2String(30) String(30)String(30) String(30) String(30) String(30)增值 服務(wù)增值 服務(wù)增值 服務(wù)3value3 value3value3 value3String(30) String(30)String(30) String(30) String(30) String(30)增值 服務(wù)增值 服務(wù)增值 服務(wù)4value4 value4value4 value4String(30) String(30)String(30) String(30) String(30) String(30)增值 服務(wù)增值 服務(wù)增值 服務(wù)5BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 82013 年 06 月 01 日<Extra <Extra<Extra <Extra e1= ”擴(kuò)展字段 擴(kuò)展字段 ” e2=”擴(kuò)展字段 擴(kuò)展字段 ” e3=”擴(kuò)展字段 擴(kuò)展字段 ” e4=”擴(kuò)展字段 擴(kuò)展字段 ” e5=”擴(kuò)展字段 擴(kuò)展字段 ” e6=”擴(kuò)展字 擴(kuò)展字 段” e7=”擴(kuò)展字段 擴(kuò)展字段 ” e8= e8=”擴(kuò)展字段 擴(kuò)展字段 ” e9= e9=”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e10= e10= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e11=e11=e11= ”擴(kuò)展字段 擴(kuò)展字段 ” e12= e12= ”擴(kuò)展字 擴(kuò)展字 段” e13= e13= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e14=e14=e14= ”擴(kuò)展字段 擴(kuò)展字段 ” e1 5= ”擴(kuò)展字段 擴(kuò)展字段 ” e16= e16= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e17=e17= e17=”擴(kuò)展字段 擴(kuò)展字段 ” e18= e18=e18=”擴(kuò)展 字段 ” e19=e19= e19=”擴(kuò)展字段 擴(kuò)展字段 ” e20= e20=e20=”擴(kuò)展字段 擴(kuò)展字段 ”/></Order> </Order></Order> </Order> </Order></Body> ody></ RequestRequest Request Request >響應(yīng)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=”訂單號(hào) 訂單號(hào) ” mailno=mailno= mailno= mailno= ”主單 ,子單 1, 子單 2, …,子單 n” originCode=originCode= originCode= originCode=originCode= originCode= originCode=”原寄 地代碼 ” destCode= destCode= destCode= destCode= destCode=”目的地代碼 目的地代碼 目的地代碼 ” filter_result=”篩單結(jié)果 篩單結(jié)果 ” 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"> 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.2. 訂單發(fā)貨確認(rèn)3.2.1. 功能描述該接口用于客戶(hù)在確定將貨物交付給順豐托運(yùn)后，將運(yùn)單上的一些重要信息，如快件重量、寄件時(shí)間，通過(guò)此接口發(fā)送給順豐。3.2.2. 接口主信息定義服務(wù)名稱(chēng)OrderConfirmService批量交易限制不支持接口類(lèi)型接入協(xié)議類(lèi)型WEBSERVICE接口方法public String sfexpressService(String XML);數(shù)據(jù)元素<請(qǐng)求>OrderConfirm必要字段名類(lèi)型（約束）默認(rèn)值描述orderid rderid rderidString(64) String(64)String(64) String(64) String(64) String(64)訂單號(hào)mailno ailno ailnoString(20) String(20)String(20) String(20) String(20) String(20)運(yùn)單號(hào)數(shù)據(jù)元素<響應(yīng)>OrderConfirmResponse字段名類(lèi)型（約束）是否非空描述orderid orderidorderid orderidSt ring(64)ring(64) ring(64) ring(64) ring(64)否訂單號(hào)mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)否運(yùn)單號(hào)res_status res_statusres_status res_status res_status res_statusNumber NumberNumber Number(1)備注 1-訂單號(hào)與運(yùn)不匹配 訂單號(hào)與運(yùn)不匹配 訂單號(hào)與運(yùn)不匹配 訂單號(hào)與運(yùn)不匹配 訂單號(hào)與運(yùn)不匹配2 成功BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 92013 年 06 月 01 日3.2.3. 可選字段信息數(shù)據(jù)元素OrderConfirm/OrderConfirmOption字段名類(lèi)型（約束）描述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)托寄物的 托寄物的 長(zhǎng)，寬高以逗號(hào)分隔 長(zhǎng)，寬高以逗號(hào)分隔 長(zhǎng)，寬高以逗號(hào)分隔 長(zhǎng)，寬高以逗號(hào)分隔 長(zhǎng)，寬高以逗號(hào)分隔 長(zhǎng)，寬高以逗號(hào)分隔 ，單位 CM ，精確到小數(shù)點(diǎn) ，精確到小數(shù)點(diǎn) ，精確到小數(shù)點(diǎn) ，精確到小數(shù)點(diǎn) 1位。3.2.4. 擴(kuò)展字段信息遵循擴(kuò)展字段規(guī)范3.2.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：請(qǐng)求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（客戶(hù)卡號(hào) 客戶(hù)卡號(hào) 客戶(hù)卡號(hào) ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校驗(yàn)碼 校驗(yàn)碼 ）</Head></Head> </Head> </Head><B ody>ody> ody><Order Order OrderConfirmConfirm Confirm Confirm orderid rderid rderid =”訂單號(hào) 訂單號(hào) ” mailnoailno ailno =”運(yùn)單號(hào) ”><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=”托寄物的長(zhǎng)，寬，高”/><Extra <Extra <Extra <Extra e1 =”擴(kuò)展字段 擴(kuò)展字段 ” e2=”擴(kuò)展字段 擴(kuò)展字段 ” e3=”擴(kuò)展字段 擴(kuò)展字段 ” e4=”擴(kuò)展字段 擴(kuò)展字段 ” e5=”擴(kuò)展字段 擴(kuò)展字段 ” e6=”擴(kuò)展字 擴(kuò)展字 段” e7=”擴(kuò)展字段 擴(kuò)展字段 ” e8= ”擴(kuò)展字段 擴(kuò)展字段 ” e9= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e10=10= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e11=11= ”擴(kuò)展字段 擴(kuò)展字段 ” e12=12= ”擴(kuò)展字 擴(kuò)展字 段” e13=13= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e14=14= ”擴(kuò)展字段 擴(kuò)展字段 ” e15=15= ”擴(kuò)展字段 擴(kuò)展字段 ” e16=16= ”擴(kuò)展字段 擴(kuò)展字段 擴(kuò)展字段 ” e17= 17=”擴(kuò)展字段 擴(kuò)展字段 ” e18= ”擴(kuò)展 字段 ” e19= 19=”擴(kuò)展字段 擴(kuò)展字段 ” e20= 20=”擴(kuò)展字段 擴(kuò)展字段 ”/></Order /Order /Order Confirm Confirm Confirm Confirm></Body>Body> Body></ RequestRequest Request Request >響應(yīng)XML：訂單確認(rèn)成功： 訂單確認(rèn)成功： 訂單確認(rèn)成功：<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= ”訂單號(hào) 訂單號(hào) ” mailno= mailno=mailno= mailno= ”運(yùn)單號(hào)” remark= remark= remark= remark=”備注 ”/></Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>訂單 確認(rèn) 失�。� 失�。�<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"> 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 102013 年 06 月 01 日3.3. 訂單篩選3.3.1. 功能描述客戶(hù)系統(tǒng)通過(guò)此接口向順豐企業(yè)服務(wù)平臺(tái)發(fā)送自動(dòng)篩單請(qǐng)求，用于判斷客戶(hù)的收、派地址是否屬于順豐的收派范圍。系統(tǒng)會(huì)根據(jù)收派雙方的地址自動(dòng)判斷是否在順豐的收派范圍內(nèi)。如果屬于范圍內(nèi)則返回可收派，否則返回不可收派。3.3.2. 接口主信息定義服務(wù)名稱(chēng)OrderFilterService批量交易限制<=5筆接口類(lèi)型接入協(xié)議類(lèi)型WEBSERVICE接口方法public String sfexpressService(String XML);數(shù)據(jù)元素<請(qǐng)求>OrderFilter必要字段名類(lèi)型（約束）默認(rèn)值描述filter_type filter_typefilter_type filter_type filter_type filter_typeNumber NumberNumber Number(1)(1)1篩單類(lèi)別： 篩單類(lèi)別： 1-自動(dòng)篩單（系統(tǒng)根據(jù) 自動(dòng)篩單（系統(tǒng)根據(jù) 自動(dòng)篩單（系統(tǒng)根據(jù) 自動(dòng)篩單（系統(tǒng)根據(jù) 自動(dòng)篩單（系統(tǒng)根據(jù) 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 地址庫(kù)進(jìn)行判斷，并返回結(jié)果）， 2-可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 可人工篩單（系統(tǒng)首先根據(jù)地址庫(kù) 判斷，如果無(wú)法自動(dòng)是否收 判斷，如果無(wú)法自動(dòng)是否收 判斷，如果無(wú)法自動(dòng)是否收 判斷，如果無(wú)法自動(dòng)是否收 判斷，如果無(wú)法自動(dòng)是否收 判斷，如果無(wú)法自動(dòng)是否收 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 派，系統(tǒng)將生成需要人工判斷的任 務(wù)，后續(xù)由人工處理 務(wù)，后續(xù)由人工處理 務(wù)，后續(xù)由人工處理 務(wù)，后續(xù)由人工處理 ，處理結(jié)束 ，處理結(jié)束 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) 后，順豐可主動(dòng)推送給客戶(hù)系統(tǒng) ）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 ， 則必須提供 則必須提供客戶(hù) 訂單號(hào) 訂單號(hào)d_address d_addressd_address d_address d_addressString StringString String(150)(150) (150)到件方詳細(xì)地址， 到件方詳細(xì)地址， 到件方詳細(xì)地址， 到件方詳細(xì)地址， 需要包括省市 需要包括省市 需要包括省市 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 區(qū)，如：廣東省深圳市福田新洲 十一街萬(wàn)基商務(wù)大廈。 十一街萬(wàn)基商務(wù)大廈。 十一街萬(wàn)基商務(wù)大廈。 十一街萬(wàn)基商務(wù)大廈。 十一街萬(wàn)基商務(wù)大廈。數(shù)據(jù)元素<響應(yīng)>OrderFilterResponse字段名類(lèi)型（約束）是否非空描述orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)訂單號(hào) ，如果需要順豐提供人工篩 ，如果需要順豐提供人工篩 單，需要提供此項(xiàng)值 單，需要提供此項(xiàng)值 單，需要提供此項(xiàng)值 單，需要提供此項(xiàng)值filter ilter ilter_r esultesult esultNumber(2) Number(2)Number(2) Number(2) Number(2)否篩單結(jié)果： 篩單結(jié)果： 篩單結(jié)果： 篩單結(jié)果： 篩單結(jié)果： 1-人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 人工確認(rèn)， 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)目的地代碼 ,如果可收派，此項(xiàng)不能 為空remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范圍， 2-派方超范圍， 3-其他原因 其他原因3.3.3. 可選字段信息數(shù)據(jù)元素OrderFilter/OrderFilterOption字段名類(lèi)型（約束）默認(rèn)值描述j_telString(20)寄件方電話(huà)countryString (50)CN寄件人所在國(guó)家BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 112013 年 06 月 01 日provinceString (30)寄件人所在省份，必須是標(biāo)準(zhǔn)的省名稱(chēng)稱(chēng)謂，示例：“廣東省”（省字不要省略）cityString (100)寄件方所屬城市名稱(chēng)，必須是標(biāo)準(zhǔn)的城市稱(chēng)謂，示例：“深圳市”（市字不要省略）countyString (30)寄件人所在縣/區(qū)，必須是標(biāo)準(zhǔn)的縣/區(qū)稱(chēng)謂，示例：“福田區(qū)”（區(qū)字不要省略）d_countryString(50)CN到件方國(guó)家d_provinceString (30)到件方所在省份，必須是標(biāo)準(zhǔn)的省名稱(chēng)稱(chēng)謂，示例：“廣東省”（省字不要省略）d_cityString (100)到件方所屬城市名稱(chēng)，必須是標(biāo)準(zhǔn)的城市稱(chēng)謂，示例：“深圳市”（市字不要省略）d_countyString (30)到件方所在縣/區(qū)，必須是標(biāo)準(zhǔn)的縣/區(qū)稱(chēng)謂，示例：“福田區(qū)”（區(qū)字不要省略）j_addressString(150)寄件方詳細(xì)地址，示例：“廣東省深圳市福田區(qū)新洲十一街萬(wàn)基商務(wù)大廈10樓”d_telString(23)到件方電話(huà)3.3.4. 擴(kuò)展字段信息無(wú)。3.3.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：請(qǐng)求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（客戶(hù)卡號(hào) 客戶(hù)卡號(hào) ）,checkwork ,checkwork ,checkwork ,checkwork ,checkwork （校驗(yàn)碼 校驗(yàn)碼 ）</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 =”篩單類(lèi)別 篩單類(lèi)別 ” orderid orderidorderid orderidorderid=”訂單號(hào) 訂單號(hào) ” 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 =”寄件方電話(huà) 寄件方電話(huà) 寄件方電話(huà) ” j_addressj_addressj_address j_addressj_address j_address =”寄件方地址 寄件方地址 寄件方地址 ” d_tel d_teld_tel =”到件方電話(huà) 到件方電話(huà) 到件方電話(huà) ”/></ OrderFilter rderFilter rderFilter rderFilter rderFilter ><! -- ...... // 最多包括 最多包括 5個(gè)<OrderFiler OrderFiler OrderFiler OrderFiler OrderFiler >-- ></Body>Body> Body></ RequestRequest Request Request >響應(yīng)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 =”訂單號(hào) 訂單號(hào) ” filter_result=”是否可收派 是否可收派 是否可收派 ” originorigin origin origincode ode=”原寄地 原寄地 代碼 ” destdest destcode ode=”目的地代碼 目的地代碼 目的地代碼 ” remark remark remark =”備注 ”/>...</Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 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">錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.4. 人工篩選結(jié)果推送3.4.1. 功能描述如果客戶(hù)通過(guò)訂單篩選接口得到的反饋結(jié)果為：3-待確認(rèn)時(shí)，如果訂單篩選時(shí)，提供了訂單號(hào)且apply_type=2，當(dāng)完成人工篩單時(shí)，順豐系統(tǒng)將人工篩單的結(jié)果推送給客戶(hù)系統(tǒng)。請(qǐng)客戶(hù)系統(tǒng)提供一個(gè)符合以下規(guī)范的HTTP URL，以便順豐向客戶(hù)系統(tǒng)推送人工篩單數(shù)據(jù)。1）順豐以HTTP POST的方式向客戶(hù)系統(tǒng)推送數(shù)據(jù)。2）請(qǐng)求方法的編碼格式：“application/x-www-form-urlencoded; charset=UTF-8”3）推送的篩單結(jié)果以XML格式，通過(guò)POST方式發(fā)送給客戶(hù)系統(tǒng)。4）一個(gè)POST方法最多推送5條篩單數(shù)據(jù)。5）對(duì)xml內(nèi)容進(jìn)行URL編碼（字符集為UTF-8）。6）客戶(hù)系統(tǒng)在接收到請(qǐng)求后，需要先對(duì)收到的內(nèi)容進(jìn)行URL解碼，得到相應(yīng)的XML。然后從XML中獲取相應(yīng)的篩單數(shù)據(jù)。7）在客戶(hù)系統(tǒng)正確處理XML信息后，向順豐返回響應(yīng)信息，考慮到處理的效率，篩單推送認(rèn)為批量成功或失敗。3.4.2. 接口主信息定義服務(wù)名稱(chēng)OrderFilterPushService批量交易限制<=5筆接口類(lèi)型推送協(xié)議類(lèi)型HTTP接口方法無(wú)數(shù)據(jù)元素<請(qǐng)求>OrderFilterResult必要字段名類(lèi)型（約束）默認(rèn)值描述orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)訂單號(hào) ，如果需要順豐提供人 ，如果需要順豐提供人 工篩單，需要提供此項(xiàng)值 工篩單，需要提供此項(xiàng)值 工篩單，需要提供此項(xiàng)值 工篩單，需要提供此項(xiàng)值 工篩單，需要提供此項(xiàng)值filter ilter ilter_resultesult esultNumber(2) Number(2)Number(2) Number(2) Number(2)否篩單結(jié)果： 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)目的地代碼 ,如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 如果可收派，此 項(xiàng)不能為空 項(xiàng)不能為空remark remarkremark remarkString(100) String(100)String(100) String(100) String(100) String(100)1-收方超范圍， 收方超范圍， 收方超范圍， 收方超范圍， 收方超范圍， 收方超范圍， 2-派方超范 派方超范 派方超范 派方超范 圍， 3-其他原因 其他原因 其他原因mailno mailnomailno mailnoString( String(String( String( 30 )運(yùn)單號(hào)數(shù)據(jù)元素<響應(yīng)>OrderFilterResultResponse字段名類(lèi)型（約束）是否非空描述orderid orderidorderid orderidString( String(String( String( 4000 4000 )否成功接收的人工篩單 訂單號(hào) 訂單號(hào) ， 如果有多個(gè)訂單號(hào)，以逗分 如果有多個(gè)訂單號(hào)，以逗分 隔，如 ”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)未成功接收的人工篩單 訂未成功接收的人工篩單 訂號(hào)，如果有多個(gè)訂單以逗 號(hào)，如果有多個(gè)訂單以逗BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 132013 年 06 月 01 日號(hào)分隔，如 號(hào)分隔，如 號(hào)分隔，如 號(hào)分隔，如 號(hào)分隔，如 ”123,124 123,124 123,124 123,124” ，這 部分訂單的篩數(shù)據(jù)順豐會(huì)定 部分訂單的篩數(shù)據(jù)順豐會(huì)定 時(shí)重發(fā)。 時(shí)重發(fā)。3.4.3. 可選字段信息無(wú)3.4.4. 擴(kuò)展字段信息無(wú)3.4.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：請(qǐng)求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 =”訂單號(hào) 訂單號(hào) ” filter_result=”是否可收派 是否可收派 是否可收派 是否可收派 ” origin origin origin codeode =”原寄地代 原寄地代 碼” destCode destCode destCode destCode =”目的地代碼 目的地代碼 目的地代碼 ” remarkremark remark remark=”備注 ”/><! -- ...//...// ...// 最多包括 最多包括 5個(gè)<OrderFilter OrderFilter OrderFilter OrderFilter OrderFilter OrderFilterResult>Result> Result> Result> -- ></Body> </Body></Body> </Body></Re </Re</Requestquest quest >響應(yīng)XML：成功響應(yīng)： 成功響應(yīng)：<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>失敗響應(yīng) 失敗響應(yīng) ：<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 "> 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.5. 路由查詢(xún)3.5.1. 功能描述提供客戶(hù)系統(tǒng)通過(guò)接口查詢(xún)客戶(hù)通過(guò)順豐承運(yùn)的運(yùn)單路由的功能，支持單個(gè)或批量運(yùn)單路由查詢(xún)的功能，批量查詢(xún)中，最多不能超過(guò)10個(gè)運(yùn)單號(hào)。同一批次，只允許查詢(xún)同一種語(yǔ)言的運(yùn)單路由。BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 142013 年 06 月 01 日路由查詢(xún)接口支持兩類(lèi)查詢(xún)方式：1） 根據(jù)運(yùn)單號(hào)查詢(xún)：查詢(xún)請(qǐng)求中提供客戶(hù)卡號(hào)與運(yùn)單號(hào)，系統(tǒng)將驗(yàn)證客戶(hù)卡號(hào)與所有請(qǐng)求運(yùn)單號(hào)的歸屬關(guān)系，系統(tǒng)只返回具有正確歸屬關(guān)系的運(yùn)單路由信息。2） 根據(jù)訂單號(hào)查詢(xún)：查詢(xún)請(qǐng)求中提供客戶(hù)卡號(hào)與訂單號(hào)，系統(tǒng)將驗(yàn)證客戶(hù)卡號(hào)與所有請(qǐng)求訂單號(hào)的歸屬關(guān)系，對(duì)于歸屬關(guān)系正確的訂單號(hào)，找到對(duì)應(yīng)的運(yùn)單號(hào)，然后返回訂單對(duì)應(yīng)運(yùn)單號(hào)的路由信息。適用于通過(guò)企業(yè)服務(wù)平臺(tái)下發(fā)過(guò)訂單的客戶(hù)。3.5.2. 接口主信息定義服務(wù)名稱(chēng)RouteService批量交易限制<=10筆接口類(lèi)型接入協(xié)議類(lèi)型WEBSERVICE接口方法public String sfexpressService(String xml);數(shù)據(jù)元素<請(qǐng)求>RouteRequest必要字段名類(lèi)型（約束）默認(rèn)值描述tracking_type tracking_typetracking_type tracking_type tracking_type tracking_type tracking_typeNumber(2) Number(2)Number(2) Number(2) Number(2)1查詢(xún)類(lèi)別 查詢(xún)類(lèi)別 , tracking_typetracking_type tracking_type tracking_type tracking_type tracking_typetracking_type tracking_type字段說(shuō)明： 字段說(shuō)明： 1-根據(jù)運(yùn)單號(hào)查 根據(jù)運(yùn)單號(hào)查 根據(jù)運(yùn)單號(hào)查 根據(jù)運(yùn)單號(hào)查 詢(xún)， orderorder order 節(jié)點(diǎn)中 節(jié)點(diǎn)中 track_number track_numbertrack_number track_number track_number track_number track_number將被當(dāng)作運(yùn)單 將被當(dāng)作運(yùn)單 將被當(dāng)作運(yùn)單 將被當(dāng)作運(yùn)單 號(hào)處理， 號(hào)處理， 2-根據(jù)訂單號(hào)查詢(xún)， 根據(jù)訂單號(hào)查詢(xún)， 根據(jù)訂單號(hào)查詢(xún)， 根據(jù)訂單號(hào)查詢(xún)， 根據(jù)訂單號(hào)查詢(xún)， order orderorder 節(jié)點(diǎn)中 節(jié)點(diǎn)中 track_number track_numbertrack_number track_number track_number track_number track_number將被當(dāng)作訂單 將被當(dāng)作訂單 將被當(dāng)作訂單 將被當(dāng)作訂單 號(hào)處理track tracktrack ing ing_n umberumber umberString StringString String(4000 4000 )查詢(xún)號(hào) , 如果 tracking_type=1 tracking_type=1tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 tracking_type=1 ，則此值 ，則此值 為運(yùn)單號(hào)。如果 為運(yùn)單號(hào)。如果 為運(yùn)單號(hào)。如果 tracking_type=2 tracking_type=2tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 tracking_type=2 ，則此值 ，則此值 為訂單號(hào) 為訂單號(hào)如果有多個(gè)單號(hào)，以逗分 如果有多個(gè)單號(hào)，以逗分 如果有多個(gè)單號(hào)，以逗分 如果有多個(gè)單號(hào)，以逗分 如果有多個(gè)單號(hào)，以逗分 如果有多個(gè)單號(hào)，以逗分 隔，如 ”123,124,125123,124,125 123,124,125 123,124,125 123,124,125 123,124,125 ”數(shù)據(jù)元素<響應(yīng)>RouteResponse字段名類(lèi)型（約束）是否非空描述mailno mailnomailno mailnoString(20) String(20)String(20) String(20) String(20) String(20)否運(yùn)單號(hào)orderid orderidorderid orderidString(64) String(64)String(64) String(64) String(64) String(64)訂單號(hào)數(shù)據(jù)元素<響應(yīng)>RouteResponse/Route字段名類(lèi)型（約束）是否非空描述accept ccept ccept_timeimeDate DateDate否路由發(fā)生的時(shí)間 路由發(fā)生的時(shí)間 路由發(fā)生的時(shí)間accept ccept ccept_addressddress ddress ddressString(100) String(100)String(100) String(100) String(100) String(100)否路由發(fā)生的地點(diǎn) 路由發(fā)生的地點(diǎn) 路由發(fā)生的地點(diǎn)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. 可選字段信息無(wú)BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 152013 年 06 月 01 日3.5.4. 擴(kuò)展字段信息無(wú)3.5.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：根據(jù)運(yùn)單號(hào)查詢(xún)請(qǐng)求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（客戶(hù)卡號(hào) 客戶(hù)卡號(hào) 客戶(hù)卡號(hào) ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校驗(yàn)碼 校驗(yàn)碼 ）</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=”查詢(xún)類(lèi)別 查詢(xún)類(lèi)別 查詢(xún)類(lèi)別 ” tracking_number tracking_numbertracking_number tracking_number tracking_number tracking_number tracking_number tracking_number =”單號(hào) 1,單號(hào) 2,…,單號(hào) n”/></Body>Body> Body></ RequestRequest Request Request >響應(yīng)XML：路由查詢(xún)成功： 路由查詢(xún)成功： 路由查詢(xún)成功：<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=”運(yùn)單號(hào) 運(yùn)單號(hào) ” orderid= orderid= orderid= orderid= ”訂單號(hào) 訂單號(hào) ”><R oute oute oute accept_time=”路由發(fā)生時(shí)間 路由發(fā)生時(shí)間 路由發(fā)生時(shí)間 ” accept_address=”路由發(fā)生地點(diǎn) 路由發(fā)生地點(diǎn) 路由發(fā)生地點(diǎn) 路由發(fā)生地點(diǎn) ” remark remark remark =”詳細(xì)說(shuō)明 詳細(xì)說(shuō)明 ” opCode= opCode=opCode= opCode= ”操作碼 操作碼 ”/><! -- ...... // 可包括多個(gè) 可包括多個(gè) 可包括多個(gè) <Route> oute>oute> -- ></ RouteResponseRouteResponse RouteResponse RouteResponse RouteResponse RouteResponse RouteResponse ><! -- ...... // 最多包括 最多包括 10個(gè)<RouteResponseRouteResponse RouteResponse RouteResponse RouteResponse RouteResponse RouteResponse >-- ></Body> </Body></Body> </Body></Response> </Response></Response> </Response> </Response> </Response>路由查詢(xún) 路由查詢(xún) 失�。� 失�。�<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 "> 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>失敗響應(yīng)： 失敗響應(yīng)：<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 "> 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 錯(cuò)誤詳細(xì)信息 </ERROR></ERROR> </ERROR> </ERROR> </ERROR></Response> </Response></Response> </Response> </Response> </Response>3.6. 路由推送3.6.1. 功能描述BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 162013 年 06 月 01 日該接口用于向客戶(hù)系統(tǒng)定時(shí)推送運(yùn)單的路由信息。需要客戶(hù)系統(tǒng)提供一個(gè)符合以下規(guī)范的HTTP URL，以便順豐向客戶(hù)系統(tǒng)推送路由數(shù)據(jù)。推送方式為增量推送，對(duì)于同一個(gè)運(yùn)單的路由，不重復(fù)推送。1） 順豐以HTTP POST的方式向客戶(hù)系統(tǒng)推送數(shù)據(jù)。2） 請(qǐng)求方法的編碼格式：“application/x-www-form-urlencoded; charset=UTF-8”3） 推送的路由數(shù)據(jù)以XML格式，通過(guò)POST方式發(fā)送給客戶(hù)系統(tǒng)。4） 一個(gè)POST方法最多推送10條路由數(shù)據(jù)。5） 對(duì)xml內(nèi)容進(jìn)行URL編碼（字符集為UTF-8）。6） 客戶(hù)系統(tǒng)在接收到請(qǐng)求后，需要先對(duì)收到的內(nèi)容進(jìn)行URL解碼，得到相應(yīng)的XML。然后從XML中獲取相應(yīng)的路由信息。在客戶(hù)系統(tǒng)正確處理XML信息后，向順豐返回響應(yīng)信息，考慮到處理的效率，路由推送認(rèn)為批量成功或失敗。3.6.2. 接口主信息定義服務(wù)名稱(chēng)RoutePushService批量交易限制<=10筆接口類(lèi)型推送協(xié)議類(lèi)型HTTP接口方法無(wú)數(shù)據(jù)元素<請(qǐng)求>WaybillRoute必要字段名類(lèi)型（約束）默認(rèn)值描述idNumber(15)路由編號(hào)，每一個(gè)id代表一條不同的路由mailnoString(20)否運(yùn)單號(hào)orderidString(64)訂單號(hào)accept_timeDate否路由產(chǎn)生時(shí)間accept_addressString(100)否路由發(fā)生城市remarkString(300)否路由說(shuō)明opcodeString(20)操作碼數(shù)據(jù)元素<響應(yīng)>WaybillRouteResponse字段名類(lèi)型（約束）是否非空描述idString(4000)否成功接收的路由編號(hào)，如果有多個(gè)路由編號(hào)，以逗號(hào)分隔，如“123,124,125“id_errorString(4000)否未成功接收的路由編號(hào)，如果有多個(gè)路由編號(hào)，以逗號(hào)分隔，如“123,124,125“，這部分路由編號(hào)，順豐會(huì)定時(shí)重發(fā)3.6.3. 可選字段信息無(wú)BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 172013 年 06 月 01 日3.6.4. 擴(kuò)展字段信息無(wú)3.6.5. 應(yīng)用場(chǎng)景XML實(shí)例. 場(chǎng)景1場(chǎng)景描述：請(qǐng)求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（客戶(hù)卡號(hào) 客戶(hù)卡號(hào) 客戶(hù)卡號(hào) ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校驗(yàn)碼 校驗(yàn)碼 ）</Head></Head> </Head> </Head><B ody>ody> ody><WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute <WaybillRoute id=id= ”路由編號(hào) 路由編號(hào) ” mailno=mailno= mailno= mailno= ”運(yùn)單號(hào) 運(yùn)單號(hào) ” orderid=orderid= orderid= orderid= orderid=”訂單號(hào) 訂單號(hào) ” accept_time=”路由發(fā)生時(shí) 路由發(fā)生時(shí) 間” accept_address=”路由發(fā)生地點(diǎn) 路由發(fā)生地點(diǎn) 路由發(fā)生地點(diǎn) ” remark remark remark =”詳細(xì)說(shuō)明 詳細(xì)說(shuō)明 詳細(xì)說(shuō)明 ” opcode=”操作碼 ”/><! -- //...//... //... 最多 10 個(gè)<Waybill<Waybill<Waybill <Waybill<Waybill <WaybillRoute>Route> Route> Route>-- ></Body>Body> Body></ RequestRequest Request Request >響應(yīng)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. 原因代碼表原因代碼描述分類(lèi) 61** 缺少必要參數(shù)6101請(qǐng)求數(shù)據(jù)缺少必選項(xiàng)缺少必要參數(shù)6102寄件方公司名稱(chēng)為空關(guān)鍵字段校驗(yàn)不合法6103寄方聯(lián)系人為空6104寄方所在省為空6105寄方所在城市為空6106寄件方詳細(xì)地址為空6107到件方公司名稱(chēng)為空6108到件方聯(lián)系人為空6109到件方所在省為空6110到件方所在城市為空6111到件方地址為空6112到件方國(guó)家不能為空6113到件方所在省份不能為空6114必須提供客戶(hù)訂單號(hào)6115到件方所屬城市名稱(chēng)不能為空BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 182013 年 06 月 01 日6116到件方所在縣/區(qū)不能為空6117到件方詳細(xì)地址不能為空6118訂單號(hào)不能為空6119到件方聯(lián)系電話(huà)不能為空6120快遞類(lèi)型不能為空6121寄件方聯(lián)系電話(huà)不能為空6122篩單類(lèi)別不合法6123運(yùn)單號(hào)不能為空6124付款方式不能為空6125需生成電子運(yùn)單,貨物名稱(chēng)等不能為空6126月結(jié)卡號(hào)不合法6127增值服務(wù)名不能為空6128增值服務(wù)名不合法8*** 功能校驗(yàn)8000報(bào)文 參數(shù)不合法參數(shù)無(wú)效8001IP未授權(quán)參數(shù)無(wú)效8002服務(wù)（功能）未授權(quán)8003查詢(xún)單號(hào)超過(guò)最大限制8004路由查詢(xún)條數(shù)超限制8005查詢(xún)次數(shù)超限制8006已下單，無(wú)法接收訂單確認(rèn)請(qǐng)求8007此訂單已經(jīng)確認(rèn)，無(wú)法接收訂單確認(rèn)請(qǐng)求8008此訂單人工篩單還未確認(rèn)，無(wú)法接收訂單確認(rèn)請(qǐng)求8009此訂單不可收派, 無(wú)法接收訂單確認(rèn)請(qǐng)求。8010此訂單未篩單, 無(wú)法接收訂單確認(rèn)請(qǐng)求。8011不存在該客戶(hù)卡號(hào)與運(yùn)單號(hào)綁定關(guān)系8012不存在該客戶(hù)卡號(hào)與訂單號(hào)綁定關(guān)系8013未傳入查詢(xún)單號(hào)8014校驗(yàn)碼錯(cuò)誤8015未傳入運(yùn)單號(hào)信息8016重復(fù)下單8017訂單號(hào)與運(yùn)單號(hào)不匹配8018未獲取到訂單信息8019訂單已確認(rèn)8020不存在該訂單跟運(yùn)單綁定關(guān)系BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范順豐集團(tuán)資訊科技本部研發(fā)中心 192013 年 06 月 01 日8021客戶(hù)卡號(hào)為空8022校驗(yàn)碼為空8023服務(wù)名為空8024未下單8025未傳入服務(wù)或不提供該服務(wù)8026不存在的客戶(hù)8027不存在的業(yè)務(wù)模板8028客戶(hù)未配置此業(yè)務(wù)8029客戶(hù)未配置默認(rèn)模板8030未找到這個(gè)時(shí)間的合法模板8031數(shù)據(jù)錯(cuò)誤，未找到模板8032數(shù)據(jù)錯(cuò)誤，未找到業(yè)務(wù)配置8033數(shù)據(jù)錯(cuò)誤，未找到業(yè)務(wù)屬性8034重復(fù)注冊(cè)人工篩單結(jié)果推送8035生成電子運(yùn)單，必須存在運(yùn)單號(hào)8036注冊(cè)路由推送必須存在運(yùn)單號(hào)4*** 系統(tǒng)校驗(yàn)4001系統(tǒng)發(fā)生數(shù)據(jù)錯(cuò)誤或運(yùn)行時(shí)異常4002報(bào)文解析錯(cuò)誤世聯(lián)翻譯-讓世界自由溝通！專(zhuān)業(yè)的全球語(yǔ)言翻譯供應(yīng)商，上海翻譯公司專(zhuān)業(yè)品牌。絲路沿線(xiàn)56種語(yǔ)言一站式翻譯與技術(shù)解決方案，專(zhuān)業(yè)英語(yǔ)翻譯、日語(yǔ)翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國(guó)外派服務(wù)，加速您的全球交付。 世聯(lián)翻譯公司在北京、上海、深圳等國(guó)際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國(guó)城市。每天有近百萬(wàn)字節(jié)的信息和貿(mào)易通過(guò)世聯(lián)走向全球！積累了大量政商用戶(hù)數(shù)據(jù)，翻譯人才庫(kù)數(shù)據(jù)，多語(yǔ)種語(yǔ)料庫(kù)大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國(guó)際組織、跨國(guó)公司和大中型企業(yè)等近萬(wàn)用戶(hù)的認(rèn)可。
