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