Kartes dati

Apraksts

Kartes pamatdati – informācija par karti (kartes statuss, kartes numurs reģistrā, kartes statuss Latvijas vēža populācijas reģistrā un citi dati).

Kartes datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss Condition, uz kura pamata izveidots FHIR profils OncologyCardData.

Apstrāde

  1. Iesūtot jaunu karti, tai biznesa statusu nepieciešams norādīt “2 - Iesniegta”.
  2. Ja nepieciešams karti anulēt, ārējās integratoru sistēmas esošai kartei norāda statusu "3 - Anulēta". Anulējot slimības karti ir nepieciešams anulēt arī visas saistītās ārstēšanas kartes. Anulēšanu var veikt arī no Vēža pacientu reģistra sistēmas puses.
  3. Statusus (5 - Apstiprināta, 6 - Noraidīta) ārējās integratoru sistēmas norādīt nevar. Šos statusus var mainīt tikai Vēža pacientu reģistra sistēma.
  4. Statusi (1 - Jauna, 4 - Dzēsta) netiek sūtīti uz FHIR un ir paredzēti tikai iekšējai lietošanai Vēža pacientu reģistra sistēmā pirms kartes iesniegšanas.
  5. Ārējās integratoru sistēmas Kartes numuru un Audzēja numuru pacientam neiesūta – to piešķir tikai Vēža pacientu reģistra sistēma.
  6. Ārējās integratoru sistēmas personas noņemšanu no uzskaites iesūtīt nevar. Šo informāciju var iesūtīt tikai Vēža pacientu reģistra sistēma. Statusu maina automātisks process, ja pacientam ir saņemts miršanas datums un nāves cēlonis, vai arī SPKC lietotājs Vēža pacientu reģistra sistēmā.
  7. Iesūtot datus, ir nepieciešams norādīt references uz administratīvajiem profiliem: pacients (Condition.subject.reference), ārējās sistēmas piešķirtā ieraksta identifikatora organizācija (Condition.identifier.assigner.reference).
  8. Statusa izmaiņu datumu (Extension: CardStatusDateExtension) automātiski piešķir Vēža pacientu reģistra IS. Vienīgais izņēmums ir anulēšanas darbība. Gadījumā, ja anulēšanas datums nav tekošās dienas datums (piemēram, karte anulēta pirms tekošās dienas), tad to var norādīt pie iesūtīšanas laukā Extension: CardStatusDateExtension un Vēža pacientu reģistra IS izmantos šo datumu.

Datu lauki

Biznesa datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
1 Kartes numurs Standard:
Condition.identifier
1..1 Business identifiers assigned to this condition Tiek izmantots identifikatora tips “ONCOLOGY_CARD_NUMBER”
2 Audzēja numurs pacientam Standard:
Condition.identifier
1..1 Business identifiers assigned to this condition Tiek izmantots identifikatora tips “PATIENT_TUMOR_NUMBER”
3 Kartes statuss reģistrā Extension:
CardStatusExtension
1..1 Pacienta slimības kartes statuss reģistrā:
1.3.6.1.4.1.38760.2.601
Slimības kartes statuss var būt tikai 2-Iesniegta, 3-Anulēta, 5-Apstiprināta vai 6-Noraidīta
Ārējās sistēmas var iesniegt tikai statusus “Iesniegta” vai “Anulēta

Citi profila obligātie datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
4 Ārējās sistēmas ieraksta ID Standard:
Condition.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
5 Atsauce uz pacientu Standard:
Condition.subject
1..1 Indicates the patient or group who the condition record is associated with. Atsauce uz VVIS LV pacienta profilu: https://vvis.gov.lv/fhir/StructureDefinition/Patient/LVPatient

Zemāk ir uzskaitīti profila datu lauki, kas tiek aizpildīti pie noteiktas biznesas darbības ar karti

Ja statuss ir “Iesniegta”, tas tiek norādīts:

Nr. Datu lauks FHIR Lauks Kard. Detaļas
6 Kartes statuss reģistrā Extension:
CardStatusExtension
1..1 Tiek uzstādīts "2-Iesniegta"
7 Iesniegšanas datums Extension:
CardStatusDateExtension
1..1 Iesniegšanas datumu automātiski uzstāda Vēža pacientu reģistra IS

Ja statuss ir “Apstiprināta”, tas tiek norādīts:

