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

ICS67.040

X00

備案號(hào)：60244-2018DB32

江蘇省地方標(biāo)準(zhǔn)

DB32/T3408—2018

食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報(bào)

接口規(guī)范

Interfacespecificationsofproductionenterprisedatareportingforfoodsafety

electronictraceability

2018-06-25發(fā)布2018-07-10實(shí)施

江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布

DB32/T3408—2018

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

1范圍

本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報(bào)接口的功能要求和上傳信息。

本標(biāo)準(zhǔn)適用于食品安全電子追溯生產(chǎn)企業(yè)數(shù)據(jù)上報(bào)接口的開發(fā)和應(yīng)用。

2規(guī)范性引用文件

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T7635.1-2002全國主要產(chǎn)品分類與代碼第1部分：可運(yùn)輸產(chǎn)品

GB12904商品條碼零售商品編碼與條碼表示

GB/T16830商品條碼儲(chǔ)運(yùn)包裝商品編碼與條碼表示

CFDAB/T0401-2014食品藥品監(jiān)管數(shù)據(jù)共享與交換接口規(guī)范

DB32/TXXXX-2018食品安全電子追溯標(biāo)識(shí)解析服務(wù)數(shù)據(jù)接口規(guī)范

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

網(wǎng)元networkelement

由軟硬件共同組成的能實(shí)現(xiàn)網(wǎng)絡(luò)中的一定的邏輯功能的邏輯單元。

3.2

CU網(wǎng)元captureunitnetworkelement

負(fù)責(zé)采集主數(shù)據(jù)、交易數(shù)據(jù)和事件數(shù)據(jù)并提交到IQS網(wǎng)元，完成數(shù)據(jù)采集功能的網(wǎng)元。

3.3

IQS網(wǎng)元informationqueryservicenetworkelement

提供可視化追溯信息查詢服務(wù)的網(wǎng)元。

3.4

SP網(wǎng)元SupervisorPlatformNetworkElement

接收IQS網(wǎng)元上報(bào)的追溯數(shù)據(jù)，支撐政府監(jiān)管人員利用追溯數(shù)據(jù)開展對(duì)企業(yè)監(jiān)管的網(wǎng)元。

4縮略語

1

DB32/T3408—2018

下列縮略語適用于本文件。

HTTPS：安全超文本傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

IQS：信息查詢服務(wù)（InformationQueryService）

MD5：消息摘要算法第五版（Message-DigestAlgorithm5）

SOAP：簡(jiǎn)單對(duì)象訪問協(xié)議（SimpleObjectAccessProtocal）

WSDL：Web服務(wù)定義語言（WebServicesDescriptionLanguage）

XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）

5功能要求

5.1網(wǎng)元交互

5.1.1總則

食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺(tái)、監(jiān)管平臺(tái)、查詢平臺(tái)組成。食品安全電子追溯系統(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ù)

上報(bào)。本標(biāo)準(zhǔn)僅規(guī)范由企業(yè)平臺(tái)IQS網(wǎng)元上傳至監(jiān)管平臺(tái)SP網(wǎng)元的數(shù)據(jù)上報(bào)接口，生產(chǎn)企業(yè)數(shù)據(jù)上報(bào)系

統(tǒng)架構(gòu)見圖1。

監(jiān)管平臺(tái)

SP網(wǎng)元

數(shù)據(jù)上報(bào)接口數(shù)據(jù)上報(bào)接口數(shù)據(jù)上報(bào)接口

IQS網(wǎng)元IQS網(wǎng)元IQS網(wǎng)元

IQS數(shù)據(jù)傳輸接口IQS數(shù)據(jù)傳輸接口IQS數(shù)據(jù)傳輸接口

CU網(wǎng)元CU網(wǎng)元CU網(wǎng)元

A企業(yè)平臺(tái)B企業(yè)平臺(tái)C企業(yè)平臺(tái)

圖1生產(chǎn)企業(yè)數(shù)據(jù)上報(bào)系統(tǒng)架構(gòu)

