《福建省一品一碼食品安全信息追溯管理平臺項目地市數(shù)據(jù)交換共享服務標準》由會員分享，可在線閱讀，更多相關《福建省一品一碼食品安全信息追溯管理平臺項目地市數(shù)據(jù)交換共享服務標準（72頁珍藏版）》請在裝配圖網(wǎng)上搜索。

1、 省"一品一碼"食品安全 信息追溯管理平臺項目 地市數(shù)據(jù)交換共享服務標準 省食品藥品監(jiān)督管理局 66 / 72 文件更改摘要 日期 版本號 修訂說明 修訂人 審核人 批準人 18.3.22 V 1.0 創(chuàng)建全文 18.4.7 V 1.1 增加食品交易單據(jù)、部小包裝配置表、檢驗報告類型3個問題 18.4.26 V 1.2 調整了專用術語、增加了基礎代碼類型 18.5.18 V 1.3 進貨單據(jù)表增加"關聯(lián)銷貨單據(jù)"字段；銷售單據(jù)表增加"關聯(lián)進貨單據(jù)號"字段；將入

2、境貨物檢驗檢疫證明從檢驗檢測中獨立；調整訂餐主體代碼的字段長度；統(tǒng)一修改登記主體代碼regEntId為regEntUnicode；修改合格方式CA015為CA014；修改接口ID 為21W03的節(jié)點entInfo為entLicense；調整產(chǎn)地證明編號字段為inspectionNo,產(chǎn)地證明名稱字段為inspectionName、產(chǎn)地證明文件字段為inspectionReport； 18.5.20 V 1.4 增加餐飲加工數(shù)據(jù)寫入接口<32W03>；修改接口12W02節(jié)點為fpProduct；修訂"食品基礎信息"的"小包裝明細"、餐飲進貨臺賬、餐飲銷貨臺賬的節(jié)點名稱

3、 18.5.26 V 1.5 接口22W01增加關聯(lián)銷貨單據(jù)字段；修改接口22W01節(jié)點fcEntryFill為fcStockBill；修改錯誤的文字說明；增加第5.2.2章節(jié)、第7章節(jié)數(shù)據(jù)刪除接口規(guī)；修訂第6章,增加數(shù)據(jù)修改說明；修改所屬行業(yè)的字段備注 18.6.15 V 1.6 修改保質期字段備注；修改食品基礎信息,預包裝食品類型,產(chǎn)地可以為空；食用農(nóng)產(chǎn)品類型,產(chǎn)地非空；企業(yè)信息,證件類型、證件可以為空；檢驗檢測信息,檢測報告編號可以為空；產(chǎn)地證明,產(chǎn)地證明編號可以為空；增加第5.2.3章節(jié)、第8章節(jié),查詢接口 18.6.19 V 1.7 檢驗

4、檢測報告新增檢測有效期至字段；修改訂餐主體信息中的訂餐人、訂餐人聯(lián)系方式、地址的字段名稱 18.8.13 V 1.8 主體信息、銷貨臺賬、餐飲類型的食品基礎數(shù)據(jù)格式,增加許可證號,餐飲類型主體,主體代碼、許可證號只要一個不為空即可；修改經(jīng)營圍字段長度為4000 18.9.3 V 1.9 增加6.1.2.4、6.2.2.4、6.3.2.4章節(jié),食品處理臺賬數(shù)據(jù)交換標準 18.9.21 V 1.10 主體數(shù)據(jù)格式增加"所屬市場ID"字段；增加8.1.3章節(jié)

5、 目 錄 1.圍1 2. 規(guī)性引用文件1 3. 術語和定義1 4. 縮略語3 5. 接口調用規(guī)3 5.1 身份驗證接口3 5.2 接口調用說明4 5.2.1 數(shù)據(jù)接入接口定義4 5.2.2 數(shù)據(jù)刪除接口定義5 5.2.3 數(shù)據(jù)查詢接口定義6 5.3 返回數(shù)據(jù)格式6 5.3.1 XML格式6 5.3.2 JSON格式7 5.3.3 標識碼定義7 6. 數(shù)據(jù)寫入更新標準規(guī)8 6.1 生產(chǎn)型主體8 6.1.1 基礎數(shù)據(jù)8 6.1.2 臺

