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

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

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

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

4、，無車承運(yùn)人試點(diǎn)企業(yè)軟件作為客戶端。5.2 數(shù)據(jù)類型本協(xié)議報(bào)文中數(shù)據(jù)流遵循 技術(shù)規(guī)，報(bào)文中使用的數(shù)據(jù)類型包括：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ù)) = 定長m 個(gè)字符（字符集默認(rèn)為GB2312）； .ul = 長度不確定的文本； . = 從最小長度到最大長度，前面附加最

5、小長度，后面附加最大長度； YYYYMMDDhhmmss“YYYY”表示世紀(jì)和年份，“MM”表示月份，“dd”表示日期，“hh”表示小時(shí)，“mm”表示分鐘，“ss”表示秒； True/False =布爾型。示例2： 1）an5(aannn)：表示定長5個(gè)字母數(shù)字字符，前2個(gè)為字母字符，后3個(gè)為數(shù)字字符；2）an3.8：表示最大長度為8，最小長度為3的不定長字符；3）n.8,4：表示該數(shù)值最大長度為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)需在請求報(bào)文頭中加入認(rèn)證時(shí)獲取的令牌信息。令牌信息在報(bào)文頭過ws-security格式來描述，如示例3所示。表1 報(bào)文頭容序號報(bào)文層XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型/數(shù)據(jù)格式（Type/Length）說明必填11soapenvsoapenv1.122soapenv:Header報(bào)文頭1.133wsse:Security報(bào)文頭1.144wsse:UsernameToken報(bào)文頭1.155wsse:Username用戶名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)文體屬性格式序號報(bào)文層LevelXM

8、L標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型/數(shù)據(jù)格式（Type/Length）說明必填11soapenvsoapenv1.122soapenv:Body報(bào)文頭1.133operate報(bào)文頭1.144businessId業(yè)務(wù)編號1.1an.20必填54businessType業(yè)務(wù)類型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 連接的建立客戶端與服務(wù)器端的數(shù)據(jù)日常連接主要采用 方式，上報(bào)電子運(yùn)單數(shù)據(jù)前，先與服務(wù)器端建立 連接，連接建立后立即向服務(wù)器端發(fā)送登錄

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

11、分為鑒權(quán)應(yīng)答和報(bào)文上報(bào)應(yīng)答，由各具體功能協(xié)議決定?？蛻舳说却龖?yīng)答超時(shí)后，應(yīng)對報(bào)文進(jìn)行重發(fā)。7.2 數(shù)據(jù)通信鏈路異常數(shù)據(jù)通信鏈路異常時(shí)，客戶端應(yīng)對需發(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)管平臺進(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è)用戶令牌標(biāo)識（UserTokenID）。令牌有時(shí)間限制，為自然時(shí)間的24小時(shí)有效。企業(yè)進(jìn)行數(shù)據(jù)交換時(shí)，物流通用軟件與其它信息系統(tǒng)應(yīng)在請求

12、消息頭中加入認(rèn)證時(shí)獲取的令牌信息。令牌信息在消息頭過ws-security格式來描述，示例如下：<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ù)，從請求消息和響應(yīng)消息兩部分對服務(wù)屬性進(jìn)

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

14、授權(quán)服務(wù)是一種web服務(wù)，從輸入消息和輸出消息兩部分對服務(wù)屬性進(jìn)行約定,實(shí)現(xiàn)用戶退出登陸。8.1.2.1 請求消息用戶退出登錄請求消息以XML方式描述了用戶名稱和用戶令牌標(biāo)識，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明名稱UsernameString1.1用戶令牌標(biāo)識UserTokenIDString1.18.1.2.2 響應(yīng)消息用戶退出登錄響應(yīng)以XML方式返回用戶退出登錄操作的結(jié)果，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明退出結(jié)果LogoutResultBoolean1.18.2 數(shù)據(jù)交換服務(wù)支持分布或異構(gòu)應(yīng)用系統(tǒng)，通過交換平臺進(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 請求消息請求消息以XML方式描述了通用的存儲請求。請求消息由目標(biāo)地址和交換事件組成，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明目標(biāo)地址ToAddressString1.1事件發(fā)送的地址交換事件ExchangeEventExchangeEventType1.n交換事件數(shù)據(jù)類型如下表。屬性名元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明事件標(biāo)識EventIDString1.1企業(yè)傳入的唯

16、一流水號操作類型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)，客戶端可將簽收信息作為掃描件存入系統(tǒng)并上傳。（1）存放業(yè)務(wù)單據(jù)報(bào)文的數(shù)據(jù)包單元（ExchangeDataPackageUnit）：此數(shù)據(jù)包單元（ExchangeDataPackageUnit）存放業(yè)務(wù)單據(jù)報(bào)文，數(shù)據(jù)包單元對應(yīng)的數(shù)據(jù)格式為：數(shù)據(jù)文件（DataFile）如下表。屬性名

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

