DB37-T 4350-2021 重要產(chǎn)品追溯　食用農(nóng)產(chǎn)品省級(jí)平臺(tái)數(shù)據(jù)接口規(guī)范

ICS35.240.60CCSL70ICS35.240.60CCSL70山 東 省 地 方 標(biāo) 準(zhǔn)DB37/T4350—2021重要產(chǎn)品追溯食用農(nóng)產(chǎn)品省級(jí)平臺(tái)數(shù)據(jù)接口規(guī)范ImportantproducttraceabilityImportantproducttraceability—Specificationforprovincialplatformdatainterfaceofedibleagriculturalproducts2021031120210411山東省市場(chǎng)監(jiān)督管理局發(fā)布目 次前言 II112范引文件 13語(yǔ)定義 14略語(yǔ) 15本求 16口型 2省平與級(jí)的接類型 2省平與點(diǎn)的接類型 27接求 28口明 38.1接請(qǐng)求 38.2接響應(yīng) 4附錄A（料）代類型 6A.1消業(yè)類型 6A.2追系類型 6A.3響碼 6A.4經(jīng)類型 7A.5流順碼 7A.6內(nèi)環(huán)信類型 8A.7檢報(bào)類型 8附錄B（料）業(yè)參數(shù)例 9參考獻(xiàn) 12前 言本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件起草單位：山東省標(biāo)準(zhǔn)化研究院、浪潮軟件股份有限公司。本文件主要起草人：王玎、梁厚廣、王志恒、吳業(yè)虎、朱承鑫、陳通。重要產(chǎn)品追溯食用農(nóng)產(chǎn)品省級(jí)平臺(tái)數(shù)據(jù)接口規(guī)范范圍本文件規(guī)定了食用農(nóng)產(chǎn)品省級(jí)追溯管理平臺(tái)（以下簡(jiǎn)稱“省級(jí)平臺(tái)”）追溯數(shù)據(jù)接口的基本要求、接口類型、對(duì)接要求、接口說(shuō)明。）（GB/T7408GB/T18391.1（MDR）第GB/T38154—2019重要產(chǎn)品追溯核心元數(shù)據(jù)GB/T38155重要產(chǎn)品追溯追溯術(shù)語(yǔ)DB37/T3659—2019重要產(chǎn)品追溯食用農(nóng)產(chǎn)品省市平臺(tái)管理規(guī)范IETFRFC2818TLS上的HTTP（HTTPOverTLS）IETFRFC3548Basel6、Base32、Base64數(shù)據(jù)編碼（TheBasel6,Base32,andBase64DataEncodings）IETFRFC3629UTF—8，ISO10646（UTF-8,transformationformatofISO10646）GB/T18391.1、GB/T38155、DB37/T3659界定的術(shù)語(yǔ)和定義適用于本文件?？s略語(yǔ)下列縮略語(yǔ)適用于本文件。HTTPS：以安全為目標(biāo)的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一種輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）SHA-256：安全雜湊算法（SecureHashAlgorithm），摘要輸出長(zhǎng)度為32字節(jié)UTF-8：一種可變長(zhǎng)度字符編碼（8-bitUnicodeTransformationFormat）接口通過(guò)服務(wù)調(diào)用實(shí)現(xiàn)信息交換，應(yīng)符合下列要求：——采用符合IETFRFC2818的HTTPS協(xié)議作為底層承載協(xié)議；——采用符合IETFRFC3629規(guī)定的UTF-8字符集；——采用符合GB/T7408規(guī)定的日期類型；——采用符合IETFRFC3548規(guī)定的BASE64編碼規(guī)則將圖片文件轉(zhuǎn)換為字符串；——接口請(qǐng)求與接口響應(yīng)均采用JSON數(shù)據(jù)格式；——建立接口日志記錄，能識(shí)別數(shù)據(jù)異?；蜃匪萁粨Q數(shù)據(jù)情況；主要包括下列類型：配送7對(duì)接要求7對(duì)接要求7.1接入前應(yīng)按照DB37/T3659—20196省級(jí)平臺(tái)省級(jí)平臺(tái)主體 產(chǎn)品備案 備案信息 信息