6、賬數(shù)據(jù)14 6.1.3 上市憑證18 6.2 流通型主體21 6.2.1 基礎數(shù)據(jù)21 6.2.2 臺賬數(shù)據(jù)26 6.2.3 上市憑證31 6.3 餐飲服務者34 6.3.1 基礎數(shù)據(jù)34 6.3.2 臺賬數(shù)據(jù)39 6.3.3 上市憑證43 7. 數(shù)據(jù)刪除標準規(guī)46 7.1 生產(chǎn)型主體46 7.1.1 基礎數(shù)據(jù)46 7.1.2 臺賬數(shù)據(jù)48 7.1.3 上市憑證49 7.2 流通型主體50 7.2.1 基礎數(shù)據(jù)50 7.2.2 臺賬數(shù)據(jù)52 7.2.3 上市憑證53 7.3 餐飲服務者54 7.3.1 基礎數(shù)據(jù)54 7.3.2 臺賬數(shù)據(jù)56 7.3.

7、3 上市憑證57 8. 數(shù)據(jù)查詢接口規(guī)58 8.1 基礎數(shù)據(jù)58 8.1.1 生產(chǎn)經(jīng)營主體信息查詢58 8.1.2 食品基礎信息查詢59 8.1.3 市場信息查詢61 8.2 交易數(shù)據(jù)62 8.2.1 食品交易單據(jù)62 9. 單據(jù)碼編碼規(guī)則63 9.1 省直單位建設追溯系統(tǒng)單據(jù)碼63 9.2 各地市建設追溯系統(tǒng)單據(jù)碼64 9.3 企業(yè)建設追溯系統(tǒng)單據(jù)碼64 10. 注意事項64 1. 圍 本標準規(guī)定了省"一品一碼"食品安全信息追溯管理平臺〔以下簡稱"一品一碼"追溯管理平臺〕與省地市自建追溯系統(tǒng)數(shù)據(jù)交換的技術架構、接口規(guī)、交換過程、數(shù)據(jù)交換規(guī)等。 本標準適用于地

8、市自建系統(tǒng)與"一品一碼"追溯管理平臺數(shù)據(jù)共享與數(shù)據(jù)交換服務。 2. 規(guī)性引用文件 下列文件中的條款通過本標準的引用而成為本標準的條段．凡是注日期的引用文件。其隨后所有的修改單〔不包括勘誤的容〕或修訂版均不適用于本標準。然而,鼓勵根據(jù)本標準達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件,其最新版本適用于本標準。 GB/T 7408-2005 數(shù)據(jù)元和交換格式 信息交換 日期和時間表示法 GB/T 18391.1-2002 信息技術 數(shù)據(jù)元的規(guī)與標準 第一部分：數(shù)據(jù)元的規(guī)與標準化框架 GB/T 21062.1-2007 政務信息資源交換體系 第1部分：總體框架

9、GB/T 21062.2-2007 政務信息資源交換體系 第2部分：技術要求 GB/T 20162.2-2007 政務信息資源交換體系 第3部分：數(shù)據(jù)接口規(guī) 3. 術語和定義 下列術語和定義適用于本標準。 （1） 省"一品一碼"食品安全信息追溯管理平臺 省建立統(tǒng)一的省食品安全信息追溯管理平臺,匯集相關行政主管部門追溯系統(tǒng)信息,通過編碼識別、身份信息比對等技術手段和驗證管理實現(xiàn)追溯食品和生產(chǎn)經(jīng)營者等信息的共享。 （2） 一品一碼 一品一碼指同一品種批次的食品和食用農(nóng)產(chǎn)品按照規(guī)定的追溯編碼規(guī)則,賦予唯一的識別追溯碼。 （3） 生產(chǎn)經(jīng)營主體 從事食品生產(chǎn)經(jīng)營活動的政府、組織、單位、