5.1.2網(wǎng)元要求

CU網(wǎng)元應(yīng)通過條碼識(shí)讀設(shè)備和RFID讀寫器等數(shù)據(jù)采集設(shè)備采集一維碼、二維碼、RFID標(biāo)簽等

信息的功能。

IQS網(wǎng)元應(yīng)提供追溯信息捕獲、查詢服務(wù)和數(shù)據(jù)上報(bào)服務(wù)的功能。

SP網(wǎng)元應(yīng)部署在監(jiān)管部門的服務(wù)器系統(tǒng)上，SP網(wǎng)元應(yīng)實(shí)現(xiàn)支撐利用追溯數(shù)據(jù)開展對(duì)企業(yè)的

監(jiān)管功能。

6接口

2

DB32/T3408—2018

6.1接口協(xié)議

接口采用Webservice方式。數(shù)據(jù)上報(bào)接口協(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來驗(yàn)證完整性，見CFDAB/T0401-2014。

數(shù)字證書由食品安全電子追溯系統(tǒng)監(jiān)管平臺(tái)服務(wù)器端經(jīng)審核后在線發(fā)放或發(fā)放硬件裝載的數(shù)字證書。

6.3基本數(shù)據(jù)類型

食品生產(chǎn)企業(yè)電子追溯系統(tǒng)提供的數(shù)據(jù)上報(bào)共享接口所使用到的基本數(shù)據(jù)類型定義見表1。

表1基本數(shù)據(jù)類型

類型名類型描述類型說明

string文本字符串內(nèi)容為所有的有效字符

date日期類型固定格式字符串，格式為YYYY-MM-DD

int數(shù)字類型內(nèi)容由從0-9的數(shù)字字符，和+-字符組成

6.4接口定義

Webservice名稱：ProductTraceService，上傳數(shù)據(jù)方法名稱：intuploadData（StringdataType,

StringdataXml,StringdataMD5），輸入?yún)?shù)見表2。

表2輸入?yún)?shù)

參數(shù)名稱類型是否必填參數(shù)說明

dataTypestring是數(shù)據(jù)類型

dataXmlstring是上傳數(shù)據(jù)的XML數(shù)據(jù)

dataMD5string是dataXml數(shù)據(jù)的MD5碼

數(shù)據(jù)上傳完畢，服務(wù)器端響應(yīng)參數(shù)見表3。

表3響應(yīng)參數(shù)

響應(yīng)參數(shù)類型參數(shù)說明

statusint返回值，用于表示狀態(tài)：

若返回值為1，表示上傳數(shù)據(jù)成功、

若返回值為0，表示上傳的XML與上傳

數(shù)據(jù)中dataXml的MD5碼不匹配

響應(yīng)參數(shù)類型參數(shù)說明

errorCodeint上傳失敗的返回值：為uploadData函

數(shù)調(diào)用返回的錯(cuò)誤碼

3

DB32/T3408—2018

錯(cuò)誤信息獲得方法名稱：StringgetUploadError（interrorCode）

輸入值為errorCode，是數(shù)據(jù)上傳完畢后服務(wù)器端的響應(yīng)參數(shù)的返回值，見表3。

返回值為上傳數(shù)據(jù)錯(cuò)誤詳細(xì)信息，見附錄A。

6.5報(bào)文格式定義與編寫方法

報(bào)文編寫格式為：

<?xmlversion="1.0"encoding="UTF-8"?>

<entitys

xmlns: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>

其中各字段對(duì)應(yīng)填寫內(nèi)容見表4，XML報(bào)文編寫示例參見附錄C，編碼格式為UTF-8。

注：原料自檢明細(xì)信息、投放明細(xì)信息、出廠檢驗(yàn)明細(xì)信息分別通過原料自檢信息上傳接口（參見附錄C.1.3）、

投入產(chǎn)出信息上傳接口上傳（參見附錄C.1.4）和出廠檢驗(yàn)信息上傳接口（參見附錄C.1.5）。

