GB/T39322-2020
电子商务交易平台追溯数据接口技术要求
TechnicalrequirementsfortraceabilitydatainterfaceinE-commercetransactionplatform
- 中国标准分类号（CCS）L67
- 国际标准分类号（ICS）35.240.60
- 实施日期2021-06-01
- 文件格式PDF
- 文本页数19页
- 文件大小1.40M
以图片形式预览电子商务交易平台追溯数据接口技术要求
电子商务交易平台追溯数据接口技术要求
国家标准 GB/T39322一2020 电子商务交易平台追溯数据 接口技术要求 Techniealrequirementsfortraceabilitydatainterfacein E-commereetransactionplatform 2020-11-19发布 2021-06-01实施 国家市场监督管理总局 发布 国家标涯花警理委员会国家标准
GB/39322一2020 目 次 前言 范围 2 规范性引用文件 术语和定义 缩略语 基本要求 格式定义与数据类型 ++ 数据结构 数据安全 附录A(资料性附录电子商务交易平台追溯数据接口JSON格式数据示例 附录B(资料性附录电子商务交易平台追溯数据接口消息响应状态 参考文献
GB/39322一2020 前 言 本标准按照GB/T1.1一2009给出的规则起草
本标准由全国物流信息管理标准化技术委员会(SAC/TC267)提出并归口
本标准起草单位;山东省标准化研究院、物品编码中心、安徽智佼信信息技术有限公司、黑龙江 省标准化研究院、山东百仕达地标产业有限公司、深圳市标准技术研究院、江苏省质量和标准化研究院
本标准主要起草人:王打、梁厚广,孙小云、方方、陈康康、曹成坤,邵小景、王亚楠、王志恒,李争 杜景荣、徐立峰、周哲、练晓、王瑜、李瑞兆
GB/39322一2020 电子商务交易平台追溯数据 接口技术要求 范围 本标准规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据 结构、数据安全
本标准适用于电子商务交易平台追溯数据服务接口的设计、开发和应用
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
GB/T7408-2005数据元和交换格式信息交换 日期和时间表示法 GB/T36061一2018电子商务交易产品可追溯性通用规范 GB/T36318一2018电子商务平台数据开放总体要求 ETFRFC2616超文本传输协议HTTP1.1(HypertextTransferProtocol一HTTP1.1) 正ETFRFC2818TLS上的HTTP(HTTPOverTLS) ETFRFC3548Basel6,Base32,Base64数据编码TheBasel6，Base32，andBase64DataEnr codings) ETFRFC3629UTF-8,ISO10646转换格式(UTF-8，atransformationformatofISO10646) 术语和定义 下列术语和定义适用于本文件
3.1 interface 接口 描述实体行为的命名操作集
GB/T25597一2015,定义4.5] 3.2 追溯参与方traeeabitypartieipant 在产品供应链中从事产品生产,加工、包装、仓储、销售、配送等相关业务的组织或个人
[GB/T36061一2018,定义3.3] 3.3 追溯数据 traceabilitydata 记录追溯的信息
[[GB/T381552019,定义3.4门] 缩略语 下列缩略语适用于本文件
GB/T39322一2020 GLN;全球参与方位置代码(GlobalL.ocationNumber) GSIN;全球货运标识代码(GlobalShipmentldentifieationNumber GTIN:全球贸易项目代码(GlobalTradeItemNumber) HTTP;超文本传输协议(HyperTextTransferProtocoD) HTTPS;超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketlayer JsoN.JavaSeript对象标记JavasSeripObjetNotation SsCC:系列货运包装箱代码(SerialShippngContainerCode) ormResourceLocator URL;统一资源定位符(Unifo 5 基本要求 电子商务交易平台追溯数据接口通过服务调用获取所需的信息,要求如下 应采用符合IETFRFC3829规定的UTF-8字符集; 应采用HTIP或HTIPs协议作为底层承载协议,采用HTTP协议时应符合 IETFRFC 816的规定,采用HTTPS协议时应符合IETFRFC2818的规定" 应进行用户合法性、数据规范性等校验; 应控制交换的追溯数据记录数量,可采用分页传输等方式,宜不影响数据的解析性能 发生错误时,接口应将详细的错误信息返回至相关业务系统由各业务系统对错误进行记录分 析和整改 应建立接口日志记录,能识别数据异常或追溯交换数据情况
格式定义与数据类型 6 6.1接口格式定义 主要包括 接口地址;请求的URL地址，一般由域名或IP,端口号、接口路径组成,参见附录A中A.1 a 接口原型:由电子商务交易平台追溯数据接口的返回类型、接口名和参数等组成,参见A.2 b) 功能说明;电子商务交易平台追溯数据接口功能的简要描述,参见A.3; c 参数说明;调用电子商务交易平台追溯数据接口的输人参数或者输出参数情况,参见A.4; d 返回说明;电子商务交易平台接口调用正常和(或)异常的响应状态(参见附录B),示例等,参 e 见A.5.
6.2数据类型 主要包括 字符型,用String表示; 整数型,用lnteger表示; 浮点型,用Float表示 日期时间型,用Datetime表示,应符合GB/T7408一2005的规定; 对象型,用Object表示,对应JSON中的“对象符号”; 数组型,用Array表示,是一个或多个JSON对象符号的集合
GB/39322一2020 数据结构 7.1追溯数据的总体数据结构 应对接口交换的电子商务交易平台追溯数据的数据集进行封装 a 追溯数据的数据集由一组或多组追溯数据组成 b)追溯数据包括一组或多组追溯参与方,追溯单元、追溯位置,交易信息,并可根据需求扩展使用 其他信息; 追溯参与方、追溯单元、追溯位置、交易信息的内容应符合GB/T36061一2018中第7章及 第8章的要求
追溯数据的总体数据结构见图1
追溯参与方 追溯单元 追溯数据 追溯数据的数据集 追溯位置 交易信息 其他信息 图1追溯数据的总体数据结构 总体数据结构组成元素见表1
表1总体数据结构组成元素 类型 名称 是否必选 备注 追溯数据的数据集 追溯数据的数据集数组包括一个或多个追溯数据对象 Array 追溯数据 Objeet 追溯数据对象 是 追溯参与方 Array 追溯参与方数组包括一个或多个追溯参与方对象 是 追溯单元 Array 追溯单元数组包括一个或多个追溯单元对象 追溯位置 追溯位置数组包括一个或多个追溯位置对象 Array 交易信息 是 交易信息数组包括一个或多个交易信息对象 Array 其他信息 Array 视需求,可适情扩展使用 7.2追溯参与方数据结构 追溯参与方数据结构见图2
GB/T39322一2020 参与方类型 参与方身份标识 参与方名称 有效联系人 追溯参与方 联系地址 联系方式 经营资质 产品资质 他 图2追溯参与方数据结构 追溯参与方数据元素见表2. 表2追溯参与方数据元素 名称 是否必选 类型 备注 追溯所涉及的关键节点类型
取值:上游供应商、电子商务平台 参与方类型 是 String 经营者、平台内经营者,电子商务物流服务商 应符合GB/T360612018中8.2.1的要求，可采用GLN或统一 参与方身份标识 是 String 社会信用代码 参与方名称 是 String 与统一社会信用代码对应的主体名称 是 有效联系人 String 联系地址 String 联系方式 String 如营业执照等
图片文件采用BASE64编码规则(应符合IETF RFc3548 经营资质 的规定)转换为字符串,或给出其URL链接地址字符 否 String 串格式 如国家强制性产品认证证书、绿色食品证书等,图片文件采 产品资质 用BAsE64编码规则转换为字符串,或给出其URL链接地址字 否 String 符串格式 视需求,可适情扩展使用 否 其他 String 7.3追溯单元数据结构 追溯单元数据结构见图3
GB/39322一2020 追溯单元类型 追溯单元标识 参与方身份标识 生产/加工企业名称 产品名称 生产批次号 序列号 生产日期/包装日期 保质期/有效期 追溯单元 产品数量 原产地 检验检测 产品图片 作业环节 作业时间 责任人 其他 图3追溯单元数据结构 追溯单元数据元素见表3
表3追溯单元数据元素 名称 是否必选 类型 备注 追溯单元信息类型,取值与含义 GTIN 追溯贸易单元; 追溯单元类型 是 String SSCC 追溯物流单元: GSIN--追溯装运单元 追溯单元标识 String 编码结构应符合GB/T36061一2018中8.2.2的规定 是 用于关联追溯参与方 参与方身份标识 String 生产/加工企业名称 是 String 产品名称 是 String
GB/T39322一2020 表3(续 名称 是否必选 类型 备注 生产批次号 是 String 序列号 当追溯到单品时,必选唯一的序列号 否 String 生产日期/包装日期 格式为YYY-MMDD或YYYY-MMDDTHH,.Mss Datetime 保质期/有效期 是 Siring 产品数量 否 Integer 否 重量 Float 否 原)产地 String 否 检验检测 String 图片文件采用BASE6编码规则转换为字符串,或给出其URL. 否 产品图片 String 链接地址字符串格式 作业环节 否 如人库,拣货、验货、出库等 String 否 格式为YYYY-MMDDTHH,MM,ss Datetime 作业时间 责任人 String 否 其他 String 视需求,可适情扩展使用 7.4追溯位置数据结构 追溯位置数据结构见图4
位置标识 参与份标 具体地址 追潮位置 有效联系人 联系方式 图4追溯位置数据结构 追溯位置数据元素见表！
表4追溯位置数据元素 类型 名称 是否必选 备注 位置标识 是 String 宜采用GLN,其编码结构按GB/T36061一2018中A.1.2的规定 是 用于关联追溯参与方 参与方身份标识 String 具体地址 是 String 有效联系人 否 String
GB/39322一2020 表4(续》 名称 是否必选 类型 备注 联系方式 否 String 其他 视需求,可适情扩展使用 String 7.5交易信息数据结构 交易信息数据结构见图5
交易类型 交易标识 参与方身份标识 编号 交易信息 交易参与方 交易时间 交易方式 交易内容 共他 图5交易信息数据结构 交易信息数据元素见表5
表5交易信息数据元素 名称 是否必选 类型 备注 交易信息有效凭证和单据类型
取值电子订单,发货单,支付 交易类型 String 单、发票、物流运单 交易标识 是 String 交易信息有效凭证和单据的唯一标识 参与方身份标识 用于关联追溯参与方 String 编号 是 交易单证编号 String 交易参与方 String 交易对象的参与方名称 交易时间 Datetime 格式为YYYY-MM-DDTHH;MM:SS 否 交易方式 String 否 交易内容 String 其他 否 String 视需求,可适情扩展使用
GB/T39322一2020 7.6其他信息数据结构 其他信息数据结构见图6 其他信息 其他 图6其他信息数据结构 其他信息数据元素见表6
表6其他信息数据元素 名称 是否必选 类型 备注 视需求,可适情扩展使用并调整类型 否 其他 String 8 数据安全 应符合GB/T363182018中4.2和5,1.3的规定
GB/39322一2020 附录 A (资料性附录) 电子商务交易平台追溯数据接口JSON格式数据示例 A.1接口地址 示例参见表A.1
表A.1接口地址 https://domainname.com:88/path/ A.2接口原型 示例参见表A.2
表A.2接口原型 StringGetInfo(Stringtraceabilitycode，Stringpageindex,Stringtimestamp,Stringnonce,Stringseeretid,Stringsig nature A.3功能说明 追溯信息查询webService接口
根据请求调用返回某个追溯码对应的追溯信息
A.4参数说明 包括 a 提交方法(Method);post
b 内容类型(Content-Type):applieation/json. 请求参数 c 1公共参数:参见表A.3
表A.3公共参数表 参数项 含义 类型 备注 是否必选 否 method 指令名称 String 接口指令的名称 否 默认最新版本 接口版本号 String version pageindex 请求数据内容当前页码 否 Integer |用于支持数据集合分页,默认第1页 用于支持数据集合分页,默认20条 Ipagesize 请求数据内容每页条数 否 Integer
GB/T39322一2020 表A.3(续) 参数项 含义 是否必选 类型 备注 请求的时间 ltimestamp 是 Datetime格式为YYYY-MM-DDTHH:MM:SS 随机数 -次请求宜使用不同的随机数 nonce 每 String 服务端分配的安全凭证,用于标识服务接口 seeretid 密钥编号 是 String 调用者的身份 用来验证此次请求的合法性,由客户端根据 请求签名 signature 实际的输人参数并凭密匹按约定的签名算 是 String 法生成签名 业务参数;参见表A.4
表A.4业务参数示例表 参数项 含义 是否必选 类型 备注 traeeabilitycode 追溯码 是 String d 返回参数;参见表A.5
表A.5返回参数表 参数项 含义 是否必选 类型 备注 否 status 响应状态代码 String 参见B,1的响应状态代码 响应状态描述 参见B.1的响应状态描述 是 lmessage String Objieet 数据结果集 接口返回结果,各个接口自定义 data 返回的数据条数 默认为0条 totalcount lnteger 是 resultlist 返回业务数据集 根据业务的不同,返回相应的业务数据集 Array A.5返回说明 包括 消息啊应状态;参见附录B. a b)返回代码示例;参见表A.6
表A.6返回代码示例表 "0" "status" 'nmessage";"ok" "data” "otaleoumt" "resultlist” 10
GB/39322一2020 表A.6(续》 "tracesub": "racetype""上游供应商" "dentifier":"参与方身份标识1" "参与方名称1" name" "有效联系人1" 3ersnnel "联系地址1" address gOntat '联系方式1" "经营资质1" 1fication "产品资质！" Daualification tracetype";"电子商务平台经营者" "参与方身份标识2" dentiier "参与方名称2" iname "有效联系人2" )ersonnel "联系地址2" address" "联系方式2" contact "平台内经营者" tracesubidentifer""参与方身份标识3" "参与方身份标识3" identilier "参与方名称3" name yersonnel":"有效联系人3" "联系地址3" address "contact "联系方式3" tracetype";"电子商务物流服务商" "参与方身份标识4" identifier 1 "参与方名称4" personnel""有效联系人4" "address" "联系地址4" "联系方式4" contact "traceuni":D traceunittype":"GTIN" "identiier "追溯单元标识1" tracesubidentifier";"参与方身份标识1" "企业名称1" 'manufacturername" productname";"产品名称1" 1
GB/T39322一2020 表A.6(续 lotnumber""批次1"， manufacturedate";"生产日期1" "shefe" "保质期1" "product";"检验检测1" traceunittype":"SSCC" identiier "追溯单元标识2" racesubidentifer";"参与方身份标识1" "企业名称1" nanufacturername" "产品名称1" productname "批次1", manufacturedate";"生产日期1" shelflife""保质期1" Derson" "责任人2" traceunittype";"GSIN" "追溯单元标识3" "identifier" 、" rracesubidentifier" 参与方身份标识3", acturername";"企业名称3" "产 “品名称38 ame "批次3" "生产日期3" nanufacturedate" 保质期3" "作业环节3" ssnamme workktime "作业时间3" "traceloc":C "dentifier";"追溯位置标识1". tracesubidentifier""参与方身份标识1" address "具体地址1" personnel";"有效联系人1" "联系方式1 contact" identifier";"追溯位置标识2", tracesubidentifier""参与方身份标识1"， address "具体地址2" personnel";"有效联系人2" "联系方式2”" contact" 12
GB/39322一2020 表A.6(续》 "identifier""追溯位置标识3" "tracesubidentifer";"参与方身份标识1" address";"具体地址3" "有效联系人3" 'personnel" "contaet":"联系方式3" tracetra tracetratype";"电子订单" "交易标识1" identifier tracesubidentifier";"参与方身份标识1" "编号1 'orderid orderparticipants" "交易参与方1" "交易时间1" orderdatetimme "发货单" tracetratype" "identifier":"交易标识2" tracesubidentifier";"参与方身份标识1". orderid "编号2" "orderpartieipants";"交易参与方2" "交易时间2" orderdatetime "racetratype";"支付单" "dentifier "交易标识3" tracesubidentiier" "参与方身份标识1" orderidl "编号3" "交易参与方3" 'orderparticipants" "orderdatetime";"交易时间3" "tracetratype":"发票" "交易标识！" "identiffier tracesubidentifier";"参与方身份标识1" "编号4" 'orderid" orderpartieipants";"交易参与方4" "交易时间4" orderdatetime "tracetratype""物流运单" "identifier";"交易标识5", 13
GB/T39322一2020 表A.6(续) "tracesubidentifier""参与方身份标识1" "orderid";"编号5" orderpartidipants""交易参与方5" "交易时间5" "orderdatetime 14
GB/39322一2020 附录B 资料性附录 电子商务交易平台追溯数据接口消息响应状态 电子商务交易平台追溯数据接口消息响应状态参见表B.1
表B.1电子商务交易平台追溯数据接口消息响应状态 响应状态代码 响应状态描述 响应状态代码含义 ok 成功 请求参数错误 paramerror invalidformat soN或XML格式错谈 签名验证失败 signaturefailure 请求长度/大小超过限制 paramlenoverlimit 请求过期 reguestexpired replayattack 重放攻击 failedtogetdata 获取数据失败 versionerror 接口版本错误 接口异常 systemerror 15
GB/T39322一2020 参 考文献 GB/T18391.1一2009信息技术元数据注册系统(MDR第1部分;框架 [1] [7 GB/T195812004 信息技术会计核算软件数据接口 [T GB/T21062.3一2007政务信息资源交换体系第3部分:数据接口规范 [ GB/T24662一2009电子商务产品核心数据元 [ GB/Z25320.2一2013电力系统管理及其信息交换数据和通信安全第2部分:术语 [a GB/T25597一2010地理信息万维网地图服务接口 [7]GB/T26841一2011基于电子商务活动的交易主体企业信用档案规范 [8]GBy/T29261.4一2012信息技术自动识别和数据采集技术词汇第4部分;无线电 通信 [9]GBy/T29265.205一2017信息技术信息设备资源共享协同服务第205部分远程访间 基础协议 [10]GBy/T29622一2013电子商务信用卖方交易信用信息披露规范 [11] GB/T30996.1一2014信息技术实时定位系统第1部分;应用程序接口 电子商务平台运背与技术规范 12]GB/T31524一2015 [13]GB/T31782一2015 电子商务可信交易要求 [l4]GB/T32419.5一2017 信息技术soA技术实现规范第5部分;服务集成开发 [15]GB/T32180.1一2015财经信息技术企业资源计划软件数据接口第1部分;公共基础 数据 [[16]GB/T32873一2016 电子商务主体基本信息规范 电子商务参与方分类与编码 [17]GB/T32875一2016 [18]GB/T33479-2o16 党政机关电子公文交换接口规范 电子商务产品质量信息规范 [19]GB/T33992一2017 354082017电子商务质量管理术语 /T [20]GB [GBT351一30I7电子商务平台产品信息展示要求 [[22]GB/T36345-2018信息技术通用数据导人接口 [[23]GB/T36456.2一2018面向工程领域的共享信息模型第2部分;领域信息服务接口 [[24]GB/T369062018电子证照共享服务接口规范 [[25]GB/T38052.3一2019智能家用电器系统互操作第3部分;服务平台间接口规范 [[26]GB/T381552019重要产品追溯追溯术语 16
GB/T39322-2020电子商务交易平台追溯数据接口技术要求
随着互联网的不断发展和普及，电子商务已成为人们日常生活中不可或缺的一部分。为了保障消费者的权益，提高商品质量和安全性，追溯技术的应用越来越受到重视。而电子商务交易平台作为商品交易的重要平台之一，必须具备完善的数据接口技术，以满足追溯技术的要求。
为此，国家标准化管理委员会于2020年颁布了《电子商务交易平台追溯数据接口技术要求》（以下简称《标准》），该标准明确了电子商务交易平台追溯数据接口所需要遵循的技术规范和操作流程。
1. 标准适用范围
《标准》适用于电子商务交易平台的追溯数据接口技术规范和操作流程，涵盖了商品、生产企业、配送企业、零售企业等环节。
2. 技术要求
《标准》要求电子商务交易平台需具备以下技术要求：
- 支持多种数据格式：对接口进行设计时应充分考虑不同数据格式的差异性，支持多种主流数据格式，如XML、JSON等；
- 数据传输加密：保证数据传输安全性，使用HTTPS协议进行加密传输，防止中间人攻击等安全问题；
- 数据可追溯性：电子商务交易平台应能够按照一定规则对商品、生产企业、配送企业等信息进行记录和保存，并能够实现追溯查询功能；
- 数据实时性：数据更新及时，保证信息的及时性和准确性；
- 数据共享性：支持数据共享，方便相关部门监管和管理；
- 数据隐私保护：用户隐私数据应得到保护，不能被非法获取或滥用。
3. 操作流程
《标准》对电子商务交易平台追溯数据接口的操作流程也进行了规定，主要分为以下步骤：
- 用户提交追溯请求；
- 后台系统对请求进行处理，并查询相应信息；
- 返回符合条件的信息和查询结果。
同时，《标准》还规定了数据格式、数据元素、数据字典等方面的具体要求，以确保电子商务交易平台追溯数据接口的高效性和可靠性。
4. 总结
GB/T39322-2020电子商务交易平台追溯数据接口技术要求规范了电子商务交易平台追溯数据接口的技术要求和操作流程，有利于保障消费者权益，提高商品质量和安全性。同时，该标准的实施也将促进电子商务交易平台的规范化建设和管理，为电子商务行业的健康发展提供有力支持。
因此，作为电子商务领域的专业人士，我们应该深入学习和理解GB/T39322-2020电子商务交易平台追溯数据接口技术要求，积极应用到实际工作中，为推动电子商务行业的发展和创新贡献自己的力量。
电子商务交易平台追溯数据接口技术要求的相关资料
- 基于XML的电子商务订单报文GB/T26152-2010
- 基于XML的电子商务发票报文GB/T26151-2010
- 基于XML的电子商务业务数据和过程第2部分：业务信息实体目录GB/T20538.2-2010
- 基于电子商务活动的交易主体企业信用评价指标与等级表示规范GB/T26842-2011
- 基于电子商务活动的交易主体企业信用档案规范GB/T26841-2011
- 电子商务信用B2B第三方交易平台信用规范GB/T33717-2017解析
- GB/T39322-2020电子商务交易平台追溯数据接口技术要求
- 第三方电子商务交易平台社会责任实施指南
- 财经信息技术会计核算软件数据接口第4部分：商业银行GB/T24589.4-2011
- 财经信息技术会计核算软件数据接口第3部分：总预算会计GB/T24589.3-2011
- 能源计量仪表通用数据接口技术协议GB/T29871-2013解析
- 快速公交智能系统之公交优先设备与交通信号控制机通信数据接口规范
- 调度中心与场站站台控制系统通信数据接口规范GB/T31455.6-2015
- 农产品追溯要求水产品GB/T29568-2013
