1、福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范福建省食品药品监督管理局二一八年九月食品生产经营企业数据对接接口技术规范I目 录1. 接口设计 .11.1. 接口地址 .11.2. 追溯系统数据接口 .11.2.1. 用户身份认证接口 .11.2.2. 数据推送接口 .21.2.3. Catalogid 定义 .21.3. 接口具体数据（info 参数）格式 .31.3.1. 食品生产企业 .31.3.2. 食品流通企业 .171.3.3. 餐饮（食堂）企业 .291.3.4. 其他 .421.4. 数据字典 .441.4.1. 食品生产不合格处理类型 .441.4.2.
2、 食品流通处理类型 .451.4.3. 餐饮处理类型 .451.4.4. 包装类型 .451.4.5. 原料类型 .451.4.6. 商品类型 .461.4.7. 商品类别 .461.4.8. 企业类型 .471.4.9. 许可证类型 .471.5. 接口返回值 .482. 注意事项 .493. 系统对接申请流程 .513.1. 食品生产经营企业数据对接申请流程 .513.2. 食品生产经营企业数据对接申请表 .52食品生产经营企业数据对接接口技术规范第 1 页，共 52 页1. 接口设计1.1. 接口地址系统通过 Web Service 进行数据对接。数据对接测试环境地址：http:/110
3、.85.58.153:5004/fdafst/webservice/dataReceive?wsdl数据对接正式环境地址：http:/120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl1.2. 追溯系统数据接口追溯系统数据接口实现企业自建追溯系统与福建省食品追溯系统对接，实现系统间的追溯数据对接。1.2.1. 用户身份认证接口调用方对接追溯系统前，需先进行身份认证。通过本接口认证成功后，将返回一个身份认证码，该身份认证码做为后续数据接口的认证参数。身份认证码有效期 30 分钟，身份认证码过期后需要重新请求获取。(1) 接口说明(2) 参数
4、说明原型接口 public String getVerifyCode(string userAccount, string password)功能描述 业务系统的身份认证功能返回值 认证成功，返回身份认证码，认证失败，返回具体错误信息，详情见 1.5参数名 参数说明 是否必填userAccount 用户名（追溯系统的登录账号） 必填password 密码（登录账号对应的密码） 必填食品生产经营企业数据对接接口技术规范第 2 页，共 52 页1.2.2. 数据推送接口追溯系统所有的备案数据、台账数据的推送统一通过本接口进行对接。接口说明如下：(1) 接口说明(2) 参数说明1.2.3. Cata
5、logid 定义类别 catalogid 事项名称15 原料供货商信息16 销售对象信息11 原料信息12 产品信息01 食品生产台账信息食品生产企业02 食品生产销货台账信息原型接口 public String pushData(String info, String catalogid, String format, String verifyCode ,String fileName, byte fileContent)功能描述 用于各企业将台账等数据汇聚到食药监追溯系统中。返回值 见 1.5参数名 参数说明 是否必填info 要推送的具体数据必填 必填Catalogid 目录标识，为每
6、个对接事项分配一个唯一标识，详见 1.2.3 必填format 接口提供两种数据类型的接收方式，xml 和 json 格式。 必填verifyCode 身份认证码，通过 getVerifyCode()接口获取，详见 1.2.1 必填fileName 附件名称数组 根据接口情况fileContent 附件内容 根据接口情况食品生产经营企业数据对接接口技术规范第 3 页，共 52 页类别 catalogid 事项名称03 食品生产不合格产品处理台账04 食品生产不合格原料处理台账05 食品原料进货台账信息17 供货商信息18 经销商信息13 商品信息06 进货台帐信息07 销货台帐信息08 退货台
7、帐信息食品流通企业09 商品处理台帐信息17 供货商信息18 销售对象信息13 商品信息06 进货台帐信息07 销货台帐信息08 退货台帐信息餐饮（食堂）企业10 商品（领用）处理台帐信息14 产品质检报告其他19 企业许可证信息1.3. 接口具体数据（info 参数）格式1.3.1. 食品生产企业1.3.1.1. 原料供货商信息(1) 参数说明食品生产经营企业数据对接接口技术规范第 4 页，共 52 页参数名 参数类型 字段长度 参数说明 是否必填fstEntName 字符型 256 企业名称 必填socialCreditUnicode字符型 32 统一社会信用代码 非必填regNo 字符型
8、 32 工商注册号（身份证号） 非必填orgNo 字符型 32 组织机构代码 非必填dom 字符型 1024 经营场所 必填contacts 字符型 256 联系人 必填contactsTel 字符型 256 联系电话 非必填opScope 字符型 4000 营业范围 非必填opStartDate 字符型 64经营起始时间，格式为yyyy-MM-dd非必填opEndDate 字符型 64经营终止时间，格式为yyyy-MM-dd非必填provinceAdminDivisionValue字符型 8 省级行政区划，如：福建省 必填cityAdminDivisionValue字符型 8 市级行政区划，
9、如：福州市 必填areaAdminDivisionValue字符型 8区县级行政区划，如：鼓楼区非必填nation 字符型 256国家，企业类型为境外企业时必填非必填fstEntType 字符型 1企业类型，参照数据字典1.4.8必填belongMarket 字符型 32主体所属批发市场 ID 或农贸市场 ID根据 1.3.4.3 章节获取非必填食品生产经营企业数据对接接口技术规范第 5 页，共 52 页(2) XML 格式企业名称913501007173106xxx3501xxxxxxxx34856913x福州市保税区 xxxxxxxxx王某某 13799912312计算机及网络软件的开发与
10、服务2016-11-112021-11-11福建省福州市鼓楼区中国11(3) JSON 格式食品生产经营企业数据对接接口技术规范第 6 页，共 52 页“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“计算机及网络软件的开发与服务“,“dom“:“福州市保税区 xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企业名称 111“,“areaAdminDivisionValue“:“鼓楼区“,“contactsTel“:“1379991
11、2312“,“nation“:“中国“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主体所属批发市场 ID 或农贸市场 ID“注:各字段意思参见 xml 格式说明1.3.1.2. 销售对象信息(1) 参数说明参数名 参数类型 字段长度 参数说明 是否必填fstEntName 字符型 256 企
12、业名称 必填socialCreditUnicode 字符型 32 统一社会信用代码 非必填regNo 字符型 32 工商注册号 非必填orgNo 字符型 32 组织机构代码 非必填dom 字符型 1024 经营场所 必填contacts 字符型 256 联系人 必填contactsTel 字符型 256 联系电话 非必填opScope 字符型 4000 营业范围 非必填opStartDate 字符型 64经营起始时间，格式为yyyy-MM-dd非必填opEndDate 字符型 64经营终止时间，格式为yyyy-MM-dd非必填provinceAdminDivisionValue字符型 8省级行
13、政区划，如：福建省必填cityAdminDivisionValue 字符型 8市级行政区划，如：福州市必填食品生产经营企业数据对接接口技术规范第 7 页，共 52 页(2) XML 格式企业名称913501007173106xxx3501xxxxxxxx34856913x福州市保税区 xxxxxxxxx王某某 13799912312计算机及网络软件的开发与服务2016-11-112021-11-11福建省areaAdminDivisionValue 字符型 8区县级行政区划，如：鼓楼区非必填nation 字符型 256国家，企业类型为境外企业时必填非必填fstEntType 字符型 1企业类型
14、，参照数据字典1.4.8必填belongMarket 字符型 32主体所属批发市场 ID 或农贸市场 ID根据 1.3.4.3 章节获取非必填食品生产经营企业数据对接接口技术规范第 8 页，共 52 页福州市鼓楼区中国11(3) JSON 格式“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“计算机及网络软件的开发与服务“,“dom“:“福州市保税区 xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企业名称 111“,“areaAd
15、minDivisionValue“:“鼓楼区“,“contactsTel“:“13799912312“,“nation“:“中国“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主体所属批发市场 ID 或农贸市场 ID“注:各字段意思参见 xml 格式说明1.3.1.3. 原料信息(1) 参数说明参数名 参数类型 字段长度 参数说明 是否必填barCode 字符型 256条形码，不填则由系统自动生成非必填packingTypeName字符型 256 包装类型，参照数据字典 1.4.4 必填productName 字符型 256 原料名称 必填sellerIdName 字符型 256 生产者名称 必填expiryDateNum 数字型 8 保质期数值 必填expiryDateUnit 字符型 128 保质期单位 必填
