Zdroj FHIR pro pacienta vysvětlen: identifikátory, jména, demografické údaje a vazby, s platným příkladem

Krátká odpověď: Patient je FHIR zdroj, který popisuje osobu, která přijímá péči: kdo je administrativně, nikoli co jí je. Obsahuje identifikátory (čísla lékařských záznamů, národní ID), jména, kontaktní údaje (telecom), administrativní pohlaví (gender), datum narození (birthDate), adresu (address), rodinný stav (maritalStatus), komunikaci (jazyky), praktického lékaře (generalPractitioner), řídící organizaci (managingOrganization) a odkazy na jiné záznamy typu Patient pro stejnou osobu. Každá Observation, Condition, Encounter nebo MedicationStatement na něj odkazuje prostřednictvím subject nebo patient. Klinická fakta nikdy nežijí v Patient; žijí ve zdrojích, které na něj odkazují.

Platný příklad FHIR R4

Platný FHIR R4 zdroj typu Patient potřebuje pouze resourceType, ale v praxi obsahuje alespoň jeden identifikátor se systémem a hodnotou, jméno s částmi family a given, administrativní pohlaví a datum narození. Níže uvedený příklad také deklaruje profil IPS Patient v meta.profile a přidává kontaktní údaje (telecom), adresu (address), preferovaný jazyk (preferred language), praktického lékaře (general practitioner) a řídící organizaci (managing organisation).

{
  "resourceType": "Patient",
  "id": "example",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Patient-uv-ips"]},
  "identifier": [{
    "use": "usual",
    "type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0203", "code": "MR"}]},
    "system": "https://hospital.example.org/mrn",
    "value": "MRN-00012345"
  }],
  "active": true,
  "name": [{"use": "official", "family": "Doe", "given": ["Jane", "Marie"], "prefix": ["Ms"]}],
  "telecom": [{"system": "email", "value": "[email protected]", "use": "home"}],
  "gender": "female",
  "birthDate": "1980-05-23",
  "address": [{"use": "home", "line": ["12 High Street"], "city": "Leeds", "postalCode": "LS1 4AB", "country": "GB"}],
  "communication": [{"language": {"coding": [{"system": "urn:ietf:bcp:47", "code": "en-GB"}]}, "preferred": true}],
  "generalPractitioner": [{"reference": "Practitioner/gp-42"}],
  "managingOrganization": {"reference": "Organization/hospital"}
}

Důležité prvky

Prvky Patient, které jsou pro interoperabilitu nejdůležitější, jsou identifier (se systémem, hodnotou a typem), name (s použitím, rodinou a danými částmi), administrativeGender, birthDate, deceased, active, contact a link. Identifikátory a jména řídí párování mezi systémy, pohlaví a datum narození jsou administrativní fakta a link zaznamenává, jak hlavní rejstřík pacientů propojuje duplicitní záznamy jedné osoby.

• identifier je seznam, každý s system (kdo jej vydal) a value. type říká, o jaký typ jde: MR číslo lékařského záznamu, NI národní identifikátor, PPN pas, SS číslo sociálního zabezpečení, z tabulky HL7 0203. Pacient jich obvykle má několik; MRN nemocnice a národní ID jsou oba platné a systémy se na ně shodují.
• name je také seznam s use: official (oficiální), usual (obvyklé), nickname (přezdívka), maiden (dívčí), old (staré). family je jeden řetězec; given je seznam. Skripty, transliterace a pořadí jmen jsou ponechány na implementačním průvodci dané země.
• gender je administrativní pohlaví se čtyřmi hodnotami: male (muž), female (žena), other (jiné), unknown (neznámé). Je to to, co záznam uvádí, používá se pro shodu a formuláře. Klinické pohlaví, genderová identita a zájmena jdou do rozšíření (extensions) nebo do Observation, které FHIR R5 a projekt Gender Harmony formalizovaly.
• birthDate je datum, volitelně pouze rok nebo rok a měsíc, pokud přesné datum není známo. Rozšíření patient-birthTime přidává čas pro novorozence.
• deceased[x] je boolean nebo datum a čas. active false označuje záznam, který by již neměl být používán (duplicitní, přesunutý), aniž by byl smazán.
• contact seznamy osob, se kterými lze kontaktovat (nejbližší příbuzný, opatrovník), s kódem vztahu; samy o sobě nejsou zdroji typu Patient. Rodič, který je zároveň pacientem, je RelatedPerson odkazující na oba.
• link propojuje záznamy typu Patient, které se týkají stejné osoby: replaced-by a replaces po sloučení, refer na autoritativní záznam, seealso pro záznam v jiném systému. Takto master patient index vyjadřuje svá rozhodnutí ve FHIR; viz Shoda pacientů.

Co přidávají národní profily

Národní a mezinárodní profily FHIR proměňují volně definovaný základní zdroj Patient na něco použitelného tím, že některé prvky činí povinnými a přidávají rozšíření specifická pro danou zemi. US Core vyžaduje identifier, name a gender a přidává rozšíření pro rasu (race), etnický původ (ethnicity) a biologické pohlaví (birth sex); profil IPS Patient vyžaduje name, gender a birthDate; národní profily definují systémy identifikátorů a formáty adres.

