進口冷鏈食品追溯數據接口規范目 次前言 II范圍 1規范性引用文件 1術語和定義 1縮略語 1基本要求 2接口類型 2接口關系 2接口描述 2附錄A（資料性）接口響應碼說明 11附錄B（資料性）追溯數據對接實例 12附錄C（資料性）企業類型及編碼說明 13附錄D（資料性）資質證照類型及編碼 14附錄E（資料性）產品分類及編碼 15參考文獻 17I進口冷鏈食品追溯數據接口規范范圍本文件規定了進口冷鏈食品追溯系統數據接口的基本要求、接口類型、接口關系、接口描述。本文件適用于企業、技術機構、監管部門在進口冷鏈食品追溯系統間的數據對接。規范性引用文件（包括所有的修改單適用于本文件。GB/T7408數據元和交換格式信息交換日期和時間表示法GB12904商品條碼零售商品編碼與條碼表示GB32100法人和其他組織統一社會信用代碼編碼規則DB4403/T191—2021食用農產品追溯碼編碼技術規范IETFRFC2818TLSHTTP（HTTPoverTLS）IETFRFC3548Base16，Base32，Base64數據編碼（TheBase16，Base32，andBase64dataencodings）IETFRFC3629UTF-8，ISO10646（UTF-8，atransformationformatofISO10646）術語和定義下列術語和定義適用于本文件。3.1冷鏈食品cold-chainfood通過冷鏈實現物流過程運輸的果蔬類、水產類、肉制品類、禽蛋類、乳制品、糧食類等易腐食品及其加工制品等食品。注：包括冷凍食品和冷藏食品。3.2追溯系統traceabilitysystem基于追溯碼、文件記錄、相關軟硬件設備和通信網絡，實現現代信息化管理并可獲取產品追溯過程中相關數據的集成。[來源：GB/T38155—2019，2.6]3.3集中監管倉centralizedsupervisionwarehouse具備進口冷鏈食品（3.1）相關疫情集中排查、集中管控、集中處置和產品外包裝預防性消毒功能的場所。縮略語下列縮略語適用于本文件。GS1：國際物品編碼協會（GlobalStandards1）HTTPS：以安全為目標的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一種輕量級的數據交換格式（JavaScriptObjectNotation）UTF-8：一種可變長度字符編碼（8-bitUnicodeTransformationFormat）1基本要求接口通過服務調用實現信息交換，應符合下列要求：——采用IETFRFC2818規定的HTTPS協議作為底層承載協議；——采用IETFRFC3629規定的UTF-8字符集；——采用GB/T7408規定的日期類型；——采用IETFRFC3548規定的Base64編碼規則將圖片文件轉換為字符串；——接口請求與接口響應均采用JSON數據格式；——建立接口日志記錄，能識別數據異常或追溯交換數據情況；——接口類型進口冷鏈食品追溯系統數據接口主要包括下列類型：——主體信息類，包括但不限于主體信息類參數；——產品信息類，包括但不限于產品品類信息、產品批次信息、入境貨物檢驗檢疫證明信息、海關進口貨物報關單信息、消毒證明信息、核酸檢測證明信息、集中監管倉出庫證明信息；——冷庫信息類，包括但不限于冷庫信息類參數；——追溯信息類，包括但不限于集中監管倉信息、收發貨信息、出入庫信息、運輸信息。接口關系進口冷鏈食品追溯系統數據接口關系如圖1所示。圖1數據接口關系接口描述接口請求2接口請求參數說明見表1。表1接口請求參數頭部參數含義類型說明appid調用編碼字符型接口調用方唯一標識，每個調用方會分配一個appid和一個appsecrettimestamp請求時間日期時間型時間戳nonce隨機字符串字符型隨機串（不少于10位）signature請求簽名字符型接口調用授權密鑰，SHA-256加密接口響應接口響應參數說明見表2。

