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