1、ICS 35.240CCS X 07 DB4403深 圳 市 地 方 标 准DB4403/T 190 2021食 品 经 营 者 追 溯 电 子 台 账 规 范 Specification for traceability electronic account offood business operators 2021-09-28发 布 2021-11-01实 施深 圳 市 市 场 监 督 管 理 局 发 布 DB4403/T 190 2021 I 目 次前 言 .II1 范 围 .12 规 范 性 引 用 文 件 .13 术 语 和 定 义 .14 缩 略 语 .15 电 子 台 账 通
2、用 要 求 .26 电 子 台 账 对 接 方 式 .3 7 信 息 传 输 要 求 .5附 录 A（ 资 料 性 ） 电 子 台 账 对 接 实 例 .6 DB4403/T 190 2021 II 前 言本 文 件 按 照 GB/T 1.1 2020 标 准 化 工 作 导 则 第 1 部 分 ： 标 准 化 文 件 的 结 构 和 起 草 规 则 的 规定 起 草 。本 文 件 由 深 圳 市 市 场 监 督 管 理 局 提 出 并 归 口 。本 文 件 起 草 单 位 ： 深 圳 市 标 准 技 术 研 究 院 、 深 圳 市 市 场 监 督 管 理 局 。本 文 件 主 要 起 草 人
3、 ： 徐 立 峰 、 李 颖 、 孙 勇 、 黎 志 文 、 周 文 丽 、 俞 科 、 吕 恺 文 、 周 哲 、 苏 巍 、 练 晓 、王 坤 、 郭 静 文 、 李 丽 娜 、 林 智 明 。 DB4403/T 190 2021 1 食 品 经 营 者 追 溯 电 子 台 账 规 范1 范 围本 文 件 规 定 了 食 品 经 营 者 追 溯 电 子 台 账 通 用 要 求 、 电 子 台 账 对 接 方 式 以 及 信 息 传 输 要 求 。本 文 件 适 用 于 食 品 经 营 者 建 立 以 食 品 追 溯 为 目 的 的 电 子 台 账 以 及 第 三 方 系 统 与 食 品 安
4、 全 追 溯 系 统电 子 台 账 数 据 的 交 互 。 食 品 包 括 预 包 装 食 品 、 食 用 农 产 品 、 食 品 原 料 、 食 品 添 加 剂 以 及 食 品 相 关 产 品 等 。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款 。 其 中 ， 注 日 期 的 引 用 文 件 ，仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件 ； 不 注 日 期 的 引 用 文 件 ， 其 最 新 版 本 （ 包 括 所 有 的 修 改 单 ） 适 用 于 本 文 件 。GB
5、 12904 商 品 条 码 零 售 商 品 编 码 与 条 码 表 示DB4403/T 191 2021 食 用 农 产 品 追 溯 码 编 码 技 术 规 范3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件 。3.1 食 品 安 全 追 溯 系 统 food safety traceability system为 食 品 安 全 监 管 机 构 、 食 品 供 应 链 相 关 企 业 、 社 会 公 众 提 供 食 品 安 全 追 溯 服 务 的 信 息 系 统 。3.2 食 品 经 营 者 food handlers 以 营 利 为 目 的 ， 从 事 生 产 经
6、 营 活 动 并 向 消 费 者 提 供 其 生 产 、 销 售 的 食 品 或 者 提 供 服 务 的 公 民 、 法 人或 者 其 它 经 济 组 织 。注 ： 本 文 中 将 食 品 经 营 者 根 据 追 溯 上 下 级 关 系 划 分 为 发 货 方 和 收 货 方 。3.3 电 子 台 账 electronic account通 过 电 子 计 算 机 和 网 络 ， 用 系 统 方 式 建 立 起 来 的 对 食 品 的 进 销 过 程 进 行 规 范 化 管 理 的 信 息 化 记 账 方式 。3.4 追 溯 电 子 台 账 traceability electronic ac
7、count以 实 现 对 食 品 从 生 产 、 供 应 、 物 流 配 送 到 零 售 终 端 的 全 程 追 溯 为 目 的 的 电 子 台 账 记 账 方 式 ， 来 表 示食 品 来 源 和 去 向 的 记 录 。3.5 第 三 方 系 统 third party system 企 业 自 建 的 或 租 用 的 ， 区 别 于 食 品 安 全 追 溯 系 统 的 外 部 系 统 。4 缩 略 语 DB4403/T 190 2021 2 下 列 缩 略 语 适 用 于 本 文 件 。DES： 数 据 加 密 标 准 （ Data Encryption Standard）HTTPS： 信
8、 息 安 全 传 输 协 议 （ Hyper Text Transfer Protocol over Secure Socket Layer）JSON： JavaScript对 象 表 示 法 （ JavaScript Object Notation）SSL： 安 全 套 接 层 （ Secure Socket Layer）XML： 可 扩 展 标 记 语 言 （ Extensible Markup Language）5 电 子 台 账 通 用 要 求5.1 电 子 台 账 概 述5.1.1 应 建 立 食 品 经 营 者 追 溯 电 子 台 账 制 度 ， 电 子 台 账 分 为 发 货 台
9、 账 和 收 货 台 账 。5.1.2 经 食 品 安 全 追 溯 系 统 实 名 认 证 的 用 户 ， 可 直 接 通 过 系 统 进 行 收 发 货 操 作 建 立 上 下 游 链 条 关 系 ， 同 时 系 统 自 动 生 成 追 溯 电 子 台 账 记 录 ， 用 户 可 在 收 发 货 电 子 台 账 库 中 自 行 打 印 和 下 载 相 关 发 货 台 账 或 收货 台 账 电 子 记 录 ， 如 图 1 虚 线 框 中 所 示 。5.1.3 采 用 系 统 互 联 对 接 方 式 的 第 三 方 系 统 ， 可 通 过 标 准 的 API接 口 方 式 或 电 子 台 账 报
10、 文 方 式 ， 生 成电 子 台 账 ， 与 食 品 安 全 追 溯 系 统 进 行 数 据 交 互 。 数 据 对 接 方 式 如 图 1虚 线 框 外 部 分 所 示 。 图 1 电 子 台 账 业 务 和 数 据 流 向 示 意 图5.2 电 子 台 账 记 录 要 求5.2.1 记 录 内 容 与 要 求 DB4403/T 190 2021 3 电 子 台 账 记 录 内 容 与 要 求 见 表 1。 表 1 电 子 台 账 记 录 要 求数 据 字 段 字 段 表 示 数 据 类 型 备 注发 货 日 期 deliverdate DATE 格 式 ： YYMMDD收 货 日 期 r
11、eceivedate DATE 格 式 ： YYMMDD产 品 编 码 productCode STRING 预 包 装 食 品 、 食 品 原 料 、 食 品 添 加 剂 以 及食 品 相 关 产 品 的 产 品 编 码 应 使 用 商 品 条码 ， 应 按 照 GB 12904 确 定 的 编 码 。 食 用农 产 品 的 产 品 编 码 应 按 照 DB4403/T 191 2021 中 第 6 章 规 定 的 的 追 溯 码 编 码 方 案产 品 名 称 productName STRING 产 品 分 类 productType STRING 规 格 /型 号 specificati
12、on STRING 品 牌 brand STRING 批 次 batchNo STRING 保 质 期 validate STRING 以 预 包 装 食 品 包 装 上 标 注 的 保 质 期 为 准检 验 报 告 checkreport STRING 食 品 出 厂 检 验 合 格 证 或 者 其 他 第 三 方 检验 合 格 证 明 。 如 ： 蔬 菜 应 有 农 残 检 验 报 告 ，肉 类 应 有 动 物 检 疫 检 验 合 格 证 （ 产 品 ） 等数 量 quality INT 发 货 方 统 一 社 会 信 用 代 码 deliveryCode STRING 18位 统 一 社
13、 会 信 用 代 码发 货 方 名 称 deliveryName STRING 发 货 方 联 系 人 姓 名 deliveryLinkName STRING 发 货 方 联 系 电 话 deliveryLinkTel STRING 收 货 方 统 一 社 会 信 用 代 码 receivedCode STRING 18位 统 一 社 会 信 用 代 码收 货 方 名 称 receivedName STRING 收 货 方 联 系 人 姓 名 receivedLinkName STRING 收 货 方 联 系 人 电 话 receivedLinkTel STRING 物 流 承 运 方 统 一
14、 社 会 信 用 代 码 logisticsCode STRING 18位 统 一 社 会 信 用 代 码物 流 承 运 方 名 称 logisticsName STRING 物 流 运 单 号 logisticsNO STRING 5.2.2 保 存 要 求电 子 台 账 数 据 保 存 期 限 不 得 少 于 产 品 保 质 期 后 6 个 月 ， 无 保 质 期 的 不 少 于 2 年 。6 电 子 台 账 对 接 方 式6.1 API接 口 方 式6.1.1 API接 口 描 述 DB4403/T 190 2021 4 API接 口 是 基 于 oauth2.0规 范 ， 使 用 实
15、名 认 证 进 行 身 份 认 证 ； API接 口 地 址 接 受 请 求 类 型 为 POST,数 据 格 式 为 JSON。6.1.2 API接 口 调 用API接 口 主 要 包 含 产 品 信 息 接 口 和 收 发 货 台 账 信 息 接 口 两 大 类 ， API 接 口 实 例 见 A.1。6.2 报 文 方 式6.2.1 总 则通 过 定 义 电 子 台 账 报 文 数 据 文 件 类 型 、 格 式 、 名 称 等 基 本 要 素 ， 使 上 传 数 据 能 形 成 统 一 的 数 据 流 ，并 通 过 相 应 的 报 文 对 接 方 式 ， 在 非 人 工 干 预 的 情
16、 况 下 完 成 数 据 上 传 。6.2.2 数 据 文 件 的 分 类 数 据 文 件 主 要 分 为 汇 总 文 件 和 业 务 数 据 文 件 两 大 类 。 汇 总 文 件 用 来 描 述 该 次 上 传 的 台 账 数 据 汇 总 信息 ， 即 每 项 业 务 数 据 的 记 录 总 数 ； 业 务 数 据 文 件 用 来 描 述 各 项 台 账 相 关 业 务 数 据 ， 根 据 业 务 将 台 账 数 据分 文 件 描 述 。 汇 总 文 件 和 业 务 数 据 文 件 应 符 合 下 列 规 则 ：a) 汇 总 文 件 要 求 如 下 ：1) 文 件 数 1 个 ， 命 名
17、为 Statistic_Request.xml；2) 汇 总 文 件 每 次 上 传 数 据 必 传 。b) 业 务 数 据 文 件 要 求 如 下 ：1) 文 件 数 3 个 ， 文 件 命 名 为 deliverAccount.xml、 receivedAccount.xml、 product.xml；2) 业 务 数 据 文 件 均 为 非 必 传 ， 若 汇 总 文 件 中 某 类 追 溯 数 据 记 录 数 不 为 0 时 ， 则 应 上 传 对 应 的XML数 据 文 件 。6.2.3 数 据 文 件 的 格 式数 据 文 件 格 式 定 义 见 表 2。 报 文 格 式 实 例
18、见 A.2。 表 2 数 据 文 件 格 式 定 义文 件 名 序 号 文 件 命 名 类 型 定 义 （ TYPE） 文 件 内 容汇 总 文 件 (1) Statistic_Request.xml Statistic_Request 上 传 数 据 汇 总 信 息业 务 数 据 文 件 (1) deliverAccount.xml Delivery 发 货 台 账(2) receivedAccount.xml Received 收 货 台 账(3) product.xml Product 产 品6.2.4 数 据 文 件 的 命 名 数 据 文 件 的 命 名 应 符 合 以 下 要 求
19、：a) 文 件 名 不 区 分 大 小 写 ；b) 文 件 名 与 表 2 中 的 文 件 命 名 一 致 ；c) XSD文 件 命 名 与 XML文 件 命 名 保 持 一 致 ； DB4403/T 190 2021 5 d) 如 果 数 据 记 录 数 超 过 单 文 件 限 制 需 拆 分 为 多 文 件 时 ， 则 命 令 格 式 为 “ 规 范 文 件 名 _序 号 （ 序 号为 从 001开 始 的 3 位 数 字 ） .xml” 。示 例 ： 发 货 台 账 的 数 据 文 件 命 名 为 deliverAccount.xml、 deliverAccount_001.xml、 d
20、eliverAccount_002.xml、deliverAccount_003.xml。6.2.5 单 文 件 数 据 条 数 限 制对 单 个 文 件 数 据 条 数 的 限 制 要 求 如 下 ：a) 单 个 文 件 信 息 条 数 不 超 过 1 万 条 ；b) 如 果 单 个 XML文 件 数 据 信 息 数 超 过 1 万 条 ， 则 需 分 多 个 文 件 上 传 ， 命 名 规 则 见 6.2.4。示 例 ： product.xml文 件 中 产 品 信 息 数 ， 最 多 允 许 1万 个 。7 信 息 传 输 要 求 7.1 传 输 方 式宜 采 用 通 过 HTTPS请
21、求 的 JSON 数 据 或 者 XML 数 据 传 输 方 式 。7.2 安 全 性 要 求安 全 性 要 求 包 括 ： 通 过 互 联 网 传 输 ， 应 对 数 据 进 行 加 密 ， 以 保 证 数 据 的 保 密 性 和 完 整 性 ； 传 输 通 道 应 统 一 采 用 SSL进 行 加 密 ， 宜 使 用 HTTPS 技 术 实 现 ； 数 据 文 件 在 传 输 之 前 ， 应 统 一 采 用 DES对 称 加 密 算 法 进 行 加 密 。7.3 可 靠 性 要 求应 实 现 断 点 续 传 ， 以 保 障 传 输 的 可 靠 性 。 DB4403/T 190 2021 6
22、 A A附 录 A（ 资 料 性 ）电 子 台 账 对 接 实 例A.1 API接 口 实 例A.1.1 获 取 token值以 产 品 发 货 台 账 API测 试 为 例 ， 获 取 token 值 方 式 如 下 ： assword&username=用 户 名 称 &password=密 码A.1.2 上 传 SON数 据调 用 产 品 发 货 台 账 接 口 ， 上 传 JSON 数 据 ,实 例 如 下 ： deliveryProducts: productCode: 6909548500352,productType: 53102305,expire: 300,productNa
23、me: 苹 果 果 味 饮 料 ,specification: 250ml,Brand: 天 然 , batchNo: 2020080404SZ,validate： 一 年 ,quality: 100,deliverdate: 2020-11-10,receivedCode: 91440300MA5FKDXC2F,receivedName: 天 虹 商 场 股 份 有 限 公 司 民 治 优 城 店 ,deliveryCode: 914403007298823514,deliveryLinkName: 李 生 ,deliveryLinkTel: 0755-83997959, productCo
24、de: 6901234567862,productType: 50192109, productName: 产 品 名 称 2.,specification : 32L,Brand: 百 家 乐 ,batchNo : 2xxx,validate： 半 年 ,quality: 200, DB4403/T 190 2021 7 deliverdate: 2020-11-10,receivedCode: 92440300FT0000558M,receivedName: 深 圳 天 虹 ,deliveryCode: 914403007298823514,deliveryLinkName: 李 生 ,d
25、eliveryLinkTel: 0755-83997959A.1.3 POST请 求 调 用POST请 求 调 用 实 例 如 下 ： 取 token 值 A.2 报 文 格 式 实 例A.2.1 文 件 头A.2.1.1 文 件 头 实 例文 件 头 实 例 如 下 ：1.091440300729882351492440300FT0000558M deliverAccount2.31047375-31804139714deliverAccount2020-11-10T16:34:12A.2.1.2 主 要 数 据 含 义文 件 头 实 例 主 要 数 据 含 义 如 下 ：a) “ 9144
26、03007298823514” 表 示 发 货 方 ， 为 发 送 该 文 件 的 单 位 统 一 社 会 信 用 代 码 ； b) “ 92440300FT0000558M” 表 示 收 货 方 ， 为 接 收 该 文 件 的 单 位 统 一 社 会 信 用 代 码 ；c) “ 1047375-31804139714” 为 该 文 档 的 标 识 字 符 串 ， 该 标 识 采 用 GUID；d) “ deliverAccount” 为 数 据 文 件 类 型 ， 代 表 发 货 台 账 ； DB4403/T 190 2021 8 e) “ 2020-11-10T16:34:12” 为 该 文 档 的 发 送 时 间 ， 格 式 为 yyyy-mm-ddTh24:mi:ss。A.2.2 文 件 体文 件 体 实 例 如 下 ：6909548500352531023052020080404SZ1002020-11-10 李 生 0755-8399795992440300FT0000558M深 圳 天 虹
