部网络货运信息交互系统接入指南(原文)

时间:2022-01-19 14:01:48 作者:好伙伴网络货运 点击: 0

为贯彻落实《交通运输部 国家税务总局关于印发<网络平台道路货物运输经营管理暂行办法>的通知》(交运规〔2019〕12号)的有关要求,指导省级网络货运信息监测系统(以下简称省级监测系统)数据及时上传至部网络货运信息交互系统(以下简称部交互系统),特制定本指南。


一、接入要求

已经完成省级监测系统建设的省份,应在2019年12月31日前接入部交互系统。


尚未建设省级监测系统的省份,应在2020年12月31日前建设完成省级监测系统并接入部交互系统。省级监测系统建设完成前,可委托相关单位依托部交互系统的虚拟平台对辖区内网络货运进行运行监测。


(一)系统接入方式

部交互系统接口格式:webservice或http。

省级监测系统交换代码:由部交互系统分配。

省级监测系统公钥私钥:由部交互系统分配。

部交互系统网址:wlhy.mot.gov.cn。


(二)数据加密要求

根据《信息安全技术信息系统安全等级保护基本要求》(GB/T 22239)相关规定,各省交通运输主管部门应确保数据传输的安全性。部交互系统和省级监测系统之间进行数据交换,应通过国密加密算法对报文进行加密。


(三)时效质量要求

网络货运经营者应在运单、资金流水单完成后实时上传数据至省级监测系统,省级监测系统应在接收网络货运经营者运单、资金流水单、车辆及驾驶员基本信息后,及时上传至部交互系统。省级监测系统应对网络货运经营者上传的单据格式进行校验,确保单据接入正常。


二、接口技术规范

(一)报文属性

表2.1 报文属性

序号

属性名称

说明

1

报文层

标识数据元在报文结构中的位置和层次关系。

2

英文名称

数据元和段组的英文标记名,可用作可扩展标记语言(XML)标记名,段组是由多个数据元构成的数据实体。

3

中文名称

对数据元的中文描述。

4

约束/出现次数

数据元在报文中重复出现的次数:

a) 0..1——数据元值域可填,且出现一次;

b) 0..n——数据元值域可填,且可出现多次;

c) 1..1——数据元值域必填,且出现一次;

d) 1..n——数据元值域必填,且可出现多次。

5

数据格式

数据格式中使用的字符含义如下:

a) a = 字母字符;

b) n= 数字字符;

c) an= 字母数字汉字字符;

d) ..= 字符型数据的最小长度到最大长度的分隔符;

e) ,= 区分数字字符个数与小数点后小数位数的分隔符,即“,”前为数字字符个数,“,”后为小数点后小数位数;

f) YYYYMMDDhhmmss  = “YYYY”表示年份,“MM”表示月份,“DD”表示日期,“hh”表示小时,“mm”表示分钟,“ss”表示秒,可以视具体实际情况组合使用。

示例1:

an3..8 表示最大长度为8,最小长度为3的不定长字符。

示例2:

an5(aannn)表示定长5个字母数字字符,前2个为字母字符,后3个为数字字符。

示例3:

n..8,4表示该数值最大长度为八位数字字符、小数点后四位数字。

6

引用文件

代码型数据元值域引用的标准。

7

说明

对数据元的简要解释和应用说明。

 


(二)网络货运单据报文格式

省级监测系统上传单据接口报文格式如下:

表2.2 网络货运单据报文格式

序号

报文层

英文名称

中文名称

约束/出现次数

数据格式

说明

1

1

Root

1..1



2

2

Header

报文头

1..1



3

3

MessageReferenceNumber

报文参考号

1..1

an..35

必填,报文的唯一标识符,由系统按GUID规则自动产生。

4

3

DocumentName

报文名称

1..1

an..35

必填,报文中文名称:电子运单、位置信息单、资金流水单、车辆信息单、驾驶员信息单。

5

3

DocumentVersionNumber

报文版本号

1..1

an..17


6

3

SenderCode

发送方代码

1..1

an..20

必填,省级监测系统交换代码。

7

3

MessageSendingDateTime

发送日期

时间

1..1

n14

必填,报文发送的日期时间。YYYYMMDDhhmmss

8

3

IPCType

