长威技术文档.docx
《长威技术文档.docx》由会员分享，可在线阅读，更多相关《长威技术文档.docx（75页珍藏版）》请在冰豆网上搜索。
长威技术文档
福建省“一品一码”食品安全信息
追溯管理平台
追溯数据交换共享服务标准
文件更改摘要
日期
版本号
修订说明
修订人
审核人
批准人
18.3.22
V1.0
创建全文
18.4.7
V1.1
增加食品交易单据、内部小包装配置表、检验报告类型3个问题
18.4.26
V1.2
调整了专用术语、增加了基础代码类型
18.5.20
V1.3
入境食品登记的“输入国家或地区”改为“原产国”；新增入境货物检验检疫证明写入（40W03）、查询（40Q03）接口；修改产地证明数据格式的“产地证明编号”、“产地证明名称”的英文名称；修订“食品基础信息”的“小包装明细”的节点名称
18.5.28
V1.4
新增第5.2.3章节、第8章节数据删除接口规范；修改第6章节，增加数据更新的说明；修改查询接口返回结果的节点；标注新增接口的主键；修改所属行业字段备注；调整查询接口中的查询条件
18.6.15
V1.5
修改保质期字段备注；修改食品基础信息，预包装食品类型，产地可以为空；食用农产品类型，产地非空；企业信息，证件类型、证件号码可以为空；检验检测信息，检测报告编号可以为空；产地证明，产地证明编号可以为空；修改交易单据的查询条件为单据号
1.范围
本标准规定了福建省“一品一码”食品安全信息追溯管理平台（以下简称“一品一码”追溯管理平台）与各厅局及地市自建追溯系统数据交换的技术架构、接口规范、交换过程、数据交换规范等。
本标准适用于“一品一码”追溯管理平台数据共享与数据交换服务。
2.规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条段．凡是注日期的引用文件。
其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准。
然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本标准。
GB/T7408-2005数据元和交换格式信息交换日期和时间表示法
GB/T18391.1-2002信息技术数据元的规范与标准第一部分：
数据元的规范与标准化框架
GB/T21062.1-2007政务信息资源交换体系第1部分：
总体框架
GB/T21062.2-2007政务信息资源交换体系第2部分：
技术要求
GB/T20162.2-2007政务信息资源交换体系第3部分：
数据接口规范
3.术语和定义
下列术语和定义适用于本标准。
（1）福建省“一品一码”食品安全信息追溯管理平台
福建省建立统一的福建省食品安全信息追溯管理平台，汇集相关行政主管部门追溯系统信息，通过编码识别、身份信息比对等技术手段和验证管理实现追溯食品和生产经营者等信息的共享。
（2）一品一码
一品一码指同一品种批次的食品和食用农产品按照规定的追溯编码规则，赋予唯一的识别追溯码。
（3）生产经营主体
从事食品生产经营活动的政府、组织、单位、法人和自然人等具备食品追溯能力的单位和自然人。
（4）主体代码
法人采用统一社会信用代码，由一组长度为18位的用于法人和其他组织身份识别的代码。
统一社会信用代码由国家标准委发布。
国家标准委发布了强制性国家标准《法人和其他组织统一社会信用代码编码规则》。
针对自然人采用散户代码或身份证号码。
（5）生产经营许可
生产经营许可证是许可证的一个类别之一，是县级以上食品药品监管部门对食品生产与经营者颁发的允许进行食品生产经营的法定证件。
（6）食用农产品
指在农业活动中直接获得的，以及经过分拣、去皮、剥壳、干燥、粉碎、清洗、切割、冷冻、打蜡、分级、包装等加工，但未改变其基本自然性状和化学性质的、供人食用的植物、动物、微生物及其产品。
（7）预包装食品
指预先定量包装或者制作在包装材料和容器中的食品；包括预先定量包装以及预先定量制作在包装材质和容器中并且在一定量限范围内具有统一的质量或体积标识的食品。
简单说，就是指在包装完成后即具有确定的量值，这一确定的量值应是在一定量限范围内具有统一的质量或体积标识。
（8）入境食品
指从其他国家和地区进口的食品。
（9）入闽食品
指中国国内，福建省外的食品，通俗的讲就是其他省份和地区食品，包含在其他省份和地区生产并在福建省内分包装的食品。
（10）食品代码
预包装食品的代码，由企业向中国物品编码中心申请，进行自主食品编码，并在中国物品编码中心备案；散装食品的代码，由各厅局负责源头赋码。
（11）食品追溯码
指福建省质量技术监督局研究出台的福建省地方标准《食品质量安全追溯码编码技术规范》（DB35/T1711-2017）规定的食品追溯码。
（12）源头准出
指福建省源头厅局对种植产品、畜牧产品、水产品、生产产品、入境食品、入闽食品批准进入市场。
（13）数据提供方
福建省“一品一码”食品安全信息追溯管理平台。
（14）用户
与福建省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的各厅局自建追溯系统以及福建省各地市自建追溯系统。
（15）数据项
共享数据实体。
（16）数据集
组成共享数据实体的集合。
（17）数据版本号
共享数据在更新序列上的唯一标识。
4.缩略语
XML--可扩展标识语言（eXtensibleMarkupLanguage）
SOAP--简单对象访问协议（SimpleObjectAccessProtocol）
UDDI--统一描述、发现和集成（UniversalDescription，Discovery,andIntegration）
5.接口调用规范
身份验证接口
通过“一品一码”食品安全信息追溯管理平台调用各类接口时，必须先对调用方的用户身份及权限进行验证，本接口负责用户身份认证和权限验证功能。
应用程序调用本接口进行身份认证和权限验证，通过后将获取身份校验码，用户通过该身份校验码才能访问其他接口。
校验码的有效时间为30分钟。
（1）原型接口
publicStringgetVerifyCode（StringuserAccount,Stringpassword,StringdataType）
（2）参数说明
参数名
说明
是否必填
dataType
返回的数据格式
否（0表示XML，1表示JSON；默认为XML）
userAccount
用户名（由“一品一码”食品安全信息追溯管理平台统一分配）
是
password
密码（由“一品一码”食品安全信息追溯管理平台统一分配）
是
（3）返回说明
验证成功返回成功标识及身份校验码；错误则返回错误标识及错误信息。
接口调用说明
“一品一码”食品安全信息追溯管理平台的接口包括两类：
数据接入类和对外服务类。
数据接入类接口对外提供数据写入服务，对外服务类接口对外提供数据查询服务。
数据接入接口定义
（1）原型接口
publicStringwriteObjectOut（StringverifyCode,StringjkId,StringdataType,StringwriteXmlDoc，String[]fileNames,byte[]fileContents）;
（2）参数说明
序号
参数名
说明
是否必填
备注
1
verifyCode
身份校验码
是
2
jkId
接口ID
是
各接口所对应的ID编号，详见各接口说明
3
dataType
返回的数据格式
否
返回的数据类型，0表示XML，1表示JSON；默认为XML
4
writeXmlDoc
写入数据
是
业务数据写入XML格式文档，附件数据通过以下附件字段进行上传。
5
fileNames
附件名称数组
否
附件名+类型，如2012012.xls
6
fileContents
附件数据数组
否
附件内容，byte字节
（3）WriteXmlDoc参数示例
xmlversion="1.0"encoding="utf-8"?
>
—zzcpzc为节点名称，具体节点名称由各接口定义，节点名称详见各接口说明；-->
—参数需要通过URLEncoder.encode方式进行编码—>
URLEncoder.encode（"主体名称","UTF-8"）
URLEncoder.encode（"主体代码","UTF-8"）
……
—jyjcxxs为检验检测报告数据明细-->
URLEncoder.encode（"检测报告编号","UTF-8"）
URLEncoder.encode（"检测报告名称","UTF-8"）
……
……
对外服务接口定义
（1）原型接口
publicStringqueryObjectOut（StringverifyCode,StringjkId,StringdataType,
StringqueryXmlDoc）;
（2）参数说明
序号
参数名
说明
是否必填
备注
1
verifyCode
身份校验码
是
2
jkId
接口ID
是
接口所对应的ID编号，详见各接口说明。
3
dataType
返回的数据格式
否
返回的数据类型，0表示XML，1表示JSON；默认为XML。
4
queryXmlDoc
写入数据
是
业务数据写入XML格式文档。
（3）QueryXmlDoc参数示例
xmlversion="1.0"encoding="utf-8"?
>
—查询条件-->
—参数需要通过URLEncoder.encode方式进行编码—>
URLEncoder.encode（"主体名称","UTF-8"）
URLEncoder.encode（"主体代码","UTF-8"）
…….
数据删除接口定义
（1）原型接口
publicStringdeleteObjectOut（StringverifyCode,StringjkId,StringdataType,
StringdeleteXmlDoc）;
（2）参数说明
序号
参数名
说明
是否必填
备注
1
verifyCode
身份校验码
是
2
jkId
接口ID
是
各接口所对应的ID编号，详见各接口说明
3
dataType
返回的数据格式
否
返回的数据类型，0表示XML，1表示JSON；默认为XML
4
deleteXmlDoc
写入数据
是
业务数据写入XML格式文档，附件数据通过以下附件
升级会员 