北京無(wú)車(chē)承運(yùn)人試點(diǎn)企業(yè)數(shù)據(jù)接口聯(lián)調(diào)方案

1、無(wú)車(chē)承運(yùn)人試點(diǎn)企業(yè)數(shù)據(jù)接口聯(lián)調(diào)方案V1.1聯(lián)調(diào)流程收到接口規(guī)并完成相應(yīng)改造的試點(diǎn)企業(yè)，應(yīng)先進(jìn)行企業(yè)平臺(tái)自查，并填報(bào)接口規(guī)自查完成情況反饋表（附件2）至市運(yùn)輸管理技術(shù)支持中心（以下簡(jiǎn)稱(chēng)技術(shù)支持中心）專(zhuān)用：bjys_jszc163.。技術(shù)支持中心核驗(yàn)后將企業(yè)平臺(tái)接入授權(quán)信息表（附件3）發(fā)送至試點(diǎn)企業(yè)。試點(diǎn)企業(yè)根據(jù)企業(yè)平臺(tái)接入授權(quán)信息表中的信息與交通運(yùn)輸物流公共信息平臺(tái)對(duì)接，并按照技術(shù)支持中心安排的時(shí)間進(jìn)行調(diào)試測(cè)試，結(jié)束后技術(shù)支持中心發(fā)給平臺(tái)技術(shù)聯(lián)調(diào)結(jié)果通知書(shū)（附件4）。調(diào)試通過(guò)的接入工作完成，調(diào)試不通過(guò)的，試點(diǎn)企業(yè)調(diào)整自身平臺(tái)后，技術(shù)支持中心根據(jù)實(shí)際情況另行安排時(shí)間進(jìn)行重測(cè)。公共平臺(tái)側(cè)：聯(lián)系人瑋

2、子政 聯(lián)調(diào)實(shí)時(shí)溝通渠道 群：285147938 群名稱(chēng)：平臺(tái)聯(lián)調(diào)聯(lián)調(diào)現(xiàn)場(chǎng)支持地點(diǎn)運(yùn)輸局5樓519機(jī)房側(cè)辦公室聯(lián)調(diào)接口接口地址：219.232.194.136聯(lián)調(diào)接口規(guī)參看附件1附件1市交通運(yùn)輸物流公共信息平臺(tái)運(yùn)單數(shù)據(jù)接口規(guī)V1.21. 圍本方案約定了物流數(shù)據(jù)上報(bào)公共信息平臺(tái)的協(xié)議基礎(chǔ)、通信連接、報(bào)文處理和服務(wù)接口描述。本方案適用于企業(yè)通過(guò)自有軟件、標(biāo)準(zhǔn)軟件或共用軟件(以下簡(jiǎn)稱(chēng)客戶(hù)端)向市交通運(yùn)輸物流公共信息平臺(tái)服務(wù)器端上報(bào)普通貨物運(yùn)輸電子數(shù)據(jù)的數(shù)據(jù)接口規(guī)。2. 規(guī)性引用文件本方案依據(jù)國(guó)家交通運(yùn)輸物流公共信息平臺(tái)|L2000標(biāo)準(zhǔn)制定，相應(yīng)協(xié)議、通信和報(bào)文均參照L2000描述，標(biāo)準(zhǔn)下載地址：交通運(yùn)

3、輸物流公共信息平臺(tái)標(biāo)準(zhǔn)3.1版本3. 術(shù)語(yǔ)和定義略4. 縮略語(yǔ)下列縮略語(yǔ)適用于本文件。XML可擴(kuò)展標(biāo)記語(yǔ)言（EXtensible Markup Language，XML）超文本傳輸協(xié)議(Hypertext Transfer Protocol)WS-SecurityWeb服務(wù)安全(Web Services Security, short WSS)Web Service WEB服務(wù)（Web Servicr）SOAP 簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議（Simple Object Access Protocol）5. 協(xié)議基礎(chǔ)5.1 通信方式本協(xié)議采用的通信方式應(yīng)符合SOAP1.1中的相關(guān)規(guī)定，通信協(xié)議采用 同步方式

