部網(wǎng)絡(luò)貨運信息交互系統(tǒng)接入指南

1、部網(wǎng)絡(luò)貨運信息交互系統(tǒng)接入指南為貫徹落實交通運輸部 國家稅務(wù)總局關(guān)于印發(fā)<網(wǎng)絡(luò)平臺道路貨物運輸經(jīng)營管理暫行辦法>的通知（交運規(guī)201912號）的有關(guān)要求，指導(dǎo)省級網(wǎng)絡(luò)貨運信息監(jiān)測系統(tǒng)（以下簡稱省級監(jiān)測系統(tǒng)）數(shù)據(jù)及時上傳至部網(wǎng)絡(luò)貨運信息交互系統(tǒng)（以下簡稱部交互系統(tǒng)），特制定本指南。一、接入要求已經(jīng)完成省級監(jiān)測系統(tǒng)建設(shè)的省份，應(yīng)在2019年12月31日前接入部交互系統(tǒng)。尚未建設(shè)省級監(jiān)測系統(tǒng)的省份，應(yīng)在2020年12月31日前建設(shè)完成省級監(jiān)測系統(tǒng)并接入部交互系統(tǒng)。省級監(jiān)測系統(tǒng)建設(shè)完成前，可委托相關(guān)單位依托部交互系統(tǒng)的虛擬平臺對轄區(qū)內(nèi)網(wǎng)絡(luò)貨運進行運行監(jiān)測。（一）系統(tǒng)接入方式。部交互系統(tǒng)接口

2、格式：webservice或http。省級監(jiān)測系統(tǒng)交換代碼：由部交互系統(tǒng)分配。省級監(jiān)測系統(tǒng)公鑰私鑰：由部交互系統(tǒng)分配。部交互系統(tǒng)網(wǎng)址：。（二）數(shù)據(jù)加密要求。根據(jù)信息安全技術(shù)信息系統(tǒng)安全等級保護基本要求（GB/T 22239）相關(guān)規(guī)定，各省交通運輸主管部門應(yīng)確保數(shù)據(jù)傳輸?shù)陌踩?。部交互系統(tǒng)和省級監(jiān)測系統(tǒng)之間進行數(shù)據(jù)交換，應(yīng)通過國密加密算法對報文進行加密。（三）時效質(zhì)量要求。網(wǎng)絡(luò)貨運經(jīng)營者應(yīng)在運單、資金流水單完成后實時上傳數(shù)據(jù)至省級監(jiān)測系統(tǒng)，省級監(jiān)測系統(tǒng)應(yīng)在接收網(wǎng)絡(luò)貨運經(jīng)營者運單、資金流水單、車輛及駕駛員基本信息后，及時上傳至部交互系統(tǒng)。省級監(jiān)測系統(tǒng)應(yīng)對網(wǎng)絡(luò)貨運經(jīng)營者上傳的單據(jù)格式進行校驗，確保單

3、據(jù)接入正常。二、接口技術(shù)規(guī)范（一）報文屬性。表2.1 報文屬性序號屬性名稱說明1報文層標識數(shù)據(jù)元在報文結(jié)構(gòu)中的位置和層次關(guān)系。2英文名稱數(shù)據(jù)元和段組的英文標記名，可用作可擴展標記語言（XML）標記名，段組是由多個數(shù)據(jù)元構(gòu)成的數(shù)據(jù)實體。3中文名稱對數(shù)據(jù)元的中文描述。4約束/出現(xiàn)次數(shù)數(shù)據(jù)元在報文中重復(fù)出現(xiàn)的次數(shù)：a) 0.1數(shù)據(jù)元值域可填，且出現(xiàn)一次；b) 0.n數(shù)據(jù)元值域可填，且可出現(xiàn)多次；c) 1.1數(shù)據(jù)元值域必填，且出現(xiàn)一次；d) 1.n數(shù)據(jù)元值域必填，且可出現(xiàn)多次。5數(shù)據(jù)格式數(shù)據(jù)格式中使用的字符含義如下：a) a = 字母字符；b) n= 數(shù)字字符；c) an= 字母數(shù)字漢字字符；d) .

