穿越小说完本,将夜猫腻小说

上海翻譯公司完成平臺(tái)接入技術(shù)規(guī)范中文翻譯

時(shí)間:2018-09-17 08:56 來源:未知作者:dl 點(diǎn)擊:次

上海翻譯公司完成平臺(tái)接入技術(shù)規(guī)范中文翻譯

1. 前言

本文檔目的是定義BSP企業(yè)服務(wù)平臺(tái)的通用對(duì)外服務(wù)接口，以便快速集成大客戶自有的系統(tǒng)，從而打通大客戶與順豐系統(tǒng)之間的信息流，實(shí)現(xiàn)整體物流供應(yīng)鏈的一體化，進(jìn)而達(dá)到順豐與客戶的雙贏。

2. 接口規(guī)范說明接口規(guī)范說明

通用對(duì)外服務(wù)接口統(tǒng)一使用UTF-8編碼的XML報(bào)文，接口通信協(xié)議支持WEBSERVICE、HTTP/POST、FTP三種協(xié)議，當(dāng)前主要使用WEBSERVICE協(xié)議方式。

通用對(duì)外服務(wù)接口分為主動(dòng)接入與對(duì)外推送兩類接口，基于FTP協(xié)議的對(duì)外推送類接口無需對(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>

關(guān)鍵規(guī)則：

a) service 屬性與HEAD元素預(yù)先定義了服務(wù)名，客戶卡號(hào)及檢驗(yàn)碼，結(jié)合請(qǐng)求的客戶IP地址可以滿足只要通過預(yù)解析HEAD元素就能夠進(jìn)行系統(tǒng)功能權(quán)限的驗(yàn)證，無功能權(quán)限情況下無需進(jìn)一步解析Body內(nèi)部數(shù)據(jù)，大大提高了攔截非法訪問的性能；

b) 客戶卡號(hào)與校驗(yàn)碼統(tǒng)一使用順豐分配的客戶卡號(hào)與校驗(yàn)碼；

c) lang屬性用于支持國際化請(qǐng)求，缺省值為zh-CN。

. 響應(yīng)報(bào)文：

</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ā)中心 4

2013 年 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)行分開定義的原則，同時(shí)字段盡量通過元素的屬性進(jìn)行定義，字段值限制在200字符以下（50個(gè)漢字以下）；必要字段使用數(shù)據(jù)元素本身的屬性進(jìn)行定義，可選項(xiàng)字段在數(shù)據(jù)元素下定義“數(shù)據(jù)元素名+Option”元素并通過其屬性進(jìn)行定義，擴(kuò)展字段使用數(shù)據(jù)元素下保留元素<Extra>的屬性進(jìn)行定義；必要字段的數(shù)目盡量控制在10個(gè)以下；如：

</Order>

OrderOption元素的屬性及值由具體的業(yè)務(wù)數(shù)據(jù)定義；Extra 元素最大支持20個(gè)屬性，屬性名為e1,…,e20,只支持字符串值。

. 盡量通過客戶個(gè)性化服務(wù)配置的方式減少接口報(bào)文需要傳遞的字段量，如在訂單報(bào)文中加入發(fā)貨點(diǎn)代碼的方式，可以在后臺(tái)基于客戶+發(fā)貨點(diǎn)代碼的方式配置月結(jié)賬號(hào)等等數(shù)據(jù)，避免在接口報(bào)文中傳遞附加的月結(jié)賬號(hào)。

. 請(qǐng)求與響應(yīng)報(bào)文元素命名采用大寫字母開頭的單詞序列，如“OrderResponse”；屬性名統(tǒng)一使用小寫，如“orderid”；子元素在定義表格中一律使用“/”徑表示，如“outeTrackingResponse/Route”；

通用對(duì)外服務(wù)接口當(dāng)前已經(jīng)定義了快遞類服務(wù)接口，其參考地址參見：

Http://bsp-oip/sf-express.com/bsp-ois/ws/expressService

3. 快遞類服務(wù) 遞類服務(wù) 接口

3.1. 下訂單（含篩選）

3.1.1. 功能描述

下單接口根據(jù)客戶需要，可提供以下三個(gè)功能：

1）客戶系統(tǒng)向順豐下發(fā)訂單。

2）為訂單分配運(yùn)單號(hào)。

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 5

2013 年 06 月 01 日

3）篩單。

3.1.2. 接口主信息定義

服務(wù)名稱

OrderService

批量交易限制

不支持

接口類型

接入

協(xié)議類型

WEBSERVICE

接口方法

public String sfexpressService(String XML);

數(shù)據(jù)元素<請(qǐng)求>

Order

必要字段名

類型（約束）

默認(rèn)值

描述

order rder id

String(64) String(64)String(64) String(64) String(64) String(64)

