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

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

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

3、|L2000標(biāo)準制定，相應(yīng)協(xié)議、通信和報文均參照L2000描述，標(biāo)準下載地址：交通運輸物流公共信息平臺標(biāo)準3.1版本3. 術(shù)語和定義略4. 縮略語下列縮略語適用于本文件。XML可擴展標(biāo)記語言（EXtensible Markup Language，XML）HTTP超文本傳輸協(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ǔ)

4、5.1 通信方式本協(xié)議采用的通信方式應(yīng)符合SOAP1.1中的相關(guān)規(guī)定，通信協(xié)議采用HTTP同步方式，無車承運人試點企業(yè)軟件作為客戶端。5.2 數(shù)據(jù)類型本協(xié)議報文中數(shù)據(jù)流遵循HTTP技術(shù)規(guī)范，報文中使用的數(shù)據(jù)類型包括：1) 出現(xiàn)次數(shù)：n.n：第一個n：最少出現(xiàn)次數(shù)，第二個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 個字

5、符（字符集默認為GB2312）； .ul = 長度不確定的文本； . = 從最小長度到最大長度，前面附加最小長度，后面附加最大長度； YYYYMMDDhhmmss “YYYY”表示世紀和年份，“MM”表示月份，“dd”表示日期，“hh”表示小時，“mm”表示分鐘，“ss”表示秒； True/False =布爾型。示例2： 1）an5(aannn)：表示定長5個字母數(shù)字字符，前2個為字母字符，后3個為數(shù)字字符；2）an3.8：表示最大長度為8，最小長度為3的不定長字符；3）n.8,4：表示該數(shù)值最大長度為8位整數(shù)、4位小數(shù)；4）True/False：表示該數(shù)值為布爾型。5.3 報文的組成每條報文

6、由報文頭和報文體組成，報文結(jié)構(gòu)圖如圖1所示。報文頭報文體圖1 報文結(jié)構(gòu)圖5.3.1 報文頭內(nèi)容如表1所示。企業(yè)進行數(shù)據(jù)交換時，物流共用軟件、重要物流及相關(guān)信息系統(tǒng)需在請求報文頭中加入認證時獲取的令牌信息。令牌信息在報文頭中通過ws-security格式來描述，如示例3所示。表1 報文頭內(nèi)容序號報文層XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型/數(shù)據(jù)格式（Type/Length）說明必填11soapenvsoapenv1.122soapenv:Header報文頭1.133wsse:Security報文頭1.144wsse:UsernameToken報文頭1.155wsse:Username用戶名1.1an

7、.20必填65wsse:Password密碼或令牌1.1an.50必填示例3： <soapenv:Header><wsse:Security soapenv:mustUnderstand="1" ><wsse:UsernameToken><wsse:Username> </wsse:Username><wsse:Password> </wsse:Password></wsse:UsernameToken></wsse:Security></soapenv:Hea

8、der>5.3.2 報文體屬性格式內(nèi)容如表2所示，結(jié)構(gòu)圖如示例4所示。表2 報文體屬性格式序號報文層LevelXML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型/數(shù)據(jù)格式（Type/Length）說明必填11soapenvsoapenv1.122soapenv:Body報文頭1.133operate報文頭1.144businessId業(yè)務(wù)編號1.1an.20必填54businessType業(yè)務(wù)類型1.1an.50必填64businessXml業(yè)務(wù)內(nèi)容1.1an.2000必填示例4： <soapenv:Body><operate xmlns="<businessId xm

9、lns="">f2bb59e2-a214-41ef-8dde-e2009ea84dfa</businessId><businessType xmlns="">FJWL_E-WAY_SEND_GENERAL</businessType><businessXml xmlns="">WVdGaA=</businessXml></operate></soapenv:Body>6. 通信連接6.1 連接的建立客戶端與服務(wù)器端的數(shù)據(jù)日常連接主要采用HTTP方

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