4、，無(wú)車(chē)承運(yùn)人試點(diǎn)企業(yè)軟件作為客戶(hù)端。5.2 數(shù)據(jù)類(lèi)型本協(xié)議報(bào)文中數(shù)據(jù)流遵循 技術(shù)規(guī)，報(bào)文中使用的數(shù)據(jù)類(lèi)型包括：1) 出現(xiàn)次數(shù)：n.n：第一個(gè)n：最少出現(xiàn)次數(shù)，第二個(gè)n：最多出現(xiàn)次數(shù)。示例1： 1）0.1：最少出現(xiàn)0次（即可不出現(xiàn)），最多只能出現(xiàn)1次（即不能循環(huán)）。2）1.9：最少出現(xiàn)1次（即必須出現(xiàn)1次），最多能出現(xiàn)9次（即可以有9次循環(huán)）。2) 數(shù)據(jù)格式：數(shù)據(jù)格式中使用的字符含義如下： a = 字母字符； n = 數(shù)字字符； an = 字母數(shù)字字符； m(m=為自然數(shù)) = 定長(zhǎng)m 個(gè)字符（字符集默認(rèn)為GB2312）； .ul = 長(zhǎng)度不確定的文本； . = 從最小長(zhǎng)度到最大長(zhǎng)度，前面附加最

5、小長(zhǎng)度，后面附加最大長(zhǎng)度； YYYYMMDDhhmmss“YYYY”表示世紀(jì)和年份，“MM”表示月份，“dd”表示日期，“hh”表示小時(shí)，“mm”表示分鐘，“ss”表示秒； True/False =布爾型。示例2： 1）an5(aannn)：表示定長(zhǎng)5個(gè)字母數(shù)字字符，前2個(gè)為字母字符，后3個(gè)為數(shù)字字符；2）an3.8：表示最大長(zhǎng)度為8，最小長(zhǎng)度為3的不定長(zhǎng)字符；3）n.8,4：表示該數(shù)值最大長(zhǎng)度為8位整數(shù)、4位小數(shù)；4）True/False：表示該數(shù)值為布爾型。5.3 報(bào)文的組成每條報(bào)文由報(bào)文頭和報(bào)文體組成，報(bào)文結(jié)構(gòu)圖如圖1所示。報(bào)文頭報(bào)文體圖1 報(bào)文結(jié)構(gòu)圖5.3.1 報(bào)文頭容如表1所示。企業(yè)

6、進(jìn)行數(shù)據(jù)交換時(shí)，物流共用軟件、重要物流與相關(guān)信息系統(tǒng)需在請(qǐng)求報(bào)文頭中加入認(rèn)證時(shí)獲取的令牌信息。令牌信息在報(bào)文頭過(guò)ws-security格式來(lái)描述，如示例3所示。表1 報(bào)文頭容序號(hào)報(bào)文層X(jué)ML標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型/數(shù)據(jù)格式（Type/Length）說(shuō)明必填11soapenvsoapenv1.122soapenv:Header報(bào)文頭1.133wsse:Security報(bào)文頭1.144wsse:UsernameToken報(bào)文頭1.155wsse:Username用戶(hù)名1.1an.20必填65wsse:Password密碼或令牌1.1an.50必填示例3： <soapenv:Header

7、><wsse:Securitysoapenv:mustUnderstand="1" ><wsse:UsernameToken><wsse:Username> </wsse:Username><wsse:Password> </wsse:Password></wsse:UsernameToken></wsse:Security></soapenv:Header>5.3.2 報(bào)文體屬性格式容如表2所示，結(jié)構(gòu)圖如示例4所示。表2 報(bào)文體屬性格式序號(hào)報(bào)文層LevelXM

8、L標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型/數(shù)據(jù)格式（Type/Length）說(shuō)明必填11soapenvsoapenv1.122soapenv:Body報(bào)文頭1.133operate報(bào)文頭1.144businessId業(yè)務(wù)編號(hào)1.1an.20必填54businessType業(yè)務(wù)類(lèi)型1.1an.50必填64businessXml業(yè)務(wù)容1.1an.2000必填示例4： <soapenv:Body><operate xmlns="operate.cwec./"><businessId xmlns="">f2bb59e2-a214-41e

9、f-8dde-e2009ea84dfa</businessId><businessType xmlns="">FJWL_E-WAY_SEND_GENERAL</businessType><businessXml xmlns="">WVdGaA=</businessXml></operate></soapenv:Body>6. 通信連接6.1 連接的建立客戶(hù)端與服務(wù)器端的數(shù)據(jù)日常連接主要采用 方式，上報(bào)電子運(yùn)單數(shù)據(jù)前，先與服務(wù)器端建立 連接，連接建立后立即向服務(wù)器端發(fā)送登錄

