Staru terapija

Apraksts

Informācija par staru terapijas ārstēšanu.

Staru terapijas datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss Procedure, uz kura pamata izveidots FHIR profils RadiationTherapy.

Apstrāde

  1. Iesūtot staru terapijas datus, ir nepieciešams norādīt slimības pamatdatu karti (FHIR profils OncologyBasicDataOfDisease). To norāda caur Procedure.reasonReference lauku.
  2. Iesūtot datus, ir nepieciešams norādīt references uz administratīvajiem profiliem: pacients (Procedure.subject.reference), ārējās sistēmas piešķirtā ieraksta identifikatora organizācija (Procedure.identifier.assigner.reference), Ārstniecības iestāde, kurā saņemta ārstēšana (Procedure.performer.actor.reference).
  3. Iesūtot jaunu karti, kartei ir jānorāda statuss 2-Iesniegta (Extension: CardStatusExtension).
  4. Gadījumā, ja karti ir nepieciešams anulēt, tai ir nepieciešams uzstādīt statusu 3-Anulēta (Extension: CardStatusExtension).
  5. 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

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
1 Ārstēšanas veids Standard:
Procedure.category
1..1 Classification of the procedure Ārstēšanas veidu klasifikators:
1.3.6.1.4.1.38760.2.628
2 Ārstniecības iestāde, kurā saņemta ārstēšana Standard:
Procedure.performer
0..1 Person or organization that provided the information about the taking of this medication Obligāti ir jāaizpilda vai nu ārstniecības iestāde, vai nu ārvalstu ārstniecības iestāde
Atsauce uz VVIS Medicīnas iestādes profilu: https://vvis.gov.lv/fhir/StructureDefinition/Organization/MedicalInstitution
3 Ārvalstu ārstniecības iestāde, kurā saņemta ārstēšana Extension:
Procedure.performer.foreignMedicalInstitution
0..1 Teksts līdz 500 simboliem
5 Staru terapijas veids Standard:
Procedure.code
Slice:
radiationTherapyCode
1..1 The specific procedure that is performed. Use text if the exact nature of the procedure cannot be coded (e.g. "Laparoscopic Appendectomy"). Staru terapijas veids:
1.3.6.1.4.1.38760.2.631
6 Staru terapijas apakšveids Standard:
Procedure.code
Slice:
radiationTherapySubCode
0..1

Pēc 01.01.2024:
1..1
Staru terapijas apakšveids:
1.3.6.1.4.1.38760.2.632
7 Staru terapijas metode Standard:
Procedure.code
Slice:
radiationTherapyMethod
0..1

Pēc 01.01.2024:
1..1
Staru terapijas metode:
1.3.6.1.4.1.38760.2.633
8 Staru terapijas sākuma datums Standard:
Procedure.Performed.start
1..1 When the procedure was performed Time range defined by start and end date/time
9 Staru terapijas beigu datums Standard:
Procedure.Performed.end
0..1 When the procedure was performed Time range defined by start and end date/time
10 Kursā saņemto greju skaits Extension:
GrayUnitsReceivedExtension
0..1

Pēc 01.01.2024: 1..1
Decimālskaitlis
11 Kursā saņemto frakciju skaits Extension:
FractionsReceivedExtension
0..1

Pēc 01.01.2024: 1..1
Decimālskaitlis
12 Norāde par pacientu tālāko ārstēšanu/ uzraudzību Standard:
Procedure.followUp
Slice:
followUp
0..1 If the procedure required specific follow up - e.g. removal of sutures. The follow up may be represented as a simple note or could potentially be more complex, in which case the CarePlan resource can be used. Pacienta tālāka ārstēšana vai uzraudzība:
1.3.6.1.4.1.38760.2.629
13 Turpmākā ārstēšana/ novērošana (tikai vēsturiskām kartēm) Standard:
Procedure.followUp
Slice:
followUpOld
0..1 If the procedure required specific follow up - e.g. removal of sutures. The follow up may be represented as a simple note or could potentially be more complex, in which case the CarePlan resource can be used. Onkoloģijas pacienta plūsma:
1.3.6.1.4.1.38760.2.204
14 Pārtraukšanas datums Extension:
TerminationDateExtension
0..1
15 Pārtraukšanas iemesls Extension:
TerminationReasonExtension
0..1 Terapijas pārtraukšanas iemesls:
1.3.6.1.4.1.38760.2.877
16 Pārtraukšanas papildus informācija Extension:
TerminationReasonExtension
0..1 Teksts līdz 250 simboliem

