DB4403-T 249-2022 進口冷鏈食品追溯數(shù)據(jù)接口規(guī)范

ICS35.240.01

CCSL78

DB4403

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

DB4403/T249—2022

進口冷鏈食品追溯數(shù)據(jù)接口規(guī)范

Datainterfacespecificationofimportedcold-chainfoodtraceability

2022-07-29發(fā)布2022-08-01實施

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

DB4403/T249—2022

進口冷鏈食品追溯數(shù)據(jù)接口規(guī)范

1范圍

本文件規(guī)定了進口冷鏈食品追溯系統(tǒng)數(shù)據(jù)接口的基本要求、接口類型、接口關(guān)系、接口描述。

本文件適用于企業(yè)、技術(shù)機構(gòu)、監(jiān)管部門在進口冷鏈食品追溯系統(tǒng)間的數(shù)據(jù)對接。

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

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

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

文件。

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時間表示法

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

GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則

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

IETFRFC2818TLS上的HTTP（HTTPoverTLS）

IETFRFC3548Base16，Base32，Base64數(shù)據(jù)編碼（TheBase16，Base32，andBase64data

encodings）

IETFRFC3629UTF-8，ISO10646轉(zhuǎn)換格式（UTF-8，atransformationformatofISO10646）

3術(shù)語和定義

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

3.1

冷鏈食品cold-chainfood

通過冷鏈實現(xiàn)物流過程運輸?shù)墓哳?、水產(chǎn)類、肉制品類、禽蛋類、乳制品、糧食類等易腐食品及

其加工制品等食品。

注：包括冷凍食品和冷藏食品。

3.2

追溯系統(tǒng)traceabilitysystem

基于追溯碼、文件記錄、相關(guān)軟硬件設(shè)備和通信網(wǎng)絡(luò)，實現(xiàn)現(xiàn)代信息化管理并可獲取產(chǎn)品追溯過程

中相關(guān)數(shù)據(jù)的集成。

[來源：GB/T38155—2019，2.6]

3.3

集中監(jiān)管倉centralizedsupervisionwarehouse

具備進口冷鏈食品（3.1）相關(guān)疫情集中排查、集中管控、集中處置和產(chǎn)品外包裝預(yù)防性消毒功能

的場所。

4縮略語

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

GS1：國際物品編碼協(xié)會（GlobalStandards1）

HTTPS：以安全為目標(biāo)的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：一種輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

UTF-8：一種可變長度字符編碼（8-bitUnicodeTransformationFormat）

1

DB4403/T249—2022

5基本要求

接口通過服務(wù)調(diào)用實現(xiàn)信息交換，應(yīng)符合下列要求：

——采用IETFRFC2818規(guī)定的HTTPS協(xié)議作為底層承載協(xié)議；

——采用IETFRFC3629規(guī)定的UTF-8字符集；

——采用GB/T7408規(guī)定的日期類型；

——采用IETFRFC3548規(guī)定的Base64編碼規(guī)則將圖片文件轉(zhuǎn)換為字符串；

——接口請求與接口響應(yīng)均采用JSON數(shù)據(jù)格式；

——建立接口日志記錄，能識別數(shù)據(jù)異常或追溯交換數(shù)據(jù)情況；

——發(fā)生錯誤時，通過接口將詳細的錯誤信息返回至相關(guān)平臺和節(jié)點系統(tǒng)，由相應(yīng)平臺和節(jié)點系

統(tǒng)對錯誤進行記錄分析和整改。

6接口類型

進口冷鏈食品追溯系統(tǒng)數(shù)據(jù)接口主要包括下列類型：

——主體信息類，包括但不限于主體信息類參數(shù)；

——產(chǎn)品信息類，包括但不限于產(chǎn)品品類信息、產(chǎn)品批次信息、入境貨物檢驗檢疫證明信息、海

關(guān)進口貨物報關(guān)單信息、消毒證明信息、核酸檢測證明信息、集中監(jiān)管倉出庫證明信息；

——冷庫信息類，包括但不限于冷庫信息類參數(shù)；

——追溯信息類，包括但不限于集中監(jiān)管倉信息、收發(fā)貨信息、出入庫信息、運輸信息。

7接口關(guān)系

進口冷鏈食品追溯系統(tǒng)數(shù)據(jù)接口關(guān)系如圖1所示。

圖1數(shù)據(jù)接口關(guān)系

8接口描述

8.1接口請求

2

DB4403/T249—2022

