食品安全电子追溯生产企业数据上报接口规范

1食品安全电子追溯生产企业数据上报接口规范本标准规定了食品安全电子追溯生产企业数据上报接口的功能要求和上传信息。本标准适用于食品安全电子追溯生产企业数据上报接口的开发和应用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7635.1-2002全国主要产品分类与代码第1部分：可运输产品GB12904商品条码零售商品编码与条码表示GB/T16830商品条码储运包装商品编码与条码表示CFDAB/T0401-2014食品药品监管数据共享与交换接口规范DB32/TXXXX-2018食品安全电子追溯标识解析服务数据接口规范3术语和定义下列术语和定义适用于本文件。3.1网元networkelement由软硬件共同组成的能实现网络中的一定的逻辑功能的逻辑单元。3.2CU网元captureunitnetworkelement负责采集主数据、交易数据和事件数据并提交到IQS网元，完成数据采集功能的网元。3.3IQS网元informationqueryservicenetworkelement提供可视化追溯信息查询服务的网元。3.4SP网元SupervisorPlatformNetworkElement接收IQS网元上报的追溯数据，支撑政府监管人员利用追溯数据开展对企业监管的网元。4缩略语2下列缩略语适用于本文件。HTTPS：安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer）IQS：信息查询服务（InformationQueryService）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）SOAP：简单对象访问协议（SimpleObjectAccessProtocal）WSDL：Web服务定义语言（WebServicesDescriptionLanguage）XML：可扩展标记语言（ExtensibleMarkupLanguage）5功能要求5.1网元交互5.1.1总则食品安全电子追溯系统应由企业平台、监管平台、查询平台组成。食品安全电子追溯系统的系统架构见DB32/TXXXX。生产企业使用CU网元将采集到的数据上传至IQS网元，由IQS网元向SP网元进行数据上报。本标准仅规范由企业平台IQS网元上传至监管平台SP网元的数据上报接口，生产企业数据上报系统架构见图1。图1生产企业数据上报系统架构5.1.2网元要求CU网元应通过条码识读设备和RFID读写器等数据采集设备采集一维码、二维码、RFID标签等信息的功能。IQS网元应提供追溯信息捕获、查询服务和数据上报服务的功能。SP网元应部署在监管部门的服务器系统上，SP网元应实现支撑利用追溯数据开展对企业的监管功能。6接口36.1接口协议接口采用Webservice方式。数据上报接口协议栈涉及到服务传输层、服务消息层和服务描述层，服务传输层使用HTTPS协议，以提高数据传输的安全性。服务消息层协议为SOAP，服务描述层描述语言为WSDL。6.2安全性设置客户端和服务器端通信采用数字证书认证，数据传输通过MD5来验证完整性，见CFDAB/T0401-2014。数字证书由食品安全电子追溯系统监管平台服务器端经审核后在线发放或发放硬件装载的数字证书。6.3基本数据类型食品生产企业电子追溯系统提供的数据上报共享接口所使用到的基本数据类型定义见表1。表1基本数据类型6.4接口定义Webservice名称：ProductTraceService，上传数据方法名称：intuploadData（StringdataType,StringdataXml,StringdataMD5输入参数见表2。表2输入参数是是是数据上传完毕，服务器端响应参数见表3。表3响应参数表3响应参数（续）4错误信息获得方法名称：StringgetUploadError（interrorCode）输入值为errorCode，是数据上传完毕后服务器端的响应参数的返回值，见表3。返回值为上传数据错误详细信息，见附录A。6.5报文格式定义与编写方法报文编写格式为：<?xmlversion="1.0"encoding="UTF-8"?><entitysxmlns:xsi="/2001/XMLSchema-instance"xmlns:xsd="/2001/XMLSchema"Version="3.0"><entity><property>value</property><property>value</property></entity><entity><property>value</property><property>value</property></entity></entitys>其中各字段对应填写内容见表4，XML报文编写示例参见附录C，编码格式为UTF-8。注：原料自检明细信息、投放明细信息、出厂检验明细信息分别通过原料自检信息上传接口（参见附录C.1.3）、投入产出信息上传接口上传（参见附录C.1.4）和出厂检验信息上传接口表4字段填写内容6.6接口约束使用增量上传方式，仅对新增和修改的数据上传。6.7接口分类接口分类见表5。5表5接口分类materialSelfCheckDetailsBunQualifiedProductsProces7数据上传接口7.1企业基本信息上传接口通过企业基本信息上传接口上传的信息见表6。表6企业基本信息上传接口信息是是否符否个编号，各编号间使用“/”否7.2原料进厂信息上传接口通过原料进厂信息上传接口上传的信息见表7。6表7原料进厂信息上传接口信息是6是是materialProductbatc否否否是是是是是否6否否6否否wareHouseCode是wareHouseName是7表7原料进厂信息上传接口信息（续）是码是码否否否6是是是7.3原料自检信息上传接口通过原料自检信息上传接口上传的信息见表8。表8原料自检信息上传接口信息是是是是6是是是否是7.4原料自检明细信息原料自检明细信息见表9。8表9自检明细信息是是是否否否7.5投入产出信息上传接口通过投入产出信息上传接口上传的信息见表10。表10投入产出信息上传接口信息是是是是是否否是是是workshopNumber否否否生产线（班组）号productionLineHeadP否是7.6投放明细信息投放明细信息见表11。9表11投放明细信息是是6是是是是否wareHouseName否否否否7.7出厂检验信息上传接口通过出厂检验信息上传接口上传的信息见表12。表12出厂检验信息上传接口信息是是是是否6是是是是否是7.8出厂检验明细信息出厂检验明细信息见表13。表13出厂检验明细信息是是是否否否7.9出厂销售信息上传接口通过出厂销售信息上传接口上传的信息见表14。表14出厂销售信息上传接口信息是是是是是是否否否否7.10批次、单品对应信息上传接口通过批次、单品对应信息上传接口上传的信息见表15。表15批次、单品对应信息上传接口信息是是表15批次、单品对应信息上传接口信息（续）是是是7.11不合格产品处理信息上传接口通过不合格产品处理信息上传接口上传的信息见表16。表16不合格产品处理信息上传接口信息是是是是否否是是是7.12产品召回事件信息上传接口通过产品召回事件信息上传接口上传的信息见表17。表17产品召回事件信息上传接口信息是是是是是表17产品召回事件信息上传接口信息（续）否否是是7.13产品召回跟踪信息上传接口通过产品召回跟踪信息上传接口上传的信息见表18。表18产品召回跟踪信息上传接口信息是是是是是是否否否是否（规范性附录）上传数据错误码列表表A.1上传数据错误码列表（规范性附录）编码表表B.1原料产品分类编码123表B.2检验情况编码123表B.3自行检验情况编码123表B.4结论编码123（资料性附录）XML报文示例C.1.1企业基本信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><registerBean><orgCode>530112111</orgCode><orgName>江苏XX食品公司</orgName><foodProductId>10000012</foodProductId><foodAdditivesId>10000012</foodAdditivesId></registerBean>C.1.2原料进厂信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><materialFactoryBean><orgCode>530101000</orgCode><materialBatchid>530101000444454</materialBatchid><materialTypeCode>004</materialTypeCode><materialCode>001</materialCode><materialProductbatchid>530101000444454</materialProductbatchid><materialName>添加剂</materialName><materialStyle>H-33</materialStyle><purchaseCount>100</purchaseCount><countUnit>千克</purchaseUnit><productionDate>2013-06-0606:12:55</productionDate><shelfLife>3</shelfLife><shelfUnit>年</shelfUnit><carNumber>辽B51212</carNumber><driverName>张三</driverName><certificateType>地方</certificateType><certificateCode>0124500</certificateCode><slefCheckId></slefCheckId><slefCheckStd>XX</slefCheckStd><wareHouseCode>0121202</wareHouseCode><wareHouseName>XXX</wareHouseName><producerCode></producerCode><producerName></producerCode><supplierCode>123212</supplierCode><supplierName>张三</supplierName><supplierAddress>江苏XX</supplierAddress><supplierCertName>李四</supplierCertName><supplierCertCode>12111</supplierCertCode><contacter>张三</contacter><contacterTel>lt;/contacterTel><contacerPhone>lt;/contacerPhone><purchaser>李四</purchaser><checkConclusion>合格</checkConclusion><accepter>李辉</accepter><createTime>2013-06-0606:12:55</createTime></materialFactoryBean>C.1.3原料自检信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><materialSelfCheckBean><orgCode>530123456</orgCode><materialBatchid>530123456112121</materialBatchid><materialCode></materialCode><reportCode>530123456</reportCode><checkConclusion>不合格</checkConclusion><checkerName>张三</checkerName><headPerson>李四</headPerson><checkDate>2014-6-711:11:55</checkDate><uploadDate>2014-06-0711:11:15</uploadDate><checkDetails><materialSelfCheckDetailsBean><checkItemCode>213122</checkItemCode><checkItemName>超标量检测</checkItemName><checkUnit>mg</checkUnit><measuredValue>0.001</measuredValue><standardValue>0.002</standardValue><checkConclusion>合格</checkConclusion><checkerName>张三</checkerName><checkDate>2014-06-0711:11:15</checkDate><headPerson>李四</headPerson><uploadDate>2014-06-0711:11:15</uploadDate></materialSelfCheckDetailsBean></checkDetails></materialSelfCheckBean>C.1.4投入产出信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><inputOutPutBean><orgCode></orgCode><batchId>530123111221212</batchId><ingredientsCode>00021</ingredientsCode><goodsCode>01111</goodsCode><productName>XXX月饼</productName><productNumber>HT-22</productNumber><productLicenseNumber>000000011100</productLicenseNumber><productCount>200</productCount><productUnit>千克</productUnit><createDate>2013-12-1112:22:22</createDate><shelfLife>3</shelfLife><shelfUnit>年</shelfUnit><workshopNumber>13</workshopNumber><headPerson>张三</headPerson><productionLineNo>1311</productionLineNo><productionLineHeadPerson>李四</productionLineHeadPerson><uploadDate>2014-06-0711:11:15</uploadDate><inputOutputItmes><inputOutPutDetailsBean><batchId>10001</batchId><goodsCode>01111</goodsCode><commoditiesCode>0004</commoditiesCode><materialCode>123</materialCode><materialBatchid></materialBatchid><materialManagerName>李四</materialManagerName><receivePerson>张三</receivePerson><wareHouseName>仓库002</wareHouseName><receiveDate>2014-06-0711:11:15</receiveDate><materialCount>200</materialCount><materialUnit>kg</materialUnit><uploadDate>2014-06-0711:11:15</uploadDate></inputOutPutDetailsBean></inputOutputItmes></inputOutPutBean>C.1.5出厂检验信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><outFactoryCheckBean><orgCode>530112113</orgCode><batchId>530112113456444</batchId><goodsCode></goodsCode><reportCode>0004</reportCode><certificateCode>000121440000</certificateCode><checkConclusion>合格</checkConclusion><checkDate>2014-06-0710:44:12</checkDate><checkerName>张三</checkerName><headPerson>李四</headPerson><selfCheckStd>HT</selfCheckStd><uploadDate>2014-06-0711:11:15</uploadDate><outfactoryItmes><outFactoryCheckDetailsBean><checkItmeCode>1120112</checkItmeCode><checkItmeName>指标超标</checkItmeName><measuredValue>0.5</measuredValue><standardValue>0.2</standardValue><checkUnit>mg</checkUnit><checkConclusion>不合格</checkConclusion><checkDate>2014-06-0711:11:15</checkDate><checkerName>张三</checkerName><headPerson>李四</headPerson><selfCheckStd>HT-002</selfCheckStd><uploadDate>2014-06-0711:11:15</uploadDate></outFactoryCheckDetailsBean></outfactoryItmes></outFactoryCheckBean>C.1.6出厂销售信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><outFactorySaleBean><orgCode>530123444</orgCode><batchId>530123444123454</batchId><goodsCode></goodsCode><saleDate>2014-06-0711:11:15</saleDate><productName>XX食品</productName><materialStyle></materialStyle><saleCount>1000</saleCount><saleCountUnit>千克</saleCountUnit><reportCode>00012</reportCode><certificateCode>002121200</certificateCode><dealerCode>012120</dealerCode><dealerName>张三</dealerName><dealerHomeAddress>江苏XXXXXXX</dealerHomeAddress><dealerCertName>地税证明XXX</dealerCertName><dealerCertCode>1237521000</dealerCertCode><dealerContacter>李四</dealerContacter><dealerTel>lt;/dealerTel><dealerPhome>lt;/dealerPhome><salerAddr>江苏XXXXXXX</salerAddr><carrier>王五</carrier></outFactorySaleBean>C.1.7批次、单品产成品对应表<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><batchItemBean><orgCode>530123444</orgCode><goodsCode></goodsCode><batchId>530123444123454</batchId><packageId>/<packageId><productionId></productionId></batchItemBean>C.1.8不合格产品处理信息上传<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><unQualifiedProductsProcessBean><orgCode>530112111</orgCode><goodsCode>5301121111411</goodsCode><batchId></batchId><problemReason></problemReason><processConclusion></processConclusion><processCount></processCount><processUnit></processUnit><processDate>2014-06-0711:11:15</processDate><processPerson>张三</processPerson><supervision>李四</supervision></unQualifiedP