业务接口代码

1..1

an..16


9

3

Token

令牌

1..1

an..200


10

2

Body

报文体

1..1



11

3

EncryptedCode

对称密钥

加密串

1..1

an..128

必填,用国密SM2加密随机生成KEY后的加密字符串。

12

3

EncryptedContent

运单内容

加密串

1..1

an..8192

必填,采用国密SM4通过随机生成的KEY加密运单内容后的加密字符串。


(三)上传运单接口

业务接口代码:WLHY_YD1001,省级监测系统通过此接口向部交互系统上报企业的运单数据,运单报文格式如下:

表2.3 运单内容

序号

报文层

英文名称

中文名称

约束/出现次数

数据格式

说明

1

OriginalDocumentNumber

原始单号

1..1

an..35

必填,上游企业委托运输单号。

1

ShippingNoteNumber

托运单号

1..1

an..20

必填,本运单单号。


SendToProDateTime

运单上传

时间

1..1

n14

必填,网络货运经营者上传运单到省级监测系统的时间。YYYYMMDDhhmmss

1

Carrier

网络货运

经营者名称

1..1

an..512

必填。

1

UnifiedSocialCreditIdentifier

统一社会

信用代码

1..1

an18

必填。

1

PermitNumber

道路运输

经营许可证

编号

1..1

an..50

必填,网络货运经营者的道路运输经营许可证编号,网络货运经营者整合车辆全部为总质量4.5吨及以下普通货运车辆的,可填“企业所在地行政区划代码+000000”。

1

ConsignmentDateTime

运单生成时间

1..1

n14

必填,网络货运经营者信息系统正式成交生成运单的日期时间。YYYYMMDDhhmmss

1

BusinessTypeCode

业务类型代码

1..1

an..7

必填,代码集参见wlhy.mot.gov.cn。

1

DespatchActualDateTime

发货日期时间

1..1

n14

必填,货物装车后的发车时间。YYYYMMDDhhmmss

10 

1

GoodsReceiptDateTime

收货日期时间

1..1

n14

必填,货物运到后的签收时间。

YYYYMMDDhhmmss

11 

1

ConsignorInfo

托运人信息

1..1



12 

2

Consignor

托运人名称

1..1

an..512

必填。

13 

2

ConsignorID

托运人统一社会信用代码或个人证件号

1..1

an..35

必填。

14 

2

PlaceOfLoading

装货地址

0..1

an..256

选填,实际装货的地点。

15 

2

CountrySubdivisionCode

装货地点的国家行政区划代码

1..1

an..12

必填,参照最新版《中华人民共和国行政区划代码》(GB/T 2260-2017),精确到区县。

16 

1

ConsigneeInfo

收货方信息

1..1



17 

2

Consignee

收货方名称

1..1

an..512

必填。

18 

2

ConsigneeID

收货方统一社会信用代码或个人证件号码

1..1

an..35

必填。

19 

2

GoodsReceiptPlace

收货地址

0..1

an..256

选填。

20 

2

CountrySubdivisionCode

收货地点的国家行政区划代码

1..1

an..12

必填,参照最新版《中华人民共和国行政区划代码》(GB/T 2260-2017),精确到区县。

21 

1

TotalMonetaryAmount

运费金额

1..1

n..18,3

必填,托运人与网络货运经营者签订运输合同确定的运费金额,货币单位为人民币(元),保留3位小数,如整数的话,以.000填充。如是一笔业务分几辆车运,需将托运人针对这笔业务付给网络货运经营者的运输费用分摊到每辆车上。

22 

1

VehicleInfo

车辆信息

1..1



23 

2

VehiclePlateColorCode

车牌颜色代码

1..1

an..2

必填,代码集参见wlhy.mot.gov.cn。

24 

2

VehicleNumber

车辆牌照号

1..1

an..35

必填。

25 

2

Driver

驾驶员

1..n


必填,如运输过程中有多个驾驶员,可循环。

26 

3

DriverName

姓名

1..1

an..30

必填,驾驶员姓名。

27 

3

DrivingLicense

机动车驾驶证编号

1..1

an..18

必填,根据机动车驾驶证填写。

28 

2

GoodsInfo

货物信息

1..n


如一车货有不同货物,则可循环。

29 