10、鑒權(quán)報(bào)文進(jìn)行鑒權(quán)。6.2 連接的維持 連接建立和客戶(hù)端鑒權(quán)成功后，即客戶(hù)端向服務(wù)器端發(fā)送電子運(yùn)單報(bào)文信息，服務(wù)器端收到后向客戶(hù)端發(fā)送報(bào)文信息后將反饋結(jié)果，客戶(hù)端在完成上報(bào)電子運(yùn)單報(bào)文后，可通過(guò)調(diào)用注銷(xiāo)接口，發(fā)送給服務(wù)器端注銷(xiāo)請(qǐng)求。 客戶(hù)端與服務(wù)器端之間不維持長(zhǎng)連接，只在需要上報(bào)電子運(yùn)單報(bào)文時(shí)才建立連接。6.3 連接的斷開(kāi)客戶(hù)端可根據(jù) 協(xié)議主動(dòng)斷開(kāi)連接?？蛻?hù)端判斷 連接斷開(kāi)的方法： 通過(guò)發(fā)送注銷(xiāo)請(qǐng)求主動(dòng)斷開(kāi)； 數(shù)據(jù)通信鏈路斷開(kāi)； 數(shù)據(jù)通信鏈路正常，達(dá)到重傳次數(shù)后仍未收到應(yīng)答。7. 報(bào)文處理（客戶(hù)端發(fā)起請(qǐng)求）7.1 數(shù)據(jù)通信鏈路正常數(shù)據(jù)通信鏈路正常時(shí)，所有客戶(hù)端主發(fā)的 報(bào)文均要求服務(wù)器端應(yīng)答，應(yīng)答

11、分為鑒權(quán)應(yīng)答和報(bào)文上報(bào)應(yīng)答，由各具體功能協(xié)議決定?？蛻?hù)端等待應(yīng)答超時(shí)后，應(yīng)對(duì)報(bào)文進(jìn)行重發(fā)。7.2 數(shù)據(jù)通信鏈路異常數(shù)據(jù)通信鏈路異常時(shí)，客戶(hù)端應(yīng)對(duì)需發(fā)送的位置信息匯報(bào)報(bào)文進(jìn)行保存。在數(shù)據(jù)通信鏈路恢復(fù)正常后，立即發(fā)送保存的報(bào)文。8. 服務(wù)接口描述8.1 交換認(rèn)證服務(wù)認(rèn)證服務(wù)是企業(yè)接入監(jiān)管平臺(tái)進(jìn)行數(shù)據(jù)交換時(shí)采用的安全保障機(jī)制，為交換雙方提供身份安全認(rèn)證和交換合法性認(rèn)證，包括安全認(rèn)證和退出授權(quán)等操作。企業(yè)在進(jìn)行數(shù)據(jù)交換前，首先調(diào)用身份安全認(rèn)證服務(wù)，該服務(wù)返回給企業(yè)一個(gè)用戶(hù)令牌標(biāo)識(shí)（UserTokenID）。令牌有時(shí)間限制，為自然時(shí)間的24小時(shí)有效。企業(yè)進(jìn)行數(shù)據(jù)交換時(shí)，物流通用軟件與其它信息系統(tǒng)應(yīng)在請(qǐng)求

12、消息頭中加入認(rèn)證時(shí)獲取的令牌信息。令牌信息在消息頭過(guò)ws-security格式來(lái)描述，示例如下：<wsse:Security><wsse:UsernameToken><wsse:Username>userName</wsse:Username><wsse:UserTokenID>pwdvalue</wsse: UserTokenID ></wsse:UsernameToken></wsse:Security>8.1.1 安全認(rèn)證服務(wù)安全認(rèn)證服務(wù)是一種web服務(wù)，從請(qǐng)求消息和響應(yīng)消息兩部分對(duì)服務(wù)屬性進(jìn)