10、法人和自然人等具備食品追溯能力的單位和自然人。 （4） 主體代碼 法人采用統(tǒng)一社會信用代碼,由一組長度為18位的用于法人和其他組織身份識別的代碼。統(tǒng)一社會信用代碼由國家標準委發(fā)布。國家標準委發(fā)布了強制性國家標準《法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則》。 針對自然人采用散戶代碼或。 （5） 生產(chǎn)經(jīng)營許可 生產(chǎn)經(jīng)營許可證是許可證的一個類別之一,是縣級以上食品藥品監(jiān)管部門對食品生產(chǎn)與經(jīng)營者頒發(fā)的允許進行食品生產(chǎn)經(jīng)營的法定證件。 （6） 食用農(nóng)產(chǎn)品 指在農(nóng)業(yè)活動中直接獲得的,以及經(jīng)過分揀、去皮、剝殼、干燥、粉碎、清洗、切割、冷凍、打蠟、分級、包裝等加工,但未改變其基本自然性狀和化學性質

11、的、供人食用的植物、動物、微生物及其產(chǎn)品。 （7） 預包裝食品 指預先定量包裝或者制作在包裝材料和容器中的食品；包括預先定量包裝以及預先定量制作在包裝材質和容器中并且在一定量限圍具有統(tǒng)一的質量或體積標識的食品。簡單說,就是指在包裝完成后即具有確定的量值,這一確定的量值應是在一定量限圍具有統(tǒng)一的質量或體積標識。 （8） 入境食品 指從其他國家和地區(qū)進口的食品。 （9） 入閩食品 指中國國,省外的食品,通俗的講就是其他省份和地區(qū)食品,包含在其他省份和地區(qū)生產(chǎn)并在省分包裝的食品。 （10） 食品代碼 預包裝食品的代碼,由企業(yè)向中國物品編碼中心申請,進行自主食品編碼,并在中國物品編碼中

12、心備案；散裝食品的代碼,由各廳局負責源頭賦碼。 （11） 食品追溯碼 指省質量技術監(jiān)督局研究出臺的省地方標準《食品質量安全追溯碼編碼技術規(guī)》〔DB35/T 1711-2017〕規(guī)定的食品追溯碼。 （12） 數(shù)據(jù)提供方 省"一品一碼"食品安全信息追溯管理平臺。 （13） 用戶 與省"一品一碼"食品安全信息追溯管理平臺進行數(shù)據(jù)共享與交換的全省生產(chǎn)經(jīng)營主體自建追溯管理平臺。 （14） 數(shù)據(jù)項 共享數(shù)據(jù)實體。 （15） 數(shù)據(jù)集 組成共享數(shù)據(jù)實體的集合。 （16） 數(shù)據(jù)版本號 共享數(shù)據(jù)在更新序列上的唯一標識。 4. 縮略語 XML -- 可擴展標識語言〔eXtensible

13、Markup Language〕 SOAP -- 簡單對象訪問協(xié)議〔Simple Object Access Protocol > UDDI -- 統(tǒng)一描述、發(fā)現(xiàn)和集成〔 Universal Description,Discovery , and Integration〕 5. 接口調用規(guī) 5.1 身份驗證接口 通過"一品一碼"食品安全信息追溯管理平臺調用各類接口時,必須先對調用方的用戶身份及權限進行驗證,本接口負責用戶身份認證和權限驗證功能。應用程序調用本接口進行身份認證和權限驗證,通過后將獲取身份校驗碼,用戶通過該身份校驗碼才能訪問其他接口。校驗碼的有效時間為30分鐘。 (1

14、) 原型接口 public String getVerifyCode (2) 參數(shù)說明 參數(shù)名 說明 是否必填 dataType 返回的數(shù)據(jù)格式 否〔0表示XML,1表示JSON；默認為XML〕 userAccount 用戶名〔"一品一碼"食品安全信息追溯管理平臺登錄賬號〕 是 password 密碼〔登錄賬號對應的密碼〕 是 (3) 返回說明 驗證成功返回成功標識及身份校驗碼；錯誤則返回錯誤標識及錯誤信息。 5.2 接口調用說明 平臺提供接口用于生產(chǎn)

15、經(jīng)營主體數(shù)據(jù)寫入,接口定義如下說明。 5.2.1 數(shù)據(jù)接入接口定義 (1) 原型接口 public String writeObjectOut ; (2) 參數(shù)說明 序號 參數(shù)名 說明 是否必填 備注 1 verifyCode 身份校驗碼 是 2 jkId 接口ID 是 各接口所對應的ID編號,詳見各接口說明 3 dataType

