食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報接口規(guī)范

1食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報接口規(guī)范本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報接口的功能要求和上傳信息。本標(biāo)準(zhǔn)適用于食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報接口的開發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T7635.1-2002全國主要產(chǎn)品分類與代碼第1部分：可運(yùn)輸產(chǎn)品GB12904商品條碼零售商品編碼與條碼表示GB/T16830商品條碼儲運(yùn)包裝商品編碼與條碼表示CFDAB/T0401-2014食品藥品監(jiān)管數(shù)據(jù)共享與交換接口規(guī)范DB32/TXXXX-2018食品安全電子追溯標(biāo)識解析服務(wù)數(shù)據(jù)接口規(guī)范3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1網(wǎng)元networkelement由軟硬件共同組成的能實(shí)現(xiàn)網(wǎng)絡(luò)中的一定的邏輯功能的邏輯單元。3.2CU網(wǎng)元captureunitnetworkelement負(fù)責(zé)采集主數(shù)據(jù)、交易數(shù)據(jù)和事件數(shù)據(jù)并提交到IQS網(wǎng)元，完成數(shù)據(jù)采集功能的網(wǎng)元。3.3IQS網(wǎng)元informationqueryservicenetworkelement提供可視化追溯信息查詢服務(wù)的網(wǎng)元。3.4SP網(wǎng)元SupervisorPlatformNetworkElement接收IQS網(wǎng)元上報的追溯數(shù)據(jù)，支撐政府監(jiān)管人員利用追溯數(shù)據(jù)開展對企業(yè)監(jiān)管的網(wǎng)元。4縮略語2下列縮略語適用于本文件。HTTPS：安全超文本傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）IQS：信息查詢服務(wù)（InformationQueryService）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）SOAP：簡單對象訪問協(xié)議（SimpleObjectAccessProtocal）WSDL：Web服務(wù)定義語言（WebServicesDescriptionLanguage）XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）5功能要求5.1網(wǎng)元交互5.1.1總則食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺、監(jiān)管平臺、查詢平臺組成。食品安全電子追溯系統(tǒng)的系統(tǒng)架構(gòu)見DB32/TXXXX。生產(chǎn)企業(yè)使用CU網(wǎng)元將采集到的數(shù)據(jù)上傳至IQS網(wǎng)元，由IQS網(wǎng)元向SP網(wǎng)元進(jìn)行數(shù)據(jù)上報。本標(biāo)準(zhǔn)僅規(guī)范由企業(yè)平臺IQS網(wǎng)元上傳至監(jiān)管平臺SP網(wǎng)元的數(shù)據(jù)上報接口，生產(chǎn)企業(yè)數(shù)據(jù)上報系統(tǒng)架構(gòu)見圖1。圖1生產(chǎn)企業(yè)數(shù)據(jù)上報系統(tǒng)架構(gòu)5.1.2網(wǎng)元要求CU網(wǎng)元應(yīng)通過條碼識讀設(shè)備和RFID讀寫器等數(shù)據(jù)采集設(shè)備采集一維碼、二維碼、RFID標(biāo)簽等信息的功能。IQS網(wǎng)元應(yīng)提供追溯信息捕獲、查詢服務(wù)和數(shù)據(jù)上報服務(wù)的功能。SP網(wǎng)元應(yīng)部署在監(jiān)管部門的服務(wù)器系統(tǒng)上，SP網(wǎng)元應(yīng)實(shí)現(xiàn)支撐利用追溯數(shù)據(jù)開展對企業(yè)的監(jiān)管功能。6接口36.1接口協(xié)議接口采用Webservice方式。數(shù)據(jù)上報接口協(xié)議棧涉及到服務(wù)傳輸層、服務(wù)消息層和服務(wù)描述層，服務(wù)傳輸層使用HTTPS協(xié)議，以提高數(shù)據(jù)傳輸?shù)陌踩浴７?wù)消息層協(xié)議為SOAP，服務(wù)描述層描述語言為WSDL。6.2安全性設(shè)置客戶端和服務(wù)器端通信采用數(shù)字證書認(rèn)證，數(shù)據(jù)傳輸通過MD5來驗證完整性，見CFDAB/T0401-2014。數(shù)字證書由食品安全電子追溯系統(tǒng)監(jiān)管平臺服務(wù)器端經(jīng)審核后在線發(fā)放或發(fā)放硬件裝載的數(shù)字證書。6.3基本數(shù)據(jù)類型食品生產(chǎn)企業(yè)電子追溯系統(tǒng)提供的數(shù)據(jù)上報共享接口所使用到的基本數(shù)據(jù)類型定義見表1。表1基本數(shù)據(jù)類型6.4接口定義Webservice名稱：ProductTraceService，上傳數(shù)據(jù)方法名稱：intuploadData（StringdataType,StringdataXml,StringdataMD5輸入?yún)?shù)見表2。表2輸入?yún)?shù)是是是數(shù)據(jù)上傳完畢，服務(wù)器端響應(yīng)參數(shù)見表3。表3響應(yīng)參數(shù)表3響應(yīng)參數(shù)（續(xù)）4錯誤信息獲得方法名稱：StringgetUploadError（interrorCode）輸入值為errorCode，是數(shù)據(jù)上傳完畢后服務(wù)器端的響應(yīng)參數(shù)的返回值，見表3。返回值為上傳數(shù)據(jù)錯誤詳細(xì)信息，見附錄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>其中各字段對應(yīng)填寫內(nèi)容見表4，XML報文編寫示例參見附錄C，編碼格式為UTF-8。注：原料自檢明細(xì)信息、投放明細(xì)信息、出廠檢驗明細(xì)信息分別通過原料自檢信息上傳接口（參見附錄C.1.3）、投入產(chǎn)出信息上傳接口上傳（參見附錄C.1.4）和出廠檢驗信息上傳接口表4字段填寫內(nèi)容6.6接口約束使用增量上傳方式，僅對新增和修改的數(shù)據(jù)上傳。6.7接口分類接口分類見表5。5表5接口分類materialSelfCheckDetailsBunQualifiedProductsProces7數(shù)據(jù)上傳接口7.1企業(yè)基本信息上傳接口通過企業(yè)基本信息上傳接口上傳的信息見表6。表6企業(yè)基本信息上傳接口信息是是否符否個編號，各編號間使用“/”否7.2原料進(jìn)廠信息上傳接口通過原料進(jìn)廠信息上傳接口上傳的信息見表7。6表7原料進(jìn)廠信息上傳接口信息是6是是materialProductbatc否否否是是是是是否6否否6否否wareHouseCode是wareHouseName是7表7原料進(jìn)廠信息上傳接口信息（續(xù)）是碼是碼否否否6是是是7.3原料自檢信息上傳接口通過原料自檢信息上傳接口上傳的信息見表8。表8原料自檢信息上傳接口信息是是是是6是是是否是7.4原料自檢明細(xì)信息原料自檢明細(xì)信息見表9。8表9自檢明細(xì)信息是是是否否否7.5投入產(chǎn)出信息上傳接口通過投入產(chǎn)出信息上傳接口上傳的信息見表10。表10投入產(chǎn)出信息上傳接口信息是是是是是否否是是是workshopNumber否否否生產(chǎn)線（班組）號productionLineHeadP否是7.6投放明細(xì)信息投放明細(xì)信息見表11。9表11投放明細(xì)信息是是6是是是是否wareHouseName否否否否7.7出廠檢驗信息上傳接口通過出廠檢驗信息上傳接口上傳的信息見表12。表12出廠檢驗信息上傳接口信息是是是是否6是是是是否是7.8出廠檢驗明細(xì)信息出廠檢驗明細(xì)信息見表13。表13出廠檢驗明細(xì)信息是是是否否否7.9出廠銷售信息上傳接口通過出廠銷售信息上傳接口上傳的信息見表14。表14出廠銷售信息上傳接口信息是是是是是是否否否否7.10批次、單品對應(yīng)信息上傳接口通過批次、單品對應(yīng)信息上傳接口上傳的信息見表15。表15批次、單品對應(yīng)信息上傳接口信息是是表15批次、單品對應(yīng)信息上傳接口信息（續(xù)）是是是7.11不合格產(chǎn)品處理信息上傳接口通過不合格產(chǎn)品處理信息上傳接口上傳的信息見表16。表16不合格產(chǎn)品處理信息上傳接口信息是是是是否否是是是7.12產(chǎn)品召回事件信息上傳接口通過產(chǎn)品召回事件信息上傳接口上傳的信息見表17。表17產(chǎn)品召回事件信息上傳接口信息是是是是是表17產(chǎn)品召回事件信息上傳接口信息（續(xù)）否否是是7.13產(chǎn)品召回跟蹤信息上傳接口通過產(chǎn)品召回跟蹤信息上傳接口上傳的信息見表18。表18產(chǎn)品召回跟蹤信息上傳接口信息是是是是是是否否否是否（規(guī)范性附錄）上傳數(shù)據(jù)錯誤碼列表表A.1上傳數(shù)據(jù)錯誤碼列表（規(guī)范性附錄）編碼表表B.1原料產(chǎn)品分類編碼123表B.2檢驗情況編碼123表B.3自行檢驗情況編碼123表B.4結(jié)論編碼123（資料性附錄）XML報文示例C.1.1企業(yè)基本信息上傳<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><registerBean><orgCode>530112111</orgCode><orgName>江蘇XX食品公司</orgName><foodProductId>10000012</foodProductId><foodAdditivesId>10000012</foodAdditivesId></registerBean>C.1.2原料進(jìn)廠信息上傳<?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>超標(biāo)量檢測</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投入產(chǎn)出信息上傳<?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>指標(biāo)超標(biāo)</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批次、單品產(chǎn)成品對應(yīng)表<?xmlversion="1.0"encoding="UTF-8"?><!--SampleXMLfilegeneratedbyXMLSpyv2007sp1()--><batchItemBean><orgCode>530123444</orgCode><goodsCode></goodsCode><batchId>530123444123454</batchId><packageId>/<packageId><productionId></productionId></batchItemBean>C.1.8不合格產(chǎn)品處理信息上傳<?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