3

DescriptionOfGoods

货物名称

1..1

an..512

必填。

30 

3

CargoTypeClassificationCode

货物类型

分类代码

1..1

an..3

必填,代码集参见wlhy.mot.gov.cn。

31 

3

GoodsItemGrossWeight

货物项毛重

1..1

n..14,3

必填,重量单位以KGM千克填写数值,保留3位小数,如整数的话,以.000填充。小数点不计入总长。如是轻泡货等货物,请估算重量。如一笔业务分几辆车运,需报送每辆车实际运输的货物重量。

32 

3

Cube

体积

0..1

n..9,4

选填,体积单位以DMQ立方米填写数值,保留4位小数,如整数的话,以.0000填充。小数点不计入总长。

33 

3

TotalNumberOfPackages

总件数

0..1

n..8

选填。

34 

1

ActualCarrierInfo

实际承运人信息

1



35 

2

ActualCarrierName

实际承运人名称

1..1

an..256

必填,与网络货运经营者签订运输合同,实际完成运输的经营者。

取得道路运输经营许可证的个体运输业户,直接填写“许可证上的业户名称”;

其他情况填写“运输公司名称(实际承运驾驶员姓名)”。

36 

2

ActualCarrierBusinessLicense

实际承运人道路运输经营许可证号

1..1

an..50

必填,实际承运人的道路运输经营许可证编号,网络货运经营者整合车辆全部为总质量4.5吨及以下普通货运车辆的,可填“车籍地6位行政区域代码+000000”。

37 

2

ActualCarrierID

实际承运人统一社会信用代码或证件号码

1..1

an..50

必填。

38 

1

InsuranceInformation

保险信息

1..1


必填。

39 

2

PolicyNumber

保险单号

1..1

an..30

必填,未投保的,可填none。

40 

2

InsuranceCompany

保险公司

名称

1..1

an..30

必填,代码集参见wlhy.mot.gov.cn。未投保的,可填“无”。

41 

1

Remark

备注

0..1

an..256

选填。


(四)上传位置信息接口

省级监测系统通过此接口,在运单起运和确认送达时,经驾驶员授权同意后,实时采集和上传驾驶员地理位置信息,报文格式如下:

表2.4 位置信息表单内容

序号

报文层

英文名称

中文名称

约束/出现次数

数据

格式

说明

1

1

SendToProDateTime

表单上传

时间

1..1

n14

必填,本位置信息表单上传到省级监测系统的时间。YYYYMMDDhhmmss

2

1

ShippingNoteNumber

对应运单号

1..1

an..20

必填,本位置信息对应的运单的单号,对应运单内容中第2项。。

3

1

LocationType

位置类型

1..1

n1

必填,0:发货;1:收货。

4

1

SendDateTime

发货/收货时间

1..1

n14

必填,发货或收货的时间。YYYYMMDDhhmmss

5

1

Longitude

经度

1..1

n..15

必填,发货或收货时的经度。

单位:1*10-6度,WGS84 GPS标准。

6

1

Latitude

纬度

1..1

n..15

必填,发货或收货时的纬度。

单位:1*10-6度,WGS84 GPS标准。

7

1

CountrySubdivisionCode

发货/收货行政区划代码

1..1

an..12

必填,参照最新版《中华人民共和国行政区划代码》(GB/T 2260-2017),精确到区县。

8

1

LocationText

地点信息

0..1

an..256

选填,发货或收货时的地址。

 

(五)上传资金流水单接口

业务接口代码:WLHY_JZ1001,省级监测系统需通过此接口上传资金流水单报文,报文格式如下:

表2.5资金流水单内容

序号

报文层

英文名称

中文名称

约束/出现次数

数据

格式

说明

1

1

DocumentNumber

单证号

1…1

an..35

必填,本资金流水单号。

2

1

SendToProDateTime

资金流水单上传时间

1..1

an..14

必填,本资金流水单上传到省级监测系统的时间。

3

1

Carrier

实际承运人名称

1..1

an..512

必填,对应运单技术规范中第35项。

4

1

ActualCarrierID

实际承运人统一社会信用代码或证件号码

1..1

an..50

必填,对应运单技术规范中第37项。

5

1

VehicleNumber

车辆牌照号