Nr. Datu lauks FHIR Lauks Kard. Detaļas
8 Kartes statuss reģistrā Extension:
CardStatusExtension
1..1 Tiek uzstādīts "5-Apstiprināta"
9 Kartes apstiprināšanas datums Extension:
CardStatusDateExtension
1..1 Apstiprināšanas datumu automātiski uzstāda Vēža pacientu reģistra IS

Ja statuss ir “Anulēta”, tas tiek norādīts:

Nr. Datu lauks FHIR Lauks Kard. Detaļas
10 Kartes statuss reģistrā Extension:
CardStatusExtension
0..1 Tiek uzstādīts "3-Anulēta"
11 Kartes anulēšanas datums Extension:
CardStatusDateExtension
0..1 Anulēšanas datumu automātiski uzstāda Vēža pacientu reģistra IS. Ja anulēšanas datums nav sysdate, tad to Integratoru IS norāda laukā Extension: CardStatusDateExtension
12 Kartes anulēšanas iemesls Extension:
CardStatusReasonExtension
0..1 Kartes anulēšanas iemesls:
1.3.6.1.4.1.38760.2.603

Ja statuss ir Noraidīta, tas tiek norādīts:

Nr. Datu lauks FHIR Lauks Kard. Detaļas
13 Kartes statuss reģistrā Extension:
CardStatusDateExtension
0..1 Tiek uzstādīts "6-Noraidīta"
14 Kartes noraidīšanas datums Extension:
CardStatusDateExtension
0..1 Noraidīšanas datumu automātiski uzstāda Vēža pacientu reģistra IS
15 Kartes noraidīšanas iemesls Extension:
CardStatusReasonExtension
0..N Kartes noraidīšanas iemesls:
1.3.6.1.4.1.38760.2.644
16 Kartes noraidīšanas iemesls cits (teksta lauks) Extension:
CardStatusReasonExtension.value[x].text
0..1 Ja tiek lietots noraidīšanas iemesls “Cits”, tad papildus var tikt norādīts teksts līdz 200 simboli

Ja persona tiek noņemta no uzskaites, tas tiek norādīts:

Nr. Datu lauks FHIR Lauks Kard. Detaļas
13 Noņemšanas no uzskaites datums Extension:
DeregistrationDateExtension
0..1 Noņemšanas no uzskaites datumu automātiski uzstāda Vēža pacientu reģistra IS
14 Noņemšanas no uzskaites iemesls Extension:
DeregistrationReasonExtension
Slice:
deregistrationReason
0..1 Noņemšanas no uzskaites iemesls:
1.3.6.1.4.1.38760.2.604
15 Noņemšanas no uzskaites iemesls, ja karte no uzskaites noņemta līdz 01.01.2024 (Vēsturiskais) Extension:
DeregistrationReasonExtension
Slice:
deregistrationReasonOld
0..1 Noņemšanas no uzskaites iemesls:
1.3.6.1.4.1.38760.2.870
16 Noņemšanas no uzskaites iemesls cits (teksta lauks) Extension:
DeregistrationReasonExtension.value[x].text
0..1 Ja tiek lietots noņemšanas no uzskaites iemesls “Cits”, tad papildus var tikt norādīts teksts līdz 200 simboli

Profila struktūra

idΣ0..1id
metaΣ I0..1OncologyMeta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedI0..0Resource
cardStatusI1..1Extension(CodeableConcept)
cardStatusDateI0..1Extension(dateTime)
cardStatusReasonI0..1Extension(CodeableConcept)
deregistrationDateI0..1Extension(date)
deregistrationReasonI0..1Extension(CodeableConcept)
modifierExtension?! I0..*Extension
id0..0id
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1codeBinding
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemΣ0..0uri
valueΣ1..1string
periodΣ I0..0Period
assignerΣ I1..1Reference(https://vvis.gov.lv/fhir/StructureDefinition/Organization)
clinicalStatusΣ ?! I0..0CodeableConceptBinding
verificationStatusΣ ?! I0..0CodeableConceptBinding
category0..0CodeableConceptBinding
severity0..0CodeableConceptBinding
codeΣ0..0CodeableConcept
bodySiteΣ0..0CodeableConcept
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
encounterΣ I0..0Reference(Encounter)
recordedDateΣ0..0dateTime
recorderΣ I0..0Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)
asserterΣ I0..0Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)
note0..0Annotation

Profila validācijas