接口請求參數(shù)說明見表1。

表1接口請求參數(shù)

頭部參數(shù)含義類型說明

接口調(diào)用方唯一標(biāo)識，每個調(diào)用方會分配一個appid和一個

appid調(diào)用編碼字符型

appsecret

timestamp請求時間日期時間型時間戳

nonce隨機字符串字符型隨機串（不少于10位）

signature請求簽名字符型接口調(diào)用授權(quán)密鑰，SHA-256加密

8.2接口響應(yīng)

接口響應(yīng)參數(shù)說明見表2。

表2接口響應(yīng)參數(shù)

參數(shù)名含義類型說明

Success響應(yīng)結(jié)果字符型是否成功

Message響應(yīng)信息字符型提示信息

Code響應(yīng)編碼數(shù)字型接口響應(yīng)碼，見附錄A

Timestamp響應(yīng)時間日期時間型時間戳

Result響應(yīng)數(shù)據(jù)參數(shù)字符型接口以JSON格式返回參數(shù)值，見附錄B

8.3業(yè)務(wù)接口說明

8.3.1主體信息類接口說明

主體信息類參數(shù)見表3。

表3主體信息類參數(shù)

字段名含義類型說明

通過統(tǒng)一社會信用代碼獲取企業(yè)注冊

Ent_name企業(yè)名稱字符型

名稱

18位統(tǒng)一社會信用代碼，按照GB

Unif_soci_cred_code統(tǒng)一社會信用代碼字符型

32100確定的編碼規(guī)則

Contact聯(lián)系人字符型—

Contact_phone聯(lián)系電話字符型—

Legal_person法人代表字符型—

Office_address地址字符型—

Addr_districts所屬區(qū)劃字符型具體到省、市、區(qū)、街道

Ent_type_code企業(yè)類型字符型企業(yè)類型及編碼說明見附錄C

將圖片轉(zhuǎn)為Base64編碼格式存儲，具

Ent_img資質(zhì)證照字符型

體的資質(zhì)證照類型見附錄D

8.3.2產(chǎn)品信息類接口說明

3

DB4403/T249—2022

產(chǎn)品品類信息接口

產(chǎn)品品類信息參數(shù)見表4。

表4產(chǎn)品品類信息參數(shù)

字段名含義類型說明

商品條碼采用GS1編碼，應(yīng)符合GB

12904中商品條碼的編碼規(guī)則；產(chǎn)品編

Product_library_id商品條碼/產(chǎn)品編碼字符型碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，

編碼規(guī)則應(yīng)按照DB4403/T191—2021

中第6章規(guī)定的編碼方案

Product_name產(chǎn)品名稱字符型實物產(chǎn)品標(biāo)簽上的產(chǎn)品名稱

追溯系統(tǒng)二級分類代碼，產(chǎn)品分類及

Product_category產(chǎn)品類型字符型

編碼見附錄E

Country原產(chǎn)國字符型產(chǎn)品輸出國家

Life_number保質(zhì)期限數(shù)字型—

Life_unit保質(zhì)期單位字符型保質(zhì)期以年、月或日為單位

Specification規(guī)格數(shù)字型—

Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）

Registration_number生產(chǎn)企業(yè)注冊號字符型產(chǎn)品原產(chǎn)國生產(chǎn)企業(yè)注冊號

Manufacturer生產(chǎn)企業(yè)名稱字符型產(chǎn)品原產(chǎn)國生產(chǎn)企業(yè)名稱

Product_label產(chǎn)品標(biāo)簽圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

Product_img產(chǎn)品圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

產(chǎn)品批次信息接口

產(chǎn)品批次信息參數(shù)說明見表5，產(chǎn)品批次對應(yīng)的入境貨物檢驗檢疫證明信息說明、海關(guān)進口貨物報

關(guān)單信息說明、消毒證明信息說明、核酸檢測證明信息說明、集中監(jiān)管倉出庫證明信息說明分別見表6、

表7、表8、表9、表10。

表5產(chǎn)品批次信息參數(shù)

字段名含義類型說明

商品條碼采用GS1編碼，應(yīng)符合GB

12904中商品條碼的編碼規(guī)則；產(chǎn)品編

Product_library_id商品條碼/產(chǎn)品編碼字符型碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，

編碼規(guī)則應(yīng)按照DB4403/T191—2021

中第6章規(guī)定的編碼方案

Product_name產(chǎn)品名稱字符型實物產(chǎn)品標(biāo)簽上的產(chǎn)品名稱

