福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范标准

省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规省食品药品监督管理局二一八年九月52 / 54目录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.餐饮处理类型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.食品生产经营企业数据对接申请表521. 接口设计1.1. 接口地址系统通过Web Service进行数据对接。数据对接测试环境地址：110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl数据对接正式环境地址：120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl1.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目录标识，为每个对接事项分配一个唯一标识，详见1.2.3必填format接口提供两种数据类型的接收方式，xml和json格式。必填verifyCode身份认证码，通过getVerifyCode()接口获取，详见1.2.1必填fileName附件名称数组根据接口情况fileContent附件容根据接口情况1.2.3. Catalogid定义类别catalogid事项名称食品生产企业15原料供货商信息16销售对象信息11原料信息12产品信息01食品生产台账信息02食品生产销货台账信息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企业名称必填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必填belongMarket字符型32主体所属批发市场ID或农贸市场ID根据1.3.4.3章节获取非必填(2) XML格式企业名称 3106#x 3501#3 4856913x 市保税区#x 王某某 计算机与网络软件的开发与服务 2016-11-11 2021-11-11 省 市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:计算机与网络软件的开发与服务,dom:市保税区#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTel:,nation:中国,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,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必填belongMarket字符型32主体所属批发市场ID或农贸市场ID根据1.3.4.3章节获取非必填(2) XML格式企业名称 3106#x 3501#3 4856913x 市保税区#x 王某某 计算机与网络软件的开发与服务 2016-11-11 2021-11-11 省 市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:计算机与网络软件的开发与服务,dom:市保税区#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTel:,nation:中国,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,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保质期单位必填netContent数字型8净含量数值非必填netContentUnit字符型64净含量单位非必填materialCategoryName字符型32原料类型，参照数据字典1.4.5必填minSalesUnit字符型64包装形式，如箱，件，包等必填(2) XML格式 Y2预包装 webservice接口原料测试 企业名称 1 年 330 ml 原料 瓶(3) JSON格式packingTypeName:预包装,netContentUnit:ml,expiryDateNum:1,materialCategoryName:原料,minSalesUnit:瓶,expiryDateUnit:年,barCode:Y23,sellerIdName:企业名称,netContent:330,productName:webservice接口原料测试注:各字段意思参见xml格式说明1.3.1.4. 产品信息(1) 参数说明参数名参数类型字段长度参数说明是否必填barCode字符型256条形码，不填则由系统自动生成非必填productName字符型256产品名称必填expiryDateNum数字型8保质期数值必填expiryDateUnit字符型64保质期单位必填specification字符型64规格必填packagingNum字符型32含最小销售单元数量非必填packagingUnit字符型64包装计量单位非必填minSalesUnit字符型64最小销售单元，如箱，件，包等必填productCategoryName字符型256商品类别，参照数据字典1.4.7必填trademark字符型256商标非必填(2) XML格式 Y2 webservice接口产品测试 1 年 规格 个 水果制品 商标牌 330ml 1(3) JSON格式packagingNum:1,expiryDateNum:1,trademark:商标牌,minSalesUnit:个,expiryDateUnit:年,specification:规格,productCategoryName:水果制品,barCode:Y2,packagingUnit:330ml,productName:webservice接口产品测试注:各字段意思参见xml格式说明1.3.1.5. 食品生产台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型64批次必填producedDate字符型32生产日期必填unit字符型64单位必填stockNum字符型16生产数量必填(2) XML格式老酒100箱201611282016-11-2834(3) JSON格式unit:箱,stockNum:100,batch:20161128,barCode:34,producedDate:2016-11-11,productName:老酒 注:各字段意思参见xml格式说明1.3.1.6. 食品生产销货台账信息(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格式 老酒 34 20161128 50 2016-11-30 瓶 老酒 34 20161129 50 2016-11-30 瓶 企业名称 2016-11-30(3) JSON格式salesDetails:unit:瓶,salesNum:1000,batch:201611312,barCode:34,producedDate:2016-11-28,productName:老酒,salesDate:2016-11-28,distributorName:企业名称注:各字段意思参见xml, salesDetails为数组,salesDetails为一个销售单号单号下的对应的销售详细信息，销售单号由系统自动生成。1.3.1.7. 食品生产不合格产品处理台账(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型64批次必填producedDate字符型32生产日期必填unit字符型32单位必填unqualifiedNum字符型16不合格数量必填handleType字符型1处理类型，参照数据字典1.4.1必填(2) XML格式达利园小面包Y6201610082016-10-10千克12(3) JSON格式unit:单位,unqualifiedNum:1,batch:20161008,barCode:Y6,producedDate:2016-10-10,productName:达利园小面包,handleType:3注:各字段意思参见model或xml1.3.1.8. 食品生产不合格原料处理台账(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型62批次必填producedDate字符型32生产日期必填unit字符型64单位必填unqualifiedNum字符型16不合格数量必填handleType字符型1处理类型，参照数据字典1.4.1必填(2) XML格式泰国香米Y6201610082016-10-10千克12(3) JSON格式unit:单位,unqualifiedNum:1,batch:20161010,barCode:Y6,producedDate:2016-10-10,productName:达利园小面包,handleType:2注:各字段意思参见model或xml1.3.1.9. 食品原料进货台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填supplyEntName字符型256原料供货商必填stockDate字符型32进货日期，格式为yyyy-MM-ddbatch字符型64批次必填producedDate字符型32生产日期，格式为yyyy-MM-dd必填unit字符型64单位必填stockNum字符型16生产数量必填(2) XML格式Y6大神大神打撒测试原料供货商0923100千克201610102016-10-102016-10-10(3) JSON格式unit:千克,stockNum:100,batch:20161010,barCode:Y6,producedDate:2016-10-10,supplyEntName:测试原料供货商0923,stockDate:2016-10-10,productName:大神大神打撒注:各字段意思参见model或xml1.3.2. 食品流通企业1.3.2.1. 供货商信息(1) 参数说明参数名参数类型字段长度参数说明是否必填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根据1.3.4.3章节获取非必填(2) XML格式企业名称 3106#x 3501#3 4856913x 市保税区#x 王某某 计算机与网络软件的开发与服务 2016-11-11 2021-11-11 省 市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:计算机与网络软件的开发与服务,dom:市保税区#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTel:,nation:中国,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见model或xml1.3.2.2. 经销商信息(1) 参数说明参数名参数类型字段长度参数说明是否必填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根据1.3.4.3章节获取非必填(2) XML格式企业名称 3106#x 3501#3 4856913x 市保税区#x 王某某 计算机与网络软件的开发与服务 2016-11-11 2021-11-11 省 市 鼓楼区 中国 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:计算机与网络软件的开发与服务,dom:市保税区#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企业名称111,areaAdminDivisionValue:鼓楼区,contactsTel:,nation:中国,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主体所属批发市场ID或农贸市场ID注:各字段意思参见xml1.3.2.3. 商品信息(1) 参数说明参数名参数类型字段长度参数说明是否必填barCode字符型256条形码，不填则由系统自动生成非必填productName字符型256商品名称必填placeTypeName字符型128商品类型，参照数据字典1.4.6必填sellerIdName字符型256生产企业名称必填socialCreditUnicode字符型32生产企业统一社会信用代码非必填expiryDateNum数字型16保质期数值必填expiryDateUnit字符型64保质期单位必填specification字符型64规格必填minSalesUnit字符型32最小销售单元，如箱，件，包等必填productCategoryName字符型64商品类别，参照数据字典1.4.7必填trademark字符型256商标非必填(2) XML格式 63 webservice接口商品测试 省外商品 企业名称 生产企业统一社会信用代码 1 年 规格 个 水果制品 商标牌(3) JSON格式placeTypeName:省外商品,expiryDateNum:1,trademark:商标牌,expiryDateUnit:年,minSalesUnit:个,specification:规格,barCode:63,sellerIdName:企业名称,socialCreditUnicode:生产企业统一社会信用代码,productCategoryName:水果制品,productName:webservice接口商品测试注:各字段意思参见xml1.3.2.4. 进货台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填supplyEntName字符型256供货商名称必填stockDate字符型32进货日期，格式为yyyy-MM-dd必填stockDetailsproductName字符型256产品名称必填barCode字符型256条码必填batch字符型64批次必填stockNum数字型16进货数量必填producedDate字符型32生产日期，格式为yyyy-MM-dd必填socialCreditUnicode字符型32生产企业统一社会信用代码非必填unit字符型32单位必填(2) XML格式企业名称 2016-11-28 老酒/productNa