福建省“一品一碼”食品安全追溯管理食品生產經(jīng)營企業(yè)數(shù)據(jù)對接接口技術規(guī)范標準
《福建省“一品一碼”食品安全追溯管理食品生產經(jīng)營企業(yè)數(shù)據(jù)對接接口技術規(guī)范標準》由會員分享,可在線閱讀,更多相關《福建省“一品一碼”食品安全追溯管理食品生產經(jīng)營企業(yè)數(shù)據(jù)對接接口技術規(guī)范標準(54頁珍藏版)》請在裝配圖網(wǎng)上搜索。
1、 省“一品一碼”食品安全追溯管理 食品生產經(jīng)營企業(yè)數(shù)據(jù)對接 接口技術規(guī) 省食品藥品監(jiān)督管理局 二〇一八年九月 52 / 54 目錄 1.接口設計1 1.1.接口地址1 1.2.追溯系統(tǒng)數(shù)據(jù)接口1 1.2.1.用戶身份認證接口1 1.2.2.數(shù)據(jù)推送接口2 1.2.3.Catalogid定義2 1.3.接口具體數(shù)據(jù)(info參數(shù))格式3 1.3.1.食品生產企業(yè)3 1.3.2.食品流通企業(yè)17 1.3.3.餐飲(食堂)企業(yè)29 1.3.4.其他42 1.4.數(shù)據(jù)字典44 1.4.1.食品生產不合格處理
2、類型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.企業(yè)類型47 1.4.9.許可證類型47 1.5.接口返回值48 2.須知49 3.系統(tǒng)對接申請流程51 3.1.食品生產經(jīng)營企業(yè)數(shù)據(jù)對接申請流程51 3.2.食品生產經(jīng)營企業(yè)數(shù)據(jù)對接申請表52 1. 接口設計 1.1. 接口地址 系統(tǒng)通過Web Service進行數(shù)據(jù)對接。 數(shù)據(jù)對接測試環(huán)境地址: 110.85.58.153:5004/fdafst/webservi
3、ce/dataReceive?wsdl 數(shù)據(jù)對接正式環(huán)境地址: 120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl 1.2. 追溯系統(tǒng)數(shù)據(jù)接口 追溯系統(tǒng)數(shù)據(jù)接口實現(xiàn)企業(yè)自建追溯系統(tǒng)與省食品追溯系統(tǒng)對接,實現(xiàn)系統(tǒng)間的追溯數(shù)據(jù)對接。 1.2.1. 用戶身份認證接口 調用方對接追溯系統(tǒng)前,需先進行身份認證。通過本接口認證成功后,將返回一個身份認證碼,該身份認證碼做為后續(xù)數(shù)據(jù)接口的認證參數(shù)。身份認證碼有效期30分鐘,身份認證碼過期后需要重新請求獲取。 (1) 接口說明 原型接口 public String getVerifyCo
4、de(string userAccount, string password) 功能描述 業(yè)務系統(tǒng)的身份認證功能 返回值 認證成功,返回身份認證碼,認證失敗,返回具體錯誤信息,詳情見1.5 (2) 參數(shù)說明 參數(shù)名 參數(shù)說明 是否必填 userAccount 用戶名(追溯系統(tǒng)的登錄賬號) 必填 password 密碼(登錄賬號對應的密碼) 必填 1.2.2. 數(shù)據(jù)推送接口 追溯系統(tǒng)所有的備案數(shù)據(jù)、臺賬數(shù)據(jù)的推送統(tǒng)一通過本接口進行對接。接口說明如下: (1) 接口說明 原型接口 public String pushData(String info, Stri
5、ng 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 目錄標識,為每個對接事項分配一個唯一標識,詳見1.2.3 必填 format 接口提供兩種數(shù)據(jù)類型的接收方式,xml和json格式。 必填 verifyCode 身份認證碼,通過getVerify
6、Code()接口獲取,詳見1.2.1 必填 fileName 附件名稱數(shù)組 根據(jù)接口情況 fileContent 附件容 根據(jù)接口情況 1.2.3. Catalogid定義 類別 catalogid 事項名稱 食品生產企業(yè) 15 原料供貨商信息 16 銷售對象信息 11 原料信息 12 產品信息 01 食品生產臺賬信息 02 食品生產銷貨臺賬信息 03 食品生產不合格產品處理臺賬 04 食品生產不合格原料處理臺賬 05 食品原料進貨臺賬信息 食品流通企業(yè) 17 供貨商信息 18 經(jīng)銷商信息 13 商品信息 06 進貨
7、臺帳信息 07 銷貨臺帳信息 08 退貨臺帳信息 09 商品處理臺帳信息 餐飲(食堂)企業(yè) 17 供貨商信息 18 銷售對象信息 13 商品信息 06 進貨臺帳信息 07 銷貨臺帳信息 08 退貨臺帳信息 10 商品(領用)處理臺帳信息 其他 14 產品質檢報告 19 企業(yè)許可證信息 1.3. 接口具體數(shù)據(jù)(info參數(shù))格式 1.3.1. 食品生產企業(yè) 1.3.1.1. 原料供貨商信息 (1) 參數(shù)說明 參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填 fstEntName 字符型 256 企業(yè)名稱 必填 soc
8、ialCreditUnicode 字符型 32 統(tǒng)一社會信用代碼 非必填 regNo 字符型 32 工商注冊號(號) 非必填 orgNo 字符型 32 組織機構代碼 非必填 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)營終止時間,格式為yy
9、yy-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或農貿市場ID 根據(jù)1.3.4.3
10、章節(jié)獲取
非必填
(2) XML格式
11、市保稅區(qū)########x
12、nDivisionValue>省
13、貿市場ID 非必填,根據(jù)1.3.4.3章節(jié)獲取-->
14、","cityAdminDivisionValue":"市","fstEntType":"1","contacts":"王某某","dataType":"1","opStartDate":"2016-11-11","regNo":"35####x000071233","opEndDate":"2021-11-11","belongMarket":"主體所屬批發(fā)市場ID或農貿市場ID"}
注:各字段意思參見xml格式說明
1.3.1.2. 銷售對象信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
fstEntName
字符型
256
企業(yè)名稱
15、必填
socialCreditUnicode
字符型
32
統(tǒng)一社會信用代碼
非必填
regNo
字符型
32
工商注冊號
非必填
orgNo
字符型
32
組織機構代碼
非必填
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)營終止時間,格 16、式為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或農貿市場ID
根據(jù)1.3 17、.4.3章節(jié)獲取
非必填
(2) XML格式
18、dom>市保稅區(qū)########x
19、AdminDivisionValue>省
20、ID或農貿市場ID 非必填,根據(jù)1.3.4.3章節(jié)獲取-->
21、:"中國","cityAdminDivisionValue":"市","fstEntType":"1","contacts":"王某某","dataType":"1","opStartDate":"2016-11-11","regNo":"35####x000071233","opEndDate":"2021-11-11","belongMarket":"主體所屬批發(fā)市場ID或農貿市場ID"}
注:各字段意思參見xml格式說明
1.3.1.3. 原料信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
barCode
字符型
256
條形碼,不填則由系 22、統(tǒng)自動生成
非必填
packingTypeName
字符型
256
包裝類型,參照數(shù)據(jù)字典1.4.4
必填
productName
字符型
256
原料名稱
必填
sellerIdName
字符型
256
生產者名稱
必填
expiryDateNum
數(shù)字型
8
保質期數(shù)值
必填
expiryDateUnit
字符型
128
保質期單位
必填
netContent
數(shù)字型
8
凈含量數(shù)值
非必填
netContentUnit
字符型
64
凈含量單位
非必填
materialCategoryName
字符型
32
23、原料類型,參照數(shù)據(jù)字典1.4.5
必填
minSalesUnit
字符型
64
包裝形式,如箱,件,包等
必填
(2) XML格式
24、
25、ryName>原料
26、uctName":"webservice接口原料測試"}
注:各字段意思參見xml格式說明
1.3.1.4. 產品信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
barCode
字符型
256
條形碼,不填則由系統(tǒng)自動生成
非必填
productName
字符型
256
產品名稱
必填
expiryDateNum
數(shù)字型
8
保質期數(shù)值
必填
expiryDateUnit
字符型
64
保質期單位
必填
specification
字符型
64
規(guī)格
必填
packagingNum
字符型
32
27、含最小銷售單元數(shù)量
非必填
packagingUnit
字符型
64
包裝計量單位
非必填
minSalesUnit
字符型
64
最小銷售單元,如箱,件,包等
必填
productCategoryName
字符型
256
商品類別,參照數(shù)據(jù)字典1.4.7
必填
trademark
字符型
256
商標
非必填
(2) XML格式
28、
29、ategoryName>水果制品
30、DateUnit":"年","specification":"規(guī)格","productCategoryName":"水果制品","barCode":"Y2","packagingUnit":"330ml","productName":"webservice接口產品測試"}
注:各字段意思參見xml格式說明
1.3.1.5. 食品生產臺賬信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
productName
字符型
256
商品名稱
必填
barCode
字符型
256
商品條碼
必填
batch
字符型
64
批次
必填
31、producedDate
字符型
32
生產日期
必填
unit
字符型
64
單位
必填
stockNum
字符型
16
生產數(shù)量
必填
(2) XML格式
32、日期 必填-->
33、
distributorName
字符型
256
分銷商名稱
必填
salesDate
字符型
32
銷貨日期,格式為yyyy-MM-dd
必填
salesDetails
productName
字符型
256
產品名稱
必填
barCode
字符型
256
條碼
必填
batch
字符型
64
批次
必填
salesNum
數(shù)字型
16
銷售數(shù)量
必填
producedDate
字符型
32
生產日期,格式為yyyy-MM-dd
必填
unit
字符型
64
單位
必填
(2) XML格式
34、ion="1.0"encoding="utf-8"?>
35、-11-30
36、alesDetails>
37、alesDate":"2016-11-28","distributorName":"企業(yè)名稱"}
注:各字段意思參見xml, salesDetails為數(shù)組,salesDetails為一個銷售單號單號下的對應的銷售詳細信息,銷售單號由系統(tǒng)自動生成。
1.3.1.7. 食品生產不合格產品處理臺賬
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
productName
字符型
256
商品名稱
必填
barCode
字符型
256
商品條碼
必填
batch
字符型
64
批次
必填
producedDate
字符型
32
生 38、產日期
必填
unit
字符型
32
單位
必填
unqualifiedNum
字符型
16
不合格數(shù)量
必填
handleType
字符型
1
處理類型,參照數(shù)據(jù)字典1.4.1
必填
(2) XML格式
39、h>
40、8","barCode":"Y6","producedDate":"2016-10-10","productName":"達利園小面包","handleType":"3"}
注:各字段意思參見model或xml
1.3.1.8. 食品生產不合格原料處理臺賬
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
productName
字符型
256
商品名稱
必填
barCode
字符型
256
商品條碼
必填
batch
字符型
62
批次
必填
producedDate
字符型
32
生產日期
必填
unit
字符型
41、
64
單位
必填
unqualifiedNum
字符型
16
不合格數(shù)量
必填
handleType
字符型
1
處理類型,參照數(shù)據(jù)字典1.4.1
必填
(2) XML格式
43、edDate":"2016-10-10","productName":"達利園小面包","handleType":"2"}
注:各字段意思參見model或xml
1.3.1.9. 食品原料進貨臺賬信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
productName
字符型
256
商品名稱
必填
barCode
字符型
256
商品條碼
必填
supplyEntName
字符型
256
原料供貨商
必填
stockDate
字符型
32
進貨日期,格式為yyyy-MM-dd
batch
字符型
64
批 44、次
必填
producedDate
字符型
32
生產日期,格式為yyyy-MM-dd
必填
unit
字符型
64
單位
必填
stockNum
字符型
16
生產數(shù)量
必填
(2) XML格式
45、3
46、batch":"20161010","barCode":"Y6","producedDate":"2016-10-10","supplyEntName":"測試原料供貨商0923","stockDate":"2016-10-10","productName":"大神大神打撒"}
注:各字段意思參見model或xml
1.3.2. 食品流通企業(yè)
1.3.2.1. 供貨商信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
fstEntName
字符型
256
企業(yè)名稱
必填
socialCreditUnicode
字符型
32
統(tǒng)一社會信用代 47、碼
非必填
regNo
字符型
32
工商注冊號
非必填
orgNo
字符型
32
組織機構代碼
非必填
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
非必填
provinceAdminDivisionV 48、alue
字符型
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或農貿市場ID
根據(jù)1.3.4.3章節(jié)獲取
非必填
(2) XML格式
49、.0"encoding="utf-8"?>
50、contacts>王某某
51、onValue>
52、Market >1
(3) JSON格式
{"socialCreditUnicode":"31##x5L","opScope":"計算機與網(wǎng)絡軟件的開發(fā)與服務","dom":"市保稅區(qū)########","provinceAdminDivisionValue":"省","orgNo":"orgNo11","fstEntName":"企業(yè)名稱111","areaAdminDivisionValue":"鼓樓區(qū)","contactsTel":"","nation":"中國","cityAdminDivisionValue":"市","fstEn 53、tType":"1","contacts":"王某某","dataType":"1","opStartDate":"2016-11-11","regNo":"35####x000071233","opEndDate":"2021-11-11","belongMarket":"主體所屬批發(fā)市場ID或農貿市場ID"}
注:各字段意思參見model或xml
1.3.2.2. 經(jīng)銷商信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
fstEntName
字符型
256
企業(yè)名稱
必填
socialCreditUnicode
字符型
32
統(tǒng)一社會 54、信用代碼
非必填
regNo
字符型
32
工商注冊號
非必填
orgNo
字符型
32
組織機構代碼
非必填
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
非必填
provinceAdminDivisi 55、onValue
字符型
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或農貿市場ID
根據(jù)1.3.4.3章節(jié)獲取
非必填
(2) XML格式
56、="1.0"encoding="utf-8"?>
57、 58、isionValue>
59、ongMarket >1
(3) JSON格式
{"socialCreditUnicode":"31##x5L","opScope":"計算機與網(wǎng)絡軟件的開發(fā)與服務","dom":"市保稅區(qū)########","provinceAdminDivisionValue":"省","orgNo":"orgNo11","fstEntName":"企業(yè)名稱111","areaAdminDivisionValue":"鼓樓區(qū)","contactsTel":"","nation":"中國","cityAdminDivisionValue":"市","fs 60、tEntType":"1","contacts":"王某某","dataType":"1","opStartDate":"2016-11-11","regNo":"35####x000071233","opEndDate":"2021-11-11","belongMarket":"主體所屬批發(fā)市場ID或農貿市場ID"}
注:各字段意思參見xml
1.3.2.3. 商品信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
barCode
字符型
256
條形碼,不填則由系統(tǒng)自動生成
非必填
productName
字符型
256
商品名稱
必 61、填
placeTypeName
字符型
128
商品類型,參照數(shù)據(jù)字典1.4.6
必填
sellerIdName
字符型
256
生產企業(yè)名稱
必填
socialCreditUnicode
字符型
32
生產企業(yè)統(tǒng)一社會信用代碼
非必填
expiryDateNum
數(shù)字型
16
保質期數(shù)值
必填
expiryDateUnit
字符型
64
保質期單位
必填
specification
字符型
64
規(guī)格
必填
minSalesUnit
字符型
32
最小銷售單元,如箱,件,包等
必填
productCategoryName 62、
字符型
64
商品類別,參照數(shù)據(jù)字典1.4.7
必填
trademark
字符型
256
商標
非必填
(2) XML格式
63、—生產者企業(yè)名稱必填-->
64、—最小銷售單元必填-->
65、cation":"規(guī)格","barCode":"63","sellerIdName":"企業(yè)名稱","socialCreditUnicode":"生產企業(yè)統(tǒng)一社會信用代碼","productCategoryName":"水果制品","productName":"webservice接口商品測試"}
注:各字段意思參見xml
1.3.2.4. 進貨臺賬信息
(1) 參數(shù)說明
參數(shù)名
參數(shù)類型
字段長度
參數(shù)說明
是否必填
supplyEntName
字符型
256
供貨商名稱
必填
stockDate
字符型
32
進貨日期,格式為yyyy-MM-d 66、d
必填
stockDetails
productName
字符型
256
產品名稱
必填
barCode
字符型
256
條碼
必填
batch
字符型
64
批次
必填
stockNum
數(shù)字型
16
進貨數(shù)量
必填
producedDate
字符型
32
生產日期,格式為yyyy-MM-dd
必填
socialCreditUnicode
字符型
32
生產企業(yè)統(tǒng)一社會信用代碼
非必填
unit
字符型
32
單位
必填
(2) XML格式
- 溫馨提示:
1: 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
2: 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權益歸上傳用戶所有。
3.本站RAR壓縮包中若帶圖紙,網(wǎng)頁內容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
4. 未經(jīng)權益所有人同意不得將文件中的內容挪作商業(yè)或盈利用途。
5. 裝配圖網(wǎng)僅提供信息存儲空間,僅對用戶上傳內容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內容本身不做任何修改或編輯,并不能對任何下載內容負責。
6. 下載文件中如有侵權或不適當內容,請與我們聯(lián)系,我們立即糾正。
7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 川渝旅游日記成都重慶城市介紹推薦景點美食推薦
- XX國有企業(yè)黨委書記個人述責述廉報告及2025年重點工作計劃
- 世界濕地日濕地的含義及價值
- 20XX年春節(jié)節(jié)后復工安全生產培訓人到場心到崗
- 大唐女子圖鑒唐朝服飾之美器物之美繪畫之美生活之美
- 節(jié)后開工第一課輕松掌握各要點節(jié)后常見的八大危險
- 廈門城市旅游介紹廈門景點介紹廈門美食展示
- 節(jié)后開工第一課復工復產十注意節(jié)后復工十檢查
- 傳統(tǒng)文化百善孝為先孝道培訓
- 深圳城市旅游介紹景點推薦美食探索
- 節(jié)后復工安全生產培訓勿忘安全本心人人講安全個個會應急
- 預防性維修管理
- 常見閥門類型及特點
- 設備預防性維修
- 2.乳化液泵工理論考試試題含答案