客戶訂單號(hào)，訂單號(hào)，訂單號(hào)，訂單號(hào)，建議英文字母英文字母英文字母英文字母 +YYMMDD +YYMMDD +YYMMDD +YYMMDD（日期） +流水號(hào)，如：流水號(hào)，如：流水號(hào)，如： TB1207300000001 TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001TB1207300000001 TB1207300000001 TB1207300000001 TB1207300000001

express_type express_typeexpress_type express_type express_type express_type express_type

String( String(String( String( 5)

標(biāo)準(zhǔn)快遞標(biāo)準(zhǔn)快遞

快件產(chǎn)品類別快件產(chǎn)品類別快件產(chǎn)品類別

1標(biāo)準(zhǔn)快遞標(biāo)準(zhǔn)快遞

2順豐特惠順豐特惠

j_company j_companyj_company j_company j_company

String(100) String(100)String(100) String(100) String(100) String(100)

_SYSTEM _SYSTEM_SYSTEM _SYSTEM

寄件方公司名稱寄件方公司名稱寄件方公司名稱寄件方公司名稱寄件方公司名稱寄件方公司名稱寄件方公司名稱 , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不提如果不提如果不提如果不提供，將從系統(tǒng)配置獲取從系統(tǒng)配置獲取從系統(tǒng)配置獲取從系統(tǒng)配置獲取

j_contact j_contactj_contact j_contact j_contact

String(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_tel

String(2 String(2String(2 String(2 String(20)

_SYSTEM _SYSTEM_SYSTEM _SYSTEM

寄件方聯(lián)系電話寄件方聯(lián)系電話寄件方聯(lián)系電話寄件方聯(lián)系電話寄件方聯(lián)系電話寄件方聯(lián)系電話寄件方聯(lián)系電話 , _SYSTEM _SYSTEM _SYSTEM _SYSTEM表示如果不表示如果不表示如果不表示如果不表示如果不提供，將從系統(tǒng)配置獲取供，將從系統(tǒng)配置獲取供，將從系統(tǒng)配置獲取供，將從系統(tǒng)配置獲取供，將從系統(tǒng)配置獲取

j_address j_addressj_address j_address j_address

String(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ù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈新洲十一街萬基商務(wù)大廈 10 樓” , _SYSTEM_SYSTEM _SYSTEM _SYSTEM 表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系表示如果不提供，將從系統(tǒng)配置獲取統(tǒng)配置獲取

d_company _company _company _company

String(100) String(100)String(100) String(100) String(100) String(100)

到件方公司名稱到件方公司名稱到件方公司名稱

d_contact d_contactd_contact d_contact d_contact

String(30) String(30)String(30) String(30) String(30) String(30)

到件方聯(lián)系人到件方聯(lián)系人到件方聯(lián)系人

d_tel d_teld_tel

String(2 String(2String(2 String(2 String(20)

到件方聯(lián)系電話到件方聯(lián)系電話到件方聯(lián)系電話

d_address d_addressd_address d_address d_address

String(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ù)大新洲十一街萬基商務(wù)大新洲十一街萬基商務(wù)大新洲十一街萬基商務(wù)大新洲十一街萬基商務(wù)大廈10 樓”

parcel_quantity parcel_quantityparcel_quantity parcel_quantity parcel_quantity parcel_quantity parcel_quantity parcel_quantity

Number(5) Number(5)Number(5) Number(5) Number(5)

包裹數(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_method

Number 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_province

String StringString String(30)

_SYSTEM _SYSTEM_SYSTEM _SYSTEM

寄件方所在省份字段填寫要求：必須是標(biāo)準(zhǔn)的省名稱謂省名稱謂如：廣東省如：廣東省如：廣東省

j_city j_cityj_city j_city

String StringString String(100)(100) (100)

_SYSTEM _SYSTEM_SYSTEM _SYSTEM

寄件方所屬城寄件方所屬城寄件方所屬城市名稱市名稱

字段填寫要求：必須是標(biāo)準(zhǔn)的城市稱謂字段填寫要求：必須是標(biāo)準(zhǔn)的城市稱謂字段填寫要求：必須是標(biāo)準(zhǔn)的城市稱謂如：深圳市

d_province d_provinced_province d_province d_province d_province

String StringString String(30)

到件方所在省份字段填寫要求：必須是標(biāo)準(zhǔn)的省名稱謂省名稱謂如：廣東省如：廣東省如：廣東省

d_city d_cityd_city d_city

String StringString String(100)(100) (100)

到件方所屬城市名稱件方所屬城市名稱件方所屬城市名稱件方所屬城市名稱

數(shù)據(jù)元素<響應(yīng)>

OrderResponse

字段名

類型（約束）

是否非空

描述

orderid rderid rderid

String(64) String(64)String(64) String(64) String(64) String(64)

否

訂單號(hào)

mailno mailnomailno mailno

String(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ā)中心 6

2013 年 06 月 01 日

originc origincoriginc originc ode ode

String(10) String(10)String(10) String(10) String(10) String(10)

否

原寄地代碼原寄地代碼

destc destcdestc ode ode

String(10) String(10)String(10) String(10) String(10) String(10)

否

目的地代碼目的地代碼

filter_result filter_resultfilter_result filter_result filter_result filter_result filter_result

Number(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 remark

String(100) String(100)String(100) String(100) String(100) String(100)

1-收方超范圍，收方超范圍，收方超范圍，收方超范圍， 2-派方超范圍，派方超范圍，派方超范圍， 3-其他原因其他原因

3.1.3. 可選字段信息

數(shù)據(jù)元素

Order/OrderOption

字段名

類型（約束）

描述

custid custidcustid custid

String(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 template

String StringString String(30)(30) (30)

模板選擇模板選擇

j_shippercode j_shippercodej_shippercode j_shippercode j_shippercode j_shippercode j_shippercode

String(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_deliverycode

String(30 String(30String(30 String(30 String(30 )

到件方代碼方代碼

cargo cargocargo

String(4000) String(4000)String(4000) String(4000) String(4000) String(4000) String(4000)

貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(gè)貨物名稱，可有多個(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_count

String(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,3

cargo_unit cargo_unitcargo_unit cargo_unit cargo_unit cargo_unit

String(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_weight

String(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.0

cargo_amount cargo_amountcargo_amount cargo_amount cargo_amount cargo_amount cargo_amount

String(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,1500

cargo_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_weight

Number(10,2) Number(10,2)Number(10,2) Number(10,2) Number(10,2) Number(10,2) Number(10,2)

訂單貨物總重量，位訂單貨物總重量，位訂單貨物總重量，位訂單貨物總重量，位訂單貨物總重量，位 KG ，如果提供此值，如果提供此值，如果提供此值，如果提供此值，必須 >0

sendstarttime sendstarttimesendstarttime sendstarttime sendstarttime sendstarttime sendstarttime

dat e

要求上門取件開始時(shí)間，格式：YYYY-MM-DD HH24:MM:SS，示例：2012-7-30 09:30:00,默認(rèn)為系統(tǒng)收到訂單的系統(tǒng)時(shí)間

mailno mailnomailno mailno

String( 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 remark

String(100) String(100)String(100) String(100) String(100) String(100)

備注

數(shù)據(jù)元素

OrderOption/AddedService

字段名

類型（約束）

描述

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 valuevalue

String(30) String(30)String(30) String(30) String(30) String(30)

增值服務(wù)增值服務(wù)增值服務(wù)1

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 7

2013 年 06 月 01 日

增值服務(wù)傳值說明:

服務(wù)

NAME

說明

備注

代收貨款

COD

value為貨款，value1為客戶編碼

保價(jià)

INSURE

value為聲明價(jià)值

MSG

value為手機(jī)號(hào)碼

包裝費(fèi)

PKFEE

value為包裝費(fèi)費(fèi)用

SMS

value為手機(jī)號(hào)碼,且與收件方的手機(jī)號(hào)相同.

value1 為個(gè)性化文字。

特殊保價(jià)

SINSURE

value為服務(wù)費(fèi)。

特殊配送

SDELIVERY

value為服務(wù)費(fèi)。

特殊增值服務(wù)費(fèi)

SADDSERVICE

value 為服務(wù)費(fèi)

3.1.4. 擴(kuò)展字段信息

遵循擴(kuò)展字段規(guī)范

3.1.5. 應(yīng)用場(chǎng)景XML實(shí)例

. 場(chǎng)景1

場(chǎng)景描述：客戶下單

請(qǐng)求XML：

<Head> <Head><Head> <Head>j_custidj_custid j_custid j_custid j_custid（客戶卡號(hào) 客戶卡號(hào) ）,checkwork ,checkwork ,checkwork ,checkwork ,checkwork （校驗(yàn)碼校驗(yàn)碼）</Head> </Head> </Head> </Head>

ody> ody>

<! -- ...... // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService> // <AddedService>// <AddedService> // <AddedService> 可有多個(gè) 可有多個(gè) -- >

</OrderOptionOrderOption OrderOption OrderOption OrderOption OrderOption >

value1 value1value1 value1

String(30) String(30)String(30) String(30) String(30) String(30)

增值服務(wù)增值服務(wù)增值服務(wù)2

value2 value2value2 value2

String(30) String(30)String(30) String(30) String(30) String(30)

增值服務(wù)增值服務(wù)增值服務(wù)3

value3 value3value3 value3

String(30) String(30)String(30) String(30) String(30) String(30)

增值服務(wù)增值服務(wù)增值服務(wù)4

value4 value4value4 value4

String(30) String(30)String(30) String(30) String(30) String(30)

增值服務(wù)增值服務(wù)增值服務(wù)5

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 8

2013 年 06 月 01 日

</Order> </Order></Order> </Order> </Order>

</Body> ody>

</ RequestRequest Request Request >

響應(yīng)XML：

訂單處理成功：訂單處理成功：訂單處理成功：

</Body> </Body></Body> </Body>

</Response> </Response></Response> </Response> </Response> </Response>

訂單處理失�。� 訂單處理失�。� 訂單處理失�。�

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. 功能描述

該接口用于客戶在確定將貨物交付給順豐托運(yùn)后，將運(yùn)單上的一些重要信息，如快件重量、寄件時(shí)間，通過此接口發(fā)送給順豐。

3.2.2. 接口主信息定義

服務(wù)名稱

OrderConfirmService

批量交易限制

不支持

接口類型

接入

協(xié)議類型

WEBSERVICE

接口方法

public String sfexpressService(String XML);

數(shù)據(jù)元素<請(qǐng)求>

OrderConfirm

必要字段名

類型（約束）

默認(rèn)值

描述

orderid rderid rderid

String(64) String(64)String(64) String(64) String(64) String(64)

訂單號(hào)

mailno ailno ailno

String(20) String(20)String(20) String(20) String(20) String(20)

運(yùn)單號(hào)

數(shù)據(jù)元素<響應(yīng)>

OrderConfirmResponse

字段名

類型（約束）

是否非空

描述

orderid orderidorderid orderid

St ring(64)ring(64) ring(64) ring(64) ring(64)

否

訂單號(hào)

mailno mailnomailno mailno

String(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_status

Number 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ā)中心 9

2013 年 06 月 01 日

3.2.3. 可選字段信息

數(shù)據(jù)元素

OrderConfirm/OrderConfirmOption

字段名

類型（約束）

描述

weight weightweight weight

Number(10,2) Number(10,2)Number(10,2) Number(10,2) Number(10,2) Number(10,2) Number(10,2)

訂單重量，位訂單重量，位訂單重量，位訂單重量，位 KG

vo lumelume lume

String(100) String(100)String(100) String(100) String(100) String(100)

托寄物的托寄物的長，寬高以逗號(hào)分隔長，寬高以逗號(hào)分隔長，寬高以逗號(hào)分隔長，寬高以逗號(hào)分隔長，寬高以逗號(hào)分隔長，寬高以逗號(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：

<Head> <Head><Head> <Head>custidcustid custid custid（客戶卡號(hào) 客戶卡號(hào) 客戶卡號(hào) ）,checkwork,checkwork ,checkwork ,checkwork ,checkwork ,checkwork（校驗(yàn)碼校驗(yàn)碼）</Head></Head> </Head> </Head>

ody> ody>

</Order /Order /Order Confirm Confirm Confirm Confirm>

</Body>Body> Body>

</ RequestRequest Request Request >

響應(yīng)XML：

訂單確認(rèn)成功：訂單確認(rèn)成功：訂單確認(rèn)成功：

</Body> </Body></Body> </Body>

</Response> </Response></Response> </Response> </Response> </Response>

訂單確認(rèn) 失�。� 失�。�

<Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head>

</Response> </Response></Response> </Response> </Response> </Response>

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 10

2013 年 06 月 01 日

3.3. 訂單篩選

3.3.1. 功能描述

客戶系統(tǒng)通過此接口向順豐企業(yè)服務(wù)平臺(tái)發(fā)送自動(dòng)篩單請(qǐng)求，用于判斷客戶的收、派地址是否屬于順豐的收派范圍。系統(tǒng)會(huì)根據(jù)收派雙方的地址自動(dòng)判斷是否在順豐的收派范圍內(nèi)。如果屬于范圍內(nèi)則返回可收派，否則返回不可收派。

3.3.2. 接口主信息定義

服務(wù)名稱

OrderFilterService

批量交易限制

<=5筆

接口類型

接入

協(xié)議類型

WEBSERVICE

接口方法

public String sfexpressService(String XML);

數(shù)據(jù)元素<請(qǐng)求>

OrderFilter

必要字段名

類型（約束）

默認(rèn)值

描述

filter_type filter_typefilter_type filter_type filter_type filter_type

Number NumberNumber Number(1)(1)

篩單類別：篩單類別： 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ù) 地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果），地址庫進(jìn)行判斷，并返回結(jié)果）， 2-可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫可人工篩單（系統(tǒng)首先根據(jù)地址庫判斷，如果無法自動(dòng)是否收判斷，如果無法自動(dòng)是否收判斷，如果無法自動(dòng)是否收判斷，如果無法自動(dòng)是否收判斷，如果無法自動(dòng)是否收判斷，如果無法自動(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)推送給客戶系統(tǒng) 后，順豐可主動(dòng)推送給客戶系統(tǒng) 后，順豐可主動(dòng)推送給客戶系統(tǒng) 后，順豐可主動(dòng)推送給客戶系統(tǒng) 后，順豐可主動(dòng)推送給客戶系統(tǒng) 后，順豐可主動(dòng)推送給客戶系統(tǒng) ）

orderid orderidorderid orderid

String 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ào) 訂單號(hào)

d_address d_addressd_address d_address d_address

String StringString String(150)(150) (150)

到件方詳細(xì)地址，到件方詳細(xì)地址，到件方詳細(xì)地址，到件方詳細(xì)地址，需要包括省市需要包括省市需要包括省市區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲區(qū)，如：廣東省深圳市福田新洲十一街萬基商務(wù)大廈。十一街萬基商務(wù)大廈。十一街萬基商務(wù)大廈。十一街萬基商務(wù)大廈。十一街萬基商務(wù)大廈。

數(shù)據(jù)元素<響應(yīng)>

OrderFilterResponse

字段名

類型（約束）

是否非空

描述

orderid orderidorderid orderid

String(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 esult

Number(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 ode

String(10) String(10)String(10) String(10) String(10) String(10)

原寄地代碼原寄地代碼

dest destdestcode ode

String(10) String(10)String(10) String(10) String(10) String(10)

目的地代碼 ,如果可收派，此項(xiàng)不能為空

remark remarkremark remark

String(100) String(100)String(100) String(100) String(100) String(100)

1-收方超范圍， 2-派方超范圍， 3-其他原因其他原因

3.3.3. 可選字段信息

數(shù)據(jù)元素

OrderFilter/OrderFilterOption

字段名

類型（約束）

默認(rèn)值

描述

j_tel

String(20)

寄件方電話

country

String (50)

寄件人所在國家

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 11

2013 年 06 月 01 日

province

String (30)

寄件人所在省份，必須是標(biāo)準(zhǔn)的省名稱稱謂，示例：“廣東省”（省字不要省略）

city

String (100)

寄件方所屬城市名稱，必須是標(biāo)準(zhǔn)的城市稱謂，示例：“深圳市”（市字不要省略）

county

String (30)

寄件人所在縣/區(qū)，必須是標(biāo)準(zhǔn)的縣/區(qū)稱謂，示例：“福田區(qū)”（區(qū)字不要省略）

d_country

String(50)

到件方國家

d_province

String (30)

到件方所在省份，必須是標(biāo)準(zhǔn)的省名稱稱謂，示例：“廣東省”（省字不要省略）

d_city

String (100)

到件方所屬城市名稱，必須是標(biāo)準(zhǔn)的城市稱謂，示例：“深圳市”（市字不要省略）

d_county

String (30)

到件方所在縣/區(qū)，必須是標(biāo)準(zhǔn)的縣/區(qū)稱謂，示例：“福田區(qū)”（區(qū)字不要省略）

j_address

String(150)

寄件方詳細(xì)地址，示例：“廣東省深圳市福田區(qū)新洲十一街萬基商務(wù)大廈10樓”

d_tel

String(23)

到件方電話

3.3.4. 擴(kuò)展字段信息

無。

3.3.5. 應(yīng)用場(chǎng)景XML實(shí)例

. 場(chǎng)景1

場(chǎng)景描述：

請(qǐng)求XML：

ody> ody>

</ OrderFilter rderFilter rderFilter rderFilter rderFilter >

<! -- ...... // 最多包括最多包括 5個(gè)<OrderFiler OrderFiler OrderFiler OrderFiler OrderFiler >-- >

</Body>Body> Body>

</ RequestRequest Request Request >

響應(yīng)XML：

篩單處理成功：篩單處理成功：篩單處理成功：

...

</Body> </Body></Body> </Body>

</Response> </Response></Response> </Response> </Response> </Response>

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 12

2013 年 06 月 01 日

篩單處理失�。� 單處理失敗：單處理失�。�

<Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head>

</Response> </Response></Response> </Response> </Response> </Response>

3.4. 人工篩選結(jié)果推送

3.4.1. 功能描述

如果客戶通過訂單篩選接口得到的反饋結(jié)果為：3-待確認(rèn)時(shí)，如果訂單篩選時(shí)，提供了訂單號(hào)且apply_type=2，當(dāng)完成人工篩單時(shí)，順豐系統(tǒng)將人工篩單的結(jié)果推送給客戶系統(tǒng)。

請(qǐng)客戶系統(tǒng)提供一個(gè)符合以下規(guī)范的HTTP URL，以便順豐向客戶系統(tǒng)推送人工篩單數(shù)據(jù)。

1）順豐以HTTP POST的方式向客戶系統(tǒng)推送數(shù)據(jù)。

2）請(qǐng)求方法的編碼格式：“application/x-www-form-urlencoded; charset=UTF-8”

3）推送的篩單結(jié)果以XML格式，通過POST方式發(fā)送給客戶系統(tǒng)。

4）一個(gè)POST方法最多推送5條篩單數(shù)據(jù)。

5）對(duì)xml內(nèi)容進(jìn)行URL編碼（字符集為UTF-8）。

6）客戶系統(tǒng)在接收到請(qǐng)求后，需要先對(duì)收到的內(nèi)容進(jìn)行URL解碼，得到相應(yīng)的XML。然后從XML中獲取相應(yīng)的篩單數(shù)據(jù)。

7）在客戶系統(tǒng)正確處理XML信息后，向順豐返回響應(yīng)信息，考慮到處理的效率，篩單推送認(rèn)為批量成功或失敗。

3.4.2. 接口主信息定義

服務(wù)名稱

OrderFilterPushService

批量交易限制

<=5筆

接口類型

推送

協(xié)議類型

HTTP

接口方法

無

數(shù)據(jù)元素<請(qǐng)求>

OrderFilterResult

必要字段名

類型（約束）

默認(rèn)值

描述

orderid orderidorderid orderid

String(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 esult

Number(2) Number(2)Number(2) Number(2) Number(2)

否

篩單結(jié)果： 2-可收派 3-不可以收派可以收派

origin originorigin origincode ode

String(10) String(10)String(10) String(10) String(10) String(10)

原寄地代碼原寄地代碼

dest destdestcode ode

String(10) String(10)String(10) String(10) String(10) String(10)

目的地代碼 ,如果可收派，此如果可收派，此如果可收派，此如果可收派，此如果可收派，此如果可收派，此如果可收派，此項(xiàng)不能為空項(xiàng)不能為空

remark remarkremark remark

String(100) String(100)String(100) String(100) String(100) String(100)

1-收方超范圍，收方超范圍，收方超范圍，收方超范圍，收方超范圍，收方超范圍， 2-派方超范派方超范派方超范派方超范圍， 3-其他原因其他原因其他原因

mailno mailnomailno mailno

String( String(String( String( 30 )

運(yùn)單號(hào)

數(shù)據(jù)元素<響應(yīng)>

OrderFilterResultResponse

字段名

類型（約束）

是否非空

描述

orderid orderidorderid orderid

String( 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 rror

String(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ā)中心 13

2013 年 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. 可選字段信息

無

3.4.4. 擴(kuò)展字段信息

無

3.4.5. 應(yīng)用場(chǎng)景XML實(shí)例

. 場(chǎng)景1

場(chǎng)景描述：

請(qǐng)求XML：

<! -- ...//...// ...// 最多包括最多包括 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> </Response>

失敗響應(yīng) 失敗響應(yīng) ：

<Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head>

</Response> </Response></Response> </Response> </Response> </Response>

3.5. 路由查詢

3.5.1. 功能描述

提供客戶系統(tǒng)通過接口查詢客戶通過順豐承運(yùn)的運(yùn)單路由的功能，支持單個(gè)或批量運(yùn)單路由查詢的功能，批量查詢中，最多不能超過10個(gè)運(yùn)單號(hào)。同一批次，只允許查詢同一種語言的運(yùn)單路由。

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 14

2013 年 06 月 01 日

路由查詢接口支持兩類查詢方式：

1）根據(jù)運(yùn)單號(hào)查詢：查詢請(qǐng)求中提供客戶卡號(hào)與運(yùn)單號(hào)，系統(tǒng)將驗(yàn)證客戶卡號(hào)與所有請(qǐng)求運(yùn)單號(hào)的歸屬關(guān)系，系統(tǒng)只返回具有正確歸屬關(guān)系的運(yùn)單路由信息。

2）根據(jù)訂單號(hào)查詢：查詢請(qǐng)求中提供客戶卡號(hào)與訂單號(hào)，系統(tǒng)將驗(yàn)證客戶卡號(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)的路由信息。適用于通過企業(yè)服務(wù)平臺(tái)下發(fā)過訂單的客戶。

3.5.2. 接口主信息定義

服務(wù)名稱

RouteService

批量交易限制

<=10筆

接口類型

接入

協(xié)議類型

WEBSERVICE

接口方法

public String sfexpressService(String xml);

數(shù)據(jù)元素<請(qǐng)求>

RouteRequest

必要字段名

類型（約束）

默認(rèn)值

描述

tracking_type tracking_typetracking_type tracking_type tracking_type tracking_type tracking_type

Number(2) Number(2)Number(2) Number(2) Number(2)

查詢類別查詢類別 , tracking_typetracking_type tracking_type tracking_type tracking_type tracking_typetracking_type tracking_type字段說明：字段說明： 1-根據(jù)運(yùn)單號(hào)查根據(jù)運(yùn)單號(hào)查根據(jù)運(yùn)單號(hào)查根據(jù)運(yùn)單號(hào)查詢， 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)查詢，根據(jù)訂單號(hào)查詢，根據(jù)訂單號(hào)查詢，根據(jù)訂單號(hào)查詢，根據(jù)訂單號(hào)查詢， 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 umber

String StringString String(4000 4000 )

查詢號(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

字段名

類型（約束）

是否非空

描述

mailno mailnomailno mailno

String(20) String(20)String(20) String(20) String(20) String(20)

否

運(yùn)單號(hào)

orderid orderidorderid orderid

String(64) String(64)String(64) String(64) String(64) String(64)

訂單號(hào)

數(shù)據(jù)元素<響應(yīng)>

RouteResponse/Route

字段名

類型（約束）

是否非空

描述

accept ccept ccept_timeime

Date DateDate

否

路由發(fā)生的時(shí)間路由發(fā)生的時(shí)間路由發(fā)生的時(shí)間

accept ccept ccept_addressddress ddress ddress

String(100) String(100)String(100) String(100) String(100) String(100)

否

路由發(fā)生的地點(diǎn) 路由發(fā)生的地點(diǎn) 路由發(fā)生的地點(diǎn)

remark remarkremark remark

String(150) String(150)String(150) String(150) String(150) String(150)

否

具體描述具體描述

op code ode

String(20) String(20)String(20) String(20) String(20) String(20)

操作碼

3.5.3. 可選字段信息

無

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 15

2013 年 06 月 01 日

3.5.4. 擴(kuò)展字段信息

無

3.5.5. 應(yīng)用場(chǎng)景XML實(shí)例

. 場(chǎng)景1

場(chǎng)景描述：根據(jù)運(yùn)單號(hào)查詢

請(qǐng)求XML：

ody> ody>

</Body>Body> Body>

</ RequestRequest Request Request >

響應(yīng)XML：

路由查詢成功：路由查詢成功：路由查詢成功：

<! -- ...... // 可包括多個(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>

路由查詢路由查詢失�。� 失敗：

<Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head>

</Response> </Response></Response> </Response> </Response> </Response>

失敗響應(yīng)：失敗響應(yīng)：

<Head> <Head><Head> <Head>ERRERR </Head> </Head> </Head> </Head>

</Response> </Response></Response> </Response> </Response> </Response>

3.6. 路由推送

3.6.1. 功能描述

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 16

2013 年 06 月 01 日

該接口用于向客戶系統(tǒng)定時(shí)推送運(yùn)單的路由信息。需要客戶系統(tǒng)提供一個(gè)符合以下規(guī)范的HTTP URL，以便順豐向客戶系統(tǒng)推送路由數(shù)據(jù)。推送方式為增量推送，對(duì)于同一個(gè)運(yùn)單的路由，不重復(fù)推送。

1）順豐以HTTP POST的方式向客戶系統(tǒng)推送數(shù)據(jù)。

2）請(qǐng)求方法的編碼格式：“application/x-www-form-urlencoded; charset=UTF-8”

3）推送的路由數(shù)據(jù)以XML格式，通過POST方式發(fā)送給客戶系統(tǒng)。

4）一個(gè)POST方法最多推送10條路由數(shù)據(jù)。

5）對(duì)xml內(nèi)容進(jìn)行URL編碼（字符集為UTF-8）。

6）客戶系統(tǒng)在接收到請(qǐng)求后，需要先對(duì)收到的內(nèi)容進(jìn)行URL解碼，得到相應(yīng)的XML。然后從XML中獲取相應(yīng)的路由信息。

在客戶系統(tǒng)正確處理XML信息后，向順豐返回響應(yīng)信息，考慮到處理的效率，路由推送認(rèn)為批量成功或失敗。

3.6.2. 接口主信息定義

服務(wù)名稱

RoutePushService

批量交易限制

<=10筆

接口類型

推送

協(xié)議類型

HTTP

接口方法

無

數(shù)據(jù)元素<請(qǐng)求>

WaybillRoute

必要字段名

類型（約束）

默認(rèn)值

描述

Number(15)

路由編號(hào)，每一個(gè)id代表一條不同的路由

mailno

String(20)

否

運(yùn)單號(hào)

orderid

String(64)

訂單號(hào)

accept_time

Date

否

路由產(chǎn)生時(shí)間

accept_address

String(100)

否

路由發(fā)生城市

remark

String(300)

否

路由說明

opcode

String(20)

操作碼

數(shù)據(jù)元素<響應(yīng)>

WaybillRouteResponse

字段名

類型（約束）

是否非空

描述

String(4000)

否

成功接收的路由編號(hào)，如果有多個(gè)路由編號(hào)，以逗號(hào)分隔，如“123,124,125“

id_error

String(4000)

否

未成功接收的路由編號(hào)，如果有多個(gè)路由編號(hào)，以逗號(hào)分隔，如“123,124,125“，這部分路由編號(hào)，順豐會(huì)定時(shí)重發(fā)

3.6.3. 可選字段信息

無

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 17

2013 年 06 月 01 日

3.6.4. 擴(kuò)展字段信息

無

3.6.5. 應(yīng)用場(chǎng)景XML實(shí)例

. 場(chǎng)景1

場(chǎng)景描述：

請(qǐng)求XML：

ody> ody>

<! -- //...//... //... 最多 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> </Response>

4. 附錄

4.1. 原因代碼表

原因代碼

描述

分類 61** 缺少必要參數(shù)

6101

請(qǐng)求數(shù)據(jù)缺少必選項(xiàng)

缺少必要參數(shù)

6102

寄件方公司名稱為空

關(guān)鍵字段校驗(yàn)不合法

6103

寄方聯(lián)系人為空

6104

寄方所在省為空

6105

寄方所在城市為空

6106

寄件方詳細(xì)地址為空

6107

到件方公司名稱為空

6108

到件方聯(lián)系人為空

6109

到件方所在省為空

6110

到件方所在城市為空

6111

到件方地址為空

6112

到件方國家不能為空

6113

到件方所在省份不能為空

6114

必須提供客戶訂單號(hào)

6115

到件方所屬城市名稱不能為空

BSP-企業(yè)服務(wù)平臺(tái)接入技術(shù)規(guī)范

順豐集團(tuán)資訊科技本部研發(fā)中心 18

2013 年 06 月 01 日

6116

到件方所在縣/區(qū)不能為空

6117

到件方詳細(xì)地址不能為空

6118

訂單號(hào)不能為空

6119

到件方聯(lián)系電話不能為空

6120

快遞類型不能為空

6121

寄件方聯(lián)系電話不能為空

6122

篩單類別不合法

6123

運(yùn)單號(hào)不能為空

6124

付款方式不能為空

6125

需生成電子運(yùn)單,貨物名稱等不能為空

6126

月結(jié)卡號(hào)不合法

6127

增值服務(wù)名不能為空

6128

增值服務(wù)名不合法

8*** 功能校驗(yàn)

8000

報(bào)文參數(shù)不合法

參數(shù)無效

8001

IP未授權(quán)

參數(shù)無效

8002

服務(wù)（功能）未授權(quán)

8003

查詢單號(hào)超過最大限制

8004

路由查詢條數(shù)超限制

8005

查詢次數(shù)超限制

8006

已下單，無法接收訂單確認(rèn)請(qǐng)求

8007

此訂單已經(jīng)確認(rèn)，無法接收訂單確認(rèn)請(qǐng)求

8008

此訂單人工篩單還未確認(rèn)，無法接收訂單確認(rèn)請(qǐng)求

8009

此訂單不可收派, 無法接收訂單確認(rèn)請(qǐng)求。

8010

此訂單未篩單, 無法接收訂單確認(rèn)請(qǐng)求。

8011

不存在該客戶卡號(hào)與運(yùn)單號(hào)綁定關(guān)系

8012

不存在該客戶卡號(hào)與訂單號(hào)綁定關(guān)系

8013

未傳入查詢單號(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ā)中心 19

2013 年 06 月 01 日

8021

客戶卡號(hào)為空

8022

校驗(yàn)碼為空

8023

服務(wù)名為空

8024

未下單

8025

未傳入服務(wù)或不提供該服務(wù)

8026

不存在的客戶

8027

不存在的業(yè)務(wù)模板

8028

客戶未配置此業(yè)務(wù)

8029

客戶未配置默認(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)翻譯-讓世界自由溝通！專業(yè)的全球語言翻譯供應(yīng)商，上海翻譯公司專業(yè)品牌。絲路沿線56種語言一站式翻譯與技術(shù)解決方案，專業(yè)英語翻譯、日語翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國外派服務(wù)，加速您的全球交付。世聯(lián)翻譯公司在北京、上海、深圳等國際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國城市。每天有近百萬字節(jié)的信息和貿(mào)易通過世聯(lián)走向全球！積累了大量政商用戶數(shù)據(jù)，翻譯人才庫數(shù)據(jù)，多語種語料庫大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國際組織、跨國公司和大中型企業(yè)等近萬用戶的認(rèn)可。