表2接口響應參數參數名含義類型說明Success響應結果字符型是否成功Message響應信息字符型提示信息Code響應編碼數字型接口響應碼，見附錄ATimestamp響應時間日期時間型時間戳Result響應數據參數字符型接口以JSON格式返回參數值，見附錄B業務接口說明主體信息類接口說明主體信息類參數見表3。

表3主體信息類參數字段名含義類型說明Ent_name企業名稱字符型通過統一社會信用代碼獲取企業注冊名稱Unif_soci_cred_code統一社會信用代碼字符型18位統一社會信用代碼，按照GB32100確定的編碼規則Contact聯系人字符型—Contact_phone聯系電話字符型—Legal_person法人代表字符型—Office_address地址字符型—Addr_districts所屬區劃字符型具體到省、市、區、街道Ent_type_code企業類型字符型企業類型及編碼說明見附錄CEnt_img資質證照字符型Base64D產品信息類接口說明3產品品類信息接口產品品類信息參數見表4。表4產品品類信息參數字段名含義類型說明Product_library_id商品條碼/產品編碼字符型商品條碼采用GS112904碼為系統自動生成的產品品類編碼，DB4403/T191—2021中第6章規定的編碼方案Product_name產品名稱字符型實物產品標簽上的產品名稱Product_category產品類型字符型追溯系統二級分類代碼，產品分類及編碼見附錄ECountry原產國字符型產品輸出國家Life_number保質期限數字型—Life_unit保質期單位字符型保質期以年、月或日為單位Specification規格數字型—Specification_unit規格單位字符型單位為千克（kg）、克（g）Registration_number生產企業注冊號字符型產品原產國生產企業注冊號Manufacturer生產企業名稱字符型產品原產國生產企業名稱Product_label產品標簽圖片字符型將圖片轉為Base64編碼格式存儲Product_img產品圖片字符型將圖片轉為Base64編碼格式存儲產品批次信息接口產品批次信息參數說明見表5，產品批次對應的入境貨物檢驗檢疫證明信息說明、海關進口貨物報6、表7、表8、表9、表10。表5產品批次信息參數字段名含義類型說明Product_library_id商品條碼/產品編碼字符型商品條碼采用GS1編碼，應符合GB12904碼為系統自動生成的產品品類編碼，編碼規則應按照DB4403/T191—2021中第6章規定的編碼方案Product_name產品名稱字符型實物產品標簽上的產品名稱Container_number貨柜編號字符型裝載該批貨物的貨柜編號Trace_code批次追溯碼字符型編碼規則應按照DB4403/T191—2021中第6章規定的追溯碼編碼方案Batch實際批次字符型實物產品標簽上的生產批號Number_of_pieces首次入庫件數數字型—Weight首次入庫重量字符型單位為千克（kg）Inventory_pieces庫存件數數字型可發貨件數Production_date生產日期日期時間型格式為YYYY-MM-DD4表5產品批次信息參數（續）字段名含義類型說明Inventory_weight庫存重量字符型可發貨件數重量總和，單位為千克（kg）Storage_name存放冷庫名稱字符型—表6入境貨物檢驗檢疫證明信息字段名含義類型說明Batch批次字符型入境貨物檢驗檢疫證明生產批號Consignee收貨人字符型進口冷鏈食品國際貿易中從境外發貨人處接收貨物并承擔相應責任的組織Consignor發貨人字符型進口冷鏈食品國際貿易中向國內收貨方提供產品的境外組織Date_ofentry入境日期日期時間型格式為YYYY-MM-DDPort_of_entry入境口岸字符型—Quarantine_number入境貨物檢驗檢疫證明編號數字型15、18或21位數字編碼Quarantine_img入境貨物檢驗檢疫證明圖片字符型將圖片轉為Base64編碼格式存儲表7海關進口貨物報關單信息字段名含義類型說明Consumer_enterprises消費使用單位字符型消費使用單位為已知的進口貨物在境進出口企業進口貨物的單位Customs_number海關編號數字型報關單上的海關編號Waybill_number提運單號字符型進出口貨物提單或運單的編號Consumer_img報關單圖片字符型將圖片轉為Base64編碼格式存儲表8消毒證明信息字段名含義類型說明Disinfect_date消毒日期日期時間型格式為YYYY-MM-DDPlace_of_disinfection消毒實施地字符型分為市場、冷庫、海關口岸和其他Disinfect_number消毒編號字符型消毒證明唯一標識Disinfect_state消毒狀態字符型消毒狀態為已消毒和未消毒，1消毒，0Disinfect_img消毒證明圖片字符型將圖片轉為Base64編碼格式存儲表9核酸檢測證明信息字段名含義類型說明Na_result核酸檢測結果字符型陰性或陽性5表9核酸檢測證明信息（續）字段名含義類型說明Na_date核酸檢測日期日期時間型格式為YYYY-MM-DDNa_unit核酸檢測單位字符型實施核酸檢測的單位名稱Verify_mode檢驗模式字符型核酸檢測覆蓋或企業自行委托Na_img核酸檢測證明圖片字符型將圖片轉為Base64編碼格式存儲表10集中監管倉出庫證明信息字段名含義類型說明Certificate_number集中監管倉出庫證明編號數字型數字編碼Certificate_date出庫證明日期日期時間型格式為YYYY-MM-DDCertificate_img集中監管倉出庫證明圖片字符型將圖片轉為Base64編碼格式存儲冷庫信息類接口說明冷庫信息類參數見表11。

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