16、返回的數(shù)據(jù)格式 否 返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML 4 writeXmlDoc 寫入數(shù)據(jù) 是 業(yè)務數(shù)據(jù)寫入XML格式文檔,附件數(shù)據(jù)通過以下附件字段進行上傳。 5 fileNames 附件名稱數(shù)組 否 附件名+類型,如2012012.xls 6 fileContents 附件數(shù)據(jù)數(shù)組 否 附件容,byte字節(jié) (3) WriteXmlDoc參數(shù)示例

17、 URLEncoder.encode<"主體名稱", "UTF-8"> URLEncoder.encode<"主體代碼", "UTF-8"> ……. URLEncoder.encode<"追溯碼", "UTF-8"> ……. …….

18、> 5.2.2 數(shù)據(jù)刪除接口定義 (1) 原型接口 public String deleteObjectOut ; (2) 參數(shù)說明 序號 參數(shù)名 說明 是否必填 備注 1 verifyCode 身份校驗碼 是 2 jkId 接口ID 是 各接口所對應的ID編號,詳見各接口說明 3 dataType 返回的數(shù)據(jù)格式 否 返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML 4

19、 deleteXmlDoc 寫入數(shù)據(jù) 是 業(yè)務數(shù)據(jù)寫入XML格式文檔,附件數(shù)據(jù)通過以下附件字段進行上傳。 (3) DeleteXmlDoc參數(shù)示例 URLEncoder.encode<"主體代碼", "UTF-8"> ……. 5.

20、2.3 數(shù)據(jù)查詢接口定義 (1) 原型接口 public String queryObjectOut ; (2) 參數(shù)說明 序號 參數(shù)名 說明 是否必填 備注 1 verifyCode 身份校驗碼 是 2 jkId 接口ID 是 各接口所對應的ID編號,詳見各接口說明 3 dataType 返回的數(shù)據(jù)格式 否 返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML 4 queryXmlDoc 寫入數(shù)

21、據(jù) 是 查詢字段寫入XML格式文檔。 (3) QueryXmlDoc參數(shù)示例 URLEncoder.encode<"主體名稱", "UTF-8"> URLEncoder.encode<"主體代碼", "UTF-8"> …….

