DB4403-T 190-2021 食品經(jīng)營者追溯電子臺賬規(guī)范

ICS35.240

CCSX07

DB4403

深圳市地方標(biāo)準(zhǔn)

DB4403/T190—2021

食品經(jīng)營者追溯電子臺賬規(guī)范

Specificationfortraceabilityelectronicaccountof

foodbusinessoperators

2021-09-28發(fā)布2021-11-01實(shí)施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/T190—2021

食品經(jīng)營者追溯電子臺賬規(guī)范

1范圍

本文件規(guī)定了食品經(jīng)營者追溯電子臺賬通用要求、電子臺賬對接方式以及信息傳輸要求。

本文件適用于食品經(jīng)營者建立以食品追溯為目的的電子臺賬以及第三方系統(tǒng)與食品安全追溯系統(tǒng)

電子臺賬數(shù)據(jù)的交互。食品包括預(yù)包裝食品、食用農(nóng)產(chǎn)品、食品原料、食品添加劑以及食品相關(guān)產(chǎn)品等。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

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

DB4403/T191—2021食用農(nóng)產(chǎn)品追溯碼編碼技術(shù)規(guī)范

3術(shù)語和定義

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

3.1

食品安全追溯系統(tǒng)foodsafetytraceabilitysystem

為食品安全監(jiān)管機(jī)構(gòu)、食品供應(yīng)鏈相關(guān)企業(yè)、社會公眾提供食品安全追溯服務(wù)的信息系統(tǒng)。

3.2

食品經(jīng)營者foodhandlers

以營利為目的，從事生產(chǎn)經(jīng)營活動并向消費(fèi)者提供其生產(chǎn)、銷售的食品或者提供服務(wù)的公民、法人

或者其它經(jīng)濟(jì)組織。

注：本文中將食品經(jīng)營者根據(jù)追溯上下級關(guān)系劃分為發(fā)貨方和收貨方。

3.3

電子臺賬electronicaccount

通過電子計(jì)算機(jī)和網(wǎng)絡(luò)，用系統(tǒng)方式建立起來的對食品的進(jìn)銷過程進(jìn)行規(guī)范化管理的信息化記賬方

式。

3.4

追溯電子臺賬traceabilityelectronicaccount

以實(shí)現(xiàn)對食品從生產(chǎn)、供應(yīng)、物流配送到零售終端的全程追溯為目的的電子臺賬記賬方式，來表示

食品來源和去向的記錄。

3.5

第三方系統(tǒng)thirdpartysystem

企業(yè)自建的或租用的，區(qū)別于食品安全追溯系統(tǒng)的外部系統(tǒng)。

4縮略語

1

DB4403/T190—2021

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

DES：數(shù)據(jù)加密標(biāo)準(zhǔn)（DataEncryptionStandard）

HTTPS：信息安全傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript對象表示法（JavaScriptObjectNotation）

SSL：安全套接層（SecureSocketLayer）

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

5電子臺賬通用要求

5.1電子臺賬概述

5.1.1應(yīng)建立食品經(jīng)營者追溯電子臺賬制度，電子臺賬分為發(fā)貨臺賬和收貨臺賬。

5.1.2經(jīng)食品安全追溯系統(tǒng)實(shí)名認(rèn)證的用戶，可直接通過系統(tǒng)進(jìn)行收發(fā)貨操作建立上下游鏈條關(guān)系，

同時(shí)系統(tǒng)自動生成追溯電子臺賬記錄，用戶可在收發(fā)貨電子臺賬庫中自行打印和下載相關(guān)發(fā)貨臺賬或收

貨臺賬電子記錄，如圖1虛線框中所示。

5.1.3采用系統(tǒng)互聯(lián)對接方式的第三方系統(tǒng)，可通過標(biāo)準(zhǔn)的API接口方式或電子臺賬報(bào)文方式，生成

電子臺賬，與食品安全追溯系統(tǒng)進(jìn)行數(shù)據(jù)交互。數(shù)據(jù)對接方式如圖1虛線框外部分所示。

圖1電子臺賬業(yè)務(wù)和數(shù)據(jù)流向示意圖

5.2電子臺賬記錄要求

5.2.1記錄內(nèi)容與要求

2

DB4403/T190—2021

電子臺賬記錄內(nèi)容與要求見表1。

表1電子臺賬記錄要求

數(shù)據(jù)字段字段表示數(shù)據(jù)類型備注

發(fā)貨日期deliverdateDATE格式：YYMMDD

收貨日期receivedateDATE格式：YYMMDD

預(yù)包裝食品、食品原料、食品添加劑以及

食品相關(guān)產(chǎn)品的產(chǎn)品編碼應(yīng)使用商品條

產(chǎn)品編碼productCodeSTRING碼，應(yīng)按照GB12904確定的編碼。食用

農(nóng)產(chǎn)品的產(chǎn)品編碼應(yīng)按照DB4403/T191

