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

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