表4字段填寫內(nèi)容

字段名對(duì)應(yīng)填寫內(nèi)容

entity見表5中上傳接口名稱

property見7章各上傳接口信息表中的參數(shù)名稱

value對(duì)應(yīng)參數(shù)名稱填寫的信息

6.6接口約束

使用增量上傳方式，僅對(duì)新增和修改的數(shù)據(jù)上傳。

6.7接口分類

接口分類見表5。

4

DB32/T3408—2018

表5接口分類

對(duì)應(yīng)本標(biāo)準(zhǔn)章節(jié)號(hào)上傳接口名稱接口說明

7.1registerBean企業(yè)基本信息上傳接口

7.2materialFactoryBean原料進(jìn)廠信息上傳接口

7.3materialSelfCheckBean原料自檢信息上傳接口

7.4materialSelfCheckDetailsBean原料自檢明細(xì)信息

7.5inputOutPutBean投入產(chǎn)出信息上傳接口

7.6inputOutPutDetailsBean投放明細(xì)信息

7.7outFactoryCheckBean出廠檢驗(yàn)信息上傳接口

7.8outFactoryCheckDetailsBean出廠檢驗(yàn)明細(xì)信息

7.9outFactorySaleBean出廠銷售信息上傳接口

7.10batchItemBean批次、單品信息上傳接口

7.11unQualifiedProductsProcessBean不合格產(chǎn)品處理信息上傳接口

7.12productRecallEventBean產(chǎn)品召回事件信息上傳接口

7.13productRecallTrackBean產(chǎn)品召回跟蹤信息上傳接口

7數(shù)據(jù)上傳接口

7.1企業(yè)基本信息上傳接口

通過企業(yè)基本信息上傳接口上傳的信息見表6。

表6企業(yè)基本信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

orgCodestring30是統(tǒng)一社會(huì)信用代碼

orgNamestring127是企業(yè)名稱

食品生產(chǎn)許可證編號(hào),如多個(gè)

編號(hào)，各編號(hào)間使用“/”分

foodProductIdstring150否

隔，輸入完畢以“.”作結(jié)束

符

食品添加劑許可證編號(hào),如多

個(gè)編號(hào)，各編號(hào)間使用“/”

foodAdditivesIdstring150否

分隔，輸入完畢以“.”作結(jié)

束符

uploadDatedate20否上傳日期

7.2原料進(jìn)廠信息上傳接口

通過原料進(jìn)廠信息上傳接口上傳的信息見表7。

5

DB32/T3408—2018

表7原料進(jìn)廠信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

原料進(jìn)貨批次碼，此字段為企

materialBatchidstring20是業(yè)上傳的原料進(jìn)廠數(shù)據(jù)的唯

一標(biāo)識(shí)位

原料產(chǎn)品分類編碼，編碼內(nèi)容

materialTypeCodestring6是

見附錄B表B.1

原料編碼，編碼內(nèi)容見GB/T

materialCodestring14是

7635.1-2002

materialProductbatchidstring20否原料生產(chǎn)企業(yè)的生產(chǎn)批次碼

materialNamestring50否進(jìn)貨原料名

materialStylestring50否規(guī)格型號(hào)

purchaseCountint10是進(jìn)貨數(shù)量

countInitstring10是進(jìn)貨數(shù)量單位

productionDatedate20是原料生產(chǎn)日期

shelfLifeint10是保質(zhì)期

保質(zhì)期單位，“小時(shí)”、“天”、

shelfUnitstring10是

“月”等

carNumberstring12否運(yùn)輸車輛牌照

合格證明類型，編碼內(nèi)容見附

certificateTypestring6否

錄B表B.2

certificateCodestring32否合格證明編號(hào)

自行檢驗(yàn)編碼，編碼內(nèi)容見附

slefCheckIdstring6否

錄B表B.3

slefCheckStdstring20否自行檢驗(yàn)執(zhí)行標(biāo)準(zhǔn)

存儲(chǔ)倉（庫、罐）編號(hào)，此字

