《福建省一品一碼食品安全追溯管理食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范標準》由會員分享，可在線閱讀，更多相關(guān)《福建省一品一碼食品安全追溯管理食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范標準（54頁珍藏版）》請在裝配圖網(wǎng)上搜索。
1、省“一品一碼”食品安全追溯管理食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)省食品藥品監(jiān)督管理局二一八年九月52 / 54目錄1.接口設(shè)計11.1.接口地址11.2.追溯系統(tǒng)數(shù)據(jù)接口11.2.1.用戶身份認證接口11.2.2.數(shù)據(jù)推送接口21.2.3.Catalogid定義21.3.接口具體數(shù)據(jù)（info參數(shù)）格式31.3.1.食品生產(chǎn)企業(yè)31.3.2.食品流通企業(yè)171.3.3.餐飲（食堂）企業(yè)291.3.4.其他421.4.數(shù)據(jù)字典441.4.1.食品生產(chǎn)不合格處理類型441.4.2.食品流通處理類型451.4.3.餐飲處理類型451.4.4.包裝類型451.4.5.原料類型451.4.6.商品類型4
2、61.4.7.商品類別461.4.8.企業(yè)類型471.4.9.許可證類型471.5.接口返回值482.須知493.系統(tǒng)對接申請流程513.1.食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接申請流程513.2.食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接申請表521. 接口設(shè)計1.1. 接口地址系統(tǒng)通過Web Service進行數(shù)據(jù)對接。數(shù)據(jù)對接測試環(huán)境地址：110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl數(shù)據(jù)對接正式環(huán)境地址：120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl1.2. 追溯系統(tǒng)數(shù)據(jù)接口追溯系統(tǒng)數(shù)據(jù)接口實現(xiàn)企
3、業(yè)自建追溯系統(tǒng)與省食品追溯系統(tǒng)對接，實現(xiàn)系統(tǒng)間的追溯數(shù)據(jù)對接。1.2.1. 用戶身份認證接口調(diào)用方對接追溯系統(tǒng)前，需先進行身份認證。通過本接口認證成功后，將返回一個身份認證碼，該身份認證碼做為后續(xù)數(shù)據(jù)接口的認證參數(shù)。身份認證碼有效期30分鐘，身份認證碼過期后需要重新請求獲取。(1) 接口說明原型接口public String getVerifyCode(string userAccount, string password)功能描述業(yè)務(wù)系統(tǒng)的身份認證功能返回值認證成功，返回身份認證碼，認證失敗，返回具體錯誤信息，詳情見1.5(2) 參數(shù)說明參數(shù)名參數(shù)說明是否必填userAccount用戶名（追
4、溯系統(tǒng)的登錄賬號）必填password密碼（登錄賬號對應(yīng)的密碼）必填1.2.2. 數(shù)據(jù)推送接口追溯系統(tǒng)所有的備案數(shù)據(jù)、臺賬數(shù)據(jù)的推送統(tǒng)一通過本接口進行對接。接口說明如下：(1) 接口說明原型接口public String pushData(String info, String catalogid, String format, String verifyCode ,String fileName, byte fileContent)功能描述用于各企業(yè)將臺賬等數(shù)據(jù)匯聚到食藥監(jiān)追溯系統(tǒng)中。返回值見1.5(2) 參數(shù)說明參數(shù)名參數(shù)說明是否必填info要推送的具體數(shù)據(jù)必填必填Catalogid目錄標
5、識，為每個對接事項分配一個唯一標識，詳見1.2.3必填format接口提供兩種數(shù)據(jù)類型的接收方式，xml和json格式。必填verifyCode身份認證碼，通過getVerifyCode()接口獲取，詳見1.2.1必填fileName附件名稱數(shù)組根據(jù)接口情況fileContent附件容根據(jù)接口情況1.2.3. Catalogid定義類別catalogid事項名稱食品生產(chǎn)企業(yè)15原料供貨商信息16銷售對象信息11原料信息12產(chǎn)品信息01食品生產(chǎn)臺賬信息02食品生產(chǎn)銷貨臺賬信息03食品生產(chǎn)不合格產(chǎn)品處理臺賬04食品生產(chǎn)不合格原料處理臺賬05食品原料進貨臺賬信息食品流通企業(yè)17供貨商信息18經(jīng)銷商信
6、息13商品信息06進貨臺帳信息07銷貨臺帳信息08退貨臺帳信息09商品處理臺帳信息餐飲（食堂）企業(yè)17供貨商信息18銷售對象信息13商品信息06進貨臺帳信息07銷貨臺帳信息08退貨臺帳信息10商品（領(lǐng)用）處理臺帳信息其他14產(chǎn)品質(zhì)檢報告19企業(yè)許可證信息1.3. 接口具體數(shù)據(jù)（info參數(shù)）格式1.3.1. 食品生產(chǎn)企業(yè)1.3.1.1. 原料供貨商信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填fstEntName字符型256企業(yè)名稱必填socialCreditUnicode字符型32統(tǒng)一社會信用代碼非必填regNo字符型32工商注冊號（號）非必填orgNo字符型32組織機構(gòu)代碼非必
7、填dom字符型1024經(jīng)營場所必填contacts字符型256聯(lián)系人必填contactsTel字符型256聯(lián)系非必填opScope字符型4000營業(yè)圍非必填opStartDate字符型64經(jīng)營起始時間，格式為yyyy-MM-dd非必填opEndDate字符型64經(jīng)營終止時間，格式為yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省級行政區(qū)劃，如：省必填cityAdminDivisionValue字符型8市級行政區(qū)劃，如：市必填areaAdminDivisionValue字符型8區(qū)縣級行政區(qū)劃，如：鼓樓區(qū)非必填nation字符型256國家，企業(yè)類型為境外企業(yè)
8、時必填非必填fstEntType字符型1企業(yè)類型，參照數(shù)據(jù)字典1.4.8必填belongMarket字符型32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID根據(jù)1.3.4.3章節(jié)獲取非必填(2) XML格式企業(yè)名稱 3106#x 3501#3 4856913x 市保稅區(qū)#x 王某某 計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù) 2016-11-11 2021-11-11 省 市 鼓樓區(qū) 中國 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù),dom:市保稅區(qū)#,provinceAdminDivisionValue:省,orgNo:orgNo11,
9、fstEntName:企業(yè)名稱111,areaAdminDivisionValue:鼓樓區(qū),contactsTel:,nation:中國,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID注:各字段意思參見xml格式說明1.3.1.2. 銷售對象信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填fstEntName字符型256企
10、業(yè)名稱必填socialCreditUnicode字符型32統(tǒng)一社會信用代碼非必填regNo字符型32工商注冊號非必填orgNo字符型32組織機構(gòu)代碼非必填dom字符型1024經(jīng)營場所必填contacts字符型256聯(lián)系人必填contactsTel字符型256聯(lián)系非必填opScope字符型4000營業(yè)圍非必填opStartDate字符型64經(jīng)營起始時間，格式為yyyy-MM-dd非必填opEndDate字符型64經(jīng)營終止時間，格式為yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省級行政區(qū)劃，如：省必填cityAdminDivisionValue字符型8市級
11、行政區(qū)劃，如：市必填areaAdminDivisionValue字符型8區(qū)縣級行政區(qū)劃，如：鼓樓區(qū)非必填nation字符型256國家，企業(yè)類型為境外企業(yè)時必填非必填fstEntType字符型1企業(yè)類型，參照數(shù)據(jù)字典1.4.8必填belongMarket字符型32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID根據(jù)1.3.4.3章節(jié)獲取非必填(2) XML格式企業(yè)名稱 3106#x 3501#3 4856913x 市保稅區(qū)#x 王某某 計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù) 2016-11-11 2021-11-11 省 市 鼓樓區(qū) 中國 1 1(3) JSON格式socialCreditUnicode:31#x5L,
12、opScope:計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù),dom:市保稅區(qū)#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企業(yè)名稱111,areaAdminDivisionValue:鼓樓區(qū),contactsTel:,nation:中國,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場I
13、D注:各字段意思參見xml格式說明1.3.1.3. 原料信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填barCode字符型256條形碼，不填則由系統(tǒng)自動生成非必填packingTypeName字符型256包裝類型，參照數(shù)據(jù)字典1.4.4必填productName字符型256原料名稱必填sellerIdName字符型256生產(chǎn)者名稱必填expiryDateNum數(shù)字型8保質(zhì)期數(shù)值必填expiryDateUnit字符型128保質(zhì)期單位必填netContent數(shù)字型8凈含量數(shù)值非必填netContentUnit字符型64凈含量單位非必填materialCategoryName字符型32原
14、料類型，參照數(shù)據(jù)字典1.4.5必填minSalesUnit字符型64包裝形式，如箱，件，包等必填(2) XML格式 Y2預包裝 webservice接口原料測試 企業(yè)名稱 1 年 330 ml 原料 瓶(3) JSON格式packingTypeName:預包裝,netContentUnit:ml,expiryDateNum:1,materialCategoryName:原料,minSalesUnit:瓶,expiryDateUnit:年,barCode:Y23,sellerIdName:企業(yè)名稱,netContent:330,productName:webservice接口原料測試注:各字段意
15、思參見xml格式說明1.3.1.4. 產(chǎn)品信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填barCode字符型256條形碼，不填則由系統(tǒng)自動生成非必填productName字符型256產(chǎn)品名稱必填expiryDateNum數(shù)字型8保質(zhì)期數(shù)值必填expiryDateUnit字符型64保質(zhì)期單位必填specification字符型64規(guī)格必填packagingNum字符型32含最小銷售單元數(shù)量非必填packagingUnit字符型64包裝計量單位非必填minSalesUnit字符型64最小銷售單元，如箱，件，包等必填productCategoryName字符型256商品類別，參照數(shù)據(jù)字典
16、1.4.7必填trademark字符型256商標非必填(2) XML格式 Y2 webservice接口產(chǎn)品測試 1 年 規(guī)格 個 水果制品 商標牌 330ml 1(3) JSON格式packagingNum:1,expiryDateNum:1,trademark:商標牌,minSalesUnit:個,expiryDateUnit:年,specification:規(guī)格,productCategoryName:水果制品,barCode:Y2,packagingUnit:330ml,productName:webservice接口產(chǎn)品測試注:各字段意思參見xml格式說明1.3.1.5. 食品生產(chǎn)臺
17、賬信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填productName字符型256商品名稱必填barCode字符型256商品條碼必填batch字符型64批次必填producedDate字符型32生產(chǎn)日期必填unit字符型64單位必填stockNum字符型16生產(chǎn)數(shù)量必填(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. 食品生產(chǎn)
18、銷貨臺賬信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填distributorName字符型256分銷商名稱必填salesDate字符型32銷貨日期，格式為yyyy-MM-dd必填salesDetailsproductName字符型256產(chǎn)品名稱必填barCode字符型256條碼必填batch字符型64批次必填salesNum數(shù)字型16銷售數(shù)量必填producedDate字符型32生產(chǎn)日期，格式為yyyy-MM-dd必填unit字符型64單位必填(2) XML格式 老酒 34 20161128 50 2016-11-30 瓶 老酒 34 20161129 50 2016-11-30
19、瓶 企業(yè)名稱 2016-11-30(3) JSON格式salesDetails:unit:瓶,salesNum:1000,batch:201611312,barCode:34,producedDate:2016-11-28,productName:老酒,salesDate:2016-11-28,distributorName:企業(yè)名稱注:各字段意思參見xml, salesDetails為數(shù)組,salesDetails為一個銷售單號單號下的對應(yīng)的銷售詳細信息，銷售單號由系統(tǒng)自動生成。1.3.1.7. 食品生產(chǎn)不合格產(chǎn)品處理臺賬(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填productN
20、ame字符型256商品名稱必填barCode字符型256商品條碼必填batch字符型64批次必填producedDate字符型32生產(chǎn)日期必填unit字符型32單位必填unqualifiedNum字符型16不合格數(shù)量必填handleType字符型1處理類型，參照數(shù)據(jù)字典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注:各
21、字段意思參見model或xml1.3.1.8. 食品生產(chǎn)不合格原料處理臺賬(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填productName字符型256商品名稱必填barCode字符型256商品條碼必填batch字符型62批次必填producedDate字符型32生產(chǎn)日期必填unit字符型64單位必填unqualifiedNum字符型16不合格數(shù)量必填handleType字符型1處理類型，參照數(shù)據(jù)字典1.4.1必填(2) XML格式泰國香米Y6201610082016-10-10千克12(3) JSON格式unit:單位,unqualifiedNum:1,batch:20161010
22、,barCode:Y6,producedDate:2016-10-10,productName:達利園小面包,handleType:2注:各字段意思參見model或xml1.3.1.9. 食品原料進貨臺賬信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填productName字符型256商品名稱必填barCode字符型256商品條碼必填supplyEntName字符型256原料供貨商必填stockDate字符型32進貨日期，格式為yyyy-MM-ddbatch字符型64批次必填producedDate字符型32生產(chǎn)日期，格式為yyyy-MM-dd必填unit字符型64單位必填stock
23、Num字符型16生產(chǎn)數(shù)量必填(2) XML格式Y(jié)6大神大神打撒測試原料供貨商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. 食品流通企業(yè)1.3.2.1. 供貨商信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填fstEntN
24、ame字符型256企業(yè)名稱必填socialCreditUnicode字符型32統(tǒng)一社會信用代碼非必填regNo字符型32工商注冊號非必填orgNo字符型32組織機構(gòu)代碼非必填dom字符型1024經(jīng)營場所必填contacts字符型256聯(lián)系人必填contactsTel字符型256聯(lián)系非必填opScope字符型4000營業(yè)圍非必填opStartDate字符型32經(jīng)營起始時間，格式為yyyy-MM-dd非必填opEndDate字符型32經(jīng)營終止時間，格式為yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省級行政區(qū)劃，如：省必填cityAdminDivisionV
25、alue字符型8市級行政區(qū)劃，如：市必填areaAdminDivisionValue字符型8區(qū)縣級行政區(qū)劃，如：鼓樓區(qū)非必填nation字符型256國家，企業(yè)類型為境外企業(yè)時必填非必填fstEntType字符型1企業(yè)類型，參照數(shù)據(jù)字典1.4.8必填belongMarket字符型32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID根據(jù)1.3.4.3章節(jié)獲取非必填(2) XML格式企業(yè)名稱 3106#x 3501#3 4856913x 市保稅區(qū)#x 王某某 計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù) 2016-11-11 2021-11-11 省 市 鼓樓區(qū) 中國 1 1(3) JSON格式socialCreditUnico
26、de:31#x5L,opScope:計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù),dom:市保稅區(qū)#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企業(yè)名稱111,areaAdminDivisionValue:鼓樓區(qū),contactsTel:,nation:中國,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStartDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主體所屬批發(fā)
27、市場ID或農(nóng)貿(mào)市場ID注:各字段意思參見model或xml1.3.2.2. 經(jīng)銷商信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填fstEntName字符型256企業(yè)名稱必填socialCreditUnicode字符型32統(tǒng)一社會信用代碼非必填regNo字符型32工商注冊號非必填orgNo字符型32組織機構(gòu)代碼非必填dom字符型1024經(jīng)營場所必填contacts字符型256聯(lián)系人必填contactsTel字符型256聯(lián)系非必填opScope字符型4000營業(yè)圍非必填opStartDate字符型32經(jīng)營起始時間，格式為yyyy-MM-dd非必填opEndDate字符型32經(jīng)營終止時間
28、，格式為yyyy-MM-dd非必填provinceAdminDivisionValue字符型8省級行政區(qū)劃，如：省必填cityAdminDivisionValue字符型8市級行政區(qū)劃，如：市必填areaAdminDivisionValue字符型8區(qū)縣級行政區(qū)劃，如：鼓樓區(qū)非必填nation字符型256國家，企業(yè)類型為境外企業(yè)時必填非必填fstEntType字符型1企業(yè)類型，參照數(shù)據(jù)字典1.4.8必填belongMarket字符型32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID根據(jù)1.3.4.3章節(jié)獲取非必填(2) XML格式企業(yè)名稱 3106#x 3501#3 4856913x 市保稅區(qū)#x 王某某 計
29、算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù) 2016-11-11 2021-11-11 省 市 鼓樓區(qū) 中國 1 1(3) JSON格式socialCreditUnicode:31#x5L,opScope:計算機與網(wǎng)絡(luò)軟件的開發(fā)與服務(wù),dom:市保稅區(qū)#,provinceAdminDivisionValue:省,orgNo:orgNo11,fstEntName:企業(yè)名稱111,areaAdminDivisionValue:鼓樓區(qū),contactsTel:,nation:中國,cityAdminDivisionValue:市,fstEntType:1,contacts:王某某,dataType:1,opStar
30、tDate:2016-11-11,regNo:35#x000071233,opEndDate:2021-11-11,belongMarket:主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID注:各字段意思參見xml1.3.2.3. 商品信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填barCode字符型256條形碼，不填則由系統(tǒng)自動生成非必填productName字符型256商品名稱必填placeTypeName字符型128商品類型，參照數(shù)據(jù)字典1.4.6必填sellerIdName字符型256生產(chǎn)企業(yè)名稱必填socialCreditUnicode字符型32生產(chǎn)企業(yè)統(tǒng)一社會信用代碼非必填expir
31、yDateNum數(shù)字型16保質(zhì)期數(shù)值必填expiryDateUnit字符型64保質(zhì)期單位必填specification字符型64規(guī)格必填minSalesUnit字符型32最小銷售單元，如箱，件，包等必填productCategoryName字符型64商品類別，參照數(shù)據(jù)字典1.4.7必填trademark字符型256商標非必填(2) XML格式 63 webservice接口商品測試 省外商品 企業(yè)名稱 生產(chǎn)企業(yè)統(tǒng)一社會信用代碼 1 年 規(guī)格 個 水果制品 商標牌(3) JSON格式placeTypeName:省外商品,expiryDateNum:1,trademark:商標牌,expiryDa
32、teUnit:年,minSalesUnit:個,specification:規(guī)格,barCode:63,sellerIdName:企業(yè)名稱,socialCreditUnicode:生產(chǎn)企業(yè)統(tǒng)一社會信用代碼,productCategoryName:水果制品,productName:webservice接口商品測試注:各字段意思參見xml1.3.2.4. 進貨臺賬信息(1) 參數(shù)說明參數(shù)名參數(shù)類型字段長度參數(shù)說明是否必填supplyEntName字符型256供貨商名稱必填stockDate字符型32進貨日期，格式為yyyy-MM-dd必填stockDetailsproductName字符型256產(chǎn)品名稱必填barCode字符型256條碼必填batch字符型64批次必填stockNum數(shù)字型16進貨數(shù)量必填producedDate字符型32生產(chǎn)日期，格式為yyyy-MM-dd必填socialCreditUnicode字符型32生產(chǎn)企業(yè)統(tǒng)一社會信用代碼非必填unit字符型32單位必填(2) XML格式企業(yè)名稱 2016-11-28 老酒/productNa
福建省一品一碼食品安全追溯管理食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范標準