13、行約定,實(shí)現(xiàn)對(duì)用戶(hù)身份的安全認(rèn)證。8.1.1.1 請(qǐng)求消息用戶(hù)安全認(rèn)證請(qǐng)求消息以XML方式描述了應(yīng)進(jìn)行認(rèn)證的用戶(hù)信息，請(qǐng)求消息包括用戶(hù)名和密碼，如下表：中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明名稱(chēng)UsernameString1.1密碼PasswordString1.18.1.1.2 響應(yīng)消息用戶(hù)認(rèn)證操作將用戶(hù)的令牌標(biāo)識(shí)以XML格式封裝返回給用戶(hù)。如果認(rèn)證失敗，返回用戶(hù)錯(cuò)誤代碼和錯(cuò)誤原因，如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明用戶(hù)令牌標(biāo)識(shí)UserTokenIDString0.1異常信息GenericFaultGenericFaultType0.18.1.2 退出授權(quán)服務(wù)退出

14、授權(quán)服務(wù)是一種web服務(wù)，從輸入消息和輸出消息兩部分對(duì)服務(wù)屬性進(jìn)行約定,實(shí)現(xiàn)用戶(hù)退出登陸。8.1.2.1 請(qǐng)求消息用戶(hù)退出登錄請(qǐng)求消息以XML方式描述了用戶(hù)名稱(chēng)和用戶(hù)令牌標(biāo)識(shí)，如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明名稱(chēng)UsernameString1.1用戶(hù)令牌標(biāo)識(shí)UserTokenIDString1.18.1.2.2 響應(yīng)消息用戶(hù)退出登錄響應(yīng)以XML方式返回用戶(hù)退出登錄操作的結(jié)果，如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明退出結(jié)果LogoutResultBoolean1.18.2 數(shù)據(jù)交換服務(wù)支持分布或異構(gòu)應(yīng)用系統(tǒng)，通過(guò)交換平臺(tái)進(jìn)行信息交換的、面向SOA（面向服務(wù)架

15、構(gòu)）的一種信息系統(tǒng)服務(wù)模式，目前提供發(fā)送服務(wù)。8.2.1 數(shù)據(jù)發(fā)送服務(wù)數(shù)據(jù)發(fā)送服務(wù)是一種基于web的服務(wù)，從輸入消息和輸出消息兩部分服務(wù)屬性進(jìn)行約定，為企業(yè)提供了數(shù)據(jù)發(fā)送功能，采用異步方式的交換傳輸。8.2.1.1 請(qǐng)求消息請(qǐng)求消息以XML方式描述了通用的存儲(chǔ)請(qǐng)求。請(qǐng)求消息由目標(biāo)地址和交換事件組成，如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明目標(biāo)地址ToAddressString1.1事件發(fā)送的地址交換事件ExchangeEventExchangeEventType1.n交換事件數(shù)據(jù)類(lèi)型如下表。屬性名元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明事件標(biāo)識(shí)EventIDString1.1企業(yè)傳入的唯

16、一流水號(hào)操作類(lèi)型ActionTypeString1.1交換數(shù)據(jù)ExchangeDataXML文件1.1包Package交換數(shù)據(jù)包可以包含1個(gè)數(shù)據(jù)包單元，存放業(yè)務(wù)單據(jù)報(bào)文,或者包含2個(gè)數(shù)據(jù)包單元，分別存放業(yè)務(wù)單據(jù)報(bào)文和簽收單圖片附件。目前，第2種情況僅出現(xiàn)在業(yè)務(wù)單據(jù)報(bào)文中包含作業(yè)單狀態(tài)，并且作業(yè)單狀態(tài)處于70已簽收狀態(tài)，客戶(hù)端可將簽收信息作為掃描件存入系統(tǒng)并上傳。（1）存放業(yè)務(wù)單據(jù)報(bào)文的數(shù)據(jù)包單元（ExchangeDataPackageUnit）：此數(shù)據(jù)包單元（ExchangeDataPackageUnit）存放業(yè)務(wù)單據(jù)報(bào)文，數(shù)據(jù)包單元對(duì)應(yīng)的數(shù)據(jù)格式為：數(shù)據(jù)文件（DataFile）如下表。屬性名

