ICS65.020.99CCSB00T/YNZYC云南省中藥材種植養(yǎng)殖行業(yè)協(xié)會(huì)團(tuán)體標(biāo)準(zhǔn)YunnanProvincialTraceabilitySystemofTraditionalChineseMedicinalMaterialsIT/YNZYC0103—2023本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別這些專利的責(zé)任。本文件由云南省中藥材種植養(yǎng)殖行業(yè)協(xié)會(huì)提出并歸口。本文件起草單位：云南省中藥材種植養(yǎng)殖行業(yè)協(xié)會(huì)、云南省商務(wù)廳、云南鈺津供應(yīng)鏈科技有限公司本文件主要起草人：蘇豹、陳曉虹、張艷芳、呂秀田、丁劍、張雪、李艷、尹容梅、李學(xué)芬、胡倆劍、楊輝T/YNZYC0103—20232云南省中藥材追溯體系第3部分：數(shù)據(jù)接口規(guī)范本標(biāo)準(zhǔn)規(guī)定了云南省中藥材追溯體系的術(shù)語和定義、追溯數(shù)據(jù)接口的總體要求、接口類型、接口關(guān)系、接口基本功能和參數(shù)等內(nèi)容。本標(biāo)準(zhǔn)適用于構(gòu)建云南省中藥材追溯體系數(shù)據(jù)接口規(guī)范。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260中華人民共和國行政區(qū)劃代碼GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法GB/T38159重要產(chǎn)品追溯追溯體系通用要求中國藥典3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1主體碼subjectcode用于產(chǎn)品生產(chǎn)流通過程中識別主體身份的代碼。按照身份主體的不同，分為流通節(jié)點(diǎn)主體碼以及經(jīng)營者主體碼。4下列縮略語適用于本文件。HTTPS:超文本傳輸安全協(xié)議(HyperTextTransferProtocoloverSecureSocketLayer或HypertextTransferProtocolSecure)ID:標(biāo)識符(Identifier)JSON:輕量級的數(shù)據(jù)交換格式(JavaScriptObjectNotation)5中藥材追溯體系數(shù)據(jù)接口總體要求5.1通信協(xié)議應(yīng)采用符合IETFRFC2818規(guī)定的HTTPS協(xié)議作為底層承載協(xié)議。5.2接口描述接口命名使用通用的駝峰命名方式，接口文本描述語言采用通用的JSON格式。T/YNZYC0103—202335.3編碼字符集應(yīng)采用IETFRFC3629規(guī)定的UTF-8字符集。5.4數(shù)據(jù)類型中藥材追溯系統(tǒng)數(shù)據(jù)接口覆蓋所能支持?jǐn)?shù)據(jù)類型，包括：——字符串型（String）——數(shù)字型（Number）——時(shí)間型（Datetime）——對象型（Objeck）——數(shù)組型（Array）——布爾型（Boolean）——空（NULL）6中藥材追溯體系數(shù)據(jù)接口類型中藥材追溯系統(tǒng)數(shù)據(jù)接口主要包括下列類型：——主體信息類，包括但不限于主體信息類參數(shù)；——基地檔案類，包括但不限于基地基本信息、基地環(huán)境信息、基地操作人員、基地管理人員等；——追溯信息類，包括但不限于種源信息、種植信息、物料信息、采收信息、加工信息、倉儲(chǔ)信息、銷售信息、運(yùn)輸信息等；——資料信息類，包括但不限于資料數(shù)據(jù)類。7中藥材追溯體系數(shù)據(jù)接口關(guān)系圖1中藥材追溯體系數(shù)據(jù)接口關(guān)系圖8中藥材追溯體系數(shù)據(jù)接口基本功能和參數(shù)T/YNZYC0103—202348.1主體信息類接口8.1.1功能用于監(jiān)管平臺(tái)查詢企業(yè)基本備案信息。8.1.2參數(shù)主體信息類參數(shù)見表1。稱Unif_soci_cred_code---具體到省、市、區(qū)、鄉(xiāng)Account_opening_app8.2基地檔案類接口8.2.1功能用于監(jiān)管平臺(tái)查詢企業(yè)基地基本信息。8.2.2基地基本信息1)請求參數(shù)基地基本信息請求參數(shù)應(yīng)符合表2的規(guī)定。-Number-Number52)響應(yīng)參數(shù)基地基本信息響應(yīng)參數(shù)應(yīng)符合表3的規(guī)定。Number-Number8.2.3基地環(huán)境信息3)請求參數(shù)基地環(huán)境信息請求參數(shù)應(yīng)符合表4的規(guī)定。baseCode-4)響應(yīng)參數(shù)基地環(huán)境信息響應(yīng)參數(shù)應(yīng)符合表5的規(guī)定。baseCode-Number---phValuepH值-Number----Number------picUrl-picCode-8.2.4基地操作人員信息5)請求參數(shù)基地操作人員信息請求參數(shù)應(yīng)符合表6的規(guī)定。T/YNZYC0103—20236baseCode--Number-phone-Number6)響應(yīng)參數(shù)基地操作人員信息響應(yīng)參數(shù)應(yīng)符合表7的規(guī)定。Number-Number8.2.5基地管理人員信息7)請求參數(shù)基地管理人員信息請求參數(shù)應(yīng)符合表8的規(guī)定。-phone-8)響應(yīng)參數(shù)基地管理人員信息響應(yīng)參數(shù)應(yīng)符合表9的規(guī)定。Number-Number8.3追溯信息類接口T/YNZYC0103—202378.3.1功能用于監(jiān)管平臺(tái)查詢企業(yè)追溯基本信息，不限于種源信息、種植信息、采收信息、加工信息、監(jiān)測信息、銷售信息、倉儲(chǔ)信息、運(yùn)輸信息等。8.3.2種源信息9)請求參數(shù)種源信息請求參數(shù)應(yīng)符合表10的規(guī)定。baseCode----patternNumber他NumberprovenanceCode-10)響應(yīng)參數(shù)種源信息響應(yīng)參數(shù)應(yīng)符合表11的規(guī)定。Number-Number8.3.3種植信息11)請求參數(shù)種植信息請求參數(shù)應(yīng)符合表12-13的規(guī)定。plantationCode-Number8--baseOperatorIdNumber-picUrl-12)響應(yīng)參數(shù)種植信息響應(yīng)參數(shù)應(yīng)符合表14-15的規(guī)定。Number-plantationMission--NumberNumber-Number8.3.4物料信息13)請求參數(shù)物料信息請求參數(shù)應(yīng)符合表16的規(guī)定。--Number-province-市-區(qū)-baseCode-T/YNZYC0103—20239-14)響應(yīng)參數(shù)物料信息響應(yīng)參數(shù)應(yīng)符合表17的規(guī)定。Number-Number8.3.5采收信息15)請求參數(shù)采收信息請求參數(shù)應(yīng)符合表18-19的規(guī)定。processDictIdNumber-Number-baseCode-baseCode-recoveryCode--baseOperatorId-picUrlNumberNumberbaseCode-Number-baseCode-recoveryCode-baseOperatorIdpicUrl16)響應(yīng)參數(shù)采收信息請求參數(shù)應(yīng)符合表22的規(guī)定。Number-Number8.3.6加工信息17)請求參數(shù)加工信息請求參數(shù)應(yīng)符合表23-24的規(guī)定。--Number--18)響應(yīng)參數(shù)加工信息響應(yīng)參數(shù)應(yīng)符合表25的規(guī)定。Number-Number8.3.7倉儲(chǔ)信息19)請求參數(shù)倉儲(chǔ)信息請求參數(shù)應(yīng)符合表26-28的規(guī)定。------Number-Number-Number-Number--Number20)響應(yīng)參數(shù)倉儲(chǔ)信息響應(yīng)參數(shù)應(yīng)符合表29的規(guī)定。Number-Number8.3.8銷售信息21)請求參數(shù)銷售信息請求參數(shù)應(yīng)符合表30的規(guī)定。Number貨Number-22)響應(yīng)參數(shù)銷售信息響應(yīng)參數(shù)應(yīng)符合表31的規(guī)定。Number-Number8.3.9運(yùn)輸信息23)請