区块链电子提单数据交互及业务流程

JT/TXXXXX—XXXX

区块链电子提单数据交互及业务流程

1范围

本文件规定了区块链电子提单业务的基本要求、业务流程和数据交互要求。

本文件适用于区块链电子提单应用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T1836集装箱代码、识别和标记

GB/T2659.1世界各国和地区及其行政区划名称代码

GB6944危险货物分类和品名编号

GB/T7407中国及世界主要海运贸易港口代码

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB/T12406表示货币和资金的代码

GB/T16472乘客及货物类型、包装类型和包装材料类型代码

GB/T16833行政、商业和运输业电子数据交换(EDIFACT)代码表

GB/T28532承运人标识符编码规则

JT/TXXXX基于区块链的港航集装箱信息交换平台接口技术要求

3术语和定义

下列术语和定义适用于本文件。

电子提单electronicBillofLading

用电子数据交换方式传输正本提单信息的电子单证。

托运人shipper

根据订舱指示记载在提单上，将货物按照合同约定的时间运输到指定地点交付承运人运输，有权要

求承运人签发提单并承担相应义务的一方当事人。

承运人carrier

本人或者委托他人以本人名义与货方订立货物运输合同，应托运人要求签发提单，并承担运输责任

的一方当事人。

收货人consignee

根据订舱指示记载在提单上，或提单最终的被背书人，向承运人交付正本提单有权提取货物并承担

相应义务的一方当事人。

开证银行issuingbank

依据申请人的请求或代表自己开立信用证的银行（一般是进口地银行）。

通知银行advisingbank

在开证银行的请求下通知信用证的银行。

1

JT/TXXXXX—XXXX

区块链电子提单平台blockchainelectronicBillofLadingplatform

基于分布式账本技术提供电子提单签发和流转服务的平台。

提货单DeliveryOrder

授权将货物交给指定的记名收货人的一方签发的单证。

[来源：GB/T39458—2020，2.98]

跟单信用证documentaryletterofcredit

受益人凭规定的单据和可能指定的汇票，按一定的条款和条件获得付款、承兑或议付的信用证。

[来源：GB/T39458—2020，2.105]

时间戳timestamp

以公共时间为参考的时间点。

路由信息routinginformation

区块链电子提单平台上的下一个电子提单传输节点的相关信息。

4缩略语

下列缩略语适用于本文件。

JSON：脚本语言对象符号，一种轻量级的数据交换格式（JavaScriptObjectNotation）

OBL：正本提单（OriginalBillofLading）

VGM：核实的集装箱重量（VerifiedGrossMass）

5基本要求

区块链电子提单业务相关方包括托运人、承运人、收货人、开证银行、通知银行、买方、卖方、

货运代理等。

区块链电子提单业务依托区块链电子提单平台进行，平台应符合JT/TXXXX的要求。

各业务相关方在区块链电子提单平台进行提单业务操作，区块链电子提单平台应具备以下业务功

能：

a)承运人链上签发电子提单给托运人；

b)电子提单在业务相关方之间链上流转；

c)通知银行、开证银行链上审核电子提单；

d)被背书人、收货人在链上获得电子提单；

e)收货人在链上将电子提单交还承运人，并换取提货单。

6业务流程

贸易合同签署

买方和卖方签署贸易合同，应规定使用跟单信用证付款，并同意使用区块链电子提单平台。

订舱

根据贸易合同，负责海上货物运输的一方（卖方或买方）与承运人签订海上货物运输合同，向承运

人发送装运指示以进行订舱，并通知承运人应选择使用区块链电子提单平台。

信用证开立、确认和通知

买方通知开证银行开立以卖方为受益人的信用证，开证银行要求通知银行确认信用证。通知银行通

知卖方信用证已开立，卖方准备货物。

2

JT/TXXXXX—XXXX

发货运输

在出口地完成所有清关程序后，卖方在收到信用证并确保其能够满足信用证中规定的条件后，应在

平台确认后将货物发送给承运人进行运输。

签发电子提单

货物装船后，承运人根据货方提供的装运说明，应通过区块链电子提单平台签发电子提单，完成数

字签名并传递给托运人。