1..1

an..35

对应运单技术规范中第24项。

6

1

VehiclePlateColorCode

车牌颜色代码

1..1

n..2

对应运单技术规范中第23项。

7

1

ShippingNoteList

运单列表

1..n


必填。

8

2

ShippingNoteNumber

托运单号

1..1

an..20

必填,对应运单技术规范中第2项。

9

1

Financiallist

财务列表

1..n


必填。

10

2

PaymentMeansCode

付款方式代码

1..1

an..3

必填,33银行汇票;39银行转账;7第三方平台支付;71支付宝支付;72微信支付;9 其他电子支付方式。

11

2

Recipient

收款方名称

1..1

an..512

必填。

12

2

ReceiptAccount

收款帐户信息

1..1

an..512

必填,银行卡号或其他收款帐号。

13

2

BankCode

银行代码

0..1

an..11

选填,代码集参见wlhy.mot.gov.cn。

14

2

SequenceCode

流水号/

序列号

1..1

an..50

必填,银行或第三方支付平台的资金流水单号,现金等其他方式可填财务记账号。

15

2

MonetaryAmount

实际支付金额

1..1

n..18,3

必填,资金流水金额,货币单位为人民币,保留3位小数,如整数的话,以.000填充。

16

2

DateTime

日期时间

1..1

n14

资金流水实际发生时间。YYYYMMDDhhmmss

 


(六)上传车辆基本信息接口

业务接口代码:WLHY_CL1001,省级监测系统需通过此接口上传车辆基本信息报文,报文格式如下:

表2.6车辆基本信息报文格式

序号

报文层

英文名称

中文名称

约束/出现次数

数据格式

说明

1

1

VehicleNumber

车辆牌照号

1..1

an..35

必填,对应运单技术规范第24项。

2

1

VehiclePlateColorCode

车牌颜色代码

1..1

an..2

必填,对应运单技术规范第23项。

3

1

VehicleType

车辆类型代码

1..1

an..3

必填。参考机动车行驶证填写,

代码集参见wlhy.mot.gov.cn。

5

1

Owner

所有人

1..1

an..128

必填,按照机动车行驶证填写。

6

1

UseCharacter

使用性质

1..1

an..20

必填,按照机动车行驶证填写。

7

1

VIN

车辆识别代号

1..1

an..32

可填,按照机动车行驶证填写。

8

1

IssuingOrganizations

发证机关

1..1

an..128

必填,按照机动车行驶证填写。

9

1

RegisterDate

注册日期

1..1

n8

必填,按照机动车行驶证填写。YYYYMMDD

10

1

IssueDate

发证日期

1..1

n8

必填,按照机动车行驶证填写。YYYYMMDD

11

1

VehicleEnergyType

车辆能源类型

1..1

an..12

必填,代码集参见wlhy.mot.gov.cn。

12

1

VehicleTonnage

核定载质量

1..1

n..9,2

必填,参考机动车行驶证填写,默认单位:吨,保留两位小数,如整数的话,以.00填充。小数点不计入总长。

13

1

GrossMass

总质量

1..1

n..9,2

必填,参考机动车行驶证填写,默认单位:吨,保留两位小数,如整数的话,以.00填充。小数点不计入总长。

14

1

RoadTransportCertificateNumber

道路运输证号

1..1

n12

必填,总质量4.5吨及以下普通货运车辆的,可填“车籍地6位行政区域代码+000000”。

15

1

TrailerVehiclePlateNumber

挂车牌照号

0..1

an..35

可填。

16

1

Remark

备注

1..1

an..256

选填。

 

 (七)上传驾驶员基本信息接口

业务接口代码:WLHY_JSY1001,省级监测系统需通过此接口上传驾驶员基本信息报文,报文格式如下:

表2.7驾驶员基本信息报文格式

序号

报文层

英文名称

中文名称

约束/出现次数

数据格式

说明

1

1

DriverName

姓名

1..1

an..30

必填,根据机动车驾驶证填写。

2

1

DrivingLicense

驾驶证编号

1..1

an..18

必填,根据机动车驾驶证填写。

3

1

VehicleClass

准驾车型

1..1

an..20

必填,根据机动车驾驶证填写。

4

1

IssuingOrganizations

驾驶证发证机关