Nr. Nosacījums Tips Validācija FHIR
1. Kartes statuss var būt tikai: 2 – Iesniegta, 3 – Anulēta, 5 – Apstiprināta, 6 - Noraidīta FHIRPath ID: OncologyCardData-con-1
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$|^5$|^6$')
2. Ja karte ir 3 – Anulēta, vai 6 – Noraidīta, tad obligāti ir jābūt norādītam anulēšanas vai noraidīšanas iemeslam FHIRPath ID: OncologyCardData-con-2
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^3$|^6$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusReasonExtension-v1').value.exists() , true)
3. Ja ir norādīts anulēšanas iemesls, ir obligāti jānorāda anulēšanas datums (un otrādi) FHIRPath ID: OncologyCardData-con-3
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^3$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusDateExtension-v1').value.exists(), true)
4. Ja ir norādīts noņemšanas no uzskaites iemesls, ir obligāti jānorāda noņemšanas no uzskaites datums (un otrādi) FHIRPath ID: OncologyCardData-con-4
iif((extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationDateExtension-v1').value.exists() or extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationReasonExtension-v1').value.coding.code.exists()), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationDateExtension-v1').value.exists() and extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationReasonExtension-v1').value.coding.code.exists(), true)
5. Kartes anulēšanas datumam jābūt mazākam vai vienādam ar šīs dienas datumu FHIRPath ID: OncologyCardData-con-5
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^3$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusDateExtension-v1').value.toString().substring(0,10).toDate() <= today(), true)
6. Ja kartes statuss ir 3 – Anulēta, tad Kartes statusa maiņas iemeslam jāatbilst 1.3.6.1.4.1.38760.2.603 klasifikatoram FHIRPath ID: OncologyCardData-con-6
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^3$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusReasonExtension-v1').value.coding.system.matches('1.3.6.1.4.1.38760.2.603'), true)
7. Ja kartes statuss ir 6 – Noraidīta, tad Kartes statusa maiņas iemeslam jāatbilst 1.3.6.1.4.1.38760.2.644 klasifikatoram FHIRPath ID: OncologyCardData-con-7
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^6$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusReasonExtension-v1').value.coding.system.matches('1.3.6.1.4.1.38760.2.644'), true)
8. Ārējas sistēmas nevar iesūtīt kartes numuru. Kartes numuru var iesūtīt tikai Vēža pacientu reģistra sistēmas reģistra backend apstrādes servisi. FHIRPath ID: OncologyCardData-con-8
iif(identifier.where(type.coding.code='ONCOLOGY_CARD_NUMBER').value.exists(), meta.tag.where(id='entererSystem').code='ONKO', true)
9. Ārējas sistēmas nevar iesūtīt audzēja numuru pacientam. Audzēja numuru pacientam var iesūtīt tikai Vēža pacientu reģistra sistēmas backend apstrādes servisi. FHIRPath ID: OncologyCardData-con-9
iif(identifier.where(type.coding.code='PATIENT_TUMOR_NUMBER').value.exists(), meta.tag.where(id='entererSystem').code='ONKO', true)
10. Ārējas sistēmas nevar iesūtīt Noņemšanas no uzskaites datums / Noņemšanas no uzskaites iemesls. Datumu un iemeslu var norādīt tikai Vēža pacientu reģistra sistēmas backend apstrādes servisi. FHIRPath ID: OncologyCardData-con-10
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationReasonExtension-v1').valueCodeableConcept.coding.code.exists() or extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/DeregistrationDateExtension-v1').valueDate.exists(), meta.tag.where(id='entererSystem').code='ONKO', true)
11. Ārējas sistēmas nevar uzstādīt kartes statusus 5-Apstiprināta un 6-Noraidīta FHIRPath ID: OncologyCardData-con-11
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^5$|^6$'), meta.tag.where(id='entererSystem').code='ONKO', true)

Datu iesūtīšanas piemēri

Skatīt Postman kolekcijas struktūru OncologyCardData:

Darbība Nosaukums Apraksts
POST Create OncologyCardData Jaunas kartes iesūtīšana
GET Get OncologyCardData Esošas kartes datu izgūšana pēc ID
PUT Update OncologyCardData (Set status 3 - Revoked/Anulēta) Esošas kartes anulēšana
GET Search for OncologyCardData cards by Patient reference Meklēt slimības kartes pēc pacienta identifikatora