安徽省食品安全快速检测数据共享接口规范.doc.doc

安徽省食品安全快速检测数据共享 接口规范 第1章 概述 5 1.1 文档说明 5 1.2 术语定义 5 1.3 交互模式 5 1.4 身份验证 5 第2章 数据采集接口规范 6 2.1 概述 6 2.2 采集接口 6 第3章 数据字典更新接口 9 3.1 概述 9 3.2 字典接口 9 3.3 需要更新的表名称 11 3.4 表字段描述 11 3.5 更新内容的格式XML 12 第4章 附录 13 第1章 概述 1.1 文档说明 本文档定义了食品安全快速检测仪器信息采集和基础数据同步接口规范，请食品快速检测仪器生产厂家按此规范对各自仪器软件系统进行修改，以便接入安徽省食品安全快速检测信息共享平台。 1.2 术语定义 客户端：指检测仪器端。 服务端：指安徽省食品安全快速检测信息共享平台。 1.3 交互模式 该系统接口采用标准的webservice接口。客户端发送请求到服务端，服务端处理后响应，将结果返回给客户端。 1.4 身份验证 检测仪器的使用单位基本信息（如单位名称、联系人等）、检测仪器本身的信息（如仪器型号、编号等）需要提供给服务端备案，以便服务端进行信息验证。 服务端提供用户名、密码(32位MD5码)给客户端，用于生成客户端key和服务端对客户端身份合法性进行验证。 第2章 数据采集接口规范 2.1 概述 制定本规范的目的是使得各食品快速检测仪器生产厂家通过适当修改设备支撑软件，调用标准接口自动上传快检数据至省局快检数据库，实现全省食品安全快速检测数据自动归集。 为保证传输数据的准确性及完善性，接口使用WebService接口，SOAP协议。接口地址为:5680/kjsys_new/webservice/instrumentDockingServiceProviderService?wsdl 2.2 采集接口 接口名称：instrumentInfoHandle 接口请求参数： 序号 字段描述 数据类型 示例数据 备注 是否必填项 验证信息 userName 用户名 String 5006150 明确用户名即仪器生产厂家编号 是 key KEY String 25d5512343aa400af412346d713c07ad MD5(用户名+密码（MD5码）+检测时间+仪器编号+抑制率或检测含量+检测结果)，加密采用utf-8编码 是 interfaceVersion 接口版本号 String 1.0 仪器信息 instrument 仪器类型 String Zyd-Smart-2 是 instrumentNo 仪器编号 String Zyd-002【厂商编号+序列号】 如果无序列号，需厂商提供厂商内部仪器唯一编号 是 gps GPS String 34.12，101.52 经度，纬度 否 mac MAC String 2C-83-45-0B-20-3C 是 样品信息 fTpye 种类编号 String 1023 例如水果干制品编号 是 fName 名称 String 白菜 是 tradeMark 商标 String 否 foodcode 产品条形码 String 693412000230003 否 proBatch 产品批次 String 否 proDate 生产/加工日期 String （YYYY-MM-DD） 否 proSpecifications 产品规格 String 否 manuUnit 产品生产企业 String ***食品有限公司 否 检测信息 checkedNo 抽检单号 String 否 sampleNo 样品编号 String 样品编号：格式=YYMMDD+样品记录号 样品记录号为使用单位的样品记录号 是 checkedUnit 被检企业编号 String 工商注册号 可设置为0，表示不启用 是 dataNum 记录编号 String 01 检测结果编号 是 testPro 检测项目编号 String 3453 例如二氧化硫编号 是 quanOrQual 检测结果类型 String 1 1、定量；2、定性 是 contents 抑制率或检测含量 String 90 检测农残时为抑制率，其它为检测含量 是 unit 检测单位 String mg/kg 否 testResult 检测结果 String 合格 是 dilutionRa 稀释倍数 String 0.5 否 testRange 检测范围 String 0.5~1.5 否 standardLimit 标准限量 String 50 否 base