危险货物道路运输电子运单信息交互技术规范

　危险货物道路运输电子运单信息交互技术规范

　 1 目 目

　 录

　一、适用范围 ······························································ 1

　二、编制依据 ······························································ 1

　三、术语定义 ······························································ 2

　（一）危险货物道路运输电子运单（以下简称运单）

　··············· 2

　（二）危险货物道路运输纸质运单 ······································· 2

　（三）运单状态 ······························································· 2

　（四）城市配送 ······························································· 2

　四、运单信息格式 ························································ 3

　（一）运单数据项定义 ······················································ 3

　（二）运单二维码 ···························································· 6

　五、交互要求 ······························································ 7

　（一）系统接入方式 ························································· 7

　（二）数据加密要求 ························································· 7

　（三）时效质量要求 ························································· 8

　六、接口技术规范 ························································ 8

　（一）通用要求 ······························································· 9

　1、实时通讯接口·········································································· 9

　2、文件接口 ············································································· 11

　3、用户认证与数据加解密 ···························································· 14

　（二）部级交互系统提供的接口 ········································ 15

　1、跨省实时运单查询接口 ···························································· 15

　2、历史运单文件接收接口 ···························································· 16

　（三）省级危货系统提供的接口 ········································ 18

　1、实时运单查询接口 ·································································· 18

　（1）接口请求报文定义 ··········································································· 18 （2）返回值数据区定义 ··········································································· 19 2、运单二维码查询接口 ······························································· 20

　3、电子运单信息接收接口 ···························································· 21

　4、电子运单状态变更接口 ···························································· 23

　七、异常情况说明及处理 ·············································· 24

　（一）异常情况说明 ······················································· 24

　1、系统接入异常········································································ 24

　2、运单数据异常········································································ 24

　 2 3、企业资质异常········································································ 24

　4、车辆资质异常········································································ 24

　5、驾驶员资质异常 ····································································· 24

　6、卫星定位轨迹异常 ·································································· 24

　（二）异常情况处理 ······················································· 25

　第 1 页

　共 25 页 危险货物道路运输电子运单信息交互技术规范

　 为贯彻落实交通运输部、工业和信息化部、公安部、生态环境部、应急管理部、市场监督管理总局六部门联合规章《危险货物道路运输安全管理办法》 （交通运输部令 20××年第 29 号，以下简称《办法》），规范危险货物道路运输电子运单系统使用，加强危险货物道路运输行业运行监测，特制定本技术规范。

　一、适用范围

　本规范适用于部级危险货物道路运输电子运单信息交互系统（以下简称部级交互系统）与危险货物道路运输安全监管系统省级工程（以下简称省级危货系统）之间，以及省级危货系统与企业危险货物道路运输电子运单管理系统（以下简称企业电子运单管理系统）之间的电子运单信息交互。

　二、编制依据

　（1）《危险货物道路运输安全管理办法》（交通运输部令 20××年第 29 号）； （2）《中华人民共和国行政区划代码》（民政部）； （3）GB/T 18284-2000 快速响应矩阵码； （4）GB/T 22239-2019 信息安全技术信息系统安全等级保护基本要求； （5）GB/T 32905-2016 信息安全技术 SM3 密码杂凑算法；

　第 2 页

　共 25 页 （6）GB/T 32907-2016 信息安全技术 SM4 分组密码算法； （7）GB/T 32918-2016 信息安全技术 SM2 椭圆曲线公钥密码算法； （8）JT/T 617-2018 危险货物道路运输规则； （9）JT/T 697.1-2013 交通信息基础数据元 第 1 部分：总则； （10）JT/T 1049.2-2016 道路运政管理信息系统 第 2 部分：数据资源采集接口。

　三、术语定义

　（ 一 ）危险货物道路运输电子运单（以下简称运单）

　危险货物承运人按照《办法》第二十四条及《危险货物道路运输规则 第 5 部分：托运要求》（JT/T 617.5-2018）的要求进行制作、并交由驾驶人以手机APP、小程序等电子化方式随车携带的运输单据。

　（ 二 ）危险货物道路运输纸质运单

