Slimības pamatdati

Apraksts

Informācija par diagnosticēto slimību, saskaņā ar dažādām slimību klasifikācijas sistēmām.

Slimības pamatdatu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss Condition, uz kura pamata izveidots FHIR profils OncologyBasicDataOfDisease.

Apstrāde

  1. Iesūtot slimības pamatdatus, ir nepieciešams norādīt onkoloģiskā pacienta slimības karti (FHIR profils OncologyCardData). To norāda caur RelatedConditionExtension extension lauku.
  2. 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).
  3. Iesūtot jaunus slimības pamatdatus, ir jānorāda statuss 2-Iesniegta (Extension: CardStatusExtension). Statusa maiņas datumu (Extension: CardStatusDateExtension) piešķir Vēža pacientu reģistra IS.
  4. Gadījumā, ja slimības pamatdatus ir nepieciešams anulēt, tiem ir nepieciešams uzstādīt statusu 3-Anulēta (Extension: CardStatusExtension). Statusa maiņas datumu (Extension: CardStatusDateExtension) piešķir Vēža pacientu reģistra IS.

Datu lauki

📝 Informācijai: Dažos gadījumos, ja diagnozes noteikšanas valsts ir “Latvija”, laukam var būt paredzēta cita kardinalitāte. Šajos gadījumos tabulā zemāk kolonnā “Kard.” (kardinalitāte) ir pievienoti izņēmuma gadījumi Latvijai, pirms kardinalitātes norādot burtu kombināciju “LV”. Piemēram, “0..1, LV: 1..1” nozīmē – ja diagnozes noteikšanas valsts nav Latvija, tad lauks ir neobligāts, bet, ja diagnozes noteikšanas valsts ir Latvija, tad lauks ir obligāts.

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
1 Slimības SSK-10 kods un nosaukums Standard:
Condition.code.coding
Slice:
ICD-10-Code
1..1 Identification of the condition, problem or diagnosis. SSK-10 klasifikators: 1.3.6.1.4.1.38760.2.159
2 Retās slimības kods un nosaukums Standard:
Condition.code.coding
Slice:
ORPHA-Code
0..N Identification of the condition, problem or diagnosis. Retās slimības ORPHA kods: 1.3.6.1.4.1.38760.2.380
3 Bērnu onkoloģiskās slimības kods un nosaukums Standard:
Condition.code.coding
Slice:
ICCC-Code
0..1 Identification of the condition, problem or diagnosis. Bērnu onkoloģiskās klasifikācija: 1.3.6.1.4.1.38760.2.610
4 Audzēja topogrāfijas kods un nosaukums Extension:
TopographyMorphologyExtension Slice:
ICD-O-3-2-Topography
0..1 LV: 1..1 SSK-O-3.2. Topogrāfija: 1.3.6.1.4.1.38760.2.608
5 Audzēja morfoloģijas kods un nosaukums Extension:
TopographyMorphologyExtension Slice:
ICD-O-3-2-Morphology
0..1 SSK-O-3.2. Morfoloģija: 1.3.6.1.4.1.38760.2.873
6 Audzēja morfoloģijas kods uz nosaukums SSK-O 2 (Vēsturiskais) Extension:
TopographyMorphologyExtension Slice:
ICD-O-2-MorphologyOld
0..1 SSK-O-2. Morfoloģija: 1.3.6.1.4.1.38760.2.416
7 Audzēja diferenciācijas pakāpe Standard:
Condition.evidence
Slice:
tumorDifferentiationDegree
0..1 Supporting evidence / manifestations that are the basis of the Condition's verification status, such as evidence that confirmed or refuted the condition. The evidence may be a simple list of coded symptoms/manifestations, or references to observations or formal assessments, or both. Audzēja diferenciācijas pakāpe: 1.3.6.1.4.1.38760.2.609
8 Audzēja lokalizācija pāra orgāniem Extension:
LateralityExtension
0..1 Audzēja lokalizācija pāra orgāniem: 1.3.6.1.4.1.38760.2.611
9 Diagnozes noteikšanas datums Standard:
Condition.onset
1..1 Estimated or actual date or date-time the condition began, in the opinion of the clinician
10 Diagnozes pamatošanas veids Standard:
Condition.evidence
Slice:
diagnosisSubstantiationType
0..1 LV: 1..1 Supporting evidence / manifestations that are the basis of the Condition's verification status, such as evidence that confirmed or refuted the condition. The evidence may be a simple list of coded symptoms/manifestations, or references to observations or formal assessments, or both. Diagnozes pamatošanas veids: 1.3.6.1.4.1.38760.2.613
11 Diagnozes noteikšanas valsts Extension: CountryOfDiagnosisExtension 1..1 Valstis:
1.3.6.1.4.1.38760.2.7
12 Diagnozes atklāšanas veids Standard:
Condition.evidence
Slice:
diagnosisRevealingType
0..1 LV: 1..1 A manifestation or symptom that led to the recording of this condition. Diagnozes atklāšanas veids: 1.3.6.1.4.1.38760.2.606
13 Diagnozes atklāšanas veids (tikai vēsturiskām kartēm līdz 2024.gadam) Standard:
Condition.evidence
Slice:
diagnosisRevealingTypeOld
0..1 Supporting evidence / manifestations that are the basis of the Condition's verification status, such as evidence that confirmed or refuted the condition. The evidence may be a simple list of coded symptoms/manifestations, or references to observations or formal assessments, or both. Diagnozes atklāšanas veids: 1.3.6.1.4.1.38760.2.650
14 Diagnozes apstiprināšanas veids (tikai vēsturiskām kartēm līdz 2024.gadam) Standard:
Condition.evidence
Slice: diagnosisConfirmationTypeOld
0..1 Supporting evidence / manifestations that are the basis of the Condition's verification status, such as evidence that confirmed or refuted the condition. The evidence may be a simple list of coded symptoms/manifestations, or references to observations or formal assessments, or both. Diagnozes apstiprināšanas veids: 1.3.6.1.4.1.38760.2.649
15 Vēlīnās onkoloģijas diagnostikas iemesls (tikai vēsturiskām kartēm līdz 2024.gadam) Standard:
Condition.evidence
Slice:
reasonForLateDiagnosticOld
0..1 Supporting evidence / manifestations that are the basis of the Condition's verification status, such as evidence that confirmed or refuted the condition. The evidence may be a simple list of coded symptoms/manifestations, or references to observations or formal assessments, or both. Vēlīnās diagnostikas iemesls: 1.3.6.1.4.1.38760.2.225

