SZDBZ 220-2016 食品安全追溯 数据接口规范

ICS 35.240.60X07SZDB/Z深圳市标准化指导性技术文件SZDB/Z220—2016食品安全追溯数据接口规范FoodSafetyTraceabilityDataInterfaceSpecification2016-12-28发布2017-02-01实施深圳市市场监督管理局发布SZDB/Z220—2016I目次前言................................................................................II 1范围...............................................................................1 2术语与定义.........................................................................1 数据接口datainterface............................................................1 3缩略语.............................................................................1 4接口方法及调用说明.................................................................1 4.1接口传输要求...................................................................1 4.2对外提供服务的数据接口.........................................................1 4.2.1零售商相关商品调用接口........................................................1 4.2.2商品标签详情调用接口..........................................................2 4.2.3食品生产许可信息调用接口......................................................3 4.2.4产品检验报告调用接口..........................................................4 4.2.5商品供应关系调用接口..........................................................5 4.2.6根据供应关系调用商品列表接口..................................................6 4.2.7新品列表调用接口..............................................................7 4.2.8零售商相关供应商列表调用接口..................................................8 4.2.9企业信息调用接口..............................................................9 4.2.10企业证照调用接口............................................................10 4.2.11供应商索证关系调用接口......................................................10 4.2.12无流通索证商品调用接口......................................................11 4.2.13商品索证信息调用接口........................................................12 4.2.14新品审核结果调用接口........................................................13 4.2.15审核信息回传接口............................................................15 4.2.16基础证照类型调用接口........................................................15 4.3从外部获取服务的数据接口......................................................16 4.3.1证照数据导入接口.............................................................16 4.3.2企业证照附件导入接口.........................................................17 SZDB/Z220—2016II前 言本标准按照GB/T1.1-2009给出的规则编写。本标准由深圳市市场监督管理局提出并归口。本标准起草单位：深圳市标准技术研究院。本标准主要起草人：孙勇、余译民、杨兴兴、谭民浠、李德平、汪彩艳、李春雷、徐立峰、苏巍、周哲、练晓、郭静文。SZDB/Z220—20161食品安全追溯数据接口规范 1范围本标准规定了食品安全追溯各信息系统间进行数据交换的各类数据接口方法和调用说明。本标准适用于食品安全追溯各信息系统间的接口调用和数据交换。2术语与定义2.1数据接口datainterface计算机软件系统之间传送数据、交换信息的接口，以电子文件的形式实现。3缩略语下列缩略语适用于本文件。JSON：JavaScript对象表示法（JavascriptObjectNotation）GUID：全局唯一标识符（GloballyUniqueIdentifier）4接口方法及调用说明4.1接口传输要求接口使用JSON传输数据，具备通用性和可扩展性。4.2对外提供服务的数据接口4.2.1零售商相关商品调用接口4.2.1.1接口方法及说明接口标识符：GetProductList接口说明：用户验证帐号密码及所需查询的零售商商品的相关条件，即可调取到该零售商对应的商品列表信息。4.2.1.2接口输入参数及说明零售商相关商品调用接口输入参数及说明见表1。表1零售商相关商品调用接口输入参数及说明输入参数非空说明userAccount是用户的账号SZDB/Z220—20162表1零售商相关商品调用接口输入参数及说明（续）输入参数非空说明Password是用户的密码，md5加密后的密文dataMainID是零售商IDsupplyState否供应状态（可选搜索条件）firLevelSort否商品一级分类（可选搜索条件）secondLevelSort否商品二级分类（可选搜索条件）BarCode否条形码（可选搜索条件）ProductName否商品名称（可选搜索条件）ProductBrand否商品品牌（可选搜索条件）Page否页码（可选条件，默认1）Rows否每页行数（可选条件，默认15）isEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.1.3接口返回参数及说明零售商相关商品调用接口返回参数及说明见表2。表2零售商相关商品调用接口返回参数及说明返回参数非空说明dataBarCode否商品条形码（列表内容）QSList否QS或SC编号Brand否品牌（列表内容）ProductName否商品名称（列表内容）SortDic否分类（列表内容）NetContent否净含量/规格（列表内容）SupplyState否状态（列表内容）ProductID否商品ID（列表内容）Count否总数isEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.2商品标签详情调用接口4.2.2.1接口方法及说明接口标识符：GetProductLabel接口说明：用户验证帐号密码及输入想要查询商品的GUID后，即可获取到这个商品的标签信息。4.2.2.2接口输入参数及说明商品标签详情调用接口输入参数及说明见表3。SZDB/Z220—20163表3商品标签详情调用接口输入参数及说明输入参数非空说明userAccount是用户的账号password是用户的密码，md5加密后的密文dataProductID否商品IDisEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.2.3接口返回参数及说明商品标签详情调用接口返回参数及说明见表4。表4商品标签详情调用接口返回参数及说明返回参数非空说明dataProductID否商品IDBarCode否商品条形码ProductName否商品名称BrandID否品牌IDBrand否品牌NetContent否净含量/规格StandradCode否状态ExpirationDateText否保质期ProductContent否成份与配料StorageCondition否贮存条件NutritionTable否营养成分表IsGreenFood否是否绿色食品IsOrganicFood否是否有机食品IsHealthFood否是否为保健食品IsTransgeneFood否是否为转基因食品IsImportFood否是否为进口食品FirLevelSort否食品第一大类SecondLevelSort否食品第二小类ThirdLevelSort否食品第三小类ProductQS否QS或SC编号FoodAreaInfo否商品流通地区ImageUrl否商品图片(用|间隔)isEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.3食品生产许可信息调用接口4.2.3.1接口方法及说明接口标识符：GetQSSZDB/Z220—20164接口说明：用户验证帐号密码及输入想要查询商品的GUID后，即可获取到这个商品的QS号或SC信息表。4.2.3.2接口输入参数及说明食品生产许可信息调用接口输入参数及说明见表5。表5食品生产许可信息调用接口输入参数及说明输入参数非空说明userAccount是用户的账号password是用户的密码，md5加密后的密文dataProductID否商品IDisEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.3.3接口返回参数及说明食品生产许可信息调用接口返回参数及说明见表6。表6食品生产许可信息调用接口返回参数及说明返回参数非空说明dataQSID否QSID（列表内容）QSNO否QS或SC编号（列表内容）ManufacturerName否生产商名称（列表内容）ManufacturerAddress否生产商地址（列表内容）BriefFileUrl否缩略图URL（列表内容）FileUrl否图片URL（列表内容）isEncrypt是若为true，则data为加密信息；若为false，data为明文信息4.2.4产品检验报告调用接口4.2.4.1接口方法及说明接口标识符：GetDetection接口说明：用户验证帐号密码及输入想要查询商品的GUID后，即可获取到这个商品的检验报告列表。4.2.4.2接口输入参数及说明产品检验报告调用接口输入参数及说明见表7。表7产品检验报告调用接口输入参数及说明输入参数非空说明userAccount是用户的账号password是用户的密码，md5加密后的密文dataProductID否商品IDSZDB/ZXXXXX—XXXX5表7产品检验