4、= 字符型數(shù)據(jù)的最小長度到最大長度的分隔符；e) ，= 區(qū)分數(shù)字字符個數(shù)與小數(shù)點后小數(shù)位數(shù)的分隔符，即“，”前為數(shù)字字符個數(shù)，“，”后為小數(shù)點后小數(shù)位數(shù)；f) YYYYMMDDhhmmss = “YYYY”表示年份，“MM”表示月份，“DD”表示日期，“hh”表示小時，“mm”表示分鐘，“ss”表示秒，可以視具體實際情況組合使用。示例1：an3.8 表示最大長度為8，最小長度為3的不定長字符。示例2：an5(aannn)表示定長5個字母數(shù)字字符，前2個為字母字符，后3個為數(shù)字字符。示例3：n.8,4表示該數(shù)值最大長度為八位數(shù)字字符、小數(shù)點后四位數(shù)字。6引用文件代碼型數(shù)據(jù)元值域引用的標準。7說明

5、對數(shù)據(jù)元的簡要解釋和應(yīng)用說明。20（二）網(wǎng)絡(luò)貨運單據(jù)報文格式。省級監(jiān)測系統(tǒng)上傳單據(jù)接口報文格式如下：表2.2 網(wǎng)絡(luò)貨運單據(jù)報文格式序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)據(jù)格式說明11Root根1.122Header報文頭1.133MessageReferenceNumber報文參考號1.1an.35必填，報文的唯一標識符，由系統(tǒng)按GUID規(guī)則自動產(chǎn)生。43DocumentName報文名稱1.1an.35必填，報文中文名稱：電子運單、位置信息單、資金流水單、車輛信息單、駕駛員信息單。53DocumentVersionNumber報文版本號1.1an.1763SenderCode發(fā)送方代碼1.

6、1an.20必填，省級監(jiān)測系統(tǒng)交換代碼。73MessageSendingDateTime發(fā)送日期時間1.1n14必填，報文發(fā)送的日期時間。YYYYMMDDhhmmss83IPCType業(yè)務(wù)接口代碼1.1an.1693Token令牌1.1an.200102Body報文體1.1113EncryptedCode對稱密鑰加密串1.1an.128必填，用國密SM2加密隨機生成KEY后的加密字符串。123EncryptedContent運單內(nèi)容加密串1.1an.8192必填，采用國密SM4通過隨機生成的KEY加密運單內(nèi)容后的加密字符串。（三）上傳運單接口。業(yè)務(wù)接口代碼：WLHY_YD1001，省級監(jiān)測系統(tǒng)

7、通過此接口向部交互系統(tǒng)上報企業(yè)的運單數(shù)據(jù)，運單報文格式如下：表2.3 運單內(nèi)容序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)據(jù)格式說明11OriginalDocumentNumber原始單號1.1an.35必填，上游企業(yè)委托運輸單號。21ShippingNoteNumber托運單號1.1an.20必填，本運單單號。3SendToProDateTime運單上傳時間1.1n14必填，網(wǎng)絡(luò)貨運經(jīng)營者上傳運單到省級監(jiān)測系統(tǒng)的時間。YYYYMMDDhhmmss41Carrier網(wǎng)絡(luò)貨運經(jīng)營者名稱1.1an.512必填。51UnifiedSocialCreditIdentifier統(tǒng)一社會信用代碼1.1an1

8、8必填。61PermitNumber道路運輸經(jīng)營許可證編號1.1an.50必填，網(wǎng)絡(luò)貨運經(jīng)營者的道路運輸經(jīng)營許可證編號，網(wǎng)絡(luò)貨運經(jīng)營者整合車輛全部為總質(zhì)量4.5噸及以下普通貨運車輛的，可填“企業(yè)所在地行政區(qū)劃代碼+000000”。71ConsignmentDateTime運單生成時間1.1n14必填，網(wǎng)絡(luò)貨運經(jīng)營者信息系統(tǒng)正式成交生成運單的日期時間。YYYYMMDDhhmmss81BusinessTypeCode業(yè)務(wù)類型代碼1.1an.7必填，代碼集參見。91DespatchActualDateTime發(fā)貨日期時間1.1n14必填，貨物裝車后的發(fā)車時間。YYYYMMDDhhmmss101Goo

9、dsReceiptDateTime收貨日期時間1.1n14必填，貨物運到后的簽收時間。YYYYMMDDhhmmss111ConsignorInfo托運人信息1.1122Consignor托運人名稱1.1an.512必填。132ConsignorID托運人統(tǒng)一社會信用代碼或個人證件號1.1an.35必填。142PlaceOfLoading裝貨地址0.1an.256選填，實際裝貨的地點。152CountrySubdivisionCode裝貨地點的國家行政區(qū)劃代碼1.1an.12必填，參照最新版中華人民共和國行政區(qū)劃代碼（GB/T 2260-2017），精確到區(qū)縣。161ConsigneeInfo收

