1、平潭综合实验区行政服务中心综合审批服务平台采购项目福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范福建省食品药品监督管理局二一八年九月II食品生产经营企业数据对接接口技术规范目 录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.食品流通处理类型451.4.3
2、.餐饮处理类型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.食品生产经营企业数据对接申请表52I1. 接口设计1.1. 接口地址系统通过Web Service进行数据对接。数据对接测试环境地址：http:/110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl数据对接正式环境地址：http:/120.35.29.61:8081/
3、fdauser/webservice/dataReceive?wsdl1.2. 追溯系统数据接口追溯系统数据接口实现企业自建追溯系统与福建省食品追溯系统对接，实现系统间的追溯数据对接。1.2.1. 用户身份认证接口调用方对接追溯系统前，需先进行身份认证。通过本接口认证成功后，将返回一个身份认证码，该身份认证码做为后续数据接口的认证参数。身份认证码有效期30分钟，身份认证码过期后需要重新请求获取。(1) 接口说明原型接口public String getVerifyCode(string userAccount, string password)功能描述业务系统的身份认证功能返回值认证成功，返回
4、身份认证码，认证失败，返回具体错误信息，详情见1.5(2) 参数说明参数名参数说明是否必填userAccount用户名（追溯系统的登录账号）必填password密码（登录账号对应的密码）必填1.2.2. 数据推送接口追溯系统所有的备案数据、台账数据的推送统一通过本接口进行对接。接口说明如下：(1) 接口说明原型接口public String pushData(String info, String catalogid, String format, String verifyCode ,String fileName, byte fileContent)功能描述用于各企业将台账等数据汇聚到食药
5、监追溯系统中。返回值见1.5(2) 参数说明参数名参数说明是否必填info要推送的具体数据必填必填Catalogid 目录标识，为每个对接事项分配一个唯一标识，详见1.2.3必填format接口提供两种数据类型的接收方式，xml和json格式。必填verifyCode身份认证码，通过getVerifyCode()接口获取，详见1.2.1必填fileName附件名称数组根据接口情况fileContent附件内容根据接口情况1.2.3. Catalogid定义类别catalogid事项名称食品生产企业15原料供货商信息16销售对象信息11原料信息12产品信息01食品生产台账信息02食品生产销货台账
6、信息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字符型256企业名称必填socialCredi
7、tUnicode字符型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省级行政区划，如：福建省必填cityAdminDivisionValue字符型8市级行政区划，
8、如：福州市必填areaAdminDivisionValue字符型8区县级行政区划，如：鼓楼区非必填nation字符型256国家，企业类型为境外企业时必填非必填fstEntType字符型1企业类型，参照数据字典1.4.8必填belongMarket字符型32主体所属批发市场ID或农贸市场ID根据1.3.4.3章节获取非必填(2) XML格式 企业名称 913501007173106xxx 3501xxxxxxxx3 4856913x 福州市保税区xxxxxxxxx 王某某 13799912312 计算机及网络软件的开发与服务 2016-11-11 2021-11-11 福建省 福州市 鼓楼区 中
9、国 1 1(3) JSON格式socialCreditUnicode:9135010071731xxx5L,opScope:计算机及网络软件的开发与服务,dom:福州市保税区xxxxxxxx,provinceAdminDivisionValue:福建省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTel:13799912312,nation:中国,cityAdminDivisionValue:福州市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:201
10、6-11-11,regNo:35xxxxx000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见xml格式说明1.3.1.2. 销售对象信息(1) 参数说明参数名参数类型字段长度参数说明是否必填fstEntName字符型256企业名称必填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省级行政区划，如：福建省必填cityAdminDivisionValue字符型8市级行政区划，如：福州市必填areaAdminDivisionValue字符型8区县级行政区划，如：鼓楼区非必填nation字符型256国家，企业类型为境外企业时必填非必填fstEntType字符型1企业类型，参照数据字典1.4.8必填
