DB4403-T 249-2022進口冷鏈食品追溯數據接口規(guī)范-（高清版）

ICS35.240.01CCSL78

DB4403深 圳 市 地 方 標 準DB4403/T249—2022進口冷鏈食品追溯數據接口規(guī)范Datainterfacespecificationofimportedcold-chainfoodtraceability2022-07-292022-07-292022-08-01深圳市市場監(jiān)督管理局發(fā)布DB4403/T249—2022DB4403/T249—2022DB4403/T249—2022DB4403/T249—2022目 次前言 II范圍 1規(guī)范性引用文件 1術語和定義 1縮略語 1基本要求 2接口類型 2接口關系 2接口描述 2附錄A（資料性）接口響應碼說明 11附錄B（資料性）追溯數據對接實例 12附錄C（資料性）企業(yè)類型及編碼說明 13附錄E（資料性）產品分類及編碼 15參考文獻 附錄E（資料性）產品分類及編碼 15參考文獻 17I前 言GB/T1.1—20201請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由深圳市市場監(jiān)督管理局提出并歸口。本文件起草單位：深圳市市場監(jiān)督管理局、深圳市標準技術研究院。本文件主要起草人：李穎、徐立峰、練曉、呂愷文、王恒、蘇巍、陳瑜、周哲、陳煒霖、陳利平、施偉、林智明。IIII進口冷鏈食品追溯數據接口規(guī)范范圍本文件規(guī)定了進口冷鏈食品追溯系統(tǒng)數據接口的基本要求、接口類型、接口關系、接口描述。本文件適用于企業(yè)、技術機構、監(jiān)管部門在進口冷鏈食品追溯系統(tǒng)間的數據對接。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T7408數據元和交換格式信息交換日期和時間表示法GB12904商品條碼零售商品編碼與條碼表示GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則DB4403/T191—2021食用農產品追溯碼編碼技術規(guī)范IETFRFC2818TLSHTTP（HTTPoverTLS）IETFRFC3548Base16，Base32，Base64數據編碼（TheBase16，Base32，andBase64dataencodings）IETFRFC3629UTF-8，ISO10646（UTF-8，atransformationformatofISO10646）術語和定義下列術語和定義適用于本文件。3.1冷鏈食品cold-chainfood通過冷鏈實現物流過程運輸的果蔬類、水產類、肉制品類、禽蛋類、乳制品、糧食類等易腐食品及其加工制品等食品。注：包括冷凍食品和冷藏食品。3.2追溯系統(tǒng)traceabilitysystem基于追溯碼、文件記錄、相關軟硬件設備和通信網絡，實現現代信息化管理并可獲取產品追溯過程中相關數據的集成。[來源：GB/T38155—2019，2.6]3.3集中監(jiān)管倉centralizedsupervisionwarehouse具備進口冷鏈食品（3.1）相關疫情集中排查、集中管控、集中處置和產品外包裝預防性消毒功能的場所?？s略語下列縮略語適用于本文件。GS1：國際物品編碼協(xié)會（GlobalStandards1）HTTPS：以安全為目標的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一種輕量級的數據交換格式（JavaScriptObjectNotation）UTF-8：一種可變長度字符編碼（8-bitUnicodeTransformationFormat）1基本要求接口通過服務調用實現信息交換，應符合下列要求：——采用IETFRFC2818規(guī)定的HTTPS協(xié)議作為底層承載協(xié)議；——采用IETFRFC3629規(guī)定的UTF-8字符集；——采用GB/T7408規(guī)定的日期類型；——采用IETFRFC3548規(guī)定的Base64編碼規(guī)則將圖片文件轉換為字符串；——接口請求與接口響應均采用JSON數據格式；——建立接口日志記錄，能識別數據異?；蜃匪萁粨Q數據情況；——接口類型進口冷鏈食品追溯系統(tǒng)數據接口主要包括下列類型：——主體信息類，包括但不限于主體信息類參數；——產品信息類，包括但不限于產品品類信息、產品批次信息、入境貨物檢驗檢疫證明信息、海關進口貨物報關單信息、消毒證明信息、核酸檢測證明信息、集中監(jiān)管倉出庫證明信息；——冷庫信息類，包括但不限于冷庫信息類參數；——追溯信息類，包括但不限于集中監(jiān)管倉信息、收發(fā)貨信息、出入庫信息、運輸信息。接口關系進口冷鏈食品追溯系統(tǒng)數據接口關系如圖1所示。進口冷鏈食品追溯系統(tǒng)數據接口關系如圖1所示。圖1數據接口關系接口描述接口請求2業(yè)務接口說明主體信息類接口說明業(yè)務接口說明主體信息類接口說明主體信息類參數見表3。表3主體信息類參數8.3.2產品信息類接口說明3接口請求參數說明見表1。表1接口請求參數頭部參數含義類型說明appid調用編碼字符型接口調用方唯一標識，每個調用方會分配一個appid和一個appsecrettimestamp請求時間日期時間型時間戳nonce隨機字符串字符型隨機串（不少于10位）signature請求簽名字符型接口調用授權密鑰，SHA-256加密8.2接口響應接口響應參數說明見表2。表2接口響應參數參數名含義類型說明Success響應結果字符型是否成功Message響應信息字符型提示信息Code響應編碼數字型接口響應碼，見附錄ATimestamp響應時間日期時間型時間戳Result響應數據參數字符型接口以JSON格式返回參數值，見附錄B字段名含義類型說明Ent_name企業(yè)名稱字符型通過統(tǒng)一社會信用代碼獲取企業(yè)注冊名稱Unif_soci_cred_code統(tǒng)一社會信用代碼字符型18位統(tǒng)一社會信用代碼，按照GB32100確定的編碼規(guī)則Contact聯系人字符型—Contact_phone聯系電話字符型—Legal_person法人代表字符型—Office_address地址字符型—Addr_districts所屬區(qū)劃字符型具體到省、市、區(qū)、街道Ent_type_code企業(yè)類型字符型企業(yè)類型及編碼說明見附錄CEnt_img資質證照字符型Base64D產品批次信息接口產品批次信息參數說明見表5，產品批次對應的入境貨物檢驗檢疫證明信息說明、海關進口貨物報產品批次信息接口產品批次信息參數說明見表5，產品批次對應的入境貨物檢驗檢疫證明信息說明、海關進口貨物報6、表7、表8、表9、表10。5產品批次信息參數產品品類信息接口產品品類信息參數見表4。表4產品品類信息參數字段名含義類型說明Product_library_id商品條碼/產品編碼字符型商品條碼采用GS112904碼為系統(tǒng)自動生成的產品品類編碼，DB4403/T191—2021中第6章規(guī)定的編碼方案Product_name產品名稱字符型實物產品標簽上的產品名稱Product_category產品類型字符型追溯系統(tǒng)二級分類代碼，產品分類及編碼見附錄ECountry原產國字符型產品輸出國家Life_number保質期限數字型—Life_unit保質期單位字符型保質期以年、月或日為單位Specification規(guī)格數字型—Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）Registration_number生產企業(yè)注冊號字符型產品原產國生產企業(yè)注冊號Manufacturer生產企業(yè)名稱字符型產品原產國生產企業(yè)名稱Product_label產品標簽圖片字符型將圖片轉為Base64編碼格式存儲Product_img產品圖片字符型將圖片轉為Base64編碼格式存儲字段名含義類型說明Product_library_id商品條碼/產品編碼字符型商品條碼采用GS1編碼，應符合GB12904碼為系統(tǒng)自動生成的產品品類編碼，編碼規(guī)則應按照DB4403/T191—2021中第6章規(guī)定的編碼方案Product_name產品名稱字符型實物產品標簽上的產品名稱Container_number貨柜編號字符型裝載該批貨物的貨柜編號Trace_code批次追溯碼字符型編碼規(guī)則應按照DB4403/T191—2021中第6章規(guī)定的追溯碼編碼方案Batch實際批次字符型實物產品標簽上的生產批號Number_of_pieces首次入庫件數數字型—Weight首次入庫重量字符型單位為千克（kg）Inventory_pieces庫存件數數字型可發(fā)貨件數Production_date生產日期日期時間型格式為YYYY-MM-DD表8消毒證明信息表8消毒證明信息表9核酸檢測證明信息5表5產品批次信息參數（續(xù)）字段名含義類型說明Inventory_weight庫存重量字符型可發(fā)貨件數重量總和，單位為千克（kg）Storage_name存放冷庫名稱字符型—表6入境貨物檢驗檢疫證明信息字段名含義類型說明Batch批次字符型入境貨物檢驗檢疫證明生產批號Consignee收貨人字符型進口冷鏈食品國際貿易中從境外發(fā)貨人處接收貨物并承擔相應責任的組織Consignor發(fā)貨人字符型進口冷鏈食品國際貿易中向國內收貨方提供產品的境外組織Date_ofentry入境日期日期時間型格式為YYYY-MM-DDPort_of_entry入境口岸字符型—Quarantine_number入境貨物檢驗檢疫證明編號數字型15、18或21位數字編碼Quarantine_img入境貨物檢驗檢疫證明圖片字符型將圖片轉為Base64編碼格式存儲表7海關進口貨物報關單信息字段名含義類型說明Consumer_enterprises消費使用單位字符型消費使用單位為已知的進口貨物在境進出口企業(yè)進口貨物的單位Customs_number海關編號數字型報關單上的海關編號Waybill_number提運單號字符型進出口貨物提單或運單的編號Consumer_img報關單圖片字符型將圖片轉為Base64編碼格式存儲字段名含義類型說明Disinfect_date消毒日期日期時間型格式為YYYY-MM-DDPlace_of_disinfection消毒實施地字符型分為市場、冷庫、海關口岸和其他Disinfect_number消毒編號字符型消毒證明唯一標識Disinfect_state消毒狀態(tài)字符型消毒狀態(tài)為已消毒和未消毒，1消毒，0Disinfect_img消毒證明圖片字符型將圖片轉為Base64編碼格式存儲字段名含義類型說明Na_result核酸檢測結果字符型陰性或陽性表9核酸檢測證明信息（續(xù)）字段名含義類型說明Na_date核酸檢測日期日期時間型格式為YYYY-MM-DDNa_unit核酸檢測單位字符型實施核酸檢測的單位名稱Verify_mode檢驗模式字符型核酸檢測覆蓋或企業(yè)自行委托Na_img核酸檢測證明圖片字符型將圖片轉為Base64編碼格式存儲表10集中監(jiān)管倉出庫證明信息字段名含義類型說明Certificate_number集中監(jiān)管倉出庫證明編號數字型數字編碼Certificate_date出庫證明日期日期時間型格式為YYYY-MM-DDCertificate_img集中監(jiān)管倉出庫證明圖片字符型將圖片轉為Base64編碼格式存儲冷庫信息類接口說明冷庫信息類參數見表11。