10、貨方信息1.1172Consignee收貨方名稱1.1an.512必填。182ConsigneeID收貨方統(tǒng)一社會信用代碼或個人證件號碼1.1an.35必填。192GoodsReceiptPlace收貨地址0.1an.256選填。202CountrySubdivisionCode收貨地點的國家行政區(qū)劃代碼1.1an.12必填，參照最新版中華人民共和國行政區(qū)劃代碼（GB/T 2260-2017），精確到區(qū)縣。211TotalMonetaryAmount運費金額1.1n.18,3必填，托運人與網(wǎng)絡(luò)貨運經(jīng)營者簽訂運輸合同確定的運費金額，貨幣單位為人民幣（元），保留3位小數(shù)，如整數(shù)的話，以.000填充

11、。如是一筆業(yè)務(wù)分幾輛車運，需將托運人針對這筆業(yè)務(wù)付給網(wǎng)絡(luò)貨運經(jīng)營者的運輸費用分攤到每輛車上。221VehicleInfo車輛信息1.1232VehiclePlateColorCode車牌顏色代碼1.1an.2必填，代碼集參見。242VehicleNumber車輛牌照號1.1an.35必填。252Driver駕駛員1.n必填，如運輸過程中有多個駕駛員，可循環(huán)。263DriverName姓名1.1an.30必填，駕駛員姓名。273DrivingLicense機動車駕駛證編號1.1an.18必填，根據(jù)機動車駕駛證填寫。282GoodsInfo貨物信息1.n如一車貨有不同貨物，則可循環(huán)。293Desc

12、riptionOfGoods貨物名稱1.1an.512必填。303CargoTypeClassificationCode貨物類型分類代碼1.1an.3必填，代碼集參見。313GoodsItemGrossWeight貨物項毛重1.1n.14,3必填，重量單位以KGM千克填寫數(shù)值，保留3位小數(shù)，如整數(shù)的話，以.000填充。小數(shù)點不計入總長。如是輕泡貨等貨物，請估算重量。如一筆業(yè)務(wù)分幾輛車運，需報送每輛車實際運輸?shù)呢浳镏亓俊?23Cube體積0.1n.9,4選填，體積單位以DMQ立方米填寫數(shù)值，保留4位小數(shù)，如整數(shù)的話，以.0000填充。小數(shù)點不計入總長。333TotalNumberOfPackag

13、es總件數(shù)0.1n.8選填。341ActualCarrierInfo實際承運人信息1352ActualCarrierName實際承運人名稱1.1an.256必填，與網(wǎng)絡(luò)貨運經(jīng)營者簽訂運輸合同，實際完成運輸?shù)慕?jīng)營者。取得道路運輸經(jīng)營許可證的個體運輸業(yè)戶，直接填寫“許可證上的業(yè)戶名稱”；其他情況填寫“運輸公司名稱（實際承運駕駛員姓名）”。362ActualCarrierBusinessLicense實際承運人道路運輸經(jīng)營許可證號1.1an.50必填，實際承運人的道路運輸經(jīng)營許可證編號，網(wǎng)絡(luò)貨運經(jīng)營者整合車輛全部為總質(zhì)量4.5噸及以下普通貨運車輛的，可填“車籍地6位行政區(qū)域代碼+000000”。37

14、2ActualCarrierID實際承運人統(tǒng)一社會信用代碼或證件號碼1.1an.50必填。381InsuranceInformation保險信息1.1必填。392PolicyNumber保險單號1.1an.30必填，未投保的，可填none。402InsuranceCompany保險公司名稱1.1an.30必填，代碼集參見。未投保的，可填“無”。411Remark備注0.1an.256選填。（四）上傳位置信息接口。省級監(jiān)測系統(tǒng)通過此接口，在運單起運和確認送達時，經(jīng)駕駛員授權(quán)同意后，實時采集和上傳駕駛員地理位置信息，報文格式如下：表2.4 位置信息表單內(nèi)容序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)