11、客戶端發(fā)起請求）7.1 數(shù)據(jù)通信鏈路正常數(shù)據(jù)通信鏈路正常時，所有客戶端主發(fā)的HTTP報文均要求服務(wù)器端應(yīng)答，應(yīng)答分為鑒權(quán)應(yīng)答和報文上報應(yīng)答，由各具體功能協(xié)議決定。客戶端等待應(yīng)答超時后，應(yīng)對報文進行重發(fā)。7.2 數(shù)據(jù)通信鏈路異常數(shù)據(jù)通信鏈路異常時，客戶端應(yīng)對需發(fā)送的位置信息匯報報文進行保存。在數(shù)據(jù)通信鏈路恢復(fù)正常后，立即發(fā)送保存的報文。8. 服務(wù)接口描述8.1 交換認證服務(wù)認證服務(wù)是企業(yè)接入監(jiān)管平臺進行數(shù)據(jù)交換時采用的安全保障機制，為交換雙方提供身份安全認證和交換合法性認證，包括安全認證和退出授權(quán)等操作。企業(yè)在進行數(shù)據(jù)交換前，首先調(diào)用身份安全認證服務(wù)，該服務(wù)返回給企業(yè)一個用戶令牌標(biāo)識（UserT

12、okenID）。令牌有時間限制，為自然時間的24小時有效。企業(yè)進行數(shù)據(jù)交換時，物流通用軟件及其它信息系統(tǒng)應(yīng)在請求消息頭中加入認證時獲取的令牌信息。令牌信息在消息頭中通過ws-security格式來描述，示例如下：<wsse:Security><wsse:UsernameToken><wsse:Username>userName</wsse:Username><wsse:UserTokenID>pwdvalue</wsse: UserTokenID ></wsse:UsernameToken></wsse:

13、Security> 8.1.1 安全認證服務(wù)安全認證服務(wù)是一種web服務(wù)，從請求消息和響應(yīng)消息兩部分對服務(wù)屬性進行約定,實現(xiàn)對用戶身份的安全認證。 請求消息用戶安全認證請求消息以XML方式描述了應(yīng)進行認證的用戶信息，請求消息包括用戶名和密碼，如下表：中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明帳戶名稱UsernameString1.1帳戶密碼PasswordString.2 響應(yīng)消息用戶認證操作將用戶的令牌標(biāo)識以XML格式封裝返回給用戶。如果認證失敗，返回用戶錯誤代碼和錯誤原因，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明用戶令牌標(biāo)識UserTo

14、kenIDString0.1異常信息GenericFaultGenericFaultType 退出授權(quán)服務(wù)退出授權(quán)服務(wù)是一種web服務(wù)，從輸入消息和輸出消息兩部分對服務(wù)屬性進行約定,實現(xiàn)用戶退出登陸。 請求消息用戶退出登錄請求消息以XML方式描述了用戶名稱和用戶令牌標(biāo)識，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明帳戶名稱UsernameString1.1用戶令牌標(biāo)識UserTokenIDString.2 響應(yīng)消息用戶退出登錄響應(yīng)以XML方式返回用戶退出登錄操作的結(jié)果，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明退出結(jié)果Logo

15、utResultBoolean1.18.2 數(shù)據(jù)交換服務(wù)支持分布或異構(gòu)應(yīng)用系統(tǒng)，通過交換平臺進行信息交換的、面向SOA（面向服務(wù)架構(gòu)）的一種信息系統(tǒng)服務(wù)模式，目前提供發(fā)送服務(wù)。8.2.1 數(shù)據(jù)發(fā)送服務(wù)數(shù)據(jù)發(fā)送服務(wù)是一種基于web的服務(wù)，從輸入消息和輸出消息兩部分服務(wù)屬性進行約定，為企業(yè)提供了數(shù)據(jù)發(fā)送功能，采用異步方式的交換傳輸。 請求消息請求消息以XML方式描述了通用的存儲請求。請求消息由目標(biāo)地址和交換事件組成，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明目標(biāo)地址ToAddressString1.1事件發(fā)送的地址交換事件ExchangeEventExchangeEven

16、tType1.n交換事件數(shù)據(jù)類型如下表。屬性名元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明事件標(biāo)識EventIDString1.1企業(yè)傳入的唯一流水號操作類型ActionTypeString1.1交換數(shù)據(jù)ExchangeDataXML文件1.1包Package交換數(shù)據(jù)包可以包含1個數(shù)據(jù)包單元，存放業(yè)務(wù)單據(jù)報文,或者包含2個數(shù)據(jù)包單元，分別存放業(yè)務(wù)單據(jù)報文和簽收單圖片附件。目前，第2種情況僅出現(xiàn)在業(yè)務(wù)單據(jù)報文中包含作業(yè)單狀態(tài)，并且作業(yè)單狀態(tài)處于70已簽收狀態(tài)，客戶端可將簽收信息作為掃描件存入系統(tǒng)并上傳。（1）存放業(yè)務(wù)單據(jù)報文的數(shù)據(jù)包單元（ExchangeDataPackageUnit）：此數(shù)據(jù)包單元（Exc

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