　危险货物承运人按照《办法》第二十四条及《危险货物道路运输规则 第 5 部分：托运要求》（JT/T 617.5-2018）的要求进行制作、并交由驾驶人以纸质文件（需加盖公章；复印或扫描件有效）等方式随车携带的运输单据。

　（ 三 ）运单状态

　包括新建未开始、运输中、已完成、作废等状态。

　（ 四 ）城市配送

　一个危险货物运输单元，在某个地点完成装货，在同一个地级市

　第 3 页

　共 25 页 范围内一个（或以上）地点多次卸货。

　四、运单信息格式

　（一）运单数据项定义

　运单数据项应符合《危险货物道路运输规则 第 5 部分：托运要求》（JT/T 617.5-2018）第 8 章的要求。

　第 4 页

　共 25 页 表 表 1 运单数据项定义

　序号

　数据项名称

　参数类型

　节点编号

　长度

　约束

　值说明

　1 运单编号 String i1 F24 1

　2 托运人名称 String i11 V256 1

　3 托运人联系电话 String i12 V32 1

　4 装货人名称 String i21 V256 ?

　5 装货人联系电话 String i22 V32 ?

　6 收货人名称 String i31 V256 1

　7 收货人联系电话 String i32 V32 1

　8 起运日期 String i41 F10 1 格式 YYYY-MM-DD 9 起运地 String i42 V256 1

　起运地所在区县行政区划代码 String i421 F6 1 《中华人民共和国行政区划代码》（民政部公布）

　10 目的地 String i43 V256 1

　目的地所在区县行政区划代码 String i431 F6 1 《中华人民共和国行政区划代码》（民政部公布）

　11 城市配送 Number i44 1 1 1：城市配送

　0：其他运输 12 承运人单位名称 String i45 V256 1

　13 承运人许可证号 String i451 V24 1

　14 承运人联系电话 String i452 V32 1

　15 车牌号码 String i46 V10 1

　车牌颜色 String i461 V10 1 车牌颜色名称，见 JT/T 1049.2—2016 中附录 A.5 16 道路运输证号 String i462 V24 1

　17 挂车车牌号码 String i47 V10 ?

　18 挂车道路运输证号 String i471 V24 ?

　第 5 页

　共 25 页 19 罐体编号 String i48 V32 ?

　20 罐体容积 Number i481 (5,2) ? 保留 2 位小数单位：立方米 21 驾驶员姓名 String i49 V32 1

　22 驾驶员从业资格证 String i491 V24 1

　23 驾驶员联系电话 String i492 V32 ?

　24 押运员姓名 String i50 V32 1

　25 押运员从业资格证 String i501 V24 1

　26 押运员联系电话 String i502 V32 ?

　27 货物信息

　i51

　（1）

　货物总重量 Number

　i510 (5,3) 1 保留 3 位小数，单位：吨 （2）

　货物明细信息（Array）

　i511

　序号 Number g1 V10 1

　联合国编号 String g2 F4 1

　危险货物正式运输名称 String g3 V128 1

　类别及项别 String g4 V8 1

　包装类别 String g5 V10 ? 根据《危险货物道路运输规则 第 3 部分：品名及运输要求索引》（JT/T 617.3-2018）附录 A 第（4）列确定 包装规格 String g6 V24 ?

　数量 String g7 V10 1

　单位 String g8 V10 1

　28 备注 String i52 V256 1

　29 调度人 String i53 V32 1

　30 调度日期 String i54 F10 1

　第 6 页

　共 25 页 其中，符号的含义如下：

　符号 含义 String 字符型 Number 数字型 Array 数组类型 ? 0..1，可选项 * 0..n，可以没有，也可以有多项 + 1..n，至少有 1 项，也可以有多项 1 必须且只能填 1 项 Fxx 固定长度，长度为 xx Vxx 可变长度，最大长度为 xx （二）运单二维码