Container_number貨柜編號字符型裝載該批貨物的貨柜編號

編碼規(guī)則應(yīng)按照DB4403/T191—2021

Trace_code批次追溯碼字符型

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

Batch實際批次字符型實物產(chǎn)品標(biāo)簽上的生產(chǎn)批號

Number_of_pieces首次入庫件數(shù)數(shù)字型—

Weight首次入庫重量字符型單位為千克（kg）

Inventory_pieces庫存件數(shù)數(shù)字型可發(fā)貨件數(shù)

Production_date生產(chǎn)日期日期時間型格式為YYYY-MM-DD

4

DB4403/T249—2022

表5產(chǎn)品批次信息參數(shù)（續(xù)）

字段名含義類型說明

可發(fā)貨件數(shù)重量總和，單位為千克

Inventory_weight庫存重量字符型

（kg）

Storage_name存放冷庫名稱字符型—

表6入境貨物檢驗檢疫證明信息

字段名含義類型說明

Batch批次字符型入境貨物檢驗檢疫證明生產(chǎn)批號

進口冷鏈食品國際貿(mào)易中從境外發(fā)貨

Consignee收貨人字符型

人處接收貨物并承擔(dān)相應(yīng)責(zé)任的組織

進口冷鏈食品國際貿(mào)易中向國內(nèi)收貨

Consignor發(fā)貨人字符型

方提供產(chǎn)品的境外組織

Date_ofentry入境日期日期時間型格式為YYYY-MM-DD

Port_of_entry入境口岸字符型—

Quarantine_number入境貨物檢驗檢疫證明編號數(shù)字型15、18或21位數(shù)字編碼

Quarantine_img入境貨物檢驗檢疫證明圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

表7海關(guān)進口貨物報關(guān)單信息

字段名含義類型說明

消費使用單位為已知的進口貨物在境

Consumer_enterprises消費使用單位字符型內(nèi)的最終消費、使用單位的名稱或委托

進出口企業(yè)進口貨物的單位

Customs_number海關(guān)編號數(shù)字型報關(guān)單上的海關(guān)編號

Waybill_number提運單號字符型進出口貨物提單或運單的編號

Consumer_img報關(guān)單圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

表8消毒證明信息

字段名含義類型說明

Disinfect_date消毒日期日期時間型格式為YYYY-MM-DD

Place_of_disinfection消毒實施地字符型分為市場、冷庫、海關(guān)口岸和其他

Disinfect_number消毒編號字符型消毒證明唯一標(biāo)識

消毒狀態(tài)為已消毒和未消毒，1代表已

Disinfect_state消毒狀態(tài)字符型

消毒，0代表未消毒

Disinfect_img消毒證明圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

表9核酸檢測證明信息

字段名含義類型說明

Na_result核酸檢測結(jié)果字符型陰性或陽性

5

DB4403/T249—2022

表9核酸檢測證明信息（續(xù)）

字段名含義類型說明

Na_date核酸檢測日期日期時間型格式為YYYY-MM-DD

Na_unit核酸檢測單位字符型實施核酸檢測的單位名稱

Verify_mode檢驗?zāi)Ｊ阶址秃怂釞z測覆蓋或企業(yè)自行委托

Na_img核酸檢測證明圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

表10集中監(jiān)管倉出庫證明信息

字段名含義類型說明

Certificate_number集中監(jiān)管倉出庫證明編號數(shù)字型數(shù)字編碼

Certificate_date出庫證明日期日期時間型格式為YYYY-MM-DD

Certificate_img集中監(jiān)管倉出庫證明圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

8.3.3冷庫信息類接口說明

冷庫信息類參數(shù)見表11。

表11冷庫信息類參數(shù)

字段名含義類型說明

18位統(tǒng)一社會信用代碼，按照GB

Unif_soci_cred_code統(tǒng)一社會信用代碼字符型

32100確定的編碼規(guī)則

該冷庫在本市唯一備案編號，外地冷

Code編號字符型

庫可以為空

Name名稱字符型—

Address地址字符型—

Addr_districts所屬區(qū)劃字符型具體到省、市、區(qū)、街道

Usablearea可用面積字符型單位為平方米

Storage_variety貯存種類字符型—

Inventory庫存量字符型單位為噸

Contact聯(lián)系人字符型—

Contact_phone聯(lián)系電話字符型—

冷庫類型分為自營自用、第三方、集

Type類型字符型

中倉三種類型

8.3.4追溯信息類接口說明

