长威技术文档Word文件下载.docx

1、18.5.20V 1.3入境食品登记的“输入国家或地区”改为“原产国”；新增入境货物检验检疫证明写入（40W03）、查询（40Q03）接口；修改产地证明数据格式的“产地证明编号”、“产地证明名称”的英文名称；修订“食品基础信息”的“小包装明细”的节点名称18.5.28V 1.4新增第5.2.3章节、第8章节数据删除接口规范；修改第6章节，增加数据更新的说明；修改查询接口返回结果的节点；标注新增接口的主键；修改所属行业字段备注；调整查询接口中的查询条件18.6.15V 1.5修改保质期字段备注；修改食品基础信息，预包装食品类型，产地可以为空；食用农产品类型，产地非空；企业信息，证件类型、证件号码

2、可以为空；检验检测信息，检测报告编号可以为空；产地证明，产地证明编号可以为空；修改交易单据的查询条件为单据号1.范围本标准规定了福建省“一品一码”食品安全信息追溯管理平台（以下简称“一品一码”追溯管理平台）与各厅局及地市自建追溯系统数据交换的技术架构、接口规范、交换过程、数据交换规范等。本标准适用于“一品一码”追溯管理平台数据共享与数据交换服务。2.规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条段凡是注日期的引用文件。其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准。然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新

3、版本适用于本标准。GB/T 7408-2005 数据元和交换格式 信息交换 日期和时间表示法GB/T 18391.1-2002 信息技术 数据元的规范与标准 第一部分：数据元的规范与标准化框架GB/T 21062.1-2007 政务信息资源交换体系 第1部分：总体框架GB/T 21062.2-2007 政务信息资源交换体系 第2部分：技术要求GB/T 20162.2-2007 政务信息资源交换体系 第3部分：数据接口规范 3.术语和定义 下列术语和定义适用于本标准。（1） 福建省“一品一码”食品安全信息追溯管理平台福建省建立统一的福建省食品安全信息追溯管理平台，汇集相关行政主管部门追溯系统信息

4、，通过编码识别、身份信息比对等技术手段和验证管理实现追溯食品和生产经营者等信息的共享。（2） 一品一码一品一码指同一品种批次的食品和食用农产品按照规定的追溯编码规则，赋予唯一的识别追溯码。（3） 生产经营主体从事食品生产经营活动的政府、组织、单位、法人和自然人等具备食品追溯能力的单位和自然人。（4） 主体代码法人采用统一社会信用代码，由一组长度为18位的用于法人和其他组织身份识别的代码。统一社会信用代码由国家标准委发布。国家标准委发布了强制性国家标准法人和其他组织统一社会信用代码编码规则。针对自然人采用散户代码或身份证号码。（5） 生产经营许可生产经营许可证是许可证的一个类别之一，是县级以上食

5、品药品监管部门对食品生产与经营者颁发的允许进行食品生产经营的法定证件。（6） 食用农产品指在农业活动中直接获得的，以及经过分拣、去皮、剥壳、干燥、粉碎、清洗、切割、冷冻、打蜡、分级、包装等加工，但未改变其基本自然性状和化学性质的、供人食用的植物、动物、微生物及其产品。（7） 预包装食品指预先定量包装或者制作在包装材料和容器中的食品；包括预先定量包装以及预先定量制作在包装材质和容器中并且在一定量限范围内具有统一的质量或体积标识的食品。简单说，就是指在包装完成后即具有确定的量值，这一确定的量值应是在一定量限范围内具有统一的质量或体积标识。（8） 入境食品指从其他国家和地区进口的食品。（9） 入闽食

6、品指中国国内，福建省外的食品，通俗的讲就是其他省份和地区食品，包含在其他省份和地区生产并在福建省内分包装的食品。（10） 食品代码预包装食品的代码，由企业向中国物品编码中心申请，进行自主食品编码，并在中国物品编码中心备案；散装食品的代码，由各厅局负责源头赋码。（11） 食品追溯码指福建省质量技术监督局研究出台的福建省地方标准食品质量安全追溯码编码技术规范（DB35/T 1711-2017）规定的食品追溯码。（12） 源头准出指福建省源头厅局对种植产品、畜牧产品、水产品、生产产品、入境食品、入闽食品批准进入市场。（13） 数据提供方福建省“一品一码”食品安全信息追溯管理平台。（14） 用户与福建

7、省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的各厅局自建追溯系统以及福建省各地市自建追溯系统。（15） 数据项共享数据实体。（16） 数据集组成共享数据实体的集合。（17） 数据版本号共享数据在更新序列上的唯一标识。4.缩略语XML - 可扩展标识语言（eXtensible Markup Language）SOAP - 简单对象访问协议（Simple Object Access Protocol ） UDDI - 统一描述、发现和集成（ Universal Description，Discovery , and Integration） 5.接口调用规范身份验证接口通过“一品一码”

8、食品安全信息追溯管理平台调用各类接口时，必须先对调用方的用户身份及权限进行验证，本接口负责用户身份认证和权限验证功能。应用程序调用本接口进行身份认证和权限验证，通过后将获取身份校验码，用户通过该身份校验码才能访问其他接口。校验码的有效时间为30分钟。（1） 原型接口public String getVerifyCode（String userAccount, String password, String dataType）（2） 参数说明参数名说明是否必填dataType返回的数据格式否（0表示XML，1表示JSON；默认为XML）userAccount用户名（由“一品一码”食品安全信息追溯

9、管理平台统一分配）是password密码（由“一品一码”食品安全信息追溯管理平台统一分配）（3） 返回说明验证成功返回成功标识及身份校验码；错误则返回错误标识及错误信息。接口调用说明“一品一码”食品安全信息追溯管理平台的接口包括两类：数据接入类和对外服务类。数据接入类接口对外提供数据写入服务，对外服务类接口对外提供数据查询服务。数据接入接口定义public String writeObjectOut （String verifyCode, String jkId, String dataType, String writeXmlDoc，String fileNames,byte fileCon

10、tents）;序号备注1verifyCode身份校验码2jkId接口ID各接口所对应的ID编号，详见各接口说明3否返回的数据类型，0表示XML，1表示JSON；默认为XML4writeXmlDoc写入数据业务数据写入XML格式文档，附件数据通过以下附件字段进行上传。5fileNames附件名称数组附件名+类型，如2012012.xls6fileContents附件数据数组附件内容，byte字节（3） WriteXmlDoc参数示例root!zzcpzc为节点名称，具体节点名称由各接口定义，节点名称详见各接口说明；-zzcpzc entNameURLEncoder.encode（主体名称, UT

11、F-8）entUnicode主体代码/ entUnicode jyjcxxs为检验检测报告数据明细-jyjcxxsjyjcxxinspectionNo检测报告编号/inspectionNoinspectionName检测报告名称）/inspectionName/jyjcxx/jyjcxxs/zzcpzc/ root 对外服务接口定义public String queryObjectOut （String verifyCode, String jkId, String dataType,String queryXmlDoc）;接口所对应的ID编号，详见各接口说明。默认为XML。queryXmlDoc业务数据写入XML格式文档。（3） QueryXmlDoc参数示例查询条件-queryCondition/entType /entUnicode ./ queryCondition 数据删除接口定义public String deleteObjectOut （String verifyCode, String jkId, String dataType,String deleteXmlDoc）;deleteXmlDoc业务数据写入XML格式文档，附件数据通过以下附件