DB32_T 3408-2018 食品安全电子追溯生产企业数据上报接口规范.pdf
《DB32_T 3408-2018 食品安全电子追溯生产企业数据上报接口规范.pdf》由会员分享,可在线阅读,更多相关《DB32_T 3408-2018 食品安全电子追溯生产企业数据上报接口规范.pdf(24页珍藏版)》请在咨信网上搜索。
1、ICS 67.040 X 00 备案号:60244-2018 DB32 江苏省地方标准 DB 32/T 34082018 食品安全电子追溯生产企业数据上报 接口规范 Interface specifications of production enterprise data reporting for food safety electronic traceability 2018-06-25 发布 2018-07-10 实施 江苏省质量技术监督局 发 布 目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 功能要求.2 5.1 网元交互.2 6
2、接口.3 6.1 接口协议.3 6.2 安全性设置.3 6.3 基本数据类型.3 6.4 接口定义.3 6.5 报文格式定义与编写方法.4 6.6 接口约束.4 6.7 接口分类.4 7 数据上传接口.5 7.1 企业基本信息上传接口.5 7.2 原料进厂信息上传接口.5 7.3 原料自检信息上传接口.7 7.4 原料自检明细信息.7 7.5 投入产出信息上传接口.8 7.6 投放明细信息.8 7.7 出厂检验信息上传接口.9 7.8 出厂检验明细信息.9 7.9 出厂销售信息上传接口.10 7.10 批次、单品对应信息上传接口.10 7.11 不合格产品处理信息上传接口.11 7.12 产品
3、召回事件信息上传接口.11 7.13 产品召回跟踪信息上传接口.11 附录 A(规范性附录)上传数据错误码列表.13 附录 B(规范性附录)编码表.14 附录 C(资料性附录)XML 报文示例.15 前 言 本标准按照GB/T 1.1-2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位:江苏省食品药品监督信息中心、江苏省质量和标准化研究院、南京农业大学、苏果超市有限公司、江苏雨润集团有限公司、南京卫岗乳业有限公司、江苏今世缘酒业股份有限公司、江苏洋河酒厂股份有限公司、江苏瑞德信息产业有限公司、江苏稻源微电子有限公司。本标准主要起草人:曹云、李睿、杨博、陆诚、章学
4、周、胡冶、崔兆明、王瑜、关春、刘小康、上官金标、陆会会。食品安全电子追溯生产企业数据上报接口规范 1 范围 本标准规定了食品安全电子追溯生产企业数据上报接口的功能要求和上传信息。本标准适用于食品安全电子追溯生产企业数据上报接口的开发和应用。2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 7635.1-2002 全国主要产品分类与代码 第1部分:可运输产品 GB 12904 商品条码 零售商品编码与条码表示 GB/T 16830 商品条码 储运包装商品编码与条
5、码表示 CFDAB/T 0401-2014 食品药品监管数据共享与交换接口规范 DB32/T XXXX-2018 食品安全电子追溯标识解析服务数据接口规范 3 术语和定义 下列术语和定义适用于本文件。3.1 网元 network element 由软硬件共同组成的能实现网络中的一定的逻辑功能的逻辑单元。3.2 CU 网元 capture unit network element 负责采集主数据、交易数据和事件数据并提交到IQS网元,完成数据采集功能的网元。3.3 IQS 网元 information query service network element 提供可视化追溯信息查询服务的网元。
6、3.4 SP 网元 Supervisor Platform Network Element 接收IQS网元上报的追溯数据,支撑政府监管人员利用追溯数据开展对企业监管的网元。4 缩略语 下列缩略语适用于本文件。HTTPS:安全超文本传输协议(Hyper Text Transfer Protocol over Secure Socket Layer)IQS:信息查询服务(Information Query Service)MD5:消息摘要算法第五版(Message-Digest Algorithm 5)SOAP:简单对象访问协议(Simple Object Access Protocal)WSDL
7、:Web服务定义语言(Web Services Description Language)XML:可扩展标记语言(Extensible Markup Language)5 功能要求 5.1 网元交互 5.1.1 总则 食品安全电子追溯系统应由企业平台、监管平台、查询平台组成。食品安全电子追溯系统的系统架构见DB32/T XXXX。生产企业使用CU网元将采集到的数据上传至IQS网元,由IQS网元向SP网元进行数据上报。本标准仅规范由企业平台IQS网元上传至监管平台SP网元的数据上报接口,生产企业数据上报系统架构见图1。SP网元IQS网元CU网元IQS网元CU网元IQS网元CU网元监管平台A企业平
8、台B企业平台C企业平台IQS数据传输接口IQS数据传输接口IQS数据传输接口数据上报接口数据上报接口数据上报接口 图1 生产企业数据上报系统架构 5.1.2 网元要求 5.1.2.1 CU网元应通过条码识读设备和RFID读写器等数据采集设备采集一维码、二维码、RFID标签等信息的功能。5.1.2.2 IQS 网元应提供追溯信息捕获、查询服务和数据上报服务的功能。5.1.2.3 SP 网元应部署在监管部门的服务器系统上,SP 网元应实现支撑利用追溯数据开展对企业的监管功能。6 接口 6.1 接口协议 接口采用Web service方式。数据上报接口协议栈涉及到服务传输层、服务消息层和服务描述层,
9、服务传输层使用HTTPS协议,以提高数据传输的安全性。服务消息层协议为SOAP,服务描述层描述语言为WSDL。6.2 安全性设置 客户端和服务器端通信采用数字证书认证,数据传输通过MD5来验证完整性,见CFDAB/T 0401-2014。数字证书由食品安全电子追溯系统监管平台服务器端经审核后在线发放或发放硬件装载的数字证书。6.3 基本数据类型 食品生产企业电子追溯系统提供的数据上报共享接口所使用到的基本数据类型定义见表1。表1 基本数据类型 类型名 类型描述 类型说明 string 文本字符串 内容为所有的有效字符 date 日期类型 固定格式字符串,格式为 YYYY-MM-DD int 数
10、字类型 内容由从 0-9 的数字字符,和+-字符组成 6.4 接口定义 Web service 名称:ProductTraceService,上传数据方法名称:int uploadData(String dataType,String dataXml,String dataMD5),输入参数见表 2。表2 输入参数 参数名称 类型 是否必填 参数说明 dataType string 是 数据类型 dataXml string 是 上传数据的 XML 数据 dataMD5 string 是 dataXml 数据的 MD5 码 数据上传完毕,服务器端响应参数见表 3。表3 响应参数 响应参数 类型
11、 参数说明 status int 返回值,用于表示状态:若返回值为 1,表示上传数据成功、若返回值为 0,表示上传的 XML 与上传数据中 dataXml 的 MD5 码不匹配 响应参数 类型 参数说明 errorCode int 上传失败的返回值:为 uploadData 函数调用返回的错误码 错误信息获得方法名称:String getUploadError(int errorCode)输入值为 errorCode,是数据上传完毕后服务器端的响应参数的返回值,见表 3。返回值为上传数据错误详细信息,见附录 A。6.5 报文格式定义与编写方法 报文编写格式为:value value value
12、 value 其中各字段对应填写内容见表4,XML报文编写示例参见附录C,编码格式为UTF-8。注:原料自检明细信息、投放明细信息、出厂检验明细信息分别通过原料自检信息上传接口(参见附录C.1.3)、投入产出信息上传接口上传(参见附录C.1.4)和出厂检验信息上传接口(参见附录C.1.5)。表4 字段填写内容 字段名 对应填写内容 entity 见表 5 中上传接口名称 property 见 7 章各上传接口信息表中的参数名称 value 对应参数名称填写的信息 6.6 接口约束 使用增量上传方式,仅对新增和修改的数据上传。6.7 接口分类 接口分类见表5。表5 接口分类 对应本标准章节号 上
13、传接口名称 接口说明 7.1 registerBean 企业基本信息上传接口 7.2 materialFactoryBean 原料进厂信息上传接口 7.3 materialSelfCheckBean 原料自检信息上传接口 7.4 materialSelfCheckDetailsBean 原料自检明细信息 7.5 inputOutPutBean 投入产出信息上传接口 7.6 inputOutPutDetailsBean 投放明细信息 7.7 outFactoryCheckBean 出厂检验信息上传接口 7.8 outFactoryCheckDetailsBean 出厂检验明细信息 7.9 out
14、FactorySaleBean 出厂销售信息上传接口 7.10 batchItemBean 批次、单品信息上传接口 7.11 unQualifiedProductsProcessBean 不合格产品处理信息上传接口 7.12 productRecallEventBean 产品召回事件信息上传接口 7.13 productRecallTrackBean 产品召回跟踪信息上传接口 7 数据上传接口 7.1 企业基本信息上传接口 通过企业基本信息上传接口上传的信息见表6。表6 企业基本信息上传接口信息 参数名称 类型 长度 Byte 是否必填 描述 orgCode string 30 是 统一社会信
15、用代码 orgName string 127 是 企业名称 foodProductId string 150 否 食品生产许可证编号,如多个编号,各编号间使用“/”分隔,输入完毕以“.”作结束符 foodAdditivesId string 150 否 食品添加剂许可证编号,如多个编号,各编号间使用“/”分隔,输入完毕以“.”作结束符 uploadDate date 20 否 上传日期 7.2 原料进厂信息上传接口 通过原料进厂信息上传接口上传的信息见表7。表7 原料进厂信息上传接口信息 参数名称 类型 长度 Byte 是否必填 描述 materialBatchid string 20 是 原
16、料进货批次码,此字段为企业上传的原料进厂数据的唯一标识位 materialTypeCode string 6 是 原料产品分类编码,编码内容见附录 B 表 B.1 materialCode string 14 是 原料编码,编码内容见 GB/T 7635.1-2002 materialProductbatchid string 20 否 原料生产企业的生产批次码 materialName string 50 否 进货原料名 materialStyle string 50 否 规格型号 purchaseCount int 10 是 进货数量 countInit string 10 是 进货数量单
17、位 productionDate date 20 是 原料生产日期 shelfLife int 10 是 保质期 shelfUnit string 10 是 保质期单位,“小时”、“天”、“月”等 carNumber string 12 否 运输车辆牌照 certificateType string 6 否 合格证明类型,编码内容见附录 B 表 B.2 certificateCode string 32 否 合格证明编号 slefCheckId string 6 否 自行检验编码,编码内容见附录 B 表 B.3 slefCheckStd string 20 否 自行检验执行标准 wareHou
18、seCode string 20 是 存储仓(库、罐)编号,此字段可以存放存储仓(库、罐)编号或某库罐内某批次原料的进货批次码 wareHouseName string 20 是 存储仓(库、罐)名称 表 7 原料进厂信息上传接口信息(续)参数名称 类型 长度 Byte 是否必填 描述 producerCode string 30 是 原料生产商统一社会信用代码 supplierCode string 30 是 原料供应商统一社会信用代码 supplierCertName string 50 否 供应商资质证明名称 supplierCertCode string 20 否 供应商资质证明编号
19、purchaser string 20 否 企业采购者 checkConclusion string 6 是 检验结论,编码内容见附录 B表 B.4 accepter string 20 是 验收人 createTime date 20 是 进厂时间 7.3 原料自检信息上传接口 通过原料自检信息上传接口上传的信息见表8。表8 原料自检信息上传接口信息 参数名称 类型 长度 Byte 是否必填 描述 tid string 40 是 原料自检序列号,此字段为企业上传的原料自检数据的唯一标识位 materialBatchid string 20 是 原料进货批次码,对应表 7 原料进货批次码 ma
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB32_T 3408-2018 食品安全电子追溯生产企业数据上报接口规范 3408 2018 食品安全 电子 追溯 生产 企业 数据 上报 接口 规范
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。