福建省“一品一码”食品安全信息追溯管理平台-地市数据交换共享服务标准

福建省“一品一码”食品安全 信息追溯管理平台项目 地市数据交换共享服务标准 福建省食品药品监督管理局 地市数据交换共享服务标准 I 文件更改摘要 日期 版本号 修订说明 修订人 审核人 批准人 18.3.22 V 1.0 创建全文 18.4.7 V 1.1 增加食品交易单据、内部小包装配置表、检验报告类型 3 个问题 18.4.26 V 1.2 调整了专用术语、增加了基础代码类型 18.5.18 V 1.3 进货单据表增加“关联销货单据” 字段；销售单据表增加“关联进货 单据号”字段；将入境货物检验检 疫证明从检验检测中独立；调整订 餐主体代码的字段长度；统一修改 登记主体代码 regEntId 为 regEntUnicode；修改合格方式 CA015 为 CA014；修改接口 ID 为 21W03 的节点 entInfo 为 entLicense；调整产地证明编号字段 为 inspectionNo，产地证明名称字段 为 inspectionName、产地证明文件字 段为 inspectionReport； 18.5.20 V 1.4 增加餐饮加工数据写入接口(32W03) ； 修改接口 12W02 节点为 fpProduct； 修订“食品基础信息”的“小包装 明细” 、餐饮进货台账、餐饮销货台 账的节点名称 18.5.26 V 1.5 接口 22W01 增加关联销货单据字段； 修改接口 22W01 节点 fcEntryFJBill 为 fcStockBill；修改错误的文字说明； 增加第 5.2.2 章节、第 7 章节数据删 除接口规范；修订第 6 章，增加数 据修改说明；修改所属行业的字段 备注 18.6.15 V 1.6 修改保质期字段备注；修改食品基 础信息，预包装食品类型，产地可 以为空；食用农产品类型，产地非 空；企业信息，证件类型、证件号 地市数据交换共享服务标准 II 码可以为空；检验检测信息，检测 报告编号可以为空；产地证明，产 地证明编号可以为空；增加第 5.2.3 章节、第 8 章节，查询接口 18.6.19 V 1.7 检验检测报告新增检测有效期至字 段；修改订餐主体信息中的订餐 人姓名、订餐人联系方式、地 址的字段名称 18.8.13 V 1.8 主体信息、销货台账、餐饮类 型的食品基础数据格式，增加 许可证号，餐饮类型主体，主 体代码、许可证号只要一个不 为空即可；修改经营范围字段 长度为 4000 18.9.3 V 1.9 增加 6.1.2.4、6.2.2.4、6.3.2.4 章节，食品处理台账数据交换标准 18.9.21 V 1.10 主体数据格式增加“所属市场 ID”字段；增加 8.1.3 章节 地市数据交换共享服务标准 I 目 录 1. 范围 1 2. 规范性引用文件 1 3. 术语和定义 1 4. 缩略语 3 5. 接口调用规范 3 5.1 身份验证接口 .3 5.2 接口调用说明 .4 5.2.1 数据接入接口定义 .4 5.2.2 数据删除接口定义 .5 5.2.3 数据查询接口定义 .6 5.3 返回数据格式 .6 5.3.1 XML 格式 6 5.3.2 JSON 格式 7 5.3.3 标识码定义 .7 6. 数据写入更新标准规范 8 6.1 生产型主体 .8 6.1.1 基础数据 .8 6.1.2 台账数据 .14 6.1.3 上市凭证 .18 6.2 流通型主体 .21 6.2.1 基础数据 .21 6.2.2 台账数据 .26 6.2.3 上市凭证 .31 6.3 餐饮服务者 .34 6.3.1 基础数据 .34 6.3.2 台账数据 .39 6.3.3 上市凭证 .43 地市数据交换共享服务标准 II 7. 数据删除标准规范 46 7.1 生产型主体 .46 7.1.1 基础数据 .46 7.1.2 台账数据 .48 7.1.3 上市凭证 .49 7.2 流通型主体 .50 7.2.1 基础数据 .50 7.2.2 台账数据 .52 7.2.3 上市凭证 .53 7.3 餐饮服务者 .54 7.3.1 基础数据 .54 7.3.2 台账数据 .56 7.3.3 上市凭证 .57 8. 数据查询接口规范 58 8.1 基础数据 .58 8.1.1 生产经营主体信息查询 .58 8.1.2 食品基础信息查询 .59 8.1.3 市场信息查询 .61 8.2 交易数据 .62 8.2.1 食品交易单据 .62 9. 单据码编码规则 63 9.1 省直单位建设追溯系统单据码 .63 9.2 各地市建设追溯系统单据码 .64 9.3 企业建设追溯系统单据码 .64 10. 注意事项 64 地市数据交换共享服务标准 第 1 页，共 69 页 1.范围 本标准规定了福建省“一品一码”食品安全信息追溯管理平台（以下简称 “一品一码”追溯管理平台）与福建省地市自建追溯系统数据交换的技术架构、 接口规范、交换过程、数据交换规范等。 本标准适用于地市自建系统与“一品一码”追溯管理平台数据共享与数据交 换服务。 2.规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条段凡是注日期的引 用文件。其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准。 然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡 是不注日期的引用文件，其最新版本适用于本标准。 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） 福建省“一品一码”食品安全信息追溯管理平台 福建省建立统一的福建省食品安全信息追溯管理平台，汇集相关行政主管部 门追溯系统信息，通过编码识别、身份信息比对等技术手段和验证管理实现追溯 食品和生产经营者等信息的共享。 （2） 一品一码 地市数据交换共享服务标准 第 2 页，共 69 页 一品一码指同一品种批次的食品和食用农产品按照规定的追溯编码规则，赋 予唯一的识别追溯码。 （3） 生产经营主体 从事食品生产经营活动的政府、组织、单位、法人和自然人等具备食品追溯 能力的单位和自然人。 （4） 主体代码 法人采用统一社会信用代码，由一组长度为18位的用于法人和其他组织身份 识别的代码。统一社会信用代码由国家标准委发布。国家标准委发布了强制性国 家标准法人和其他组织统一社会信用代码编码规则 。 针对自然人采用散户代码或身份证号码。 （5） 生产经营许可 生产经营许可证是许可证的一个类别之一，是县级以上食品药品监管部门对 食品生产与经营者颁发的允许进行食品生产经营的法定证件。 （6） 食用农产品 指在农业活动中直接获得的，以及经过分拣、去皮、剥壳、干燥、粉碎、清 洗、切割、冷冻、打蜡、分级、包装等加工，但未改变其基本自然性状和化学性 质的、供人食用的植物、动物、微生物及其产品。 （7） 预包装食品 指预先定量包装或者制作在包装材料和容器中的食品；包括预先定量包装以 及预先定量制作在包装材质和容器中并且在一定量限范围内具有统一的质量或体 积标识的食品。简单说，就是指在包装完成后即具有确定的量值，这一确定的量 值应是在一定量限范围内具有统一的质量或体积标识。 （8） 入境食品 指从其他国家和地区进口的食品。 （9） 入闽食品 指中国国内，福建省外的食品，通俗的讲就是其他省份和地区食品，包含在 其他省份和地区生产并在福建省内分包装的食品。 （10） 食品代码 地市数据交换共享服务标准 第 3 页，共 69 页 预包装食品的代码，由企业向中国物品编码中心申请，进行自主食品编码， 并在中国物品编码中心备案；散装食品的代码，由各厅局负责源头赋码。 （11） 食品追溯码 指福建省质量技术监督局研究出台的福建省地方标准食品质量安全追溯码 编码技术规范 （DB35/T 1711-2017）规定的食品追溯码。 （12） 数据提供方 福建省“一品一码”食品安全信息追溯管理平台。 （13） 用户 与福建省“一品一码”食品安全信息追溯管理平台进行数据共享与交换的全 省生产经营主体自建追溯管理平台。 （14） 数据项 共享数据实体。 （15） 数据集 组成共享数据实体的集合。 （16） 数据版本号 共享数据在更新序列上的唯一标识。 4.缩略语 XML - 可扩展标识语言（eXtensible Markup Language） SOAP - 简单对象访问协议（Simple Object Access Protocol ) UDDI - 统一描述、发现和集成（ Universal Description，Discovery , and Integration） 5.接口调用规范 5.1身份验证接口 通过“一品一码”食品安全信息追溯管理平台调用各类接口时，必须先对调 用方的用户身份及权限进行验证，本接口负责用户身份认证和权限验证功能。应 用程序调用本接口进行身份认证和权限验证，通过后将获取身份校验码，用户通 地市数据交换共享服务标准 第 4 页，共 69 页 过该身份校验码才能访问其他接口。校验码的有效时间为 30 分钟。 (1) 原型接口 public String getVerifyCode(String userAccount, String password,String dataType) (2) 参数说明 参数名 说明 是否必填 dataType 返回的数据格式 否（0 表示 XML，1 表示JSON；默认为 XML） userAccount 用户名（“一品一码”食品安全信息追溯管理平台登录账号） 是 password 密码（登录账号对应的密码） 是 (3) 返回说明 验证成功返回成功标识及身份校验码；错误则返回错误标识及错误信息。 5.2接口调用说明 平台提供接口用于生产经营主体数据写入，接口定义如下说明。 5.2.1数据接入接口定义 (1) 原型接口 public String writeObjectOut (String verifyCode, String jkId, String dataType, String writeXmlDoc，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 参数示例 地市数据交换共享服务标准 第 5 页，共 69 页 URLEncoder.encode(“主体名称“, “UTF-8“) URLEncoder.encode(“主体代码“, “UTF-8“) . URLEncoder.encode(“追溯码“, “UTF-8“) . . 5.2.2数据删除接口定义 (1) 原型接口 public String deleteObjectOut (String verifyCode, String jkId, String dataType, String deleteXmlDoc); (2) 参数说明 序号 参数名 说明 是否必填 备注 1 verifyCode 身份校验码 是 2 jkId 接口 ID 是 各接口所对应的 ID 编号，详见各接口说明 3 dataType 返回的数据格式 否 返回的数据类型，0 表示 XML，1表示 JSON；默认为 XML 4 deleteXmlDoc 写入数据 是 业务数据写入 XML 格式文档，附件数据通过以下附件字段进行上传。 (3) DeleteXmlDoc 参数示例 URLEncoder.encode(“主体代码“, “UTF-8“) . 地市数据交换共享服务标准 第 6 页，共 69 页 5.2.3数据查询接口定义 (1) 原型接口 public String queryObjectOut (String verifyCode, String jkId, String dataType, String queryXmlDoc); (2) 参数说明 序号 参数名 说明 是否必填 备注 1 verifyCode 身份校验码 是 2 jkId 接口 ID 是 各接口所对应的 ID 编号，详见各接口说明 3 dataType 返回的数据格式 否 返回的数据类型，0 表示 XML，1表示 JSON；默认为 XML 4 queryXmlDoc 写入数据 是 查询字段写入 XML 格式文档。 (3) QueryXmlDoc 参数示例 URLEncoder.encode(“主体名称“, “UTF-8“) URLEncoder.encode(“主体代码“, “UTF-8“) . 5.3返回数据格式 接口支持 JSON/XML 两种返回数据格式，需要在请求参数中进行指定。 5.3.1XML格式 地市数据交换共享服务标准 第 7 页，共 69 页 5.3.2JSON格式 “head“: “flag“: “标识码“, “msg“: “描述信息 “ 5.3.3标识码定义 编码 编码说明 -2 业务异常 -1 系统异常 00 操作成功 01 逻辑业务出错 02 参数信息不能为空！ 07 账号或密码错误！ 10 xml 格式解析异常 14 身份认证码超时 地市数据交换共享服务标准 第 8 页，共 69 页 6.数据写入更新标准规范 6.1生产型主体 6.1.1基础数据 6.1.1.1 原料供货商信息 (1) 接口 ID ：11W01 (2) 节点名称：entInfo (3) 接口说明：用于写入、更新生产主体的原料供货商数据。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 原料供货商类型 entType 1 非空。CA001 2 原料供货商名称 entName 300 非空 3 原料供货商代码 entUnicode 18 4 食品经营许可证号/餐饮许可证号 orgNo 32 “生产经营类别” 为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须 有一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 5 经营场所 busiPlace 300 原料供货商类型为企事业单位、自然人时，非空 6 经营范围 busiScope 4000 7 经营起始时间 busiStartDate 14 格式 yyyyMMdd 8 经营终止时间 busiEndDate 14 格式 yyyyMMdd 9 生产经营类别 entCategory 1 原料供货商类型为企事业单位、自然人时，非空。CA002 地市数据交换共享服务标准 第 9 页，共 69 页 序号 中文名称 英文名称 长度 备注 10 所属行业 industry 128 原料供货商类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 11 证照图片 licPic 以附件方式上传，文件大小不超过 5M。 12 法定代表人 legal 64 原料供货商类型为企事业单位时，非空 13 证件类型 legalLicType 2 14 证件号码 legalLicNo 18 15 负责人姓名 principalName 64 原料供货商类型为企事业单位、境外企业时，非空 16 负责人手机 principalMobile 32 17 负责人固定电话 principalTel 32 18 负责人传真号码 principalFax 32 19 负责人证件号码 principalLicNo 18 20 负责人邮箱 principalEmail 64 21 所属国家 nation 8 非空。GB/T 2659 22 所属省行政区划 provinceAdminDivision 8 原料供货商类型为企事业单位、自然人时，非空。GB T2260 23 所属市行政区划 cityAdminDivision 8 原料供货商类型为企事业单位、自然人时，非空。GB T2260 24 所属区县行政区划 areaAdminDivision 8 原料供货商类型为企事业单位、自然人时，非空。GB T2260 25 所属市场 ID belongMarket 32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.2 销货主体信息 (1) 接口 ID ：11W02 (2) 节点名称：entInfo 地市数据交换共享服务标准 第 10 页，共 69 页 (3) 接口说明：用于写入、更新生产主体的销货主体数据。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 销货主体类型 entType 1 非空。CA001 2 销货主体名称 entName 300 非空 3 销货主体代码 entUnicode 18 4 食品经营许可证号/餐饮许可证号 orgNo 32 “生产经营类别” 为“餐饮服 务者”时。主体代码与食品 经营许可证号/餐饮许可证 号必须有一个不为空。 企事业单位的主体代码采用 统一社会信用代码，自然人 采用散户代码或身份证号码。 “餐饮服务者”可填写食品 经营许可证号或餐饮许可证 号（旧证） 5 经营场所 busiPlace 300 销货主体类型为企事业单位、自然人时，非空 6 经营范围 busiScope 4000 7 经营起始时间 busiStartDate 14 格式 yyyyMMdd 8 经营终止时间 busiEndDate 14 格式 yyyyMMdd 9 生产经营类别 entCategory 1 销货主体类型为企事业单位、自然人时，非空。CA002 10 所属行业 industry 128 销货主体类型为企事业单位、 自然人时，非空。多个所属 行业用逗号隔开。CA003 11 证照图片 licPic 以附件方式上传，文件大小不超过 5M。 12 法定代表人 legal 64 销货主体类型为企事业单位时，非空 13 证件类型 legalLicType 2 14 证件号码 legalLicNo 18 15 负责人姓名 principalName 64 销货主体类型为企事业单位、境外企业时，非空 地市数据交换共享服务标准 第 11 页，共 69 页 序号 中文名称 英文名称 长度 备注 16 负责人手机 principalMobile 32 17 负责人固定电话 principalTel 32 18 负责人传真号码 principalFax 32 19 负责人证件号码 principalLicNo 18 20 负责人邮箱 principalEmail 64 21 所属国家 nation 8 非空。GB/T 2659 22 所属省行政区划 provinceAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 23 所属市行政区划 cityAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 24 所属区县行政区划 areaAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 25 所属市场 ID belongMarket 32 主体所属批发市场 ID 或农 贸市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.3 生产经营许可 (1) 接口 ID ：11W03 (2) 节点名称：entLicense (3) 接口说明：用于原料供货商、销货主体的生产经营许可证写入、更新。 同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的 数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 主体名称 entName 300 非空。关联生产经营主体表主体名称 2 主体代码 entUnicode 18 非空。关联生产经营主体表主体代码。法人采用统一社会信用代码， 地市数据交换共享服务标准 第 12 页，共 69 页 序号 中文名称 英文名称 长度 备注 自然人采用散户代码或身份证号码 3 许可证类型 licenseType 1 非空。CA008 4 许可证编号 licenseNo 32 非空。唯一标识 5 发证日期 licIssueDate 14 非空，格式 yyyyMMdd 6 有效期至 licValidEndDate 14 非空，格式 yyyyMMdd 7 许可证图片 licensePic 非空，以附件方式上传，文件大小不超过 5M。 8 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.4 食品基础信息 (1) 接口 ID ：11W04 (2) 节点名称：foodProduct (3) 接口说明：用于生产主体进货原料、生产食品的基础数据信息写入、更 新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上 传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 食品代码 productCode 32 非空。唯一标识 2 食品名称 productName 256 非空 3 食品类型 productType 1 非空。CA009 4 产地类型 placeType 1 非空。CA005 5 生产主体名称 entName 300 非空。关联生产经营主体表主体名称 6 生产主体代码 entUnicode 18 非空。关联生产经营主体表主体代码 7 商标 trademark 128 8 保质期 expiryDate 32 请输入数值+单位（年、月、天） 地市数据交换共享服务标准 第 13 页，共 69 页 序号 中文名称 英文名称 长度 备注 格式，例如：180 天。 9 食用农产品类别 agrProductCategory 32 食品类型为食用农产品时，必填。CA015 10 预包装食品类别 productCategory 32 食品类型为预包装食品时，必填。CA010 11 规格 specification 64 12 产地 placeOfOrigin 64 预包装食品类型，可以为空；食用农产品类型，非空 13 原产国 nation 8 产地类型为进口食品时，必填。GB/T 2659 14 计量单位 measurementUnit 64 非空。 15 食品图片 productPic 以附件方式上传，文件大小不超过5M。 16 备注 remark 300 17 小包装明细 xbzmxs 用于记录大包装食品内还含有多个 小包装食品的关系数据。如：箱装 牛奶内含多个小盒牛奶、大箱矿泉 水内含多个小瓶矿泉水。 内部小包装明细参数：(节点xbzmx) 序号 中文名称 英文名称 长度 备注 1 小包装食品代码 smallProductCode 32 非空。关联食品基础信息表的食品代码 2 小包装食品数量 containsNum 18 非空 3 小包装食品计量单位 measurementUnit 64 非空。 4 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 地市数据交换共享服务标准 第 14 页，共 69 页 6.1.2台账数据 6.1.2.1 原料进货单据 (1) 接口 ID ：12W01 (2) 节点名称：fpStockBill (3) 接口说明：用于原料进货单据及明细写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 单据号 billNo 50 非空。唯一标识。单据号规则见 第 9 章节 2 登记主体名称 regEntName 300 非空。关联生产经营主体表主体 名称 3 登记主体代码 regEntUnicode 18 非空。关联生产经营主体表主体 代码 4 交易日期 tradeDate 14 非空。格式 yyyyMMddHHmmss 5 供货主体名称 supplyEntName 300 非空，关联原料供货商表的主体 名称 6 供货主体代码 supplyEntUnicode 18 非空，关联原料供货商表的主体 代码 7 备注 remark 300 8 关联销货单据 refSalesBillNo 50 关联上游的销货单据号 9 进货单据明细 fpStockDetails 原料进货单据明细，可传多条明细，详细参数如下表： 原料进货单据明细参数： (节点 fpStockDetail) 序号 中文名称 英文名称 长度 备注 1 食品追溯码 traceCode 64 非空 2 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 3 食品名称 productName 256 非空，关联食品基础信息表的食品名称 地市数据交换共享服务标准 第 15 页，共 69 页 序号 中文名称 英文名称 长度 备注 4 批次 batch 32 非空 5 生产日期 productDate 14 非空。格式 yyyyMMddHHmmss 6 交易数量 tradeNum 18 非空 7 计量单位 measurementUnit 64 非空。 8 顺序号 orderNum 8 9 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.2.2 生产台账登记 (1) 接口 ID ：12W02 (2) 节点名称：fpProduct (3) 接口说明：用于生产主体的生产台账登记数据写入、更新。同一主键数 据，重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 登记主体名称 regEntName 300 非空。关联生产经营主体表主体名称 2 登记主体代码 regEntUnicode 18 非空。关联生产经营主体表主体代码 3 食品追溯码 traceCode 64 非空。唯一标识 4 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 5 食品名称 productName 256 非空，关联食品基础信息表的食品名称 6 批次 batch 32 非空 7 生产日期 productDate 14 非空，格式 yyyyMMddHHmmss 8 生产数量 tradeNum 18 非空 9 计量单位 measurementUnit 64 非空。 10 备注 remark 300 (5) 返回说明 地市数据交换共享服务标准 第 16 页，共 69 页 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.2.3 销售单据登记 (1) 接口 ID ：12W03 (2) 节点名称：fpSalesBill (3) 接口说明：用于主体的销售单据及明细写入、更新。同一主键数据，重 复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 单据号 billNo 50 非空。唯一标识。单据号规则见第9 章节 2 登记主体名称 regEntName 300 非空。关联生产经营主体表主体名 称 3 登记主体代码 regEntUnicode 18 非空。关联生产经营主体表主体代 码 4 交易日期 tradeDate 14 非空。格式 yyyyMMddHHmmss 5 收货主体名称 receiveEntName 300 非空，关联销货主体表的主体名称 6 收货主体代码 receiveEntUnicode 18 7 收货主体食品 经营许可证号/ 餐饮许可证号 receiveEntOrgNo 32 必须有一个不为空 8 备注 remark 50 非空 9 关联进货单据号 refStockBillNo 50 关联下游的进货单据号 10 销售单据明细 fpSalesDetails 销售单据明细，可传多条明细，详细参数如下表： 销售单据明细参数：(节点fpSalesDetail) 序号 中文名称 英文名称 长度 备注 1 食品追溯码 traceCode 64 非空 2 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 地市数据交换共享服务标准 第 17 页，共 69 页 序号 中文名称 英文名称 长度 备注 3 食品名称 productName 256 非空，关联食品基础信息表的食品名称 4 批次 batch 32 非空 5 生产日期 productDate 14 非空。格式 yyyyMMddHHmmss 6 交易数量 tradeNum 18 非空 7 计量单位 measurementUnit 64 非空。 8 顺序号 orderNum 8 9 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.2.4 食品处理台账 (1) 接口 ID ：12W04 (2) 节点名称：fpFoodHandle (3) 接口说明：记录生产主体食品处理的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 处理单据号 billNo 50 非空。唯一标识。单据号规则见 第 9 章节 2 登记主体名称 regEntName 300 非空 3 登记主体代码 regEntUnicode 18 非空 4 处理对象类型 handleObjType 1 非空。1 - 原料；2 - 产品 5 食品追溯码 traceCode 64 非空 6 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 7 食品名称 productName 256 非空，关联食品基础信息表的食品名称 地市数据交换共享服务标准 第 18 页，共 69 页 序号 中文名称 英文名称 长度 备注 8 批次 batch 32 非空 9 生产日期 productDate 非空。格式yyyyMMddHHmmss 10 处理数量 handleNum 18 非空 11 计量单位 measurementUnit 64 非空 12 处理日期 handleDate 非空 13 处理类型 handleType 1 非空。1 - 退货；2 - 销毁；3 - 报废；4 - 其他； 7 - 零售；8 - 投用； 14 领用人 leadingPerson 100 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3上市凭证 6.1.3.1 检验检测信息 (1) 接口 ID ：13W01 (2) 节点名称：inspectionReport (3) 接口说明：用于食品检验检测的数据写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 检验报告类型 inspectionType 4 非空。CA013 2 检测报告编号 inspectionNo 32 3 检测报告名称 inspectionName 256 4 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 地市数据交换共享服务标准 第 19 页，共 69 页 序号 中文名称 英文名称 长度 备注 5 食品生产日期 productDate 14 非空，格式 yyyyMMddHHmmss 6 批次 batch 32 非空 7 检测结果 inspectionResult 1 非空。CA007 8 检测日期 inspectionDate 14 非空，格式 yyyyMMdd 9 合格方式 qualifiedStyle 2 CA014 10 检测报告文件 inspectionReport 以附件方式上传，文件大小不超过5M。 11 检测机构 inspectionOrg 256 12 检测人员 inspectionPerson 64 13 检测有效期至 inspectionValidDate 格式 yyyyMMdd 14 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3.2 产地证明 (1) 接口 ID ：13W02 (2) 节点名称：inspectionReport (3) 接口说明：用于食品的产地证明数据写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 产地证明编号 inspectionNo 32 2 产地证明名称 inspectionName 256 3 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 4 食品生产日 productDate 14 非空，格式 yyyyMMddHHmmss 地市数据交换共享服务标准 第 20 页，共 69 页 序号 中文名称 英文名称 长度 备注 期 5 批次 batch 32 非空 6 产地 placeOfOrigin 64 非空 7 报告日期 inspectionDate 8 非空，格式 yyyyMMdd 8 产地证明文件 inspectionReport 以附件方式上传，文件大小不超过5M。 9 检测有效期至 inspectionValidDate 格式 yyyyMMdd 10 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3.3 入境货物检验检疫证明 (1) 接口 ID ：13W03 (2) 节点名称：inspectionReport (3) 接口说明：用于入境货物经验检疫证明数据写入、更新。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 检测报告编号 inspectionNo 32 2 检测报告名称 inspectionName 256 3 食品代码 productCode 32 非空，关联食品基础信息表的食品代码 4 食品生产日期 productDate 非空，格式 yyyyMMddHHmmss 5 批次 batch 32 非空 6 证明出具日期 inspectionDate 非空。格式 yyyyMMdd 7 入境证明文件 inspectionReport 以附件方式上传，文件大小不超过5M。 8 证明出具机构 inspectionOrg 256 地市数据交换共享服务标准 第 21 页，共 69 页 序号 中文名称 英文名称 长度 备注 9 证明出具人员 inspectionPerson 64 10 检测有效期至 inspectionValidDate 格式 yyyyMMdd 11 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2流通型主体 6.2.1基础数据 6.2.1.1 供货主体信息 (1) 接口 ID ：21W01 (2) 节点名称：entInfo (3) 接口说明：用于供货主体的数据写入、更新。同一主键数据，重复上传， 将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 供货主体类型 entType 1 非空。CA001 2 供货主体名称 entName 300 非空 3 供货主体代码 entUnicode 18 4 食品经营许可证号/餐饮许可证号 orgNo 32 “生产经营类别” 为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须有 一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 地市数据交换共享服务标准 第 22 页，共 69 页 序号 中文名称 英文名称 长度 备注 5 经营场所 busiPlace 300 供货主体类型为企事业单位、自然人时，非空 6 经营范围 busiScope 4000 7 经营起始时间 busiStartDate 14 格式 yyyyMMdd 8 经营终止时间 busiEndDate 14 格式 yyyyMMdd 9 生产经营类别 entCategory 1 供货主体类型为企事业单位、自然人时，非空。CA002 10 所属行业 industry 128 供货主体类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 11 证照图片 licPic 以附件方式上传，文件大小不超过 5M。 法定代表人 legal 64 供货主体类型为企事业单位时，非空 12 13 证件类型 legalLicType 2 14 证件号码 legalLicNo 18 15 负责人姓名 principalName 64 供货主体类型为企事业单位、境外企业时，非空 16 负责人手机 principalMobile 32 17 负责人固定电话 principalTel 32 18 负责人传真号码 principalFax 32 19 负责人证件号码 principalLicNo 18 20 负责人邮箱 principalEmail 64 21 所属国家 nation 8 非空。GB/T 2659 22 所属省行政区划 provinceAdminDivision 8 供货主体类型为企事业单位、自然人时，非空。GB T2260 23 所属市行政区划 cityAdminDivision 8 供货主体类型为企事业单位、自然人时，非空。GB T2260 24 所属区县行政区划 areaAdminDivision 8 供货主体类型为企事业单位、自然人时，非空。GB T2260 25 所属市场 ID belongMarket 32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 地市数据交换共享服务标准 第 23 页，共 69 页 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2.1.2 销货主体信息 (1) 接口 ID ：21W02 (2) 节点名称：entInfo (3) 接口说明：用于销货主体信息数据写入、更新。同一主键数据，重复上 传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 销货主体类型 entType 1 非空。CA001 2 销货主体名称 entName 300 非空 3 销货主体代码 entUnicode 18 4 食品经营许可证号/餐饮许可证号 orgNo 32 “生产经营类别” 为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须有 一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 5 经营场所 busiPlace 300 销货主体类型为企事业单位、自然人时，非空 6 经营范围 busiScope 4000 7 经营起始时间 busiStartDate 14 格式 yyyyMMdd 8 经营终止时间 busiEndDate 14 格式 yyyyMMdd 9 生产经营类别 entCategory 1 销货主体类型为企事业单位、自然人时，非空。CA002 10 所属行业 industry 128 销货主体类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 地市数据交换共享服务标准 第 24 页，共 69 页 序号 中文名称 英文名称 长度 备注 11 证照图片 licPic 以附件方式上传，文件大小不超过 5M。 12 法定代表人 legal 64 销货主体类型为企事业单位时，非空 13 证件类型 legalLicType 2 14 证件号码 legalLicNo 18 15 负责人姓名 principalName 64 销货主体类型为企事业单位、境外企业时，非空 16 负责人手机 principalMobile 32 17 负责人固定电话 principalTel 32 18 负责人传真号码 principalFax 32 19 负责人证件号码 principalLicNo 18 20 负责人邮箱 principalEmail 64 21 所属国家 nation 8 非空。GB/T 2659 22 所属省行政区划 provinceAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 23 所属市行政区划 cityAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 24 所属区县行政区划 areaAdminDivision 8 销货主体类型为企事业单位、自然人时，非空。GB T2260 25 所属市场 ID belongMarket 32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2.1.3 生产经营许可 (1) 接口 ID ：21W03 (2) 节点名称：entLicense (3) 接口说明：用于供货主体、销货主体的生产经营许可证写入、更新。同 一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数 地市数据交换共享服务标准 第 25 页，共 69 页 据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 主体名称 entName 300 非空。关联生产经营主体表主体名称 2 主体代码 entUnicode 18 非空。关联生产经营主体表主体代 码。法人采用统一社会信用代码， 自然人采用散户代码或身份证号码 3 许可证类型 licenseType 1 非空。CA008 4 许可证编号 licenseNo 32 非空、唯一标识 5 发证日期 licIssueDate 14 非空，格式 yyyyMMdd 6 有效期至 licValidEndDate 14 非空，格式 yyyyMMdd 7 许可证图片 licensePic 非空，以附件方式上传，文件大小不超过 5M。 8 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2.1.4 食品基础信息 (1) 接口 ID ：21W04 (2) 节点名称：foodProduct (3) 接口说明：用于流通主体经营食品的基础数据信息写入、更新。同一主 键数据，重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 食品代码 productCode 32 非空。唯一标识 2 食品名称 productName 256 非空 3 食品类型 productType 1 非空。CA009 4 产地类型 placeType 1 非空。CA005 5 生产主体名称 entName 300 非空。关联生产经营主体表主体名 地市数据交换共享服务标准 第 26 页，共 69 页 序号 中文名称 英文名称 长度 备注 称 6 生产主体代码 entUnicode 18 非空。关联生产经营主体表主体代码 7 商标 trademark 128 8 保质期 expiryDate 32 请输入数值+单位（年、月、天）格式，例如：180 天 9 食用农产品类别 agrProductCategory 32 食品类型为食用农产品时，必填。CA015 10 预包装食品类别 productCategory 32 食品类型为预包装食品时，必填。CA010 11 规格 specification 64 12 产地 placeOfOrigin 64 预包装食品类型，可以为空；食用农产品类型，非空 13 原产国 nation 8 产地类型为进口食品时，必填。GB/T 2659 14 计量单位 measurementUnit 64 非空。 15 食品图片 productPic 以附件方式上传，文件大小不超过5M。 16 备注 remark 300 17 小包装明细 xbzmxs 用于记录大包装食品内还含有多个 小包装食品的关系数据。如：箱装 牛奶内含多个小盒牛奶、大箱矿泉 水内含多个小瓶矿泉水。 内部小包装明细参数：(节点xbzmx) 序号 中文名称 英文名称 长度 备注 1 小包装食品代码 smallProductCode 32 非空。关联食品基础信息表的食品代码 2 小包装食品数量 containsNum 18 非空 3 小包装食品计量单位 measurementUnit 64 非空。 4 备注 remark 300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 地市数据交换共享服务标准 第 27 页，共 69 页 【返回数据格式】定义说明。 6.2.2台账数据 6.2.2.1 入闽食品单据登记 (1) 接口 ID ：22W01 (2) 节点名称：fcStockBill (3) 接口说明：用于入闽食品单据数据写入、更新，由入闽一级批发商负责 登记。入闽登记的食品系统需按照标准规范针对每批入闽食品生成食品 追溯码。同一主键数据，重复上传，将更新该记录数据，只允许更新自 己上传的数据。 (4) 写入参数： 序号 中文名称 英文名称 长度 备注 1 单据号 billNo 50 非空。唯一标识。单据号规则见 第 9 章节 2 登记主体名称 regEntName 300 非空。关联生产经营主体表主 体名称 3 登记主体代码 regEntUnicode 18 非空。关联生产经营主体表主 体代码 4 入闽日期 tradeDate 14 非空。格式 yyyyMMddHHmmss 5 供货主体名称 supplierEntName 300 非空，关联供货主体表的主体名称 6 供货主体代码 supplierEntUni