22、> 5.3 返回數(shù)據(jù)格式 接口支持JSON/XML兩種返回數(shù)據(jù)格式,需要在請求參數(shù)中進行指定。 5.3.1 XML格式 5.3.2 JSON格式 { "head": { "fl

23、ag": "標識碼", "msg": "描述信息 " } } 5.3.3 標識碼定義 編碼 編碼說明 -2 業(yè)務異常 -1 系統(tǒng)異常 00 操作成功 01 邏輯業(yè)務出錯 02 參數(shù)信息不能為空！ 07 賬號或密碼錯誤！ 10 xml格式解析異常 14 身份認證碼超時 6. 數(shù)據(jù)寫入更新標準規(guī) 6.1 生產(chǎn)型主體 6.1.1 基礎數(shù)據(jù) 6.1.1.1 原料供貨商信息 (1) 接口ID ：11W01 (2) 節(jié)點名稱：entInfo (3) 接口說明：用于寫入、更新生產(chǎn)主體的原料供貨商數(shù)據(jù)。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允

24、許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 原料供貨商類型 entType 1 非空。CA001 2 原料供貨商名稱 entName 300 非空 3 原料供貨商代碼 entUnicode 18 "生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。 企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。 "餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號〔舊證〕 4 食品經(jīng)營許可證號/餐飲許可證號 orgNo 32 5 經(jīng)營場所 busiPl

25、ace 300 原料供貨商類型為企事業(yè)單位、自然人時,非空 6 經(jīng)營圍 busiScope 4000 7 經(jīng)營起始時間 busiStartDate 14 格式y(tǒng)yyyMMdd 8 經(jīng)營終止時間 busiEndDate 14 格式y(tǒng)yyyMMdd 9 生產(chǎn)經(jīng)營類別 entCategory 1 原料供貨商類型為企事業(yè)單位、自然人時,非空。CA002 10 所屬行業(yè) industry 128 原料供貨商類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003 11 證照圖片 licPic 以附件方式上傳,文件大小不超過5

26、M。 12 法定代表人 legal 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 負責人 principalEma

27、il 64 21 所屬國家 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或農(nóng)貿(mào)市場ID

28、市場ID根據(jù)8.1.3章節(jié)獲取 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.1.2 銷貨主體信息 (1) 接口ID ：11W02 (2) 節(jié)點名稱：entInfo (3) 接口說明：用于寫入、更新生產(chǎn)主體的銷貨主體數(shù)據(jù)。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 銷貨主體類型 entType 1 非空。CA001 2 銷貨主體名稱 entName 300 非空 3 銷貨主體代碼 en

29、tUnicode 18 "生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。 企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。 "餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號〔舊證〕 4 食品經(jīng)營許可證號/餐飲許可證號 orgNo 32 5 經(jīng)營場所 busiPlace 300 銷貨主體類型為企事業(yè)單位、自然人時,非空 6 經(jīng)營圍 busiScope 4000 7 經(jīng)營起始時間 busiStartDate 14 格式y(tǒng)yyyMMdd 8 經(jīng)營終止時間 busiEndDate 1

30、4 格式y(tǒng)yyyMMdd 9 生產(chǎn)經(jīng)營類別 entCategory 1 銷貨主體類型為企事業(yè)單位、自然人時,非空。CA002 10 所屬行業(yè) industry 128 銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003 11 證照圖片 licPic 以附件方式上傳,文件大小不超過5M。 12 法定代表人 legal 64 銷貨主體類型為企事業(yè)單位時,非空 13 證件類型 legalLicType 2 14 證件 legalLicNo 18 15 負責人 principalName 64 銷貨

31、主體類型為企事業(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ū)劃 provinceAdminDivision 8 銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260 23 所屬市行政區(qū)劃 cit

32、yAdminDivision 8 銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260 24 所屬區(qū)縣行政區(qū)劃 areaAdminDivision 8 銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260 25 所屬市場ID belongMarket 32 主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID 市場ID根據(jù)8.1.3章節(jié)獲取 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.1.3 生產(chǎn)經(jīng)營許可 (1) 接口ID ：11W03 (2) 節(jié)點名稱：entLicense (3) 接

33、口說明：用于原料供貨商、銷貨主體的生產(chǎn)經(jīng)營許可證寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 主體名稱 entName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 2 主體代碼 entUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或 3 許可證類型 licenseType 1 非空。CA008 4 許可證編號 licenseNo 32 非空。唯一標識 5 發(fā)證日期 licIssueDate

34、 14 非空,格式y(tǒng)yyyMMdd 6 有效期至 licValidEndDate 14 非空,格式y(tǒng)yyyMMdd 7 許可證圖片 licensePic 非空,以附件方式上傳,文件大小不超過5M。 8 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.1.4 食品基礎信息 (1) 接口ID ：11W04 (2) 節(jié)點名稱：foodProduct (3) 接口說明：用于生產(chǎn)主體進貨原料、生產(chǎn)食品的基礎數(shù)據(jù)信息寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新

35、該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 食品代碼 productCode 32 非空。唯一標識 2 食品名稱 productName 256 非空 3 食品類型 productType 1 非空。CA009 4 產(chǎn)地類型 placeType 1 非空。CA005 5 生產(chǎn)主體名稱 entName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 6 生產(chǎn)主體代碼 entUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼 7 商標 trademark 128

36、 8 保質期 expiryDate 32 請輸入數(shù)值+單位〔年、月、天〕格式,例如：180天。 9 食用農(nóng)產(chǎn)品類別 agrProductCategory 32 食品類型為食用農(nóng)產(chǎn)品時,必填。CA015 10 預包裝食品類別 productCategory 32 食品類型為預包裝食品時,必填。CA010 11 規(guī)格 specification 64 12 產(chǎn)地 placeOfOrigin 64 預包裝食品類型,可以為空；食用農(nóng)產(chǎn)品類型,非空 13 原產(chǎn)國 nation 8 產(chǎn)地類型為進口食品時,必填。GB/T 2659 14 計

37、量單位 measurementUnit 64 非空。 15 食品圖片 productPic 以附件方式上傳,文件大小不超過5M。 16 備注 remark 300 17 小包裝明細 xbzmxs 用于記錄大包裝食品還含有多個小包裝食品的關系數(shù)據(jù)。如：箱裝牛奶含多個小盒牛奶、大箱礦泉水含多個小瓶礦泉水。 部小包裝明細參數(shù)：<節(jié)點xbzmx> 序號 中文名稱 英文名稱 長度 備注 1 小包裝食品代碼 smallProductCode 32 非空。關聯(lián)食品基礎信息表的食品代碼 2 小包裝食品數(shù)量 containsNum 18

38、非空 3 小包裝食品計量單位 measurementUnit 64 非空。 4 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.2 臺賬數(shù)據(jù) 6.1.2.1 原料進貨單據(jù) (1) 接口ID ：12W01 (2) 節(jié)點名稱：fpStockBill (3) 接口說明：用于原料進貨單據(jù)及明細寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 單據(jù)號 bill

39、No 50 非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié) 2 登記主體名稱 regEntName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 3 登記主體代碼 regEntUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼 4 交易日期 tradeDate 14 非空。格式y(tǒng)yyyMMddHHmmss 5 供貨主體名稱 supplyEntName 300 非空,關聯(lián)原料供貨商表的主體名稱 6 供貨主體代碼 supplyEntUnicode 18 非空,關聯(lián)原料供貨商表的主體代碼 7 備注 remark 300 8 關聯(lián)銷貨單據(jù)

40、refSalesBillNo 50 關聯(lián)上游的銷貨單據(jù)號 9 進貨單據(jù)明細 fpStockDetails 原料進貨單據(jù)明細,可傳多條明細,詳細參數(shù)如下表： 原料進貨單據(jù)明細參數(shù)：<節(jié)點fpStockDetail> 序號 中文名稱 英文名稱 長度 備注 1 食品追溯碼 traceCode 64 非空 2 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 3 食品名稱 productName 256 非空,關聯(lián)食品基礎信息表的食品名稱 4 批次 batch 32 非空 5 生產(chǎn)日期 productD

41、ate 14 非空。格式y(tǒng)yyyMMddHHmmss 6 交易數(shù)量 tradeNum 18 非空 7 計量單位 measurementUnit 64 非空。 8 順序號 orderNum 8 9 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.2.2 生產(chǎn)臺賬登記 (1) 接口ID ：12W02 (2) 節(jié)點名稱：fpProduct (3) 接口說明：用于生產(chǎn)主體的生產(chǎn)臺賬登記數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允

42、許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 登記主體名稱 regEntName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 2 登記主體代碼 regEntUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼 3 食品追溯碼 traceCode 64 非空。唯一標識 4 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 5 食品名稱 productName 256 非空,關聯(lián)食品基礎信息表的食品名稱 6 批次 batch 32 非空 7 生產(chǎn)日期 pr

43、oductDate 14 非空,格式y(tǒng)yyyMMddHHmmss 8 生產(chǎn)數(shù)量 tradeNum 18 非空 9 計量單位 measurementUnit 64 非空。 10 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.2.3 銷售單據(jù)登記 (1) 接口ID ：12W03 (2) 節(jié)點名稱：fpSalesBill (3) 接口說明：用于主體的銷售單據(jù)及明細寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4)