区块链电子提单平台应将托运人指定为货物所有权人和提单持有人。区块链电子提单平台应记录

由时间戳、数字签名、提单数据、路由信息和状态同步信息生成的哈希值。

发起托管、背书转让电子提单

托运人解密提单数据并验证哈希值和数字签名，指定通知银行作为提单持有人进行电子提单托管，

如果需要，托运人将完成电子签名并将电子提单背书给买方。

用于路由控制的数据应使用通知银行的公钥加密。区块链电子提单平台应记录由时间戳、数字签名、

路由信息和状态同步信息生成的的哈希值，便于通知银行使用私钥进行解密。

通知银行接受电子提单托管

通知银行将电子提单与从托运人处收到的贸易文件一起保存，根据信用证对文件进行解密和检查，

验证哈希值和数字签名，如果单据符合信用证规定，通知银行将按照信用证的规定付款、承兑或议付，

通知银行将开证行指定为提单持有人，并完成其数字签名。

用于路由控制的数据应使用开证银行的公钥加密，区块链电子提单平台中应记录由时间戳、数字签

名、电子提单路由信息和状态同步生成的哈希值，便于开证银行使用私钥进行解密。

开证银行接收电子提单托管

开证银行将电子提单与从通知银行收到的交易文件一起托管，根据信用证对文件进行解密和检查，

验证哈希值和数字签名。在根据信用证的要求验证文件正确无误并收到买方全部付款后，开证银行、将

电子提单和相关贸易文件发放给买方。提单持有人和货物所有权人将更新至收货人，并应记录在区块链

电子提单平台中，并完成其数字签名。

用于路由控制的数据（即，指示下一个节点是买方）应使用买方的公钥加密。区块链电子提单平台

中应记录由时间戳、数字签名、电子提单路由信息和状态同步生成的哈希值，便于买方使用私钥进行解

密。对于上一个节点中的买方需要继续向下一个买方背书的情形，重复托运人背书的过程，相关银行也

应重复相应的过程，直到买方最终成为收货人。

换取提货单

当货物到达卸货港并从船上卸下时，收货人向承运人提交电子提单，换提货单，将提单持有人更换

为承运人，并完成其数字签名。

用于路由控制的数据（即，指示下一个节点是承运人）应使用承运人的公钥加密。区块链电子提单

平台中应记录由时间戳、数字签名、电子提单路由信息和状态同步生成的哈希值。承运人验证哈希并回

收电子提单，电子提单完成流转。

提取货物

在进口地完成所有清关程序后，收货人使用提货单在最终目的地从承运人处提取货物，电子提单平

台上的业务流程结束。

7数据交互要求

区块链电子提单宜采用JSON作为数据交换的格式，数据属性包括索引、层次、中文名称、英文名

称、类型、是否必填、说明与要求，其中：

——索引：数据检索编号；

——层次：字段所属的层次关系；

3

JT/TXXXXX—XXXX

——中文名称：字段的中文名称；

——英文名称：字段的英文名称；

——类型：数据元的特征和基本要素，包括字符型（string）、对象型（object）、数组型

（array）、布尔型（boolean）、数字型（number）；

——是否必填：该数据元是否必填，必填为M，非必填为C，可选为O；

——说明与要求：字段的内容和表达的含义。

在区块链电子提单平台上，从一个节点向下一个节点传输电子提单的相关信息时，电子提单路由

信息数据格式应符合表1的要求。

表1电子提单路由信息数据格式

索引层次中文名称英文名称类型是否必填说明与要求

/0路由信息

由区块链返回的单证唯一识别号，如果同一单

A1信息识别码assetIdstringM证有更改，则此标识号不变，在进入区块链流程

后产生

由区块链返回的单证变更版本，第一次发上链

B1单证版本versionnumberM

的单证版本号为1，在进入区块链流程后产生

电子提单的专属单证类型为OBL，在进入区块链

C1信息类型assetTypestringM

流程后产生

由区块链返回的上链事务识别号和时间戳

D1上链事务onChainTxn-M

在进入区块链流程后产生

D.12事务识别号txnIdstringM由区块链返回的上链事务识别号