17、元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明文件標(biāo)識(shí)DataFileIDString1.1數(shù)據(jù)文件標(biāo)識(shí)文件名FileNameString1.1文件格式DataFileFormatString1.1XML嵌入式容EdDataBase64Binary1.1（2）存放簽收單圖片附件的數(shù)據(jù)包單元（ExchangeDataPackageUnit）：數(shù)據(jù)包單元對(duì)應(yīng)的數(shù)據(jù)格式為：附件文件（DataFile）如下表。屬性名元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明文件標(biāo)識(shí)DataFileIDString1.1數(shù)據(jù)文件標(biāo)識(shí)文件名FileNameString1.1主文件名和擴(kuò)展名文件格式DataFileFormatString1.1F

18、ile嵌入式容AttachmentDataBase64Binary1.1圖片二進(jìn)制文本容8.2.1.2 響應(yīng)消息響應(yīng)消息是將操作結(jié)果封裝。響應(yīng)消息是發(fā)送結(jié)果類(lèi)型。由執(zhí)行狀態(tài)，發(fā)送失敗集組成，如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明發(fā)送結(jié)果ResultBoolean1.1發(fā)送是否成功服務(wù)代理容ResultXMLBase64Binary0.1異常信息GenericFaultGenericFaultType0.1通用異常信息通用異常信息類(lèi)型規(guī)定了一般的異常信息的表示方法，通用異常信息包括異常編碼和異常錯(cuò)誤信息，它的屬性定義如下表。中文名稱(chēng)屬性/元素名數(shù)據(jù)類(lèi)型約束/出現(xiàn)次數(shù)說(shuō)明異常編碼C

19、odeString1.1自定異常錯(cuò)誤代碼異常信息ErrorMessageString1.1異常發(fā)生原因的詳細(xì)信息9. 普通貨物運(yùn)輸跟蹤業(yè)務(wù)接口9.1 普通貨物運(yùn)輸托運(yùn)單上傳企業(yè)進(jìn)行普通運(yùn)輸托運(yùn)貨物受理時(shí)，在普通運(yùn)輸通用軟件生成托運(yùn)單，并將托運(yùn)單與明細(xì)發(fā)送給監(jiān)管平臺(tái)。一托運(yùn)單由1條托運(yùn)單記錄、若干條托運(yùn)單貨物明細(xì)、若干條容器明細(xì)組成。l 發(fā)送方：企業(yè)通過(guò)接口發(fā)送；l 發(fā)送方式：異步，通過(guò)接口的傳輸服務(wù)l 接收方：監(jiān)管平臺(tái)序號(hào)報(bào)文層數(shù)據(jù)元標(biāo)識(shí)符XML標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型引用文件說(shuō)明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber

20、報(bào)文參考號(hào)1.1an.35報(bào)文唯一標(biāo)識(shí)符，系統(tǒng)自動(dòng)按照GUID規(guī)則生成431000DocumentName單證名稱(chēng)1.1an.35中文名稱(chēng)：普通運(yùn)輸托運(yùn)單530052DocumentVersionNumber報(bào)文版本號(hào)1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時(shí)間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報(bào)文功能代碼0.1an.3代碼集4.592Body報(bào)文體1.11031802ShippingNoteNumber托運(yùn)單號(hào)1.1a

21、n.201131820OriginalDocumentNumber原始單號(hào)0.1an.351232805ConsignmentDateTime托運(yùn)時(shí)間1.1an.19YYYYMMDDhhmmss1338902BusinessTypeName業(yè)務(wù)類(lèi)型名稱(chēng)0.1an.351439896OperationRequirment作業(yè)要求0.1an.351538921PriorityCode緊急程度代碼1.1an.3代碼集5.131638920PriorityDescription緊急程度描述0.1an.171738905GoodsPickupMethodcode提貨方式代碼1.1an.3代碼集5.141

22、838904GoodsPickupMethodDescription提貨方式描述0.1an.171938973VehicleServiceTypeCode車(chē)輛服務(wù)類(lèi)型代碼0.1an.3代碼集5.252033878Shipper托運(yùn)人0.1an.1002133879ShipperCode托運(yùn)人代碼0.1an.50企業(yè)自定義223ConsignorInfo裝貨方信息0.12343336Consignor發(fā)貨人0.1an.5122443337ConsignorCode發(fā)貨人代碼0.1an.17企業(yè)自定義2543412ContactName聯(lián)系人1.1an.256裝貨聯(lián)系人2643869Telphon

