GB/T 39322-2020.Technical requirements for traceability data interface in E-commerce transaction platform.
1范围
GB/T 39322规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据结构、数据安全。
GB/T 39322适用于电子商务交易平台追溯数据服务接口的设计、开发和应用。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 7408-2005数据元和交换格式 信息交换日 期和时间表示法.
GB/T 36061-2018电 子商务交易产品可追溯性通用规范
GB/T 36318-2018电子商 务平台数据开放总体要求
IETF RFC 2616超文 本传输协议HTTP/1.1(Hypertext Transfer Protocol- HTTP/1.1)
IETF RFC 2818 TLS. 上的HTTP(HTTP Over TLS)
IETF RFC 3548 Basel6、 Base32、Base64数据编码( The Basel6，Base32, and Base64 Data Encodings)
IETF RFC 3629 UTF-8,ISO 10646 转换格式(UTF-8, a transformation format of ISO 10646)
3术语和定义
下列术语和定义适用于本文件。
3.1
接口 interface
描述实体行为的命名操作集。
[GB/T 25597-2015,定义4.5]
3.2
追溯参与方 traceability participant
在产品供应链中从事产品生产、加工、包装、仓储、销售、配送等相关业务的组织或个人。
[GB/T 36061-2018,定义3.3]
3.3
追溯数据 traceability data
记录追溯的信息。
[GB/T 38155-2019,定 义3.4]

ICS35.240.60
中华人民共和国国家标准
GB/T39322—2020
电子商务交易平台追溯数据，
接口技术要求
Technical requirements for traceability data interface inE-commerce transaction platform2020-11-19发布
国家市场监督管理总局
国家标准化管理委员会
2021-06-01实施
规范性引用文件
术语和定义
缩略语
基本要求
格式定义与数据类型
数据结构
数据安全
附录A（资料性附录）
附录B（资料性附录）
参考文献
电子商务交易平台追溯数据接口JSON格式数据示例电子商务交易平台追溯数据接口消息响应状态GB/T39322—2020
本标准按照GB/T1.1—2009给出的规则起草本标准由全国物流信息管理标准化技术委员会（SAC/TC267)提出并归口GB/T39322—2020
本标准起草单位：山东省标准化研究院、中国物品编码中心、安徽智安信信息技术有限公司、黑龙江省标准化研究院、山东百仕达地标产业有限公司、深圳市标准技术研究院、江苏省质量和标准化研究院。本标准主要起草人：王、梁厚广、孙小云、方方、陈康康、曹成坤、邵小景、王亚楠、王志恒、李铮、杜景荣、徐立峰、周哲、练晓、王瑜、李瑞兆。m
1范围
电子商务交易平台追溯数据
接口技术要求
GB/T39322—2020
本标准规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据结构、数据安全
本标准适用于电子商务交易平台追溯数据服务接口的设计、开发和应用。规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注目期的引用文件，仅注目期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单)适用于本文件数据元和交换格式信息交换日期和时间表示法GB/T7408—2005
GB/T36061—2018日
电子商务交易产品可追溯性通用规范GB/T36318—2018日
电子商务平台数据开放总体要求IETFRFC2616
超文本传输协议HTTP/1.1(HypertextTransferProtocol—HTTP/1.1)IETFRFC2818TLS上的HTTP(HTTPOverTLS)IETFRFC3548
codings)
IETFRFC3629
术语和定义
Basel6、Base32、Base64数据编码（TheBasel6，Base32，andBase64DataEn-UTF-8,ISO10646转换格式（UTF-8，atransformationformatofISO10646）下列术语和定义适用于本文件。3.1
interface
描述实体行为的命名操作集。
[GB/T25597—2015，定义4.5]
追溯参与方
traceability participant
在产品供应链中从事产品生产、加工、包装、仓储、销售、配送等相关业务的组织或个人。[GB/T36061—2018,定义3.3]
traceabilitydata
追溯数据
记录追溯的信息。
[GB/T38155—2019，定义3.4]
4缩略语
下列缩略语适用于本文件。
GB/T39322—2020
GLN：全球参与方位置代码（GlobalLocationNumber）GSIN：全球货运标识代码（GlobalShipmentIdentificationNumber）GTIN：全球贸易项目代码（GlobalTradeItemNumber）HTTP：超文本传输协议（HyperTextTransferProtocol）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）JSON：JavaScript对象标记(JavaScriptObjectNotation）SSCC：系列货运包装箱代码（SerialShippingContainerCode）URL：统一资源定位符（UniformResourceLocator）5基本要求
电子商务交易平台追溯数据接口通过服务调用获取所需的信息，要求如下：应采用符合1ETFRFC3629规定的UTF-8字符集；应采用HTTP或HTTPS协议作为底层承载协议，采用HTTP协议时应符合IETFRFC2616的规定，采用HTTPS协议时应符合IETFRFC2818的规定；一应进行用户合法性、数据规范性等校验；应控制交换的追溯数据记录数量，可采用分页传输等方式，宜不影响数据的解析性能；发生错误时，接口应将详细的错误信息返回至相关业务系统，由各业务系统对错误进行记录分析和整改；
应建立接口日志记录，能识别数据异常或追溯交换数据情况6格式定义与数据类型
接口格式定义
主要包括：www.bzxz.net
接口地址：请求的URL地址，一般由域名或IP、端口号、接口路径组成，参见附录A中A.1；b）接口原型：由电子商务交易平台追溯数据接口的返回类型、接口名和参数等组成，参见A,2；功能说明：电子商务交易平台追溯数据接口功能的简要描述，参见A.3；c）
参数说明：调用电于商务交易平台追溯数据接口的输人参数或者输出参数情况，参见A.4；d)
返回说明：电子商务交易平台接口调用正常和（或）异常的响应状态（参见附录B）、示例等，参e)
见A.5。
2数据类型
主要包括：
字符型，用String表示；
整数型，用Integer表示；
浮点型，用Float表示；
日期时间型，用Datetime表示，应符合GB/T7408一2005的规定；一对象型，用Object表示，对应JSON中的对象符号”；一数组型，用Array表示，是一个或多个JSON对象符号的集合。2
数据结构
追溯数据的总体数据结构
应对接口交换的电子商务交易平台追溯数据的数据集进行封装：a）
追溯数据的数据集由一组或多组追溯数据组成；GB/T39322—2020
追溯数据包括一组或多组追溯参与方、追溯单元、追溯位置、交易信息，并可根据需求扩展使用b）
其他信息；
追溯参与方、追溯单元、追溯位置、交易信息的内容应符合GB/T36061一2018中第7章及第8章的要求。
追溯数据的总体数据结构见图1。追溯参与方
追溯单元
追溯数据的数据集
追溯数据
图1追溯数据的总体数据结构
总体数据结构组成元素见表1。
总体数据结构组成元素
追溯数据的数据集
追溯数据
追溯参与方
追溯单元
追溯位置
交易信息
其他信息
是否必选
追溯参与方数据结构
追溯参与方数据结构见图2。
Object
追溯位置
交易信息
其他信息
追溯数据的数据集数组包括一个或多个追溯数据对象追溯数据对象
追溯参与方数组包括一个或多个追溯参与方对象追溯单元数组包括一个或多个追溯单元对象追溯位置数组包括一个或多个追溯位置对象交易信息数组包括一个或多个交易信息对象视需求，可适情扩展使用
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。