D.22时间戳timestampstringM由区块链返回的上链事务时间戳

由区块链返回的资产上链所提供角色清单识

E1角色清单识别号roleListIdstringM

别号，在进入区块链流程后产生

roleListVersio由区块链返回的角色清单版本，在进入区块链

F1角色清单版本numberM

n流程后产生

由区块链返回的资产上链时所用的角色清单类

G1角色清单类型roleListTypestringM型，每种报文均有相应的角色清单类型，在进入

区块链流程后产生

H1单证内容集assetContents-M由区块链返回的角色清单和单证相关内容

H.12角色清单roleList-M由区块链返回的角色清单相关内容

roleListConten

H.1.13角色清单内容-M

t

由区块链为托运人生成的32位通用唯一识别

托运人区块链代

H.1.1.14shipperOrgIDstringM码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

码

xxxxxxxxxxxx

由区块链为收货人生成的32位通用唯一识别

收货人区块链代

H.1.1.24consigneeOrgIDstringC码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

码

xxxxxxxxxxxx

由区块链为货物所有权人生成的32位通用唯一

货物所有权人区titleOwnerOrgI

H.1.1.34stringC识别码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

块链代码D

xxxxxxxxxxxx

由区块链为提单持有人生成的32位通用唯一识

提单持有人区块

H.1.1.44blHolderOrgIDstringC别码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

链代码

xxxxxxxxxxxx

4

JT/TXXXXX—XXXX

表1电子提单路由信息数据格式（续）

索引层次中文名称英文名称类型是否必填说明与要求

由区块链为承运人生成的32位通用唯一识别

承运人区块链代

H.1.1.54carrierOrgIDstringM码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

码

xxxxxxxxxxxx

由区块链为通知方生成的32位通用唯一识别

通知方区块链代notifyPartyOrg

H.1.1.64stringC码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

码ID

xxxxxxxxxxxx

由区块链为应用开发商生成的32位通用唯一识

应用开发商区块appBuilderOrgI

H.1.1.74stringM别码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

链代码D

xxxxxxxxxxxx

由区块链为货运代理生成的32位通用唯一识别

货运代理区块链

H.1.1.84forwarderOrgIDstringC码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

代码

xxxxxxxxxxxx

由区块链为银行生成的32位通用唯一识别码，

H.1.1.94银行区块链代码bankOrgIDstringC格式为xxxxxxxx-xxxx-xxxx-xxxx-

xxxxxxxxxxxx

roleListLocato

H.1.23角色清单定位键stringM

rKey

H.1.33角色清单类型roleListTypestringM

正本提单（Originalbilloflading）单证相

H.22信息明细assetContent-M

关内容

在区块链电子提单平台上传输的电子提单数据格式应符合表2的要求。

表2电子提单数据格式

索引层次中文名称英文名称类型是否必填说明与要求

正本提单（Originalbilloflading）单证相

H.22信息明细assetContent-M

关内容

H.2.13提单号blNumberstringM

—NEW新建

H.2.23操作类型actionstringM

—WITHDRAW取消

提单版本信息，由承运人提供，该版本号是由承

H.2.33提单版本信息docVersionnumberM

运人在其生产管理系统签发最终提单而触发

签发的提单文件类型

H.2.43提单文件类型documentTypestringM

—ORIGINALS：正本

H.2.53提单类型blTypestringM—OBL：正本提单

carrierBooking

H.2.63承运人订舱号arrayC

Numbers

externalRefere

H.2.73出运信息arrayC

nces

代码类型符合GB/T16833，未涵盖的类型，可根

H.2.7.14出运信息类型referenceTypestringC

据要求自定义添加

referenceNumbe

H.2.7.24出运信息号stringC

r

H.2.83承运人carrier-M承运人信息

由区块链为托运人生成的32位通用唯一识别

承运人区块链组

H.2.8.14carrierOrgIDstringM码，格式为xxxxxxxx-xxxx-xxxx-xxxx-

织代码

xxxxxxxxxxxx

H.2.8.24承运人SCAC代码carrierSCACstringM应符合GB/T28532的要求

H.2.8.34承运人公司名称carrierNamestringM