表12集中監管倉信息參數字段名含義類型說明Container_number貨柜編號字符型裝載該批貨物的貨柜編號6表12集中監管倉信息參數（續）字段名含義類型說明Customs_img報關單圖片地址字符型圖片以URL形式展示Customs_number海關編號字符型也稱報關單號，報關單上的海關編號Nucleic_result抽樣核酸檢測結果字符型陰性Specification規格數字型—Specification_unit規格單位字符型單位為千克（kg）、克（g）Pieces件數數字型—Dataid推送數據編碼字符型對推送數據分配的唯一標識Nucleic_number核酸編號字符型—Cold_name冷庫名稱字符型—Production_batch生產批號字符型—Unif_soci_cred_code統一社會信用代碼字符型18位統一社會信用代碼，按照GB32100確定的編碼規則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監管倉出庫證明圖片字符型將圖片轉為Base64編碼格式存儲發貨信息接口說明發貨信息參數見表13。同一個發貨單號可對應多個發貨產品，發貨產品詳情見表14。表13發貨信息參數字段名含義類型說明Send_number發貨單號字符型系統自動分配的唯一標識Send_time發貨日期日期時間型格式為YYYY-MM-DDReceiver_ent_name客戶名稱字符型—Receive_contact收貨方聯系人字符型—Receive_contact_phone收貨方聯系電話字符型—Receive_address收貨地址字符型—7表13發貨信息參數（續）字段名含義類型說明Product_list發貨產品詳情數組型14表14發貨產品詳情字段名含義類型說明storage_number冷庫編號字符型可以為空storage_name冷庫名稱字符型—product_library_id商品條碼/商品編碼字符型商品條碼采用GS112904DB4403/T191—20216product_name產品名稱字符型實物產品標簽上的產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces件數數字型—specification規格數字型—Specification_unit規格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）container_number貨柜編號字符型裝載該批貨物的貨柜編號收貨信息接口說明收貨信息參數見表15。表15收貨信息參數字段名含義類型說明Receiver_number收貨單號字符型系統自動分配的唯一標識Send_time發貨日期日期時間型格式為YYYY-MM-DDReceive_time收貨日期日期時間型格式為YYYY-MM-DDSend_ent_name發貨方名稱字符型—Send_contact發貨方聯系人字符型—Send_contact_phone發貨方聯系電話字符型—Product_list收貨產品詳情數組型14入庫信息接口說明冷庫入庫信息參數見表16。同一個入庫單號可對應多個入庫產品，入庫產品詳情見表17。816入庫信息參數字段名含義類型說明In_stock_code入庫碼字符型系統自動分配的唯一標識In_stock_date入庫時間日期時間型格式為YYYY-MM-DDSend_contact貨主聯系人字符型—Send_ent_name貨主名稱字符型—Send_contact_phone貨主聯系電話字符型—Product_list入庫產品詳情數組型入庫產品信息，見表1717入庫產品詳情字段名含義類型說明product_library_id商品條碼/商品編碼字符型GS1GB12904DB4403/T2021中第6章規定的編碼方案product_name產品名稱字符型實物產品標簽上產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces實際入庫件數數字型—specification規格數字型—Specification_unit規格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）container_number貨柜編號字符型裝載該批貨物的貨柜編號出庫信息接口說明冷庫出庫信息參數見表18。同一個出庫單號可對應多個出庫產品，出庫產品詳情見表19。表18出庫信息參數字段名含義類型說明Outstock_code出庫碼字符型系統自動分配的唯一標識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出庫存冷庫名稱字符型—9表18出庫信息參數（續）字段名含義類型說明Product_list出庫產品詳情數組型出庫產品信息，見表19表19出庫產品詳情字段名含義類型說明product_library_id商品條碼/商品編碼字符型商品條碼采用GS1GB12904DB4403/T191—20216product_name產品名稱字符型實物產品標簽上產品名稱batch實際批次字符型實物產品標簽上的生產批號production_date生產日期日期時間型格式為YYYY-MM-DDnumber_of_pieces實際出庫件數數字型—specification規格數字型—Specification_unit規格單位字符型單位為千克（kg）、克（g）weight凈重字符型單位為千克（kg）運輸車輛信息接口說明運輸車輛信息參數見表20。表20運輸車輛信息參數字段名含義類型說明Licenseplate車牌字符型—Driver_name司機姓名字符型—Driver_contact_phone司機聯系電話字符型—10附錄A（資料性）接口響應碼見表A.1。表A.1接口響應碼及狀態說明狀態碼狀態說明200服務器已成功處理請求401未獲得登錄授權或令牌失效403服務器拒絕請求404服務器找不到請求的接口或頁面500服務器遇到錯誤，無法完成請求502服務器作為網關或代理，從上游服務器收到無效響應503服務器目前無法使用（由于超載或停機維護）504服務器作為網關或代理，但是沒有及時從上游服務器收到請求11附錄B（資料性）追溯數據對接實例下面以產品批次信息接口為例演示接口JSON實例。{"success":true,"message":"","code":200,"result":{"productLibraryId":"17896448006462","productName":"冷凍雞兩節翅","containerNo":"MNBU3167382","parentTraceCode":"0117896448006462101138885683196","traceCode":"0117896448006462101138896901150","batch":"L1","weight":13500.00,"productionDate":"2021-02-08","inventory":501,"inventoryWeight":7515.00,"StorageName"batch":"BY9066","consignee":"深圳業俊貿易有限公司","consignor":"COOPAVELCOOPERATTVAAGROINDUSTRIAL","dateOfentry":"2021-07-16","portOfEntry":"鹽田","quarantineNumber":"531620211160071009001","Quarantineimg":"data:image/jpg;Base64+Base64轉換碼",}"customsInfo":{"consumerEnterprises":"深圳市業俊貿易有限公司","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":"廣州市賽泰特醫學檢驗實驗室","verifyMode":"SelfCheck","Disinfectimg":"data:image/jpg;Base64+Base64轉換碼",}}12附錄C（資料性）企業類型及編碼說明企業類型及編碼見表C.1。表C.1企業類型及編碼編碼企業分類01食品生產企業06農批市場07貿易公司09