Základní zdroj činí téměř vše volitelným. Profily jej činí použitelným:

Záznam, který bude překračovat hranice, musí splňovat profil na obou stranách, což v praxi znamená nesení národního identifikátoru i MRN, plného oficiálního jména a kompletního data narození. Viz Implementační průvodci FHIR.

Operace, které budete používat

Operace FHIR, které se s Patient používají nejčastěji, jsou vyhledávání podle identifikátoru nebo demografických údajů (GET /Patient s parametry identifier, family nebo birthdate), operace $everything, která vrací pacienta a všechny zdroje, které na něj odkazují, a $match, která se ptá algoritmu párování serveru na pravděpodobné duplicity. Operace $merge se standardizuje ve FHIR R5.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 najde pacienta podle identifikátoru; ?family=doe&birthdate=1980-05-23 podle demografických údajů.
• GET /Patient/{id}/$everything vrátí pacienta a všechny zdroje, které na něj odkazují, stránkované, což je způsob, jakým se exportuje celý záznam.
• $match (kde je podporováno) požádá serverový algoritmus shody o pravděpodobné duplikáty; $merge je standardizováno v R5.

Chyby, které narušují záznamy pacientů

Chyby, které nejčastěji narušují záznamy FHIR Patient, jsou ukládání národního ID do resource id místo do identifier, vynechání identifier.system, takže se hodnoty z různých nemocnic srážejí, vkládání celého jména do textu bez částí family a given, použití administrativního pohlaví pro klinické pohlaví a úprava sloučeného záznamu na místě místo jeho propojení a deaktivace.

• Umístění národního ID do id. id zdroje patří serveru a může se při importu změnit; identifikátory patří do identifier.
• Jedno name se vším v text a bez family/given, takže vyhledávání podle příjmení selže.
• gender použitý pro klinické pohlaví, nebo nastavený na unknown, protože formulář neměl pole.
• Chybějící identifier.system, takže hodnoty MRN-1 dvou nemocnic kolidují.
• Úprava Patient na místě, když došlo ke sloučení, místo propojení a deaktivace.

V Anpheros

Anpheros reprezentuje každou osobu, držitele účtu a každý rodinný profil, jako zdroj FHIR Patient na Anpheros Platform, a každý záznam, který klinika přidá přes API, odkazuje na tento Patient. Identifikátory kliniky jsou uchovávány jako další identifikátory s vlastním systémem kliniky a demografické údaje, které osoba zadá, zůstávají administrativními daty, z nichž se nic klinického nevyvozuje.

Když klinika odešle svůj vlastní identifikátor, je uložen jako další identifier se systémem kliniky, takže stejnou osobu lze najít z obou stran. Demografické údaje, které osoba zadala v aplikaci, jsou usual jméno a administrativní údaje; záznam z nich nikdy nic klinického nevyvozuje.

Související stránky

• Shoda pacientů a master patient index
• Implementační průvodci FHIR
• FHIR Encounter vysvětleno
• FHIR Condition vysvětleno
• Vyhledávání FHIR vysvětleno
• Příklad Pacienta na vývojářském webu

Zdroje

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• HL7 Terminology: kódy typů identifikátorů (v2-0203)
• HL7 US Core: Profil Pacienta
• HL7 IPS: Profil Pacienta

Časté otázky

Je Patient totéž co Person ve FHIR?

Ne. Person je administrativní zdroj, který propojuje stejnou lidskou bytost v různých rolích (zde Patient, tam Practitioner, jinde RelatedPerson). Klinické zdroje odkazují na Patient, nikdy na Person.

Kam jdou alergie a stavy?

Do zdrojů AllergyIntolerance a Condition, které odkazují na Patient. Patient sám obsahuje pouze administrativní údaje.

Jak zaznamenám novorozence bez jména?

Se jménem, jehož použití je temporary (dočasné) nebo prázdné, birthDate s rozšířením patient-birthTime a link na záznam matky prostřednictvím RelatedPerson nebo rozšíření patient-mothersMaidenName, jak specifikují národní profily.

Může jeden zdroj Patient sdílet více nemocnic?

Každý systém si udržuje svůj vlastní zdroj Patient s vlastním id; sdílejí identifikátory (národní ID) a mohou záznamy propojovat. Shoda mezi systémy je úkolem master patient indexu, nikoli zdroje.

Anpheros Platform

Vyzkoušejte zdarma v sandboxu

První volání FHIR za 5 minut. API standardu HL7 FHIR R4 s integrovaným souhlasem pacienta: vyzkoušejte si ho v sandboxu a poté propojte svou vlastní aplikaci nebo klinický systém.

Vytvořit sandbox zdarmaPřečíst návody pro vývojáře →

Zdarma · 30 syntetických pacientů · bez karty

Napsal

Tým Anpheros

Anpheros vytváří zdravotní záznamy, které pacient ovládá a může sdílet s jakoukoli klinikou, na platformě HL7 FHIR R4 se sídlem v EU. Tyto průvodce vám pomohou porozumět vašemu zdraví a uspořádat si ho; nenahrazují vašeho lékaře.

O Anpheros →