　企业运单管理系统将电子运单信息上传到省级危货系统后，省级危货系统对企业、车辆、人员等许可资质信息进行校验，检验通过后生成一个运单二维码返回给企业运单管理系统。运单二维码为符合《快速响应矩阵码》(GB/T 18284-2000）标准要求的 QR 码。

　二维码的信息内容包括运单摘要和校验信息。其中运单摘要包括运单编号、车辆信息、驾押人员信息、货物信息（货物重量信息、货物信息列表）；校验信息包括版本信息、数据校验码。各信息项内容之间使用“$”（半角）进行分隔，同一信息项如果有多项内容用“,”（半角）分隔，同一项多组数据之间用“|”（半角）分隔。

　信息项应按照下表顺序号排列，各信息项的定义如下表所示：

　表 表 2 二维码信息内容

　顺序 号

　信息项名称

　信息项数据格式

　其他说明

　1 二维码数据格式版本 2 位数字字符 目前统一为“01” 2 数据校验密钥属性 2 位数字字符，标识密钥的索引。

　目前统一为“01” 3 运单编号

　第 7 页

　共 25 页 顺序 号

　信息项名称

　信息项数据格式

　其他说明

　4 车辆信息 货车号牌，货车车牌号颜色，挂车车牌号 示例数据：

　有挂车：

　京 AG6888,黄色,京 AG689 挂 无挂车：

　京 AG888,黄色 5 驾押人员信息 驾驶员姓名，驾驶员证件号码；押运员姓名，押运员证件号码 显示时，证件号码中间 6 位以*替代 6 货物总重量 保留 3 位小数，单位：吨。

　如 19.625 吨 7 货物信息列表 货物信息1|货物信息2|…… 货物信息定义如下：货物联合国编号,包装类别,数量,单位 8 数据校验码

　 注：

　1）汉字字符集编码采用 GBK； 2）数据校验码的生成方法：对 1-7 项数据用 2 项中指定的密钥做签名（签名值为 R||S形式，二进制数据），签名值再进行 Base64 编码。

　五、交互要求

　（一）系统接入方式

　部省间系统通过交通行业专网/高速公路光纤网，采用 WEB API方式实现实时交互，采用 SFTP 方式实现批量文件上传。

　企业运单管理系统通过互联网，以 WEB API 方式接入省级危货系统。

　（二）数据加密要求

　根据《中华人民共和国密码法》、《信息安全技术信息系统安全等级保护基本要求》（GB/T 22239-20××）相关规定，部级交互系统和省级危货系统之间进行数据交换，应通过国产密码算法对报文进行加密和认证。

　部级交互系统、省级危货系统、企业运单管理系统所使用的公私

　第 8 页

　共 25 页 钥分别由各自系统生成，并将公钥发放给具有交互接口的系统。密钥的保存和使用应遵循国家相关规定。

　（三）时效质量要求

　企业运单管理系统生成的电子运单，应在运输作业开始前上传至省级危货系统。省级危货系统应对企业上传的运单数据按本规范进行校验，确保数据质量符合标准要求。如遇网络中断等特殊情况无法上传电子运单，企业运单管理系统应缓存电子运单数据，待系统恢复后及时补传电子运单数据。

　省级危货系统应确保运单联网查询接口的稳定性和可靠性。每周日 24 点，省级危货系统应将本周已完成的历史运单信息通过文件方式批量上传至部级交互系统。

　六、接口技术规范

　部省电子运单信息交互接口主要包括省级危货系统历史运单数据批量上传接口、跨省电子运单查询接口、二维码运单信息查询接口。

　省级危货系统与企业运单管理系统的交互接口主要包括电子运单信息接收接口、电子运单状态更新接口。

　接口类型分为实时通讯接口、文件传输接口两种类型。本规范中，除省级危货系统历史运单数据批量上传为文件传输接口外，其余接口为实时通讯接口。

　第 9 页

　共 25 页 （一）通用要求

　1 1 、 实时通讯接口

　接口采用 WEB API 方式，服务端提供给客户端的数据接口通信协议采用 HTTP(S)，以 Json 为数据承载体格式，接口宜采用 HTTPS 方式调用。

　实时通讯接口为 http(s)://url:port/busicode/interface 形式。其中，url 是接口提供方的 url 地址；port：接口提供方的 url访问端口号；busicode 为接口业务代码；interface 为接口名称。

　实时通讯接口的请求报文包括公共参数区及业务参数区（如表 3所示）。公共参数包括系统标识、接口安全信息等，每次调用均需附带公共参数。业务参数区根据不同的业务类型定义。

　表

　3 请求报文结构定义

　参数

　参数名称

　类型

　长度

　约束

　描述

　备注

　说明

　公共参数区 ak 系统标识 String F6 1 该接口适用于部省之间接口调用：由省级危货系统发起时，使用省级行政区划代码。部级交互系统以“000000”填充

　该接口适用于企业运单管理系统与省级危货系统之间接口调用：由省级危货系统统一分配企业运单管理系统接入标识 ts 时间戳 Number

　1 用户发起请求时的 unix 时间戳

　sk 签名密钥标识 String F2 1 密钥的标识（从 01 开始）

　sn 签名 String V128 1 签名数据，详见本节签名数据格式及签名计算示例。

　业务参数区 ps 业务参数区 Json Object

　1 具体数据项根据业务确定

　实时通讯接口的应答报文结构包括状态码、状态码描述及业务返

　第 10 页

　共 25 页 回数据。应答报文采用 Json 格式，包括 code,msg,data 三个部分，定义如下：

　{ “code”:”状态码”, “msg”:”状态码的文字描述”, “data”:{json Object} } 其中：

　——code: 状态码，9000 表示成功，其它表示错误代码； ——msg：对状态码的文字描述，成功时为"success"，否则为错误提示信息； ——data：成功时返回的数据，类型为对象或数据。只在请求成功时，data 有效（无返回数据或调用失败时，data 无效）。数据类型限定为对象或数组，当请求需要的数据为单个对象时则传回对象，当请求需要的数据是列表时，则为某个对象的数组。

　状态码及及含义如表 4 所示：

　表

　4 状态码及含义

　code 值 Msg 9000 Success F001 请求的参数格式不符合接口要求 F002 签名校验失败 F003 未找到符合条件的数据 F004 运单信息已存在 F005 运单信息签名校验失败 F101 运单数据项不全 F102 运单数据项格式不符合要求

　第 11 页

　共 25 页 FXXX 其他，参见具体的接口业务定义 签名数据的步骤包括：

　1）组织签名数据。依次将以下信息进行字符串拼接，得到basic_string：

　——HTTP METHOD：

　POST 或 GET； ——参数集合：将所有参数（包括 GET 或 POST 的参数，但不包含签名(sn)字段）格式化为“key=value”格式，如“k1=v1”、“k2=v2”、“k3=v3”，将格式化好的参数键值对以字典序升序（key）排列后，拼接在一起，结果如“k1=v1k2=v2k3=v3”；对于 ps（业务参数 Json object）的值，参与运算时需先进行字符编码。字符编码方法为java.net.URLEncoder.encode（"要编码的内容","UTF-8"）。

　2 ）

　将 组 织 好 的 basic_string 进 行 字 符 编 码 ， 得 到En_basic_string； 3）使用 SM2（密钥为参数区指定的密钥)及对应的摘要算法（SM3）对 En_basic_string 进行签名，得到的签名值（签名值为 R||S 形式，二进制数据）再进行 Base64 编码得到参数 sn 的值。

