省"一品一碼"食品安全信息追溯管理平臺項目地市數(shù)據(jù)交換共享服務標準省食品藥品監(jiān)督管理局66 / 72文件更改摘要日期版本號修訂說明修訂人審核人批準人18.3.22V 1.0創(chuàng)建全文18.4.7V 1.1增加食品交易單據(jù)、部小包裝配置表、檢驗報告類型3個問題18.4.26V 1.2調整了專用術語、增加了基礎代碼類型18.5.18V 1.3進貨單據(jù)表增加"關聯(lián)銷貨單據(jù)"字段；銷售單據(jù)表增加"關聯(lián)進貨單據(jù)號"字段；將入境貨物檢驗檢疫證明從檢驗檢測中獨立；調整訂餐主體代碼的字段長度；統(tǒng)一修改登記主體代碼regEntId為regEntUnicode；修改合格方式CA015為CA014；修改接口ID 為21W03的節(jié)點entInfo為entLicense；調整產(chǎn)地證明編號字段為inspectionNo,產(chǎn)地證明名稱字段為inspectionName、產(chǎn)地證明文件字段為inspectionReport； 18.5.20V 1.4增加餐飲加工數(shù)據(jù)寫入接口<32W03>；修改接口12W02節(jié)點為fpProduct；修訂"食品基礎信息"的"小包裝明細"、餐飲進貨臺賬、餐飲銷貨臺賬的節(jié)點名稱18.5.26V 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.15V 1.6修改保質期字段備注；修改食品基礎信息,預包裝食品類型,產(chǎn)地可以為空；食用農(nóng)產(chǎn)品類型,產(chǎn)地非空；企業(yè)信息,證件類型、證件可以為空；檢驗檢測信息,檢測報告編號可以為空；產(chǎn)地證明,產(chǎn)地證明編號可以為空；增加第5.2.3章節(jié)、第8章節(jié),查詢接口18.6.19V 1.7檢驗檢測報告新增檢測有效期至字段；修改訂餐主體信息中的訂餐人、訂餐人聯(lián)系方式、地址的字段名稱18.8.13V 1.8主體信息、銷貨臺賬、餐飲類型的食品基礎數(shù)據(jù)格式,增加許可證號,餐飲類型主體,主體代碼、許可證號只要一個不為空即可；修改經(jīng)營圍字段長度為400018.9.3V 1.9增加6.1.2.4、6.2.2.4、6.3.2.4章節(jié),食品處理臺賬數(shù)據(jù)交換標準18.9.21V 1.10主體數(shù)據(jù)格式增加"所屬市場ID"字段；增加8.1.3章節(jié)目 錄1.圍12. 規(guī)性引用文件13. 術語和定義14. 縮略語35. 接口調用規(guī)35.1 身份驗證接口35.2 接口調用說明45.2.1 數(shù)據(jù)接入接口定義45.2.2 數(shù)據(jù)刪除接口定義55.2.3 數(shù)據(jù)查詢接口定義65.3 返回數(shù)據(jù)格式65.3.1 XML格式65.3.2 JSON格式75.3.3 標識碼定義76. 數(shù)據(jù)寫入更新標準規(guī)86.1 生產(chǎn)型主體86.1.1 基礎數(shù)據(jù)86.1.2 臺賬數(shù)據(jù)146.1.3 上市憑證186.2 流通型主體216.2.1 基礎數(shù)據(jù)216.2.2 臺賬數(shù)據(jù)266.2.3 上市憑證316.3 餐飲服務者346.3.1 基礎數(shù)據(jù)346.3.2 臺賬數(shù)據(jù)396.3.3 上市憑證437. 數(shù)據(jù)刪除標準規(guī)467.1 生產(chǎn)型主體467.1.1 基礎數(shù)據(jù)467.1.2 臺賬數(shù)據(jù)487.1.3 上市憑證497.2 流通型主體507.2.1 基礎數(shù)據(jù)507.2.2 臺賬數(shù)據(jù)527.2.3 上市憑證537.3 餐飲服務者547.3.1 基礎數(shù)據(jù)547.3.2 臺賬數(shù)據(jù)567.3.3 上市憑證578. 數(shù)據(jù)查詢接口規(guī)588.1 基礎數(shù)據(jù)588.1.1 生產(chǎn)經(jīng)營主體信息查詢588.1.2 食品基礎信息查詢598.1.3 市場信息查詢618.2 交易數(shù)據(jù)628.2.1 食品交易單據(jù)629. 單據(jù)碼編碼規(guī)則639.1 省直單位建設追溯系統(tǒng)單據(jù)碼639.2 各地市建設追溯系統(tǒng)單據(jù)碼649.3 企業(yè)建設追溯系統(tǒng)單據(jù)碼6410. 注意事項641. 圍本標準規(guī)定了省"一品一碼"食品安全信息追溯管理平臺以下簡稱"一品一碼"追溯管理平臺與省地市自建追溯系統(tǒng)數(shù)據(jù)交換的技術架構、接口規(guī)、交換過程、數(shù)據(jù)交換規(guī)等。本標準適用于地市自建系統(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部分：總體框架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)營活動的政府、組織、單位、法人和自然人等具備食品追溯能力的單位和自然人。（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)過分揀、去皮、剝殼、干燥、粉碎、清洗、切割、冷凍、打蠟、分級、包裝等加工,但未改變其基本自然性狀和化學性質的、供人食用的植物、動物、微生物及其產(chǎn)品。（7） 預包裝食品指預先定量包裝或者制作在包裝材料和容器中的食品；包括預先定量包裝以及預先定量制作在包裝材質和容器中并且在一定量限圍具有統(tǒng)一的質量或體積標識的食品。簡單說,就是指在包裝完成后即具有確定的量值,這一確定的量值應是在一定量限圍具有統(tǒng)一的質量或體積標識。（8） 入境食品指從其他國家和地區(qū)進口的食品。（9） 入閩食品指中國國,省外的食品,通俗的講就是其他省份和地區(qū)食品,包含在其他省份和地區(qū)生產(chǎn)并在省分包裝的食品。（10） 食品代碼預包裝食品的代碼,由企業(yè)向中國物品編碼中心申請,進行自主食品編碼,并在中國物品編碼中心備案；散裝食品的代碼,由各廳局負責源頭賦碼。（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 Markup LanguageSOAP - 簡單對象訪問協(xié)議Simple Object Access Protocol > UDDI - 統(tǒng)一描述、發(fā)現(xiàn)和集成 Universal Description,Discovery , and Integration5. 接口調用規(guī)5.1 身份驗證接口通過"一品一碼"食品安全信息追溯管理平臺調用各類接口時,必須先對調用方的用戶身份及權限進行驗證,本接口負責用戶身份認證和權限驗證功能。應用程序調用本接口進行身份認證和權限驗證,通過后將獲取身份校驗碼,用戶通過該身份校驗碼才能訪問其他接口。校驗碼的有效時間為30分鐘。(1) 原型接口public String getVerifyCode<String userAccount, String password,String dataType>(2) 參數(shù)說明參數(shù)名說明是否必填dataType返回的數(shù)據(jù)格式否0表示XML,1表示JSON；默認為XMLuserAccount用戶名"一品一碼"食品安全信息追溯管理平臺登錄賬號 是password密碼登錄賬號對應的密碼是(3) 返回說明驗證成功返回成功標識及身份校驗碼；錯誤則返回錯誤標識及錯誤信息。5.2 接口調用說明平臺提供接口用于生產(chǎn)經(jīng)營主體數(shù)據(jù)寫入,接口定義如下說明。5.2.1 數(shù)據(jù)接入接口定義(1) 原型接口public String writeObjectOut <String verifyCode, String jkId, String dataType, String writeXmlDoc,String fileNames,byte fileContents>(2) 參數(shù)說明序號參數(shù)名說明是否必填備注1verifyCode身份校驗碼是2jkId接口ID是各接口所對應的ID編號,詳見各接口說明3dataType返回的數(shù)據(jù)格式否返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML4writeXmlDoc寫入數(shù)據(jù)是業(yè)務數(shù)據(jù)寫入XML格式文檔,附件數(shù)據(jù)通過以下附件字段進行上傳。5fileNames附件名稱數(shù)組否附件名+類型,如2012012.xls6fileContents附件數(shù)據(jù)數(shù)組否附件容,byte字節(jié)(3) WriteXmlDoc參數(shù)示例<?xml version="1.0"encoding="utf-8"?><root><!ylghsxx 為節(jié)點名稱,具體節(jié)點名稱由各接口定義,節(jié)點名稱詳見各接口說明-><ylghsxx> <!參數(shù)需要通過URLEncoder.encode方式進行編碼><entName>URLEncoder.encode<"主體名稱", "UTF-8"></ entType ><entUnicode>URLEncoder.encode<"主體代碼", "UTF-8"></ entUnicode >.<djmxs> <djmx> <traceCode>URLEncoder.encode<"追溯碼", "UTF-8"></traceCode>. </djmx>.</djmxs></ylghsxx></ root >5.2.2 數(shù)據(jù)刪除接口定義(1) 原型接口public String deleteObjectOut <String verifyCode, String jkId, String dataType,String deleteXmlDoc>(2) 參數(shù)說明序號參數(shù)名說明是否必填備注1verifyCode身份校驗碼是2jkId接口ID是各接口所對應的ID編號,詳見各接口說明3dataType返回的數(shù)據(jù)格式否返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML4deleteXmlDoc寫入數(shù)據(jù)是業(yè)務數(shù)據(jù)寫入XML格式文檔,附件數(shù)據(jù)通過以下附件字段進行上傳。(3) DeleteXmlDoc參數(shù)示例<?xml version="1.0"encoding="utf-8"?><root><!刪除查詢條件-><deleteCondition> <!參數(shù)需要通過URLEncoder.encode方式進行編碼><entUnicode>URLEncoder.encode<"主體代碼", "UTF-8"></entUnicode >.</ deleteCondition ></root >5.2.3 數(shù)據(jù)查詢接口定義(1) 原型接口public String queryObjectOut <String verifyCode, String jkId, String dataType,String queryXmlDoc>(2) 參數(shù)說明序號參數(shù)名說明是否必填備注1verifyCode身份校驗碼是2jkId接口ID是各接口所對應的ID編號,詳見各接口說明3dataType返回的數(shù)據(jù)格式否返回的數(shù)據(jù)類型,0表示XML,1表示JSON；默認為XML4queryXmlDoc寫入數(shù)據(jù)是查詢字段寫入XML格式文檔。(3) QueryXmlDoc參數(shù)示例<?xml version="1.0"encoding="utf-8"?><root><!查詢條件-><queryCondition> <!參數(shù)需要通過URLEncoder.encode方式進行編碼><entName>URLEncoder.encode<"主體名稱", "UTF-8"></entType ><entUnicode>URLEncoder.encode<"主體代碼", "UTF-8"></entUnicode >.</ queryCondition ></ root >5.3 返回數(shù)據(jù)格式接口支持JSON/XML兩種返回數(shù)據(jù)格式,需要在請求參數(shù)中進行指定。5.3.1 XML格式<?xml version="1.0"encoding="utf-8"?><root><head><flag><!CDATA標識碼</flag><!-操作結果標識碼,包括錯誤碼,詳情參考編碼定義表-><msg><!CDATA描述信息> </msg><!結果描述信息,具體錯誤原因根據(jù)實際情況返回-></head></root >5.3.2 JSON格式"head": "flag": "標識碼","msg": "描述信息 "5.3.3 標識碼定義編碼編碼說明-2業(yè)務異常-1系統(tǒng)異常00操作成功01邏輯業(yè)務出錯02參數(shù)信息不能為空！07賬號或密碼錯誤！10xml格式解析異常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ù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1原料供貨商類型entType1非空。CA0012原料供貨商名稱entName300非空3原料供貨商代碼entUnicode18"生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。"餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號舊證4食品經(jīng)營許可證號/餐飲許可證號orgNo325經(jīng)營場所busiPlace300原料供貨商類型為企事業(yè)單位、自然人時,非空6經(jīng)營圍busiScope40007經(jīng)營起始時間busiStartDate14格式y(tǒng)yyyMMdd8經(jīng)營終止時間busiEndDate14格式y(tǒng)yyyMMdd9生產(chǎn)經(jīng)營類別entCategory1原料供貨商類型為企事業(yè)單位、自然人時,非空。CA00210所屬行業(yè)industry128原料供貨商類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA00311證照圖片licPic以附件方式上傳,文件大小不超過5M。12法定代表人legal64原料供貨商類型為企事業(yè)單位時,非空13證件類型legalLicType214證件legalLicNo1815負責人principalName64原料供貨商類型為企事業(yè)單位、境外企業(yè)時,非空16負責人手機principalMobile3217負責人固定principalTel3218負責人principalFax3219負責人證件principalLicNo1820負責人principalEmail6421所屬國家nation8非空。GB/T 265922所屬省行政區(qū)劃provinceAdminDivision8原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T226023所屬市行政區(qū)劃cityAdminDivision8原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T226024所屬區(qū)縣行政區(qū)劃areaAdminDivision8原料供貨商類型為企事業(yè)單位、自然人時,非空。GB T226025所屬市場IDbelongMarket32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID市場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銷貨主體類型entType1非空。CA0012銷貨主體名稱entName300非空3銷貨主體代碼entUnicode18"生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。"餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號舊證4食品經(jīng)營許可證號/餐飲許可證號orgNo325經(jīng)營場所busiPlace300銷貨主體類型為企事業(yè)單位、自然人時,非空6經(jīng)營圍busiScope40007經(jīng)營起始時間busiStartDate14格式y(tǒng)yyyMMdd8經(jīng)營終止時間busiEndDate14格式y(tǒng)yyyMMdd9生產(chǎn)經(jīng)營類別entCategory1銷貨主體類型為企事業(yè)單位、自然人時,非空。CA00210所屬行業(yè)industry128銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA00311證照圖片licPic以附件方式上傳,文件大小不超過5M。12法定代表人legal64銷貨主體類型為企事業(yè)單位時,非空13證件類型legalLicType214證件legalLicNo1815負責人principalName64銷貨主體類型為企事業(yè)單位、境外企業(yè)時,非空16負責人手機principalMobile3217負責人固定principalTel3218負責人principalFax3219負責人證件principalLicNo1820負責人principalEmail6421所屬國家nation8非空。GB/T 265922所屬省行政區(qū)劃provinceAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226023所屬市行政區(qū)劃cityAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226024所屬區(qū)縣行政區(qū)劃areaAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226025所屬市場IDbelongMarket32主體所屬批發(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) 接口說明：用于原料供貨商、銷貨主體的生產(chǎn)經(jīng)營許可證寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1主體名稱entName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱2主體代碼entUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或3許可證類型licenseType1非空。CA0084許可證編號licenseNo32非空。唯一標識5發(fā)證日期licIssueDate14非空,格式y(tǒng)yyyMMdd6有效期至licValidEndDate14非空,格式y(tǒng)yyyMMdd7許可證圖片licensePic非空,以附件方式上傳,文件大小不超過5M。8備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.1.1.4 食品基礎信息(1) 接口ID ：11W04(2) 節(jié)點名稱：foodProduct (3) 接口說明：用于生產(chǎn)主體進貨原料、生產(chǎn)食品的基礎數(shù)據(jù)信息寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1食品代碼productCode32非空。唯一標識2食品名稱productName256非空3食品類型productType1非空。CA0094產(chǎn)地類型placeType1非空。CA0055生產(chǎn)主體名稱entName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱6生產(chǎn)主體代碼entUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼7商標trademark1288保質期expiryDate32請輸入數(shù)值+單位年、月、天格式,例如：180天。9食用農(nóng)產(chǎn)品類別agrProductCategory32食品類型為食用農(nóng)產(chǎn)品時,必填。CA01510預包裝食品類別productCategory32食品類型為預包裝食品時,必填。CA01011規(guī)格specification6412產(chǎn)地placeOfOrigin64預包裝食品類型,可以為空；食用農(nóng)產(chǎn)品類型,非空13原產(chǎn)國nation8產(chǎn)地類型為進口食品時,必填。GB/T 265914計量單位measurementUnit64非空。15食品圖片productPic以附件方式上傳,文件大小不超過5M。16備注remark30017小包裝明細xbzmxs用于記錄大包裝食品還含有多個小包裝食品的關系數(shù)據(jù)。如：箱裝牛奶含多個小盒牛奶、大箱礦泉水含多個小瓶礦泉水。部小包裝明細參數(shù)：<節(jié)點xbzmx>序號中文名稱英文名稱長度備注1小包裝食品代碼smallProductCode32非空。關聯(lián)食品基礎信息表的食品代碼2小包裝食品數(shù)量containsNum18非空3小包裝食品計量單位measurementUnit64非空。4備注remark300(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ù)號billNo50非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié)2登記主體名稱regEntName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱3登記主體代碼regEntUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼4交易日期tradeDate14非空。格式y(tǒng)yyyMMddHHmmss5供貨主體名稱supplyEntName300非空,關聯(lián)原料供貨商表的主體名稱6供貨主體代碼supplyEntUnicode18非空,關聯(lián)原料供貨商表的主體代碼7備注remark3008關聯(lián)銷貨單據(jù)refSalesBillNo50關聯(lián)上游的銷貨單據(jù)號9進貨單據(jù)明細fpStockDetails原料進貨單據(jù)明細,可傳多條明細,詳細參數(shù)如下表：原料進貨單據(jù)明細參數(shù)：<節(jié)點fpStockDetail>序號中文名稱英文名稱長度備注1食品追溯碼traceCode64非空2食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼3食品名稱productName256非空,關聯(lián)食品基礎信息表的食品名稱4批次batch32非空5生產(chǎn)日期productDate14非空。格式y(tǒng)yyyMMddHHmmss6交易數(shù)量tradeNum18非空7計量單位measurementUnit64非空。8順序號orderNum89備注remark300(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ù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1登記主體名稱regEntName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱2登記主體代碼regEntUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼3食品追溯碼traceCode64非空。唯一標識4食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼5食品名稱productName256非空,關聯(lián)食品基礎信息表的食品名稱6批次batch32非空7生產(chǎn)日期productDate14非空,格式y(tǒng)yyyMMddHHmmss8生產(chǎn)數(shù)量tradeNum18非空9計量單位measurementUnit64非空。10備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.1.2.3 銷售單據(jù)登記(1) 接口ID ：12W03(2) 節(jié)點名稱：fpSalesBill (3) 接口說明：用于主體的銷售單據(jù)及明細寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1單據(jù)號billNo50非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié)2登記主體名稱regEntName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱3登記主體代碼regEntUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼4交易日期tradeDate14非空。格式y(tǒng)yyyMMddHHmmss5收貨主體名稱receiveEntName300非空,關聯(lián)銷貨主體表的主體名稱6收貨主體代碼receiveEntUnicode18必須有一個不為空7收貨主體食品經(jīng)營許可證號/餐飲許可證號receiveEntOrgNo328備注remark50非空9關聯(lián)進貨單據(jù)號refStockBillNo50關聯(lián)下游的進貨單據(jù)號10銷售單據(jù)明細fpSalesDetails銷售單據(jù)明細,可傳多條明細,詳細參數(shù)如下表：銷售單據(jù)明細參數(shù)：<節(jié)點fpSalesDetail>序號中文名稱英文名稱長度備注1食品追溯碼traceCode64非空2食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼3食品名稱productName256非空,關聯(lián)食品基礎信息表的食品名稱4批次batch32非空5生產(chǎn)日期productDate14非空。格式y(tǒng)yyyMMddHHmmss6交易數(shù)量tradeNum18非空7計量單位measurementUnit64非空。8順序號orderNum89備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.1.2.4 食品處理臺賬(1) 接口ID ：12W04(2) 節(jié)點名稱：fpFoodHandle(3) 接口說明：記錄生產(chǎn)主體食品處理的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1處理單據(jù)號billNo50非空。唯一標識。單據(jù)號規(guī)則見第9章節(jié)2登記主體名稱regEntName300非空3登記主體代碼regEntUnicode18非空4處理對象類型handleObjType1非空。1 - 原料；2 - 產(chǎn)品5食品追溯碼traceCode64非空6食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼7食品名稱productName256非空,關聯(lián)食品基礎信息表的食品名稱8批次batch32非空9生產(chǎn)日期productDate非空。格式y(tǒng)yyyMMddHHmmss10處理數(shù)量handleNum18非空11計量單位measurementUnit64非空12處理日期handleDate非空13處理類型handleType1非空。1 - 退貨；2 - 銷毀；3 - 報廢；4 - 其他； 7 - 零售；8 - 投用；14領用人leadingPerson100(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檢驗報告類型inspectionType4非空。CA0132檢測報告編號inspectionNo323檢測報告名稱inspectionName2564食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼5食品生產(chǎn)日期productDate14非空,格式y(tǒng)yyyMMddHHmmss6批次batch32非空7檢測結果inspectionResult1非空。CA0078檢測日期inspectionDate14非空,格式y(tǒng)yyyMMdd9合格方式qualifiedStyle2CA01410檢測報告文件inspectionReport以附件方式上傳,文件大小不超過5M。11檢測機構inspectionOrg25612檢測人員inspectionPerson6413檢測有效期至inspectionValidDate格式y(tǒng)yyyMMdd14備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.1.3.2 產(chǎn)地證明(1) 接口ID ：13W02(2) 節(jié)點名稱：inspectionReport (3) 接口說明：用于食品的產(chǎn)地證明數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1產(chǎn)地證明編號inspectionNo322產(chǎn)地證明名稱inspectionName2563食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼4食品生產(chǎn)日期productDate14非空,格式y(tǒng)yyyMMddHHmmss5批次batch32非空6產(chǎn)地placeOfOrigin64非空7報告日期inspectionDate8非空,格式y(tǒng)yyyMMdd8產(chǎn)地證明文件inspectionReport以附件方式上傳,文件大小不超過5M。9檢測有效期至inspectionValidDate格式y(tǒng)yyyMMdd10備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.1.3.3 入境貨物檢驗檢疫證明(1) 接口ID ：13W03(2) 節(jié)點名稱：inspectionReport(3) 接口說明：用于入境貨物經(jīng)驗檢疫證明數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1檢測報告編號inspectionNo322檢測報告名稱inspectionName2563食品代碼productCode32非空,關聯(lián)食品基礎信息表的食品代碼4食品生產(chǎn)日期productDate非空,格式y(tǒng)yyyMMddHHmmss5批次batch32非空6證明出具日期inspectionDate非空。格式y(tǒng)yyyMMdd7入境證明文件inspectionReport以附件方式上傳,文件大小不超過5M。8證明出具機構inspectionOrg2569證明出具人員inspectionPerson6410檢測有效期至inspectionValidDate格式y(tǒng)yyyMMdd11備注remark300(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(shù)據(jù)格式定義說明。6.2 流通型主體6.2.1 基礎數(shù)據(jù)6.2.1.1 供貨主體信息(1) 接口ID ：21W01(2) 節(jié)點名稱：entInfo (3) 接口說明：用于供貨主體的數(shù)據(jù)寫入、更新。同一主鍵數(shù)據(jù),重復上傳,將更新該記錄數(shù)據(jù),只允許更新自己上傳的數(shù)據(jù)。(4) 寫入?yún)?shù)：序號中文名稱英文名稱長度備注1供貨主體類型entType1非空。CA0012供貨主體名稱entName300非空3供貨主體代碼entUnicode18"生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。"餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號舊證4食品經(jīng)營許可證號/餐飲許可證號orgNo325經(jīng)營場所busiPlace300供貨主體類型為企事業(yè)單位、自然人時,非空6經(jīng)營圍busiScope40007經(jīng)營起始時間busiStartDate14格式y(tǒng)yyyMMdd8經(jīng)營終止時間busiEndDate14格式y(tǒng)yyyMMdd9生產(chǎn)經(jīng)營類別entCategory1供貨主體類型為企事業(yè)單位、自然人時,非空。CA00210所屬行業(yè)industry128供貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA00311證照圖片licPic以附件方式上傳,文件大小不超過5M。法定代表人legal64供貨主體類型為企事業(yè)單位時,非空1213證件類型legalLicType214證件legalLicNo1815負責人principalName64供貨主體類型為企事業(yè)單位、境外企業(yè)時,非空16負責人手機principalMobile3217負責人固定principalTel3218負責人principalFax3219負責人證件principalLicNo1820負責人principalEmail6421所屬國家nation8非空。GB/T 265922所屬省行政區(qū)劃provinceAdminDivision8供貨主體類型為企事業(yè)單位、自然人時,非空。GB T226023所屬市行政區(qū)劃cityAdminDivision8供貨主體類型為企事業(yè)單位、自然人時,非空。GB T226024所屬區(qū)縣行政區(qū)劃areaAdminDivision8供貨主體類型為企事業(yè)單位、自然人時,非空。GB T226025所屬市場IDbelongMarket32主體所屬批發(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ù)：序號中文名稱英文名稱長度備注1銷貨主體類型entType1非空。CA0012銷貨主體名稱entName300非空3銷貨主體代碼entUnicode18"生產(chǎn)經(jīng)營類別"為"餐飲服務者"時。主體代碼與食品經(jīng)營許可證號/餐飲許可證號必須有一個不為空。企事業(yè)單位的主體代碼采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或。"餐飲服務者"可填寫食品經(jīng)營許可證號或餐飲許可證號舊證4食品經(jīng)營許可證號/餐飲許可證號orgNo325經(jīng)營場所busiPlace300銷貨主體類型為企事業(yè)單位、自然人時,非空6經(jīng)營圍busiScope40007經(jīng)營起始時間busiStartDate14格式y(tǒng)yyyMMdd8經(jīng)營終止時間busiEndDate14格式y(tǒng)yyyMMdd9生產(chǎn)經(jīng)營類別entCategory1銷貨主體類型為企事業(yè)單位、自然人時,非空。CA00210所屬行業(yè)industry128銷貨主體類型為企事業(yè)單位、自然人時,非空。多個所屬行業(yè)用逗號隔開。CA00311證照圖片licPic以附件方式上傳,文件大小不超過5M。12法定代表人legal64銷貨主體類型為企事業(yè)單位時,非空13證件類型legalLicType214證件legalLicNo1815負責人principalName64銷貨主體類型為企事業(yè)單位、境外企業(yè)時,非空16負責人手機principalMobile3217負責人固定principalTel3218負責人principalFax3219負責人證件principalLicNo1820負責人principalEmail6421所屬國家nation8非空。GB/T 265922所屬省行政區(qū)劃provinceAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226023所屬市行政區(qū)劃cityAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226024所屬區(qū)縣行政區(qū)劃areaAdminDivision8銷貨主體類型為企事業(yè)單位、自然人時,非空。GB T226025所屬市場IDbelongMarket32主體所屬批發(fā)市場ID或農(nóng)貿(mào)市場ID市場ID根據(jù)8.1.3章節(jié)獲取(5) 返回說明寫入成功返回成功標識,失敗則返回失敗標識及原因,具體返回格式詳見返回數(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主體名稱entName300非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體名稱2主體代碼entUnicode18非空。關聯(lián)生產(chǎn)經(jīng)營主體表主體代碼。法人采用統(tǒng)一社會信用代碼,自然人采用散戶代碼或3許可證類型licenseType1非空。CA0084許可證編號licenseNo32非空、唯一標識5發(fā)證日期licIssueDate14非空,格式y(tǒng)yyyMMdd6有效期至licValidEndDate14非空,格式y(tǒng)yyyMMdd7許可證圖片licensePic非空,以附件方式上傳,文件大小不超過5M。8備注remark300(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食品代碼productCode32非空。唯一標識2食品名稱productName256非空3食品