(高清版)GB∕T 39322-2020 电子商务交易平台追溯数据接口技术要求

L67中华人民共和国国家标准电子商务交易平台追溯数据接口技术要求TE-国家市场监督管理总局国家标准化管理委员会ⅠGB／T39322—2020 1范围 2规范性引用文件 3术语和定义 4缩略语 5基本要求 6格式定义与数据类型 7数据结构 8数据安全 附录B（资料性附录）电子商务交易平台追溯数据接口消息响应状态 参考文献 ⅢGB／T39322—2020本标准按照GB/T1.1—2009给出的规则起草。本标准由全国物流信息管理标准化技术委员会(SAC/TC267)提出并归口。本标准起草单位：山东省标准化研究院、中国物品编码中心、安徽智?信信息技术有限公司、黑龙江省标准化研究院、山东百仕达地标产业有限公司、深圳市标准技术研究院、江苏省质量和标准化研究院。本标准主要起草人：王玎、梁厚广、孙小云、方方、陈康康、曹成坤、邵小景、王亚楠、王志恒、李铮、1GB／T39322—2020电子商务交易平台追溯数据接口技术要求本标准规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据结构、数据安全。本标准适用于电子商务交易平台追溯数据服务接口的设计、开发和应用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7408—2005数据元和交换格式信息交换日期和时间表示法GB/T36061—2018电子商务交易产品可追溯性通用规范GB/T36318—2018电子商务平台数据开放总体要求IETFRFCIETFRFCTLS上的HTTP(HTTPOverTLS)IETFRFCBase16、Base32、Base64数据编码(TheBase16,Base32,andBase64DataEn-IETFRFCUTF-8,ISO10646转换格式(UTF-8,atransformationformatofISO10646)3术语和定义下列术语和定义适用于本文件。3.1描述实体行为的命名操作集。[GB/T25597—2015,定义4.5]3.2在产品供应链中从事产品生产、加工、包装、仓储、销售、配送等相关业务的组织或个人。[GB/T36061—2018,定义3.3]3.3记录追溯的信息。[GB/T38155—2019,定义3.4]下列缩略语适用于本文件。GB／T39322—2020URL：统一资源定位符(UniformResourceLocator)5基本要求电子商务交易平台追溯数据接口通过服务调用获取所需的信息，要求如下：—应采用符合IETFRFC3629规定的UTF-8字符集；—应采用HTTP或HTTPS协议作为底层承载协议，采用HTTP协议时应符合IETFRFC2616的规定，采用HTTPS协议时应符合IETFRFC2818的规定；—应进行用户合法性、数据规范性等校验；—应控制交换的追溯数据记录数量，可采用分页传输等方式，宜不影响数据的解析性能；—发生错误时，接口应将详细的错误信息返回至相关业务系统，由各业务系统对错误进行记录分析和整改；—应建立接口日志记录，能识别数据异常或追溯交换数据情况。6格式定义与数据类型主要包括：主要包括：Datetime表示，应符合GB/T7408—2005的规定；23GB／T39322—20207数据结构7.1追溯数据的总体数据结构应对接口交换的电子商务交易平台追溯数据的数据集进行封装：；其他信息；第8章的要求。追溯数据的总体数据结构见图1。图1追溯数据的总体数据结构总体数据结构组成元素见表1。表1总体数据结构组成元素名称是否必选类型备注追溯数据的数据集是追溯数据的数据集数组包括一个或多个追溯数据对象追溯数据是追溯数据对象追溯参与方是追溯参与方数组包括一个或多个追溯参与方对象追溯单元是追溯单元数组包括一个或多个追溯单元对象追溯位置是追溯位置数组包括一个或多个追溯位置对象交易信息是交易信息数组包括一个或多个交易信息对象其他信息否视需求，可适情扩展使用7.2追溯参与方数据结构追溯参与方数据结构见图2。4GB／T39322—2020图2追溯参与方数据结构追溯参与方数据元素见表2。表2追溯参与方数据元素名称是否必选类型备注参与方类型是String追溯所涉及的关键节点类型。取值：上游供应商、电子商务平台经营者、平台内经营者、电子商务物流服务商参与方身份标识是String应符合GB/T36061—2018中8.2.1的要求，可采用GLN或统一社会信用代码参与方名称是String与统一社会信用代码对应的主体名称有效联系人是String联系地址是String联系方式是String经营资质否String如营业执照等。图片文件采用BASE64编码规则（应符合IETFRFC3548的规定）转换为字符串，或给出其URL链接地址字符串格式产品资质否String如中国国家强制性产品认证证书、绿色食品证书等，图片文件采用BASE64编码规则转换为字符串，或给出其URL链接地址字符串格式其他否String视需求，可适情扩展使用7.3追溯单元数据结构追溯单元数据结构见图3。5GB／T39322—2020图3追溯单元数据结构追溯单元数据元素见表3。表3追溯单元数据元素名称是否必选类型备注追溯单元类型是String追溯单元信息类型，取值与含义：GTIN—追溯贸易单元；SSCC—追溯物流单元；GSIN—追溯装运单元追溯单元标识是String编码结构应符合GB/T36061—2018中8.2.2的规定参与方身份标识是String用于关联追溯参与方生产／加工企业名称是String产品名称是StringGB／T39322—2020名称是否必选类型备注生产批次号是String序列号否String当追溯到单品时，必选唯一的序列号生产日期／包装日期是Datetime格式为YYYY-MM-DD或YYYY-MM-DDTHH:MM:SS保质期／有效期是String产品数量否Integer重量否Float否String检验检测否String产品图片否String图片文件采用BASE64编码规则转换为字符串，或给出其URL链接地址字符串格式作业环节否String如入库、拣货、验货、出库等作业时间否Datetime格式为YYYY-MM-DDTHH:MM:SS责任人否String其他否String视需求，可适情扩展使用7.4追溯位置数据结构追溯位置数据结构见图4。图4追溯位置数据结构追溯位置数据元素见表4。表4追溯位置数据元素名称是否必选类型备注位置标识是String宜采用GLN,其编码结构按GB/T36061—2018中A.1.2的规定参与方身份标识是String用于关联追溯参与方具体地址是String有效联系人否String67GB／T39322—2020名称是否必选类型备注联系方式否String其他否String视需求，可适情扩展使用7.5交易信息数据结构交易信息数据结构见图5。图5交易信息数据结构交易信息数据元素见表5。表5交易信息数据元素名称是否必选类型备注交易类型是String交易信息有效凭证和单据类型。取值：电子订单、发货单、支付单、发票、物流运单交易标识是String交易信息有效凭证和单据的唯一标识参与方身份标识是String用于关联追溯参与方编号是String交易单证编号交易参与方是String交易对象的参与方名称交易时间是Datetime格式为YYYY-MM-DDTHH:MM:SS交易方式否String交易内容否String其他否String视需求，可适情扩展使用8GB／T39322—20207.6其他信息数据结构其他信息数据结构见图6。图6其他信息数据结构其他信息数据元素见表6。表6其他信息数据元素名称是否必选类型备注其他否String视需求，可适情扩展使用并调整类型8数据安全应符合GB/T36318—2018中4.2和5.1.3的规定。9GB／T39322—2020附录A（资料性附录）JONA.1接口地址示例参见表A.1。表A.1接口地址A.2接口原型示例参见表A.2。表A.2接口原型nature)A.3功能说明A.4参数说明包括：1)公共参数：参见表A.3。表A.3公共参数表参数项含义是否必选类型备注method指令名称否String接口指令的名称version接口版本号否String默认最新版本pageindex请求数据内容当前页码否Integer用于支持数据集合分页，默认第1页pagesize请求数据内容每页条数否Integer用于支持数据集合分页，默认20条GB／T39322—2020表A.3（续）参数项含义是否必选类型备注timestamp请求的时间是Datetime格式为YYYY-MM-DDTHH:MM:SSnonce随机数是String每一次请求宜使用不同的随机数secretid密钥编号是String服务端分配的安全凭证，用于标识服务接口调用者的身份signature请求签名是String用来验证此次请求的合法性，由客户端根据实际的输入参数并凭密匙按约定的签名算法生成签名2)业务参数：参见表A.4。表A.4业务参数示例表参数项含义是否必选类型备注traceabilitycode追溯码是String表A.5返回参数表参数项含义是否必选类型备注status响应状态代码否String参见B.1的响应状态代码message响应状态描述是String参见B.1的响应状态描述data数据结果集是接口返回结果，各个接口自定义totalcount返回的数据条数是Integer默认为0条resultlist返回业务数据集是根据业务的不同，返回相应的业务数据集A.5返回说明包括：B表A.6返回代码示例表{"status":"0","data":{"totalcount":1,"resultlist":[{GB／T39322—2020表A.6（续）"tracesub":[{"name":"参与方名称1","address":"联系地址1","contact":"联系方式1",{"name":"参与方名称2","address":"联系地址2","contact":"联系方式2"{"name":"参与方名称3","address":"联系地址3","contact":"联系方式3"{"name":"参与方名称4","address":"联系地址4","contact":"联系方式4"],"traceunit":[{"manufacturername":"企业名称1",GB／T39322—2020表A.6（续）"lotnumber":"批次1","manufacturedate":"生产日期1","shelflife":"保质期1",{"manufacturername":"企业名称1","lotnumber":"批次1","manufacturedate":"生产日期1","shelflife":"保质期1",{"manufacturername":"企业名称3","lotnumber":"批次3","manufacturedate":"生产日期3","shelflife":"保质期3","worktime":"作业时间3"}],"traceloc":[{"contact":"联系方式1"{"contact":"联系方式2"GB／T39322—2020表A.6（续）{"contact":"联系方式3"}],"tracetra":[{"identifier":"交易标识1","orderid":"编号1","orderdatetime":"交易时间1"{"identifier":"交易标识2","orderid":"编号2","orderdatetime":"交易时间2"{"identifier":"交易标识3","orderid":"编号3","orderdatetime":"交易时间3"{"identifier":"交易标识4","orderid":"编号4","orderdatetime":"交易时间4"{"identifier":"交易标识5",GB／T39322—2020表A.6（续）"orderid":"编号5","orderdatetime":"交易时间5"}]}]}}GB／T39322—2020附录B（资料性附录）电子商务交易平台追溯数据接口消息响应状态电子商务交易平台追溯数据接口消息响应状态参见表B.1。表B.1电子商务交易平台追溯数据接口消息响应状态响应状态代码响应状态描述响应状态代码含义0ok成功1paramerror请求参数错误2invalidformatJSON或XML格式错误3signaturefailure签名验证失败4paramlenoverlimit请求长度／大小超过限制5requestexpired请求过期6replayattack重放攻击7failedtogetdata获取数据失败8versionerror接口版本错误9systemerror接口异常………GB／T39322—2020[1]GB/T18391.1—2009信息技术元数据注册系统(MDR)第1部分：框架[2]GB/T19581—2004信息技术会计核算软件数据接口[3]GB/T21062.3—2007政务信息资源交换体系第3部分：数据接口规范[4]GB/T24662—2009电子商务产品核心数据元[5]GB/Z25320.2—2013电力系统管理及其信息交换数据和通信安全第2部分：术语[6]GB/T25597—2010地理信息万维网地图服务接口[7]GB/T26841—2011基于电子商务活动的交易主体企业信用档案规范[8]GB/T29261.4—2012信息技术自动识别和数据采集技术词汇第4部分：无线电通信[9]GB/T29265.205—2017信息技术信息设备资源共享协同服务第205部分：远程访问基础协议[10]GB/T29622—2013电子商务信用卖方交易信用信息披露规范[11]GB/T30996.1—