　2 2 、 文件接口

　文件交换接口使用 SFTP 协议。传输方式包括全量和增量。首次上传应按全量上传。文件接收端服务器对上传文件保持期限为 30 天，30 天后自动删除该文件。

　文件接收端的目录包括：

　——/upload：为上传文件存放目录；

　第 12 页

　共 25 页 ——/download：回执文件存放目录； ——/tmp：为传输过程临时文件目录。

　上传的每个数据文件对应一个校验文件，校验文件连同数据文件同时上传。

　增量数据文件的命名规则为：行政区划代码_业务代码_YYYYMMDD.XML （YYYYMMDD 为该文件的生成的日期）。全量数据文件的命名规则为：行政区划代码_业务代码_00000000.XML；重传文件的命名规则为：原文件名.redo。数据文件应 zip 格式压缩，压缩后的文件名为数据文件的主文件名.zip。

　数据文件的内容格式采用 xml 方式定义，对应的数据节点如表 5所示：

　表

　5 文件内容数据节点定义

　数据元 数据 类型 说明 是否 必须 备注说明 文件说明区<HEAD> VER N2 文件版本号 是 当前版本 01 SKID N2 签名密钥标识 是 默认为 01 SALGO N2 签名算法（01：SM2-SM3）

　是 默认为 01 COUNT N 数据区的数据条数 是

