部网络货运信息交互系统接入指南模板.docx
《部网络货运信息交互系统接入指南模板.docx》由会员分享,可在线阅读,更多相关《部网络货运信息交互系统接入指南模板.docx(28页珍藏版)》请在冰豆网上搜索。
部网络货运信息交互系统接入指南模板
部网络货运信息交互系统接入指南
为贯彻落实《交通运输部国家税务总局关于印发<网络平台道路货物运输经营管理暂行办法>的通知》(交运规〔2019〕12号)的有关要求,指导省级网络货运信息监测系统(以下简称省级监测系统)数据及时上传至部网络货运信息交互系统(以下简称部交互系统),特制定本指南。
一、接入要求
已经完成省级监测系统建设的省份,应在2019年12月31日前接入部交互系统。
尚未建设省级监测系统的省份,应在2020年12月31日前建设完成省级监测系统并接入部交互系统。
省级监测系统建设完成前,可委托相关单位依托部交互系统的虚拟平台对辖区内网络货运进行运行监测。
(一)系统接入方式。
部交互系统接口格式:
webservice或http。
省级监测系统交换代码:
由部交互系统分配。
省级监测系统公钥私钥:
由部交互系统分配。
部交互系统网址:
。
(二)数据加密要求。
根据《信息安全技术信息系统安全等级保护基本要求》(GB/T22239)相关规定,各省交通运输主管部门应确保数据传输的安全性。
部交互系统和省级监测系统之间进行数据交换,应通过国密加密算法对报文进行加密。
(三)时效质量要求。
网络货运经营者应在运单、资金流水单完成后实时上传数据至省级监测系统,省级监测系统应在接收网络货运经营者运单、资金流水单、车辆及驾驶员基本信息后,及时上传至部交互系统。
省级监测系统应对网络货运经营者上传的单据格式进行校验,确保单据接入正常。
二、接口技术规范
(一)报文属性。
表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
1
OriginalDocumentNumber
原始单号
1..1
an..35
必填,上游企业委托运输单号。
2
1
ShippingNoteNumber
托运单号
1..1
an..20
必填,本运单单号。
3
SendToProDateTime
运单上传
时间
1..1
n14
必填,网络货运经营者上传运单到省级监测系统的时间。
YYYYMMDDhhmmss
4
1
Carrier
网络货运
经营者名称
1..1
an..512
必填。
5
1
UnifiedSocialCreditIdentifier
统一社会
信用代码
1..1
an18
必填。
6
1
PermitNumber
道路运输
经营许可证
编号
1..1
an..50
必填,网络货运经营者的道路运输经营许可证编号,网络货运经营者整合车辆全部为总质量4.5吨及以下普通货运车辆的,可填“企业所在地行政区划代码+********”。
7
1
ConsignmentDateTime
运单生成时间
1..1
n14
必填,网络货运经营者信息系统正式成交生成运单的日期时间。
YYYYMMDDhhmmss
8
1
BusinessTypeCode
业务类型代码
1..1
an..7
必填,代码集参见。
9
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/T2260-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/T2260-2017),精确到区县。
21
1
TotalMonetaryAmount
运费金额
1..1
n..18,3
必填,托运人与网络货运经营者签订运输合同确定的运费金额,货币单位为人民币(元),保留3位小数,如整数的话,以.000填充。
如是一笔业务分几辆车运,需将托运人针对这笔业务付给网络货运经营者的运输费用分摊到每辆车上。
22
1
VehicleInfo
车辆信息
1..1
23
2
VehiclePlateColorCode
车牌颜色代码
1..1
an..2
必填,代码集参见。
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
必填,代码集参见。
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位行政区域代码+********”。
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
必填,代码集参见。
未投保的,可填“无”。
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度,WGS84GPS标准。
6
1
Latitude
纬度
1..1
n..15
必填,发货或收货时的纬度。
单位:
1*10-6度,WGS84GPS标准。
7
1
CountrySubdivisionCode
发货/收货行政区划代码
1..1
an..12
必填,参照最新版《中华人民共和国行政区划代码》(GB/T2260-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
选填,代码集参见。
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
必填。
参考机动车行驶证填写,
代码集参见。
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
必填,代码集参见。
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位行政区域代码+********”。
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位+********”。
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.