福建省“一品一码”食品安全 信息追溯管理平台项目 地市数据交换共享服务标准.doc

福建省“一品一码”食品安全 信息追溯管理平台项目 地市数据交换共享服务标准 福建省食品药品监督管理局 地市数据交换共享服务标准 文件更改摘要 日期 版本号 修订说明 修订人 审核人 批准人 18.3.22 V 1.0 创建全文 18.4.7 V 1.1 增加食品交易单据、内部小包装配置表、检验报告类型3个问题 18.4.26 V 1.2 调整了专用术语、增加了基础代码类型 18.5.18 V 1.3 进货单据表增加“关联销货单据”字段；销售单据表增加“关联进货单据号”字段；将入境货物检验检疫证明从检验检测中独立；调整订餐主体代码的字段长度；统一修改登记主体代码regEntId为regEntUnicode；修改合格方式CA015为CA014；修改接口ID 为21W03的节点entInfo为entLicense；调整产地证明编号字段为inspectionNo，产地证明名称字段为inspectionName、产地证明文件字段为inspectionReport； 18.5.20 V 1.4 增加餐饮加工数据写入接口(32W03)；修改接口12W02节点为fpProduct；修订“食品基础信息”的“小包装明细”、餐饮进货台账、餐饮销货台账的节点名称 18.5.26 V 1.5 接口22W01增加关联销货单据字段；修改接口22W01节点fcEntryFJBill为fcStockBill；修改错误的文字说明；增加第5.2.2章节、第7章节数据删除接口规范；修订第6章，增加数据修改说明；修改所属行业的字段备注 18.6.15 V 1.6 修改保质期字段备注；修改食品基础信息，预包装食品类型，产地可以为空；食用农产品类型，产地非空；企业信息，证件类型、证件号码可以为空；检验检测信息，检测报告编号可以为空；产地证明，产地证明编号可以为空；增加第5.2.3章节、第8章节，查询接口 18.6.19 V 1.7 检验检测报告新增检测有效期至字段；修改订餐主体信息中的订餐人姓名、订餐人联系方式、地址的字段名称 18.8.13 V 1.8 主体信息、销货台账、餐饮类型的食品基础数据格式，增加许可证号，餐饮类型主体，主体代码、许可证号只要一个不为空即可；修改经营范围字段长度为4000 18.9.3 V 1.9 增加6.1.2.4、6.2.2.4、6.3.2.4章节，食品处理台账数据交换标准 18.9.21 V 1.10 主体数据格式增加“所属市场ID”字段；增加8.1.3章节 II 地市数据交换共享服务标准 目 录 I 地市数据交换共享服务标准 1. 范围 1 2. 规范性引用文件 1 3. 术语和定义 1 4. 缩略语 3 5. 接口调用规范 3 5.1 身份验证接口 3 5.2 接口调用说明 4 5.2.1 数据接入接口定义 4 5.2.2 数据删除接口定义 5 5.2.3 数据查询接口定义 6 5.3 返回数据格式 6 5.3.1 XML格式 6 5.3.2 JSON格式 7 5.3.3 标识码定义 7 6. 数据写入更新标准规范 8 6.1 生产型主体 8 6.1.1 基础数据 8 6.1.2 台账数据 14 6.1.3 上市凭证 18 6.2 流通型主体 21 6.2.1 基础数据 21 6.2.2 台账数据 26 6.2.3 上市凭证 31 6.3 餐饮服务者 34 6.3.1 基础数据 34 6.3.2 台账数据 39 6.3.3 上市凭证 43 7. 数据删除标准规范 46 7.1 生产型主体 46 7.1.1 基础数据 46 7.1.2 台账数据 48 7.1.3 上市凭证 49 7.2 流通型主体 50 7.2.1 基础数据 50 7.2.2 台账数据 52 7.2.3 上市凭证 53 7.3 餐饮服务者 54 7.3.1 基础数据 54 7.3.2 台账数据 56 7.3.3 上市凭证 57 8. 数据查询接口规范 58 8.1 基础数据 58 8.1.1 生产经营主体信息查询 58 8.1.2 食品基础信息查询 59 8.1.3 市场信息查询 61 8.2 交易数据 62 8.2.1 食品交易单据 62 9. 单据码编码规则 63 9.1 省直单位建设追溯系统单据码 63 9.2 各地市建设追溯系统单据码 64 9.3 企业建设追溯系统单据码 64 10. 注意事项 64 II 地市数据交换共享服务标准 1. 范围 本标准规定了福建省“一品一码”食品安全信息追溯管理平台（以下简称“一品一码”追溯管理平台）与福建省地市自建追溯系统数据交换的技术架构、接口规范、交换过程、数据交换规范等。 本标准适用于地市自建系统与“一品一码”追溯管理平台数据共享与数据交换服务。 2. 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条段．凡是注日期的引用文件。其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准。然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 GB/T 7408-2005 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18391.1-2002 信息技术 数据元的规范与标准 第一部分：数据元的规范与标准化框架 GB/T 21062.1-2007 政务信息资源交换体系 第1部分：总体框架 GB/T 21062.2-2007 政务信息资源交换体系 第2部分：技术要求 GB/T 20162.2-2007 政务信息资源交换体系 第3部分：数据接口规范 3. 术语和定义 下列术语和定义适用于本标准。 （1） 福建省“一品一码”食品安全信息追溯管理平台 福建省建立统一的福建省食品安全信息追溯管理平台，汇集相关行政主管部门追溯系统信息，通过编码识别、身份信息比对等技术手段和验证管理实现追溯食品和生产经营者等信息的共享。 （2） 一品一码 一品一码指同一品种批次的食品和食用农产品按照规定的追溯编码规则，赋予唯一的识别追溯码。 （3） 生产经营主体 从事食品生产经营活动的政府、组织、单位、法人和自然人等具备食品追溯能力的单位和自然人。 （4） 主体代码 法人采用统一社会信用代码，由一组长度为18位的用于法人和其他组织身份识别的代码。统一社会信用代码由国家标准委发布。国家标准委发布了强制性国家标准《法人和其他组织统一社会信用代码编码规则》。 针对自然人采用散户代码或身份证号码。 （5） 生产经营许可 生产经营许可证是许可证的一个类别之一，是县级以上食品药品监管部门对食品生产与经营者颁发的允许进行食品生产经营的法定证件。 （6） 食用农产品 指在农业活动中直接获得的，以及经过分拣、去皮、剥壳、干燥、粉碎、清洗、切割、冷冻、打蜡、分级、包装等加工，但未改变其基本自然性状和化学性质的、供人食用的植物、动物、微生物及其产品。 （7） 预包装食品 指预先定量包装或者制作在包装材料和容器中的食品；包括预先定量包装以及预先定量制作在包装材质和容器中并且在一定量限范围内具有统一的质量或体积标识的食品。简单说，就是指在包装完成后即具有确定的量值，这一确定的量值应是在一定量限范围内具有统一的质量或体积标识。 （8） 入境食品 指从其他国家和地区进口的食品。 （9） 入闽食品 指中国国内，福建省外的食品，通俗的讲就是其他省份和地区食品，包含在其他省份和地区生产并在福建省内分包装的食品。 （10） 食品代码 预包装食品的代码，由企业向中国物品编码中心申请，进行自主食品编码，并在中国物品编码中心备案；散装食品的代码，由各厅局负责源头赋码。 （11） 食品追溯码 指福建省质量技术监督局研究出台的福建省地方标准《食品质量安全追溯码编码技术规范》（DB35/T 1711-2017）规定的食品追溯码。 （12） 数据提供方 福建省“一品一码”食品安全信息追溯管理平台。 （13） 用户 与福建省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的全省生产经营主体自建追溯管理平台。 （14） 数据项 共享数据实体。 （15） 数据集 组成共享数据实体的集合。 （16） 数据版本号 共享数据在更新序列上的唯一标识。 4. 缩略语 XML -- 可扩展标识语言（eXtensible Markup Language） SOAP -- 简单对象访问协议（Simple Object Access Protocol ) UDDI -- 统一描述、发现和集成（ Universal Description，Discovery , and Integration） 5. 接口调用规范 5.1 身份验证接口 通过“一品一码”食品安全信息追溯管理平台调用各类接口时，必须先对调用方的用户身份及权限进行验证，本接口负责用户身份认证和权限验证功能。应用程序调用本接口进行身份认证和权限验证，通过后将获取身份校验码，用户通过该身份校验码才能访问其他接口。校验码的有效时间为30分钟。 (1) 原型接口 public String getVerifyCode(String userAccount, String password,String dataType) (2) 参数说明 参数名 说明 是否必填 dataType 返回的数据格式 否（0表示XML，1表示JSON；默认为XML） userAccount 用户名（“一品一码”食品安全信息追溯管理平台登录账号） 是 password 密码（登录账号对应的密码） 是 (3) 返回说明 验证成功返回成功标识及身份校验码；错误则返回错误标识及错误信息。 5.2 接口调用说明 平台提供接口用于生产经营主体数据写入，接口定义如下说明。 5.2.1 数据接入接口定义 (1) 原型接口 public String writeObjectOut (String verifyCode, String jkId, String dataType, String writeXmlDoc，String[] fileNames,byte[][] fileContents); (2) 参数说明 序号 参数名 说明 是否必填 备注 1 verifyCode 身份校验码 是 2 jkId 接口ID 是 各接口所对应的ID编号，详见各接口说明 3 dataType 返回的数据格式 否 返回的数据类型，0表示XML，1表示JSON；默认为XML 4 writeXmlDoc 写入数据 是 业务数据写入XML格式文档，附件数据通过以下附件字段进行上传。 5 fileNames 附件名称数组 否 附件名+类型，如2012012.xls 6 fileContents 附件数据数组 否 附件内容，byte字节 (3) WriteXmlDoc参数示例 <?xml version="1.0" encoding="utf-8"?> <root> <!—ylghsxx 为节点名称，具体节点名称由各接口定义，节点名称详见各接口说明--> <ylghsxx> <!—参数需要通过