18、g1.1數(shù)據(jù)文件標(biāo)識文件名FileNameString1.1主文件名和擴展名文件格式DataFileFormatString1.1File嵌入式內(nèi)容AttachmentDataBase64Binary1.1圖片二進制文本內(nèi)容 響應(yīng)消息響應(yīng)消息是將操作結(jié)果封裝。響應(yīng)消息是發(fā)送結(jié)果類型。由執(zhí)行狀態(tài)，發(fā)送失敗集組成，如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明發(fā)送結(jié)果ResultBoolean1.1發(fā)送是否成功服務(wù)代理內(nèi)容ResultXMLBase64Binary0.1異常信息GenericFaultGenericFaultType0.1通用異常信息通用異常信息類型規(guī)定了一般

19、的異常信息的表示方法，通用異常信息包括異常編碼和異常錯誤信息，它的屬性定義如下表。中文名稱屬性/元素名數(shù)據(jù)類型約束/出現(xiàn)次數(shù)說明異常編碼CodeString1.1自定異常錯誤代碼異常信息ErrorMessageString1.1異常發(fā)生原因的詳細信息9. 普通貨物運輸跟蹤業(yè)務(wù)接口9.1 普通貨物運輸托運單上傳企業(yè)進行普通運輸托運貨物受理時，在普通運輸通用軟件生成托運單，并將托運單及明細發(fā)送給監(jiān)管平臺。一張托運單由1條托運單記錄、若干條托運單貨物明細、若干條容器明細組成。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺序號報文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名

20、稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報文頭1.1330062MessageReferenceNumber報文參考號1.1an.35報文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：普通運輸托運單530052DocumentVersionNumber報文版本號1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時間1.1an.19YYYYMMDDhhmmss831225MessageFuncti

21、onCode報文功能代碼0.1an.3代碼集4.592Body報文體1.11031802ShippingNoteNumber托運單號1.1an.201131820OriginalDocumentNumber原始單號0.1an.351232805ConsignmentDateTime托運時間1.1an.19YYYYMMDDhhmmss1338902BusinessTypeName業(yè)務(wù)類型名稱0.1an.351439896OperationRequirment作業(yè)要求0.1an.351538921PriorityCode緊急程度代碼1.1an.3代碼集5.131638920PriorityDesc

22、ription緊急程度描述0.1an.171738905GoodsPickupMethodcode提貨方式代碼1.1an.3代碼集5.141838904GoodsPickupMethodDescription提貨方式描述0.1an.171938973VehicleServiceTypeCode車輛服務(wù)類型代碼0.1an.3代碼集5.252033878Shipper托運人0.1an.1002133879ShipperCode托運人代碼0.1an.50企業(yè)自定義223ConsignorInfo裝貨方信息0.12343336Consignor發(fā)貨人0.1an.5122443337ConsignorC

23、ode發(fā)貨人代碼0.1an.17企業(yè)自定義2543412ContactName聯(lián)系人姓名1.1an.256裝貨聯(lián)系人姓名2643869TelphoneNumber聯(lián)系電話1.1an.18裝貨聯(lián)系人電話2743875MobileTelphoneNumber移動電話號碼0.1an.182843228CountrySubdivisionName國家行政區(qū)劃名稱1.1an.702943229CountrySubdivisionCode國家行政區(qū)劃代碼0.1an.12代碼集4.123043334PlaceOfLoading裝貨地點0.1an.2563132809RequestedLoadingDateT

24、ime要求裝貨時間0.1an.19YYYYMMDDhhmmss323ConsigneeInfo收貨方信息0.13343132Consignee收貨人0.1an.5123443133ConsigneeCode收貨人代碼0.1an.17企業(yè)自定義3543412ContactName聯(lián)系人姓名1.1an.25收貨聯(lián)系人姓名3643869TelphoneNumber電話號碼1.1an.18收貨聯(lián)系人電話3743875MobileTelphoneNumber移動電話號碼0.1an.183843228CountrySubdivisionName國家行政區(qū)劃名稱1.1an.703943229CountryS