23、eNumber聯(lián)系1.1an.18裝貨聯(lián)系人2743875MobileTelphoneNumber移動(dòng)0.1an.182843228CountrySubdivisionName國(guó)家行政區(qū)劃名稱(chēng)1.1an.702943229CountrySubdivisionCode國(guó)家行政區(qū)劃代碼0.1an.12代碼集4.123043334PlaceOfLoading裝貨地點(diǎn)0.1an.2563132809RequestedLoadingDateTime要求裝貨時(shí)間0.1an.19YYYYMMDDhhmmss323ConsigneeInfo收貨方信息0.13343132Consignee收貨人0.1an.51

24、23443133ConsigneeCode收貨人代碼0.1an.17企業(yè)自定義3543412ContactName聯(lián)系人1.1an.25收貨聯(lián)系人3643869TelphoneNumber1.1an.18收貨聯(lián)系人3743875MobileTelphoneNumber移動(dòng)0.1an.183843228CountrySubdivisionName國(guó)家行政區(qū)劃名稱(chēng)1.1an.703943229CountrySubdivisionCode國(guó)家行政區(qū)劃代碼0.1an.12代碼集4.124043160GoodsReceiptPlace收貨地點(diǎn)1.1an.2564132821RequestedUnload

25、edDate要求卸貨日期0.1an.19YYYYMMDDhhmmss4231825IsReturn是否回執(zhí)0.1n1代碼集5.244335077PriceCurrencyCode價(jià)格貨幣代碼0.1an.3代碼集4.604435004MonetaryAmount貨幣金額0.1n.18代收貨款數(shù)量4531829ShippingNoteStatusCode托運(yùn)單狀態(tài)代碼0.1an.3代碼集4.574637824GoodsSelfNumber貨物自編號(hào)0.1an.1004739842Remark備注0.1an.256483GoodsInfo貨物信息1.n4947823AriticleNumber商品條

26、碼0.1an.355047819CargoHSNumber商品HS編碼0.1an.10代碼集4.365147820GoodsClassificationName貨物分類(lèi)名稱(chēng)0.1an.355247002DescriptionOfGoods貨物名稱(chēng)1.1an.5125347832GoodsSpecification貨物規(guī)格0.1an.355447338ArticleBatchNumber產(chǎn)品批次號(hào)0.1an.175547370TotalNumberOfPackages總件數(shù)1.1n.85647065PackageTypeCode包裝類(lèi)型代碼1.1an.17代碼集4.295743880GoodsO

27、wner貨主0.1an.1005849842Remark備注0.1an.255594ItemGrossWeight貨物毛重0.16056292GoodsItemGrossWeight貨物項(xiàng)毛重1.1n.166156411MeasurementUnitCode計(jì)量單位代碼0.1an.3代碼集4.28TNE：噸，KGM：千克，缺省千克624ItemValue貨物體積0.16356322Cube體積0.1n.96456411MeasurementUnitCode計(jì)量單位代碼0.1an.3代碼集4.28MTQ：立方米，LTR：升，缺省立方米653ContainerInfo容器信息0.n6647828T

28、ransortEquipmentAccessoryName運(yùn)輸設(shè)備附件名稱(chēng)1.1an.206747823ArtticleNumber商品條碼0.1an.356846810ContainerQuantity容器數(shù)量0.1n.6694ContainerGrossWeight容器毛重0.n7056292GoodsItemGrossWeight貨物項(xiàng)毛重1.1n.167156411MeasurementUnitCode計(jì)量單位代碼0.1an.3代碼集4.28TNE：噸，KGM：千克，缺省千克724ContainerValue容器體積0.n7356322Cube體積1.1n.97456411Measur

29、ementUnitCode計(jì)量單位代碼0.1an.3代碼集4.28MTQ：立方米，LTR：升，缺省立方米7549842Remark備注0.1an.2559.2 普通貨物運(yùn)輸托運(yùn)狀態(tài)變化單上傳當(dāng)企業(yè)平臺(tái)將托運(yùn)狀態(tài)發(fā)生改變時(shí)，需要將此托運(yùn)狀態(tài)變化的情況上傳到監(jiān)管平臺(tái)。l 發(fā)送方：企業(yè)通過(guò)接口發(fā)送；l 發(fā)送方式：異步，通過(guò)接口的傳輸服務(wù)l 接收方：監(jiān)管平臺(tái)業(yè)務(wù)接口通過(guò)調(diào)用send接口來(lái)發(fā)送請(qǐng)求消息，在交換數(shù)據(jù)包中嵌入上傳的普通運(yùn)輸托運(yùn)狀態(tài)變化單報(bào)文,其報(bào)文結(jié)構(gòu)見(jiàn)下表。序號(hào)報(bào)文層數(shù)據(jù)元標(biāo)識(shí)符XML標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型引用文件說(shuō)明11RootRoot1.122Header報(bào)文頭1.1330062

