Resursa FHIR Pacient explicată: identificatori, nume, demografie și legături, cu un exemplu valid

Răspuns scurt: Patient este resursa FHIR care descrie o persoană care primește îngrijiri: cine este administrativ, nu ce probleme are. Aceasta conține identificatori (numere de dosar medical, acte de identitate naționale), nume, contacte telecom, genul administrativ, data nașterii, adresa, starea civilă, comunicarea (limbi), un medic de familie, o organizație gestionară și legături către alte înregistrări de tip Patient pentru aceeași persoană. Fiecare Observation, Condition, Encounter sau MedicationStatement face referire la aceasta prin subject sau patient. Faptele clinice nu se află niciodată în Patient; ele se află în resursele care indică spre acesta.

Un exemplu valid FHIR R4

O resursă FHIR R4 Patient validă necesită doar resourceType, dar în practică include cel puțin un identificator cu un sistem și o valoare, un nume cu părțile de familie și prenume, un gen administrativ și o dată de naștere. Exemplul de mai jos revendică, de asemenea, profilul IPS Patient în meta.profile și adaugă informații de contact, adresă, limbă preferată, medic de familie și organizația gestionară.

{
  "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"}
}

Elementele importante

Elementele Patient care contează cel mai mult pentru interoperabilitate sunt identificatorul (cu sistem, valoare și tip), numele (cu utilizare, familie și prenume), genul administrativ, data nașterii (birthDate), decesul (deceased), starea activă (active), contactul (contact) și legătura (link). Identificatoarele și numele determină potrivirea între sisteme, genul și data nașterii sunt fapte administrative, iar link înregistrează cum un index central al pacienților a conectat înregistrări duplicate ale unei persoane.

• identifier este o listă, fiecare cu un system (cine l-a emis) și o value. type indică ce fel de identificator este: MR număr de dosar medical, NI identificator național, PPN pașaport, SS număr de securitate socială, din tabelul HL7 0203. Un pacient are de obicei mai mulți; numărul de dosar medical al unui spital și un act de identitate național sunt ambele valide, iar sistemele se potrivesc pe baza lor.
• name este, de asemenea, o listă cu un use: official, usual, nickname, maiden, old. family este un singur șir de caractere; given este o listă. Scripturile, transliterările și ordinea numelor sunt lăsate la ghidul de implementare al țării.
• gender este genul administrativ cu patru valori: male, female, other, unknown. Este ceea ce spune înregistrarea, utilizat pentru potrivire și formulare. Sexul clinic, identitatea de gen și pronumele se regăsesc în extensii sau în Observații, pe care FHIR R5 și proiectul Gender Harmony le-au formalizat.
• birthDate este o dată, opțional doar anul sau anul-luna atunci când data exactă este necunoscută. O extensie patient-birthTime adaugă ora pentru nou-născuți.
• deceased[x] este un boolean sau o dată-oră. active false marchează o înregistrare care nu mai ar trebui utilizată (duplicat, mutat), fără a o șterge.
• contact listează persoanele de contact (rude apropiate, tutore), cu un cod de relație; acestea nu sunt resurse Patient în sine. Un părinte care este și pacient este un RelatedPerson care indică spre ambele.
• link conectează înregistrările Patient care aparțin aceleiași persoane: replaced-by și replaces după o fuziune, refer către înregistrarea autoritară, seealso pentru o înregistrare dintr-un alt sistem. Acesta este modul în care un index master de pacienți își exprimă deciziile în FHIR; vezi Potrivirea pacienților.

Ce adaugă profilurile naționale

Profilurile FHIR naționale și internaționale transformă resursa de bază Patient, definită vag, într-una utilizabilă, făcând elementele obligatorii și adăugând extensii specifice țării. US Core necesită identificator, nume și gen și adaugă extensii pentru rasă, etnie și sex la naștere; profilul IPS Patient necesită nume, gen și data nașterii; profilurile naționale definesc sistemele de identificare și formatele adreselor.

Resursa de bază face aproape totul opțional. Profilurile o fac utilizabilă:

O înregistrare care va traversa o graniță trebuie să satisfacă profilul de pe fiecare parte, ceea ce în practică înseamnă să conțină atât identificatorul național, cât și un MRN, un nume oficial complet și o dată de naștere completă. Vezi Ghiduri de implementare FHIR.

Operațiuni pe care le veți utiliza