25、ubdivisionCode國家行政區(qū)劃代碼0.1an.12代碼集4.124043160GoodsReceiptPlace收貨地點1.1an.2564132821RequestedUnloadedDate要求卸貨日期0.1an.19YYYYMMDDhhmmss4231825IsReturn是否回執(zhí)0.1n1代碼集5.244335077PriceCurrencyCode價格貨幣代碼0.1an.3代碼集4.604435004MonetaryAmount貨幣金額0.1n.18代收貨款數(shù)量4531829ShippingNoteStatusCode托運單狀態(tài)代碼0.1an.3代碼集4.574637824

26、GoodsSelfNumber貨物自編號0.1an.1004739842Remark備注0.1an.256483GoodsInfo貨物信息1.n4947823AriticleNumber商品條碼0.1an.355047819CargoHSNumber商品HS編碼0.1an.10代碼集4.365147820GoodsClassificationName貨物分類名稱0.1an.355247002DescriptionOfGoods貨物名稱1.1an.5125347832GoodsSpecification貨物規(guī)格0.1an.355447338ArticleBatchNumber產(chǎn)品批次號0.1an

27、.175547370TotalNumberOfPackages總件數(shù)1.1n.85647065PackageTypeCode包裝類型代碼1.1an.17代碼集4.295743880GoodsOwner貨主0.1an.1005849842Remark備注0.1an.255594ItemGrossWeight貨物毛重0.16056292GoodsItemGrossWeight貨物項毛重1.1n.166156411MeasurementUnitCode計量單位代碼0.1an.3代碼集4.28TNE：噸，KGM：千克，缺省千克624ItemValue貨物體積0.16356322Cube體積0.1n.9

28、6456411MeasurementUnitCode計量單位代碼0.1an.3代碼集4.28MTQ：立方米，LTR：升，缺省立方米653ContainerInfo容器信息0.n6647828TransortEquipmentAccessoryName運輸設(shè)備附件名稱1.1an.206747823ArtticleNumber商品條碼0.1an.356846810ContainerQuantity容器數(shù)量0.1n.6694ContainerGrossWeight容器毛重0.n7056292GoodsItemGrossWeight貨物項毛重1.1n.167156411MeasurementUnitC

29、ode計量單位代碼0.1an.3代碼集4.28TNE：噸，KGM：千克，缺省千克724ContainerValue容器體積0.n7356322Cube體積1.1n.97456411MeasurementUnitCode計量單位代碼0.1an.3代碼集4.28MTQ：立方米，LTR：升，缺省立方米7549842Remark備注0.1an.2559.2 普通貨物運輸托運狀態(tài)變化單上傳當(dāng)企業(yè)平臺將托運狀態(tài)發(fā)生改變時，需要將此托運狀態(tài)變化的情況上傳到監(jiān)管平臺。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包

30、中嵌入上傳的普通運輸托運狀態(tài)變化單報文,其報文結(jié)構(gòu)見下表。序號報文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報文頭1.1330062MessageReferenceNumber報文參考號1.1an.35報文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：普通運輸托運狀態(tài)變化單530052DocumentVersionNumber報文版本號1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingD

31、ateTime發(fā)送時間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報文功能代碼0.1an.3代碼集4.592Body報文體1.11031802ShippingNoteNumber托運單號1.1an.201131820OriginalDocumentNumber原始單號0.1an.351231829ShippingNoteStatusCode托運單狀態(tài)代碼1.1an.3代碼集4.571332867StatusChangeDateTime狀態(tài)變更時間1.1an.19YYYYMMDDhhmmss1439842Remark備注1.1an.255描述關(guān)閉

32、原因153DetailStatusInfo詳細狀態(tài)信息0.n1641812JobOrderNumber作業(yè)單號1.1an.501748802VehicleNumber車輛牌照號1.1an.351848819LicensePlateTypeCode牌照類型代碼1.1an.20代碼集4.481941833JobOrderStatusCode作業(yè)單狀態(tài)代碼1.1an.3代碼集4.572048067TransportModeCode運輸方式代碼0.1an.3代碼集4.39214Driver駕駛員1.12253412ContactName聯(lián)系人姓名1.1an.2562353869TelphoneNumb

33、er聯(lián)系電話1.1an.182443334PlaceOfLoading裝貨地點1.1an.2562542809RequestedLoadingDateTime要求裝貨時間0.1an.19YYYYMMDDhhmmss2642821RequestedUnloadedDate要求卸貨日期0.1an.19YYYYMMDDhhmmss2742171DespatchActualDateTime發(fā)運實際日期1.1an.19YYYYMMDDhhmmss2842441GoodsReceiptDateTime收貨日期0.1an.19YYYYMMDDhhmmss2942867StatusChangeDateTime