30、MessageReferenceNumber報(bào)文參考號(hào)1.1an.35報(bào)文唯一標(biāo)識(shí)符，系統(tǒng)自動(dòng)按照GUID規(guī)則生成431000DocumentName單證名稱(chēng)1.1an.35中文名稱(chēng)：普通運(yùn)輸托運(yùn)狀態(tài)變化單530052DocumentVersionNumber報(bào)文版本號(hào)1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時(shí)間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報(bào)文功能代碼0.1an.3代碼集4.592Body報(bào)文體1.11031802

31、ShippingNoteNumber托運(yùn)單號(hào)1.1an.201131820OriginalDocumentNumber原始單號(hào)0.1an.351231829ShippingNoteStatusCode托運(yùn)單狀態(tài)代碼1.1an.3代碼集4.571332867StatusChangeDateTime狀態(tài)變更時(shí)間1.1an.19YYYYMMDDhhmmss1439842Remark備注1.1an.255描述關(guān)閉原因153DetailStatusInfo詳細(xì)狀態(tài)信息0.n1641812JobOrderNumber作業(yè)單號(hào)1.1an.501748802VehicleNumber車(chē)輛牌照號(hào)1.1an.35

32、1848819LicensePlateTypeCode牌照類(lèi)型代碼1.1an.20代碼集4.481941833JobOrderStatusCode作業(yè)單狀態(tài)代碼1.1an.3代碼集4.572048067TransportModeCode運(yùn)輸方式代碼0.1an.3代碼集4.39214Driver駕駛員1.12253412ContactName聯(lián)系人1.1an.2562353869TelphoneNumber聯(lián)系1.1an.182443334PlaceOfLoading裝貨地點(diǎn)1.1an.2562542809RequestedLoadingDateTime要求裝貨時(shí)間0.1an.19YYYYMMD

33、Dhhmmss2642821RequestedUnloadedDate要求卸貨日期0.1an.19YYYYMMDDhhmmss2742171DespatchActualDateTime發(fā)運(yùn)實(shí)際日期1.1an.19YYYYMMDDhhmmss2842441GoodsReceiptDateTime收貨日期0.1an.19YYYYMMDDhhmmss2942867StatusChangeDateTime狀態(tài)變更時(shí)間1.1an.19YYYYMMDDhhmmss9.3 普通貨物運(yùn)輸回執(zhí)單上傳當(dāng)企業(yè)平臺(tái)記錄運(yùn)輸完成收到回執(zhí)時(shí)，需要將此回執(zhí)單的情況上傳到監(jiān)管平臺(tái)。l 發(fā)送方：企業(yè)通過(guò)接口發(fā)送；l 發(fā)送方式：

34、異步，通過(guò)接口的傳輸服務(wù)l 接收方：監(jiān)管平臺(tái)業(yè)務(wù)接口通過(guò)調(diào)用send接口來(lái)發(fā)送請(qǐng)求消息，在交換數(shù)據(jù)包中嵌入上傳的普通運(yùn)輸回單報(bào)文,其報(bào)文結(jié)構(gòu)見(jiàn)下表。序號(hào)報(bào)文層數(shù)據(jù)元標(biāo)識(shí)符XML標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型引用文件說(shuō)明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber報(bào)文參考號(hào)1.1an.35報(bào)文唯一標(biāo)識(shí)符，系統(tǒng)自動(dòng)按照GUID規(guī)則生成431000DocumentName單證名稱(chēng)1.1an.35中文名稱(chēng)：普通運(yùn)輸回單530052DocumentVersionNumber報(bào)文版本號(hào)1.1an.17V3.1639813SenderCode發(fā)

