1、福建省“一品一码”食品安全信息追溯管理平台项目地市数据交换共享服务标准福建省食品药品监督管理局文件更改摘要日期版本号修订说明修订人审核人批准人18322V1.0创建全文1847V1.1增加食品交易单据、内部小包装配置表、检验报告类型3个问题18.4.26V1.2调整了专用术语、增加了基础代码类型18.5.18V1.3进货单据表增加“关联销货单据”字段；销售单据表增加“关联进货单据号”字段；将入境货物检验检疫证明从检验检测中独立；调整订餐主体代码的字段长度；统一修改登记主体代码regEntld为regEntUnicode；修改合格方式CA015为CA014;修改接
2、口ID为21W03的节点entInfo为entLicense;调整产地证明编号字段为inspectionNo，产地证明名称字段为inspectionName、产地证明文件字段为inspectionReport；18.5.20V1.4增加餐饮加工数据写入接口(32W03);修改接口12W02节点为fpProduct;修订“食品基础信息”的“小包装明细”、餐饮进货台账、餐饮销货台账的节点名称18.5.26V1.5接口22W01增加关联销货单据字段；修改接口22W01节点fcEntryFJBill为fcStockBill;修改错误的文字说明；增加
3、第5.2.2章节、第7章节数据删除接口规范；修订第6章，增加数据修改说明；修改所属行业的字段备注18.6.15V1.6修改保质期字段备注；修改食品基础信息，预包装食品类型，产地可以为空；食用农产品类型，产地非空；企业信息，证件类型、证件号码可以为空；检验检测信息，检测报告编号可以为空；产地证明，产地证明编号可以为空；增加第5.2.3章节、第8章节，查询接口18.6.19V1.7检验检测报告新增检测有效期至字段；修改订餐主体信息中的订餐人姓名、订餐人联系方式、地址的字段名称18.8.13V1.8主体信息、销货台账、餐饮类型的食品基础数据格式，增加许可证号，餐饮类型
4、主体，主体代码、许可证号只要一个不为空即可；修改经营范围字段长度为400018.9.3V1.9增加6.1.2.4、6.224、6.3.2.4章节，食品处理台账数据交换标准18.9.21V1.10主体数据格式增加“所属市场ID”字段；增加8.1.3章节1.范围12.规范性引用文件13.术语和定义14.缩略语35.接口调用规范35.1身份验证接口35.2接口调用说明45.2.1数据接入接口定义45.2.2数据删除接口定义55.2.3数据查询接口定义65.3返回数据格式65.3.1XML格式65.3.2JSON格式75.3.3标识码定义76.数据写入更新
5、标准规范86.1生产型主体86.1.1基础数据86.1.2台账数据146.1.3上市凭证186.2流通型主体216.2.1基础数据216.2.2台账数据266.2.3上市凭证316.3餐饮服务者346.3.1基础数据346.3.2台账数据396.3.3上市凭证437.数据删除标准规范467.1生产型主体467.1.1基础数据467.1.2台账数据487.1.3上市凭证497.2流通型主体507.2.1基础数据507.2.2台账数据527.2.3上市凭证537.3餐饮服务者547.3.1基础数据547.3.2台账数据567.3.3上市凭证578.数据查询接口规范588.1基础
6、数据588.1.1生产经营主体信息查询588.1.2食品基础信息查询598.1.3市场信息查询618.2交易数据628.2.1食品交易单据629.单据码编码规则639.1省直单位建设追溯系统单据码639.2各地市建设追溯系统单据码649.3企业建设追溯系统单据码6410.注意事项641.范围本标准规定了福建省“一品一码”食品安全信息追溯管理平台(以下简称“一品一码”追溯管理平台)与福建省地市自建追溯系统数据交换的技术架构、接口规范、交换过程、数据交换规范等。本标准适用于地市自建系统与“一品一码”追溯管理平台数据共享与数据交换服务。2.规范性引用文件下列文件中的条款
9、。统一社会信用代码由国家标准委发布。国家标准委发布了强制性国家标准法人和其他组织统一社会信用代码编码规则。针对自然人采用散户代码或身份证号码。（5）生产经营许可生产经营许可证是许可证的一个类别之一，是县级以上食品药品监管部门对食品生产与经营者颁发的允许进行食品生产经营的法定证件。（6）食用农产品指在农业活动中直接获得的，以及经过分拣、去皮、剥壳、干燥、粉碎、清洗、切割、冷冻、打蜡、分级、包装等加工，但未改变其基本自然性状和化学性质的、供人食用的植物、动物、微生物及其产品。（7）预包装食品指预先定量包装或者制作在包装材料和容器中的食品；包括预先定量包装以及预先定量制作在包装材质和容器中
10、并且在一定量限范围内具有统一的质量或体积标识的食品。简单说，就是指在包装完成后即具有确定的量值，这一确定的量值应是在一定量限范围内具有统一的质量或体积标识。（8）入境食品指从其他国家和地区进口的食品。（9）入闽食品指中国国内，福建省外的食品，通俗的讲就是其他省份和地区食品，包含在其他省份和地区生产并在福建省内分包装的食品。（10）食品代码预包装食品的代码，由企业向中国物品编码中心申请，进行自主食品编码，并在中国物品编码中心备案；散装食品的代码，由各厅局负责源头赋码。（11）食品追溯码指福建省质量技术监督局研究出台的福建省地方标准食品质量安全追溯码编码技术规范（DB35/T1711-2
11、017）规定的食品追溯码。（12）数据提供方福建省“一品一码”食品安全信息追溯管理平台。（13）用户与福建省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的全省生产经营主体自建追溯管理平台。（14）数据项共享数据实体。（15）数据集组成共享数据实体的集合。（16）数据版本号共享数据在更新序列上的唯一标识。4.缩略语XML-可扩展标识语言（eXtensibleMarkupLanguageSOAP-简单对象访问协议（SimpleObjectAccessProtocol）UDDI-统一描述、发现和集成（UniversalDescription,Discovery,
14、eContents);(2)参数说明序号参数名说明是否必填备注1verifyCode身份校验码是2jkld接口ID是各接口所对应的ID编号，详见各接口说明3dataType返回的数据格式否返回的数据类型，0表示XML，1表示JSON;默认为XML4writeXmlDoc写入数据是业务数据写入XML格式文档，附件数据通过以下附件字段进行上传。5fileNames附件名称数组否附件名+类型，如2012012.xls6fileContents附件数据数组否附件内容，byte字节WriteXmlDoc参数示例 15、ng="utf-8"> 16、gt; 17、明是否必填备注1verifyCode身份校验码是2jkId接口ID是各接口所对应的ID编号，详见各接口说明3dataType返回的数据格式否返回的数据类型，0表示XML,1表示JSON;默认为XML4deleteXmlDoc写入数据是业务数据写入XML格式文档，附件数据通过以下附件字段进行上传。DeleteXmlDoc参数示例 18、URLEncoder.encode方式进行编码一> 19、ifyCode身份校验码是2jkId接口ID是各接口所对应的ID编号，详见各接口说明3dataType返回的数据格式否返回的数据类型，0表示XML,1表示JSON;默认为XML4queryXmlDoc写入数据是查询字段写入XML格式文档。QueryXmlDoc参数示例 20、Name>URLEncoder.encode（”主体名称","UTF-8"） 22、息533标识码定义编码编码说明-2业务异常-1系统异常00操作成功01逻辑业务出错02参数信息不能为空！07账号或密码错误！10xml格式解析异常14身份认证码超时6.数据写入更新标准规范6.1生产型主体6.1.1基础数据6.1.1.1原料供货商信息接口ID:11W01(2)节点名称：entinfo(3)接口说明：用于写入、更新生产主体的原料供货商数据。同一主键数据,重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1原料供货商类型entType1非空。CA0012原料供货商名称entName300非空3原料供货商代码entUnicod 26、场ID或农贸市场ID市场ID根据8.1.3章节获取返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.1.1.2销货主体信息接口ID:11W02(2)节点名称：entInfo(3)接口说明：用于写入、更新生产主体的销货主体数据。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1销货主体类型entType1非空。CA0012销货主体名称entName300非空3销货主体代码entUnicode18生产经营类别”为“餐饮服务者”时。主体代码与食品经营许可证号/餐饮许可证号 29、lEmail6421所属国家nation8非空。GB/T265922所属省行政区划provinceAdminDivision8销货主体类型为企事业单位、自然人时，非空。GBT226023所属市行政区划cityAdminDivision8销货主体类型为企事业单位、自然人时，非空。GBT226024所属区县行政区划areaAdminDivision8销货主体类型为企事业单位、自然人时，非空。GBT226025所属市场IDbelongMarket32主体所属批发市场ID或农贸市场ID市场ID根据8.1.3章节获取(5)返回说明写入成功返回成功标识，失败则返回失败标识及原因 30、，具体返回格式详见【返回数据格式】定义说明。6.1.1.3生产经营许可(1)接口ID:11W03(2)节点名称：entLicense(3)接口说明：用于原料供货商、销货主体的生产经营许可证写入、更新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1主体名称entName300非空。关联生产经营主体表主体名称序号中文名称英文名称长度备注2主体代码entUnicode18非空。关联生产经营主体表主体代码。法人采用统一社会信用代码，自然人采用散户代码或身份证号码3许可证类型licenseType1非空。CA0084许 31、可证编号licenseNo32非空。唯一标识5发证日期licIssueDate14非空，格式yyyyMMdd6有效期至licValidEndDate14非空，格式yyyyMMdd7许可证图片licensePic非空，以附件方式上传，文件大小不超过5M。8备注remark300返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.1.1.4食品基础信息接口ID:11W04(2)节点名称：foodProduct(3)接口说明：用于生产主体进货原料、生产食品的基础数据信息写入、更新同一主键数据，重复上传，将更新该记录数据，只允许更新 32、自己上传的数据。(4)写入参数:序号中文名称英文名称长度备注1食品代码productCode32非空。唯一标识2食品名称productName256非空3食品类型productType1非空。CA0094产地类型placeType1非空。CA0055生产主体名称entName300非空。关联生产经营主体表主体名称6生产主体代码entUnicode18非空。关联生产经营主体表主体代码序号中文名称英文名称长度备注7商标trademark1288保质期expiryDate32请输入数值+单位（年、月、天）格式，例如：180天。9食用农产品类别agrProductCategory32食品类 33、型为食用农产品时，必填。CA01510预包装食品类别productcategory32食品类型为预包装食品时，必填。CA01011规格specification6412产地placeOfOrigin64预包装食品类型，可以为空；食用农产品类型，非空13原产国nation8产地类型为进口食品时，必填。GB/T265914计量单位measurementUnit64非空。15食品图片productPic以附件方式上传，文件大小不超过5M。16备注remark30017小包装明细xbzmxs用于记录大包装食品内还含有多个小包装食品的关系数据。如：箱装牛奶内含多个小盒牛奶、大箱矿泉水内含 34、多个小瓶矿泉水。内部小包装明细参数：（节点xbzmx）序号中文名称英文名称长度备注1小包装食品代码smallProductCode32非空。关联食品基础信息表的食品代码2小包装食品数量containsNum18非空3小包装食品计量单位measurementUnit64非空。4备注remark300（5）返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明6.1.2台账数据6.1.2.1原料进货单据接口ID:12W01节点名称：fpStockBill(3)接口说明：用于原料进货单据及明细写入、更新。同一主键数据，重复上传，将更新该记录 35、数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1单据号billNo50非空。唯一标识。单据号规则见第9章节2登记主体名称regEntName300非空。关联生产经营主体表主体名称3登记主体代码regEntUnicode18非空。关联生产经营主体表主体代码4交易日期tradeDate14非空。格式yyyyMMddHHmmss5供货主体名称supplyEntName300非空，关联原料供货商表的主体名称6供货主体代码supplyEntUnicode18非空，关联原料供货商表的主体代码7备注remark3008关联销货单据refSalesBillNo50关联上游 36、的销货单据号9进货单据明细fpStockDetails原料进货单据明细，可传多条明细，详细参数如下表：原料进货单据明细参数：(节点fpStockDetail)序号中文名称英文名称长度备注1食品追溯码traceCode64非空2食品代码productCode32非空，关联食品基础信息表的食品代码3食品名称productName256非空，关联食品基础信息表的食品名称序号中文名称英文名称长度备注4批次batch32非空5生产日期productDate14非空。格式yyyyMMddHHmmss6交易数量tradeNum18非空7计量单位measurementUnit64非空。8顺序号orde 37、rNum89备注remark300(5)返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.122生产台账登记(1)接口ID:12W02(2)节点名称：fpProduct(3)接口说明：用于生产主体的生产台账登记数据写入、更新。同一主键数据,重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1登记主体名称regEntName300非空。关联生产经营主体表主体名称2登记主体代码regEntUnicode18非空。关联生产经营主体表主体代码3食品追溯码traceCode64非空。唯一标识4 38、食品代码productCode32非空，关联食品基础信息表的食品代码5食品名称productName256非空，关联食品基础信息表的食品名称6批次batch32非空7生产日期productDate14非空，格式yyyyMMddHHmmss8生产数量tradeNum18非空9计量单位measurementUnit64非空。10备注remark300返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.123销售单据登记接口ID:12W03(2)节点名称：fpSalesBill(3)接口说明：用于主体的销售单据及明细写入、更新。同一主键 39、数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1单据号billNo50非空。唯一标识。单据号规则见第9早节2登记主体名称regEntName300非空。关联生产经营主体表主体名称3登记主体代码regEntUnicode18非空。关联生产经营主体表主体代码4交易日期tradeDate14非空。格式yyyyMMddHHmmss5收货主体名称receiveEntName300非空，关联销货主体表的主体名称6收货主体代码receiveEntUnicode18必须有一个不为空7收货主体食品经营许可证号/餐饮许可证号receiveEntO 40、rgNo328备注remark50非空9关联进货单据号refStockBillNo50关联下游的进货单据号10销售单据明细fpSalesDetails销售单据明细，可传多条明细，详细参数如下表：销售单据明细参数：(节点fpSalesDetail)序号中文名称英文名称长度备注1食品追溯码traceCode64非空2食品代码productCode32非空，关联食品基础信息表的食品代码3食品名称productName256非空，关联食品基础信息表的食品名称4批次batch32非空序号中文名称英文名称长度备注5生产日期productDate14非空。格式yyyyMMddHHmmss6交易数量tr 41、adeNum18非空7计量单位measurementUnit64非空。8顺序号orderNum89备注remark300返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.124食品处理台账接口ID:12W04(2)节点名称：fpFoodHandle(3)接口说明：记录生产主体食品处理的数据写入参数：序号中文名称英文名称长度备注1处理单据号billNo50非空。唯一标识。单据号规则见第9章节2登记主体名称regEntName300非空3登记主体代码regEntUnicode18非空4处理对象类型handleObjTyp 42、e1非空。1-原料；2-产品5食品追溯码traceCode64非空6食品代码productCode32非空，关联食品基础信息表的食品代码7食品名称productName256非空，关联食品基础信息表的食品名称8批次batch32非空9生产日期productDate非空。格式yyyyMMddHHmmss10处理数量handleNum18非空序号中文名称英文名称长度备注11计量单位measurementUnit64非空12处理日期handleDate非空13处理类型handleType1非空。1-退货；2-销毁；3-报废；4-其他；7-零售；8-投用；14领用人 43、leadingPerson100(5)返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.1.3上市凭证6.1.3.1检验检测信息(1)接口ID:13W01(2)节点名称：inspectionReport(3)接口说明：用于食品检验检测的数据写入、更新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1检验报告类型inspectionType4非空。CA0132检测报告编号inspectionNo323检测报告名称inspectionName2564 44、食品代码productCode32非空，关联食品基础信息表的食品代码5食品生产日期productDate14非空，格式yyyyMMddHHmmss6批次batch32非空7检测结果inspectionResult1非空。CA0078检测日期inspectionDate14非空，格式yyyyMMdd9合格方式qualifiedStyle2CA01410检测报告文件inspectionReport以附件方式上传，文件大小不超过5M。序号中文名称英文名称长度备注11检测机构inspectionOrg25612检测人员inspectionPerson6413检测有效期至inspe 45、ctionValidDate格式yyyyMMdd14备注remark300(5)返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.1.3.2产地证明(1)接口ID:13W02(2)节点名称：inspectionReport(3)接口说明：用于食品的产地证明数据写入、更新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1产地证明编号inspectionNo322产地证明名称inspectionName2563食品代码productCode32非空， 46、关联食品基础信息表的食品代码4食品生产日期productDate14非空，格式yyyyMMddHHmmss5批次batch32非空6产地placeOfOrigin64非空7报告日期inspectionDate8非空，格式yyyyMMdd8产地证明文件inspectionReport以附件方式上传，文件大小不超过5M。9检测有效期至inspectionValidDate格式yyyyMMdd10备注remark300(5)返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明。6.1.3.3入境货物检验检疫证明(1)接口ID:1 47、3W03(2)节点名称：inspectionReport(3)接口说明：用于入境货物经验检疫证明数据写入、更新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据写入参数：序号中文名称英文名称长度备注1检测报告编号inspectionNo322检测报告名称inspectionName2563食品代码productCode32非空，关联食品基础信息表的食品代码4食品生产日期productDate非空，格式yyyyMMddHHmmss5批次batch32非空6证明出具日期inspectionDate非空。格式yyyyMMdd7入境证明文件inspection 48、Report以附件方式上传，文件大小不超过5M。8证明出具机构inspectionOrg2569证明出具人员inspectionPerson6410检测有效期至inspectionValidDate格式yyyyMMdd11备注remark300返回说明写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见【返回数据格式】定义说明6.2流通型主体621基础数据6.2.1.1供货主体信息接口ID:21W01(2)节点名称：entinfo(3)接口说明：用于供货主体的数据写入、更新。同一主键数据，重复上传,将更新该记录数据，只允许更新自己上传的数据写入参