DB37-T 4350-2021 重要产品追溯　食用农产品省级平台数据接口规范

ICS35.240.60CCSL70ICS35.240.60CCSL70山 东 省 地 方 标 准DB37/T4350—2021重要产品追溯食用农产品省级平台数据接口规范ImportantproducttraceabilityImportantproducttraceability—Specificationforprovincialplatformdatainterfaceofedibleagriculturalproducts2021031120210411山东省市场监督管理局发布目 次前言 II112范引文件 13语定义 14略语 15本求 16口型 2省平与级的接类型 2省平与点的接类型 27接求 28口明 38.1接请求 38.2接响应 4附录A（料）代类型 6A.1消业类型 6A.2追系类型 6A.3响码 6A.4经类型 7A.5流顺码 7A.6内环信类型 8A.7检报类型 8附录B（料）业参数例 9参考献 12前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。本文件主要起草人：王玎、梁厚广、王志恒、吴业虎、朱承鑫、陈通。重要产品追溯食用农产品省级平台数据接口规范范围本文件规定了食用农产品省级追溯管理平台（以下简称“省级平台”）追溯数据接口的基本要求、接口类型、对接要求、接口说明。）（GB/T7408GB/T18391.1（MDR）第GB/T38154—2019重要产品追溯核心元数据GB/T38155重要产品追溯追溯术语DB37/T3659—2019重要产品追溯食用农产品省市平台管理规范IETFRFC2818TLS上的HTTP（HTTPOverTLS）IETFRFC3548Basel6、Base32、Base64数据编码（TheBasel6,Base32,andBase64DataEncodings）IETFRFC3629UTF—8，ISO10646（UTF-8,transformationformatofISO10646）GB/T18391.1、GB/T38155、DB37/T3659界定的术语和定义适用于本文件。缩略语下列缩略语适用于本文件。HTTPS：以安全为目标的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）SHA-256：安全杂凑算法（SecureHashAlgorithm），摘要输出长度为32字节UTF-8：一种可变长度字符编码（8-bitUnicodeTransformationFormat）接口通过服务调用实现信息交换，应符合下列要求：——采用符合IETFRFC2818的HTTPS协议作为底层承载协议；——采用符合IETFRFC3629规定的UTF-8字符集；——采用符合GB/T7408规定的日期类型；——采用符合IETFRFC3548规定的BASE64编码规则将图片文件转换为字符串；——接口请求与接口响应均采用JSON数据格式；——建立接口日志记录，能识别数据异常或追溯交换数据情况；主要包括下列类型：配送7对接要求7对接要求7.1接入前应按照DB37/T3659—20196省级平台省级平台主体 产品备案 备案信息 信息