Citi profila obligātie datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
17 Ārējās sistēmas ieraksta ID Standard:
Procedure.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
18 Procedure statuss Standard:
Procedure.status
1..1 A code specifying the state of the procedure. Generally, this will be the in-progress or completed state. FHIR obligātais lauks. Pieejamās vērtības:
preparation, in-progress, not-done, on-hold, stopped, completed, entered-in-error, unknown
Iesūtot vienmēr tiek aizpildīts ar “completed
19 Ārstēšanas kartes statuss Extension:
CardStatusExtension
1..1 Ārstēšanas karte var būt statusā 2-Iesniegta vai 3-Anulēta
20 Ārstēšanas kartes statusa datums Extension:
CardStatusDateExtension
0..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
21 Atsauce uz pacientu Standard:
Procedure.subject
1..1 Who is/was taking the medication Atsauce uz VVIS LV pacienta profilu: https://vvis.gov.lv/fhir/StructureDefinition/Patient/LVPatient
22 Ārstētā slimība
Sasaiste ar slimības pamatdatiem (FHIR: OncologyBasicDataOfDisease)
Standard:
Procedure.reasonReference
1..* The justification of why the procedure was performed. Ārstētā slimība - Norāde uz vienu vai vairākām onkoloģiskā pacienta slimības kartēm (numuriem), ar kuru ir saistīta attiecīgā ārstēšana

Profila struktūra

idΣ0..1id
id0..0id
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ I1..1canonical(StructureDefinition)
securityΣ0..0CodingBinding
id1..1idFixed Value
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
id1..1idFixed Value
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
id1..1idFixed Value
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
id1..1idFixed Value
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
id1..1idFixed Value
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedI0..0Resource
grayUnitsReceivedI0..1Extension(decimal)
fractionsReceivedI0..1Extension(decimal)
cardStatusExtensionI1..1Extension(CodeableConcept)
cardStatusDateExtensionI0..1Extension(dateTime)
cardStatusReasonExtensionI0..1Extension(CodeableConcept)
terminationDateExtensionI0..1Extension(dateTime)
terminationReasonExtensionI0..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(MedicalInstitution)
instantiatesCanonicalΣ0..0canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire)
instantiatesUriΣ0..0uri
basedOnΣ I0..0Reference(CarePlan | ServiceRequest)
partOfΣ I0..0Reference(Procedure | Observation | MedicationAdministration)
statusΣ ?!1..1codeBinding
statusReasonΣ0..0CodeableConcept
id0..1id
extensionI0..*Extension
id0..1id
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
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
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
encounterΣ I0..0Reference(Encounter)
id0..1id
extensionI0..*Extension
startS Σ I1..1dateTime
endΣ I0..1dateTime
recorderΣ I0..0Reference(Patient | RelatedPerson | Practitioner | PractitionerRole)
asserterΣ I0..0Reference(Patient | RelatedPerson | Practitioner | PractitionerRole)
id0..1id
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
functionΣ0..1CodeableConcept
id0..1id
foreignMedicalInstitutionI0..1Extension(string)
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
onBehalfOfI0..1Reference(Organization)
locationΣ I0..0Reference(Location)
reasonCodeΣ0..0CodeableConcept
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
bodySiteΣ0..0CodeableConcept
outcomeΣ0..0CodeableConcept
reportI0..0Reference(DiagnosticReport | DocumentReference | Composition)
complication0..0CodeableConcept
complicationDetailI0..0Reference(Condition)
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
textΣ0..1string
note0..0Annotation
usedReferenceI0..0Reference(Device | Medication | Substance)
usedCode0..0CodeableConcept

