搜索
福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范福建省食品药品监督管理局二〇一八年九月食品生产经营企业数据对接接口技术规范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.食品流通处理类型......................................................................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.接口地址系统通过WebService进行数据对接。数据对接测试环境地址：数据对接正式环境地址：追溯系统数据接口追溯系统数据接口实现企业自建追溯系统与福建省食品追溯系统对接，实现系统间的追溯数据对接。1.2.1.用户身份认证接口调用方对接追溯系统前，需先进行身份认证。通过本接口认证成功后，将返回一个身份认证码，该身份认证码做为后续数据接口的认证参数。身份认证码有效期30分钟，身份认证码过期后需要重新请求获取。(1)接口说明(2)参数说明原型接口publicStringgetVerifyCode(stringuserAccount,stringpassword)功能描述业务系统的身份认证功能返回值认证成功，返回身份认证码，认证失败，返回具体错误信息，详情见1.5参数名参数说明是否必填userAccount用户名（追溯系统的登录账号）必填password密码（登录账号对应的密码）必填食品生产经营企业数据对接接口技术规范第2页，共52页1.2.2.数据推送接口追溯系统所有的备案数据、台账数据的推送统一通过本接口进行对接。接口说明如下：(1)接口说明(2)参数说明1.2.3.Catalogid定义类别catalogid事项名称食品生产企业15原料供货商信息16销售对象信息11原料信息12产品信息01食品生产台账信息02食品生产销货台账信息原型接口publicStringpushData(Stringinfo,Stringcatalogid,Stringformat,StringverifyCode,String[]fileName,byte[]fileContent)功能描述用于各企业将台账等数据汇聚到食药监追溯系统中。返回值见1.5参数名参数说明是否必填info要推送的具体数据——必填必填Catalogid目录标识，为每个对接事项分配一个唯一标识，详见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退货台帐信息09商品处理台帐信息餐饮（食堂）企业17供货商信息18销售对象信息13商品信息06进货台帐信息07销货台帐信息08退货台帐信息10商品（领用）处理台帐信息其他14产品质检报告19企业许可证信息1.3.接口具体数据（info参数）格式1.3.1.食品生产企业1.3.1.1.原料供货商信息(1)参数说明参数名参数类型字段长度参数说明是否必填食品生产经营企业数据对接接口技术规范第4页，共52页(2)XML格式?xmlversion=1.0encoding=utf-8?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章节获取非必填食品生产经营企业数据对接接口技术规范第5页，共52页root!—企业名称必填--fstEntName企业名称/fstEntName!—统一社会信用代码非必填--socialCreditUnicode913501007173106xxx/socialCreditUnicode!—工商注册号非必填--regNo3501xxxxxxxx3/regNo!—组织机构代码非必填--orgNo4856913x/orgNo!—地址必填--dom福州市保税区xxxxxxxxx/dom!—联系人必填--contacts王某某/contacts!—联系电话必填--contactsTel13799912312/contactsTel!—经营范围必填--opScope计算机及网络软件的开发与服务/opScope!—经营起始时间非必填--opStartDate2016-11-11/opStartDate!—经营终止时间非必填--opEndDate2021-11-11/opEndDate!—省级行政区划必填--provinceAdminDivisionValue福建省/provinceAdminDivisionValue!