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

平潭综合实验区行政服务中心综合审批服务平台采购项目福建省“一品一码”食品安全追溯管理食品生产经营企业数据对接接口技术规范福建省食品药品监督管理局二一八年九月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.餐饮处理类型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/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格式<?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必填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.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格式<?xml version="1.0" encoding="utf-8"?><root> <!条码 非必填（不填则由系统自动生成）-> <barCode>Y123442312312</barCode> <!包装类型 必填 参照数据字典表（包装类型）-> <packingTypeName>预包装</packingTypeName> <!原料名称 必填-> <productName>webservice接口原料测试</productName> <!生产者企业名称 必填-> <sellerIdName>企业名称</sellerIdName> <!保质期数值 必填-> <expiryDateNum>1</expiryDateNum> <!保质期单位 必填（只能填年、月、日）-> <expiryDateUnit>年</expiryDateUnit> <!净含量数值 必填-> <netContent>330</netContent> <!净含量单位 必填-> <netContentUnit>ml</netContentUnit> <!原料类型 必填-> <materialCategoryName>原料</materialCategoryName> <!包装形式（单位） 必填-> <minSalesUnit>瓶</minSalesUnit></root>(3) JSON格式"packingTypeName":"预包装","netContentUnit":"ml","expiryDateNum":1,"materialCategoryName":"原料","minSalesUnit":"瓶","expiryDateUnit":"年","barCode":"Y1112333123123","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格式<?xml version="1.0" encoding="utf-8"?><root> <!条码 非必填（不填则由系统自动生成）-> <barCode>Y123442312312</barCode> <!产品名称 必填-> <productName>webservice接口产品测试</productName> <!保质期数值 必填-> <expiryDateNum>1</expiryDateNum> <!保质期单位 必填（只能填年、月、日）-> <expiryDateUnit>年</expiryDateUnit> <!规格 必填-> <specification>规格</specification> <!最小销售单元 必填-> <minSalesUnit>个</minSalesUnit> <!商品类别 必填 参照数据字典表（商品类别）-> <productCategoryName>水果制品</productCategoryName> <!商标 非必填-> <trademark>商标牌</trademark> <!包装计量单位 非必填-> <packagingUnit>330ml</packagingUnit> <!内含最小销售单元数量 非必填-> <packagingNum>1</packagingNum></root>(3) JSON格式"packagingNum":"1","expiryDateNum":1,"trademark":"商标牌","minSalesUnit":"个","expiryDateUnit":"年","specification":"规格","productCategoryName":"水果制品","barCode":"Y123442312312","packagingUnit":"330ml","productName":"webservice接口产品测试"注:各字段意思参见xml格式说明1.3.1.5. 食品生产台账信息(1) 参数说明参数名参数类型字段长度参数说明是否必填productName字符型256商品名称必填barCode字符型256商品条码必填batch字符型64批次必填producedDate字符型32生产日期必填unit字符型64单位必填stockNum字符型16生产数量必填(2) XML格式<?xml version="1.0" encoding="utf-8"?><root><!产品名称 必填-><productName>福建老酒</productName><!生产数量 必填-><stockNum>100</stockNum><!单位 选填-><unit>箱</unit><!批次 必填-><batch>20161128</batch><!生产日期 必填-><producedDate>2016-11-28</producedDate><!商品条码 必填-><barCode>6926032336334</barCode></root>(3) JSON格式"unit":"箱","stockNum":100,"batch":"20161128","barCode":"6926032336334","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格式<?xml version="1.0" encoding="utf-8"?><root> <!-销售详情-> <salesDetails><!产品名称 必填-> <productName>福建老酒</productName> <!产品条码 必填-> <barCode>6926032336334</barCode> <!产品批次 必填-> <batch>20161128</batch> <!-销售数量 必填-> <salesNum>50</salesNum> <!生产日期 必填-> <producedDate>2016-11-30</producedDate> <!单位 必填-> <unit>瓶</unit> </salesDetails> <salesDetails> <productName>福建老酒</productName> <barCode>6926032336334</barCode> <batch>20161129</batch> <salesNum>50</salesNum> <producedDate>2016-11-30</producedDate> <unit>瓶</unit> </salesDetails><!-销售对象企业名称 必填-> <distributorName>企业名称</distributorName> <!销售日期 必填 日期格式为2016-09-22-> <salesDate>2016-11-30</salesDate></root>(3) JSON格式"salesDetails":"unit":"瓶","salesNum":1000,"batch":"201611312","barCode":"6926032336334","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格式<?xml version="1.0" encoding="utf-8"?><root> <!-产品名称 必填-> <productName>达利园小面包</productName> <!-产品条形码 必填-> <barCode>Y160928090006</barCode> <!-产品批次 必填-> <batch>20161008</batch> <!-产品生产日期 必填 日期格式为2016-09-22 -> <producedDate>2016-10-10</producedDate> <!-产品单位 必填-> <unit>千克</unit> <!-不合格数量 必填-> <unqualifiedNum>1</unqualifiedNum> <!处理类型 必填 参照字典表(食品生产不合格处理类型)-> <handleType>2</handleType></root>(3) JSON格式"unit":"单位","unqualifiedNum":1,"batch":"20161008","barCode":"Y160928090006","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格式<?xml version="1.0" encoding="utf-8"?><root> <!-产品名称 必填-> <productName>泰国香米</productName> <!-产品条形码 必填-> <barCode>Y160928090006</barCode> <!-产品批次 必填-> <batch>20161008</batch> <!-产品生产日期 必填 日期格式为2016-09-22-> <producedDate>2016-10-10</producedDate> <!-产品单位 必填-> <unit>千克</unit> <!-不合格数量 必填-> <unqualifiedNum>1</unqualifiedNum><!处理类型 必填 参照字典表(食品生产不合格处理类型)-> <handleType>2</handleType></root>(3) JSON格式"unit":"单位","unqualifiedNum":1,"batch":"20161010","barCode":"Y161010150096","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格式<?xml version="1.0" encoding="utf-8"?><root> <!-产品条形码 必填-> <barCode>Y161010150096</barCode> <!-产品名称 必填-> <productName>大神大神打撒</productName> <!-原料供货商 必填-> <supplyEntName>测试原料供货商0923</supplyEntName> <!-进货数量 必填-> <stockNum>100</stockNum> <!-单位-> <unit>千克</unit> <!-生产批次 必填-> <batch>20161010</batch> <!-生产日期 必填-> <producedDate>2016-10-10</producedDate> <!-进货日期 必填-> <stockDate>2016-10-10</stockDate></root>(3) JSON格式"unit":"千克","stockNum":100,"batch":"20161010","barCode":"Y161010150096","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国家，企业类