Profila validācijas

Nr. Nosacījums Tips Validācija FHIR
1 Vai ir norādīta vismaz viena saistītā slimības karte Kardinalitāte Procedure.reasonReference kardinalitāte ir uzstādīta 1..*
2 Vai ir norādīta ārstniecības iestāde (Latvijas – no klasifikatora, vai ārvalstu – ievadot informāciju teksta laukā) FHIRPath ID: RadiationTherapy-con-1
performer.actor.reference.exists() or performer.actor.extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/ForeignMedicalInstitutionExtension-v1').value.exists()
3 Vai ir norādīts staru terapijas veids Kardinalitāte Procedure.code.coding:radiationTherapyCode kardinalitāte ir uzstādīta 1..1
4 Vai ir norādīts staru terapijas apakšveids Kardinalitāte Procedure.code.coding:radiationTherapySubCode kardinalitāte ir uzstādīta 1..1
5 Vai ir norādīts sākuma datums Kardinalitāte Procedure.performed[x].start kardinalitāte ir uzstādīta 1..1
6 Vai ir norādīta metode Kardinalitāte Procedure.code.coding:radiationTherapyMethod kardinalitāte ir uzstādīta 1..1
7 Vai ir norādīts saņemto greju skaits Kardinalitāte Procedure.extension:grayUnitsReceived kardinalitāte ir uzstādīta 1..1
8 Vai ir norādīts kursā saņemto frakciju skaits Kardinalitāte Procedure.extension:fractionsReceived kardinalitāte ir uzstādīta 1..1
9 Staru terapijas sākuma datums – obligāts, datums nedrīkst būt nākotnē FHIRPath ID: RadiationTherapy-con-2
iif(performed.start is dateTime and performed.start.exists(), performed.start.toDateTime() <= now(), false)
10 Staru terapijas sākuma datums – obligāts, datums nedrīkst būt agrāks par diagnozes noteikšanas datumu FHIRPath Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-39
11 Staru terapijas sākuma datums – obligāts, datumam ir jābūt lielākam par pacienta dzimšanas datumu. - Validācija netiek nodrošināta FHIR līmenī, tā kā pacienta dzimšanas datums netiek iesūtīts datu kopā (tiek iesūtīta tikai reference uz pacientu)
12 Staru terapijas beigu datums (neobligāts), Datums nedrīkst būt nākotnē & nedrīkst būt mazāks par sākuma datumu (var būt vienāds vai lielāks) FHIRPath ID: RadiationTherapy-con-3
iif(performed.end is dateTime and performed.end.exists(), performed.end.toDateTime() <= now() and performed.end.toDateTime() >= performed.start.toDateTime(), true)
13 Ja staru terapijas apakšveids ir “Kodolmedicīna”, lauks Staru terapijas metode nav pieejams iesūtīšanai un ir neobligāts FHIRPath ID: RadiationTherapy-con-4
iif(code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.632')='3', code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.633').code.exists().not(), true)
14 Ja staru terapijas apakšveids ir “Kodolmedicīna”, lauks Kursā saņemto greju skaits nav pieejams iesūtīšanai un ir neobligāts FHIRPath ID: RadiationTherapy-con-5
iif(code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.632').code='3', extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/GrayUnitsReceivedExtension-v1').value.exists().not(), true)
15 Ja staru terapijas apakšveids ir “Kodolmedicīna”, lauks Kursā saņemto frakciju skaits nav pieejams iesūtīšanai un ir neobligāts FHIRPath ID: RadiationTherapy-con-6
iif(code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.632').code='3', extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/FractionsReceivedExtension-v1').value.exists().not(), true)
16 Ja staru terapijas sākuma datums ir pēc 01.01.2024 un terapijas metode nav kodolmedicīna, tad Staru terapijas metode, Kursā saņemto greju skaits un Kursā saņemto frakciju skaits ir obligāti FHIRPath ID: RadiationTherapy-con-7
iif(performed.start >= '2024-01-01T00:00:00.000Z'.toDateTime() and code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.632' and code='3').exists().not(), code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.633').code.exists() and extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/GrayUnitsReceivedExtension-v1').value.exists() and extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/FractionsReceivedExtension-v1').value.exists(), true)
17 Ja staru terapijas sākuma datums ir pēc 01.01.2024, staru terapijas apakšveids ir obligāts FHIRPath ID: RadiationTherapy-con-8
iif(performed.start >= '2024-01-01T00:00:00.000Z'.toDateTime(), code.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.632').code.exists(), true)
18 Vienlaikus var norādīt tikai vienu ārstniecības iestādi – Latvijas no klasifikatora, vai ārvalstu teksta laukā FHIRPath ID: RadiationTherapy-con-9
(performer.actor.reference.exists() implies performer.actor.extension.value.exists().not()) and (performer.actor.extension.value.exists() implies performer.actor.reference.exists().not())
19 Ārstēšanas kartes statuss var būt tikai 2-Iesniegta vai 3-Anulēta FHIRPath ID: RadiationTherapy-con-10
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$')
20 Staru terapijas ārstēšanas gadījumā jānorāda ārstēšanas veids 2-Staru terapija FHIRPath ID: RadiationTherapy-con-11
$this='https://onko.vvis.gov.lv/fhir/StructureDefinition/Procedure/RadiationTherapy-v1' implies (%resource.category.ofType(CodeableConcept).coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.628').code = '2')
21 Ja ārstēšanas kartei tiek uzstādīts statuss "3-Anulēta", tad obligāti ir jānorāda anulēšanas iemesls FHIRPath ID: RadiationTherapy-con-12
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.exists(), true)
22 Pārtraukšanas datums nav atļauts, ja ir aizpildīts terapijas beigu datums FHIRPath ID: RadiationTherapy-con-13
iif(performed.end.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists().not(), true)
23 Terapijas pārtraukšanas datumam ir jābūt lielākam vai vienādam ar terapijas sākuma datumu FHIRPath ID: RadiationTherapy-con-14
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.toDate() >= performed.start.toDateTime(), true)
24 Ja ir norādīts terapijas pārtraukšanas datums, tad ir obligāti jābūt norādītam terapijas pārtraukšanas iemeslam no klasifikatora (un otrādi: ja ir norādīts pārtraukšanas iemesls, tad ir noteikti jābūt pārtraukšanas datumam) FHIRPath ID: RadiationTherapy-con-15
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists() or extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationReasonExtension-v1').value.coding.code.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists() and extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationReasonExtension-v1').value.coding.code.exists(), true)
25 Ja ir norādīts teksts sadaļā “Papildus informācija” tad ir obligāti jābūt norādītam pārtraukšanas datumam un iemeslam no klasifikatora (bet pats “papildus informācijas” lauks nav obligāts) FHIRPath ID: RadiationTherapy-con-16
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationReasonExtension-v1').value.text.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists() and extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationReasonExtension-v1').value.coding.code.exists(), true)

Datu iesūtīšanas piemēri

Skatīt Postman kolekcijas struktūru RadiationTherapy:

Darbība Nosaukums Apraksts
POST Create RadiationTherapy Jaunas ārstēšanas – staru terapija iesūtīšana
POST Create RadiationTherapy (historical cards) Jaunas ārstēšanas - staru terapija iesūtīšana, iekļaujot arī vēsturiskos datu laukus
GET Get RadiationTherapy Esošas ārstēšanas - staru terapija izgūšana pēc ID
PUT Update RadiationTherapy Esošas ārstēšanas - staru terapija datu labošana
GET Search for RadiationTherapy entry by OncologyBasicDataOfDisease reference Staru terapijas kartes meklēšana pēc Slimības pamatdatu references