Ķīmijterapija

Apraksts

Informācija par ķīmijterapijas ārstēšanu.

Ķīmijterapijas datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss MedicationStatement, uz kura pamata izveidots FHIR profils Chemotherapy.

Apstrāde

  1. Iesūtot ķīmijterapijas datus, ir nepieciešams norādīt slimības pamatdatu karti (FHIR profils OncologyBasicDataOfDisease). To norāda caur MedicationStatement.reasonReference lauku.
  2. Iesūtot datus, ir nepieciešams norādīt references uz administratīvajiem profiliem: pacients (MedicationStatement.subject.reference), ārējās sistēmas piešķirtā ieraksta identifikatora organizācija (MedicationStatement.identifier.assigner.reference), Ārstniecības iestāde, kurā saņemta ārstēšana (MedicationStatement.informationSource.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:
MedicationStatement.category
1..1 Type of medication usage Ārstēšanas veidu klasifikators:
1.3.6.1.4.1.38760.2.628
2 Ārstniecības iestāde, kurā saņemta ārstēšana Standard:
MedicationStatement.informationSource
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:
MedicationStatement.foreignMedicalInstitution
0..1 Teksts līdz 500 simboliem
4 Ķīmijterapijas veids Standard:
MedicationStatement.category
1..1 Type of medication usage Ķīmijterapijas veids:
1.3.6.1.4.1.38760.2.634
5 Ķīmijterapijas līnija Extension:
TherapyLineExtension
0..1 Ķīmijterapijas līnija:
1.3.6.1.4.1.38760.2.635
6 Zāļu vispārīgā nosaukuma ATK kods Standard:
MedicationStatement.Medication
1..* What medication was taken Zāļu anatomiski terapeitiski ķīmiskā klasifikācija (ATĶ):
1.3.6.1.4.1.38760.2.141
7 Saņemto kursu skaits Extension:
CourseCountReceived
0..1 Nav klasifikators
8 Ķīmijterapijas sākuma datums Standard:
MedicationStatement.effective.start
1..1 When the procedure was performed Time range defined by start and end date/time
9 Ķīmijterapijas beigu datums Standard:
MedicationStatement.effective.end
0..1 When the procedure was performed Time range defined by start and end date/time
10 Norāde par pacientu tālāko ārstēšanu/ uzraudzību Extension:
FollowUpExtension
Slice:
followUp
0..1 Pacienta tālāka ārstēšana vai uzraudzība:
1.3.6.1.4.1.38760.2.629
11 Turpmākā ārstēšana/ novērošana (tikai vēsturiskām kartēm) Extension:
FollowUpExtension
Slice:
folowUpOld
0..1 Onkoloģijas pacienta plūsma:
1.3.6.1.4.1.38760.2.204
12 Pārtraukšanas datums Extension:
TerminationDateExtension
0..1
13 Pārtraukšanas iemesls Extension:
TerminationReasonExtension
0..1 Terapijas pārtraukšanas iemesls:
1.3.6.1.4.1.38760.2.877
14 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
15 Ārējās sistēmas ieraksta ID Standard:
MedicationStatement.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
16 MedicationStatement statuss Standard:
MedicationStatement.status
1..1 A code representing the patient or other source's judgment about the state of the medication used that this statement is about. Generally, this will be active or completed. FHIR obligātais lauks. Pieejamās vērtības:
active, completed, entered-in-error, intended, stopped, on-hold, unknown, not-taken
Iesūtot vienmēr tiek aizpildīts ar “completed
17 Ārstēšanas kartes statuss Extension:
CardStatusExtension
1..1 Ārstēšanas karte var būt statusā 2-Iesniegta vai 3-Anulēta
18 Ā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
19 Atsauce uz pacientu Standard:
MedicationStatement.subject
1..1 Who is/was taking the medication Atsauce uz VVIS LV pacienta profilu: https://vvis.gov.lv/fhir/StructureDefinition/Patient/LVPatient
20 Ārstētā slimība.
Sasaiste ar slimības pamatdatiem (FHIR: OncologyBasicDataOfDisease)
Standard:
MedicationStatement.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
courseCountReceivedI0..1Extension(integer)
chemotherapyLineI0..1Extension(CodeableConcept)
followUpExtensionI0..*Extension(CodeableConcept)
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)
basedOnΣ I0..0Reference(MedicationRequest | CarePlan | ServiceRequest)
partOfΣ I0..0Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)
statusΣ ?!1..1codeBinding
statusReason0..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
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
textΣ0..1string
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
contextΣ I0..0Reference(Encounter | EpisodeOfCare)
id0..1id
extensionI0..*Extension
startS Σ I1..1dateTime
endΣ I0..1dateTime
dateAssertedΣ0..0dateTime
id0..1id
foreignMedicalInstitutionI0..1Extension(string)
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
derivedFromI0..0Reference(Resource)
reasonCode0..0CodeableConcept
id0..1id
extensionI0..*Extension
referenceΣ I1..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
note0..0Annotation
dosage0..0Dosage

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 MedicationStatement.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: Chemotherapy-con-1
informationSource.reference.exists() or informationSource.extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/ForeignMedicalInstitutionExtension-v1').value.exists()
3 Vai ir norādīts ķīmijterapijas veids Kardinalitāte MedicationStatement.category.coding:chemotherapyType kardinalitāte ir uzstādīta 1..1
4 Vai ir norādīts sākuma datums Kardinalitāte MedicationStatement.effective[x].start kardinalitāte ir uzstādīta 1..1
5 Vai ir norādīts vismaz viens medikaments Kardinalitāte MedicationStatement.medication[x].coding kardinalitāte ir uzstādīta 1..*
6 Ķīmijterapijas sākuma datums – obligāts, datums nedrīkst būt nākotnē FHIRPath ID: Chemotherapy-con-2
iif(effective.start.exists(), effective.start.toDateTime() <= now(), false)
7 Ķīmijterapijas 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-40
8 Ķīmijterapijas 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)
9 Ķīmijterpaijas 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: Chemotherapy-con-3
iif(effective.end.exists(), effective.end.toDateTime() <= now() and effective.end.toDateTime() >= effective.start.toDateTime(), true)
10 Ķīmijterpaijas gadījumā jānorāda ārstēšanas veids 3—Ķīmijterpaija FHIRPath ID: Chemotherapy-con-4
$this='https://onko.vvis.gov.lv/fhir/StructureDefinition/MedicationStatement/Chemotherapy-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 = '3')
11 Kā medikamentu var iesūtīt tikai piektā līmeņa ierakstu (aktīvas vielas līmeņa ierakstu, piemēram: L01AA02  chlorambucil). FHIRPath ID: Chemotherapy-con-6
medicationCodeableConcept.coding.all(code.matches('^.{7}$'))
12 Vienlaikus var norādīt tikai vienu ārstniecības iestādi – Latvijas no klasifikatora, vai ārvalstu teksta laukā FHIRPath ID: Chemotherapy-con-7
(informationSource.reference.exists() implies informationSource.extension.value.exists().not()) and (informationSource.extension.value.exists() implies informationSource.reference.exists().not())
13 Ārstēšanas kartes statuss var būt tikai 2-Iesniegta vai 3-Anulēta FHIRPath ID: Chemotherapy-con-8
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$')
14 Ja ārstēšanas kartei tiek uzstādīts statuss "3-Anulēta", tad obligāti ir jānorāda anulēšanas iemesls FHIRPath ID: Chemotherapy-con-9
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)
15 Pārtraukšanas datums nav atļauts, ja ir aizpildīts terapijas beigu datums FHIRPath ID: Chemotherapy-con-10
iif(effective.end.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists().not(), true)
16 Terapijas pārtraukšanas datumam ir jābūt lielākam vai vienādam ar terapijas sākuma datumu FHIRPath ID: Chemotherapy-con-11
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() >= effective.start.toDateTime(), true)
17 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: Chemotherapy-con-12
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)
18 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: Chemotherapy-con-13
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 Chemotherapy:

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