44、 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 單據(jù)號 billNo 50 非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié) 2 登記主體名稱 regEntName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 3 登記主體代碼 regEntUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼 4 交易日期 tradeDate 14 非空。格式y(tǒng)yyyMMddHHmmss 5 收貨主體名稱 receiveEntName 300 非空,關聯(lián)銷貨主體表的主體名稱 6 收貨主體代碼 receiveEntUnicode 18 必須有一個不

45、為空 7 收貨主體食品經(jīng)營許可證號/餐飲許可證號 receiveEntOrgNo 32 8 備注 remark 50 非空 9 關聯(lián)進貨單據(jù)號 refStockBillNo 50 關聯(lián)下游的進貨單據(jù)號 10 銷售單據(jù)明細 fpSalesDetails 銷售單據(jù)明細,可傳多條明細,詳細參數(shù)如下表： 銷售單據(jù)明細參數(shù)：<節(jié)點fpSalesDetail> 序號 中文名稱 英文名稱 長度 備注 1 食品追溯碼 traceCode 64 非空 2 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 3 食

46、品名稱 productName 256 非空,關聯(lián)食品基礎信息表的食品名稱 4 批次 batch 32 非空 5 生產(chǎn)日期 productDate 14 非空。格式y(tǒng)yyyMMddHHmmss 6 交易數(shù)量 tradeNum 18 非空 7 計量單位 measurementUnit 64 非空。 8 順序號 orderNum 8 9 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.2.4 食品處理臺賬 (1) 接口ID