　 数据区属性定义节点<DP> 是

　EN N1 数据的加密状态（0：不加密；1：加密）

　是

　EKID N2 加密密钥标识 否 对应的部级交互系统的公钥版本标识 KV AN 临时对称密钥的密文值的 Base64 编码 否 使用对应公钥对临时密钥加密后，进行 Base64 编码 交易数据区 DETAILS (1-n)

　根据业务代码分类定义，具体参见业务数据定义。

　示例 XML <?xml version="1.0" encoding="gbk"?> <PACKAGE>

　第 13 页

　共 25 页 <HEAD> <VER>01</VER> <SKID>01</SKID> <SALGO>01</SALGO> <COUNT></COUNT> <DP> <EN>1</EN> <EKID>01</EKID> <KV>MDEwMjAzMDQwNTA2MDcwODAxMDIwMzA0MDUwNjA3MDg=</KV> </DP> </HEAD> <DETAILS> <!—明文数据 --> <RECORD> <ot>1</ot> <item1>…</item1> </RECORD> <!—密文数据 --> <RECORD>数据记录加密后的数据（Base64 编码）</RECORD> </DETAILS> </PACKAGE> 校验文件的命名规则为：数据文件的主文件名.chk。校验文件包括数据文件记录数、数据文件字节数、数据文件签名值（对数据文件的摘要数据做签名，签名对应的密钥及算法在数据文件中定义）。不同数据项之间以半角逗号分隔。

　回 执 文 件 的 命 名 规 则 为 ：

　行 政 区 划 代 码 _ 业 务 代 码_YYYYMMDD_resp.XML 。回执文件的内容格式采用 xml 方式定义，对应的数据节点如表 6 所示：

　表

　6 回执文件内容数据节点定义

　数据元

　数据类型

　说明

　是否必须

　备注说明

　文件说明区<HEAD> VER N2 文件版本号 是 当前版本 01 STATE String 数据处理结果 是 包括：

　OK、FAIL、ERROR COUNT N 数据区的数据条数 是

　第 14 页

　共 25 页 数据元

　数据类型

　说明

　是否必须

　备注说明

　交易数据区 DETAILS (1-n)，当数据处理结果为 ERROR 时，节点有效。

　根据业务代码分类定义，具体参见业务数据定义。

　示例 XML <?xml version="1.0" encoding="GBK"?> <PACKAGE> <HEAD> <VER>01</VER> <STATE>OK/FAIL/ERROR</STATE > <COUNT></COUNT> </HEAD> <DETAILS> <RECORD><!—具体参见各文件接口业务定义 --></RECORD> <RECORD><!—具体参见各文件接口业务定义 --></RECORD> </DETAILS> </PACKAGE> 数据上传完成收到回执文件后，应采取如下处理步骤：

　——若数据处理结果为 ERROR，则应按照回执文件<DETAILS>区域返回的记录进行问题排查，处理后在次日进行上传； ——若数据处理结果为 FAIL，则应将该回执文件对应的原文件修复后再次压缩上传。重发文件为回执文件对应的已修复原文件全量；重发文件仍旧按正常上传流程，但文件名命名规则按重传文件命名规则命名。

　3 3 、 用户认证与数据加解密

　电子运单信息交互应采用国产密码算法, 保障数据交互过程中的系统身份认证、传输安全和数据传输可追溯。数据加解密、签名、验签算法采用 SM2、SM4，数据摘要算法采用 SM3。

　数据签名、非对称加解密应符合《GB/T 32918-2016 信息安全技术 SM2 椭圆曲线公钥密码算法》要求。对称加解密应符合《GB/T 32907-2016 信息安全技术 SM4 分组密码算法》要求。数据摘要应符

　第 15 页

　共 25 页 合《GB/T 32905-2016 信息安全技术 SM3 密码杂凑算法》； 对称加密的方法为 EData = SM4_Encrypt(MSG ||Padding)，其中：