集中監(jiān)管倉信息接口

集中監(jiān)管倉信息參數(shù)見表12。

表12集中監(jiān)管倉信息參數(shù)

字段名含義類型說明

Container_number貨柜編號字符型裝載該批貨物的貨柜編號

6

DB4403/T249—2022

表12集中監(jiān)管倉信息參數(shù)（續(xù)）

字段名含義類型說明

Customs_img報關(guān)單圖片地址字符型圖片以URL形式展示

Customs_number海關(guān)編號字符型也稱報關(guān)單號，報關(guān)單上的海關(guān)編號

Nucleic_result抽樣核酸檢測結(jié)果字符型陰性

Specification規(guī)格數(shù)字型—

Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）

Pieces件數(shù)數(shù)字型—

Dataid推送數(shù)據(jù)編碼字符型對推送數(shù)據(jù)分配的唯一標(biāo)識

Nucleic_number核酸編號字符型—

Cold_name冷庫名稱字符型—

Production_batch生產(chǎn)批號字符型—

18位統(tǒng)一社會信用代碼，按照GB

Unif_soci_cred_code統(tǒng)一社會信用代碼字符型

32100確定的編碼規(guī)則

Brand品名字符型—

Nucleic_item核酸項目字符型外包裝、內(nèi)包裝、物品表面

Certificate_date出庫證明日期日期時間型格式為YYYY-MM-DD

Disinfect_data消毒日期日期時間型格式為YYYY-MM-DD

Placeorigin原產(chǎn)國字符型產(chǎn)品輸出國家

Instockno入庫單號字符型—

Disinfect_result消毒結(jié)果字符型已消毒或未消毒

Shipper_name貨主名稱字符型—

Product_number商品編號數(shù)字型—

Certificate_number出庫證明編號數(shù)字型—

Gross_weight毛重字符型單位為千克（kg）

Nucleic_data核酸檢測日期日期時間型格式為YYYY-MM-DD

Goods_flow商品流向字符型—

Certificate_img監(jiān)管倉出庫證明圖片字符型將圖片轉(zhuǎn)為Base64編碼格式存儲

發(fā)貨信息接口說明

發(fā)貨信息參數(shù)見表13。同一個發(fā)貨單號可對應(yīng)多個發(fā)貨產(chǎn)品，發(fā)貨產(chǎn)品詳情見表14。

表13發(fā)貨信息參數(shù)

字段名含義類型說明

Send_number發(fā)貨單號字符型系統(tǒng)自動分配的唯一標(biāo)識

Send_time發(fā)貨日期日期時間型格式為YYYY-MM-DD

Receiver_ent_name客戶名稱字符型—

Receive_contact收貨方聯(lián)系人字符型—

Receive_contact_phone收貨方聯(lián)系電話字符型—

Receive_address收貨地址字符型—

7

DB4403/T249—2022

表13發(fā)貨信息參數(shù)（續(xù)）

字段名含義類型說明

Product_list發(fā)貨產(chǎn)品詳情數(shù)組型發(fā)貨產(chǎn)品信息，可為多個產(chǎn)品，見表14

表14發(fā)貨產(chǎn)品詳情

字段名含義類型說明

該冷庫在本市唯一備案編號，外地冷庫

storage_number冷庫編號字符型

可以為空

storage_name冷庫名稱字符型—

商品條碼采用GS1編碼，應(yīng)符合GB

12904中商品條碼的編碼規(guī)則；產(chǎn)品編

product_library_id商品條碼/商品編碼字符型碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，編

碼規(guī)則應(yīng)按照DB4403/T191—2021中

第6章規(guī)定的編碼方案

product_name產(chǎn)品名稱字符型實物產(chǎn)品標(biāo)簽上的產(chǎn)品名稱

batch實際批次字符型實物產(chǎn)品標(biāo)簽上的生產(chǎn)批號

production_date生產(chǎn)日期日期時間型格式為YYYY-MM-DD

number_of_pieces件數(shù)數(shù)字型—

specification規(guī)格數(shù)字型—

Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）

weight凈重字符型單位為千克（kg）

container_number貨柜編號字符型裝載該批貨物的貨柜編號

收貨信息接口說明

收貨信息參數(shù)見表15。

表15收貨信息參數(shù)

字段名含義類型說明

Receiver_number收貨單號字符型系統(tǒng)自動分配的唯一標(biāo)識

Send_time發(fā)貨日期日期時間型格式為YYYY-MM-DD

