DB5101/T 2-2018 成都市食品检验检测交换数据接口规范

DB5101

四川省成都市地方标准

DB5101/T2-2018

成都市食品检验检测交换数据接口规范

2018-07-01发布2018-07-02实施

成都市质量技术监督局发布

DB5101/T2-2018

目次

前言II

引言III

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5交换要求2

5.1接口交换要求2

5.1.1接口基本要求2

5.1.2接口请求消息格式要求2

5.1.3接口消息参数格式约定2

5.1.4接口应答消息格式要求2

5.1.5接口传输格式2

5.2文件交换要求2

5.2.1文件交换基本要求2

5.2.2文件交换模板要求2

5.3交换安全要求2

附录A（资料性附录）接口传输格式要求3

I

DB5101/T2-2018

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由成都市食品药品监督管理局提出并归口。

本标准由成都市质量技术监督局批准。

本标准起草单位：成都市标准化研究院、成都市食品药品检验研究院。

本标准主要起草人：万渝平、王立山、叶梅、李南、罗军、刘莎、李茂春、向游江。

II

DB5101/T2-2018

引言

为进一步加强食品安全检验检测数据的融合利用，实现食品安全检验检测数据互联互通、共享共治，

消除信息孤岛，运用数据分析为食品监管提供决策支持，提升我市食品安全智慧监管现代化水平，根据

《中华人民共和国食品安全法》及其实施条例、《关于进一步加强食品药品安全工作的意见》（成委发

〔2016〕14号）等有关法律、法规和文件规定，统一食品检验检测信息数据规范，特制定我市食品检验

检测交换数据接口规范。

III

DB5101/T2-2018

成都市食品检验检测交换数据接口规范

1范围

本标准规定了食品检验检测交换数据接口的接口交换要求、文件交换要求以及交换安全要求。

本标准适用于成都市行政区域内的食品检验检测数据的交换。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

DB5101/T1-2018成都市食品检验检测数据交换规范

3术语和定义

下列术语和定义适用于本文件。

3.1

接口

计算机信息系统之间传送数据、交换信息的接口。

3.2

服务提供方

提供食品检验检测交换数据接口服务的机构。

3.3

数据提供方

通过服务提供方的接口进行食品检验检测数据交换的机构。

4缩略语

下列缩略语适用于本文件。

HTTPS安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer）

REST表述性状态转移（RepresentationalStateTransfer）

SOAP简单对象访问协议（SimpleObjectAccessProtocol）

XML扩展标记语言（ExtensibleMarkupLanguage）

1

DB5101/T2-2018

5交换要求

5.1接口交换要求

5.1.1接口基本要求

支持SOAP协议或REST架构。

采用HTTPS通讯协议进行同步通讯。

接口部署到服务提供方服务器上，通过Intranet/Internet提供服务。

5.1.2接口请求消息格式要求

请求消息以XML标签形式封装，数据对象及参数英文名即为XML消息中标签名，XML标签含有的英文

采用小写字母表示。

5.1.3接口消息参数格式约定

接口消息参数格式约定如下：

——各参数若无特别说明均为字符型。

——整数数值型参数不得存在除数字字符以外的其他字符。

——浮点数值型参数不得存在除小数点和数字字符以外的其他字符。

——日期型参数默认格式为“YYYY-MM-DD”。

——时间型参数默认格式为“hh:mm:ss”。

5.1.4接口应答消息格式要求

应答消息以XML标签形式封装，XML标签含有的英文采用小写字母表示，应答消息应包含对请求消息

进行处理的结果信息，包括：

——处理成功或失败的标志；

——处理成功或失败的原因说明。

5.1.5接口传输格式

接口传输格式见附录A。

5.2文件交换要求

5.2.1文件交换基本要求

采用HTTPS通讯协议进行同步通讯。

服务提供方应提供文件交换功能，通过Intranet/Internet提供服务。

5.2.2文件交换模板要求

服务提供方应提供文件交换模板，便于数据提供方填写数据后进行数据交换，文件交换模板参数格

