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

书书书犐犆犛３５．２４０．６０犔６７中华人民共和国国家标准犌犅／犜３９３２２—２０２０电子商务交易平台追溯数据接口技术要求犜犲犮犺狀犻犮犪犾狉犲狇狌犻狉犲犿犲狀狋狊犳狅狉狋狉犪犮犲犪犫犻犾犻狋狔犱犪狋犪犻狀狋犲狉犳犪犮犲犻狀犈犮狅犿犿犲狉犮犲狋狉犪狀狊犪犮狋犻狅狀狆犾犪狋犳狅狉犿２０２０１１１９发布２０２１０６０１实施国家市场监督管理总局国家标准化管理委员会发布书书书目　　次前言Ⅲ…………………………………………………………………………………………………………１　范围１………………………………………………………………………………………………………２　规范性引用文件１…………………………………………………………………………………………３　术语和定义１………………………………………………………………………………………………４　缩略语１……………………………………………………………………………………………………５　基本要求２…………………………………………………………………………………………………６　格式定义与数据类型２……………………………………………………………………………………７　数据结构３…………………………………………………………………………………………………８　数据安全８…………………………………………………………………………………………………附录Ａ（资料性附录）　电子商务交易平台追溯数据接口ＪＳＯＮ格式数据示例９………………………附录Ｂ（资料性附录）　电子商务交易平台追溯数据接口消息响应状态１５………………………………参考文献１６……………………………………………………………………………………………………Ⅰ犌犅／犜３９３２２—２０２０前　　言　　本标准按照ＧＢ／Ｔ１．１—２００９给出的规则起草。本标准由全国物流信息管理标准化技术委员会（ＳＡＣ／ＴＣ２６７）提出并归口。本标准起草单位：山东省标准化研究院、中国物品编码中心、安徽智?信信息技术有限公司、黑龙江省标准化研究院、山东百仕达地标产业有限公司、深圳市标准技术研究院、江苏省质量和标准化研究院。本标准主要起草人：王玎、梁厚广、孙小云、方方、陈康康、曹成坤、邵小景、王亚楠、王志恒、李铮、杜景荣、徐立峰、周哲、练晓、王瑜、李瑞兆。Ⅲ犌犅／犜３９３２２—２０２０电子商务交易平台追溯数据接口技术要求１　范围本标准规定了电子商务交易平台与相关系统交换追溯数据的基本要求、格式定义与数据类型、数据结构、数据安全。本标准适用于电子商务交易平台追溯数据服务接口的设计、开发和应用。２　规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ＧＢ／Ｔ７４０８—２００５　数据元和交换格式　信息交换　日期和时间表示法ＧＢ／Ｔ３６０６１—２０１８　电子商务交易产品可追溯性通用规范ＧＢ／Ｔ３６３１８—２０１８　电子商务平台数据开放　总体要求ＩＥＴＦＲＦＣ２６１６　超文本传输协议　ＨＴＴＰ／１．１（ＨｙｐｅｒｔｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌ—ＨＴＴＰ／１．１）ＩＥＴＦＲＦＣ２８１８　ＴＬＳ上的ＨＴＴＰ（ＨＴＴＰＯｖｅｒＴＬＳ）ＩＥＴＦＲＦＣ３５４８　Ｂａｓｅ１６、Ｂａｓｅ３２、Ｂａｓｅ６４数据编码（ＴｈｅＢａｓｅ１６，Ｂａｓｅ３２，ａｎｄＢａｓｅ６４ＤａｔａＥｎｃｏｄｉｎｇｓ）ＩＥＴＦＲＦＣ３６２９　ＵＴＦ８，ＩＳＯ１０６４６转换格式（ＵＴＦ８，ａｔｒａｎｓｆｏｒｍａｔｉｏｎｆｏｒｍａｔｏｆＩＳＯ１０６４６）３　术语和定义下列术语和定义适用于本文件。３．１　接口　犻狀狋犲狉犳犪犮犲描述实体行为的命名操作集。［ＧＢ／Ｔ２５５９７—２０１５，定义４．５］３．２　追溯参与方　狋狉犪犮犲犪犫犻犾犻狋狔狆犪狉狋犻犮犻狆犪狀狋在产品供应链中从事产品生产、加工、包装、仓储、销售、配送等相关业务的组织或个人。［ＧＢ／Ｔ３６０６１—２０１８，定义３．３］３．３　追溯数据　狋狉犪犮犲犪犫犻犾犻狋狔犱犪狋犪记录追溯的信息。［ＧＢ／Ｔ３８１５５—２０１９，定义３．４］４　缩略语下列缩略语适用于本文件。１犌犅／犜３９３２２—２０２０ＧＬＮ：全球参与方位置代码（ＧｌｏｂａｌＬｏｃａｔｉｏｎＮｕｍｂｅｒ）ＧＳＩＮ：全球货运标识代码（ＧｌｏｂａｌＳｈｉｐｍｅｎｔＩｄｅｎｔｉｆｉｃａｔｉｏｎＮｕｍｂｅｒ）ＧＴＩＮ：全球贸易项目代码（ＧｌｏｂａｌＴｒａｄｅＩｔｅｍＮｕｍｂｅｒ）ＨＴＴＰ：超文本传输协议（ＨｙｐｅｒＴｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌ）ＨＴＴＰＳ：超文本传输安全协议（ＨｙｐｅｒＴｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌｏｖｅｒＳｅｃｕｒｅＳｏｃｋｅｔＬａｙｅｒ）ＪＳＯＮ：ＪａｖａＳｃｒｉｐｔ对象标记（ＪａｖａＳｃｒｉｐｔＯｂｊｅｃｔＮｏｔａｔｉｏｎ）ＳＳＣＣ：系列货运包装箱代码（ＳｅｒｉａｌＳｈｉｐｐｉｎｇＣｏｎｔａｉｎｅｒＣｏｄｅ）ＵＲＬ：统一资源定位符（ＵｎｉｆｏｒｍＲｅｓｏｕｒｃｅＬｏｃａｔｏｒ）５　基本要求电子商务交易平台追溯数据接口通过服务调用获取所需的信息，要求如下：———应采用符合ＩＥＴＦＲＦＣ３６２９规定的ＵＴＦ８字符集；———应采用ＨＴＴＰ或ＨＴＴＰＳ协议作为底层承载协议，采用ＨＴＴＰ协议时应符合ＩＥＴＦＲＦＣ２６１６的规定，采用ＨＴＴＰＳ协议时应符合ＩＥＴＦＲＦＣ２８１８的规定；———应进行用户合法性、数据规范性等校验；———应控制交换的追溯数据记录数量，可采用分页传输等方式，宜不影响数据的解析性能；———发生错误时，接口应将详细的错误信息返回至相关业务系统，由各业务系统对错误进行记录分析和整改；———应建立接口日志记录，能识别数据异常或追溯交换数据情况。６　格式定义与数据类型６．１　接口格式定义主要包括：ａ）　接口地址：请求的ＵＲＬ地址，一般由域名或ＩＰ、端口号、接口路径组成，参见附录Ａ中Ａ．１；ｂ）　接口原型：由电子商务交易平台追溯数据接口的返回类型、接口名和参数等组成，参见Ａ．２；ｃ）　功能说明：电子商务交易平台追溯数据接口功能的简要描述，参见Ａ．３；ｄ）　参数说明：调用电子商务交易平台追溯数据接口的输入参数或者输出参数情况，参见Ａ．４；ｅ）　返回说明：电子商务交易平台接口调用正常和（或）异常的响应状态（参见附录Ｂ）、示例等，参见Ａ．５。６．２　数据类型主要包括：———字符型，用Ｓｔｒｉｎｇ表示；———整数型，用Ｉｎｔｅｇｅｒ表示；———浮点型，用Ｆｌｏａｔ表示；———日期时间型，用Ｄａｔｅｔｉｍｅ表示，应符合ＧＢ／Ｔ７４０８—２００５的规定；———对象型，用Ｏｂｊｅｃｔ表示，对应ＪＳＯＮ中的“对象符号”；———数组型，用Ａｒｒａｙ表示，是一个或多个ＪＳＯＮ对象符号的集合。２犌犅／犜３９３２２—２０２０７　数据结构７．１　追溯数据的总体数据结构应对接口交换的电子商务交易平台追溯数据的数据集进行封装：ａ）　追溯数据的数据集由一组或多组追溯数据组成；ｂ）　追溯数据包括一组或多组追溯参与方、追溯单元、追溯位置、交易信息，并可根据需求扩展使用其他信息；ｃ）　追溯参与方、追溯单元、追溯位置、交易信息的内容应符合ＧＢ／Ｔ３６０６１—２０１８中第７章及第８章的要求。追溯数据的总体数据结构见图１。图１　追溯数据的总体数据结构　　总体数据结构组成元素见表１。表１　总体数据结构组成元素名称是否必选类型备注追溯数据的数据集是Ａｒｒａｙ追溯数据的数据集数组包括一个或多个追溯数据对象追溯数据是Ｏｂｊｅｃｔ追溯数据对象追溯参与方是Ａｒｒａｙ追溯参与方数组包括一个或多个追溯参与方对象追溯单元是Ａｒｒａｙ追溯单元数组包括一个或多个追溯单元对象追溯位置是Ａｒｒａｙ追溯位置数组包括一个或多个追溯位置对象交易信息是Ａｒｒａｙ交易信息数组包括一个或多个交易信息对象其他信息否Ａｒｒａｙ视需求，可适情扩展使用７．２　追溯参与方数据结构追溯参与方数据结构见图２。３犌犅／犜３９３２２—２０２０图２　追溯参与方数据结构　　追溯参与方数据元素见表２。表２　追溯参与方数据元素名称是否必选类型备注参与方类型是Ｓｔｒｉｎｇ追溯所涉及的关键节点类型。取值：上游供应商、电子商务平台经营者、平台内经营者、电子商务物流服务商参与方身份标识是Ｓｔｒｉｎｇ应符合ＧＢ／Ｔ３６０６１—２０１８中８．２．１的要求，可采用ＧＬＮ或统一社会信用代码参与方名称是Ｓｔｒｉｎｇ与统一社会信用代码对应的主体名称有效联系人是Ｓｔｒｉｎｇ联系地址是Ｓｔｒｉｎｇ联系方式是Ｓｔｒｉｎｇ经营资质否Ｓｔｒｉｎｇ如营业执照等。图片文件采用ＢＡＳＥ６４编码规则（应符合ＩＥＴＦＲＦＣ３５４８的规定）转换为字符串，或给出其ＵＲＬ链接地址字符串格式产品资质否Ｓｔｒｉｎｇ如中国国家强制性产品认证证书、绿色食品证书等，图片文件采用ＢＡＳＥ６４编码规则转换为字符串，或给出其ＵＲＬ链接地址字符串格式其他否Ｓｔｒｉｎｇ视需求，可适情扩展使用７．３　追溯单元数据结构追溯单元数据结构见图３。４犌犅／犜３９３２２—２０２０图３　追溯单元数据结构　　追溯单元数据元素见表３。表３　追溯单元数据元素名称是否必选类型备注追溯单元类型是Ｓｔｒｉｎｇ追溯单元信息类型，取值与含义：ＧＴＩＮ———追溯贸易单元；ＳＳＣＣ———追溯物流单元；ＧＳＩＮ———追溯装运单元追溯单元标识是Ｓｔｒｉｎｇ编码结构应符合ＧＢ／Ｔ３６０６１—２０１８中８．２．２的规定参与方身份标识是Ｓｔｒｉｎｇ用于关联追溯参与方生产／加工企业名称是Ｓｔｒｉｎｇ产品名称是Ｓｔｒｉｎｇ５犌犅／犜３９３２２—２０２０表３（续）名称是否必选类型备注生产批次号是Ｓｔｒｉｎｇ序列号否Ｓｔｒｉｎｇ当追溯到单品时，必选唯一的序列号生产日期／包装日期是Ｄａｔｅｔｉｍｅ格式为ＹＹＹＹＭＭＤＤ或ＹＹＹＹＭＭＤＤＴＨＨ：ＭＭ：ＳＳ保质期／有效期是Ｓｔｒｉｎｇ产品数量否Ｉｎｔｅｇｅｒ重量否Ｆｌｏａｔ（原）产地否Ｓｔｒｉｎｇ检验检测否Ｓｔｒｉｎｇ产品图片否Ｓｔｒｉｎｇ图片文件采用ＢＡＳＥ６４编码规则转换为字符串，或给出其ＵＲＬ链接地址字符串格式作业环节否Ｓｔｒｉｎｇ如入库、拣货、验货、出库等作业时间否Ｄａｔｅｔｉｍｅ格式为ＹＹＹＹＭＭＤＤＴＨＨ：ＭＭ：ＳＳ责任人否Ｓｔｒｉｎｇ其他否Ｓｔｒｉｎｇ视需求，可适情扩展使用７．４　追溯位置数据结构追溯位置数据结构见图４。图４　追溯位置数据结构　　追溯位置数据元素见表４。表４　追溯位置数据元素名称是否必选类型备注位置标识是Ｓｔｒｉｎｇ宜采用ＧＬＮ，其编码结构按ＧＢ／Ｔ３６０６１—２０１８中Ａ．１．２的规定参与方身份标识是Ｓｔｒｉｎｇ用于关联追溯参与方具体地址是Ｓｔｒｉｎｇ有效联系人否Ｓｔｒｉｎｇ６犌犅／犜３９３２２—２０２０表４（续）名称是否必选类型备注联系方式否Ｓｔｒｉｎｇ其他否Ｓｔｒｉｎｇ视需求，可适情扩展使用７．５　交易信息数据结构交易信息数据结构见图５。图５　交易信息数据结构　　交易信息数据元素见表５。表５　交易信息数据元素名称是否必选类型备注交易类型是Ｓｔｒｉｎｇ交易信息有效凭证和单据类型。取值：电子订单、发货单、支付单、发票、物流运单交易标识是Ｓｔｒｉｎｇ交易信息有效凭证和单据的唯一标识参与方身份标识是Ｓｔｒｉｎｇ用于关联追溯参与方编号是Ｓｔｒｉｎｇ交易单证编号交易参与方是Ｓｔｒｉｎｇ交易对象的参与方名称交易时间是Ｄａｔｅｔｉｍｅ格式为ＹＹＹＹＭＭＤＤＴＨＨ：ＭＭ：ＳＳ交易方式否Ｓｔｒｉｎｇ交易内容否Ｓｔｒｉｎｇ其他否Ｓｔｒｉｎｇ视需求，可适情扩展使用７犌犅／犜３９３２２—２０２０７．６　其他信息数据结构其他信息数据结构见图６。图６　其他信息数据结构　　其他信息数据元素见表６。表６　其他信息数据元素名称是否必选类型备注其他否Ｓｔｒｉｎｇ视需求，可适情扩展使用并调整类型８　数据安全应符合ＧＢ／Ｔ３６３１８—２０１８中４．２和５．１．３的规定。８犌犅／犜３９３２２—２０２０附　录　犃（资料性附录）电子商务交易平台追溯数据接口犑犛犗犖格式数据示例犃．１　接口地址示例参见表Ａ．１。表