15、據(jù)格式說明11SendToProDateTime表單上傳時間1.1n14必填，本位置信息表單上傳到省級監(jiān)測系統(tǒng)的時間。YYYYMMDDhhmmss21ShippingNoteNumber對應(yīng)運單號1.1an.20必填，本位置信息對應(yīng)的運單的單號，對應(yīng)運單內(nèi)容中第2項。31LocationType位置類型1.1n1必填，0：發(fā)貨；1：收貨。41SendDateTime發(fā)貨/收貨時間1.1n14必填，發(fā)貨或收貨的時間。YYYYMMDDhhmmss51Longitude經(jīng)度1.1n.15必填，發(fā)貨或收貨時的經(jīng)度。單位：1*10-6度，WGS84 GPS標準。61Latitude緯度1.1n.15必填

16、，發(fā)貨或收貨時的緯度。單位：1*10-6度，WGS84 GPS標準。71CountrySubdivisionCode發(fā)貨/收貨行政區(qū)劃代碼1.1an.12必填，參照最新版中華人民共和國行政區(qū)劃代碼（GB/T 2260-2017），精確到區(qū)縣。81LocationText地點信息0.1an.256選填，發(fā)貨或收貨時的地址。(五)上傳資金流水單接口。業(yè)務(wù)接口代碼：WLHY_JZ1001，省級監(jiān)測系統(tǒng)需通過此接口上傳資金流水單報文，報文格式如下：表2.5資金流水單內(nèi)容序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)據(jù)格式說明11DocumentNumber單證號11an.35必填，本資金流水單號。21Se

17、ndToProDateTime資金流水單上傳時間1.1an.14必填，本資金流水單上傳到省級監(jiān)測系統(tǒng)的時間。31Carrier實際承運人名稱1.1an.512必填，對應(yīng)運單技術(shù)規(guī)范中第35項。41ActualCarrierID實際承運人統(tǒng)一社會信用代碼或證件號碼1.1an.50必填，對應(yīng)運單技術(shù)規(guī)范中第37項。51VehicleNumber車輛牌照號1.1an.35對應(yīng)運單技術(shù)規(guī)范中第24項。61VehiclePlateColorCode車牌顏色代碼1.1n.2對應(yīng)運單技術(shù)規(guī)范中第23項。71ShippingNoteList運單列表1.n必填。82ShippingNoteNumber托運單號1

18、.1an.20必填，對應(yīng)運單技術(shù)規(guī)范中第2項。91Financiallist財務(wù)列表1.n必填。102PaymentMeansCode付款方式代碼1.1an.3必填，33銀行匯票；39銀行轉(zhuǎn)賬；7第三方平臺支付；71支付寶支付；72微信支付；9 其他電子支付方式。112Recipient收款方名稱1.1an.512必填。122ReceiptAccount收款帳戶信息1.1an.512必填，銀行卡號或其他收款帳號。132BankCode銀行代碼0.1an.11選填，代碼集參見。142SequenceCode流水號/序列號1.1an.50必填，銀行或第三方支付平臺的資金流水單號，現(xiàn)金等其他方式可填

19、財務(wù)記賬號。152MonetaryAmount實際支付金額1.1n.18,3必填，資金流水金額，貨幣單位為人民幣，保留3位小數(shù)，如整數(shù)的話，以.000填充。162DateTime日期時間1.1n14資金流水實際發(fā)生時間。YYYYMMDDhhmmss(六)上傳車輛基本信息接口。業(yè)務(wù)接口代碼：WLHY_CL1001，省級監(jiān)測系統(tǒng)需通過此接口上傳車輛基本信息報文，報文格式如下：表2.6車輛基本信息報文格式序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)據(jù)格式說明11VehicleNumber車輛牌照號1.1an.35必填，對應(yīng)運單技術(shù)規(guī)范第24項。21VehiclePlateColorCode車牌顏色代碼

20、1.1an.2必填，對應(yīng)運單技術(shù)規(guī)范第23項。31VehicleType車輛類型代碼1.1an.3必填。參考機動車行駛證填寫，代碼集參見。51Owner所有人1.1an.128必填，按照機動車行駛證填寫。61UseCharacter使用性質(zhì)1.1an.20必填，按照機動車行駛證填寫。71VIN車輛識別代號1.1an.32可填，按照機動車行駛證填寫。81IssuingOrganizations發(fā)證機關(guān)1.1an.128必填，按照機動車行駛證填寫。91RegisterDate注冊日期1.1n8必填，按照機動車行駛證填寫。YYYYMMDD101IssueDate發(fā)證日期1.1n8必填，按照機動車行駛