　——MSG 为 ENTLA||Data，data 为待加密数据，ENTLA 是 data 的数据长度（高字节在前，低字节在后）； ——Padding 为符合 ISO/IEC 9797-1 的 PADDING 模式 1。如果输入数据MSG的长度不是分组长度16的整数倍，在MSG的右端加上0x00字节补齐。

　（二）部级交互系统提供的接口

　1 1 、 跨省实时运单查询接口

　省级危货系统可通过该接口，查询跨省实时运单数据。该接口业务代码为 waybill，接口名称为 query。

　跨省实时运单查询接口流程如下：

　1）部级交互系统收到 A 省（请求发起方）危货系统发起的实时运单查询请求后，对请求参数进行校验。校验内容包括参数格式是否符合要求、时间戳是否有效、签名数据是否正确。如果校验未通过，返回相应的错误； 2）部级交互系统根据请求中的参数（车牌号码或运单编号）确定 B 省危货系统（运单所属省份），组织请求参数、对数据进行签名后调用 B 省危货系统实时运单查询接口； 3）部级交互系统将 B 省危货系统返回的数据发送给 A 省危货系统。

　第 16 页

　共 25 页 跨省实时运单查询接口请求报文参数如表 7 所示：

　表 表 7 跨省实时运单查询请求报文参数

　参数

　参数

　名称

　类型

　长度

　约束

　描述

　备注说明

　公共参数区 业务参数 支持通过车辆号牌（车牌颜色）或运单编号查询。

　ps: {“vno”:“车辆号牌”，“vcolor”:“车牌颜色”，“wbno”：“运单编号”} vno 车辆号牌 String V10 ？

　 vcolor 车牌颜色 String V10 ？ JT/T 697.7—2014 中5.6

　wbno 运单编号 String F24 ？

　 表 表 8 跨省实时运单查询返回值 a data 节点定义

　参数

　参数名称

　参数类型

　长度

　约束

　说明

　en 返回值加密属性 Number 1 1 0：数据未加密 1：数据加密 kv 传输密钥密文值 String

　? 使用请求消息头中指定的密钥公钥加密后再经 Base64 编码。当 en=1 时有效 wb 运单数据 String/Json

　1 en=1 时，数据类型为String(原始数据为运单数据Json String，加密后 BASE64编码)

　en=0 时，数据类型为 Json String 2 2 、 历史运单文件接收接口

　历史运单批量上传采用文件接口方式，通过 SFTP 在省级危货系统和部级交互系统之间进行数据文件的传输。部级交互系统提供 SFTP服务端，各省级危货系统 SFTP 登录后可以上传或下载文件。具体文件格式参见文件接口通用要求，业务代码为 waybill。

　批量信息上传包括全量上传及日常的增量上传。全量上传适用于

　第 17 页

　共 25 页 部省之间首次传输、以及根据部级交互系统要求适时全量上传。增量上传是指省级危货系统每周将运单增量历史运单数据（7 天）上传。

　省级危货系统历史运单信息批量文件上传流程：

　1）省级危货系统生成文件并压缩，文件如无数据，应生成空文件，并按照指定时间上传文件； 2）省级危货系统上传文件过程中，应将文件放到/tmp 目录，在文件传输结束后，将文件转移到/upload 目录； 3）部级交互系统将回执文件存放到/download 目录； 4）省级危货系统根据/download 目录下回执文件内容，对数据进行修正处理； 批量上传运单数据格式如下表所示：

　表 表 9 批量运单数据格式定义

　序号

　层级

　父元素

　名称

　元素名称

　约束

　类型

　长度

　描述

　取值说明

　1 2 DETAILS record * - - 数据节点 - 2 3 record ot 1 n 1 数据更新方式 1：新增 9：删除 3~34 3 record 运单信息，项目为 i1~i50、i52~i54 35 3 record goods *

　 货物信息

　（1）

　4 goods i510 1

　 货物总重量

　(2)

　4 goods 货物信息（Array）（i511 节点），项目为 g1~g8 回执文件的格式如下表所示：

　表 表 10 回执文件数据定义

　序号

　层级

　父元素名称

　元素名称

　约束

　类型

　长度

　描述

　取值说明

　1 2 DETAILS record * - - 数据节点 -

　第 18 页

　共 25 页 序号

　层级

　父元素名称

　元素名称

　约束