追溯业务信息接口接口接口市级平台接口接口市级平台种植信息零售信息消费信息召回信息养殖信息生产加工信息屠宰信息批发信息养殖信息生产加工信息屠宰信息批发信息接口节点系统追溯接口节点系统追溯召回信息消费信息零售信息种植信息养殖信息生产加工信息屠宰信息批发信息图1对接示意图SHA-256图1对接示意图SHA-256post（Method）application/json（Content-Type）8接口说明请求参数表见表1。表1公共请求参数名称含义类型是否可空说明BIZ_TYPE业务消息类型字符串否见附录A中的表A.1REQ_TIME请求时间日期时间型否yyyy-MM-ddHH:mm:ssREQ_ID请求编码字符串否yyyyMMddHHmmss+6位字母数字组合随机码AUTH_ID认证编码字符串否省级平台提供的授权密匙，SHA-265加密PARAM业务请求参数字符串否见8.1.2，JSON子节点，自由文本请求格式示例见表2。表2请求格式{{"BIZ_TYPE":"traceDataRequest","REQ_TIME":"2020-01-1000:00:00","REQ_ID":"20200721084654qJJ2Jb","AUTH_ID":"20200609153209831756","PARAM":{}}8.1.2业务请求WSDWebServicesDescriptionLanguage）GB/T38154—2019B表3公共响应参数响应格式示例见表4。表3公共响应参数响应格式示例见表4。表4响应格式8.2.2业务响应业务响应结果信息见表5。名称含义类型是否可空说明BIZ_TYPE业务类型字符串否见附录A中的表A.1RESP_TIME响应时间日期时间型否yyyy-MM-ddHH:mm:ssRESP_ID响应编码字符串否响应方产生的唯一编码REQ_ID请求编码字符串否请求方的唯一编码RESULT响应数据参数字符串否JSON子节点，自由文本{{"BIZ_TYPE":"traceDataRequest","RESP_TIME":"2020-01-1000:00:00","RESP_ID":"20200721084836BSoICl","REQ_ID":"20200721084654qJJ2Jb","RESULT":{}}表5业务响应参数名称含义类型是否可空说明SUCCESS是否成功字符串否true/falseRESULT_CODE响应码字符串否见附录A中的表A.3RESULT_MSG响应消息字符串否BATCH_ID批次码字符串是对应请求消息中的批次码CODE_NUM追溯码数量数值型是实际返回的追溯码数量TRACE_IDS追溯码字符串是多个追溯码以逗号分隔,最多返回100000个，自由文本……其他参数字符串是响应格式示例见表6。表6响应格式{{"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":"追溯码数量","TRACE_IDS":"追溯码1,追溯码2,追溯码3"}}附录A（消息业务类型见表A.1。表A.1消息业务类型类型代码含义traceDataRequest追溯数据上报请求traceDataResponse追溯数据上报响应追溯系统类型见表A.2。表A.2追溯系统类型类型代码含义00肉菜追溯系统01老字号追溯系统02可追溯供应商追溯系统03商业超市追溯系统04地理标志产品追溯系统05特色产品追溯系统06中药材追溯系统99其他追溯系统A.3响应码A.3响应码响应码见表A.3。表A.3响应码类型代码含义0000成功0001请求参数错误0002json格式不合法0003认证信息错误0004验签错误0005请求时间错误0006业务类型错误0100非空校验错误0101正则表达式校验错误0102枚举值校验错误0103数据范围校验错误表A.3响应码（续）类型代码含义0104长度校验错误0105其他校验错误0300农残抑制率不合格＞50%0301检测报告错误0302经营主体编码错误0303地区校验错误0304生成追溯码错误9999未知错误A.4经营类型经营类型见表A.4。表A.4经营类型类型代码含义00种养殖10生产加工20批发21仓储配送22零售30团体消费单位99其它A.5流通顺序码A.5流通顺序码流通顺序码见表A.5。表A.5流通顺序码类型代码含义10种养殖11种养殖环节仓储配送12种养植环节销售20生产加工21生产加工环节仓储配送22生产加工环节销售30批发31批发环节仓储配送32批发环节销售40零售41零售环节仓储配送42零售环节销售表A.5流通顺序码（续）类型代码含义50团体消费单位51团体消费单位仓储配送90其它91其它环节仓储配送92其它环节销售内部环节信息类型见表A.6。表A.6内部环节信息类型类型代码含义01农事信息（种养殖等）02生产加工过程信息03仓储配送信息表A.7检测报告类型表A.7检测报告类型类型代码含义01动物检疫合格证明02肉品品质检验合格证03瘦肉精检测报告10农药残留检测报告20入境货物检验检疫证明30质检报告（生产加工环节）附录B（）追溯业务数据上报请求参数见B.1。表B.1追溯业务数据上报请求参数名称含义类型是否可空说明TRACE_TYPE追溯系统类型字符串否见附录A中的表A.2SEQ_ID流通顺序码字符串否见附录A中的表A.5BUSI_ID经营主体编码字符串否统一社会信用代码GOODS_ID商品条码字符串否符合GB12904的规定GOODS_NAME商品名称字符串否上报企业系统商品名称GOODS_NUM商品数量数值型否GOODS_UNIT计量单位字符串否KG-千克,L-升GOODS_PRICE商品单价数值型否元，保留小数点2位BATCH_ID批次码字符串否企业原批次码TRACE_ID追溯码字符串是追溯码时使用OPER_DESC内部环节信息字符串否见附录A中的表A.6VERIFY_IMG检测报告图片字符串是JPG格式BASE64编码字符串VERIFY_IMGS检测报告多图地址字符串是多个地址以逗号分隔VERIFY_MULTIIMG检测报告多图字符串是报告类型见附录A中的表A.7VERIFY检测数据数组型是JSON子节点VERIFY/COMPANY检测单位字符串否检测单位名称VERIFY/INSPECTOR检验员字符串否检验员名称VERIFY/DATE检测日期日期型否yyyy-MM-ddVERIFY/INHIBIT抑制率(%)数值型否如：22.6，保留小数点2位VERIFY/RESULT检测结果字符串否如：合格等MAKE_DATE生产日期日期型否yyyy-MM-ddVALID_DAYS保质期数值型否默认天VALID_TYPE保质期类型字符串是Y-年，M-月，D-日CONTACT_BATCH_ID关联批次码字符串是CONTACT_TRACE_ID关联追溯码字符串是CODE_NUM请求追溯码数量数值型否0100000果传0TRACE_ID市级平台上报直接传0SELL_COUNTRY销售地国家编码字符串是销售环节填写符合GB/T2659数字代码表B.1追溯业务数据上报请求参数（续）名称含义类型是否可空说明SELL_REGION销售地区编码字符串是6码（符合GB/T2260中规定的数字代码，否则为空请求格式示例见表B.2。表B.2请求格式{{"BIZ_TYPE":"traceDataRequest","REQ_TIME":"2020-01-1000:00:00","REQ_ID":"20200721084654qJJ2Jb","AUTH_ID":"20200609153209831756","PARAM":{"TRACE_TYPE":"追溯类型","SEQ_ID":"顺序码","BUSI_ID":"经营主体编码","GOODS_ID":"商品编码","GOODS_NAME":"商品名称","GOODS_NUM":"商品数量","GOODS_UNIT":"计量单位","GOODS_PRICE":"商品单价","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请求格式（续）{{"OPER_DATE":"2020-07-01","OPERATOR":"浸泡操作员",/r/