21、證填寫。YYYYMMDD111VehicleEnergyType車輛能源類型1.1an.12必填，代碼集參見。121VehicleTonnage核定載質(zhì)量1.1n.9,2必填，參考機動車行駛證填寫，默認單位：噸，保留兩位小數(shù)，如整數(shù)的話，以.00填充。小數(shù)點不計入總長。131GrossMass總質(zhì)量1.1n.9,2必填，參考機動車行駛證填寫，默認單位：噸，保留兩位小數(shù)，如整數(shù)的話，以.00填充。小數(shù)點不計入總長。141RoadTransportCertificateNumber道路運輸證號1.1n12必填，總質(zhì)量4.5噸及以下普通貨運車輛的，可填“車籍地6位行政區(qū)域代碼+000000”。151

22、TrailerVehiclePlateNumber掛車牌照號0.1an.35可填。161Remark備注1.1an.256選填。(七)上傳駕駛員基本信息接口。業(yè)務(wù)接口代碼：WLHY_JSY1001，省級監(jiān)測系統(tǒng)需通過此接口上傳駕駛員基本信息報文，報文格式如下：表2.7駕駛員基本信息報文格式序號報文層英文名稱中文名稱約束/出現(xiàn)次數(shù)數(shù)據(jù)格式說明11DriverName姓名1.1an.30必填，根據(jù)機動車駕駛證填寫。21DrivingLicense駕駛證編號1.1an.18必填，根據(jù)機動車駕駛證填寫。31VehicleClass準駕車型1.1an.20必填，根據(jù)機動車駕駛證填寫。41IssuingO

23、rganizations駕駛證發(fā)證機關(guān)1.1an.128必填，根據(jù)機動車駕駛證填寫。51ValidPeriodFrom駕駛證有效期自1.1n8必填，根據(jù)機動車駕駛證填寫。YYYYMMDD61ValidPeriodTo駕駛證有效期至1.1n8必填，根據(jù)機動車駕駛證填寫。YYYYMMDD71QualificationCertificate從業(yè)資格證號1.1an.18必填，駕駛員從業(yè)資格證號，使用總質(zhì)量4.5噸及以下普通貨運車輛從事普通貨物運輸經(jīng)營的駕駛員，填寫“駕駛員身份證前6位+000000000000”。81Telephone手機號碼1.1an.18必填。91Remark備注1.1an.256

24、選填。（八）身份驗證。用戶首次調(diào)用接口，必須先進行身份驗證，驗證通過后生成令牌。令牌是系統(tǒng)唯一接口調(diào)用憑證，有效期2小時。令牌失效后需再調(diào)用身份驗證接口重新獲取令牌。有效期說明：令牌持續(xù)使用，會自動延期，2小時內(nèi)未被使用將失效。網(wǎng)絡(luò)貨運經(jīng)營者應(yīng)在確認令牌失效后，再申請新令牌。新令牌生效后，舊令牌立即失效。多單據(jù)同時上傳需調(diào)用多個業(yè)務(wù)接口時，從共享緩存中獲取令牌。業(yè)務(wù)接口代碼（IPCType）：YZ1001。請求報文格式見表2.8，應(yīng)答報文格式見表2.9。表2.8身份驗證請求報文格式序號數(shù)據(jù)層次英文名稱中文名稱標記數(shù)據(jù)類型和長度要求或說明11User用戶1.1an.50統(tǒng)一分配21Passwor

25、d密碼1.1an.100統(tǒng)一分配表2.9身份驗證應(yīng)答報文格式序號數(shù)據(jù)層次英文名稱中文名稱標記數(shù)據(jù)類型和長度要求或說明11Token令牌1.1an.2002小時有效三、異常情況說明及處理（一）異常情況說明。部交互系統(tǒng)將對省級監(jiān)測系統(tǒng)上報的數(shù)據(jù)信息進行異常情況的校驗分析，包括：單據(jù)接入異常、車輛資質(zhì)異常、駕駛員資質(zhì)異常、車輛入網(wǎng)異常、運單重復(fù)出現(xiàn)、運輸軌跡異常、運單與資金流水單匹配異常等。1.單據(jù)接入異常，指上報的單據(jù)未按填報要求填報，存在必填項未填或填報數(shù)據(jù)格式不符合要求和基本邏輯的問題。2.車輛資質(zhì)異常，指運單中的車輛信息與部交互系統(tǒng)、全國道路運政管理信息系統(tǒng)的車輛信息比對，存在車輛基礎(chǔ)信息未上傳、車輛無道路運輸證、證