47、：12W04 (2) 節(jié)點名稱：fpFoodHandle (3) 接口說明：記錄生產(chǎn)主體食品處理的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 處理單據(jù)號 billNo 50 非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié) 2 登記主體名稱 regEntName 300 非空 3 登記主體代碼 regEntUnicode 18 非空 4 處理對象類型 handleObjType 1 非空。1 - 原料；2 - 產(chǎn)品 5 食品追溯碼 traceCode 64 非空 6 食品代碼 productCode 32

48、 非空,關聯(lián)食品基礎信息表的食品代碼 7 食品名稱 productName 256 非空,關聯(lián)食品基礎信息表的食品名稱 8 批次 batch 32 非空 9 生產(chǎn)日期 productDate 非空。格式y(tǒng)yyyMMddHHmmss 10 處理數(shù)量 handleNum 18 非空 11 計量單位 measurementUnit 64 非空 12 處理日期 handleDate 非空 13 處理類型 handleType 1 非空。1 - 退貨；2 - 銷毀；3 - 報廢；4 - 其他； 7 - 零售；8 - 投用； 14

49、 領用人 leadingPerson 100 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.3 上市憑證 6.1.3.1 檢驗檢測信息 (1) 接口ID ：13W01 (2) 節(jié)點名稱：inspectionReport (3) 接口說明：用于食品檢驗檢測的數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 檢驗報告類型 inspectionType 4 非空。CA013 2 檢

50、測報告編號 inspectionNo 32 3 檢測報告名稱 inspectionName 256 4 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 5 食品生產(chǎn)日期 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

51、檢測報告文件 inspectionReport 以附件方式上傳,文件大小不超過5M。 11 檢測機構 inspectionOrg 256 12 檢測人員 inspectionPerson 64 13 檢測有效期至 inspectionValidDate 格式y(tǒng)yyyMMdd 14 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.3.2 產(chǎn)地證明 (1) 接口ID ：13W02 (2) 節(jié)點名稱：inspectionReport

52、(3) 接口說明：用于食品的產(chǎn)地證明數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 產(chǎn)地證明編號 inspectionNo 32 2 產(chǎn)地證明名稱 inspectionName 256 3 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 4 食品生產(chǎn)日期 productDate 14 非空,格式y(tǒng)yyyMMddHHmmss 5 批次 batch 32 非空 6 產(chǎn)地 placeOfOrigin

53、64 非空 7 報告日期 inspectionDate 8 非空,格式y(tǒng)yyyMMdd 8 產(chǎn)地證明文件 inspectionReport 以附件方式上傳,文件大小不超過5M。 9 檢測有效期至 inspectionValidDate 格式y(tǒng)yyyMMdd 10 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.1.3.3 入境貨物檢驗檢疫證明 (1) 接口ID ：13W03 (2) 節(jié)點名稱：inspectionReport (3) 接口說明

54、：用于入境貨物經(jīng)驗檢疫證明數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 檢測報告編號 inspectionNo 32 2 檢測報告名稱 inspectionName 256 3 食品代碼 productCode 32 非空,關聯(lián)食品基礎信息表的食品代碼 4 食品生產(chǎn)日期 productDate 非空,格式y(tǒng)yyyMMddHHmmss 5 批次 batch 32 非空 6 證明出具日期 inspectionDate

55、非空。格式y(tǒng)yyyMMdd 7 入境證明文件 inspectionReport 以附件方式上傳,文件大小不超過5M。 8 證明出具機構 inspectionOrg 256 9 證明出具人員 inspectionPerson 64 10 檢測有效期至 inspectionValidDate 格式y(tǒng)yyyMMdd 11 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.2 流通型主體 6.2.1 基礎數(shù)據(jù) 6.2.1.1 供貨主體信息

