《福建省“一品一码”食品安全信息追溯管理平台-批发市场数据交换共享服务标准.doc》由会员分享,可在线阅读,更多相关《福建省“一品一码”食品安全信息追溯管理平台-批发市场数据交换共享服务标准.doc(75页珍藏版)》请在教育文库上搜索。
1、福建省“一品一码”食品安全 信息追溯管理平台项目 批发市场数据交换共享服务标准 福建省食品药品监督管理局 批发市场数据交换共享服务标准 I 文件更改摘要 日期 版本号 修订说明 修订人 审核人 批准人 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 进货单据表增加“关联销货单据” 字段;销售单据表增加“关联进货 单据号”字段;将入境货物检验检 疫证明从检验检测中独立;调整订 餐主体代码的字段长度;统一修改 登记主体代码 reg
2、EntId 为 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 增加关联销货单据字
3、段; 修改接口 22W01 节点 fcEntryFJBill 为 fcStockBill;修改错误的文字说明; 增加第 5.2.2 章节、第 7 章节数据删 除接口规范;修订第 6 章,增加数 据修改说明;修改所属行业的字段 备注 18.6.15 V 1.6 修改保质期字段备注;修改食品基 础信息,预包装食品类型,产地可 以为空;食用农产品类型,产地非 空;企业信息,证件类型、证件号 批发市场数据交换共享服务标准 II 码可以为空;检验检测信息,检测 报告编号可以为空;产地证明,产 地证明编号可以为空;增加第 5.2.3 章节、第 8 章节,查询接口 18.6.19 V 1.7 检验检测报告新
4、增检测有效期至字 段;修改订餐主体信息中的订餐 人姓名、订餐人联系方式、地 址的字段名称 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 章节 批发市场数据交换共享服务标准 I 目 录 1. 范围 1 2. 规范性引用文件 1 3. 术语和定义 1 4. 缩略语
5、 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 餐饮服务者 .
6、34 6.3.1 基础数据 .34 6.3.2 台账数据 .39 6.3.3 上市凭证 .43 批发市场数据交换共享服务标准 II 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 生产经营主体信息
7、查询 .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 批发市场数据交换共享服务标准 第 1 页,共 69 页 1.范围 本标准规定了福建省“一品一码”食品安全信息追溯管理平台(以下简称 “一品一码”追溯管理平台)与省内批发市场自建追溯系统数据交换的技术架构、 接口规范、交换过程、数据交换规范等。 本标准适用于省内批发市场与“一品
8、一码”追溯管理平台数据共享与数据交 换服务。 2.规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条段凡是注日期的引 用文件。其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准。 然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡 是不注日期的引用文件,其最新版本适用于本标准。 GB/T 7408-2005 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18391.1-2002 信息技术 数据元的规范与标准 第一部分:数据元的规 范与标准化框架 GB/T 21062.1-2007 政务信息资源交换体系 第1部分:总体框架 GB/T 210
9、62.2-2007 政务信息资源交换体系 第2部分:技术要求 GB/T 20162.2-2007 政务信息资源交换体系 第3部分:数据接口规范 3.术语和定义 下列术语和定义适用于本标准。 (1) 福建省“一品一码”食品安全信息追溯管理平台 福建省建立统一的福建省食品安全信息追溯管理平台,汇集相关行政主管部 门追溯系统信息,通过编码识别、身份信息比对等技术手段和验证管理实现追溯 食品和生产经营者等信息的共享。 (2) 一品一码 批发市场数据交换共享服务标准 第 2 页,共 69 页 一品一码指同一品种批次的食品和食用农产品按照规定的追溯编码规则,赋 予唯一的识别追溯码。 (3) 生产经营主体
10、从事食品生产经营活动的政府、组织、单位、法人和自然人等具备食品追溯 能力的单位和自然人。 (4) 主体代码 法人采用统一社会信用代码,由一组长度为18位的用于法人和其他组织身份 识别的代码。统一社会信用代码由国家标准委发布。国家标准委发布了强制性国 家标准法人和其他组织统一社会信用代码编码规则 。 针对自然人采用散户代码或身份证号码。 (5) 生产经营许可 生产经营许可证是许可证的一个类别之一,是县级以上食品药品监管部门对 食品生产与经营者颁发的允许进行食品生产经营的法定证件。 (6) 食用农产品 指在农业活动中直接获得的,以及经过分拣、去皮、剥壳、干燥、粉碎、清 洗、切割、冷冻、打蜡、分级、
11、包装等加工,但未改变其基本自然性状和化学性 质的、供人食用的植物、动物、微生物及其产品。 (7) 预包装食品 指预先定量包装或者制作在包装材料和容器中的食品;包括预先定量包装以 及预先定量制作在包装材质和容器中并且在一定量限范围内具有统一的质量或体 积标识的食品。简单说,就是指在包装完成后即具有确定的量值,这一确定的量 值应是在一定量限范围内具有统一的质量或体积标识。 (8) 入境食品 指从其他国家和地区进口的食品。 (9) 入闽食品 指中国国内,福建省外的食品,通俗的讲就是其他省份和地区食品,包含在 其他省份和地区生产并在福建省内分包装的食品。 (10) 食品代码 批发市场数据交换共享服务标
12、准 第 3 页,共 69 页 预包装食品的代码,由企业向中国物品编码中心申请,进行自主食品编码, 并在中国物品编码中心备案;散装食品的代码,由各厅局负责源头赋码。 (11) 食品追溯码 指福建省质量技术监督局研究出台的福建省地方标准食品质量安全追溯码 编码技术规范 (DB35/T 1711-2017)规定的食品追溯码。 (12) 数据提供方 福建省“一品一码”食品安全信息追溯管理平台。 (13) 用户 与福建省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的全 省生产经营主体自建追溯管理平台。 (14) 数据项 共享数据实体。 (15) 数据集 组成共享数据实体的集合。 (16) 数据
13、版本号 共享数据在更新序列上的唯一标识。 4.缩略语 XML - 可扩展标识语言(eXtensible Markup Language) SOAP - 简单对象访问协议(Simple Object Access Protocol ) UDDI - 统一描述、发现和集成( Universal Description,Discovery , and Integration) 5.接口调用规范 5.1身份验证接口 通过“一品一码”食品安全信息追溯管理平台调用各类接口时,必须先对调 用方的用户身份及权限进行验证,本接口负责用户身份认证和权限验证功能。应 用程序调用本接口进行身份认证和权限验证,通过后将
14、获取身份校验码,用户通 批发市场数据交换共享服务标准 第 4 页,共 69 页 过该身份校验码才能访问其他接口。校验码的有效时间为 30 分钟。 (1) 原型接口 public String getVerifyCode(String userAccount, String password,String dataType) (2) 参数说明 参数名 说明 是否必填 dataType 返回的数据格式 否(0 表示 XML,1 表示JSON;默认为 XML) userAccount 用户名(“一品一码”食品安全信息追溯管理平台登录账号) 是 password 密码(登录账号对应的密码) 是 (3)
15、 返回说明 验证成功返回成功标识及身份校验码;错误则返回错误标识及错误信息。 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 是 各
16、接口所对应的 ID 编号,详见各接口说明 3 dataType 返回的数据格式 否 返回的数据类型,0 表示 XML,1表示 JSON;默认为 XML 4 writeXmlDoc 写入数据 是 业务数据写入 XML 格式文档,附件数据通过以下附件字段进行上传。 5 fileNames 附件名称数组 否 附件名+类型,如 2012012.xls 6 fileContents 附件数据数组 否 附件内容,byte 字节 (3) WriteXmlDoc 参数示例 批发市场数据交换共享服务标准 第 5 页,共 69 页 URLEncoder.encode(“主体名称“, “UTF-8“) URLEnc
17、oder.encode(“主体代码“, “UTF-8“) . URLEncoder.encode(“追溯码“, “UTF-8“) . . 5.2.2数据删除接口定义 (1) 原型接口 public String deleteObjectOut (String verifyCode, String jkId, String dataType, String deleteXmlDoc); (2) 参数说明 序号 参数名 说明 是否必填 备注 1 verifyCode 身份校验码 是 2 jkId 接口 ID 是 各接口所对应的 ID 编号,详见各接口说明 3 dataType 返回的数据格式 否
18、返回的数据类型,0 表示 XML,1表示 JSON;默认为 XML 4 deleteXmlDoc 写入数据 是 业务数据写入 XML 格式文档,附件数据通过以下附件字段进行上传。 (3) DeleteXmlDoc 参数示例 URLEncoder.encode(“主体代码“, “UTF-8“) . 批发市场数据交换共享服务标准 第 6 页,共 69 页 5.2.3数据查询接口定义 (1) 原型接口 public String queryObjectOut (String verifyCode, String jkId, String dataType, String queryXmlDoc);
19、(2) 参数说明 序号 参数名 说明 是否必填 备注 1 verifyCode 身份校验码 是 2 jkId 接口 ID 是 各接口所对应的 ID 编号,详见各接口说明 3 dataType 返回的数据格式 否 返回的数据类型,0 表示 XML,1表示 JSON;默认为 XML 4 queryXmlDoc 写入数据 是 查询字段写入 XML 格式文档。 (3) QueryXmlDoc 参数示例 URLEncoder.encode(“主体名称“, “UTF-8“) URLEncoder.encode(“主体代码“, “UTF-8“) . 5.3返回数据格式 接口支持 JSON/XML 两种返回数
20、据格式,需要在请求参数中进行指定。 5.3.1XML格式 批发市场数据交换共享服务标准 第 7 页,共 69 页 5.3.2JSON格式 “head“: “flag“: “标识码“, “msg“: “描述信息 “ 5.3.3标识码定义 编码 编码说明 -2 业务异常 -1 系统异常 00 操作成功 01 逻辑业务出错 02 参数信息不能为空! 07 账号或密码错误! 10 xml 格式解析异常 14 身份认证码超时 批发市场数据交换共享服务标准 第 8 页,共 69 页 6.数据写入更新标准规范 6.1生产型主体 6.1.1基础数据 6.1.1.1 原料供货商信息 (1) 接口 ID :11W
21、01 (2) 节点名称:entInfo (3) 接口说明:用于写入、更新生产主体的原料供货商数据。同一主键数据, 重复上传,将更新该记录数据,只允许更新自己上传的数据。 (4) 写入参数: 序号 中文名称 英文名称 长度 备注 1 原料供货商类型 entType 1 非空。CA001 2 原料供货商名称 entName 300 非空 3 原料供货商代码 entUnicode 18 4 食品经营许可证号/餐饮许可证号 orgNo 32 “生产经营类别” 为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须 有一个不为空。 企事业单位的主体代码采用统 一社会信用代码,自然人采用 散
22、户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 (旧证) 5 经营场所 busiPlace 300 原料供货商类型为企事业单位、自然人时,非空 6 经营范围 busiScope 4000 7 经营起始时间 busiStartDate 14 格式 yyyyMMdd 8 经营终止时间 busiEndDate 14 格式 yyyyMMdd 9 生产经营类别 entCategory 1 原料供货商类型为企事业单位、自然人时,非空。CA002 批发市场数据交换共享服务标准 第 9 页,共 69 页 序号 中文名称 英文名称 长度 备注 10 所属行业 industry 128
23、 原料供货商类型为企事业单位、 自然人时,非空。多个所属行 业用逗号隔开。CA003 11 证照图片 licPic 以附件方式上传,文件大小不超过 5M。 12 法定代表人 legal 64 原料供货商类型为企事业单位时,非空 13 证件类型 legalLicType 2 14 证件号码 legalLicNo 18 15 负责人姓名 principalName 64 原料供货商类型为企事业单位、境外企业时,非空 16 负责人手机 principalMobile 32 17 负责人固定电话 principalTel 32 18 负责人传真号码 principalFax 32 19 负责人证件号码
24、 principalLicNo 18 20 负责人邮箱 principalEmail 64 21 所属国家 nation 8 非空。GB/T 2659 22 所属省行政区划 provinceAdminDivision 8 原料供货商类型为企事业单位、自然人时,非空。GB T2260 23 所属市行政区划 cityAdminDivision 8 原料供货商类型为企事业单位、自然人时,非空。GB T2260 24 所属区县行政区划 areaAdminDivision 8 原料供货商类型为企事业单位、自然人时,非空。GB T2260 25 所属市场 ID belongMarket 32 主体所属批发
- 温馨提示:
新时代文库作为内容存储提供商,无法对所有上传者文档的真实性、完整性、准确性以及专业性等问题提供审核及保证,请慎重购买!
- 特别说明:
部分文档作品中含有的素材、图片等,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 资源网址:
- https://www.xsdwk.com/p-3525.html 关键词: 福建省 一品一码 食品安全 信息 追溯 管理 平台 批发市场 数据 交换 共享 服务 标准