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

平潭综合实验区行政服务中心综合审批服务平台采购项目 福建省“一品一码”食品安全追溯管理 食品生产经营企业数据对接 接口技术规范 福建省食品药品监督管理局 二〇一八年九月 II 食品生产经营企业数据对接接口技术规范 目 录 1. 接口设计 1 1.1. 接口地址 1 1.2. 追溯系统数据接口 1 1.2.1. 用户身份认证接口 1 1.2.2. 数据推送接口 2 1.2.3. Catalogid定义 2 1.3. 接口具体数据（info参数）格式 3 1.3.1. 食品生产企业 3 1.3.2. 食品流通企业 17 1.3.3. 餐饮（食堂）企业 29 1.3.4. 其他 42 1.4. 数据字典 44 1.4.1. 食品生产不合格处理类型 44 1.4.2. 食品流通处理类型 45 1.4.3. 餐饮处理类型 45 1.4.4. 包装类型 45 1.4.5. 原料类型 45 1.4.6. 商品类型 46 1.4.7. 商品类别 46 1.4.8. 企业类型 47 1.4.9. 许可证类型 47 1.5. 接口返回值 48 2. 注意事项 49 3. 系统对接申请流程 51 3.1. 食品生产经营企业数据对接申请流程 51 3.2. 食品生产经营企业数据对接申请表 52 I 1. 接口设计 1.1. 接口地址 系统通过Web Service进行数据对接。 数据对接测试环境地址： http://110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl 数据对接正式环境地址： http://120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl 1.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格式 <?xml version="1.0" encoding="utf-8"?> <root> <!—企业名称 必填--> <fstEntName>企业名称</fstEntName> <!—统一社会信用代码 非必填--> <socialCreditUnicode>913501007173106xxx</socialCreditUnicode> <!—工商注册号 非必填--> <regNo>3501xxxxxxxx3</regNo> <!—组织机构代码 非必填--> <orgNo>4856913x</orgNo> <!—地址 必填--> <dom>福州市保税区xxxxxxxxx</dom> <!—联系人 必填--> <contacts>王某某</contacts> <!—联系电话 必填--> <contactsTel>13799912312</contactsTel> <!—经营范围 必填--> <opScope>计算机及网络软件的开发与服务</opScope> <!—经营起始时间 非必填--> <opStartDate>2016-11-11</opStartDate> <!—经营终止时间 非必填--> <opEndDate>2021-11-11</opEndDate> <!—省级行政区划 必填--> <provinceAdminDivisionValue>福建省</provinceAdminDivisionValue> <!—市级行政区划 必填--> <cityAdminDivisionValue>福州市</cityAdminDivisionValue> <!—区县级行政区划 非必填--> <areaAdminDivisionValue>鼓楼区</areaAdminDivisionValue> <!—所属国家 必填--> <nation>中国</nation> <!—企业类型 必填参照数据字典（企业类型）--> <fstEntType>1</fstEntType> <!—主体所属批发市场ID或农贸市场ID 非必填，根据1.3.4.3章节获取 --> < belongMarket >1</ belongMarket > </root> (3) JSON格式 {"socialCreditUnicode":"9135010071731xxx5L","opScope":"计算机及网络软件的开发与服务","dom":"福州市保税区xxxxxxxx","provinceAdminDivisionValue":"福建省","orgNo":"orgNo11","fstEntName":"企业名称111","areaAdminDivisionValue":"鼓楼区","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.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 必填