—2021中第6章規(guī)定的追溯碼編碼方案

產(chǎn)品名稱productNameSTRING—

產(chǎn)品分類productTypeSTRING—

規(guī)格/型號specificationSTRING—

品牌brandSTRING—

批次batchNoSTRING—

保質(zhì)期validateSTRING以預(yù)包裝食品包裝上標(biāo)注的保質(zhì)期為準(zhǔn)

食品出廠檢驗(yàn)合格證或者其他第三方檢

檢驗(yàn)報(bào)告checkreportSTRING驗(yàn)合格證明。如：蔬菜應(yīng)有農(nóng)殘檢驗(yàn)報(bào)告，

肉類應(yīng)有動物檢疫檢驗(yàn)合格證（產(chǎn)品）等

數(shù)量qualityINT—

發(fā)貨方統(tǒng)一社會信用代碼deliveryCodeSTRING18位統(tǒng)一社會信用代碼

發(fā)貨方名稱deliveryNameSTRING—

發(fā)貨方聯(lián)系人姓名deliveryLinkNameSTRING—

發(fā)貨方聯(lián)系電話deliveryLinkTelSTRING—

收貨方統(tǒng)一社會信用代碼receivedCodeSTRING18位統(tǒng)一社會信用代碼

收貨方名稱receivedNameSTRING—

收貨方聯(lián)系人姓名receivedLinkNameSTRING—

收貨方聯(lián)系人電話receivedLinkTelSTRING—

物流承運(yùn)方統(tǒng)一社會信用代碼logisticsCodeSTRING18位統(tǒng)一社會信用代碼

物流承運(yùn)方名稱logisticsNameSTRING—

物流運(yùn)單號logisticsNOSTRING—

5.2.2保存要求

電子臺賬數(shù)據(jù)保存期限不得少于產(chǎn)品保質(zhì)期后6個(gè)月，無保質(zhì)期的不少于2年。

6電子臺賬對接方式

6.1API接口方式

6.1.1API接口描述

3

DB4403/T190—2021

API接口是基于oauth2.0規(guī)范，使用實(shí)名認(rèn)證進(jìn)行身份認(rèn)證；API接口地址接受請求類型為POST,

數(shù)據(jù)格式為JSON。

6.1.2API接口調(diào)用

API接口主要包含產(chǎn)品信息接口和收發(fā)貨臺賬信息接口兩大類，API接口實(shí)例見A.1。

6.2報(bào)文方式

6.2.1總則

通過定義電子臺賬報(bào)文數(shù)據(jù)文件類型、格式、名稱等基本要素，使上傳數(shù)據(jù)能形成統(tǒng)一的數(shù)據(jù)流，

并通過相應(yīng)的報(bào)文對接方式，在非人工干預(yù)的情況下完成數(shù)據(jù)上傳。

6.2.2數(shù)據(jù)文件的分類

數(shù)據(jù)文件主要分為匯總文件和業(yè)務(wù)數(shù)據(jù)文件兩大類。匯總文件用來描述該次上傳的臺賬數(shù)據(jù)匯總信

息，即每項(xiàng)業(yè)務(wù)數(shù)據(jù)的記錄總數(shù)；業(yè)務(wù)數(shù)據(jù)文件用來描述各項(xiàng)臺賬相關(guān)業(yè)務(wù)數(shù)據(jù)，根據(jù)業(yè)務(wù)將臺賬數(shù)據(jù)

分文件描述。匯總文件和業(yè)務(wù)數(shù)據(jù)文件應(yīng)符合下列規(guī)則：

a)匯總文件要求如下：

1)文件數(shù)1個(gè)，命名為Statistic_Request.xml；

2)匯總文件每次上傳數(shù)據(jù)必傳。

b)業(yè)務(wù)數(shù)據(jù)文件要求如下：

1)文件數(shù)3個(gè)，文件命名為deliverAccount.xml、receivedAccount.xml、product.xml；

2)業(yè)務(wù)數(shù)據(jù)文件均為非必傳，若匯總文件中某類追溯數(shù)據(jù)記錄數(shù)不為0時(shí)，則應(yīng)上傳對應(yīng)的

XML數(shù)據(jù)文件。

6.2.3數(shù)據(jù)文件的格式

數(shù)據(jù)文件格式定義見表2。報(bào)文格式實(shí)例見A.2。

表2數(shù)據(jù)文件格式定義

文件名序號文件命名類型定義（TYPE）文件內(nèi)容

匯總文件(1)Statistic_Request.xmlStatistic_Request上傳數(shù)據(jù)匯總信息

(1)deliverAccount.xmlDelivery發(fā)貨臺賬

業(yè)務(wù)數(shù)據(jù)文件(2)receivedAccount.xmlReceived收貨臺賬

(3)product.xmlProduct產(chǎn)品

6.2.4數(shù)據(jù)文件的命名

數(shù)據(jù)文件的命名應(yīng)符合以下要求：

a)文件名不區(qū)分大小寫；