　类型

　长度

　描述

　取值说明

　2 3 record wbno 1 String F24 运单编号

　3 3 record st 1 n 1 数据同步状态 1：数据已存在，操作失败 2：数据未存在，操作失败 3：运单数据项不全或数据格式不符合要求 （三）省级危货系统提供的接口

　1 1 、 实时运单查询接口

　部级交互系统调用该接口，实时查询运单信息。接口业务代码为waybill，接口名称为 query。

　省级危货系统收到部级交互系统的查询请求后，需对请求参数进行校验。校验内容主要包括参数格式是否符合要求、时间戳是否有效、签名数据是否正确。如校验未通过，返回相应的错误。省级危货系统根据业务请求参数中指定的车牌号码（车牌颜色）或运单编号，查询该车辆的运单信息，并将信息反馈给部级交互系统。当运单编号有效时，按照运单编号查询运单信息。当运单编号为空时，根据车牌号码、车牌颜色查询该车最近一次的运单信息。

　（1 1 ）

　接口请求报文定义

　接口请求报文参数定义如表 11 所示：

　表 表 11 跨省实时运单查询请求报文参数

　参数

　参数名称

　类型

　长度

　约束

　描述

　备注说明

　公共参数区 其中公共参数区中的 ak 参数，以 000000 填充（标识部级交互系统调用）；sk 为部级交互系统的密钥标识，初始为 01。

　业务参数区 ps:{“vno”:“车辆号牌”，“vcolor”:“车牌颜色”，“wbno”：“运单编号”} 支持通过车辆号牌（车牌颜色）或运单编号查询。

　第 19 页

　共 25 页 vno 车辆号牌 String V10 1

　vcolor 车牌颜色 String V10 1 见 JT/T 697.7—2014 中 5.6

　 wbno 运单编号 String F24

　？

　（2 2 ）

　返回值数据区定义

　返回值数据区定义如表 8 所示，示例如下：

　{ “code”:”9000”, “msg”:”success”, “data”:{ “en”:0, “wb”:{ "i1": "XXXXXXXX（运单编号）", "i11": "XXXXXXXXX（托运人名称）", …… …… "i511":

　[

　 { "g1": "序号", "g2": "联合国编号", "g3": "危险货物正式运输名称", "g4": "类别及项别", "g5": "包装类别", "g6": "包装规格",

　第 20 页

　共 25 页 "g7": "数量", "g8": "单位"

　 }, ……

　 ] } } } 2 2 、 运单二维码查询接口

　运单二维码查询接口采用 HTTP GET 方式，接口形式为http://url:port/api/v1/wbqrcode?wbno=&vcode=，其中 url 为服务器地址， port 为服务器端口号，wbno 为运单编号，vcode 为数据校验码。

　接口返回的数据格式为 Json 格式，包括 code、msg 和 data 三部分。code 及 msg 的定义如下表所示：

　表 表 12 返回值代码定义

　Code Msg 9000 接口调用成功 F001 请求的参数格式不符合接口要求 F002 数据校验未通过 F003 未找到符合条件的运单数据 当 code 为 9000 时，返回的 data 数据格式如表 13 所示：

　表 表 13 二维码查询返回值 a data 区 数据格式

　第 21 页

　共 25 页 格式如下：

　{ "i1": "XXXXXXXX（运单编号）", "i11": "XXXXXXXXX（托运人名称）", …… …… "i511":

　[

　 { "g1": "序号", "g2": "联合国编号", "g3": "危险货物正式运输名称", "g4": "类别及项别", "g5": "包装类别", "g6": "包装规格", "g7": "数量", "g8": "单位"

　 }, ……

　 ] } 3 3 、 电子运单信息接收接口

　企业运单管理系统可通过该接口实现实时运单信息的上传或者

　第 22 页

　共 25 页 运单数据的补传。电子运单信息接收接口采用实时接口方式，其中接口业务代码为 waybill，接口名称为 upload。

　接口业务流程如下：

　1）省级危货系统收到请求后对消息体进行验证，如果参数项及数据格式不符合要求，则返回 F001 错误；如果请求数据体公共参数区中的签名数据不符合要求，则返回 F002 错误；如该运单编号对应的数据已存在，则返回 F004 消息。