1..1

an..128

必填,根据机动车驾驶证填写。

5

1

ValidPeriodFrom

驾驶证有效期自

1..1

n8

必填,根据机动车驾驶证填写。YYYYMMDD

6

1

ValidPeriodTo

驾驶证有效期至

1..1

n8

必填,根据机动车驾驶证填写。YYYYMMDD

7

1

QualificationCertificate

从业资格证号

1..1

an..18

必填,驾驶员从业资格证号,使用总质量4.5吨及以下普通货运车辆从事普通货物运输经营的驾驶员,填写“驾驶员身份证前6位+000000000000”。

8

1

Telephone

手机号码

1..1

an..18

必填。

9

1

Remark

备注

1..1

an..256

选填。

 

(八)身份验证

用户首次调用接口,必须先进行身份验证,验证通过后生成令牌。令牌是系统唯一接口调用凭证,有效期2小时。令牌失效后需再调用身份验证接口重新获取令牌。

有效期说明:令牌持续使用,会自动延期,2小时内未被使用将失效。网络货运经营者应在确认令牌失效后,再申请新令牌。新令牌生效后,旧令牌立即失效。多单据同时上传需调用多个业务接口时,从共享缓存中获取令牌。

业务接口代码(IPCType):YZ1001。

请求报文格式见表2.8,应答报文格式见表2.9。

表2.8身份验证请求报文格式

序号

数据

层次

英文名称

中文名称

标记

数据类型

和长度

要求或说明

1

1

User

用户

1..1

an..50

统一分配

2

1

Password

密码

1..1

an..100

统一分配

 

表2.9身份验证应答报文格式

序号

数据层次

英文名称

中文名称

标记

数据类型和长度

要求或说明

1

1

Token

令牌

1..1

an..200

2小时有效


三、异常情况说明及处理

(一)异常情况说明

部交互系统将对省级监测系统上报的数据信息进行异常情况的校验分析,包括:单据接入异常、车辆资质异常、驾驶员资质异常、车辆入网异常、运单重复出现、运输轨迹异常、运单与资金流水单匹配异常等。


1.单据接入异常,指上报的单据未按填报要求填报,存在必填项未填或填报数据格式不符合要求和基本逻辑的问题。


2.车辆资质异常,指运单中的车辆信息与部交互系统、全国道路运政管理信息系统的车辆信息比对,存在车辆基础信息未上传、车辆无道路运输证、证件过期、信息不符的情况。


3.驾驶员资质异常,指运单中的驾驶员信息与部交互系统、全国道路运政管理信息系统的驾驶员信息比对,存在驾驶员基础信息未上传、驾驶员无从业资格证、证件过期、信息不符的情况。


4.车辆入网异常,指总质量12吨及以上的重型普通载货汽车和半挂牵引车未接入全国道路货运车辆公共监管与服务平台。


5.运单重复出现,指车牌号、起讫点、起讫时间相同的运单多次出现,且货运量合计超过车辆核定载质量。


6.运输轨迹异常,包含以下两种情况:

(1)车辆定位异常,指使用总质量12吨及以上货运车辆进行运输的网络货运经营者,上报运单起讫点信息与运单中车辆在全国道路货运车辆公共监管与服务平台的轨迹定位信息比对,位置信息不符。

(2)驾驶员定位异常,指运单起讫点信息与上传的驾驶员位置信息比对不符。


7.运单与资金流水单匹配异常,指网络货运经营者委托实际承运人完成的运输业务没有对应的资金流水记录。

注:如一条单据中含以上任意一种或几种异常的,则该单据为异常单据。综合异常率为一定时期内异常单据占总上传单据量的比例。


(二)异常情况处理

部交互系统将对省级监测系统上报的数据进行校验,设置单据异常率预警,将异常率较高的网络货运经营者相关信息推送至省级监测系统。地方负有道路运输监督管理职责的机构应在收到上级交通运输主管部门通知后,及时核查异常信息,并督促网络货运经营者整改。


四、相关服务

部交互系统将为网络货运经营者提供人、车、户资质信息查询、总质量12吨及以上重型载货汽车和半挂牵引车入网信息查询等服务,为网络货运经营者严格用户审核、加强相关资质信息核验提供支撑。