56、(1) 接口ID ：21W01 (2) 節(jié)點名稱：entInfo (3) 接口說明：用于供貨主體的數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 供貨主體類型 entType 1 非空。CA001 2 供貨主體名稱 entName 300 非空 3 供貨主體代碼 entUnicode 18 "生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。 企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或

57、。 "餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號〔舊證〕 4 食品經(jīng)營許可證號/餐飲許可證號 orgNo 32 5 經(jīng)營場所 busiPlace 300 供貨主體類型為企事業(yè)單位、自然人時,非空 6 經(jīng)營圍 busiScope 4000 7 經(jīng)營起始時間 busiStartDate 14 格式y(tǒng)yyyMMdd 8 經(jīng)營終止時間 busiEndDate 14 格式y(tǒng)yyyMMdd 9 生產(chǎn)經(jīng)營類別 entCategory 1 供貨主體類型為企事業(yè)單位、自然人時,非空。CA002 10 所屬行業(yè) industry 128

58、 供貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(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

59、 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è)單位、自然人時,非空。GB T2260 24 所屬區(qū)縣行政區(qū)劃 areaAdminDivision 8

60、 供貨主體類型為企事業(yè)單位、自然人時,非空。GB T2260 25 所屬市場ID belongMarket 32 主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID 市場ID根據(jù)8.1.3章節(jié)獲取 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.2.1.2 銷貨主體信息 (1) 接口ID ：21W02 (2) 節(jié)點名稱：entInfo (3) 接口說明：用于銷貨主體信息數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度

61、備注 1 銷貨主體類型 entType 1 非空。CA001 2 銷貨主體名稱 entName 300 非空 3 銷貨主體代碼 entUnicode 18 "生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。 企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。 "餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號〔舊證〕 4 食品經(jīng)營許可證號/餐飲許可證號 orgNo 32 5 經(jīng)營場所 busiPlace 300 銷貨主體類型為企事業(yè)單位、自然人時,非空 6 經(jīng)營圍 busiSco

62、pe 4000 7 經(jīng)營起始時間 busiStartDate 14 格式y(tǒng)yyyMMdd 8 經(jīng)營終止時間 busiEndDate 14 格式y(tǒng)yyyMMdd 9 生產(chǎn)經(jīng)營類別 entCategory 1 銷貨主體類型為企事業(yè)單位、自然人時,非空。CA002 10 所屬行業(yè) industry 128 銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA003 11 證照圖片 licPic 以附件方式上傳,文件大小不超過5M。 12 法定代表人 legal 64 銷貨主體類型為企事業(yè)單位時,非空 13 證件

63、類型 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 所屬國家 nation 8 非空。GB/T 2659 22 所屬省

64、行政區(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或農(nóng)貿(mào)市場ID 市場ID根據(jù)8.1.3章節(jié)獲取 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回

65、格式詳見[返回數(shù)據(jù)格式]定義說明。 6.2.1.3 生產(chǎn)經(jīng)營許可 (1) 接口ID ：21W03 (2) 節(jié)點名稱：entLicense (3) 接口說明：用于供貨主體、銷貨主體的生產(chǎn)經(jīng)營許可證寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 主體名稱 entName 300 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱 2 主體代碼 entUnicode 18 非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或 3 許可證類型 lic

66、enseType 1 非空。CA008 4 許可證編號 licenseNo 32 非空、唯一標識 5 發(fā)證日期 licIssueDate 14 非空,格式y(tǒng)yyyMMdd 6 有效期至 licValidEndDate 14 非空,格式y(tǒng)yyyMMdd 7 許可證圖片 licensePic 非空,以附件方式上傳,文件大小不超過5M。 8 備注 remark 300 (5) 返回說明 寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見[返回數(shù)據(jù)格式]定義說明。 6.2.1.4 食品基礎信息 (1) 接口ID ：21W04 (2) 節(jié)點名稱：foodProduct (3) 接口說明：用于流通主體經(jīng)營食品的基礎數(shù)據(jù)信息寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。 (4) 寫入?yún)?shù)： 序號 中文名稱 英文名稱 長度 備注 1 食品代碼 productCode 32 非空。唯一標識 2 食品名稱 productName 256 非空 3 食品