34、狀態(tài)變更時間1.1an.19YYYYMMDDhhmmss9.3 普通貨物運輸回執(zhí)單上傳當(dāng)企業(yè)平臺記錄運輸完成收到回執(zhí)時，需要將此回執(zhí)單的情況上傳到監(jiān)管平臺。l 發(fā)送方：企業(yè)通過接口發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包中嵌入上傳的普通運輸回單報文,其報文結(jié)構(gòu)見下表。序號報文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報文頭1.1330062MessageReferenceNumber報文參考號1.1an.35報文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成43

35、1000DocumentName單證名稱1.1an.35中文名稱：普通運輸回單530052DocumentVersionNumber報文版本號1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報文功能代碼0.1an.3代碼集4.592Body報文體1.11031802ShippingNoteNumber托運單號1.1an.201131820OriginalDocumentNumber原始單號0

36、.1an.351231829ShippingNoteStatusCode托運單狀態(tài)代碼1.1an.3代碼集4.571334440FreeText自由文本0.1an.512143ConsigneeInfo收貨信息0.n1542441GoodsReceiptDateTime收貨日期0.1an.19YYYYMMDDhhmmss1643160GoodsReceiptPlace收貨地點1.1an.5121743042StreetAndNumberOrPOBox街道門牌號碼/郵政信箱0.1an.2561843132Consignee收貨人1.1an.701943412ContactName聯(lián)系人姓名0.1

37、an.2562043869TelphoneNumber電話號碼0.1an.182143871FaxNumber傳真號碼0.1an.182241808IdentityDocumentNumber證件號0.1an.182351815PersonalIdentityDocumentTypeCode身份證件類別代碼0.1an.3代碼集5.12447817SignTypeCode簽收類別代碼0.1an.3代碼集5.3254GoodsInfo貨物信息0.n2657823 ArticleNumber商品條碼 0.1an.35 2757819 CargoHSNumber貨物HS編碼 0.1an.10 代碼集4

38、.36 2857820GoodsClassificationName貨物分類名稱0.1an.352957002DecriptionOfGoods貨物名稱1.1an.5123057832GoodsSpecification貨物規(guī)格0.1an.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ù)量 1.1 n.6 355 683

39、4 DamagePackagesNumber 貨物破損數(shù)量 1.1 n.6 365 6836 RejectPackagesNumber 貨物拒收數(shù)量 1.1 n.6 375 6838 MissingPackagesNumber 貨物缺件數(shù)量 1.1 n.6 383 FreightCharges運輸費用0.1394 5077 PriceCurrencyCode 價格貨幣代碼 0.1 an.3 代碼集4.60 404 5004 MonetaryAmount 貨幣金額 0.1 n.18 413CollectingFees 代收費用 0.1 424 5077 PriceCurrencyCode 價格貨

40、幣代碼 0.1 an.3 代碼集4.60 434 5004 MonetaryAmount 貨幣金額 0.1 n.18 443 9842 Remark 備注 0.1 an.255 9.4 實際承運人信息上傳企業(yè)平臺需要每日定時將實際承運人明細數(shù)據(jù)上傳到監(jiān)管平臺。l 發(fā)送方：企業(yè)通過接口定時發(fā)送；l 發(fā)送方式：異步，通過接口的傳輸服務(wù)l 接收方：監(jiān)管平臺業(yè)務(wù)接口通過調(diào)用send接口來發(fā)送請求消息，在交換數(shù)據(jù)包中嵌入上傳的實際承運人信息報文,其報文結(jié)構(gòu)見下表。序號報文層數(shù)據(jù)元標(biāo)識符XML標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型引用文件說明11RootRoot1.122Header報文頭1.1330062Mess

41、ageReferenceNumber報文參考號1.1an.35報文唯一標(biāo)識符，系統(tǒng)自動按照GUID規(guī)則生成431000DocumentName單證名稱1.1an.35中文名稱：承運人信息530052DocumentVersionNumber報文版本號1.1an.17V3.1639813SenderCode發(fā)送方代碼0.1an.20交換代碼，不填732863MessageSendingDateTime發(fā)送時間1.1an.19YYYYMMDDhhmmss831225MessageFunctionCode報文功能代碼0.1an.3代碼集4.592Body報文體1.11033126CarrierName承運人名稱1.1an.5121133127CarrierIdentifier承運人標(biāo)識符0.1an.171233926P