H.2.8.44制单联系人邮箱contactEmailstringC

5

JT/TXXXXX—XXXX

表2电子提单数据格式（续）

索引层次中文名称英文名称类型是否必填说明与要求

—GC：普通品

—DG：危险品

—RF：冷冻品

shipmentCargoT—RD：冷冻危险品

H.2.93货物类型stringM

ype—AD：特殊尺寸危险品

—AW：特殊尺寸品

—MX：混合品（如果同时有多个货物类型，则用

此类型）

shipmentTraffi

H.2.103货物交换形态-M

cMode

出口装船之前的集装箱装货状态：

H.2.10.

4出口段outBoundstringM—2Fullloads

1

—3Lessthanfullloads

进口卸船之后集装箱内货物状态代码：

H.2.10.

4进口段inBoundstringM—2Fullloads

2

—3Lessthanfullloads

blIssueDateTim

H.2.113提单签发日期-M格式：YYYY-MM-DDThh：mm：ss[.mmm]Z

e

H.2.123海运船信息vesselVoyage-M海运船相关信息

H.2.12.

4航线servicestringM承运人定义的航线代码

1

H.2.12.

4船舶代码vesselCodestringC承运人定义的船舶代码

2

H.2.12.

4船名vesselNamestringM

3

H.2.12.

4航次号voyageNumberstringM

4

—E：东

H.2.12.—N：北

4航次向directionstringC

5—S：南

—W：西

H.2.12.vesselIMONumbe

4IMO船舶编码stringC

6r

H.2.12.

4呼号callSignstringC

7

H.2.12.vesselNational船舶在其法律下注册或领取执照的管辖国家英

4船旗国籍stringC

8ity文全称

H.2.133托运人shipper-M托运人，应符合A.1的要求

H.2.143货运代理forwarder-C货运代理，应符合A.1的要求

H.2.153收货人consignee-C收货人，应符合A.1的要求

H.2.163通知方notifyParty-C通知方，应符合A.1的要求

alsoNotifyPart

H.2.173第二通知方-C第二通知方，应符合A.1的要求

y

H.2.183货品运输路径declaredRoute-M订舱时选择的承运人对外公布的货物运输路径

H.2.18.

4前程运输方preCarriagestringC前程运输所使用的交通工具的名称

1

H.2.18.

4货物交接方式haulage-M货物交接方式相关内容

2

H.2.18.outBoundHaulag—C：船方运输

5接货方式stringM

2.1e—M：货主运输

H.2.18.—C：船方运输

5交货方式inBoundHaulagestringM

2.2—M：货主运输

6

JT/TXXXXX—XXXX

表2电子提单数据格式（续）

索引层次中文名称英文名称类型是否必填说明与要求

H.2.18.

4接货地por-M接货地，应符合A.5的要求

3

H.2.18.

4交货地fnd-M最终目的地，应符合A.5的要求

4

H.2.18.货物最初装船的港口名称，水路运输中第一个

4第一程船装货港firstPOL-M

5装船的港口，应符合A.5的要求

H.2.18.最后一程船卸货货物最后卸船的港口名称，水路运输中最后一

4lastPOD-M

6港个卸船的港口，应符合A.5的要求

H.2.193集装箱containersarrayO集装箱货物必填

H.2.19.containerSeque

4集装箱序列号numberM集装箱序列号

1nce

H.2.19.containerNumbe

4集装箱号stringM应符合GB/T1836的要求

2r

H.2.19.containerCheck

4集装箱号校验码stringM应符合GB/T1836的要求

3Digit

H.2.19.carrierContain

4集装箱尺寸类型stringM应符合GB/T1836的要求

4erSizeType

H.2.19.associatedBook

4订舱号stringC

5ingNumber

H.2.19.—True：是

4是否货主自备柜isSOCbooleanM

6—False：否

H.2.19.一个集装箱有多于一份提单时且装船条款为整

4是否分单isPartialbooleanM

7箱货/整箱货

H.2.19.

4毛重grossWeight-M集装箱内货物的毛重信息

8

H.2.19.

5毛重grossWeightnumberM集装箱内货物的毛重

8.1

H.2.19.grossWeightUni—KGM：千克

