GB/T 39322-2020 电子商务交易平台追溯数据接口技术要求

ICS35.240.60

L67GB

中华人民共和国国家标准

GB/T39322-2020

电子商务交易平台追溯数据

接口技术要求

Technicalrequirementsfortraceabilitydatainterfacein

E-commercetransactionplatform

2020-11-19发布2021-06-01实施

国家市场监督管理总局告士

国家标准化管理委员会保W

GB/T39322-2020

目次

前言…··皿

1范围………··………….1

2规范性引用文件……”…….1

3术语和定义”…………“………·……1

4缩略语……………“………·……1

5基本要求………………”………·……2

6格式定义与数据类型………”………·……2

7数据结构…“………”………·……3

8数据安全…………”………·…….8

附录AC资料性附录）电子商务交易平台追溯数据接口JSON格式数据示例…9

附录B（资料性附录）电子商务交易平台追溯数据接口消息响应状态”…………15

参考文献……·……”…………16

I

GB/T39322-2020

前言

本标准按照GB/T1.12009给出的规则起草。

本标准由全国物流信息管理标准化技术委员会（SAC/TC267）提出并归口．

本标准起草单位s山东省标准化研究院、中国物品编码中心、安徽智偿信信息技术有限公司、黑龙江

省标准化研究院、山东百仕达地标产业有限公司、深圳市标准技术研究院、江苏省质量和标准化研究院。

本标准主要起草人＝王可、梁厚广、孙小云、方方、陈康康、曹成坤、邵小景、王亚楠、王志恒、李铮、

杜景荣、徐立峰、周哲、练晓、王瑜、李瑞兆。

m

GB/T39322-2020

电子商务交易平台追溯数据

接口技术要求

1范围

本标准规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据

结构、数据安全。

本标准适用于电子商务交易平台追溯数据服务接口的设计、开发和应用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单〉适用于本文件。

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

GB/T36061-2018电子商务交易产品可追溯性通用规范

GB/T363182018电子商务平台数据开放总体要求

IETFRFC2616超文本传输协议HTTP/1.l(HypertextTransferProtocol-HTTP/1.1)

IETFRFC2818TLS上的HTTP(HTTPOverTLS)

IETFRFC3548Basel6、Base32、Base64数据编码（TheBasel6,Base32,andBase64DataEn-

codings)

IETFRFC3629UTF毡，ISO10646转换格式（UTF毡，atransformationformatofISO10646)

3术语和定义

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

3.1

接口interface

描述实体行为的命名操作集。

[GB/T25597-2015，定义4.5]

3.2

追溯参与方traceabilityparticipant

在产品供应链中从事产品生产、加工、包装、仓储、销售、配送等相关业务的组织或个人。

[GB/T360612018，定义3.3]

3.3

追溯数据tra四abilitydata

记录追溯的信息。

[GB/T381552019，定义3.4]

4绵暗语

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

1

GB/T39322-2020

GLN：全球参与方位置代码（GlobalLocationNumber]

GSIN：全球货运标识代码（GlobalShipmentIdentificationNumber)

GTIN：全球贸易项目代码（GlobalTradeItemNumber)

HTTP：超文本传输协议（HyperTextTransferProtocol)

HTTPS，超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer)

JSON:JavaScript对象标记(JavaScriptObjectNotation)

sscc，系列货运包装箱代码（SerialShippingContainerCode)

URL：统一资源定位符（UniformResourceLocator)

5基本要求

电子商务交易平台追溯数据接口通过服务调用获取所需的信息，要求如下:

应采用符合IETFRFC3629规定的UTF-8字符集；

一一应采用HTTP或HTTPS协议作为底层承载协议，采用HTTP协议时应符合IETFRFC

2616的规定，采用HTTPS协议时应符合IETFRFC2818的规定s

一一应进行用户合法性、数据规范性等校验；

应控制交换的追溯数据记录数量，可采用分页传输等方式，宜不影响数据的解析性能s

发生错误时，接口应将详细的错误信息返回至相关业务系统，由各业务系统对错误进行记录分

析和整改s

一一应建立接口日志记录，能识别数据异常或追溯交换数据情况。

6格式定义与数据类型

6.1接口格式定义

主要包括g

a)接口地址g请求的URL地址，一般由域名或IP、端口号、接口路径组成，参见附录A中A.l;

b)接口原型＝由电子商务交易平台追溯数据接口的返回类型、接口名和参数等组成，参见A.2;

c)功能说明s电子商务交易平台追溯数据接口功能的简要描述，参见A.3;

d）参数说明＝调用电子商务交易平台追溯数据接口的输入参数或者输出参数情况，参见A.幻

e)返回说明s电子商务交易平台接口调用正常和（或）异常的响应状态〈参见附录B）、示例等，参

见A.5。

6.2敛据类型

主要包括2

一一字符型，用String表示s

一一整数型，用Integer表示p

一一浮点型，用Float表示；

日期时间型，用Datetime表示，应符合GB/T74082005的规定g

对象型，用Object表示，对应JSON中的“对象符号’气

一一数组型，用Array表示，是一个或多个JSON对象符号的集合。

2

GB/T39322-2020

7数据结构

7.1追溯数据的总体数据结构

应对接口交换的电子商务交易平台追溯数据的数据集进行封装g

a)追溯数据的数据集由一组或多组追溯数据组成；

b)追溯数据包括一组或多组追溯参与方、追溯单元、追溯位置、交易信息，并可根据需求扩展使用

其他信息5

c)追溯参与方、追溯单元、追溯位置、交易信息的内容应符合GB/T36061-2018中第7章及

第8章的要求，

追溯数据的总体数据结构见图1,

2耐

1“国

i鞋草草辈辈辈罪必盖在苦苦差整

IZ市

I‘瞌

L二豆~事

o.z牌

固1追溯数据的总体数据结构

总体数据结构组成元素见表1,

表1总体戴据结构组成元素

名称是杏必选类型备注

追溯数据的数据集是Array追溯数据的数据集数组包括一个或多个追溯数据对象

追溯数据是Object迫溯数据对象

迫害赞参与方是Array追糊参与方数组包括一个或多个追溯参与方对象

追溯单元是Array迫糊单元数组包括一个或多个追溯单元对象

追溯位置是Array追翻位置数组包括一个或多个追溯位置对象

交易信息是Array交易信息数组包括一个或多个交易信息对象

其他信息否Array视需求，可适情扩展使用

7.2追溯参与方鼓据结构

追溯参与方数据结构见图2。

3

GB/T39322-2020

圄2追溯参与方数据结构

追溯参与方数据元素见表2。

表2追溯参与方数据元素

名称是否必选类型备注

追溯所涉及的关键节点类型．取值3上游供应商、电子商务平台

参与方类型是String

经营者、平台内经营者、电子商务物流服务商

应符合GB/T360612018中8.2.1的要求，可采用GLN或统一

参与方身份标识是String

社会信用代码

参与方名称是String与统一社会信用代码对应的主体名称

有效联系人是String

联系地址是Strmg

联系方式是String

如营业执照等．图片文件采用BASE64编码规则（应符合IETF

经营资质杏StringRFC3548的规定）转换为字符串，或给出其URL链接地址字符