福建省一品一码食品安全追溯管理

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进行数据对接。数据对接测试环境地址：53:5004/fdafst/webservice/dataReceive?wsdl数据对接正式环境地址：1: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) 参数说明参数名参数类型字段长度参数说明是否必填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根据章节获取非必填(2) XML格式 企业名称 913501007173106xxx 3501xxxxxxxx3 4856913x 福州市保税区xxxxxxxxx 王某某计算机及网络软件的开发与服务 2016-11-11 2021-11-11 福建省 福州市 鼓楼区 中

9、国 1 1(3) JSON格式socialCreditUnicode:9135010071731xxx5L,opScope:计算机及网络软件的开发与服务,dom:福州市保税区xxxxxxxx,provinceAdminDivisionValue:福建省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTelnation:中国,cityAdminDivisionValue:福州市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:201

10、6-11-11,regNo:35xxxxx000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见xml格式说明. 销售对象信息(1) 参数说明参数名参数类型字段长度参数说明是否必填fstEntName字符型256企业名称必填socialCreditUnicode字符型32统一社会信用代码非必填regNo字符型32工商注册号非必填orgNo字符型32组织机构代码非必填dom字符型1024经营场所必填contacts字符型256联系人必填contactsTel字符型256联系电话非必填opScope

11、字符型4000营业范围非必填opStartDate字符型64经营起始时间，格式为yyyy-MM-dd非必填opEndDate字符型64经营终止时间，格式为yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省级行政区划，如：福建省必填cityAdminDivisionValue字符型8市级行政区划，如：福州市必填areaAdminDivisionValue字符型8区县级行政区划，如：鼓楼区非必填nation字符型256国家，企业类型为境外企业时必填非必填fstEntType字符型1企业类型，参照数据字典1.4.8必填belongMarket字符型32主体所属批

12、发市场ID或农贸市场ID根据章节获取非必填(2) XML格式 企业名称 913501007173106xxx 3501xxxxxxxx3 4856913x 福州市保税区xxxxxxxxx 王某某计算机及网络软件的开发与服务 2016-11-11 2021-11-11 福建省 福州市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:9135010071731xxx5L,opScope:计算机及网络软件的开发与服务,dom:福州市保税区xxxxxxxx,provinceAdminDivisionValue:福建省,orgNo:

13、orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTelnation:中国,cityAdminDivisionValue:福州市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35xxxxx000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见xml格式说明. 原料信息(1) 参数说明参数名参数类型字段长度参数说

14、明是否必填barCode字符型256条形码，不填则由系统自动生成非必填packingTypeName字符型256包装类型，参照数据字典1.4.4必填productName字符型256原料名称必填sellerIdName字符型256生产者名称必填expiryDateNum数字型8保质期数值必填expiryDateUnit字符型128保质期单位必填netContent数字型8净含量数值非必填netContentUnit字符型64净含量单位非必填materialCategoryName字符型32原料类型，参照数据字典1.4.5必填minSalesUnit字符型64包装形式，如箱，件，包等必填(2)

15、XML格式 Y123442312312 预包装 webservice接口原料测试 企业名称 1 年 330 ml 原料 瓶(3) JSON格式packingTypeName:预包装,netContentUnit:ml,expiryDateNum:1,materialCategoryName:原料,minSalesUnit:瓶,expiryDateUnit:年,barCode:Y1112333123123,sellerIdName:企业名称,netContent:330,productName:webservice接口原料测试注:各字段意思参见xml格式说明. 产品信息(1) 参数

16、说明参数名参数类型字段长度参数说明是否必填barCode字符型256条形码，不填则由系统自动生成非必填productName字符型256产品名称必填expiryDateNum数字型8保质期数值必填expiryDateUnit字符型64保质期单位必填specification字符型64规格必填packagingNum字符型32内含最小销售单元数量非必填packagingUnit字符型64包装计量单位非必填minSalesUnit字符型64最小销售单元，如箱，件，包等必填productCategoryName字符型256商品类别，参照数据字典1.4.7必填trademark字符型256商标非必填(

17、2) XML格式 Y123442312312 webservice接口产品测试 1 年 规格 个 水果制品 商标牌 330ml 1(3) JSON格式packagingNum:1,expiryDateNum:1,trademark:商标牌,minSalesUnit:个,expiryDateUnit:年,specification:规格,productCategoryName:水果制品,barCode:Y123442312312,packagingUnit:330ml,productName:webservice接口产品测试注:各字段意思参见xml格式说明. 食品生产台账信息(1)

18、 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型64批次必填producedDate字符型32生产日期必填unit字符型64单位必填stockNum字符型16生产数量必填(2) XML格式福建老酒100箱201611282016-11-286926032336334(3) JSON格式unit:箱,stockNum:100,batch:20161128,barCode:6926032336334,producedDate:2016-11-11,productName:福建老酒 注:各字段意思参见