表11冷庫信息類參數字段名含義類型說明Unif_soci_cred_code統(tǒng)一社會信用代碼字符型18位統(tǒng)一社會信用代碼，按照GB32100確定的編碼規(guī)則Code編號字符型該冷庫在本市唯一備案編號，外地冷庫可以為空Name名稱字符型—Address地址字符型—Addr_districts所屬區(qū)劃字符型具體到省、市、區(qū)、街道Usablearea可用面積字符型單位為平方米Storage_variety貯存種類字符型—Inventory庫存量字符型單位為噸Contact聯系人字符型—Contact_phone聯系電話字符型—Type類型字符型冷庫類型分為自營自用、第三方、集中倉三種類型追溯信息類接口說明集中監(jiān)管倉信息接口集中監(jiān)管倉信息參數見表12。

表12集中監(jiān)管倉信息參數字段名含義類型說明Container_number貨柜編號字符型裝載該批貨物的貨柜編號發(fā)貨信息接口說明發(fā)貨信息參數見表13。同一個發(fā)貨單號可對應多個發(fā)貨產品，發(fā)貨產品詳情見表14。發(fā)貨信息接口說明發(fā)貨信息參數見表13。同一個發(fā)貨單號可對應多個發(fā)貨產品，發(fā)貨產品詳情見表14。表13發(fā)貨信息參數7表12集中監(jiān)管倉信息參數（續(xù)）字段名含義類型說明Customs_img報關單圖片地址字符型圖片以URL形式展示Customs_number海關編號字符型也稱報關單號，報關單上的海關編號Nucleic_result抽樣核酸檢測結果字符型陰性Specification規(guī)格數字型—Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）Pieces件數數字型—Dataid推送數據編碼字符型對推送數據分配的唯一標識Nucleic_number核酸編號字符型—Cold_name冷庫名稱字符型—Production_batch生產批號字符型—Unif_soci_cred_code統(tǒng)一社會信用代碼字符型18位統(tǒng)一社會信用代碼，按照GB32100確定的編碼規(guī)則Brand品名字符型—Nucleic_item核酸項目字符型外包裝、內包裝、物品表面Certificate_date出庫證明日期日期時間型格式為YYYY-MM-DDDisinfect_data消毒日期日期時間型格式為YYYY-MM-DDPlaceorigin原產國字符型產品輸出國家Instockno入庫單號字符型—Disinfect_result消毒結果字符型已消毒或未消毒Shipper_name貨主名稱字符型—Product_number商品編號數字型—Certificate_number出庫證明編號數字型—Gross_weight毛重字符型單位為千克（kg）Nucleic_data核酸檢測日期日期時間型格式為YYYY-MM-DDGoods_flow商品流向字符型—Certificate_img監(jiān)管倉出庫證明圖片字符型將圖片轉為Base64編碼格式存儲字段名含義類型說明Send_number發(fā)貨單號字符型系統(tǒng)自動分配的唯一標識Send_time發(fā)貨日期日期時間型格式為YYYY-MM-DDReceiver_ent_name客戶名稱字符型—Receive_contact收貨方聯系人字符型—Receive_contact_phone收貨方聯系電話字符型—Receive_address收貨地址字符型—收貨信息接口說明收貨信息參數見表15。收貨信息接口說明收貨信息參數見表15。表15收貨信息參數入庫信息接口說明冷庫入庫信息參數見表16。同一個入庫單號可對應多個入庫產品，入庫產品詳情見表17。8表13發(fā)貨信息參數（續(xù)）字段名含義類型說明Product_list發(fā)貨產品詳情數組型14表14發(fā)貨產品詳情字段名含義類型說明storage_number冷庫編號字符型可以為空storage_name冷庫名稱字符型—product_library_id商品條碼/商品編碼字符型商品條碼采用GS112904DB4403/T191—20216product_name產品名稱字符型實物產品標簽上的產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces件數數字型—specification規(guī)格數字型—Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）container_number貨柜編號字符型裝載該批貨物的貨柜編號字段名含義類型說明Receiver_number收貨單號字符型系統(tǒng)自動分配的唯一標識Send_time發(fā)貨日期日期時間型格式為YYYY-MM-DDReceive_time收貨日期日期時間型格式為YYYY-MM-DDSend_ent_name發(fā)貨方名稱字符型—Send_contact發(fā)貨方聯系人字符型—Send_contact_phone發(fā)貨方聯系電話字符型—Product_list收貨產品詳情數組型出庫信息接口說明冷庫出庫信息參數見表18。同一個出庫單號可對應多個出庫產品，出庫產品詳情見表19。出庫信息接口說明冷庫出庫信息參數見表18。同一個出庫單號可對應多個出庫產品，出庫產品詳情見表19。表18出庫信息參數916入庫信息參數字段名含義類型說明In_stock_code入庫碼字符型系統(tǒng)自動分配的唯一標識In_stock_date入庫時間日期時間型格式為YYYY-MM-DDSend_contact貨主聯系人字符型—Send_ent_name貨主名稱字符型—Send_contact_phone貨主聯系電話字符型—Product_list入庫產品詳情數組型入庫產品信息，見表1717入庫產品詳情字段名含義類型說明product_library_id商品條碼/商品編碼字符型GS1GB12904DB4403/T2021中第6章規(guī)定的編碼方案product_name產品名稱字符型實物產品標簽上產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces實際入庫件數數字型—specification規(guī)格數字型—Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）container_number貨柜編號字符型裝載該批貨物的貨柜編號字段名含義類型說明Outstock_code出庫碼字符型系統(tǒng)自動分配的唯一標識Out_stock_date出庫時間日期時間型格式為YYYY-MM-DDSend_ent_name貨主名稱字符型—Send_contact貨主聯系人字符型—Send_contact_phone貨主聯系電話字符型—Receiver_ent_name收貨方名稱字符型—Receive_contact收貨方聯系人字符型—Out_stock_storage_number出庫存冷庫編號字符型該冷庫在本市唯一備案編號，外地冷庫可以為空Receive_contact_phone收貨方聯系電話字符型—Out_stock_storage_name出庫存冷庫名稱字符型—表18出庫信息參數（續(xù)）字段名含義類型說明Product_list出庫產品詳情數組型出庫產品信息，見表19表19出庫產品詳情字段名含義類型說明product_library_id商品條碼/商品編碼字符型商品條碼采用GS1GB12904DB4403/T191—20216product_name產品名稱字符型實物產品標簽上產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces實際出庫件數數字型—specification規(guī)格數字型—Specification_unit規(guī)格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）運輸車輛信息接口說明運輸車輛信息參數見表20。表20運輸車輛信息參數字段名含義類型說明Licenseplate車牌字符型—Driver_name司機姓名字符型—Driver_contact_phone司機聯系電話字符型—10附錄A（資料性）接口響應碼見表A.1。表A.1接口響應碼及狀態(tài)說明狀態(tài)碼狀態(tài)說明200服務器已成功處理請求401未獲得登錄授權或令牌失效403服務器拒絕請求404服務器找不到請求的接口或頁面500服務器遇到錯誤，無法完成請求502服務器作為網關或代理，從上游服務器收到無效響應503服務器目前無法使用（由于超載或停機維護）504服務器作為網關或代理，但是沒有及時從上游服務器收到請求1111附錄B（資料性）追溯數據對接實例下面以產品批次信息接口為例演示接口JSON實例。{"success":true,"message":"","code":200,"result":{"productLibraryId":"17896448006462","productName":"冷凍雞兩節(jié)翅","containerNo":"MNBU3167382","parentTraceCode":"0117896448006462101138885683196","traceCode":"0117896448006462101138896901150","batch":"L1","weight":13500.00,"productionDate":"2021-02-08","inventory":501,"inventoryWeight":7515.00,"StorageName"batch":"BY9066","consignee":"深圳業(yè)俊貿易有限公司","consignor":"COOPAVELCOOPERATTVAAGROINDUSTRIAL","dateOfentry":"2021-07-16","portOfEntry":"鹽田","quarantineNumber":"531620211160071009001","Quarantineimg":"data:image/jpg;Base64+Base64轉換碼",}"customsInfo":{"consumerEnterprises":"深圳市業(yè)俊貿易有限公司","customsNo":"531620211160071009","waybillNumber":"608370090","Consumerimg":"data:image/jpg;Base64+Base64轉換碼",}"disinfectInfo":{"disinfectDate":"2021-07-18","placeOfDisinfection":"CustomsPort","disinfectNumber":"HL20210718YL1","disinfectState":1,"Disinfectimg":"data:image/jpg;Base64+Base64轉換碼",}"nucleicInfo":{"naResult":"陰性","naDate":"2021-07-18","naUnit":"廣州市賽泰特醫(yī)學檢驗實驗室","verifyMode":"SelfCheck","Disinfectimg":"data:image/jpg;Base64+Base64轉換碼",}}12附錄C（資料性）企業(yè)類型及編碼說明企業(yè)類型及編碼見表C.1。表C.1企業(yè)類型及編碼編碼企業(yè)分類01食品生產企業(yè)06農批市場07貿易公司09農貿市場11零售商超14餐飲服務單位19冷庫29其他1313附錄D（資料性）資質證照類型及編碼資質證照類型及編碼見表D.1。表D.1資質證照類型及編碼類型編碼類型名稱01營業(yè)執(zhí)照02事業(yè)單位法人證書03中華人民共和國民辦學校辦學許可證04民辦非企業(yè)單位登記證書20食品經營許可證21食品生產許可證39其他資質證照1414附錄E（資料性）產品分類及編碼見表E.1。表E.1產品分類及編碼編碼產品大類產品中類0401肉制品熱加工熟肉制品0402肉制品發(fā)酵肉制品0403肉制品預制調理肉制品0404肉