5毛重单位stringM

8.2t—LBR：磅

H.2.19.grossWeightTex

5提单毛重stringC显示在提单上的毛重

8.3t

H.2.19.

4净重netWeight-C集装箱内货物的净重信息

9

H.2.19.

5净重netWeightnumberC集装箱内货物的净重

9.1

H.2.19.—KGM：千克

5净重单位netWeightUnitstringC

9.2—LBR：磅

H.2.19.

5提单净重netWeightTextstringC显示在提单上的净重

9.3

H.2.19.

4集装箱自重tareWeight-C集装箱自重信息

10

H.2.19.

5自重tareWeightnumberC集装箱自重

10.1

H.2.19.—KGM：千克

5自重单位tareWeightUnitstringC

10.2—LBR：磅

H.2.19.

4体积volume-C集装箱内货物的体积信息

11

H.2.19.

5体积volumenumberC

11.1

—FTQ：立方英尺

H.2.19.

5体积单位volumeUnitstringC—MTQ：立方米

11.2

—LTR：公升

7

JT/TXXXXX—XXXX

表2电子提单数据格式（续）

索引层次中文名称英文名称类型是否必填说明与要求

H.2.19.

4铅封sealsarrayM

12

—CA：承运人

—CU：海关

H.2.19.

5铅封类型sealTypestringM—SH：货主

12.1

—TO：码头运营商

—AC：检疫机关

H.2.19.

5铅封号sealNumberstringM铅封号码

12.2

H.2.19.集装箱总件数及containerTotal

4-C

13包装Packaging

container

H.2.19.集装箱总包装代

5TotalPackageCostringC应符合GB/T16472的要求

13.1码

de

container

H.2.19.集装箱总包装名

5TotalPackageNastringC应符合B/T16472的要求

13.2称

me

container

H.2.19.集装箱总包装数

5TotalPackageQtnumberC

13.3量

y

H.2.203货物cargosarrayM货物信息

H.2.20.

4货物序列号cargoSequencenumberC

1

—GC：普通品

—DG：危险品

H.2.20.—RF：冷冻品

4货物类型cargoNaturestringM

2—RD：冷冻危险品

—AD：特殊尺寸危险品

—AW：特殊尺寸品

H.2.20.cargoDescripti

4货物情况stringM包含货物品名、型号等相关信息的具体描述

3on

H.2.20.

4货物件数及包装cargoPackaging-M货物件数及包装新信息

4

H.2.20.cargoPackageCo

5货物包装代码stringM应符合GB/T16472的要求

4.1de

H.2.20.cargoPackageNa

5货物包装名称stringM

4.2me

H.2.20.cargoPackageQt

5货物包装数量numberM

4.3y

H.2.20.cargoGrossWeig

4货物毛重-M货物毛重信息

5ht

H.2.20.cargoGrossWeig

5货物毛重numberM

5.1ht

H.2.20.cargoGrossWeig—KGM：千克

5货物毛重单位stringM

5.2htUnit—LBR：磅

H.2.20.

4货物净重cargoNetWeight-C货物净重信息

6

H.2.20.

5货物净重cargoNetWeightnumberC

6.1

H.2.20.cargoNetWeight—KGM：千克

5货物净重单位stringC

6.2Unit—LBR：磅

H.2.20.

4货物体积cargoVolume-C货物体积信息

7

8

JT/TXXXXX—XXXX

表2电子提单数据格式（续）

索引层次中文名称英文名称类型是否必填说明与要求

H.2.20.

5货物体积cargoVolumenumberC

7.1

—FTQ：立方英尺

H.2.20.cargoVolumeUni

5货物体积单位stringC—MTQ：立方米

7.2t

—LTR：公升

marksAndNumber

H.2.20.

4唛头序列号sSequenceNumbenumberC

8

r

H.2.20.marksAndNumber

4唛头stringC

9sLine

H.2.20.统一编码/海关

4harmonizedCodestringC

10编码

H.2.20.

4货物集装箱cargoContainer-M货物所在集装箱

11

H.2.20.containerNumbe

5集装箱号stringM应符合GB/T1836的要求

11.1r

H.2.20.