Receive_time收貨日期日期時間型格式為YYYY-MM-DD

Send_ent_name發(fā)貨方名稱字符型—

Send_contact發(fā)貨方聯(lián)系人字符型—

Send_contact_phone發(fā)貨方聯(lián)系電話字符型—

收貨產(chǎn)品信息，可為多個產(chǎn)品，與上游

Product_list收貨產(chǎn)品詳情數(shù)組型

發(fā)貨產(chǎn)品信息一致，見表14

入庫信息接口說明

冷庫入庫信息參數(shù)見表16。同一個入庫單號可對應(yīng)多個入庫產(chǎn)品，入庫產(chǎn)品詳情見表17。

8

DB4403/T249—2022

表16入庫信息參數(shù)

字段名含義類型說明

In_stock_code入庫碼字符型系統(tǒng)自動分配的唯一標(biāo)識

In_stock_date入庫時間日期時間型格式為YYYY-MM-DD

Send_contact貨主聯(lián)系人字符型—

Send_ent_name貨主名稱字符型—

Send_contact_phone貨主聯(lián)系電話字符型—

Product_list入庫產(chǎn)品詳情數(shù)組型入庫產(chǎn)品信息，見表17

表17入庫產(chǎn)品詳情

字段名含義類型說明

商品條碼采用GS1編碼，應(yīng)符合GB

12904中商品條碼的編碼規(guī)則；產(chǎn)品

product_library_id商品條碼/商品編碼字符型編碼為系統(tǒng)自動生成的產(chǎn)品品類編

碼，編碼規(guī)則應(yīng)按照DB4403/T191—

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

product_name產(chǎn)品名稱字符型實物產(chǎn)品標(biāo)簽上產(chǎn)品名稱

batch實際批次字符型實物產(chǎn)品標(biāo)簽上的生產(chǎn)批號

production_date生產(chǎn)日期日期時間型格式為YYYY-MM-DD

number_of_pieces實際入庫件數(shù)數(shù)字型—

specification規(guī)格數(shù)字型—

Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）

weight凈重字符型單位為千克（kg）

container_number貨柜編號字符型裝載該批貨物的貨柜編號

出庫信息接口說明

冷庫出庫信息參數(shù)見表18。同一個出庫單號可對應(yīng)多個出庫產(chǎn)品，出庫產(chǎn)品詳情見表19。

表18出庫信息參數(shù)

字段名含義類型說明

Outstock_code出庫碼字符型系統(tǒng)自動分配的唯一標(biāo)識

Out_stock_date出庫時間日期時間型格式為YYYY-MM-DD

Send_ent_name貨主名稱字符型—

Send_contact貨主聯(lián)系人字符型—

Send_contact_phone貨主聯(lián)系電話字符型—

Receiver_ent_name收貨方名稱字符型—

Receive_contact收貨方聯(lián)系人字符型—

該冷庫在本市唯一備案編號，外地冷

Out_stock_storage_number出庫存冷庫編號字符型

庫可以為空

Receive_contact_phone收貨方聯(lián)系電話字符型—

Out_stock_storage_name出庫存冷庫名稱字符型—

9

DB4403/T249—2022

表18出庫信息參數(shù)（續(xù)）

字段名含義類型說明

Product_list出庫產(chǎn)品詳情數(shù)組型出庫產(chǎn)品信息，見表19

表19出庫產(chǎn)品詳情

字段名含義類型說明

商品條碼采用GS1編碼，應(yīng)符合GB

12904中商品條碼的編碼規(guī)則；產(chǎn)品編

product_library_id商品條碼/商品編碼字符型碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，編

碼規(guī)則應(yīng)按照DB4403/T191—2021中

第6章規(guī)定的編碼方案

product_name產(chǎn)品名稱字符型實物產(chǎn)品標(biāo)簽上產(chǎn)品名稱

batch實際批次字符型實物產(chǎn)品標(biāo)簽上的生產(chǎn)批號

production_date生產(chǎn)日期日期時間型格式為YYYY-MM-DD

number_of_pieces實際出庫件數(shù)數(shù)字型—

specification規(guī)格數(shù)字型—

Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）

weight凈重字符型單位為千克（kg）

運輸車輛信息接口說明

運輸車輛信息參數(shù)見表20。

表20運輸車輛信息參數(shù)

字段名含義類型說明

Licenseplate車牌字符型—

Driver_name司機姓名字符型—

Driver_contact_phone司機聯(lián)系電話字符型—

10