ICS35.240.01CCSL78DB4403深圳市市場監(jiān)督管理局發(fā)布IDB4403/T249—2022前言 12規(guī)范性引用文件 13術(shù)語和定義 14縮略語 15基本要求 26接口類型 27接口關(guān)系 28接口描述 2附錄A（資料性）接口響應(yīng)碼說明 附錄B（資料性）追溯數(shù)據(jù)對接實(shí)例 附錄C（資料性）企業(yè)類型及編碼說明 附錄D（資料性）資質(zhì)證照類型及編碼 附錄E（資料性）產(chǎn)品分類及編碼 參考文獻(xiàn) DB4403/T249—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由深圳市市場監(jiān)督管理局提出并歸口。本文件起草單位：深圳市市場監(jiān)督管理局、深圳市標(biāo)準(zhǔn)技術(shù)研究院。本文件主要起草人：李穎、徐立峰、練曉、呂愷文、王恒、蘇巍、陳瑜、周哲、陳煒霖、陳利平、施偉、林智明。DB4403/T249—20221進(jìn)口冷鏈?zhǔn)称纷匪輸?shù)據(jù)接口規(guī)范本文件規(guī)定了進(jìn)口冷鏈?zhǔn)称纷匪菹到y(tǒng)數(shù)據(jù)接口的基本要求、接口類型、接口關(guān)系、接口描述。本文件適用于企業(yè)、技術(shù)機(jī)構(gòu)、監(jiān)管部門在進(jìn)口冷鏈?zhǔn)称纷匪菹到y(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，andBase64dataencodings）IETFRFC3629UTF-8，ISO10646轉(zhuǎn)換格式（UTF-8，atransformationformatofISO10646）3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1冷鏈?zhǔn)称穋old-chainfood通過冷鏈實(shí)現(xiàn)物流過程運(yùn)輸?shù)墓哳悺⑺a(chǎn)類、肉制品類、禽蛋類、乳制品、糧食類等易腐食品及其加工制品等食品。3.2追溯系統(tǒng)traceabilitysystem基于追溯碼、文件記錄、相關(guān)軟硬件設(shè)備和通信網(wǎng)絡(luò)，實(shí)現(xiàn)現(xiàn)代信息化管理并可獲取產(chǎn)品追溯過程中相關(guān)數(shù)據(jù)的集成。[來源：GB/T38155—2019，2.6]3.3集中監(jiān)管倉centralizedsupervisionwarehouse具備進(jìn)口冷鏈?zhǔn)称罚?.1）相關(guān)疫情集中排查、集中管控、集中處置和產(chǎn)品外包裝預(yù)防性消毒功能的場所。4縮略語下列縮略語適用于本文件。GS1：國際物品編碼協(xié)會（GlobalStandards1）HTTPS：以安全為目標(biāo)的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一種輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）UTF-8：一種可變長度字符編碼（8-bitUnicodeTransformationFormat）DB4403/T249—202225基本要求接口通過服務(wù)調(diào)用實(shí)現(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ù)異?；蜃匪萁粨Q數(shù)據(jù)情況；——發(fā)生錯誤時，通過接口將詳細(xì)的錯誤信息返回至相關(guān)平臺和節(jié)點(diǎn)系統(tǒng)，由相應(yīng)平臺和節(jié)點(diǎn)系統(tǒng)對錯誤進(jìn)行記錄分析和整改。6接口類型進(jìn)口冷鏈?zhǔn)称纷匪菹到y(tǒng)數(shù)據(jù)接口主要包括下列類型：——主體信息類，包括但不限于主體信息類參數(shù)；——產(chǎn)品信息類，包括但不限于產(chǎn)品品類信息、產(chǎn)品批次信息、入境貨物檢驗檢疫證明信息、海關(guān)進(jìn)口貨物報關(guān)單信息、消毒證明信息、核酸檢測證明信息、集中監(jiān)管倉出庫證明信息；——冷庫信息類，包括但不限于冷庫信息類參數(shù)；——追溯信息類，包括但不限于集中監(jiān)管倉信息、收發(fā)貨信息、出入庫信息、運(yùn)輸信息。7接口關(guān)系進(jìn)口冷鏈?zhǔn)称纷匪菹到y(tǒng)數(shù)據(jù)接口關(guān)系如圖1所示。圖1數(shù)據(jù)接口關(guān)系8接口描述8.1接口請求DB4403/T249—20223接口請求參數(shù)說明見表1。表1接口請求參數(shù)接口調(diào)用方唯一標(biāo)識，每個調(diào)用方會分配一個appid和一個8.2接口響應(yīng)接口響應(yīng)參數(shù)說明見表2。表2接口響應(yīng)參數(shù)接口以JSON格式返回參數(shù)值，見附錄B8.3業(yè)務(wù)接口說明8.3.1主體信息類接口說明主體信息類參數(shù)見表3。表3主體信息類參數(shù)通過統(tǒng)一社會信用代碼獲取企業(yè)注冊18位統(tǒng)一社會信用代碼，按照GB———8.3.2產(chǎn)品信息類接口說明DB4403/T249—20224產(chǎn)品品類信息接口產(chǎn)品品類信息參數(shù)見表4。表4產(chǎn)品品類信息參數(shù)商品條碼采用GS1編碼，應(yīng)符合GB碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，追溯系統(tǒng)二級分類代碼，產(chǎn)品分類及——將圖片轉(zhuǎn)為Base64編碼格式存儲將圖片轉(zhuǎn)為Base64編碼格式存儲產(chǎn)品批次信息接口產(chǎn)品批次信息參數(shù)說明見表5，產(chǎn)品批次對應(yīng)的入境貨物檢驗檢疫證明信息說明、海關(guān)進(jìn)口貨物報關(guān)單信息說明、消毒證明信息說明、核酸檢測證明信息說明、集中監(jiān)管倉出庫證明信息說明分別見表6、表7、表8、表9、表10。表5產(chǎn)品批次信息參數(shù)碼為系統(tǒng)自動生成的產(chǎn)品品類編碼，—DB4403/T249—20225表5產(chǎn)品批次信息參數(shù)（續(xù)）可發(fā)貨件數(shù)重量總和，單位為千克—表6入境貨物檢驗檢疫證明信息進(jìn)口冷鏈?zhǔn)称穱H貿(mào)易中從境外發(fā)貨進(jìn)口冷鏈?zhǔn)称穱H貿(mào)易中向國內(nèi)收貨將圖片轉(zhuǎn)為Base64編碼格式存儲表7海關(guān)進(jìn)口貨物報關(guān)單信息消費(fèi)使用單位為已知的進(jìn)口貨物在境表8消毒證明信息將圖片轉(zhuǎn)為Base64編碼格式存儲表9核酸檢測證明信息DB4403/T249—20226表9核酸檢測證明信息（續(xù)）將圖片轉(zhuǎn)為Base64編碼格式存儲表10集中監(jiān)管倉出庫證明信息將圖片轉(zhuǎn)為Base64編碼格式存儲8.3.3冷庫信息類接口說明冷庫信息類參數(shù)見表11。表11冷庫信息類參數(shù)18位統(tǒng)一社會信用代碼，按照GB該冷庫在本市唯一備案編號，外地冷—————冷庫類型分為自營自用、第三方、集8.3.4追溯信息類接口說明集中監(jiān)管倉信息接口集中監(jiān)管倉信息參數(shù)見表12。表12集中監(jiān)管倉信息參數(shù)DB4403/T249—20227表12集中監(jiān)管倉信息參數(shù)（續(xù)）—————18位統(tǒng)一社會信用代碼，按照GB—————將圖片轉(zhuǎn)為Base64編碼格式存儲發(fā)貨信息接口說明發(fā)貨信息參數(shù)見表13。同一個發(fā)貨單號可對應(yīng)多個發(fā)貨產(chǎn)品，發(fā)貨產(chǎn)品詳情見表14。表13發(fā)貨信息參數(shù)———DB4403/T249—20228表13發(fā)貨信息參數(shù)（續(xù)）表14發(fā)貨產(chǎn)品詳情商品條碼采用GS1編碼，應(yīng)符合GB——weight收貨信息接口說明收貨信息參數(shù)見表15。表15收貨信息參數(shù)———入庫信息接口說明冷庫入庫信息參數(shù)見表16。同一個入庫單號可對應(yīng)多個入庫產(chǎn)品，入庫產(chǎn)品詳情見表17。DB4403/T249—20229表16入庫信息參數(shù)——表17入庫產(chǎn)品詳情——weight出庫信息接口說明冷庫出庫信息參數(shù)見表18。同一個出庫單號可對應(yīng)多個出庫產(chǎn)品，出庫產(chǎn)品詳情見表19。表18出庫信息參數(shù)————該冷庫在本市唯一備案編號，外地冷——DB4403/T249—2022表18出庫信息參數(shù)（續(xù)）表19出庫產(chǎn)品詳情商品條碼采用GS1編碼，應(yīng)符合GB—weight運(yùn)輸車輛信息接口說明運(yùn)輸車輛信息參數(shù)見表20。表20運(yùn)輸車輛信息參數(shù)——DB4403/T249—2022（資料性）接口響應(yīng)碼說明接口響應(yīng)碼見表A.1。表A.1接口響應(yīng)碼及狀態(tài)說明DB4403/T249—2022（資料性）追溯數(shù)據(jù)對接實(shí)例下面以產(chǎn)品批次信息接口為例演示接口JSON實(shí)例。{"success":true,"result":{"productLibraryId":"17896448006462","productName":"冷凍雞兩節(jié)翅","containerNo":"MNBU3167382","parentTraceCode":"0117896448006462101138885683196","traceCode":"0117896448006462101138896901150","weight":13500.00,"productionDate":"2021-02-08","inventory":501,"inventoryWeight":7515.00,"StorageName":深圳市龍崗區(qū)同城食品配送行,"quarantineInfo":{"batch":"BY9066","consignee":"深圳業(yè)俊貿(mào)易有限公司","consignor":"COOPAVELCOOPERATTVAAGROINDUSTRIAL","dateOfentry":"2021-07-16","portOfEntry":"鹽田","quarantineNumber":"531620211160071009001","Quarantineimg":"data:image/jpg;Base64+Base64轉(zhuǎn)換碼",}"customsInfo":{"consumerEnterprises":"深圳市業(yè)俊貿(mào)易有限公司","customsNo":"531620211160071009","waybillNumber":"608370090","Consumerimg":"data:image/jpg;Base64+Base64轉(zhuǎn)換碼",}"disinfectInfo":{"disinfectDate":"2021-07-18","placeOfDisinfection":"CustomsPort","disinfectNumber":"HL20210718YL1","disinfectState":1,"Disinfectimg":"data:image/jpg;Base64+Base64轉(zhuǎn)換碼",}"nucleicInfo":{"naResult":"陰性","naDate":"2021-07-18","naUnit":"廣州市賽泰特醫(yī)學(xué)檢驗實(shí)驗室","verifyMode":"SelfCheck","Disinfectimg":"data:image/jpg;Base64+Base64轉(zhuǎn)換碼",}}DB4403/T249—2022（資料性）企業(yè)類型及編碼說明企業(yè)類型及編碼見表C.1。表C.1企業(yè)類型及編碼DB4403/T249—2022（資料性）資質(zhì)證照類型及編碼資質(zhì)證照類型及編碼見表D.1。表D.1資質(zhì)證照類型及編碼DB4403/T249—2022（資料性）產(chǎn)品分類及編碼產(chǎn)品分類及編碼見表E.1。表E.1產(chǎn)品分類及編碼DB4403/T249—2022表E.1產(chǎn)品分類及編碼（續(xù)）DB4403/T249—2022參考文獻(xiàn)[1]GB/T18391.1—2009信息技術(shù)元數(shù)據(jù)注冊系統(tǒng)（MDR）第1部分：框架[2]GB/T38155—2019重要產(chǎn)品追溯追溯術(shù)語[3]IETFRFC1421Internet電子郵件的隱私增強(qiáng)：第