段可以存放存儲(chǔ)倉（庫、罐）

wareHouseCodestring20是

編號(hào)或某庫罐內(nèi)某批次原料

的進(jìn)貨批次碼

wareHouseNamestring20是存儲(chǔ)倉（庫、罐）名稱

6

DB32/T3408—2018

表7原料進(jìn)廠信息上傳接口信息（續(xù)）

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

原料生產(chǎn)商統(tǒng)一社會(huì)信用代

producerCodestring30是

碼

原料供應(yīng)商統(tǒng)一社會(huì)信用代

supplierCodestring30是

碼

supplierCertNamestring50否供應(yīng)商資質(zhì)證明名稱

supplierCertCodestring20否供應(yīng)商資質(zhì)證明編號(hào)

purchaserstring20否企業(yè)采購者

檢驗(yàn)結(jié)論，編碼內(nèi)容見附錄B

checkConclusionstring6是

表B.4

accepterstring20是驗(yàn)收人

createTimedate20是進(jìn)廠時(shí)間

7.3原料自檢信息上傳接口

通過原料自檢信息上傳接口上傳的信息見表8。

表8原料自檢信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

原料自檢序列號(hào)，此字段為企

tidstring40是業(yè)上傳的原料自檢數(shù)據(jù)的唯

一標(biāo)識(shí)位

原料進(jìn)貨批次碼，對(duì)應(yīng)表7原

materialBatchidstring20是

料進(jìn)貨批次碼

原料編碼，編碼內(nèi)容見GB/T

materialCodestring14是

7635.1-2002

reportCodestring50是檢驗(yàn)報(bào)告編號(hào)

檢驗(yàn)結(jié)論，編碼內(nèi)容見附錄B

checkResultstring6是

表B.3

checkerNamestring20是檢驗(yàn)人

headPersonstring20是負(fù)責(zé)人

checkDatedate20否檢驗(yàn)日期

原料自檢明細(xì)信息，此參數(shù)為

checkDetailsstring180是

多項(xiàng)信息，見表9

7.4原料自檢明細(xì)信息

原料自檢明細(xì)信息見表9。

7

DB32/T3408—2018

表9自檢明細(xì)信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

reportCodestring50是檢驗(yàn)報(bào)告編號(hào)

checkItemCodestring20是檢驗(yàn)項(xiàng)目編碼

checkItemNamestring32是檢驗(yàn)項(xiàng)目名稱

checkUnitstring20否計(jì)量單位

measuredValuestring32否實(shí)測(cè)值

標(biāo)準(zhǔn)值，參照食品產(chǎn)品對(duì)應(yīng)國

standardValuestring32否

家標(biāo)準(zhǔn)、行業(yè)標(biāo)準(zhǔn)或企業(yè)標(biāo)準(zhǔn)

7.5投入產(chǎn)出信息上傳接口

通過投入產(chǎn)出信息上傳接口上傳的信息見表10。

表10投入產(chǎn)出信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

序號(hào)，此字段為企業(yè)上傳的投

tidstring40是

入產(chǎn)出數(shù)據(jù)的唯一標(biāo)識(shí)位

batchIdstring20是生產(chǎn)批次碼

ingredientsCodestring20是投配料單編碼

goodsCodestring14是商品條碼，依據(jù)GB12904

productLicenseNumberstring14是成品的許可證編號(hào)

productCountint10否生產(chǎn)成品數(shù)量

productUnitstring10否成品數(shù)量單位

createDatedate20是生產(chǎn)日期

shelfLifeint20是保質(zhì)期

shelfUnitstring10是保質(zhì)期單位

workshopNumberstring20否生產(chǎn)車間號(hào)

headPersonstring20否負(fù)責(zé)人

productionLineNostring20否生產(chǎn)線（班組）號(hào)

productionLineHeadPersonstring20否生產(chǎn)線（班組）負(fù)責(zé)人姓名

投放明細(xì)信息，此參數(shù)為多項(xiàng)

