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

福建省福建省“一品一码一品一码”食品安全食品安全 信息追溯管理平台项目信息追溯管理平台项目 地市数据交换共享服务标准地市数据交换共享服务标准 福建省食品药品监督管理局福建省食品药品监督管理局 地市数据交换共享服务标准 I 文文件更改摘要件更改摘要 日期日期版本号版本号修订说明修订说明修订人修订人审核人审核人批准人批准人 18.3.22V 1.0创建全文 18.4.7V 1.1 增加食品交易单据、内部小包装配 置表、检验报告类型 3 个问题 18.4.26V 1.2 调整了专用术语、增加了基础代码 类型 18.5.18V 1.3 进货单据表增加“关联销货单据” 字段；销售单据表增加“关联进货 单据号”字段；将入境货物检验检 疫证明从检验检测中独立；调整订 餐主体代码的字段长度；统一修改 登记主体代码 regEntId 为 regEntUnicode；修改合格方式 CA015 为 CA014；修改接口 ID 为 21W03 的节点 entInfo 为 entLicense；调整产地证明编号字段 为 inspectionNo，产地证明名称字段 为 inspectionName、产地证明文件字 段为 inspectionReport； 18.5.20V 1.4 增加餐饮加工数据写入接口(32W03)； 修改接口 12W02 节点为 fpProduct； 修订“食品基础信息”的“小包装 明细” 、餐饮进货台账、餐饮销货台 账的节点名称 18.5.26V 1.5 接口 22W01 增加关联销货单据字段； 修改接口 22W01 节点 fcEntryFJBill 为 fcStockBill；修改错误的文字说明； 增加第 5.2.2 章节、第 7 章节数据删 除接口规范；修订第 6 章，增加数 据修改说明；修改所属行业的字段 备注 18.6.15V 1.6 修改保质期字段备注；修改食品基 础信息，预包装食品类型，产地可 以为空；食用农产品类型，产地非 空；企业信息，证件类型、证件号 地市数据交换共享服务标准 II 码可以为空；检验检测信息，检测 报告编号可以为空；产地证明，产 地证明编号可以为空；增加第 5.2.3 章节、第 8 章节，查询接口 18.6.19V 1.7 检验检测报告新增检测有效期至字 段；修改订餐主体信息中的订餐 人姓名、订餐人联系方式、地 址的字段名称 18.8.13V 1.8 主体信息、销货台账、餐饮类 型的食品基础数据格式，增加 许可证号，餐饮类型主体，主 体代码、许可证号只要一个不 为空即可；修改经营范围字段 长度为 4000 18.9.3V 1.9 增加 6.1.2.4、6.2.2.4、6.3.2.4 章节， 食品处理台账数据交换标准 18.9.21V 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) 参数说明 序号参数名说明是否必填备注 1verifyCode身份校验码是 2jkId接口 ID是 各接口所对应的 ID 编号，详见各接 口说明 3dataType返回的数据格式否 返回的数据类型，0 表示 XML，1 表示 JSON；默认为 XML 4writeXmlDoc写入数据是 业务数据写入 XML 格式文档，附件 数据通过以下附件字段进行上传。 5fileNames附件名称数组否附件名+类型，如 2012012.xls 6fileContents附件数据数组否附件内容，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) 参数说明 序号参数名说明是否必填备注 1verifyCode身份校验码是 2jkId接口 ID是 各接口所对应的 ID 编号，详见各接 口说明 3dataType返回的数据格式否 返回的数据类型，0 表示 XML，1 表示 JSON；默认为 XML 4 deleteXmlDo c 写入数据是 业务数据写入 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) 参数说明 序号参数名说明是否必填备注 1verifyCode身份校验码是 2jkId接口 ID是 各接口所对应的 ID 编号，详见各接 口说明 3dataType返回的数据格式否 返回的数据类型，0 表示 XML，1 表示 JSON；默认为 XML 4queryXmlDoc写入数据是查询字段写入 XML 格式文档。 (3) QueryXmlDoc 参数示例 URLEncoder.encode(“主体名称“, “UTF-8“) URLEncoder.encode(“主体代码“, “UTF-8“) . 5.3返回数据格式返回数据格式 接口支持 JSON/XML 两种返回数据格式，需要在请求参数中进行指定。 5.3.1XML格式格式 !CDATA标识码 地市数据交换共享服务标准 第 7 页，共 69 页 5.3.2JSON格式格式 “head“: “flag“: “标识码“, “msg“: “描述信息 “ 5.3.3标识码定义标识码定义 编码编码编码说明编码说明 -2业务异常 -1系统异常 00操作成功 01逻辑业务出错 02参数信息不能为空！ 07账号或密码错误！ 10xml 格式解析异常 14身份认证码超时 地市数据交换共享服务标准 第 8 页，共 69 页 6.数据写入更新标准规范数据写入更新标准规范 6.1生产型主体生产型主体 6.1.1基础数据基础数据 6.1.1.1 原料供货商信息原料供货商信息 (1) 接口 ID ：11W01 (2) 节点名称：entInfo (3) 接口说明：用于写入、更新生产主体的原料供货商数据。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1原料供货商类型entType1非空。CA001 2原料供货商名称entName300非空 3原料供货商代码entUnicode18 4 食品经营许可证 号/餐饮许可证号 orgNo32 “生产经营类别”为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须 有一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 5经营场所busiPlace300 原料供货商类型为企事业单位、 自然人时，非空 6经营范围busiScope4000 7经营起始时间busiStartDate14格式 yyyyMMdd 8经营终止时间busiEndDate14格式 yyyyMMdd 9生产经营类别entCategory1 原料供货商类型为企事业单位、 自然人时，非空。CA002 地市数据交换共享服务标准 第 9 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 10所属行业industry128 原料供货商类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 11证照图片licPic 以附件方式上传，文件大小不 超过 5M。 12法定代表人legal64 原料供货商类型为企事业单位 时，非空 13证件类型legalLicType2 14证件号码legalLicNo18 15负责人姓名principalName64 原料供货商类型为企事业单位、 境外企业时，非空 16负责人手机principalMobile32 17负责人固定电话principalTel32 18负责人传真号码principalFax32 19负责人证件号码principalLicNo18 20负责人邮箱principalEmail64 21所属国家nation8非空。GB/T 2659 22所属省行政区划provinceAdminDivision8 原料供货商类型为企事业单位、 自然人时，非空。GB T2260 23所属市行政区划cityAdminDivision8 原料供货商类型为企事业单位、 自然人时，非空。GB T2260 24 所属区县行政区 划 areaAdminDivision8 原料供货商类型为企事业单位、 自然人时，非空。GB T2260 25所属市场 IDbelongMarket32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.2 销货主体信息销货主体信息 (1) 接口 ID ：11W02 (2) 节点名称：entInfo 地市数据交换共享服务标准 第 10 页，共 69 页 (3) 接口说明：用于写入、更新生产主体的销货主体数据。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1销货主体类型entType1非空。CA001 2销货主体名称entName300非空 3销货主体代码entUnicode18 4 食品经营许可证号 /餐饮许可证号 orgNo32 “生产经营类别”为“餐饮服 务者”时。主体代码与食品 经营许可证号/餐饮许可证 号必须有一个不为空。 企事业单位的主体代码采用 统一社会信用代码，自然人 采用散户代码或身份证号码。 “餐饮服务者”可填写食品 经营许可证号或餐饮许可证 号（旧证） 5经营场所busiPlace300 销货主体类型为企事业单位、 自然人时，非空 6经营范围busiScope4000 7经营起始时间busiStartDate14格式 yyyyMMdd 8经营终止时间busiEndDate14格式 yyyyMMdd 9生产经营类别entCategory1 销货主体类型为企事业单位、 自然人时，非空。CA002 10所属行业industry128 销货主体类型为企事业单位、 自然人时，非空。多个所属 行业用逗号隔开。CA003 11证照图片licPic 以附件方式上传，文件大小 不超过 5M。 12法定代表人legal64 销货主体类型为企事业单位 时，非空 13证件类型legalLicType2 14证件号码legalLicNo18 15负责人姓名principalName64 销货主体类型为企事业单位、 境外企业时，非空 地市数据交换共享服务标准 第 11 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 16负责人手机principalMobile32 17负责人固定电话principalTel32 18负责人传真号码principalFax32 19负责人证件号码principalLicNo18 20负责人邮箱principalEmail64 21所属国家nation8非空。GB/T 2659 22所属省行政区划 provinceAdminDivisio n 8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 23所属市行政区划cityAdminDivision8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 24所属区县行政区划areaAdminDivision8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 25所属市场 IDbelongMarket32 主体所属批发市场 ID 或农 贸市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.3 生产经营许可生产经营许可 (1) 接口 ID ：11W03 (2) 节点名称：entLicense (3) 接口说明：用于原料供货商、销货主体的生产经营许可证写入、更新。 同一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的 数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1主体名称entName300 非空。关联生产经营主体表主体名 称 2主体代码entUnicode18 非空。关联生产经营主体表主体代 码。法人采用统一社会信用代码， 地市数据交换共享服务标准 第 12 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 自然人采用散户代码或身份证号码 3许可证类型licenseType1非空。CA008 4许可证编号licenseNo32非空。唯一标识 5发证日期licIssueDate14非空，格式 yyyyMMdd 6有效期至licValidEndDate14非空，格式 yyyyMMdd 7许可证图片licensePic 非空，以附件方式上传，文件大小 不超过 5M。 8备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.1.4 食品基础信息食品基础信息 (1) 接口 ID ：11W04 (2) 节点名称：foodProduct (3) 接口说明：用于生产主体进货原料、生产食品的基础数据信息写入、更 新。同一主键数据，重复上传，将更新该记录数据，只允许更新自己上 传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1食品代码productCode32非空。唯一标识 2食品名称productName256非空 3食品类型productType1非空。CA009 4产地类型placeType1非空。CA005 5生产主体名称entName300 非空。关联生产经营主体表主体名 称 6生产主体代码entUnicode18 非空。关联生产经营主体表主体代 码 7商标trademark128 8保质期expiryDate32请输入数值+单位（年、月、天） 地市数据交换共享服务标准 第 13 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 格式，例如：180 天。 9 食用农产品类 别 agrProductCategory32 食品类型为食用农产品时，必填。 CA015 10 预包装食品类 别 productCategory32 食品类型为预包装食品时，必填。 CA010 11规格specification64 12产地placeOfOrigin64 预包装食品类型，可以为空；食用 农产品类型，非空 13原产国nation8 产地类型为进口食品时，必填。 GB/T 2659 14计量单位measurementUnit64非空。 15食品图片productPic 以附件方式上传，文件大小不超过 5M。 16备注remark300 17小包装明细xbzmxs 用于记录大包装食品内还含有多个 小包装食品的关系数据。如：箱装 牛奶内含多个小盒牛奶、大箱矿泉 水内含多个小瓶矿泉水。 内部小包装明细参数：(节点xbzmx) 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1 小包装食品代 码 smallProductCode32 非空。关联食品基础信息表的食 品代码 2 小包装食品数 量 containsNum18非空 3 小包装食品计 量单位 measurementUnit64非空。 4备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 地市数据交换共享服务标准 第 14 页，共 69 页 6.1.2台账数据台账数据 6.1.2.1 原料进货单据原料进货单据 (1) 接口 ID ：12W01 (2) 节点名称：fpStockBill (3) 接口说明：用于原料进货单据及明细写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1单据号billNo50 非空。唯一标识。单据号规则见 第 9 章节 2 登记主体名称regEntName 300 非空。关联生产经营主体表主体 名称 3 登记主体代码regEntUnicode 18 非空。关联生产经营主体表主体 代码 4交易日期tradeDate14 非空。格式 yyyyMMddHHmmss 5供货主体名称supplyEntName300 非空，关联原料供货商表的主体 名称 6供货主体代码supplyEntUnicode18 非空，关联原料供货商表的主体 代码 7备注remark300 8关联销货单据refSalesBillNo50关联上游的销货单据号 9进货单据明细fpStockDetails 原料进货单据明细，可传多条明 细，详细参数如下表： 原料进货单据明细参数：原料进货单据明细参数：(节点节点 fpStockDetail) 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1食品追溯码traceCode64非空 2食品代码productCode32 非空，关联食品基础信息表的食品 代码 3食品名称productName256 非空，关联食品基础信息表的食品 名称 地市数据交换共享服务标准 第 15 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 4批次batch32非空 5生产日期productDate14非空。格式 yyyyMMddHHmmss 6交易数量tradeNum18非空 7计量单位measurementUnit64非空。 8顺序号orderNum8 9备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.2.2 生产台账登记生产台账登记 (1) 接口 ID ：12W02 (2) 节点名称：fpProduct (3) 接口说明：用于生产主体的生产台账登记数据写入、更新。同一主键数 据，重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1 登记主体名称regEntName 300 非空。关联生产经营主体表主体名称 2 登记主体代码regEntUnicode 18 非空。关联生产经营主体表主体代码 3食品追溯码traceCode64非空。唯一标识 4食品代码productCode32非空，关联食品基础信息表的食品代码 5食品名称productName256非空，关联食品基础信息表的食品名称 6批次batch32非空 7生产日期productDate14非空，格式 yyyyMMddHHmmss 8生产数量tradeNum18非空 9计量单位 measurementUni t 64非空。 10备注remark300 (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 收货主体食品 经营许可证号/ 餐饮许可证号 receiveEntOrgNo32 必须有一个不为空 8备注remark 50非空 9 关联进货单据 号 refStockBillNo 50关联下游的进货单据号 10销售单据明细fpSalesDetails 销售单据明细，可传多条明细，详 细参数如下表： 销售单据明细参数：(节点fpSalesDetail) 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1食品追溯码traceCode64非空 2食品代码productCode32 非空，关联食品基础信息表的食品 代码 地市数据交换共享服务标准 第 17 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 3食品名称productName256 非空，关联食品基础信息表的食品 名称 4批次batch32非空 5生产日期productDate14非空。格式 yyyyMMddHHmmss 6交易数量tradeNum18非空 7计量单位measurementUnit64非空。 8顺序号orderNum8 9备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.2.4 食品处理台账食品处理台账 (1) 接口 ID ：12W04 (2) 节点名称：fpFoodHandle (3) 接口说明：记录生产主体食品处理的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1处理单据号billNo 50非空。唯一标识。单据号规则 见第 9 章节 2 登记主体名 称 regEntName300非空 3 登记主体代 码 regEntUnicode18非空 4 处理对象类 型 handleObjType1非空。1 - 原料；2 - 产品 5食品追溯码traceCode64非空 6食品代码productCode32 非空，关联食品基础信息表的 食品代码 7食品名称productName256 非空，关联食品基础信息表的 食品名称 地市数据交换共享服务标准 第 18 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 8批次batch32非空 9生产日期productDate 非空。格式 yyyyMMddHHmmss 10处理数量handleNum18非空 11计量单位measurementUnit64非空 12处理日期handleDate非空 13处理类型handleType1 非空。1 - 退货；2 - 销毁；3 - 报废；4 - 其他； 7 - 零售；8 - 投用； 14领用人leadingPerson100 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3上市凭证上市凭证 6.1.3.1 检验检测信息检验检测信息 (1) 接口 ID ：13W01 (2) 节点名称：inspectionReport (3) 接口说明：用于食品检验检测的数据写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1 检验报告类 型 inspectionType4非空。CA013 2 检测报告编 号 inspectionNo32 3 检测报告名 称 inspectionName256 4食品代码productCode32 非空，关联食品基础信息表的食品代 码 地市数据交换共享服务标准 第 19 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 5 食品生产日 期 productDate14非空，格式 yyyyMMddHHmmss 6批次batch32非空 7检测结果inspectionResult1非空。CA007 8检测日期inspectionDate14非空，格式 yyyyMMdd 9合格方式qualifiedStyle2CA014 10 检测报告文 件 inspectionReport 以附件方式上传，文件大小不超过 5M。 11检测机构inspectionOrg256 12检测人员inspectionPerson64 13 检测有效期 至 inspectionValidDat e 格式 yyyyMMdd 14备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3.2 产地证明产地证明 (1) 接口 ID ：13W02 (2) 节点名称：inspectionReport (3) 接口说明：用于食品的产地证明数据写入、更新。同一主键数据，重复 上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1 产地证明编 号 inspectionNo32 2 产地证明名 称 inspectionName256 3食品代码productCode32 非空，关联食品基础信息表的食品代 码 4食品生产日productDate14非空，格式 yyyyMMddHHmmss 地市数据交换共享服务标准 第 20 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 期 5批次batch32非空 6产地placeOfOrigin64非空 7报告日期inspectionDate8非空，格式 yyyyMMdd 8 产地证明文 件 inspectionReport 以附件方式上传，文件大小不超过 5M。 9 检测有效期 至 inspectionValidDat e 格式 yyyyMMdd 10备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.1.3.3 入境货物检验检疫证明入境货物检验检疫证明 (1) 接口 ID ：13W03 (2) 节点名称：inspectionReport (3) 接口说明：用于入境货物经验检疫证明数据写入、更新。同一主键数据， 重复上传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1检测报告编号inspectionNo32 2检测报告名称inspectionName256 3食品代码productCode32 非空，关联食品基础信息表的食品代 码 4食品生产日期productDate非空，格式 yyyyMMddHHmmss 5批次batch32非空 6证明出具日期inspectionDate非空。格式 yyyyMMdd 7入境证明文件inspectionReport 以附件方式上传，文件大小不超过 5M。 8证明出具机构inspectionOrg256 地市数据交换共享服务标准 第 21 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 9证明出具人员inspectionPerson64 10检测有效期至 inspectionValidDat e 格式 yyyyMMdd 11备注remark300 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2流通型主体流通型主体 6.2.1基础数据基础数据 6.2.1.1 供货主体信息供货主体信息 (1) 接口 ID ：21W01 (2) 节点名称：entInfo (3) 接口说明：用于供货主体的数据写入、更新。同一主键数据，重复上传， 将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1供货主体类型entType1非空。CA001 2供货主体名称entName300非空 3供货主体代码entUnicode18 4 食品经营许可证号 /餐饮许可证号 orgNo32 “生产经营类别”为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须有 一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 地市数据交换共享服务标准 第 22 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 5经营场所busiPlace300 供货主体类型为企事业单位、 自然人时，非空 6经营范围busiScope4000 7经营起始时间busiStartDate14格式 yyyyMMdd 8经营终止时间busiEndDate14格式 yyyyMMdd 9生产经营类别entCategory1 供货主体类型为企事业单位、 自然人时，非空。CA002 10所属行业industry128 供货主体类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 11证照图片licPic 以附件方式上传，文件大小不 超过 5M。 法定代表人legal64 供货主体类型为企事业单位时， 非空 12 13证件类型legalLicType2 14证件号码legalLicNo18 15负责人姓名principalName64 供货主体类型为企事业单位、 境外企业时，非空 16负责人手机principalMobile32 17负责人固定电话principalTel32 18负责人传真号码principalFax32 19负责人证件号码principalLicNo18 20负责人邮箱principalEmail64 21所属国家nation8非空。GB/T 2659 22所属省行政区划 provinceAdminDivisio n 8 供货主体类型为企事业单位、 自然人时，非空。GB T2260 23所属市行政区划cityAdminDivision8 供货主体类型为企事业单位、 自然人时，非空。GB T2260 24所属区县行政区划areaAdminDivision8 供货主体类型为企事业单位、 自然人时，非空。GB T2260 25所属市场 IDbelongMarket32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 地市数据交换共享服务标准 第 23 页，共 69 页 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2.1.2 销货主体信息销货主体信息 (1) 接口 ID ：21W02 (2) 节点名称：entInfo (3) 接口说明：用于销货主体信息数据写入、更新。同一主键数据，重复上 传，将更新该记录数据，只允许更新自己上传的数据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1销货主体类型entType1非空。CA001 2销货主体名称entName300非空 3销货主体代码entUnicode18 4 食品经营许可证号 /餐饮许可证号 orgNo32 “生产经营类别”为“餐饮服务 者”时。主体代码与食品经营 许可证号/餐饮许可证号必须有 一个不为空。 企事业单位的主体代码采用统 一社会信用代码，自然人采用 散户代码或身份证号码。 “餐饮服务者”可填写食品经 营许可证号或餐饮许可证号 （旧证） 5经营场所busiPlace300 销货主体类型为企事业单位、 自然人时，非空 6经营范围busiScope4000 7经营起始时间busiStartDate14格式 yyyyMMdd 8经营终止时间busiEndDate14格式 yyyyMMdd 9生产经营类别entCategory1 销货主体类型为企事业单位、 自然人时，非空。CA002 10所属行业industry128 销货主体类型为企事业单位、 自然人时，非空。多个所属行 业用逗号隔开。CA003 地市数据交换共享服务标准 第 24 页，共 69 页 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 11证照图片licPic 以附件方式上传，文件大小不 超过 5M。 12法定代表人legal64 销货主体类型为企事业单位时， 非空 13证件类型legalLicType2 14证件号码legalLicNo18 15负责人姓名principalName64 销货主体类型为企事业单位、 境外企业时，非空 16负责人手机principalMobile32 17负责人固定电话principalTel32 18负责人传真号码principalFax32 19负责人证件号码principalLicNo18 20负责人邮箱principalEmail64 21所属国家nation8非空。GB/T 2659 22所属省行政区划 provinceAdminDivisio n 8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 23所属市行政区划cityAdminDivision8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 24所属区县行政区划areaAdminDivision8 销货主体类型为企事业单位、 自然人时，非空。GB T2260 25所属市场 IDbelongMarket32 主体所属批发市场 ID 或农贸 市场 ID 市场 ID 根据 8.1.3 章节获取 (5) 返回说明 写入成功返回成功标识，失败则返回失败标识及原因，具体返回格式详见 【返回数据格式】定义说明。 6.2.1.3 生产经营许可生产经营许可 (1) 接口 ID ：21W03 (2) 节点名称：entLicense (3) 接口说明：用于供货主体、销货主体的生产经营许可证写入、更新。同 一主键数据，重复上传，将更新该记录数据，只允许更新自己上传的数 地市数据交换共享服务标准 第 25 页，共 69 页 据。 (4) 写入参数： 序号序号中文名称中文名称英文名称英文名称长度长度备注备注 1主体名称entName300 非空