福建省“一品一碼”食品安全信息追溯管理平臺-食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范

《福建省“一品一碼”食品安全信息追溯管理平臺-食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范》由會員分享，可在線閱讀，更多相關(guān)《福建省“一品一碼”食品安全信息追溯管理平臺-食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范（54頁珍藏版）》請在裝配圖網(wǎng)上搜索。

福建省“一品一碼”食品安全追溯管理食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范福建省食品藥品監(jiān)督管理局二一八年九月食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范I目 錄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. 商品類型 .461.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ù)對接申請表 .52食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 1 頁，共 52 頁1. 接口設(shè)計1.1. 接口地址系統(tǒng)通過 Web Service 進行數(shù)據(jù)對接。數(shù)據(jù)對接測試環(huán)境地址：http:/110.85.58.153:5004/fdafst/webservice/dataReceive?wsdl數(shù)據(jù)對接正式環(huán)境地址：http:/120.35.29.61:8081/fdauser/webservice/dataReceive?wsdl1.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. 用戶身份認證接口調(diào)用方對接追溯系統(tǒng)前，需先進行身份認證。通過本接口認證成功后，將返回一個身份認證碼，該身份認證碼做為后續(xù)數(shù)據(jù)接口的認證參數(shù)。身份認證碼有效期 30 分鐘，身份認證碼過期后需要重新請求獲取。(1) 接口說明(2) 參數(shù)說明原型接口 public String getVerifyCode(string userAccount, string password)功能描述 業(yè)務(wù)系統(tǒng)的身份認證功能返回值 認證成功，返回身份認證碼，認證失敗，返回具體錯誤信息，詳情見 1.5參數(shù)名 參數(shù)說明 是否必填userAccount 用戶名（追溯系統(tǒng)的登錄賬號） 必填password 密碼（登錄賬號對應(yīng)的密碼） 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 2 頁，共 52 頁1.2.2. 數(shù)據(jù)推送接口追溯系統(tǒng)所有的備案數(shù)據(jù)、臺賬數(shù)據(jù)的推送統(tǒng)一通過本接口進行對接。接口說明如下：(1) 接口說明(2) 參數(shù)說明1.2.3. Catalogid 定義類別 catalogid 事項名稱15 原料供貨商信息16 銷售對象信息11 原料信息12 產(chǎn)品信息01 食品生產(chǎn)臺賬信息食品生產(chǎn)企業(yè)02 食品生產(chǎn)銷貨臺賬信息原型接口 public String pushData(String info, String catalogid, String format, String verifyCode ,String fileName, byte fileContent)功能描述 用于各企業(yè)將臺賬等數(shù)據(jù)匯聚到食藥監(jiān)追溯系統(tǒng)中。返回值 見 1.5參數(shù)名 參數(shù)說明 是否必填info 要推送的具體數(shù)據(jù)必填 必填Catalogid 目錄標(biāo)識，為每個對接事項分配一個唯一標(biāo)識，詳見 1.2.3 必填format 接口提供兩種數(shù)據(jù)類型的接收方式，xml 和 json 格式。 必填verifyCode 身份認證碼，通過 getVerifyCode()接口獲取，詳見 1.2.1 必填fileName 附件名稱數(shù)組 根據(jù)接口情況fileContent 附件內(nèi)容 根據(jù)接口情況食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 3 頁，共 52 頁類別 catalogid 事項名稱03 食品生產(chǎn)不合格產(chǎn)品處理臺賬04 食品生產(chǎn)不合格原料處理臺賬05 食品原料進貨臺賬信息17 供貨商信息18 經(jīng)銷商信息13 商品信息06 進貨臺帳信息07 銷貨臺帳信息08 退貨臺帳信息食品流通企業(yè)09 商品處理臺帳信息17 供貨商信息18 銷售對象信息13 商品信息06 進貨臺帳信息07 銷貨臺帳信息08 退貨臺帳信息餐飲（食堂）企業(yè)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ù)說明食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 4 頁，共 52 頁參數(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 字符型 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è)時必填非必填fstEntType 字符型 1企業(yè)類型，參照數(shù)據(jù)字典1.4.8必填belongMarket 字符型 32主體所屬批發(fā)市場 ID 或農(nóng)貿(mào)市場 ID根據(jù) 1.3.4.3 章節(jié)獲取非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 5 頁，共 52 頁(2) XML 格式企業(yè)名稱913501007173106xxx3501xxxxxxxx34856913x福州市保稅區(qū) xxxxxxxxx王某某 13799912312計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)2016-11-112021-11-11福建省福州市鼓樓區(qū)中國11(3) JSON 格式食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 6 頁，共 52 頁“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)“,“dom“:“福州市保稅區(qū) xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企業(yè)名稱 111“,“areaAdminDivisionValue“:“鼓樓區(qū)“,“contactsTel“:“13799912312“,“nation“:“中國“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主體所屬批發(fā)市場 ID 或農(nóng)貿(mào)市場 ID“注:各字段意思參見 xml 格式說明1.3.1.2. 銷售對象信息(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 字符型 64經(jīng)營起始時間，格式為yyyy-MM-dd非必填opEndDate 字符型 64經(jīng)營終止時間，格式為yyyy-MM-dd非必填provinceAdminDivisionValue字符型 8省級行政區(qū)劃，如：福建省必填cityAdminDivisionValue 字符型 8市級行政區(qū)劃，如：福州市必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 7 頁，共 52 頁(2) XML 格式企業(yè)名稱913501007173106xxx3501xxxxxxxx34856913x福州市保稅區(qū) xxxxxxxxx王某某 13799912312計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)2016-11-112021-11-11福建省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é)獲取非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 8 頁，共 52 頁福州市鼓樓區(qū)中國11(3) JSON 格式“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)“,“dom“:“福州市保稅區(qū) xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企業(yè)名稱 111“,“areaAdminDivisionValue“:“鼓樓區(qū)“,“contactsTel“:“13799912312“,“nation“:“中國“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主體所屬批發(fā)市場 ID 或農(nóng)貿(mào)市場 ID“注:各字段意思參見 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ì)期單位 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 9 頁，共 52 頁(2) XML 格式Y(jié)123442312312預(yù)包裝webservice 接口原料測試企業(yè)名稱1年330ml原料 瓶(3) JSON 格式“packingTypeName“:“預(yù)包裝“,“netContentUnit“:“ml“,“expiryDateNum“:1,“materialCategoryName“:“原料“,“minSalesUnit“:“瓶“,“expiryDateUnit“:“年“,“barCode“:“Y1112333123123“,“sellerIdName“:“企業(yè)名稱“,“netContent“:330,“productName“:“webservice 接口原料測試“注:各字段意思參見 xml 格式說明netContent 數(shù)字型 8 凈含量數(shù)值 非必填netContentUnit 字符型 64 凈含量單位 非必填materialCategoryName字符型 32 原料類型，參照數(shù)據(jù)字典 1.4.5 必填minSalesUnit 字符型 64 包裝形式，如箱，件，包等 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 10 頁，共 52 頁1.3.1.4. 產(chǎn)品信息(1) 參數(shù)說明(2) XML 格式Y(jié)123442312312webservice 接口產(chǎn)品測試1年規(guī)格參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填barCode 字符型 256條形碼，不填則由系統(tǒng)自動生成非必填productName 字符型 256 產(chǎn)品名稱 必填expiryDateNum 數(shù)字型 8 保質(zhì)期數(shù)值 必填expiryDateUnit 字符型 64 保質(zhì)期單位 必填specification 字符型 64 規(guī)格 必填packagingNum 字符型 32 內(nèi)含最小銷售單元數(shù)量 非必填packagingUnit 字符型 64 包裝計量單位 非必填minSalesUnit 字符型 64最小銷售單元，如箱，件，包等必填productCategoryName字符型 256商品類別，參照數(shù)據(jù)字典 1.4.7必填trademark 字符型 256 商標(biāo) 非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 11 頁，共 52 頁個水果制品商標(biāo)牌330ml1(3) JSON 格式“packagingNum“:“1“,“expiryDateNum“:1,“trademark“:“商標(biāo)牌“,“minSalesUnit“:“ 個“,“expiryDateUnit“:“年“,“specification“:“ 規(guī)格“,“productCategoryName“:“水果制品“,“barCode“:“Y123442312312“,“packagingUnit“:“330ml“,“productName“:“webservice 接口產(chǎn)品測試“注:各字段意思參見 xml 格式說明1.3.1.5. 食品生產(chǎn)臺賬信息(1) 參數(shù)說明(2) XML 格式福建老酒參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填productName 字符型 256 商品名稱 必填barCode 字符型 256 商品條碼 必填batch 字符型 64 批次 必填producedDate 字符型 32 生產(chǎn)日期 必填unit 字符型 64 單位 必填stockNum 字符型 16 生產(chǎn)數(shù)量 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 12 頁，共 52 頁100箱201611282016-11-286926032336334(3) JSON 格式“unit“:“箱“,“stockNum“:100,“batch“:“20161128“,“barCode“:“6926032336334“,“producedDate“:“2016-11-11“,“productName“:“福建老酒“ 注:各字段意思參見 xml 格式說明1.3.1.6. 食品生產(chǎn)銷貨臺賬信息(1) 參數(shù)說明(2) XML 格式參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填distributorName 字符型 256 分銷商名稱 必填salesDate 字符型 32銷貨日期，格式為yyyy-MM-dd必填productName 字符型 256 產(chǎn)品名稱 必填barCode 字符型 256 條碼 必填batch 字符型 64 批次 必填salesNum 數(shù)字型 16 銷售數(shù)量 必填producedDate 字符型 32生產(chǎn)日期，格式為yyyy-MM-dd必填salesDetailsunit 字符型 64 單位 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 13 頁，共 52 頁福建老酒692603233633420161128502016-11-30瓶福建老酒692603233633420161129502016-11-30瓶企業(yè)名稱2016-11-30(3) JSON 格式“salesDetails“:“unit“:“瓶“,“salesNum“:1000,“batch“:“201611312“,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“productName“:“福建老酒“,“salesDate“:“2016-11-28“,“distributorName“:“企業(yè)名稱“注:各字段意思參見 xml, salesDetails 為數(shù)組,salesDetails 為一個銷售單號單號下的對應(yīng)的銷售詳細信息，銷售單號由系統(tǒng)自動生成。食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 14 頁，共 52 頁1.3.1.7. 食品生產(chǎn)不合格產(chǎn)品處理臺賬(1) 參數(shù)說明(2) XML 格式達利園小面包Y160928090006201610082016-10-10千克12(3) JSON 格式參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填productName 字符型 256 商品名稱 必填barCode 字符型 256 商品條碼 必填batch 字符型 64 批次 必填producedDate 字符型 32 生產(chǎn)日期 必填unit 字符型 32 單位 必填unqualifiedNum 字符型 16 不合格數(shù)量 必填handleType 字符型 1處理類型，參照數(shù)據(jù)字典1.4.1必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 15 頁，共 52 頁“unit“:“單位“,“unqualifiedNum“:1,“batch“:“20161008“,“barCode“:“Y160928090006“,“producedDate“:“2016-10-10“,“productName“:“達利園小面包“,“handleType“:“3“注:各字段意思參見 model 或 xml1.3.1.8. 食品生產(chǎn)不合格原料處理臺賬(1) 參數(shù)說明(2) XML 格式泰國香米Y160928090006201610082016-10-10千克12參數(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 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 16 頁，共 52 頁(3) JSON 格式“unit“:“單位“,“unqualifiedNum“:1,“batch“:“20161010“,“barCode“:“Y161010150096“,“producedDate“:“2016-10-10“,“productName“:“達利園小面包“,“handleType“:“2“注:各字段意思參見 model 或 xml1.3.1.9. 食品原料進貨臺賬信息(1) 參數(shù)說明(2) XML 格式Y(jié)161010150096大神大神打撒測試原料供貨商 0923100參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填productName 字符型 256 商品名稱 必填barCode 字符型 256 商品條碼 必填supplyEntName 字符型 256 原料供貨商 必填stockDate 字符型 32進貨日期，格式為 yyyy-MM-ddbatch 字符型 64 批次 必填producedDate 字符型 32生產(chǎn)日期，格式為 yyyy-MM-dd必填unit 字符型 64 單位 必填stockNum 字符型 16 生產(chǎn)數(shù)量 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 17 頁，共 52 頁千克201610102016-10-102016-10-10(3) JSON 格式“unit“:“千克“,“stockNum“:100,“batch“:“20161010“,“barCode“:“Y161010150096“,“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ù)說明 是否必填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)營起始時間，格式為非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 18 頁，共 52 頁(2) XML 格式企業(yè)名稱913501007173106xxx3501xxxxxxxx34856913x福州市保稅區(qū) xxxxxxxxx王某某 yyyy-MM-ddopEndDate 字符型 32經(jīng)營終止時間，格式為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é)獲取非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 19 頁，共 52 頁13799912312計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)2016-11-112021-11-11福建省福州市鼓樓區(qū)中國11(3) JSON 格式“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)“,“dom“:“福州市保稅區(qū) xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企業(yè)名稱 111“,“areaAdminDivisionValue“:“鼓樓區(qū)“,“contactsTel“:“13799912312“,“nation“:“中國“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主體所屬批發(fā)市場 ID 或農(nóng)貿(mào)市場 ID“注:各字段意思參見 model 或 xml1.3.2.2. 經(jīng)銷商信息(1) 參數(shù)說明參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填fstEntName 字符型 256 企業(yè)名稱 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 20 頁，共 52 頁(2) XML 格式企業(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ū)劃，如：福建省必填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é)獲取非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 21 頁，共 52 頁913501007173106xxx3501xxxxxxxx34856913x福州市保稅區(qū) xxxxxxxxx王某某 13799912312計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)2016-11-112021-11-11福建省福州市鼓樓區(qū)中國11(3) JSON 格式“socialCreditUnicode“:“9135010071731xxx5L“,“opScope“:“計算機及網(wǎng)絡(luò)軟件的開發(fā)與服務(wù)“,“dom“:“福州市保稅區(qū) xxxxxxxx“,“provinceAdminDivisionValue“:“福建省“,“orgNo“:“orgNo11“,“fstEntName“:“企業(yè)名稱 111“,“areaAdminDivisionValue“:“鼓樓區(qū)“,“contactsTel“:“13799912312“,“nation“:“中國“,“cityAdminDivisionValue“:“福州市“,“fstEntType“:“1“,“contacts“:“王某某“,“dataType“:“1“,“opStartDate“:“2016-11-食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 22 頁，共 52 頁11“,“regNo“:“35xxxxx000071233“,“opEndDate“:“2021-11-11“,“belongMarket“:“主體所屬批發(fā)市場 ID 或農(nóng)貿(mào)市場 ID“注:各字段意思參見 xml1.3.2.3. 商品信息(1) 參數(shù)說明(2) XML 格式6922266444463webservice 接口商品測試參數(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)一社會信用代碼 非必填expiryDateNum 數(shù)字型 16 保質(zhì)期數(shù)值 必填expiryDateUnit 字符型 64 保質(zhì)期單位 必填specification 字符型 64 規(guī)格 必填minSalesUnit 字符型 32最小銷售單元，如箱，件，包等必填productCategoryName 字符型 64商品類別，參照數(shù)據(jù)字典1.4.7必填trademark 字符型 256 商標(biāo) 非必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 23 頁，共 52 頁省外商品企業(yè)名稱生產(chǎn)企業(yè)統(tǒng)一社會信用代碼1年規(guī)格個水果制品商標(biāo)牌(3) JSON 格式“placeTypeName“:“省外商品 “,“expiryDateNum“:1,“trademark“:“商標(biāo)牌“,“expiryDateUnit“:“年“,“minSalesUnit“:“個“,“specification“:“規(guī)格“,“barCode“:“6922266444463“,“sellerIdName“:“企業(yè)名稱“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productCategoryName“:“水果制品“,“productName“:“webservice 接口商品測試“注:各字段意思參見 xml1.3.2.4. 進貨臺賬信息(1) 參數(shù)說明參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填supplyEntName 字符型 256 供貨商名稱 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 24 頁，共 52 頁(2) XML 格式企業(yè)名稱2016-11-28福建老酒69260323363342016112810002016-11-28生產(chǎn)企業(yè)統(tǒng)一社會信用代碼stockDate 字符型 32進貨日期，格式為 yyyy-MM-dd必填productName 字符型 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)一社會信用代碼非必填stockDetailsunit 字符型 32 單位 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 25 頁，共 52 頁瓶福建老酒69260323363342016112910002016-11-2835XXXXXXXX瓶(3) JSON 格式“stockDetails“:“unit“:“瓶“,“stockNum“:1000,“batch“:“20161128“,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productName“:“福建老酒“,“unit“:“瓶“,“stockNum“:1000,“batch“:“20161129“,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productName“:“福建老酒“,“supplyEntName“:“企業(yè)名稱“,“stockDate“:“2016-11-28“注:各字段意思參見 model 或 xml1.3.2.5. 銷貨臺賬信息(1) 參數(shù)說明參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填distributorName 字符型 256 分銷商名稱 必填salesDate 字符型 32銷貨日期，格式為 yyyy-MM-dd必填productName 字符型 256 產(chǎn)品名稱 必填barCode 字符型 256 條碼 必填batch 字符型 64 批次 必填salesDetailssalesNum 數(shù)字型 16 銷售數(shù)量 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 26 頁，共 52 頁(2) XML 格式企業(yè)名稱2016-11-28福建老酒69260323363342016112810002016-11-28生產(chǎn)企業(yè)統(tǒng)一社會信用代碼瓶福建老酒6926032336334201611291000producedDate 字符型 32生產(chǎn)日期，格式為 yyyy-MM-dd必填socialCreditUnicode字符型 32生產(chǎn)企業(yè)統(tǒng)一社會信用代碼非必填unit 字符型 32 單位 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 27 頁，共 52 頁2016-11-2835XXXXXXX瓶(3) JSON 格式“salesDetails“:“unit“:“瓶“,“salesNum“:1000,“batch“:“20161128“,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productName“:“福建老酒“,“unit“:“瓶“,“salesNum“:1000,“batch“:“20161129“,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productName“:“福建老酒“,“salesDate“:“2016-11-28“,“distributorName“:“企業(yè)名稱“注:各字段意思參見 model 或 xml1.3.2.6. 退貨臺賬信息(1) 參數(shù)說明(2) XML 格式參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填productName 字符型 256 商品名稱 必填barCode 字符型 256 商品條碼 必填batch 字符型 64 批次 必填producedDate 字符型 32 生產(chǎn)日期 必填socialCreditUnicode字符型 32 生產(chǎn)企業(yè)統(tǒng)一社會信用代碼 非必填unit 字符型 32 單位 必填returnNum 字符型 16 退貨數(shù)量 必填食品生產(chǎn)經(jīng)營企業(yè)數(shù)據(jù)對接接口技術(shù)規(guī)范第 28 頁，共 52 頁福建老酒6926032336334201611282016-11-28生產(chǎn)企業(yè)統(tǒng)一社會信用代碼瓶100(3) JSON 格式“unit“:“瓶“,“batch“:“20161128“,“returnNum“:100,“barCode“:“6926032336334“,“producedDate“:“2016-11-28“,“socialCreditUnicode“:“生產(chǎn)企業(yè)統(tǒng)一社會信用代碼“,“productName“:“福建老酒“注:各字段意思參見 model 或 xml1.3.2.7. 商品處理臺帳信息(1) 參數(shù)說明參數(shù)名 參數(shù)類型 字段長度 參數(shù)說明 是否必填productName 字符型 256 商品名稱 必填barCode 字符型 256 商品條碼 必填batch 字符型 64 批次 必填producedDate 字符型 32 生產(chǎn)日期 必填socialCreditUnicode字符型 32 生產(chǎn)企業(yè)統(tǒng)一社會信用代碼 非必填unit 字符型 32 單位 必填returnNum 字符型 16 處理數(shù)量 必填