福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范标准
省“一品一码”食品安全追溯管理
食品生产经营企业数据对接
接口技术规
省食品药品监督管理局
二〇一八年九月
目 录
1.
接口设计 ..................................................................................................... 1 1.1. 1.2.
接口地址 ............................................................................................... 1 追溯系统数据接口 ............................................................................... 1 1.2.1. 用户身份认证接口 ........................................................................ 1 1.2.2. 数据推送接口 ................................................................................ 2 1.2.3. Catalogid定义 ............................................................................... 2 1.3.
接口具体数据（info参数）格式 ........................................................ 3 1.3.1. 食品生产企业 ................................................................................ 3 1.3.2. 食品流通企业 .............................................................................. 17 1.3.3. 餐饮（食堂）企业 ...................................................................... 29 1.3.4. 其他 .............................................................................................. 41 1.4.
数据字典 ............................................................................................. 44 1.4.1. 食品生产不合格处理类型 .......................................................... 44 1.4.2. 食品流通处理类型 ...................................................................... 44 1.4.3. 餐饮处理类型 .............................................................................. 44 1.4.4. 包装类型 ...................................................................................... 45 1.4.5. 原料类型 ...................................................................................... 45 1.4.6. 商品类型 ...................................................................................... 45 1.4.7. 商品类别 ...................................................................................... 45 1.4.8. 企业类型 ...................................................................................... 47 1.4.9. 许可证类型 .................................................................................. 47 1.5. 2. 3.
接口返回值 ......................................................................................... 47
注意事项 ................................................................................................... 48 系统对接申请流程 ................................................................................... 50 3.1. 3.2.
食品生产经营企业数据对接申请流程 ............................................. 50 食品生产经营企业数据对接申请表 ................................................. 51
1. 接口设计
1.1.
接口地址
系统通过Web Service进行数据对接。 数据对接测试环境地址：
110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl 数据对接正式环境地址：
120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl
1.2. 追溯系统数据接口
追溯系统数据接口实现企业自建追溯系统与省食品追溯系统对接，实现系统间的追溯数据对接。
1.2.1. 用户身份认证接口
调用方对接追溯系统前，需先进行身份认证。通过本接口认证成功后，将返回一个身份认证码，该身份认证码做为后续数据接口的认证参数。身份认证码有效期30分钟，身份认证码过期后需要重新请求获取。
(1) 接口说明
原型接口 功能描述 返回值 public String getVerifyCode(string userAccount, string password) 业务系统的身份认证功能 认证成功，返回身份认证码，认证失败，返回具体错误信息，详情见1.5 (2) 参数说明
参数名 userAccount password 参数说明 用户名（追溯系统的登录账号） 密码（登录账号对应的密码） 是否必填 必填 必填
1.2.2. 数据推送接口
追溯系统所有的备案数据、台账数据的推送统一通过本接口进行对接。接口说明如下：
(1) 接口说明
原型接口 public String pushData(String info, String catalogid, String format, String verifyCode ,String[] fileName, byte[] fileContent) 功能描述 返回值 用于各企业将台账等数据汇聚到食药监追溯系统中。 见1.5 (2) 参数说明
参数名 info Catalogid format verifyCode fileName fileContent 参数说明 要推送的具体数据——必填 目录标识，为每个对接事项分配一个唯一标识，详见1.2.3 接口提供两种数据类型的接收方式，xml和json格式。 身份认证码，通过getVerifyCode()接口获取，详见1.2.1 附件名称数组 附件容 是否必填 必填 必填 必填 必填 根据接口情况 根据接口情况 1.2.3. Catalogid定义
类别 catalogid 15 16 11 食品生产企业 12 01 02 产品信息 食品生产台账信息 食品生产销货台账信息 原料供货商信息 销售对象信息 原料信息 事项名称
类别 catalogid 03 04 05 17 18 13 事项名称 食品生产不合格产品处理台账 食品生产不合格原料处理台账 食品原料进货台账信息 供货商信息 经销商信息 商品信息 进货台帐信息 销货台帐信息 退货台帐信息 商品处理台帐信息 供货商信息 销售对象信息 商品信息 进货台帐信息 销货台帐信息 退货台帐信息 商品（领用）处理台帐信息 产品质检报告 企业许可证信息 食品流通企业 06 07 08 09 17 18 13 餐饮（食堂）企业 06 07 08 10 14 其他 19 1.3. 接口具体数据（info参数）格式
1.3.1. 食品生产企业
1.3.1.1. 原料供货商信息
(1) 参数说明
参数名 参数类型 字段长度 参数说明 是否必填
fstEntName socialCreditUnicod字符型 字符型 256 32 企业名称 统一社会信用代码 必填 非必填 e regNo orgNo dom contacts contactsTel opScope opStartDate 字符型 字符型 字符型 字符型 字符型 字符型 字符型 32 32 1024 256 256 4000 64 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdminDiv字符型 isionValue cityAdminDivision字符型 Value areaAdminDivision字符型 Value nation 字符型 256 时必填 企业类型，参照数据字典fstEntType 字符型 1 1.4.8 主体所属批发市场ID或农belongMarket 字符型 32 贸市场ID 根据1.3.4.3章节获取 非必填 必填 8 区 国家，企业类型为境外企业非必填 区县级行政区划，如：鼓楼非必填 8 市级行政区划，如：市 必填 8 省级行政区划，如：省 必填 字符型 64 yyyy-MM-dd 非必填 工商注册号（号） 组织机构代码 经营场所 联系人 联系 营业围 经营起始时间，格式为非必填 非必填 非必填 必填 必填 非必填 非必填 (2) XML格式
< belongMarket >1
(3) JSON格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业
名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\注:各字段意思参见xml格式说明
1.3.1.2. 销售对象信息 (1) 参数说明
参数名 fstEntName socialCreditUnicode regNo orgNo dom contacts contactsTel opScope opStartDate 参数类型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字段长度 256 32 32 32 1024 256 256 4000 64 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdminDivisionV字符型 alue cityAdminDivisionValue areaAdminDivisionValue nation 字符型 字符型 字符型 8 8 区 256 国家，企业类型为境外企业非必填 市级行政区划，如：市 区县级行政区划，如：鼓楼非必填 必填 8 省级行政区划，如：省 必填 字符型 64 yyyy-MM-dd 非必填 参数说明 企业名称 统一社会信用代码 工商注册号 组织机构代码 经营场所 联系人 联系 营业围 经营起始时间，格式为非必填 是否必填 必填 非必填 非必填 非必填 必填 必填 非必填 非必填
时必填 企业类型，参照数据字典fstEntType 字符型 1 1.4.8 主体所属批发市场ID或农belongMarket 字符型 32 贸市场ID 根据1.3.4.3章节获取 非必填 必填 (2) XML格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\注:各字段意思参见xml格式说明
1.3.1.3. 原料信息 (1) 参数说明
参数名 参数类型 字段长度 参数说明 条形码，不填则由系统自动生barCode packingTypeNa字符型 me productName sellerIdName expiryDateNum expiryDateUnit netContent netContentUnit materialCategor字符型 yName 32 原料类型，参照数据字典1.4.5 必填 字符型 字符型 数字型 字符型 数字型 字符型 256 256 8 128 8 64 原料名称 生产者名称 保质期数值 保质期单位 净含量数值 净含量单位 必填 必填 必填 必填 非必填 非必填 256 包装类型，参照数据字典1.4.4 必填 字符型 256 成 非必填 是否必填
minSalesUnit 字符型 64 包装形式，如箱，件，包等 必填 (2) XML格式
(3) JSON格式
{\"packingTypeName\":\"预包装\原料\瓶\年\企业名称\接口原料测试\注:各字段意思参见xml格式说明
1.3.1.4. 产品信息 (1) 参数说明
参数名
参数类型 字段长度 参数说明 是否必填
条形码，不填则由系统自barCode productName expiryDateNum expiryDateUnit specification packagingNum packagingUnit minSalesUnit productCategor字符型 yName trademark 字符型 256 256 1.4.7 商标 非必填 字符型 字符型 数字型 字符型 字符型 字符型 字符型 字符型 256 动生成 256 8 64 64 32 64 64 包等 商品类别，参照数据字典必填 产品名称 保质期数值 保质期单位 规格 含最小销售单元数量 包装计量单位 最小销售单元，如箱，件，必填 必填 必填 必填 必填 非必填 非必填 非必填 (2) XML格式
{\"packagingNum\":\"1\商标牌\个\年\规格\水果制品\接口产品测试\ 注:各字段意思参见xml格式说明
1.3.1.5. 食品生产台账信息 (1) 参数说明
参数名 productName barCode batch producedDate unit stockNum 参数类型 字符型 字符型 字符型 字符型 字符型 字符型 字段长度 256 256 64 32 64 16 参数说明 商品名称 商品条码 批次 生产日期 单位 生产数量 是否必填 必填 必填 必填 必填 必填 必填 (2) XML格式
{\"unit\":\"箱\e\":\"老酒\" } 注:各字段意思参见xml格式说明
1.3.1.6. 食品生产销货台账信息 (1) 参数说明
参数名 distributorName salesDate productName barCode batch salesDetails salesNum producedDate unit 参数类型 字符型 字符型 字符型 字符型 字符型 数字型 字符型 字符型 字段长度 256 32 yyyy-MM-dd 256 256 64 16 32 yyyy-MM-dd 64 单位 必填 产品名称 条码 批次 销售数量 生产日期，格式为必填 必填 必填 必填 必填 参数说明 分销商名称 销货日期，格式为必填 是否必填 必填 (2) XML格式
(3) JSON格式
{\"salesDetails\":[{\"unit\":\"瓶\Name\":\"老酒\企业名称\注:各字段意思参见xml, salesDetails为数组,salesDetails为一个销售单号单号下的对应的销售详细信息，销售单号由系统自动生成。
1.3.1.7. 食品生产不合格产品处理台账 (1) 参数说明
参数名 参数类型 字段长度 参数说明 是否必填
productName barCode batch producedDate unit unqualifiedNum handleType 字符型 字符型 字符型 字符型 字符型 字符型 字符型 256 256 64 32 32 16 1 商品名称 商品条码 批次 生产日期 单位 不合格数量 处理类型，参照数据字典1.4.1 必填 必填 必填 必填 必填 必填 必填
(2) XML格式
(3) JSON格式
{\"unit\":\"单位\ctName\":\"达利园小面包\注:各字段意思参见model或xml
1.3.1.8. 食品生产不合格原料处理台账 (1) 参数说明
参数名 productName barCode batch producedDate unit unqualifiedNum handleType 参数类型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字段长度 256 256 62 32 64 16 1 参数说明 商品名称 商品条码 批次 生产日期 单位 不合格数量 处理类型，参照数据字典1.4.1 是否必填 必填 必填 必填 必填 必填 必填 必填 (2) XML格式
(3) JSON格式
{\"unit\":\"单位\ctName\":\"达利园小面包\
注:各字段意思参见model或xml
1.3.1.9. 食品原料进货台账信息 (1) 参数说明
参数名 productName barCode supplyEntName stockDate batch producedDate unit stockNum 参数类型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字符型 字段长度 256 256 256 32 yyyy-MM-dd 64 32 yyyy-MM-dd 64 16 单位 生产数量 必填 必填 批次 生产日期，格式为必填 必填 参数说明 商品名称 商品条码 原料供货商 进货日期，格式为 是否必填 必填 必填 必填 (2) XML格式
{\"unit\":\"千克Name\":\"测试原料供货商0923\大神大神打撒\注:各字段意思参见model或xml
1.3.2. 食品流通企业
1.3.2.1. 供货商信息 (1) 参数说明
参数名 fstEntName socialCreditUn字符型 icode regNo orgNo dom contacts contactsTel opScope opStartDate 字符型 字符型 字符型 字符型 字符型 字符型 字符型 32 32 1024 256 256 4000 32 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdmi字符型 字符型 32 yyyy-MM-dd 8 省级行政区划，如：省 必填 非必填 工商注册号 组织机构代码 经营场所 联系人 联系 营业围 经营起始时间，格式为非必填 非必填 非必填 必填 必填 非必填 非必填 32 统一社会信用代码 非必填 参数类型 字符型 字段长度 256 参数说明 企业名称 是否必填 必填
nDivisionValue cityAdminDivi字符型 sionValue areaAdminDiv字符型 isionValue nation 字符型 256 企业时必填 企业类型，参照数据字fstEntType 字符型 1 典1.4.8 主体所属批发市场IDbelongMarket 字符型 32 或农贸市场ID 根据1.3.4.3章节获取 非必填 必填 8 鼓楼区 国家，企业类型为境外非必填 区县级行政区划，如：非必填 8 市级行政区划，如：市 必填 (2) XML格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\ 注:各字段意思参见model或xml
1.3.2.2. 经销商信息 (1) 参数说明
参数名 fstEntName socialCreditUnicode regNo orgNo dom 参数类型 字符型 字符型 字符型 字符型 字符型 字段长度 256 32 32 32 1024 参数说明 企业名称 统一社会信用代码 工商注册号 组织机构代码 经营场所 是否必填 必填 非必填 非必填 非必填 必填
contacts contactsTel opScope opStartDate 字符型 字符型 字符型 字符型 256 256 4000 32 联系人 联系 营业围 经营起始时间，格式为必填 非必填 非必填 非必填 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdminDivisi字符型 onValue cityAdminDivisionVa字符型 lue areaAdminDivisionV字符型 alue nation 字符型 256 业时必填 企业类型，参照数据字典fstEntType 字符型 1 1.4.8 主体所属批发市场ID或农belongMarket 字符型 32 贸市场ID 根据1.3.4.3章节获取 非必填 必填 8 楼区 国家，企业类型为境外企非必填 区县级行政区划，如：鼓非必填 8 市级行政区划，如：市 必填 8 省级行政区划，如：省 必填 字符型 32 yyyy-MM-dd 非必填 (2) XML格式
< belongMarket >1
(3) JSON格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\注:各字段意思参见xml
1.3.2.3. 商品信息 (1) 参数说明
参数名 参数类型 字段长度 参数说明 条形码，不填则由系统自动barCode productName placeTypeName sellerIdName socialCreditUnicode expiryDateNum expiryDateUnit specification minSalesUnit 字符型 字符型 字符型 字符型 字符型 数字型 字符型 字符型 字符型 256 生成 256 128 1.4.6 256 32 16 64 64 32 包等 商品类别，参照数据字典productCategoryName trademark 字符型 字符型 64 1.4.7 256 商标 非必填 必填 生产企业名称 生产企业统一社会信用代码 保质期数值 保质期单位 规格 最小销售单元，如箱，件，必填 必填 非必填 必填 必填 必填 商品名称 商品类型，参照数据字典必填 必填 非必填 是否必填 (2) XML格式
{\"placeTypeName\":\"省外商品\商标牌\年\个\规格\企业名称\生产企业统一社会信用代码\水果制品\接口商品测试\注:各字段意思参见xml
1.3.2.4. 进货台账信息 (1) 参数说明
参数名 supplyEntName stockDate stockDetails productName 参数类型 字段长度 字符型 字符型 字符型 256 32 yyyy-MM-dd 256 产品名称 必填 参数说明 供货商名称 进货日期，格式为必填 是否必填 必填
barCode batch stockNum producedDate socialCreditU字符型 字符型 数字型 字符型 256 64 16 32 条码 批次 进货数量 生产日期，格式为必填 必填 必填 必填 yyyy-MM-dd 生产企业统一社会信用字符型 nicode unit 字符型 32 32 代码 单位 必填 非必填 (2) XML格式
{\"stockDetails\":[{\"unit\":\"瓶\editUnicode\":\"生产企业统一社会信用代码\老酒\瓶\editUnicode\":\"生产企业统一社会信用代码\老酒\企业名称\注:各字段意思参见model或xml
1.3.2.5. 销货台账信息 (1) 参数说明
参数名 distributorName salesDate productName barCode batch salesNum salesDetails 生产日期，格式为producedDate socialCreditU字符型 nicode 32 代码 字符型 32 yyyy-MM-dd 生产企业统一社会信用非必填 必填 参数类型 字符型 字符型 字符型 字符型 字符型 数字型 字段长度 256 32 yyyy-MM-dd 256 256 64 16 产品名称 条码 批次 销售数量 必填 必填 必填 必填 参数说明 分销商名称 销货日期，格式为必填 是否必填 必填
unit 字符型 32 单位 必填 (2) XML格式
(3) JSON格式
{\"salesDetails\":[{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\企业名称\ 注:各字段意思参见model或xml
1.3.2.6. 退货台账信息 (1) 参数说明
参数名 productName barCode batch producedDate socialCreditUni字符型 code unit returnNum 字符型 字符型 32 16 单位 退货数量 必填 必填 32 生产企业统一社会信用代码 非必填 参数类型 字符型 字符型 字符型 字符型 字段长度 256 256 64 32 参数说明 商品名称 商品条码 批次 生产日期 是否必填 必填 必填 必填 必填 (2) XML格式
{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\ 注:各字段意思参见model或xml
1.3.2.7. 商品处理台帐信息 (1) 参数说明
参数名 productName barCode batch producedDate socialCreditUni字符型 code unit returnNum handleType 字符型 字符型 字符型 32 16 1 1.4.2 单位 处理数量 处理类型，参照数据字典 必填 必填 32 生产企业统一社会信用代码 非必填 参数类型 字符型 字符型 字符型 字符型 字段长度 256 256 64 32 参数说明 商品名称 商品条码 批次 生产日期 是否必填 必填 必填 必填 必填 (2) XML格式
{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\注:各字段意思参见model或xml
1.3.3. 餐饮（食堂）企业
1.3.3.1. 供货商信息 (1) 参数说明
参数名 fstEntName socialCreditUnicod字符型 e regNo orgNo dom contacts 字符型 字符型 字符型 字符型 32 32 1024 256 工商注册号 组织机构代码 经营场所 联系人 非必填 非必填 必填 必填 32 统一社会信用代码 非必填 参数类型 字符型 字段长度 256 参数说明 企业名称 是否必填 必填
contactsTel opScope opStartDate 字符型 字符型 字符型 256 4000 32 联系 营业围 经营起始时间，格式为非必填 非必填 非必填 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdminDiv字符型 isionValue cityAdminDivision字符型 Value areaAdminDivision字符型 Value nation 字符型 256 企业时必填 企业类型，参照数据字fstEntType 字符型 1 典1.4.8 主体所属批发市场IDbelongMarket 字符型 32 或农贸市场ID 根据1.3.4.3章节获取 非必填 必填 8 鼓楼区 国家，企业类型为境外非必填 区县级行政区划，如：非必填 8 市级行政区划，如：市 必填 8 省级行政区划，如：省 必填 字符型 32 yyyy-MM-dd 非必填 (2) XML格式
< belongMarket >1
(3) JSON格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\注:各字段意思参见model或xml
1.3.3.2. 销售对象信息 (1) 参数说明
参数名
参数类型 字段长度 参数说明 是否必填
fstEntName socialCreditUnicod字符型 字符型 256 32 企业名称 统一社会信用代码 必填 非必填 e regNo orgNo dom contacts contactsTel opScope opStartDate 字符型 字符型 字符型 字符型 字符型 字符型 字符型 32 32 1024 256 256 4000 32 yyyy-MM-dd 经营终止时间，格式为opEndDate provinceAdminDiv字符型 isionValue cityAdminDivision字符型 Value areaAdminDivision字符型 Value nation 字符型 256 业时必填 企业类型，参照数据字典fstEntType 字符型 1 1.4.8 主体所属批发市场ID或belongMarket 字符型 32 农贸市场ID 根据1.3.4.3章节获取 非必填 必填 8 楼区 国家，企业类型为境外企非必填 区县级行政区划，如：鼓非必填 8 市级行政区划，如：市 必填 8 省级行政区划，如：省 必填 字符型 32 yyyy-MM-dd 非必填 工商注册号 组织机构代码 经营场所 联系人 联系 营业围 经营起始时间，格式为非必填 非必填 非必填 必填 必填 非必填 非必填 (2) XML格式
< belongMarket >1
(3) JSON格式
{\"socialCreditUnicode\":\"31xxx5L\计算机及网络软件的开发与服务\市保税区xxxxxxxx\省\企业
名称111\鼓楼区\中国\市\王某某\-11-11\主体所属批发市场ID或农贸市场ID\注:各字段意思参见model或xml
1.3.3.3. 商品信息 (1) 参数说明
参数名 参数类型 字段长度 参数说明 条形码，不填则由系统自barCode productName placeTypeName sellerIdName socialCreditUnicode expiryDateNum expiryDateUnit specification minSalesUnit 字符型 字符型 字符型 字符型 字符型 数字型 字符型 字符型 字符型 256 动生成 256 32 1.4.6 256 32 码 16 32 32 32 包等 商品类别，参照数据字典productCategoryName trademark 字符型 字符型 64 1.4.7 256 商标 非必填 必填 保质期数值 保质期单位 规格 最小销售单元，如箱，件，必填 必填 必填 必填 生产企业名称 生产企业统一社会信用代非必填 必填 商品名称 商品类型，参照数据字典必填 必填 非必填 是否必填 (2) XML格式
(3) JSON格式
{\"placeTypeName\":\"省外商品\商标牌\年\个\规格\企业名称\生产企业统一社会信用代码\水果制品\接口商品测试\注:各字段意思参见model或xml
1.3.3.4. 进货台账信息 (1) 参数说明
参数名 supplyEntName stockDate 参数类型 字符型 字符型 字段长度 256 32 参数说明 供货商名称 进货日期，格式为是否必填 必填 必填
yyyy-MM-dd productName barCode batch stockNum stockDetails producedDate socialCreditU字符型 nicode unit 字符型 32 32 代码 单位 必填 字符型 32 yyyy-MM-dd 生产企业统一社会信用非必填 字符型 字符型 字符型 数字型 256 256 64 16 产品名称 条码 批次 进货数量 生产日期，格式为必填 必填 必填 必填 必填 (2) XML格式
{\"stockDetails\":[{\"unit\":\"瓶\editUnicode\":\"生产企业统一社会信用代码\老酒\瓶\editUnicode\":\"生产企业统一社会信用代码\老酒\企业名称\注:各字段意思参见model或xml
1.3.3.5. 销货台账信息 (1) 参数说明
参数名 distributorName salesDate productName barCode batch salesDetails salesNum producedDate 数字型 字符型 16 32 yyyy-MM-dd 销售数量 生产日期，格式为必填 必填 参数类型 字符型 字符型 字符型 字符型 字符型 字段长度 256 32 yyyy-MM-dd 256 256 64 产品名称 条码 批次 必填 必填 必填 参数说明 分销商名称 销货日期，格式为必填 是否必填 必填
socialCreditU字符型 nicode unit 字符型 32 32 生产企业统一社会信用非必填 代码 单位 必填 (2) XML格式
{\"salesDetails\":[{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\企业名称\注:各字段意思参见model或xml
1.3.3.6. 退货台账信息 (1) 参数说明
参数名 productName barCode batch producedDate socialCreditUn字符型 icode unit returnNum 字符型 字符型 32 16 单位 退货数量 必填 必填 32 生产企业统一社会信用代码 非必填 参数类型 字符型 字符型 字符型 字符型 字段长度 256 256 64 32 参数说明 商品名称 商品条码 批次 生产日期 是否必填 必填 必填 必填 必填 (2) XML格式
{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\注:各字段意思参见model或xml
1.3.3.7. 商品（领用）处理台帐信息 (1) 参数说明
参数名 productName barCode batch producedDate socialCreditUnico字符型 de unit returnNum handleType 字符型 字符型 字符型 32 16 1 单位 处理数量 处理类型，参照数据字典1.4.3 必填 必填 32 生产企业统一社会信用代码 非必填 参数类型 字符型 字符型 字符型 字符型 字段长度 256 256 64 32 参数说明 商品名称 商品条码 批次 生产日期 是否必填 必填 必填 必填 必填 (2) XML格式
{\"unit\":\"瓶\ditUnicode\":\"生产企业统一社会信用代码\老酒\注:各字段意思参见model或xml
1.3.4. 其他
1.3.4.1. 质检报告 (1) 参数说明
参数名 barCode qcNum validEndDate qcName 参数类型 字符型 字符型 字符型 字符型 字段长度 256 256 32 yyyy-MM-dd 256 质检报告名称 必填 参数说明 商品条码 质检报告编号 质检报告有效期，格式为必填 是否必填 必填 必填 (2) XML格式
{\"remark\":\"备注\质检报告编号111\质检名称\" } (4) 附件说明：许可证图片文件名参数为fileName，许可证图片数据参数名为
fileContent。
1.3.4.2. 企业许可证信息 (1) 参数说明
参数名 fstEntName licTypeName licValidEndDate licNum 参数类型 字符型 字符型 字符型 字符型 字段长度 256 64 32 yyyy-MM-dd 64 许可证编号 必填 参数说明 企业名称 许可证类型，参考数据字典1.4.9 许可证有效期，格式为必填 是否必填 必填 必填 (2) XML格式
{\"licValidEndDate\":\"2016-11-11\许可证编号1111\食品经营许可证\企业名称\" } (4) 附件说明：许可证图片文件名参数为fileName，许可证图片数据参数名为
fileContent。 1.3.4.3. 市场信息查询
(1) 参数说明
参数名 参数类型 字段长度 参数说明 市场名称。如果为空，则返回全terminalName 字符型 500 部市场信息 非必填 是否必填 (2) XML格式
{\"terminalID\":\"市场ID\市场名称\市场代码\所属省行政区划\所属市行政区划\所属县行政区划\市场状态 0 - 禁用；1 - 有效\" } 1.4. 数据字典
以下字典表是接口调用过程中需要用到的参照值，参数值是调用接口传递的值，参数说明是指参数值所代表的含义。如食品生产不合格处理类型为“报废”时，传递给webservice接口的参数值为“2”。再以包装类型数据字典为例，包装类型为“预包装”时，传递给webservice接口的参数值为“预包装”。
1.4.1. 食品生产不合格处理类型
类型 食品生产不合格处理 食品生产不合格处理 食品生产不合格处理 参数值 1 2 3 说明 销毁 报废 其他 1.4.2. 食品流通处理类型
类型 食品流通处理类型 食品流通处理类型 食品流通处理类型 食品流通处理类型 食品流通处理类型 食品流通处理类型 参数值 2 3 4 7 8 9 说明 销毁 报废 其他 零售 投用 接收退货 1.4.3. 餐饮处理类型
类型 参数值 说明
餐饮处理类型 餐饮处理类型 餐饮处理类型 餐饮处理类型 餐饮处理类型 餐饮处理类型 餐饮处理类型 餐饮处理类型 2 3 4 5 6 7 8 9 销毁 报废 其他 厨房领用 前厅领用 零售 投用 接收退货 1.4.4. 包装类型
类型 包装类型 包装类型 包装类型 参数值 预包装 散装 食用农产品 说明 预包装 散装 食用农产品 1.4.5. 原料类型
类型 原料类型 原料类型 原料类型 参数值 原料 食品添加剂 包装材料 说明 原料 食品添加剂 包装材料 1.4.6. 商品类型
类型 商品类型 商品类型 商品类型 参数值 省商品 省外商品 海外商品 说明 省商品 省外商品 海外商品 1.4.7. 商品类别
类型 参数值 说明
商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 商品类别 粮食加工品 粮食加工品 食用油、油脂及其制品 食用油、油脂及其制品 调味品 肉制品 乳制品 饮料 方便食品 饼干 罐头 冷冻饮品 速冻食品 薯类和膨化食品 糖果制品 茶叶及相关制品 酒类 蔬菜制品 水果制品 炒货食品及坚果制品 蛋制品 可可及焙烤咖啡产品 食糖 水产制品 淀粉及淀粉制品 糕点 豆制品 蜂产品 保健食品 特殊医学用途配方食品 婴幼儿配方食品 调味品 肉制品 乳制品 饮料 方便食品 饼干 罐头 冷冻饮品 速冻食品 薯类和膨化食品 糖果制品 茶叶及相关制品 酒类 蔬菜制品 水果制品 炒货食品及坚果制品 蛋制品 可可及焙烤咖啡产品 食糖 水产制品 淀粉及淀粉制品 糕点 豆制品 蜂产品 保健食品 特殊医学用途配方食品 婴幼儿配方食品
商品类别 商品类别 商品类别 特殊膳食食品 其他食品 食品添加剂 特殊膳食食品 其他食品 食品添加剂 1.4.8. 企业类型
类型 企业类型 企业类型 企业类型 企业类型 企业类型 参数值 1 2 3 4 5 说明 企业 个人 学校 事业单位 境外企业 1.4.9. 许可证类型
类型 许可证类型 许可证类型 参数值 食品生产许可证 食品经营许可证 说明 食品生产许可证 食品经营许可证 1.5. 接口返回值
(1) XML格式 返回XML格式如下：
编码 -2 -1 编码说明 业务异常 系统异常
00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 操作成功 逻辑业务出错 数据信息为不能空！ 目录标识不能为空！ 数据格式不能为空！ 身份认证码不能为空！ 身份认证码不正确 账号或密码错误！ 根据参数找不到目录信息！ json格式解析异常 xml格式解析异常 请确认[format]参数是否为json或xml 用户名不能为空 密码不能为空 身份认证码超时 2. 注意事项
(1) 在调用pushData()接口前需要通过getVerifyCode()接口进行身份认证，获取身份认证码。身份认证是pushData()请求的唯一凭证。身份认证码有效期30分钟，身份认证码过期后需要重新请求。
(2) 时间数据采用yyyy-MM-dd HH:mm:ss（如：2016-04-29 09:09:01）格式传输。
(3) info参数如果为XML格式的数据，需要用来包裹数据，即，如下图：
(4) 在与企业信息备案相关的接口中（包括供货商与经销商），如果企业类型为个人时必须上传正反面照片。正反面照片图片文件的文件名放入fileName参数中作为数组或List传递，正反面照片数据放入fileContent参数中作为数组或List传递，仅能上传两图片。
(5) 在与企业信息备案相关的接口中（包括供货商与经销商），如果企业类型为企业或者境外企业时，可选上传营业执照照片（证照照片），照片图片文件的文件名放入fileName参数中作为数组或List传递，照片数据放入fileContent参数中作为数组或List传递，仅能上传一图片。若无证照图片上传，请将这两个参数设置为空。
(6) 企业信息备案中，如果企业名称已经存在则自动与已存在的企业进行关联关联备案。同理，产品（商品、原料）信息备案中如果条码已经存在则自动与已存在的产品（商品、原料）进行关联备案。
3. 系统对接申请流程 3.1. 食品生产经营企业数据对接申请流程 食品生产经营企业数据对接申请流程食品生产经营企业省局业务处室省局对接技术人员输出物流程开始登录“福建省食品生产经营追溯管理系统”，企业进行注册；提交对接申请单申请审批《食品生产经营企业数据对接申请表》否是否通过是系统对接提供测试环境，进行对接；(参照本技术规范章节1执行)测试完成后，提供正式环境地址；(参照本技术规范章节1执行)回复企业及省局业务处事完成对接流程结束
3.2. 食品生产经营企业数据对接申请表
省“一品一码”食品安全追溯管理 食品生产经营企业数据对接申请表
申请企业名称 企业类型 追溯系统账号 联系 对接系统名称 对接系统地址 对接系统描述 □食品生产 □食品销售 □餐饮（食堂） 联系人 联系 我单位承诺严格遵守国家及省网络安全和电子政务数据共享相关法律法规和文件规定，妥善保管省“一品一码”食品安全信息追溯管理平台数据共享接口用户信息，对上传数据的真实性和完整性负责，并承担共享数据的责任，保障共享数据的存储、传输和使用安全。 申请单位：(盖章) 申请日期： 以下由省食品药品监督管理局填写 省局业务 处室意见 签 字： 日 期： 账 号： 密 码： 账号开通 操作人： 开通日期： 注：申请人填写本表并加盖单位公章后，寄送如下地址： 省市东浦路156号省食品药品监督管理局信息中心（350003） 收件人：廖佳铭 电 话：09
因篇幅问题不能全部显示，请点此查看更多更全内容