　2）省级危货系统对收到的运单数据进行校验，校验的内容主要包括车辆卫星定位装置是否正常运行；车辆道路运输证经营范围是否与承运货物相符；车辆是否按期年审等；驾驶员及押运员是否具备有效危险货物道路运输从业资格证等； 3）校验通过后，保存运单信息并反馈上传成功信息。对于实时运单信息，同时返回运单二维码信息（企业运单管理系统据此生成二维码图形）。

　接口请求参数如下表所示。

　表

　14 电子运单信息接收请求报文参数定义

　参数

　参数名称

　参数类型

　长度

　约束

　值说明

　公共参数区 ak 参数，省级危货系统分配；sk 为企业运单管理系统的密钥标识，初始为 01。

　业务参数区 ps:{“dt”:“运单数据类型”,“ws”:“运单状态”,“wb”:运单 json object }

　dt 运单数据类型 Number F1 1 0：实时上传 1：数据补传

　第 23 页

　共 25 页 ws 运单状态 String F2 1 状态定义 00:新建 01:运输中 09:完成 10:作废 当参数 为 0 时，运单状态默认为 00（新建）

　wb 运单数据 Json 不定长 1

　当接口处理成功后，返回值为 9000 时，data 为二维码数据。

　4 4 、 电子运单状态变更接口

　企业运单管理系统可调用本接口实现运单状态的变更。接口采用实时接口方式，业务代码为 waybill，接口名称为 changestate。接口请求报文参数定义下表所示：

　表

　15 电子运单状态变更请求报文参数定义

　参数

　参数名称

　参数类型

　长度

　约束

　值说明

　公共参数区 ak 参数，省级危货系统分配；sk 为企业运单管理系统的密钥标识，初始为 01。

　业务参数区 ps:{“wbno”:“ 运 单 编 号 ”,“ws”:“ 运 单 状 态 ”,“ct”:” 状 态 变 更 时间”,“cd”:“变更说明”}

　wbno 运单编号 String F24 1

　ws 运单状态 Number 2 1 状态定义 01:运输中 09:完成 10:作废 ct 状态变更时间 String F19 1 YYYY-MM-DD HH:NN:SS cd 变更说明 String V256 ？

　省级危货系统收到请求后对消息体进行验证，如果参数项及数据格式不符合要求，则返回 F001 错误；如果请求数据体公共参数区中的签名数据不符合要求，则返回 F002 错误；如运单未找到，则返回F003 消息。状态变更成功后，返回值为 9000，data 数据区为空。

　第 24 页

　共 25 页 七、异常情况说明及处理

　（一）异常情况说明

　部级交互系统将对省级危货系统上传的运单数据、接口工作情况等进行异常情况的统计分析。典型异常情况主要包括以下几种：

　1 1 、 系统接入异常

　包括省级危货系统无法访问，或者省级危货系统提供的服务接口不符合规范要求； 2 2 、 运单数据异常

　未按要求上传历史运单；或者数据项不全，数据格式不符合要求； 3 3 、 企业资质异常

　运单中的危险货物类别超出企业经营范围、经营许可证超期、证照状态失效等情况； 4 4 、 车辆资质异常

　运单中的车辆信息与部交互系统、全国道路运政管理信息系统的车辆信息比对，存在车辆基础信息未上传、证件过期、信息不符、车辆处于非营运状态、危险货物类别超出罐体适装介质列表等情况； 5 5 、 驾驶员资质异常

　指运单中的驾驶员信息与部交互系统、全国道路运政管理信息系统的驾驶员信息比对，存在驾驶员基础信息未上传、驾驶员无从业资格证、证件过期、信息不符、证照状态失效等情况； 6 6 、 卫星定位轨迹异常

　与重点营运车辆联网联控平台比对，运单开始至运单完成期间，

　第 25 页

　共 25 页 存在车辆无轨迹、轨迹不完整、或者运单起讫点与定位信息不符的情况。

　（二）异常情况处理

　部级交互系统将对省级系统上传的数据进行统计，在工作网站上定期发布各省数据交互情况及异常情况等。各省交通运输主管部门应及时核查异常信息，并督促相关方及时整改。