福建省一品一碼食品安全
《福建省一品一碼食品安全》由會員分享,可在線閱讀,更多相關《福建省一品一碼食品安全(73頁珍藏版)》請在裝配圖網上搜索。
1、 福建省“一品一碼”食品安全 信息追溯管理平臺項目 批發(fā)市場數據交換共享服務標準 福建省食品藥品監(jiān)督管理局 批發(fā)市場數據交換共享服務標準 文件更改摘要 日期 版本號 修訂說明 修訂人 審核人 批準人 18.3.22 V 1.0 創(chuàng)建全文 18.4.7 V 1.1 增加食品交易單據、內部小包裝配置表、檢驗報告類型3個問題 18.4.26 V 1.2 調整了專用術語、增加了基礎代碼類型 18.5.18 V 1.3 進貨單據表增加“關聯銷貨單據”字段;銷售單據表增加
2、“關聯進貨單據號”字段;將入境貨物檢驗檢疫證明從檢驗檢測中獨立;調整訂餐主體代碼的字段長度;統(tǒng)一修改登記主體代碼regEntId為regEntUnicode;修改合格方式CA015為CA014;修改接口ID 為21W03的節(jié)點entInfo為entLicense;調整產地證明編號字段為inspectionNo,產地證明名稱字段為inspectionName、產地證明文件字段為inspectionReport; 18.5.20 V 1.4 增加餐飲加工數據寫入接口(32W03);修改接口12W02節(jié)點為fpProduct;修訂“食品基礎信息”的“小包裝明細”、餐飲進貨臺賬、餐
3、飲銷貨臺賬的節(jié)點名稱 18.5.26 V 1.5 接口22W01增加關聯銷貨單據字段;修改接口22W01節(jié)點fcEntryFJBill為fcStockBill;修改錯誤的文字說明;增加第5.2.2章節(jié)、第7章節(jié)數據刪除接口規(guī)范;修訂第6章,增加數據修改說明;修改所屬行業(yè)的字段備注 18.6.15 V 1.6 修改保質期字段備注;修改食品基礎信息,預包裝食品類型,產地可以為空;食用農產品類型,產地非空;企業(yè)信息,證件類型、證件號碼可以為空;檢驗檢測信息,檢測報告編號可以為空;產地證明,產地證明編號可以為空;增加第5.2.3章節(jié)、第8章節(jié),查詢接口
4、 18.6.19 V 1.7 檢驗檢測報告新增檢測有效期至字段;修改訂餐主體信息中的訂餐人姓名、訂餐人聯系方式、地址的字段名稱 18.8.13 V 1.8 主體信息、銷貨臺賬、餐飲類型的食品基礎數據格式,增加許可證號,餐飲類型主體,主體代碼、許可證號只要一個不為空即可;修改經營范圍字段長度為4000 18.9.3 V 1.9 增加6.1.2.4、6.2.2.4、6.3.2.4章節(jié),食品處理臺賬數據交換標準 18.9.21 V 1.10 主體數據格式增加“所屬市場ID”字段;增加8.1.3章節(jié)
5、 II 批發(fā)市場數據交換共享服務標準 目 錄 I 批發(fā)市場數據交換共享服務標準 1. 范圍 1 2. 規(guī)范性引用文件 1 3. 術語和定義 1 4. 縮略語 3 5. 接口調用規(guī)范 3 5.1 身份驗證接口 3 5.2 接口調用說明 4 5.2.1 數據接入接口定義 4 5.2.2 數據刪除接口定義 5 5.2.3 數據查詢接口定義 6 5.3 返回數據格式 6 5.3.1 XML格式 6
6、 5.3.2 JSON格式 7 5.3.3 標識碼定義 7 6. 數據寫入更新標準規(guī)范 8 6.1 生產型主體 8 6.1.1 基礎數據 8 6.1.2 臺賬數據 14 6.1.3 上市憑證 18 6.2 流通型主體 21 6.2.1 基礎數據 21 6.2.2 臺賬數據 26 6.2.3 上市憑證 31 6.3 餐飲服務者 34 6.3.1 基礎數據 34 6.3.2 臺賬數據 39 6.3.3 上市憑證 43 7. 數據刪除標準規(guī)范 46 7.1 生產型主體 46 7.1.1 基礎數據 46 7.1.2 臺賬數據 48 7.1.3 上市憑證 49 7
7、.2 流通型主體 50 7.2.1 基礎數據 50 7.2.2 臺賬數據 52 7.2.3 上市憑證 53 7.3 餐飲服務者 54 7.3.1 基礎數據 54 7.3.2 臺賬數據 56 7.3.3 上市憑證 57 8. 數據查詢接口規(guī)范 58 8.1 基礎數據 58 8.1.1 生產經營主體信息查詢 58 8.1.2 食品基礎信息查詢 59 8.1.3 市場信息查詢 61 8.2 交易數據 62 8.2.1 食品交易單據 62 9. 單據碼編碼規(guī)則 63 9.1 省直單位建設追溯系統(tǒng)單據碼 63 9.2 各地市建設追溯系統(tǒng)單據碼 64 9.3 企業(yè)建設追
8、溯系統(tǒng)單據碼 64 10. 注意事項 64 II 批發(fā)市場數據交換共享服務標準 1. 范圍 本標準規(guī)定了福建省“一品一碼”食品安全信息追溯管理平臺(以下簡稱“一品一碼”追溯管理平臺)與省內批發(fā)市場自建追溯系統(tǒng)數據交換的技術架構、接口規(guī)范、交換過程、數據交換規(guī)范等。 本標準適用于省內批發(fā)市場與“一品一碼”追溯管理平臺數據共享與數據交換服務。 2. 規(guī)范性引用文件 下列文件中的條款通過本標準的引用而成為本標準的條段.凡是注日期的引用文件。其隨后所有的修改單(不包括勘誤的內容)或修訂版均不適用于本標準。然而,鼓勵根據本標準達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日
9、期的引用文件,其最新版本適用于本標準。 GB/T 7408-2005 數據元和交換格式 信息交換 日期和時間表示法 GB/T 18391.1-2002 信息技術 數據元的規(guī)范與標準 第一部分:數據元的規(guī)范與標準化框架 GB/T 21062.1-2007 政務信息資源交換體系 第1部分:總體框架 GB/T 21062.2-2007 政務信息資源交換體系 第2部分:技術要求 GB/T 20162.2-2007 政務信息資源交換體系 第3部分:數據接口規(guī)范 3. 術語和定義 下列術語和定義適用于本標準。 (1) 福建省“一品一碼”食品安全信息追溯管理平臺 福建省建立統(tǒng)一的福建省
10、食品安全信息追溯管理平臺,匯集相關行政主管部門追溯系統(tǒng)信息,通過編碼識別、身份信息比對等技術手段和驗證管理實現追溯食品和生產經營者等信息的共享。 (2) 一品一碼 一品一碼指同一品種批次的食品和食用農產品按照規(guī)定的追溯編碼規(guī)則,賦予唯一的識別追溯碼。 (3) 生產經營主體 從事食品生產經營活動的政府、組織、單位、法人和自然人等具備食品追溯能力的單位和自然人。 (4) 主體代碼 法人采用統(tǒng)一社會信用代碼,由一組長度為18位的用于法人和其他組織身份識別的代碼。統(tǒng)一社會信用代碼由國家標準委發(fā)布。國家標準委發(fā)布了強制性國家標準《法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則》。 針對自然人采用散
11、戶代碼或身份證號碼。 (5) 生產經營許可 生產經營許可證是許可證的一個類別之一,是縣級以上食品藥品監(jiān)管部門對食品生產與經營者頒發(fā)的允許進行食品生產經營的法定證件。 (6) 食用農產品 指在農業(yè)活動中直接獲得的,以及經過分揀、去皮、剝殼、干燥、粉碎、清洗、切割、冷凍、打蠟、分級、包裝等加工,但未改變其基本自然性狀和化學性質的、供人食用的植物、動物、微生物及其產品。 (7) 預包裝食品 指預先定量包裝或者制作在包裝材料和容器中的食品;包括預先定量包裝以及預先定量制作在包裝材質和容器中并且在一定量限范圍內具有統(tǒng)一的質量或體積標識的食品。簡單說,就是指在包裝完成后即具有確定的量值,這一確
12、定的量值應是在一定量限范圍內具有統(tǒng)一的質量或體積標識。 (8) 入境食品 指從其他國家和地區(qū)進口的食品。 (9) 入閩食品 指中國國內,福建省外的食品,通俗的講就是其他省份和地區(qū)食品,包含在其他省份和地區(qū)生產并在福建省內分包裝的食品。 (10) 食品代碼 預包裝食品的代碼,由企業(yè)向中國物品編碼中心申請,進行自主食品編碼,并在中國物品編碼中心備案;散裝食品的代碼,由各廳局負責源頭賦碼。 (11) 食品追溯碼 指福建省質量技術監(jiān)督局研究出臺的福建省地方標準《食品質量安全追溯碼編碼技術規(guī)范》(DB35/T 1711-2017)規(guī)定的食品追溯碼。 (12) 數據提供方 福建省“一品
13、一碼”食品安全信息追溯管理平臺。 (13) 用戶 與福建省“一品一碼”食品安全信息追溯管理平臺進行數據共享與交換的全省生產經營主體自建追溯管理平臺。 (14) 數據項 共享數據實體。 (15) 數據集 組成共享數據實體的集合。 (16) 數據版本號 共享數據在更新序列上的唯一標識。 4. 縮略語 XML -- 可擴展標識語言(eXtensible Markup Language) SOAP -- 簡單對象訪問協(xié)議(Simple Object Access Protocol ) UDDI -- 統(tǒng)一描述、發(fā)現和集成( Universal Description,Disc
14、overy , and Integration) 5. 接口調用規(guī)范 5.1 身份驗證接口 通過“一品一碼”食品安全信息追溯管理平臺調用各類接口時,必須先對調用方的用戶身份及權限進行驗證,本接口負責用戶身份認證和權限驗證功能。應用程序調用本接口進行身份認證和權限驗證,通過后將獲取身份校驗碼,用戶通過該身份校驗碼才能訪問其他接口。校驗碼的有效時間為30分鐘。 (1) 原型接口 public String getVerifyCode(String userAccount, String password,String dataType) (2) 參數說明 參數名 說明 是否必填
15、 dataType 返回的數據格式 否(0表示XML,1表示JSON;默認為XML) userAccount 用戶名(“一品一碼”食品安全信息追溯管理平臺登錄賬號) 是 password 密碼(登錄賬號對應的密碼) 是 (3) 返回說明 驗證成功返回成功標識及身份校驗碼;錯誤則返回錯誤標識及錯誤信息。 5.2 接口調用說明 平臺提供接口用于生產經營主體數據寫入,接口定義如下說明。 5.2.1 數據接入接口定義 (1) 原型接口 public String writeObjectOut (String verifyCode, String jkId, String
16、 dataType, String writeXmlDoc,String[] fileNames,byte[][] fileContents); (2) 參數說明 序號 參數名 說明 是否必填 備注 1 verifyCode 身份校驗碼 是 2 jkId 接口ID 是 各接口所對應的ID編號,詳見各接口說明 3 dataType 返回的數據格式 否 返回的數據類型,0表示XML,1表示JSON;默認為XML 4 writeXmlDoc 寫入數據 是 業(yè)務數據寫入XML格式文檔,附件數據通過以下附件字段進行上傳。 5 fileNames
17、
附件名稱數組
否
附件名+類型,如2012012.xls
6
fileContents
附件數據數組
否
附件內容,byte字節(jié)
(3) WriteXmlDoc參數示例
18、nicode>URLEncoder.encode("主體代碼", "UTF-8") entUnicode >
…….
19、d, String dataType, String deleteXmlDoc); (2) 參數說明 序號 參數名 說明 是否必填 備注 1 verifyCode 身份校驗碼 是 2 jkId 接口ID 是 各接口所對應的ID編號,詳見各接口說明 3 dataType 返回的數據格式 否 返回的數據類型,0表示XML,1表示JSON;默認為XML 4 deleteXmlDoc 寫入數據 是 業(yè)務數據寫入XML格式文檔,附件數據通過以下附件字段進行上傳。 (3) DeleteXmlDoc參數示例
20、encoding="utf-8"?>
21、ype,
String queryXmlDoc);
(2) 參數說明
序號
參數名
說明
是否必填
備注
1
verifyCode
身份校驗碼
是
2
jkId
接口ID
是
各接口所對應的ID編號,詳見各接口說明
3
dataType
返回的數據格式
否
返回的數據類型,0表示XML,1表示JSON;默認為XML
4
queryXmlDoc
寫入數據
是
查詢字段寫入XML格式文檔。
(3) QueryXmlDoc參數示例
22、-->
23、coding="utf-8"?>
24、1
邏輯業(yè)務出錯
02
參數信息不能為空!
07
賬號或密碼錯誤!
10
xml格式解析異常
14
身份認證碼超時
6. 數據寫入更新標準規(guī)范
6.1 生產型主體
6.1.1 基礎數據
6.1.1.1 原料供貨商信息
(1) 接口ID :11W01
(2) 節(jié)點名稱:entInfo
(3) 接口說明:用于寫入、更新生產主體的原料供貨商數據。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
原料供貨商類型
entType
1
非空。CA001
2
原料供貨 25、商名稱
entName
300
非空
3
原料供貨商代碼
entUnicode
18
“生產經營類別”為“餐飲服務者”時。主體代碼與食品經營許可證號/餐飲許可證號必須有一個不為空。
企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼。
“餐飲服務者”可填寫食品經營許可證號或餐飲許可證號(舊證)
4
食品經營許可證號/餐飲許可證號
orgNo
32
5
經營場所
busiPlace
300
原料供貨商類型為企事業(yè)單位、自然人時,非空
6
經營范圍
busiScope
4000
7
經營起始時間
busiStartDa 26、te
14
格式y(tǒng)yyyMMdd
8
經營終止時間
busiEndDate
14
格式y(tǒng)yyyMMdd
9
生產經營類別
entCategory
1
原料供貨商類型為企事業(yè)單位、自然人時,非空。CA002
10
所屬行業(yè)
industry
128
原料供貨商類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003
11
證照圖片
licPic
以附件方式上傳,文件大小不超過5M。
12
法定代表人
legal
64
原料供貨商類型為企事業(yè)單位時,非空
13
證件類型
legalLicType
2
14
證件號 27、碼
legalLicNo
18
15
負責人姓名
principalName
64
原料供貨商類型為企事業(yè)單位、境外企業(yè)時,非空
16
負責人手機
principalMobile
32
17
負責人固定電話
principalTel
32
18
負責人傳真號碼
principalFax
32
19
負責人證件號碼
principalLicNo
18
20
負責人郵箱
principalEmail
64
21
所屬國家
nation
8
非空。GB/T 2659
22
所屬省行政區(qū)劃
provi 28、nceAdminDivision
8
原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T2260
23
所屬市行政區(qū)劃
cityAdminDivision
8
原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T2260
24
所屬區(qū)縣行政區(qū)劃
areaAdminDivision
8
原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T2260
25
所屬市場ID
belongMarket
32
主體所屬批發(fā)市場ID或農貿市場ID
市場ID根據8.1.3章節(jié)獲取
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數 29、據格式】定義說明。
6.1.1.2 銷貨主體信息
(1) 接口ID :11W02
(2) 節(jié)點名稱:entInfo
(3) 接口說明:用于寫入、更新生產主體的銷貨主體數據。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
銷貨主體類型
entType
1
非空。CA001
2
銷貨主體名稱
entName
300
非空
3
銷貨主體代碼
entUnicode
18
“生產經營類別”為“餐飲服務者”時。主體代碼與食品經營許可證號/餐飲許可證號必須有一個不為空。
30、企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼。
“餐飲服務者”可填寫食品經營許可證號或餐飲許可證號(舊證)
4
食品經營許可證號/餐飲許可證號
orgNo
32
5
經營場所
busiPlace
300
銷貨主體類型為企事業(yè)單位、自然人時,非空
6
經營范圍
busiScope
4000
7
經營起始時間
busiStartDate
14
格式y(tǒng)yyyMMdd
8
經營終止時間
busiEndDate
14
格式y(tǒng)yyyMMdd
9
生產經營類別
entCategory
1
銷貨主體類型為企事業(yè)單位、自 31、然人時,非空。CA002
10
所屬行業(yè)
industry
128
銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003
11
證照圖片
licPic
以附件方式上傳,文件大小不超過5M。
12
法定代表人
legal
64
銷貨主體類型為企事業(yè)單位時,非空
13
證件類型
legalLicType
2
14
證件號碼
legalLicNo
18
15
負責人姓名
principalName
64
銷貨主體類型為企事業(yè)單位、境外企業(yè)時,非空
16
負責人手機
principalMobile
32 32、
17
負責人固定電話
principalTel
32
18
負責人傳真號碼
principalFax
32
19
負責人證件號碼
principalLicNo
18
20
負責人郵箱
principalEmail
64
21
所屬國家
nation
8
非空。GB/T 2659
22
所屬省行政區(qū)劃
provinceAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
23
所屬市行政區(qū)劃
cityAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時, 33、非空。GB T2260
24
所屬區(qū)縣行政區(qū)劃
areaAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
25
所屬市場ID
belongMarket
32
主體所屬批發(fā)市場ID或農貿市場ID
市場ID根據8.1.3章節(jié)獲取
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.1.3 生產經營許可
(1) 接口ID :11W03
(2) 節(jié)點名稱:entLicense
(3) 接口說明:用于原料供貨商、銷貨主體的生產經營許可證寫入、更新。同一主鍵數據, 34、重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
主體名稱
entName
300
非空。關聯生產經營主體表主體名稱
2
主體代碼
entUnicode
18
非空。關聯生產經營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼
3
許可證類型
licenseType
1
非空。CA008
4
許可證編號
licenseNo
32
非空。唯一標識
5
發(fā)證日期
licIssueDate
14
非空,格式y(tǒng)yyyMMdd
6
有效期至
li 35、cValidEndDate
14
非空,格式y(tǒng)yyyMMdd
7
許可證圖片
licensePic
非空,以附件方式上傳,文件大小不超過5M。
8
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.1.4 食品基礎信息
(1) 接口ID :11W04
(2) 節(jié)點名稱:foodProduct
(3) 接口說明:用于生產主體進貨原料、生產食品的基礎數據信息寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
36、序號
中文名稱
英文名稱
長度
備注
1
食品代碼
productCode
32
非空。唯一標識
2
食品名稱
productName
256
非空
3
食品類型
productType
1
非空。CA009
4
產地類型
placeType
1
非空。CA005
5
生產主體名稱
entName
300
非空。關聯生產經營主體表主體名稱
6
生產主體代碼
entUnicode
18
非空。關聯生產經營主體表主體代碼
7
商標
trademark
128
8
保質期
expiryDate
32
請輸入數 37、值+單位(年、月、天)格式,例如:180天。
9
食用農產品類別
agrProductCategory
32
食品類型為食用農產品時,必填。CA015
10
預包裝食品類別
productCategory
32
食品類型為預包裝食品時,必填。CA010
11
規(guī)格
specification
64
12
產地
placeOfOrigin
64
預包裝食品類型,可以為空;食用農產品類型,非空
13
原產國
nation
8
產地類型為進口食品時,必填。GB/T 2659
14
計量單位
measurementUnit
64
非空。
38、
15
食品圖片
productPic
以附件方式上傳,文件大小不超過5M。
16
備注
remark
300
17
小包裝明細
xbzmxs
用于記錄大包裝食品內還含有多個小包裝食品的關系數據。如:箱裝牛奶內含多個小盒牛奶、大箱礦泉水內含多個小瓶礦泉水。
內部小包裝明細參數:(節(jié)點xbzmx)
序號
中文名稱
英文名稱
長度
備注
1
小包裝食品代碼
smallProductCode
32
非空。關聯食品基礎信息表的食品代碼
2
小包裝食品數量
containsNum
18
非空
3
小包裝食品計量單位
measur 39、ementUnit
64
非空。
4
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.2 臺賬數據
6.1.2.1 原料進貨單據
(1) 接口ID :12W01
(2) 節(jié)點名稱:fpStockBill
(3) 接口說明:用于原料進貨單據及明細寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
單據號
billNo
50
非空。唯一標識。單據號規(guī)則見第9 40、章節(jié)
2
登記主體名稱
regEntName
300
非空。關聯生產經營主體表主體名稱
3
登記主體代碼
regEntUnicode
18
非空。關聯生產經營主體表主體代碼
4
交易日期
tradeDate
14
非空。格式y(tǒng)yyyMMddHHmmss
5
供貨主體名稱
supplyEntName
300
非空,關聯原料供貨商表的主體名稱
6
供貨主體代碼
supplyEntUnicode
18
非空,關聯原料供貨商表的主體代碼
7
備注
remark
300
8
關聯銷貨單據
refSalesBillNo
50
關聯上游 41、的銷貨單據號
9
進貨單據明細
fpStockDetails
原料進貨單據明細,可傳多條明細,詳細參數如下表:
原料進貨單據明細參數:(節(jié)點fpStockDetail)
序號
中文名稱
英文名稱
長度
備注
1
食品追溯碼
traceCode
64
非空
2
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
3
食品名稱
productName
256
非空,關聯食品基礎信息表的食品名稱
4
批次
batch
32
非空
5
生產日期
productDate
14
非空。格式y(tǒng)yyyMMddHH 42、mmss
6
交易數量
tradeNum
18
非空
7
計量單位
measurementUnit
64
非空。
8
順序號
orderNum
8
9
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.2.2 生產臺賬登記
(1) 接口ID :12W02
(2) 節(jié)點名稱:fpProduct
(3) 接口說明:用于生產主體的生產臺賬登記數據寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
43、序號
中文名稱
英文名稱
長度
備注
1
登記主體名稱
regEntName
300
非空。關聯生產經營主體表主體名稱
2
登記主體代碼
regEntUnicode
18
非空。關聯生產經營主體表主體代碼
3
食品追溯碼
traceCode
64
非空。唯一標識
4
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
5
食品名稱
productName
256
非空,關聯食品基礎信息表的食品名稱
6
批次
batch
32
非空
7
生產日期
productDate
14
非空,格式y(tǒng)yyy 44、MMddHHmmss
8
生產數量
tradeNum
18
非空
9
計量單位
measurementUnit
64
非空。
10
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.2.3 銷售單據登記
(1) 接口ID :12W03
(2) 節(jié)點名稱:fpSalesBill
(3) 接口說明:用于主體的銷售單據及明細寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
45、長度
備注
1
單據號
billNo
50
非空。唯一標識。單據號規(guī)則見第9章節(jié)
2
登記主體名稱
regEntName
300
非空。關聯生產經營主體表主體名稱
3
登記主體代碼
regEntUnicode
18
非空。關聯生產經營主體表主體代碼
4
交易日期
tradeDate
14
非空。格式y(tǒng)yyyMMddHHmmss
5
收貨主體名稱
receiveEntName
300
非空,關聯銷貨主體表的主體名稱
6
收貨主體代碼
receiveEntUnicode
18
必須有一個不為空
7
收貨主體食品經營許可證號/餐飲許可 46、證號
receiveEntOrgNo
32
8
備注
remark
50
非空
9
關聯進貨單據號
refStockBillNo
50
關聯下游的進貨單據號
10
銷售單據明細
fpSalesDetails
銷售單據明細,可傳多條明細,詳細參數如下表:
銷售單據明細參數:(節(jié)點fpSalesDetail)
序號
中文名稱
英文名稱
長度
備注
1
食品追溯碼
traceCode
64
非空
2
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
3
食品名稱
productName
256
非 47、空,關聯食品基礎信息表的食品名稱
4
批次
batch
32
非空
5
生產日期
productDate
14
非空。格式y(tǒng)yyyMMddHHmmss
6
交易數量
tradeNum
18
非空
7
計量單位
measurementUnit
64
非空。
8
順序號
orderNum
8
9
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.2.4 食品處理臺賬
(1) 接口ID :12W04
(2) 節(jié)點名稱:fpFoodH 48、andle
(3) 接口說明:記錄生產主體食品處理的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
處理單據號
billNo
50
非空。唯一標識。單據號規(guī)則見第9章節(jié)
2
登記主體名稱
regEntName
300
非空
3
登記主體代碼
regEntUnicode
18
非空
4
處理對象類型
handleObjType
1
非空。1 - 原料;2 - 產品
5
食品追溯碼
traceCode
64
非空
6
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
7
食 49、品名稱
productName
256
非空,關聯食品基礎信息表的食品名稱
8
批次
batch
32
非空
9
生產日期
productDate
非空。格式y(tǒng)yyyMMddHHmmss
10
處理數量
handleNum
18
非空
11
計量單位
measurementUnit
64
非空
12
處理日期
handleDate
非空
13
處理類型
handleType
1
非空。1 - 退貨;2 - 銷毀;3 - 報廢;4 - 其他; 7 - 零售;8 - 投用;
14
領用人
leadingPerson
10 50、0
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.3 上市憑證
6.1.3.1 檢驗檢測信息
(1) 接口ID :13W01
(2) 節(jié)點名稱:inspectionReport
(3) 接口說明:用于食品檢驗檢測的數據寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
檢驗報告類型
inspectionType
4
非空。CA013
2
檢測報告編號
inspectionNo
32
51、
3
檢測報告名稱
inspectionName
256
4
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
5
食品生產日期
productDate
14
非空,格式y(tǒng)yyyMMddHHmmss
6
批次
batch
32
非空
7
檢測結果
inspectionResult
1
非空。CA007
8
檢測日期
inspectionDate
14
非空,格式y(tǒng)yyyMMdd
9
合格方式
qualifiedStyle
2
CA014
10
檢測報告文件
inspectionRepor 52、t
以附件方式上傳,文件大小不超過5M。
11
檢測機構
inspectionOrg
256
12
檢測人員
inspectionPerson
64
13
檢測有效期至
inspectionValidDate
格式y(tǒng)yyyMMdd
14
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.3.2 產地證明
(1) 接口ID :13W02
(2) 節(jié)點名稱:inspectionReport
(3) 接口說明:用于食品的產地證明數據 53、寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
產地證明編號
inspectionNo
32
2
產地證明名稱
inspectionName
256
3
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
4
食品生產日期
productDate
14
非空,格式y(tǒng)yyyMMddHHmmss
5
批次
batch
32
非空
6
產地
placeOfOrigin
64
非空
7
報告日期
ins 54、pectionDate
8
非空,格式y(tǒng)yyyMMdd
8
產地證明文件
inspectionReport
以附件方式上傳,文件大小不超過5M。
9
檢測有效期至
inspectionValidDate
格式y(tǒng)yyyMMdd
10
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.1.3.3 入境貨物檢驗檢疫證明
(1) 接口ID :13W03
(2) 節(jié)點名稱:inspectionReport
(3) 接口說明:用于入境貨物經驗檢疫證明數據寫入、更 55、新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
檢測報告編號
inspectionNo
32
2
檢測報告名稱
inspectionName
256
3
食品代碼
productCode
32
非空,關聯食品基礎信息表的食品代碼
4
食品生產日期
productDate
非空,格式y(tǒng)yyyMMddHHmmss
5
批次
batch
32
非空
6
證明出具日期
inspectionDate
非空。格式y(tǒng)yyyMMdd
7
入 56、境證明文件
inspectionReport
以附件方式上傳,文件大小不超過5M。
8
證明出具機構
inspectionOrg
256
9
證明出具人員
inspectionPerson
64
10
檢測有效期至
inspectionValidDate
格式y(tǒng)yyyMMdd
11
備注
remark
300
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.2 流通型主體
6.2.1 基礎數據
6.2.1.1 供貨主體信息
(1) 接口ID :21W01
(2 57、) 節(jié)點名稱:entInfo
(3) 接口說明:用于供貨主體的數據寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
供貨主體類型
entType
1
非空。CA001
2
供貨主體名稱
entName
300
非空
3
供貨主體代碼
entUnicode
18
“生產經營類別”為“餐飲服務者”時。主體代碼與食品經營許可證號/餐飲許可證號必須有一個不為空。
企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼。
“餐飲服務者”可填寫食 58、品經營許可證號或餐飲許可證號(舊證)
4
食品經營許可證號/餐飲許可證號
orgNo
32
5
經營場所
busiPlace
300
供貨主體類型為企事業(yè)單位、自然人時,非空
6
經營范圍
busiScope
4000
7
經營起始時間
busiStartDate
14
格式y(tǒng)yyyMMdd
8
經營終止時間
busiEndDate
14
格式y(tǒng)yyyMMdd
9
生產經營類別
entCategory
1
供貨主體類型為企事業(yè)單位、自然人時,非空。CA002
10
所屬行業(yè)
industry
128
供貨主體類型為企事業(yè)單 59、位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003
11
證照圖片
licPic
以附件方式上傳,文件大小不超過5M。
法定代表人
legal
64
供貨主體類型為企事業(yè)單位時,非空
12
13
證件類型
legalLicType
2
14
證件號碼
legalLicNo
18
15
負責人姓名
principalName
64
供貨主體類型為企事業(yè)單位、境外企業(yè)時,非空
16
負責人手機
principalMobile
32
17
負責人固定電話
principalTel
32
1 60、8
負責人傳真號碼
principalFax
32
19
負責人證件號碼
principalLicNo
18
20
負責人郵箱
principalEmail
64
21
所屬國家
nation
8
非空。GB/T 2659
22
所屬省行政區(qū)劃
provinceAdminDivision
8
供貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
23
所屬市行政區(qū)劃
cityAdminDivision
8
供貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
24
所屬區(qū)縣行政區(qū)劃
areaAdminDivi 61、sion
8
供貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
25
所屬市場ID
belongMarket
32
主體所屬批發(fā)市場ID或農貿市場ID
市場ID根據8.1.3章節(jié)獲取
(5) 返回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.2.1.2 銷貨主體信息
(1) 接口ID :21W02
(2) 節(jié)點名稱:entInfo
(3) 接口說明:用于銷貨主體信息數據寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名 62、稱
長度
備注
1
銷貨主體類型
entType
1
非空。CA001
2
銷貨主體名稱
entName
300
非空
3
銷貨主體代碼
entUnicode
18
“生產經營類別”為“餐飲服務者”時。主體代碼與食品經營許可證號/餐飲許可證號必須有一個不為空。
企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼。
“餐飲服務者”可填寫食品經營許可證號或餐飲許可證號(舊證)
4
食品經營許可證號/餐飲許可證號
orgNo
32
5
經營場所
busiPlace
300
銷貨主體類型為企事業(yè)單位、自然人時,非空
6
63、經營范圍
busiScope
4000
7
經營起始時間
busiStartDate
14
格式y(tǒng)yyyMMdd
8
經營終止時間
busiEndDate
14
格式y(tǒng)yyyMMdd
9
生產經營類別
entCategory
1
銷貨主體類型為企事業(yè)單位、自然人時,非空。CA002
10
所屬行業(yè)
industry
128
銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003
11
證照圖片
licPic
以附件方式上傳,文件大小不超過5M。
12
法定代表人
legal
64
銷貨主體類型為企事 64、業(yè)單位時,非空
13
證件類型
legalLicType
2
14
證件號碼
legalLicNo
18
15
負責人姓名
principalName
64
銷貨主體類型為企事業(yè)單位、境外企業(yè)時,非空
16
負責人手機
principalMobile
32
17
負責人固定電話
principalTel
32
18
負責人傳真號碼
principalFax
32
19
負責人證件號碼
principalLicNo
18
20
負責人郵箱
principalEmail
64
21
所屬國家
65、
nation
8
非空。GB/T 2659
22
所屬省行政區(qū)劃
provinceAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
23
所屬市行政區(qū)劃
cityAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
24
所屬區(qū)縣行政區(qū)劃
areaAdminDivision
8
銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260
25
所屬市場ID
belongMarket
32
主體所屬批發(fā)市場ID或農貿市場ID
市場ID根據8.1.3章節(jié)獲取
(5) 返 66、回說明
寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見【返回數據格式】定義說明。
6.2.1.3 生產經營許可
(1) 接口ID :21W03
(2) 節(jié)點名稱:entLicense
(3) 接口說明:用于供貨主體、銷貨主體的生產經營許可證寫入、更新。同一主鍵數據,重復上傳,將更新該記錄數據,只允許更新自己上傳的數據。
(4) 寫入參數:
序號
中文名稱
英文名稱
長度
備注
1
主體名稱
entName
300
非空。關聯生產經營主體表主體名稱
2
主體代碼
entUnicode
18
非空。關聯生產經營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或身份證號碼
3
許可證類型
licenseType
1
非空。CA008
4
許可證編號
licenseNo
32
非空、唯一標識
5
發(fā)證日期
licIssueDate
14
非空,格式y(tǒng)yyyMMdd
6
有效期至
licValidEndDate
14
非空,格式y(tǒng)yyyMMdd
7
許可證圖片
licenseP
- 溫馨提示:
1: 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
2: 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯系上傳者。文件的所有權益歸上傳用戶所有。
3.本站RAR壓縮包中若帶圖紙,網頁內容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
4. 未經權益所有人同意不得將文件中的內容挪作商業(yè)或盈利用途。
5. 裝配圖網僅提供信息存儲空間,僅對用戶上傳內容的表現方式做保護處理,對用戶上傳分享的文檔內容本身不做任何修改或編輯,并不能對任何下載內容負責。
6. 下載文件中如有侵權或不適當內容,請與我們聯系,我們立即糾正。
7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 110中國人民警察節(jié)(筑牢忠誠警魂感受別樣警彩)
- 2025正字當頭廉字入心爭當公安隊伍鐵軍
- XX國企干部警示教育片觀后感筑牢信仰之基堅守廉潔底線
- 2025做擔當時代大任的中國青年PPT青年思想教育微黨課
- 2025新年工作部署會圍繞六個干字提要求
- XX地區(qū)中小學期末考試經驗總結(認真復習輕松應考)
- 支部書記上黨課筑牢清廉信念為高質量發(fā)展營造風清氣正的環(huán)境
- 冬季消防安全知識培訓冬季用電防火安全
- 2025加強政治引領(政治引領是現代政黨的重要功能)
- 主播直播培訓直播技巧與方法
- 2025六廉六進持續(xù)涵養(yǎng)良好政治生態(tài)
- 員工職業(yè)生涯規(guī)劃方案制定個人職業(yè)生涯規(guī)劃
- 2024年XX地區(qū)黨建引領鄉(xiāng)村振興工作總結
- XX中小學期末考試經驗總結(認真復習輕松應考)
- 幼兒園期末家長會長長的路慢慢地走