式按5.1.3的规定执行。

5.3交换安全要求

服务提供方应提供提供数据交换安全保障措施。

2

DB5101/T2-2018

AA

附录A

（资料性附录）

接口传输格式要求

A.1接口定义

A.1.1请求消息格式

请求消息包括以下参数，描述见表A.1：

——pageNumber.cludove：返回记录的页数；

——recordNumber.cludove：每页返回记录数；

——token：身份认证加密字符串；

——format：消息格式；

——catalog.cludove：目录标识；

——test_info:检验检测交换数据信息，格式如下：

<data>

······

</data>

表A.1请求消息参数表

序号参数中文参数参数说明

1返回记录的页数pageNumber.cludove数值型，返回记录的页数

2每页返回记录数recordNumber.cludove数值型，每页返回记录数,0表示不分页

3身份认证加密字符串token字符型，身份认证信息加密字符串

4消息格式format字符型，值为xml或其他约定格式

5目录标识catalog.cludove字符型，目录标识

6交换数据信息test_info食品检验检测交换数据信息

A.1.2应答消息格式

a)应答消息参数表见表A.2。

b)应答消息格式：

<data>

<resultcode>处理结果代码</resultcode>

<resultinfo>处理结果信息</resultinfo>

</data>

表A.2应答消息参数表

序号参数中文参数参数说明

1处理结果代码resultcode结果代码：1-成功；0-失败

2处理结果信息resultinfo结果信息描述

3

DB5101/T2-2018

A.2接口实例

A.2.1抽样检验基本信息接口

A.2.1.1请求消息格式

请求消息包括以下参数，描述见表A.3：

——pageNumber.cludove：返回记录的页数；

——recordNumber.cludove：每页返回记录数；

——token：身份认证加密字符串；

——format：消息格式；

——catalog.cludove：目录标识；

——test_info:检验检测交换数据信息（抽样检验基本信息），格式如下：

<data>

<samplelistno>抽样单编号</samplelistno>

<tasksource>任务来源</tasksource>

······

<fillper>填报人</fillper>

<filldate>填报日期</filldate>

<attach>附件</attach>

</data>

表A.3抽样检验基本信息参数表

序号参数中文参数参数说明

1返回记录的页数pageNumber.cludove数值型，返回记录的页数

2每页返回记录数recordNumber.cludove数值型，每页返回记录数,0表示不分页

3身份认证加密字符串token字符型，身份认证信息加密字符串

4消息格式format字符型，值为xml或其他约定格式

5目录标识catalog.cludove字符型，值固定为save.cy.testinfo

6抽样单编号samplelistno

7任务来源tasksource按照《成都市食品检验检测数据交换规范》4.2.1的

8检验目的/任务类别tasktype规定执行

9食品类别foodtype

被抽样单位信息

10单位名称submitunit

11区域类型areatype

12单位所在行政区划areacode

13单位详细地址submitunitaddr按照《成都市食品检验检测数据交换规范》4.2.1的

14单位邮编zipcode规定执行

15单位负责人legalperofsubmitunit

16单位联系人contactorofsubmitunit

17联系电话submitunittel

4

DB5101/T2-2018

表A.3（续）

序号参数中文参数参数说明

18统一社会信用代码uniscid

19组织机构代码orgcode

20营业执照号buslicenseno

按照《成都市食品检验检测数据交换规范》4.2.1的

21单位许可证类别licensename

规定执行

22单位许可证号licenseno

23抽样地点drawplace

24GPS信息gpsinfo

样品信息

25样品来源samplesource

26样品属性sampleattr

27样品类型sampletype

28样品名称samplename

29商标brand

30规格型号samplespec

31样品日期类型datetype

32生产/购进/加工日期getsampledate

33样品批号batchno

34保质期qualityperiod

35执行标准/技术文件standard

36质量等级qualitylevel

按照《成都市食品检验检测数据交换规范》4.2.1的

37生产许可证编号prolicenseno

规定执行

38单价unitprice

39是否出口isexport

40抽样基数/批量base