追溯業(yè)務(wù)信息接口接口接口市級(jí)平臺(tái)接口接口市級(jí)平臺(tái)種植信息零售信息消費(fèi)信息召回信息養(yǎng)殖信息生產(chǎn)加工信息屠宰信息批發(fā)信息養(yǎng)殖信息生產(chǎn)加工信息屠宰信息批發(fā)信息接口節(jié)點(diǎn)系統(tǒng)追溯接口節(jié)點(diǎn)系統(tǒng)追溯召回信息消費(fèi)信息零售信息種植信息養(yǎng)殖信息生產(chǎn)加工信息屠宰信息批發(fā)信息圖1對(duì)接示意圖SHA-256圖1對(duì)接示意圖SHA-256post（Method）application/json（Content-Type）8接口說(shuō)明請(qǐng)求參數(shù)表見(jiàn)表1。表1公共請(qǐng)求參數(shù)名稱含義類型是否可空說(shuō)明BIZ_TYPE業(yè)務(wù)消息類型字符串否見(jiàn)附錄A中的表A.1REQ_TIME請(qǐng)求時(shí)間日期時(shí)間型否yyyy-MM-ddHH:mm:ssREQ_ID請(qǐng)求編碼字符串否yyyyMMddHHmmss+6位字母數(shù)字組合隨機(jī)碼AUTH_ID認(rèn)證編碼字符串否省級(jí)平臺(tái)提供的授權(quán)密匙，SHA-265加密PARAM業(yè)務(wù)請(qǐng)求參數(shù)字符串否見(jiàn)8.1.2，JSON子節(jié)點(diǎn)，自由文本請(qǐng)求格式示例見(jiàn)表2。表2請(qǐng)求格式{{"BIZ_TYPE":"traceDataRequest","REQ_TIME":"2020-01-1000:00:00","REQ_ID":"20200721084654qJJ2Jb","AUTH_ID":"20200609153209831756","PARAM":{}}8.1.2業(yè)務(wù)請(qǐng)求WSDWebServicesDescriptionLanguage）GB/T38154—2019B表3公共響應(yīng)參數(shù)響應(yīng)格式示例見(jiàn)表4。表3公共響應(yīng)參數(shù)響應(yīng)格式示例見(jiàn)表4。表4響應(yīng)格式8.2.2業(yè)務(wù)響應(yīng)業(yè)務(wù)響應(yīng)結(jié)果信息見(jiàn)表5。名稱含義類型是否可空說(shuō)明BIZ_TYPE業(yè)務(wù)類型字符串否見(jiàn)附錄A中的表A.1RESP_TIME響應(yīng)時(shí)間日期時(shí)間型否yyyy-MM-ddHH:mm:ssRESP_ID響應(yīng)編碼字符串否響應(yīng)方產(chǎn)生的唯一編碼REQ_ID請(qǐng)求編碼字符串否請(qǐng)求方的唯一編碼RESULT響應(yīng)數(shù)據(jù)參數(shù)字符串否JSON子節(jié)點(diǎn)，自由文本{{"BIZ_TYPE":"traceDataRequest","RESP_TIME":"2020-01-1000:00:00","RESP_ID":"20200721084836BSoICl","REQ_ID":"20200721084654qJJ2Jb","RESULT":{}}表5業(yè)務(wù)響應(yīng)參數(shù)名稱含義類型是否可空說(shuō)明SUCCESS是否成功字符串否true/falseRESULT_CODE響應(yīng)碼字符串否見(jiàn)附錄A中的表A.3RESULT_MSG響應(yīng)消息字符串否BATCH_ID批次碼字符串是對(duì)應(yīng)請(qǐng)求消息中的批次碼CODE_NUM追溯碼數(shù)量數(shù)值型是實(shí)際返回的追溯碼數(shù)量TRACE_IDS追溯碼字符串是多個(gè)追溯碼以逗號(hào)分隔,最多返回100000個(gè)，自由文本……其他參數(shù)字符串是響應(yīng)格式示例見(jiàn)表6。表6響應(yīng)格式{{"BIZ_TYPE":"traceDataResponse","RESP_TIME":"2020-01-1000:00:00","RESP_ID":"20200721084836BSoICl","REQ_ID":"20200721084654qJJ2Jb","RESULT":{"SUCCESS":"true","RESULT_CODE":"0000","RESULT_MSG":"處理成功","BATCH_ID":"批次碼","CODE_NUM":"追溯碼數(shù)量","TRACE_IDS":"追溯碼1,追溯碼2,追溯碼3"}}附錄A（消息業(yè)務(wù)類型見(jiàn)表A.1。表A.1消息業(yè)務(wù)類型類型代碼含義traceDataRequest追溯數(shù)據(jù)上報(bào)請(qǐng)求traceDataResponse追溯數(shù)據(jù)上報(bào)響應(yīng)追溯系統(tǒng)類型見(jiàn)表A.2。表A.2追溯系統(tǒng)類型類型代碼含義00肉菜追溯系統(tǒng)01老字號(hào)追溯系統(tǒng)02可追溯供應(yīng)商追溯系統(tǒng)03商業(yè)超市追溯系統(tǒng)04地理標(biāo)志產(chǎn)品追溯系統(tǒng)05特色產(chǎn)品追溯系統(tǒng)06中藥材追溯系統(tǒng)99其他追溯系統(tǒng)A.3響應(yīng)碼A.3響應(yīng)碼響應(yīng)碼見(jiàn)表A.3。表A.3響應(yīng)碼類型代碼含義0000成功0001請(qǐng)求參數(shù)錯(cuò)誤0002json格式不合法0003認(rèn)證信息錯(cuò)誤0004驗(yàn)簽錯(cuò)誤0005請(qǐng)求時(shí)間錯(cuò)誤0006業(yè)務(wù)類型錯(cuò)誤0100非空校驗(yàn)錯(cuò)誤0101正則表達(dá)式校驗(yàn)錯(cuò)誤0102枚舉值校驗(yàn)錯(cuò)誤0103數(shù)據(jù)范圍校驗(yàn)錯(cuò)誤表A.3響應(yīng)碼（續(xù)）類型代碼含義0104長(zhǎng)度校驗(yàn)錯(cuò)誤0105其他校驗(yàn)錯(cuò)誤0300農(nóng)殘抑制率不合格＞50%0301檢測(cè)報(bào)告錯(cuò)誤0302經(jīng)營(yíng)主體編碼錯(cuò)誤0303地區(qū)校驗(yàn)錯(cuò)誤0304生成追溯碼錯(cuò)誤9999未知錯(cuò)誤A.4經(jīng)營(yíng)類型經(jīng)營(yíng)類型見(jiàn)表A.4。表A.4經(jīng)營(yíng)類型類型代碼含義00種養(yǎng)殖10生產(chǎn)加工20批發(fā)21倉(cāng)儲(chǔ)配送22零售30團(tuán)體消費(fèi)單位99其它A.5流通順序碼A.5流通順序碼流通順序碼見(jiàn)表A.5。表A.5流通順序碼類型代碼含義10種養(yǎng)殖11種養(yǎng)殖環(huán)節(jié)倉(cāng)儲(chǔ)配送12種養(yǎng)植環(huán)節(jié)銷售20生產(chǎn)加工21生產(chǎn)加工環(huán)節(jié)倉(cāng)儲(chǔ)配送22生產(chǎn)加工環(huán)節(jié)銷售30批發(fā)31批發(fā)環(huán)節(jié)倉(cāng)儲(chǔ)配送32批發(fā)環(huán)節(jié)銷售40零售41零售環(huán)節(jié)倉(cāng)儲(chǔ)配送42零售環(huán)節(jié)銷售表A.5流通順序碼（續(xù)）類型代碼含義50團(tuán)體消費(fèi)單位51團(tuán)體消費(fèi)單位倉(cāng)儲(chǔ)配送90其它91其它環(huán)節(jié)倉(cāng)儲(chǔ)配送92其它環(huán)節(jié)銷售內(nèi)部環(huán)節(jié)信息類型見(jiàn)表A.6。表A.6內(nèi)部環(huán)節(jié)信息類型類型代碼含義01農(nóng)事信息（種養(yǎng)殖等）02生產(chǎn)加工過(guò)程信息03倉(cāng)儲(chǔ)配送信息表A.7檢測(cè)報(bào)告類型表A.7檢測(cè)報(bào)告類型類型代碼含義01動(dòng)物檢疫合格證明02肉品品質(zhì)檢驗(yàn)合格證03瘦肉精檢測(cè)報(bào)告10農(nóng)藥殘留檢測(cè)報(bào)告20入境貨物檢驗(yàn)檢疫證明30質(zhì)檢報(bào)告（生產(chǎn)加工環(huán)節(jié)）附錄B（）追溯業(yè)務(wù)數(shù)據(jù)上報(bào)請(qǐng)求參數(shù)見(jiàn)B.1。表B.1追溯業(yè)務(wù)數(shù)據(jù)上報(bào)請(qǐng)求參數(shù)名稱含義類型是否可空說(shuō)明TRACE_TYPE追溯系統(tǒng)類型字符串否見(jiàn)附錄A中的表A.2SEQ_ID流通順序碼字符串否見(jiàn)附錄A中的表A.5BUSI_ID經(jīng)營(yíng)主體編碼字符串否統(tǒng)一社會(huì)信用代碼GOODS_ID商品條碼字符串否符合GB12904的規(guī)定GOODS_NAME商品名稱字符串否上報(bào)企業(yè)系統(tǒng)商品名稱GOODS_NUM商品數(shù)量數(shù)值型否GOODS_UNIT計(jì)量單位字符串否KG-千克,L-升GOODS_PRICE商品單價(jià)數(shù)值型否元，保留小數(shù)點(diǎn)2位BATCH_ID批次碼字符串否企業(yè)原批次碼TRACE_ID追溯碼字符串是追溯碼時(shí)使用OPER_DESC內(nèi)部環(huán)節(jié)信息字符串否見(jiàn)附錄A中的表A.6VERIFY_IMG檢測(cè)報(bào)告圖片字符串是JPG格式BASE64編碼字符串VERIFY_IMGS檢測(cè)報(bào)告多圖地址字符串是多個(gè)地址以逗號(hào)分隔VERIFY_MULTIIMG檢測(cè)報(bào)告多圖字符串是報(bào)告類型見(jiàn)附錄A中的表A.7VERIFY檢測(cè)數(shù)據(jù)數(shù)組型是JSON子節(jié)點(diǎn)VERIFY/COMPANY檢測(cè)單位字符串否檢測(cè)單位名稱VERIFY/INSPECTOR檢驗(yàn)員字符串否檢驗(yàn)員名稱VERIFY/DATE檢測(cè)日期日期型否yyyy-MM-ddVERIFY/INHIBIT抑制率(%)數(shù)值型否如：22.6，保留小數(shù)點(diǎn)2位VERIFY/RESULT檢測(cè)結(jié)果字符串否如：合格等MAKE_DATE生產(chǎn)日期日期型否yyyy-MM-ddVALID_DAYS保質(zhì)期數(shù)值型否默認(rèn)天VALID_TYPE保質(zhì)期類型字符串是Y-年，M-月，D-日CONTACT_BATCH_ID關(guān)聯(lián)批次碼字符串是CONTACT_TRACE_ID關(guān)聯(lián)追溯碼字符串是CODE_NUM請(qǐng)求追溯碼數(shù)量數(shù)值型否0100000果傳0TRACE_ID市級(jí)平臺(tái)上報(bào)直接傳0SELL_COUNTRY銷售地國(guó)家編碼字符串是銷售環(huán)節(jié)填寫(xiě)符合GB/T2659數(shù)字代碼表B.1追溯業(yè)務(wù)數(shù)據(jù)上報(bào)請(qǐng)求參數(shù)（續(xù)）名稱含義類型是否可空說(shuō)明SELL_REGION銷售地區(qū)編碼字符串是6碼（符合GB/T2260中規(guī)定的數(shù)字代碼，否則為空請(qǐng)求格式示例見(jiàn)表B.2。表B.2請(qǐng)求格式{{"BIZ_TYPE":"traceDataRequest","REQ_TIME":"2020-01-1000:00:00","REQ_ID":"20200721084654qJJ2Jb","AUTH_ID":"20200609153209831756","PARAM":{"TRACE_TYPE":"追溯類型","SEQ_ID":"順序碼","BUSI_ID":"經(jīng)營(yíng)主體編碼","GOODS_ID":"商品編碼","GOODS_NAME":"商品名稱","GOODS_NUM":"商品數(shù)量","GOODS_UNIT":"計(jì)量單位","GOODS_PRICE":"商品單價(jià)","BATCH_ID":"批次碼","OPER_DESC":[{"OPER_DATE":"2020-07-01","OPERATOR":"種植操作員","DESC":"種植","OPER_TYPE":"01"},{"OPER_DATE":"2020-08-01","OPERATOR":"施肥操作員","DESC":"施肥","OPER_TYPE":"01"},表B.2請(qǐng)求格式（續(xù)）{{"OPER_DATE":"2020-07-01","OPERATOR":"浸泡操作員",/r/