19、xml格式说明. 食品生产销货台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填distributorName字符型256分销商名称必填salesDate字符型32销货日期，格式为yyyy-MM-dd必填salesDetailsproductName字符型256产品名称必填barCode字符型256条码必填batch字符型64批次必填salesNum数字型16销售数量必填producedDate字符型32生产日期，格式为yyyy-MM-dd必填unit字符型64单位必填(2) XML格式 福建老酒 6926032336334 20161128 50 2016-11-3

20、0 瓶 福建老酒 6926032336334 20161129 50 2016-11-30 瓶 企业名称 2016-11-30(3) JSON格式salesDetails:unit:瓶,salesNum:1000,batch:201611312,barCode:6926032336334,producedDate:2016-11-28,productName:福建老酒,salesDate:2016-11-28,distributorName:企业名称注:各字段意思参见xml, salesDetails为数组,salesDetails为一个销售单号单号下的对应的销售详细信息，销售单号由系统自动生

21、成。. 食品生产不合格产品处理台账(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型64批次必填producedDate字符型32生产日期必填unit字符型32单位必填unqualifiedNum字符型16不合格数量必填handleType字符型1处理类型，参照数据字典1.4.1必填(2) XML格式 达利园小面包 Y160928090006 20161008 2016-10-10 千克 1 2(3) JSON格式unit:单位,unqualifiedNum:1,batch:2

22、0161008,barCode:Y160928090006,producedDate:2016-10-10,productName:达利园小面包,handleType:3注:各字段意思参见model或xml. 食品生产不合格原料处理台账(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型62批次必填producedDate字符型32生产日期必填unit字符型64单位必填unqualifiedNum字符型16不合格数量必填handleType字符型1处理类型，参照数据字典1.4.1

23、必填(2) XML格式 泰国香米 Y160928090006 20161008 2016-10-10 千克 1 2(3) JSON格式unit:单位,unqualifiedNum:1,batch:20161010,barCode:Y161010150096,producedDate:2016-10-10,productName:达利园小面包,handleType:2注:各字段意思参见model或xml. 食品原料进货台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填supplyEntN

24、ame字符型256原料供货商必填stockDate字符型32进货日期，格式为yyyy-MM-ddbatch字符型64批次必填producedDate字符型32生产日期，格式为yyyy-MM-dd必填unit字符型64单位必填stockNum字符型16生产数量必填(2) XML格式 Y161010150096 大神大神打撒 测试原料供货商0923 100 千克 20161010 2016-10-10 2016-10-10(3) JSON格式unit:千克,stockNum:100,batch:20161010,barCode:Y161010150096,producedDate:2016-10-

25、10,supplyEntName:测试原料供货商0923,stockDate:2016-10-10,productName:大神大神打撒注:各字段意思参见model或xml1.3.2. 食品流通企业. 供货商信息(1) 参数说明参数名参数类型字段长度参数说明是否必填fstEntName字符型256企业名称必填socialCreditUnicode字符型32统一社会信用代码非必填regNo字符型32工商注册号非必填orgNo字符型32组织机构代码非必填dom字符型1024经营场所必填contacts字符型256联系人必填contactsTel字符型256联系电话非必填opScope

26、字符型4000营业范围非必填opStartDate字符型32经营起始时间，格式为yyyy-MM-dd非必填opEndDate字符型32经营终止时间，格式为yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省级行政区划，如：福建省必填cityAdminDivisionValue字符型8市级行政区划，如：福州市必填areaAdminDivisionValue字符型8区县级行政区划，如：鼓楼区非必填nation字符型256国家，企业类型为境外企业时必填非必填fstEntType字符型1企业类型，参照数据字典1.4.8必填belongMarket字符型32主体所属批

27、发市场ID或农贸市场ID根据章节获取非必填(2) XML格式 企业名称 913501007173106xxx 3501xxxxxxxx3 4856913x 福州市保税区xxxxxxxxx 王某某计算机及网络软件的开发与服务 2016-11-11 2021-11-11 福建省 福州市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:9135010071731xxx5L,opScope:计算机及网络软件的开发与服务,dom:福州市保税区xxxxxxxx,provinceAdminDivisionValue:福建省,orgNo:

28、orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTelnation:中国,cityAdminDivisionValue:福州市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35xxxxx000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见model或xml. 经销商信息(1) 参数说明参数名参数类型字段长度

29、参数说明是否必填fstEntName字符型256企业名称必填socialCreditUnicode字符型32统一社会信用代码非必填regNo字符型32工商注册号非必填orgNo字符型32组织机构代码非必填dom字符型1024经营场所必填contacts字符型256联系人必填contactsTel字符型256联系电话非必填opScope字符型4000营业范围非必填opStartDate字符型32经营起始时间，格式为yyyy-MM-dd非必填opEndDate字符型32经营终止时间，格式为yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省级行政区划，如：福建省必填cityAdminDivisionValue字符型8市级行政区划，如：福州市必填areaAdminDivisionValue字符型8区县级行政区划，如：鼓楼区非必填nation字符型256国家，企业类型为境外企业时必填非必填fstEntType字符型1企业类型，参照数据字典1.4.8必填belongMarket字符型32主体所属批发市场ID或农贸市场ID根据章节