Citi profila obligātie datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
16 Ārējās sistēmas ieraksta ID Standard:
Condition.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
17 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
18 Atsauce uz Onkoloģijas karti Extension:
RelatedConditionExtension
1..1 Sasaista slimības pamatdatus ar slimības karti
19 Slimības pamatdatu statuss Extension:
CardStatusExtension
1..1 Slimības pamatdatu statuss var būt tikai 2-Iesniegta, 3-Anulēta, 5-Apstiprināta vai 6-Noraidīta
20 Slimības pamatdatu statusa datums Extension:
CardStatusDateExtension
1..1 Datums, kad attiecīgais statuss kartei ir piešķirts. Datumu nav nepieciešams iesūtīt, to automātiski piešķir Vēža pacientu reģistra IS

Profila struktūra

idΣ0..1id
metaΣ I0..1OncologyMeta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedI0..0Resource
lateralityI0..1Extension(CodeableConcept)
id0..1id
extensionI0..*Extension
url1..1uriFixed Value
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
relatedOncologyCardI1..1Extension(Reference(Condition))
countryOfDiagnosisI1..1Extension(CodeableConcept)
cardStatusExtensionI1..1Extension(CodeableConcept)
cardStatusDateExtensionI0..1Extension(dateTime)
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(MedicalInstitution)
clinicalStatusΣ ?! I0..0CodeableConceptBinding
verificationStatusΣ ?! I0..0CodeableConceptBinding
category0..0CodeableConceptBinding
severity0..0CodeableConceptBinding
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
bodySiteΣ0..0CodeableConcept
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
encounterΣ I0..0Reference(Encounter)
onsetDateTimedateTime
recordedDateΣ0..0dateTime
recorderΣ I0..0Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)
asserterΣ I0..0Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)
id0..1id
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
detailΣ I0..*Reference(Resource)
note0..0Annotation