inputOutputItmesstring200是

信息，見表11

7.6投放明細(xì)信息

投放明細(xì)信息見表11。

8

DB32/T3408—2018

表11投放明細(xì)信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

batchIdstring20是生產(chǎn)批次碼

goodsCodestring14是商品條碼，依據(jù)GB12904

原料產(chǎn)品分類編碼，編碼內(nèi)容

commoditiesCodestring6是

見GB/T7635.1-2002

materialCodestring20是原料編碼

materialBatchidstring20是原料進(jìn)貨批次碼

materialManagerNamestring20是原料保管員姓名

領(lǐng)用人姓名，如多個(gè)姓名，各

receivePersonstring30否姓名間使用“/”分隔，輸入

完畢以“.”作結(jié)束符

wareHouseNamestring20否存儲(chǔ)倉（庫、罐）名稱

receiveDatedate20否領(lǐng)用日期

materialCountint10否投入物料數(shù)量

materialUnitstring10否數(shù)量單位

7.7出廠檢驗(yàn)信息上傳接口

通過出廠檢驗(yàn)信息上傳接口上傳的信息見表12。

表12出廠檢驗(yàn)信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

序號(hào)，此字段為企業(yè)上傳的出

tidstring40是

廠檢驗(yàn)數(shù)據(jù)的唯一標(biāo)識(shí)位

batchIdstring20是生產(chǎn)批次碼

goodsCodestring14是商品條碼，依據(jù)GB12904

reportCodestring50是檢驗(yàn)報(bào)告編號(hào)

certificateCodestring32否合格證明編號(hào)

檢驗(yàn)結(jié)論編碼，內(nèi)容見附錄B

checkConclusionstring6是

表B.3

checkDatedate20是檢驗(yàn)日期

checkerNamestring20是檢驗(yàn)人

headPersonstring20是負(fù)責(zé)人

selfCheckStdstring20否檢驗(yàn)執(zhí)行標(biāo)準(zhǔn)

出廠檢驗(yàn)明細(xì)信息，此參數(shù)為

outfactoryItmesstring180是

多項(xiàng)信息，見表13

9

DB32/T3408—2018

7.8出廠檢驗(yàn)明細(xì)信息

出廠檢驗(yàn)明細(xì)信息見表13。

表13出廠檢驗(yàn)明細(xì)信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

checkItmeNamestring32是檢驗(yàn)項(xiàng)目名稱

reportCodestring50是檢驗(yàn)報(bào)告編號(hào)

checkItmeCodestring20是檢驗(yàn)項(xiàng)目編碼

measuredValuestring32否實(shí)測(cè)值

standardValuestring32否標(biāo)準(zhǔn)值

checkUnitstring20否計(jì)量單位

7.9出廠銷售信息上傳接口

通過出廠銷售信息上傳接口上傳的信息見表14。

表14出廠銷售信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

batchIdstring20是生產(chǎn)批次碼

goodsCodestring14是商品條碼，依據(jù)GB12904

saleDatedate20是銷售日期

saleCountint10是銷售數(shù)量

saleCountUnitstring10是銷售數(shù)量單位

dealerCodestring30是經(jīng)銷商統(tǒng)一信用代碼

dealerCertNamestring32否經(jīng)銷商資質(zhì)證明名稱

dealerCertCodestring50否經(jīng)銷商資質(zhì)證明編號(hào)

salerAddrstring128否出貨地點(diǎn)

carrierstring20否承運(yùn)者

7.10批次、單品對(duì)應(yīng)信息上傳接口

通過批次、單品對(duì)應(yīng)信息上傳接口上傳的信息見表15。

表15批次、單品對(duì)應(yīng)信息上傳接口信息

長(zhǎng)度

參數(shù)名稱類型是否必填描述

Byte

商品外箱條碼，儲(chǔ)運(yùn)包裝商品

goodsCode_boxstring14是

條碼，見GB/T16830

goodsCodestring14是商品條碼，依據(jù)GB12904

10