18、ile嵌入式容AttachmentDataBase64Binary1.1圖片二進(jìn)制文本容8.2.1.2 響應(yīng)消息響應(yīng)消息是將操作結(jié)果封裝。響應(yīng)消息是發(fā)送結(jié)果類型。由執(zhí)行狀態(tài)，發(fā)送失敗集組成，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明發(fā)送結(jié)果ResultBoolean1.1發(fā)送是否成功服務(wù)代理容ResultXMLBase64Binary0.1異常信息GenericFaultGenericFaultType0.1通用異常信息通用異常信息類型規(guī)定了一般的異常信息的表示方法，通用異常信息包括異常編碼和異常錯(cuò)誤信息，它的屬性定義如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明異常編碼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)管平臺。一托運(yùn)單由1條托運(yùn)單記錄、若干條托運(yùn)單貨物明細(xì)、若干條容器明細(xì)組成。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺序號報(bào)文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber

20、報(bào)文參考號1.1an.35報(bào)文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：普通運(yùn)輸托運(yùn)單530052DocumentVersionNumber報(bà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)單號1.1a

21、n.201131820OriginalDocumentNumber原始單號0.1an.351232805ConsignmentDateTime托運(yùn)時(shí)間1.1an.19YYYYMMDDhhmmss1338902BusinessTypeName業(yè)務(wù)類型名稱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車輛服務(wù)類型代碼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移動0.1an.182843228CountrySubdivisionName國家行政區(qū)劃名稱1.1an.702943229CountrySubdivisionCode國家行政區(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移動0.1an.183843228CountrySubdivisionName國家行政區(qū)劃名稱1.1an.703943229CountrySubdivisionCode國家行政區(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貨物自編號0.1an.1004739842Remark備注0.1an.256483GoodsInfo貨物信息1.n4947823AriticleNumber商品條

26、碼0.1an.355047819CargoHSNumber商品HS編碼0.1an.10代碼集4.365147820GoodsClassificationName貨物分類名稱0.1an.355247002DescriptionOfGoods貨物名稱1.1an.5125347832GoodsSpecification貨物規(guī)格0.1an.355447338ArticleBatchNumber產(chǎn)品批次號0.1an.175547370TotalNumberOfPackages總件數(shù)1.1n.85647065PackageTypeCode包裝類型代碼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è)備附件名稱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è)平臺將托運(yùn)狀態(tài)發(fā)生改變時(shí)，需要將此托運(yùn)狀態(tài)變化的情況上傳到監(jiān)管平臺。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包中嵌入上傳的普通運(yùn)輸托運(yùn)狀態(tài)變化單報(bào)文,其報(bào)文結(jié)構(gòu)見下表。序號報(bào)文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報(bào)文頭1.1330062

30、MessageReferenceNumber報(bào)文參考號1.1an.35報(bào)文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：普通運(yùn)輸托運(yùn)狀態(tài)變化單530052DocumentVersionNumber報(bà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)單號1.1an.201131820OriginalDocumentNumber原始單號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è)單號1.1an.501748802VehicleNumber車輛牌照號1.1an.35

32、1848819LicensePlateTypeCode牌照類型代碼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è)平臺記錄運(yùn)輸完成收到回執(zhí)時(shí)，需要將此回執(zhí)單的情況上傳到監(jiān)管平臺。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：

34、異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包中嵌入上傳的普通運(yùn)輸回單報(bào)文,其報(bào)文結(jié)構(gòu)見下表。序號報(bào)文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber報(bào)文參考號1.1an.35報(bào)文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：普通運(yùn)輸回單530052DocumentVersionNumber報(bà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)單號1.1an.201131820OriginalDocumentNumber原始單號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街道門牌/郵政信箱0.1an.2561843132Consignee收貨人1.1an.701943412ContactName聯(lián)系人0.1an.2562043869TelphoneNumber0.1an.182143871FaxNumber0.1an.182241808IdentityDocumentNumber證件號0.1an.1823518

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

38、an.35315 7338 ArticleBatchNumber 產(chǎn)品批次號0.1 an.35 325 7065 PackageTypeCode 包裝類型代碼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è)平臺需要每日定時(shí)將實(shí)際承運(yùn)人明細(xì)數(shù)據(jù)上傳到監(jiān)管平臺。

40、l 發(fā)送方：企業(yè)通過接口定時(shí)發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包中嵌入上傳的實(shí)際承運(yùn)人信息報(bào)文,其報(bào)文結(jié)構(gòu)見下表。序號報(bào)文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報(bào)文頭1.1330062MessageReferenceNumber報(bào)文參考號1.1an.35報(bào)文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：承運(yùn)人信息530052DocumentVersionNumber報(bà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)人名稱1.1an.5121133127CarrierIdentifier承運(yùn)人標(biāo)識