35、送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時(shí)間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報(bào)文功能代碼0.1an.3代碼集4.592Body報(bào)文體1.11031802ShippingNoteNumber托運(yùn)單號(hào)1.1an.201131820OriginalDocumentNumber原始單號(hào)0.1an.351231829ShippingNoteStatusCode托運(yùn)單狀態(tài)代碼1.1an.3代碼集4.571334440FreeText自由文本0.1an.512143ConsigneeInf

36、o收貨信息0.n1542441GoodsReceiptDateTime收貨日期0.1an.19YYYYMMDDhhmmss1643160GoodsReceiptPlace收貨地點(diǎn)1.1an.5121743042StreetAndNumberOrPOBox街道門(mén)牌/郵政信箱0.1an.2561843132Consignee收貨人1.1an.701943412ContactName聯(lián)系人0.1an.2562043869TelphoneNumber0.1an.182143871FaxNumber0.1an.182241808IdentityDocumentNumber證件號(hào)0.1an.1823518

37、15PersonalIdentityDocumentTypeCode件類(lèi)別代碼0.1an.3代碼集5.12447817SignTypeCode簽收類(lèi)別代碼0.1an.3代碼集5.3254GoodsInfo貨物信息0.n2657823 ArticleNumber商品條碼0.1an.35 2757819 CargoHSNumber貨物HS編碼0.1an.10 代碼集4.36 2857820GoodsClassificationName貨物分類(lèi)名稱(chēng)0.1an.352957002DecriptionOfGoods貨物名稱(chēng)1.1an.5123057832GoodsSpecification貨物規(guī)格0.1

38、an.35315 7338 ArticleBatchNumber 產(chǎn)品批次號(hào)0.1 an.35 325 7065 PackageTypeCode 包裝類(lèi)型代碼0.1 an.17 代碼集4.29 335 7224 PackageQuantity 包裝數(shù)量1.1 n.8 345 6832 PackagesNumber 貨物實(shí)收數(shù)量1.1 n.6 355 6834 DamagePackagesNumber 貨物破損數(shù)量1.1 n.6 365 6836 RejectPackagesNumber 貨物拒收數(shù)量1.1 n.6 375 6838 MissingPackagesNumber 貨物缺件數(shù)量1.1

39、 n.6 383 FreightCharges運(yùn)輸費(fèi)用0.1394 5077 PriceCurrencyCode 價(jià)格貨幣代碼0.1 an.3 代碼集4.60 404 5004 MonetaryAmount 貨幣金額0.1 n.18 413CollectingFees 代收費(fèi)用0.1 424 5077 PriceCurrencyCode 價(jià)格貨幣代碼0.1 an.3 代碼集4.60 434 5004 MonetaryAmount 貨幣金額0.1 n.18 443 9842 Remark 備注0.1 an.255 9.4 實(shí)際承運(yùn)人信息上傳企業(yè)平臺(tái)需要每日定時(shí)將實(shí)際承運(yùn)人明細(xì)數(shù)據(jù)上傳到監(jiān)管平臺(tái)。

40、l 發(fā)送方：企業(yè)通過(guò)接口定時(shí)發(fā)送；l 發(fā)送方式：異步，通過(guò)接口的傳輸服務(wù)l 接收方：監(jiān)管平臺(tái)業(yè)務(wù)接口通過(guò)調(diào)用send接口來(lái)發(fā)送請(qǐng)求消息，在交換數(shù)據(jù)包中嵌入上傳的實(shí)際承運(yùn)人信息報(bào)文,其報(bào)文結(jié)構(gòu)見(jiàn)下表。序號(hào)報(bào)文層數(shù)據(jù)元標(biāo)識(shí)符XML標(biāo)記中文名稱(chēng)出現(xiàn)次數(shù)數(shù)據(jù)類(lèi)型引用文件說(shuō)明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber報(bào)文參考號(hào)1.1an.35報(bào)文唯一標(biāo)識(shí)符，系統(tǒng)自動(dòng)按照GUID規(guī)則生成431000DocumentName單證名稱(chēng)1.1an.35中文名稱(chēng)：承運(yùn)人信息530052DocumentVersionNumber報(bào)文版本號(hào)1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時(shí)間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報(bào)文功能代碼0.1an.3代碼集4.592Body報(bào)文體1.11033126CarrierName承運(yùn)人名稱(chēng)1.1an.5121133127CarrierIdentifier承運(yùn)人標(biāo)識(shí)