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

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