Operațiunile FHIR cel mai des utilizate cu Patient sunt căutarea după identificator sau după demografie (GET /Patient cu parametri de identificator, familie sau dată de naștere), operațiunea $everything, care returnează pacientul și fiecare resursă care face referire la el, și $match, care solicită algoritmului de potrivire al serverului posibile duplicate. O operațiune $merge este în curs de standardizare în FHIR R5.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 găsește un pacient după identificator; ?family=doe&birthdate=1980-05-23 după demografice.
• GET /Patient/{id}/$everything returnează pacientul și toate resursele care fac referire la acesta, paginat, ceea ce reprezintă modul în care o înregistrare completă este exportată.
• $match (acolo unde este suportat) solicită algoritmului de potrivire al serverului duplicări probabile; $merge este în curs de standardizare în R5.

Greșeli care strică înregistrările pacienților

Greșelile care cel mai des strică înregistrările FHIR Patient sunt stocarea unui ID național în resource id în loc de identifier, omiterea identifier.system astfel încât valorile de la spitale diferite să se ciocnească, introducerea numelui complet în text fără părțile de familie și prenume, utilizarea genului administrativ pentru sexul clinic și editarea unei înregistrări combinate în loc să o legați și să o dezactivați.

• Punerea ID-ului național în id. id-ul resursei aparține serverului și se poate schimba la import; identificatorii aparțin identifier.
• Un singur name cu totul în text și fără family/given, astfel încât căutările după numele de familie eșuează.
• gender utilizat pentru sexul clinic sau setat la unknown deoarece formularul nu avea câmpul respectiv.
• Lipsa identifier.system, astfel încât valorile MRN-1 de la două spitale intră în conflict.
• Editarea unui Patient în loc atunci când a avut loc o fuziune, în loc de a lega și dezactiva.

În Anpheros

Anpheros reprezintă fiecare persoană, deținătorul contului și fiecare profil de familie, ca o resursă FHIR Patient pe Anpheros Platform, iar fiecare înregistrare pe care o adaugă o clinică prin API face referire la acel Patient. Identificatoarele clinicii sunt păstrate ca identificatori suplimentari cu propriul sistem al clinicii, iar demografia pe care o introduce o persoană rămâne dată administrativă din care nu se inferă nimic clinic.

Când o clinică trimite propriul identificator, acesta este stocat ca un identifier suplimentar cu sistemul clinicii, astfel încât aceeași persoană poate fi găsită din ambele părți. Demografia pe care persoana a introdus-o în aplicație este numele usual și date administrative; înregistrarea nu inferă niciodată nimic clinic din acestea.

Pagini conexe

• Potrivirea pacienților și indexul master de pacienți
• Ghiduri de implementare FHIR
• FHIR Encounter explicat
• FHIR Condition explicat
• Căutarea FHIR explicată
• Exemplu de Patient pe site-ul dezvoltatorilor

Surse

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• HL7 Terminology: coduri de tip identificator (v2-0203)
• HL7 US Core: Profil Patient
• HL7 IPS: Profil Patient

Întrebări frecvente

Este Patient același lucru cu Person în FHIR?

Nu. Person este o resursă administrativă care leagă aceeași persoană fizică în diferite roluri (un Patient aici, un Practitioner acolo, un RelatedPerson în altă parte). Resursele clinice fac referire la Patient, niciodată la Person.

Unde merg alergiile și afecțiunile?

În resursele AllergyIntolerance și Condition care fac referire la Patient. Patient în sine conține doar date administrative.

Cum înregistrez un nou-născut fără nume?

Cu un nume al cărui use este temporary sau gol, un birthDate cu extensia patient-birthTime și o link către înregistrarea mamei prin RelatedPerson sau extensia patient-mothersMaidenName, așa cum specifică profilurile naționale.

Poate fi o singură resursă Patient partajată de două spitale?

Fiecare sistem își păstrează propria resursă Patient cu propriul său id; acestea partajează identificatori (un ID național) și pot lega înregistrările. Potrivirea între sisteme este sarcina unui index master de pacienți, nu a resursei.

Anpheros Platform

Încearcă gratuit în sandbox

Primul apel FHIR în 5 minute. Un API HL7 FHIR R4 cu consimțământul pacientului integrat: încearcă-l în sandbox, apoi conectează-ți propria aplicație sau sistemul clinicii.

Creează un sandbox gratuitCitește ghidurile pentru dezvoltatori →

Gratuit · 30 de pacienți sintetici · fără card

Scris de

Echipa Anpheros

Anpheros construiește un dosar medical pe care pacientul îl controlează și îl poate da oricărei clinici, pe o platformă HL7 FHIR R4, cu sediul în UE. Ghidurile te ajută să-ți înțelegi și să-ți organizezi sănătatea; nu înlocuiesc medicul.

Despre Anpheros →