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

ICS67.040X00备案号：江DB32苏省地方标准DBT3408—2018Interfacespecificationsofproductionenterprisedatareportingforfoodsafetyictraceability江苏省质量技术监督局发布IDB32/T3408—2018前言 品处理信息上传接口 11口 11口 11附录A(规范性附录)上传数据错误码列表 13 DB32/T3408—2018前言本标准按照GB/T1.1-2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位：江苏省食品药品监督信息中心、江苏省质量和标准化研究院、南京农业大学、苏果超市有限公司、江苏雨润集团有限公司、南京卫岗乳业有限公司、江苏今世缘酒业股份有限公司、江苏洋河酒厂股份有限公司、江苏瑞德信息产业有限公司、江苏稻源微电子有限公司。本标准主要起草人：曹云、李睿、杨博、陆诚、章学周、胡冶、崔兆明、王瑜、关春、刘小康、上官金标、陆会会。1DB32/T3408—2018食品安全电子追溯生产企业数据上报接口规范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缩略语2DB32/T3408—2018下列缩略语适用于本文件。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接口3DB32/T3408—20186.1接口协议接口采用Webservice方式。数据上报接口协议栈涉及到服务传输层、服务消息层和服务描述层，服务传输层使用HTTPS协议，以提高数据传输的安全性。服务消息层协议为SOAP，服务描述层描述语言为WSDL。6.2安全性设置客户端和服务器端通信采用数字证书认证，数据传输通过MD5来验证完整性，见CFDAB/T0401-2014。数字证书由食品安全电子追溯系统监管平台服务器端经审核后在线发放或发放硬件装载的数字证书。6.3基本数据类型食品生产企业电子追溯系统提供的数据上报共享接口所使用到的基本数据类型定义见表1。表1基本数据类型类型名类型描述类型说明string文本字符串内容为所有的有效字符date日期类型固定格式字符串，格式为YYYY-MM-DD数字类型内容由从0-9的数字字符，和+-字符组成6.4接口定义Webservice名称：ProductTraceService，上传数据方法名称：intuploadData(StringdataType,StringdataXml,StringdataMD5)，输入参数见表2。表2输入参数参数名称类型是否必填参数说明dataTypestring是数据类型dataXmlstring是的XML数据dataMD5string是数据上传完毕，服务器端响应参数见表3。表3响应参数响应参数类型参数说明status返回值，用于表示状态：若返回值为1，表示上传数据成功、上传的XML与上传表3响应参数(续)响应参数类型参数说明4DB32/T3408—2018errorCode上传失败的返回值：为uploadData函数调用返回的错误码错误信息获得方法名称：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)和出厂检验信息上传接口(参见附录C.1.5)。表4字段填写内容字段名对应填写内容entity见表5中上传接口名称property见7章各上传接口信息表中的参数名称value对应参数名称填写的信息6.6接口约束使用增量上传方式，仅对新增和修改的数据上传。6.7接口分类接口分类见表5。5DB32/T3408—2018表5接口分类对应本标准章节号上传接口名称接口说明7.1registerBean企业基本信息上传接口7.2materialFactoryBean原料进厂信息上传接口7.3materialSelfCheckBean原料自检信息上传接口7.4materialSelfCheckDetailsBean原料自检明细信息7.5inputOutPutBean投入产出信息上传接口7.6inputOutPutDetailsBean投放明细信息7.7outFactoryCheckBean出厂检验信息上传接口7.8outFactoryCheckDetailsBean出厂检验明细信息7.9outFactorySaleBean出厂销售信息上传接口7.10batchItemBean批次、单品信息上传接口7.11unQualifiedProductsProcessBean不合格产品处理信息上传接口7.12productRecallEventBean产品召回事件信息上传接口7.13productRecallTrackBean产品召回跟踪信息上传接口7数据上传接口7.1企业基本信息上传接口通过企业基本信息上传接口上传的信息见表6。表6企业基本信息上传接口信息参数名称类型长度Byte是否必填描述orgCodestring30是统一社会信用代码orgNamestring是企业名称foodProductIdstring否食品生产许可证编号,如多个编号，各编号间使用“/”分隔，输入完毕以“.”作结束符foodAdditivesIdstring否食品添加剂许可证编号,如多个编号，各编号间使用“/”分隔，输入完毕以“.”作结束符uploadDatedate20否上传日期7.2原料进厂信息上传接口通过原料进厂信息上传接口上传的信息见表7。6DB32/T3408—2018表7原料进厂信息上传接口信息参数名称类型长度Byte是否必填描述materialBatchidstring20是原料进货批次码，此字段为企业上传的原料进厂数据的唯一标识位materialTypeCodestring6是原料产品分类编码，编码内容materialCodestring是原料编码，编码内容见GB/T7635.1-2002materialProductbatchidstring20否原料生产企业的生产批次码materialNamestring50否进货原料名materialStylestring50否规格型号purchaseCount是进货数量countInitstring是进货数量单位productionDatedate20是原料生产日期shelfLife是保质期shelfUnitstring是“月”等carNumberstring否运输车辆牌照certificateTypestring6否合格证明类型，编码内容见附certificateCodestring32否合格证明编号slefCheckIdstring6否自行检验编码，编码内容见附slefCheckStdstring20否自行检验执行标准wareHouseCodestring20是存储仓(库、罐)编号，此字段可以存放存储仓(库、罐)编号或某库罐内某批次原料的进货批次码wareHouseNamestring20是存储仓(库、罐)名称7DB32/T3408—2018表7原料进厂信息上传接口信息(续)参数名称类型长度Byte是否必填描述producerCodestring30是原料生产商统一社会信用代码supplierCodestring30是原料供应商统一社会信用代码supplierCertNamestring50否供应商资质证明名称supplierCertCodestring20否供应商资质证明编号purchaserstring20否企业采购者checkConclusionstring6是检验结论，编码内容见附录Baccepterstring20是验收人createTimedate20是进厂时间7.3原料自检信息上传接口通过原料自检信息上传接口上传的信息见表8。表8原料自检信息上传接口信息参数名称类型长度Byte是否必填描述tidstring40是原料自检序列号，此字段为企业上传的原料自检数据的唯一标识位materialBatchidstring20是对应表7原料进货批次码materialCodestring是原料编码，编码内容见GB/T7635.1-2002reportCodestring50是检验报告编号checkResultstring6是检验结论，编码内容见附录BcheckerNamestring20是检验人headPersonstring20是负责人checkDatedate20否检验日期checkDetailsstring是原料自检明细信息，此参数为多项信息，见表97.4原料自检明细信息原料自检明细信息见表9。8DB32/T3408—2018表9自检明细信息参数名称类型长度Byte是否必填描述reportCodestring50是检验报告编号checkItemCodestring20是检验项目编码checkItemNamestring32是检验项目名称checkUnitstring20否计量单位measuredValuestring32否实测值standardValuestring32否标准值，参照食品产品对应国家标准、行业标准或企业标准7.5投入产出信息上传接口通过投入产出信息上传接口上传的信息见表10。表10投入产出信息上传接口信息参数名称类型长度Byte是否必填描述tidstring40是序号，此字段为企业上传的投入产出数据的唯一标识位batchIdstring20是生产批次码ingredientsCodestring20是投配料单编码goodsCodestring是商品条码，依据GB12904productLicenseNumberstring是成品的许可证编号productCount否生产成品数量productUnitstring否成品数量单位createDatedate20是生产日期shelfLife20是保质期shelfUnitstring是保质期单位workshopNumberstring20否生产车间号headPersonstring20否负责人productionLineNostring20否生产线(班组)号productionLineHeadPersonstring20否生产线(班组)负责人姓名inputOutputItmesstring200是投放明细信息，此参数为多项信息，见表117.6投放明细信息投放明细信息见表11。9DB32/T3408—2018表11投放明细信息参数名称类型长度Byte是否必填描述batchIdstring20是生产批次码goodsCodestring是商品条码，依据GB12904commoditiesCodestring6是原料产品分类编码，编码内容见GB/T7635.1-2002materialCodestring20是原料编码materialBatchidstring20是原料进货批次码materialManagerNamestring20是原料保管员姓名receivePersonstring30否领用人姓名，如多个姓名，各姓名间使用“/”分隔，输入完毕以“.”作结束符wareHouseNamestring20否存储仓(库、罐)名称receiveDatedate20否领用日期materialCount否投入物料数量materialUnitstring否数量单位7.7出厂检验信息上传接口通过出厂检验信息上传接口上传的信息见表12。表12出厂检验信息上传接口信息参数名称类型长度Byte是否必填描述tidstring40是序号，此字段为企业上传的出厂检验数据的唯一标识位batchIdstring20是生产批次码goodsCodestring是商品条码，依据GB12904reportCodestring50是检验报告编号certificateCodestring32否合格证明编号checkConclusionstring6是容见附录BcheckDatedate20是检验日期checkerNamestring20是检验人headPersonstring20是负责人selfCheckStdstring20否检验执行标准outfactoryItmesstring是出厂检验明细信息，此参数为多项信息，见表13DB32/T3408—20187.8出厂检验明细信息出厂检验明细信息见表13。表13出厂检验明细信息参数名称类型长度Byte是否必填描述checkItmeNamestring32是检验项目名称reportCodestring50是检验报告编号checkItmeCodestring20是检验项目编码measuredValuestring32否实测值standardValuestring32否标准值checkUnitstring20否计量单位7.9出厂销售信息上传接口通过出厂销售信息上传接口上传的信息见表14。表14出厂销售信息上传接口信息参数名称类型长度Byte是否必填描述batchIdstring20是生产批次码goodsCodestring是商品条码，依据GB12904saleDatedate20是销售日期saleCount是销售数量saleCountUnitstring是销售数量单位dealerCodestring是经销商统一信用代码dealerCertNamestring32否经销商资质证明名称dealerCertCodestring50否经销商资质证明编号salerAddrstring否出货地点carrierstring20否承运者7.10批次、单品对应信息上传接口通过批次、单品对应信息上传接口上传的信息见表15。表15批次、单品对应信息上传接口信息参数名称类型长度Byte是否必填描述goodsCode_boxstring是商品外箱条码，储运包装商品条码，见GB/T16830goodsCodestring是商品条码，依据GB12904DB32/T3408—2018表15批次、单品对应信息上传接口信息(续)参数名称类型长度Byte是否必填描述batchIdstring20是生产批次码packageIdstring20是包装序列号productionIdstring20是产品序列号7.11不合格产品处理信息上传接口通过不合格产品处理信息上传接口上传的信息见表16。表16不合格产品处理信息上传接口信息参数名称类型长度Byte是否必填描述goodsCodestring是商品条码，依据GB12904batchIdstring20是生产批次码problemReasonstring是问题原因processConclusionstring是产品处理结论processCount否产品处理数量processUnitstring否计量单位processDatedate20是处理时间processPersonstring20是处理人supervisionstring20是监督人7.12产品召回事件信息上传接口通过产品召回事件信息上传接口上传的信息见表17。表17产品召回事件信息上传接口信息参数名称类型长度Byte是否必填描述recallCodestring20是召回事件编码，此字段为企业上传的为召回事件编制的唯一标识位batchIdstring20是生产批次码goodsCodestring是商品条码，依据GB12904recallReasonstring256是召回原因recallCount是预计召回数量DB32/T3408—2018表17产品召回事件信息上传接口信息(续)参数名称类型长度Byte是否必填描述recallUnitstring否数量单位recallDatedate20否召回时间recallNamestring20是召回人superVisorstring20是监督人7.13产品召回跟踪信息上传接口通过产品召回跟踪信息上传接口上传的信息见表18。表18产品召回跟踪信息上传接口信息参数名称类型长度Byte是否必填描述recallCodestring20是召回事件编码，见表17batchIdstring20是生产批次码goodsCodestring是商品条码，依据GB12904dealerCodestring30是经销商统一信用代码recallAddressstring是召回地址actualRecallCount是实际召回数量recallUnitstring否数量单位processMethodstring32否处理方式recallDatedate20否召回时间recallPersonstring20是召回人superVisorstring20否监督人DB32/T3408—2018AA附录A(规范性附录)上传数据错误码列表表A.1上传数据错误码列表错误码错误详细信息2001服务器端验证未通过，数字证书已过期或无数字证书3001上传数据中字段未按规定长度上传3002上传数据中参数名称错误3003上传数据中有语法错误4001服务器端错误导致的登录失败5001上传数据审核未通过DB32/T3408—2018BB附录B(规范性附录)编码表表B.1原料产品分类编码序号产品大类分类编码1食品类原料SS2食品添加剂ST3包装材料SB表B.2检验情况编码序号合格证明类型编码1检验报告HZ00012合格证HZ00023无合格证明HZ0003表B.3自行检验情况编码序号自行检验情况编码1未自行检验ZJ00012自行检验合格ZJ00023自行检验不合格ZJ0003表B.4结论编码序号结论编码1合格JL00012不合格JL00023让步接收JL0003DB32/T3408—2018附录C(资料性附录)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>DB32/T3408—2018<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>DB32/T3408—2018C.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"?>DB32/T3408—2018<!--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>DB32/T3408—2018<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><orgC