b)文件名與表2中的文件命名一致；

c)XSD文件命名與XML文件命名保持一致；

4

DB4403/T190—2021

d)如果數(shù)據(jù)記錄數(shù)超過單文件限制需拆分為多文件時(shí)，則命令格式為“規(guī)范文件名_序號（序號

為從001開始的3位數(shù)字）.xml”。

示例：發(fā)貨臺賬的數(shù)據(jù)文件命名為deliverAccount.xml、deliverAccount_001.xml、deliverAccount_002.xml、

deliverAccount_003.xml。

6.2.5單文件數(shù)據(jù)條數(shù)限制

對單個(gè)文件數(shù)據(jù)條數(shù)的限制要求如下：

a)單個(gè)文件信息條數(shù)不超過1萬條；

b)如果單個(gè)XML文件數(shù)據(jù)信息數(shù)超過1萬條，則需分多個(gè)文件上傳，命名規(guī)則見6.2.4。

示例：product.xml文件中產(chǎn)品信息數(shù)，最多允許1萬個(gè)。

7信息傳輸要求

7.1傳輸方式

宜采用通過HTTPS請求的JSON數(shù)據(jù)或者XML數(shù)據(jù)傳輸方式。

7.2安全性要求

安全性要求包括：

——通過互聯(lián)網(wǎng)傳輸，應(yīng)對數(shù)據(jù)進(jìn)行加密，以保證數(shù)據(jù)的保密性和完整性；

——傳輸通道應(yīng)統(tǒng)一采用SSL進(jìn)行加密，宜使用HTTPS技術(shù)實(shí)現(xiàn)；

——數(shù)據(jù)文件在傳輸之前，應(yīng)統(tǒng)一采用DES對稱加密算法進(jìn)行加密。

7.3可靠性要求

應(yīng)實(shí)現(xiàn)斷點(diǎn)續(xù)傳，以保障傳輸?shù)目煽啃浴?/p>

5

DB4403/T190—2021

AA

附錄A

（資料性）

電子臺賬對接實(shí)例

A.1API接口實(shí)例

A.1.1獲取token值

以產(chǎn)品發(fā)貨臺賬API測試為例，獲取token值方式如下：

/oauth/token?client_id=mobile&client_secret=secret&grant_type=p

assword&username=用戶名稱&password=密碼

A.1.2上傳SON數(shù)據(jù)

調(diào)用產(chǎn)品發(fā)貨臺賬接口，上傳JSON數(shù)據(jù),實(shí)例如下：

{

deliveryProducts:[

{

"productCode":'6909548500352',

"productType":'53102305',

"expire":300,

"productName":'蘋果果味飲料',

"specification":'250ml',

"Brand":'天然',

"batchNo":'2020080404SZ',

"validate"：'一年',

"quality":'100',

"deliverdate":'2020-11-10',

"receivedCode":'91440300MA5FKDXC2F',

"receivedName":'天虹商場股份有限公司民治優(yōu)城店',

"deliveryCode":'914403007298823514',

"deliveryLinkName":'李生',

"deliveryLinkTel":

},

{

"productCode":'6901234567862',

"productType":'50192109',

"productName":'產(chǎn)品名稱2.',

"specification":'32L',

"Brand":'百家樂',

"batchNo":'2xxx',

"validate"：'半年',

"quality":200,

6

DB4403/T190—2021

"deliverdate":'2020-11-10',

"receivedCode":'92440300FT0000558M',

"receivedName":'深圳天虹',

"deliveryCode":'914403007298823514',

"deliveryLinkName":'李生',

"deliveryLinkTel":

}

]

}

A.1.3POST請求調(diào)用

POST請求調(diào)用實(shí)例如下：

/API/deliverAccount?access_token=獲取token值

A.2報(bào)文格式實(shí)例

A.2.1文件頭

A.2.1.1文件頭實(shí)例

文件頭實(shí)例如下：

<sh:StandardBusinessDocumentHeader>

<sh:HeaderVersion>1.0</sh:HeaderVersion>

<sh:Deliver>

<sh:IdentifierAuthority="deliverAccount">914403007298823514</sh:Identifier>

</sh:Deliver>

<sh:Receiver>

<sh:IdentifierAuthority="deliverAccount">92440300FT0000558M</sh:Identifier>

</sh:Receiver>

<sh:DocumentIdentification>

<sh:Standard>deliverAccount</sh:Standard>

<sh:TypeVersion>2.3</sh:TypeVersion>

<sh:InstanceIdentifier>1047375-31804139714</sh:InstanceIdentifier>

<sh:Type>deliverAccount</sh:Type>

<sh:CreationDateAndTime>2020-11-10T16:34:12</sh:CreationDateAndTime>

</sh:DocumentIdentification>

</sh:StandardBusinessDocumentHeader>

A.2.1.2主要數(shù)據(jù)含義

文件頭實(shí)例主要數(shù)據(jù)含義如下：

a)“9144030072