Profila validācijas

Nr. Nosacījums Tips Validācija FHIR
1. Diagnozes noteikšanas datums nevar būt nākotnē FHIRPath ID: OncologyBasicDataOfDisease-con-1
iif(onset is dateTime and onset.exists(), onset.toDateTime() <= now(), false)
2. Audzēja morfoloģija (SSK-O-3.2.) – netiek iesūtīti ieraksti, kuriem dabas kods ir 9  - nezināms primārais audzējs - Šobrīd netiek nodrošināta FHIR līmenī
3. Audzēja morfoloģija (SSK-O-3.2.) – Morfoloģijas kodus ar dabu = 0 var izvēlēties tikai tad, ja topogrāfijas kods atbilst CNS (C70‐C72, C75.1‐C75.3) - Šobrīd netiek nodrošināta FHIR līmenī
4. Diagnoze (SSK-10) -  var iesūtīt vērtības tikai no audzēju grupas C00-C97, D00-D09, D32 un D33, D35 koda garums > 3 vai kods in (C01, C07, C12, C19, C20, C23, C33, C37, C52, C55, C56, C58, C61, C64, C65, C66, C73, C80) FHIRPath ID: OncologyBasicDataOfDisease-con-7
iif(code.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.159').code.exists(), code.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.159').code.matches('C(([0-8][0-9])|([9][0-7]))|D(([0][0-9]))|D32|D33|D35'), true)
5. Morfoloģijas kods ir iesūtāms tikai tad, ja diagnozes pamatošanas veids ir:
10 - Primārā audzēja histoloģija
12 - Citoloģiski
13 - Audzēja specifiskie marķieri (hematoloģija)
11 - Metastāzes histoloģija
- Šobrīd netiek nodrošināta FHIR līmenī
6. Ja ievada diagnozes atklāšanas veidu 5 - Pēc nāves bez autopsijas, tad pamatošanas veidam jābūt tikai 14 - Medicīniskā apliecība par nāves iestāšanos un šajā gadījumā nedrīkst būt iespējai pievienot ārstēšanas kartes, slimības gaitu. FHIRPath Validācija sadalīta divās atsevišķās validācijās – viena tiek definēta OncologyBasicDataOfDisease profilā (Ja ievada diagnozes atklāšanas veidu 5 - Pēc nāves bez autopsijas, tad pamatošanas veidam jābūt tikai 14 - Medicīniskā apliecība par nāves iestāšanos):
ID: OncologyBasicDataOfDisease-con-8
iif(evidence.code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.606').code = '5', evidence.code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.613').code = '14', true)
Savukārt otra tiek definēta Bundle ietvaros (Ja ievada diagnozes atklāšanas veidu 5 - Pēc nāves bez autopsijas, tad šajā gadījumā nedrīkst būt iespējai pievienot ārstēšanas kartes, slimības gaitu), ar OncologyBundle-con-46
7. Diagnozes kods un nosaukums pēc SSK-10 klasifikācijas ir obligāts Kardinalitāte Condition.code.coding:ICD-10-Code kardinalitāte ir uzstādīta 1..1
8. Diagnozes noteikšanas datums ir obligāts Kardinalitāte Condition.onset[x] kardinalitāte ir uzstādīta 1..1
9. Ja diagnozes noteikšanas valsts ir “Latvija” un diagnozes noteikšanas datums ir lielāks par 01.01.2024, Audzēja topogrāfijas kods pēc SSK-O-3.2. klasifikācijas ir obligāts FHIRPath ID: OncologyBasicDataOfDisease-con-2
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CountryOfDiagnosisExtension-v1').value.coding.code='LV' and onset >= '2024-01-01T00:00:00.000Z'.toDateTime(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TopographyMorphologyExtension-v1').value.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.608').code.exists(), true))
10. Ja diagnozes noteikšanas valsts ir “Latvija” un diagnozes noteikšanas datums ir lielāks par 01.01.2024, Diagnozes noteikšana veids ir obligāts FHIRPath ID: OncologyBasicDataOfDisease-con-3
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CountryOfDiagnosisExtension-v1').value.coding.code='LV' and onset >= '2024-01-01T00:00:00.000Z'.toDateTime(), evidence.code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.606').code.exists(), true)
11. Ja diagnozes noteikšanas valsts ir “Latvija” un diagnozes noteikšanas datums ir mazāks par 01.01.2024, Diagnozes noteikšana veids (līdz 2024)” ir obligāts FHIRPath ID: OncologyBasicDataOfDisease-con-4
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CountryOfDiagnosisExtension-v1').value.coding.code='LV' and onset < '2024-01-01T00:00:00.000Z'.toDateTime(), evidence.code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.650').code.exists(), true)
12. Ja diagnozes noteikšanas valsts ir “Latvija”, Diagnozes pamatošanas veids ir obligāts FHIRPath ID: OncologyBasicDataOfDisease-con-5
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CountryOfDiagnosisExtension').value.coding.code='LV', evidence.code.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.613').code.exists(), true)
13. Audzēja morfoloģija pēc SSK-O-3.2. – obligāts, ja “Diagnozes pamatošanas veids” ir (10 – primāra audzēja histoloģija, 11 – metastāzes histoloģija, 12 – citoloģija) - Šobrīd netiek nodrošināta FHIR līmenī
14. Audzēja lokalizācija pāra orgāniem – obligāts, ja “Diagnoze pēc SSK-10” ir C34%; C50%; C64%; C69; D05% FHIRPath OncologyBasicDataOfDisease-con-6
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CountryOfDiagnosisExtension').value.coding.code='LV' and (code.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.159').code.matches('C(34|50|64|69).[0-9]|D(50).[0-9]')) or code.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.608').code.matches('C(34|50|64|69).[0-9]')), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/LateralityExtension').value.coding.where(system='https://vvis.gov.lv/fhir/StructureDefinition/ValueSet/1.3.6.1.4.1.38760.2.611').code.exists(), true)
15. Slimības pamatdatu statuss var būt tikai 2-Iesniegt, 3-Anulēta, 5-Apstiprināta vai 6-Noraidīta FHIRPath OncologyBasicDataOfDisease-con-9
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$|^5$|^6$')
16. Ja SSK-10 diagnoze ir D00 – D09, morfoloģijas kodam jābeidzas ar 2 - Šobrīd netiek nodrošināta FHIR līmenī
17. Ja SSK-10 diagnoze ir C00-C76 un C80 – C97, morfoloģijas kodam jābeidzas ar 3 - Šobrīd netiek nodrošināta FHIR līmenī
18. Ja SSK-10 diagnoze ir C77-C79 , morfoloģijas kodam jābeidzas ar 6 - Šobrīd netiek nodrošināta FHIR līmenī
19. Ja SSK-10 diagnoze ir C00-C97, tad stadija nedrīkst būt 0 [un pārējās, kas ir ar nulli] FHIRPath Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-5
20. Audzēja lokalizāciju pāra orgāniem nav iespējam iesūtīt hematoloģiskajiem audzējiem pēc SSK-O-3.2: C42% un SSK-10: C90%-C96% FHIRPath OncologyBasicDataOfDisease-con-10
iif(code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.608').code.matches('C42.[0-9]') or code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.159').code.matches('^C[9][0-6].[0-9]$'), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/LateralityExtension-v1').value.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.611').code.exists().not(), true)

Datu iesūtīšanas piemēri

Skatīt Postman kolekcijas struktūru OncologyBasicDataOfDisease:

Darbība Nosaukums Apraksts
POST Create OncologyBasicDataOfDisease Jaunu slimības pamatdatu iesūtīšana
POST Create OncologyBasicDataOfDisease (historical cards) Jaunu slimības pamatdatu iesūtīšana, iekļaujot arī vēsturiskos datu laukus
GET Get OncologyBasicDataOfDisease Esošu slimības pamatdatu izgūšana pēc ID
PUT Update OncologyBasicDataOfDisease Esošu slimības pamatdatu datu labošana
GET Search for OncologyBasicDataOfDisease entry by OncologyCardData reference Slimības pamatdatu ieraksta meklēšana pēc Slimības kartes references