2022醫(yī)療器械唯-標(biāo)識(shí)數(shù)據(jù)接口規(guī)范

醫(yī)療器械唯一標(biāo)識(shí)數(shù)據(jù)接口規(guī)范目 次前言 II引言 III1圍 12范引文件 13語定義 14略語 25據(jù)口明 2身認(rèn)要求 2接傳要求 2接調(diào)流程 26據(jù)用口 3憑據(jù)Token用口 3醫(yī)機(jī)數(shù)調(diào)口 3供商據(jù)用口 5生制商據(jù)接口 6IPAGEPAGE1PAGE2醫(yī)療器械唯一標(biāo)識(shí)數(shù)據(jù)接口規(guī)范范圍本文件規(guī)定了“深圳市醫(yī)療器械唯一標(biāo)識(shí)（UDI）追溯平臺(tái)”與第三方（包括醫(yī)療機(jī)構(gòu)、供應(yīng)商、生產(chǎn)制造商等）系統(tǒng)之間進(jìn)行數(shù)據(jù)交換的接口方法和調(diào)用說明。本文件適用于“深圳市醫(yī)療器械唯一標(biāo)識(shí)（UDI）追溯平臺(tái)”與第三方各信息系統(tǒng)間的數(shù)據(jù)對(duì)接。（GB/T16986—2018商品條碼應(yīng)用標(biāo)識(shí)符YY/T1681—2019醫(yī)療器械唯一標(biāo)識(shí)系統(tǒng)基礎(chǔ)術(shù)語YY/T1681—2019、GB/T16986—2018界定的以及下列術(shù)語和定義適用于本文件。3.1療械一識(shí) uniquedeviceidentifier在醫(yī)療器械產(chǎn)品或者包裝上附載的，由數(shù)字、字母或者符號(hào)組成的代碼，用于對(duì)醫(yī)療器械進(jìn)行唯一性識(shí)別。注1：“唯一”一詞并不意味著對(duì)單個(gè)產(chǎn)品進(jìn)行序列化管理。注2：用于醫(yī)療器械產(chǎn)品的管理和追溯等。[來源：YY/T1681—2019，3.1，有修改]3.2品識(shí) deviceidentifier特定于某種規(guī)格型號(hào)和包裝的醫(yī)療器械唯一性代碼。注：產(chǎn)品標(biāo)識(shí)用作對(duì)醫(yī)療器械唯一標(biāo)識(shí)數(shù)據(jù)庫存儲(chǔ)信息的“訪問關(guān)鍵字”，關(guān)聯(lián)醫(yī)療器械產(chǎn)品信息、制造商信息、注冊(cè)信息等。[來源：YY/T1681—2019，3.2，有修改]3.3產(chǎn)識(shí) productionidentifier識(shí)別醫(yī)療器械生產(chǎn)過程相關(guān)數(shù)據(jù)的代碼。注：生產(chǎn)標(biāo)識(shí)包含醫(yī)療器械序列號(hào)、生產(chǎn)批號(hào)、生產(chǎn)日期、失效日期等。[來源：YY/T1681—2019，3.3，有修改]3.4用識(shí)符 applicationidentifier用2-4位數(shù)字來表示特定代碼含義與格式的字符。注：01代表產(chǎn)品標(biāo)識(shí)，11代表生產(chǎn)日期，17代表失效日期，10代表批次，21代表序列號(hào)等。[來源：GB/T16986—2018，3.1，有修改]3.5據(jù)口 datainterface計(jì)算機(jī)軟件系統(tǒng)之間傳送數(shù)據(jù)、交換信息的接口，以電子文件的形式實(shí)現(xiàn)?？s略語AI：應(yīng)用標(biāo)識(shí)符（ApplicationIdentifier）JSON：JavaScript對(duì)象表示法（JavascriptObjectNotation）UDI：醫(yī)療器械唯一標(biāo)識(shí)（UniqueDeviceIdentifier）UDI-DI：產(chǎn)品標(biāo)識(shí)（UniqueDeviceIdentifier-DeviceIdentifier）UDI-PI：生產(chǎn)標(biāo)識(shí)（UniqueDeviceIdentifier-ProductionIdentifier）調(diào)用方需申請(qǐng)對(duì)應(yīng)的應(yīng)用唯一碼和應(yīng)用私鑰。接口使用JSON傳輸數(shù)據(jù)，具備通用性和可擴(kuò)展性。（UDI）1圖1 接調(diào)流圖Token接口說明如下：\h/udi/api/api/GetToken；GET；GetToken接口調(diào)用憑據(jù)Token調(diào)用接口輸入?yún)?shù)及說明見表1。表1 憑據(jù)Token調(diào)接輸參數(shù)說明輸入?yún)?shù)是否非空說明appId是應(yīng)用唯一碼appSecret是應(yīng)用私鑰接口調(diào)用憑據(jù)Token調(diào)用接口返回參數(shù)及說明見表2。表2 憑據(jù)Token調(diào)接返參數(shù)說明返回參數(shù)是否非空說明datasuccess是調(diào)用結(jié)果，若為true，表示成功；若為false，表示失敗message是提示信息code是成功則返回代碼0；失敗則返回錯(cuò)誤碼result是授權(quán)訪問令牌Tokentimestamp是時(shí)間戳接口說明如下：/udi/api/api/SyncDataHis；POST；SyncDataHis同步醫(yī)療機(jī)構(gòu)醫(yī)療器械使用數(shù)據(jù)，調(diào)用接口輸入?yún)?shù)及說明見表3。表3 醫(yī)療構(gòu)據(jù)用口入?yún)⒓懊鬏斎雲(yún)?shù)是否非空說明Headers是授權(quán)訪問令牌Token（X-Access-Token）BodyuserCertNo是患者證件號(hào)（患者住院號(hào)或就診號(hào)等）isEmbeddedMedical是/01表示，其它（含設(shè)備等）用2表示materialMedicalCode否耗材醫(yī)保編碼materialGtin是耗材唯一標(biāo)識(shí)（UD-IAI01）produceDate是生產(chǎn)日期，對(duì)應(yīng)UDI-PI中AI（11）信息expireDate是失效日期，對(duì)應(yīng)UDI-PI中AI（17）信息materialBatchNo是生產(chǎn)批號(hào)，對(duì)應(yīng)UDI-PI中AI（10）信息materialNo否序列號(hào)，對(duì)應(yīng)UDI-PI中AI（21）信息defineName是產(chǎn)品名稱defineContent是產(chǎn)品規(guī)格defineType是產(chǎn)品型號(hào)manfactureName是產(chǎn)品生產(chǎn)企業(yè)名稱，多個(gè)企業(yè)以分號(hào)；分隔registerCertNo是醫(yī)療器械注冊(cè)證號(hào)supplierName是產(chǎn)品經(jīng)銷/代理企業(yè)名稱，多個(gè)企業(yè)以分號(hào)；分隔useTime否院內(nèi)使用時(shí)間，YYYY-MM-DDHH:MM:SSuseNumber是院內(nèi)使用數(shù)量sectionOffice否使用科室hospitalName是醫(yī)院名稱注：醫(yī)療機(jī)構(gòu)根據(jù)實(shí)際，因原始標(biāo)簽信息缺失不全（如：耗材分類、耗材醫(yī)保編碼等）造成的必傳參數(shù)無法帶值上傳的，由UDI追溯管理后臺(tái)按系統(tǒng)默認(rèn)值處理。同步醫(yī)療機(jī)構(gòu)使用數(shù)據(jù)，調(diào)用接口返回參數(shù)及說明見表4。表4 醫(yī)療構(gòu)據(jù)用口回參及明返回參數(shù)是否非空說明datasuccess是調(diào)用結(jié)果，若為true，表示成功；若為false，表示失敗message是提示信息code是成功則返回代碼0；失敗則返回錯(cuò)誤碼result是返回結(jié)果信息timestamp是時(shí)間戳接口說明如下：POST；SyncDataSupply同步供應(yīng)商數(shù)據(jù)，調(diào)用接口輸入?yún)?shù)及說明見表5。表5 供應(yīng)數(shù)調(diào)接輸參數(shù)說明輸入?yún)?shù)是否非空說明Headers是授權(quán)訪問令牌Token（X-Access-Token）BodyisEmbeddedMedical是耗材分類：植入/01表示，其它（含設(shè)備等）用2表示materialMedicalCode否耗材醫(yī)保編碼productCode否產(chǎn)品碼（集采平臺(tái)用）specificationCode否規(guī)格型號(hào)碼（集采平臺(tái)用）orderSN否訂單號(hào)（集采平臺(tái)用）materialGtin是耗材唯一標(biāo)識(shí)（UD-IAI01）produceDate是生產(chǎn)日期，對(duì)應(yīng)UDI-PI中AI（11）信息expireDate是失效日期，對(duì)應(yīng)UDI-PI中AI（17）信息materialBatchNo是生產(chǎn)批號(hào)，對(duì)應(yīng)UDI-PI中AI（10）信息materialNo否序列號(hào)，對(duì)應(yīng)UDI-PI中AI（21）信息defineName是產(chǎn)品名稱defineContent是產(chǎn)品規(guī)格defineType是產(chǎn)品型號(hào)manfactureName是產(chǎn)品生產(chǎn)企業(yè)名稱，多個(gè)企業(yè)以分號(hào)；分隔registerCertNo是醫(yī)療器械注冊(cè)證號(hào)supplierName是產(chǎn)品經(jīng)銷/代理企業(yè)名稱hospitalName否供應(yīng)醫(yī)院名稱，多個(gè)醫(yī)院以分號(hào)；分隔注：供應(yīng)商根據(jù)實(shí)際，因原始標(biāo)簽信息缺失不全（如：生產(chǎn)日期、失效日期等）造成的必傳參數(shù)無法帶值上傳的，由UDI追溯管理后臺(tái)按系統(tǒng)默認(rèn)值處理。同步供應(yīng)商數(shù)據(jù)，調(diào)用接口返回參數(shù)及說明見表6。表6 供應(yīng)數(shù)調(diào)接返參數(shù)說明返回參數(shù)是否非空說明datasuccess是調(diào)用結(jié)果，若為true，表示成功；若為false，表示失敗message是提示信息code是成功則返回代碼0；失敗則返回錯(cuò)誤碼result是返回結(jié)果信息timestamp是時(shí)間戳接口說明如下：/udi/api/api/SyncDataProduce；POST；SyncDataProduce同步生產(chǎn)制造商數(shù)據(jù)，調(diào)用接口輸入?yún)?shù)及說明見表7。表7 生產(chǎn)造數(shù)調(diào)接輸入數(shù)說明輸入?yún)?shù)是否非空說明Headers是授權(quán)訪問令牌Token（X-Access-Token）BodyisEmbeddedMedical是/01表示，其它（含設(shè)備等）用2表示materialMedicalCode否耗材醫(yī)保編碼materialGtin是耗材唯一標(biāo)識(shí)（UD-IAI01）produceDate是生產(chǎn)日期，對(duì)應(yīng)UDI-PI中AI（11）信息expireDate是失效日期，對(duì)應(yīng)UDI-PI中AI（17）信息materialBatchNo是生產(chǎn)批號(hào)，對(duì)應(yīng)UDI-PI中AI（10）信息materialNo否序列號(hào)，對(duì)應(yīng)UDI-PI中AI（21）信息defineName是產(chǎn)品名稱defineContent是產(chǎn)品規(guī)格defineType是產(chǎn)品型號(hào)manfactureName是產(chǎn)品生產(chǎn)企業(yè)名稱registerCertNo是醫(yī)療器械注冊(cè)證號(hào)supplierNa