全国食盐电子防伪追溯服务平台接口规范.docx

全国食盐电子防伪追溯服务平台接口规范

（生产企业接口规范）

（版本号：V3.0）

发布日期：2022年4月

目录

第一章总则 1

1.1背景 1

1.2文档内容 1

1.3适用范围 1

1.4解释权与修订权 1

第二章接口定义 1

2.1名词解释 1

2.2接口规则说明 2

2.3追溯码数据导出接口 3

2.3.1描述 3

2.3.2追溯码文件名称定义 3

2.3.3接口标准 3

2.4产品数据导出接口 4

2.4.1描述 4

2.4.2接口标准 4

2.4.3XMLSchema规范 5

2.4.4接口示例 9

2.5产品批次激活接口 11

2.5.1描述 11

2.5.2接口标准 11

2.5.3XMLSchema规范 12

2.5.4接口示例 16

2.6批发企业导出接口 17

2.6.1描述 17

2.6.2接口标准 17

2.6.3XMLSchema规范 18

2.6.4接口示例 20

2.7终端客户导出接口 21

2.7.1描述 21

2.7.2接口标准 21

2.7.3接口示例 24

2.8工厂出库接口 24

2.8.1描述 25

2.8.2接口标准 25

2.8.3XMLSchema规范 26

2.8.4接口示例 29

2.9文件传输规范 30

2.9.1文件大小 30

2.9.2文件拆分 30

2.10关联数据校验 30

2.10.1描述 30

2.10.2追溯码（20位）编码结构 31

—1—

第一章总则

1.1背景

目前全国食盐电子防伪追溯服务平台一期已开发建设完成，为规范平台的接口对接工作，整理了本接口标准。

1.2文档内容

本文主要规定了全国食盐电子防伪追溯服务平台与生产线客户端软件数据接口标准。

1.3适用范围

本文主要用于生产线客户端软件的开发与管理。用于指导各食盐生产企业的生产线客户软件的研制、开发和实施。本文适用于生产线客户软件系统建设厂家和食盐生产企业的管理及技术人员等。

1.4解释权与修订权

本文指导单位为工业和信息化部消费品工业司，主办单位为中国盐业协会。本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国盐业协会。

第二章接口定义

生产企业客户端分为中心客户端和生产线客户端，其中中心客户端为与全国食盐电子防伪追溯服务平台进行数据交换的客户端，生产线客户端为企业生产线上用来建立各级包装追溯码关联关系的客户端。

本文档详细说明了生产企业中心客户端与生产线客户端之间的数据接口，具体表现为如下几个接口：

各接口均为生产线客户端与中心客户端之间的数据交换接口，除“追溯码数据导出接口”采用指定的文本文件格式外，其他的接口均采用XML1.0的国际标准文件格式进行数据交换。

●追溯码数据导出接口

●产品数据导出接口

●产品批次激活接口

●批发企业导出接口

●终端客户导出接口

2.1名词解释

食盐定点生产企业：指取得由工业和信息化部（原为国家发展和改革委员会）审批发放的食盐定点生产企业证书的食盐生产企业。

—2—

食盐批发企业：指取得由工业和信息化部（原为国家发展和改革委员会）审批发放的食盐批发企业证书的食盐批发企业。

食盐企业：食盐企业包含食盐定点生产企业、食盐批发企业。

产品信息：定点生产企业产品具有的相关属性。包括：产品名称、净含量、规格、产品执行标准号、产品类别、生产日期、保质期、产地、产品批次、产品追溯码等信息。

批次激活：定点生产企业产品质量追溯系统中产品的原料信息、生产信息、检验信息、通过对产品唯一追溯码的批次管理，实现信息上传国家平台。

核注核销：食盐企业产品质量追溯系统产品的出入库流向信息，实现信息上传国家平台。

往来单位：往来单位包含“客户”和“供应商”，本平台主要的供应商为食盐定点批发企业。

终端客户：食盐销售零售商，如超市，食盐销售门店等。

企业追溯系统：食盐定点生产企业的产品质量追溯系统。做到对食盐产品从原材料到生产、仓库、流通等环节全程追溯。

原料：指生产食用盐所用的海盐、湖盐、井矿盐。

辅料：指生产食用盐所需的配料，包括氯化钾、碘酸钾、碘化钾等。

2.2接口规则说明

接口定义参考xmlschema的格式进行定义,但不同于xmlschema的语法规则