Endokrīnā ārstēšana

Apraksts

Informācija par endokrīnās terapijas ārstēšanu.

Endokrīnās ārstēšanas datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss MedicationStatement, uz kura pamata izveidots FHIR profils EndocrineTherapy.

Apstrāde

  1. Iesūtot endokrīnās ārstēšanas 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 Endokrīnās terapijas veids
Standard:
MedicationStatement.category
0..1 Pēc 01.01.2024: 1..1 Type of medication usage Endokrīnās terapijas veids:
1.3.6.1.4.1.38760.2.875
5 Endokrīnās terapijas līnija Extension:
TherapyLineExtension
0..1 Endokrīnās terapijas līnija:
1.3.6.1.4.1.38760.2.641
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 Endokrīnās terapijas sākuma datuma Standard:
MedicationStatement.effective.start
1..1 When the procedure was performed Time range defined by start and end date/time
8 Endokrīnās terapijas beigu datums Standard:
MedicationStatement.effective.end
0..1 When the procedure was performed Time range defined by start and end date/time
9 Norāde par pacientu tālāko ārstēšanu/ uzraudzību
Extension:
FollowUpExtension
Slice:
folowUp
0..1 Pacienta tālāka ārstēšana vai uzraudzība:
1.3.6.1.4.1.38760.2.629
10 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
11 Pārtraukšanas datums Extension:
TerminationDateExtension
0..1
12 Pārtraukšanas iemesls Extension:
TerminationReasonExtension
0..1 Terapijas pārtraukšanas iemesls:
1.3.6.1.4.1.38760.2.877
13 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
14 Ārējās sistēmas ieraksta ID Standard:
MedicationStatement.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
15 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
16 Ārstēšanas kartes statuss Extension:
CardStatusExtension
1..1 Ārstēšanas karte var būt statusā 2-Iesniegta vai 3-Anulēta
17 Ā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
18 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
19 Ā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
endocrineTherapyLineI0..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: EndocrineTherapy-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 endokrīnās terapijas veids Kardinalitāte MedicationStatement.category.coding:endocrineTherapyType 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 Terapijas sākuma datums – obligāts, datums nedrīkst būt nākotnē FHIRPath ID: EndocrineTherapy-con-2
iif(effective.start.exists(), effective.start.toDateTime() <= now(), false)
7 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-41
8 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)
9 Terapijas beigu datums (neobligāts), Datums nedrīkst būt nākotē & nedrīkst būt mazāks par sākuma datumu (var būt vienāds vai lielāks) FHIRPath ID: EndocrineTherapy-con-3
iif(effective.end.exists(), effective.end.toDateTime() <= now() and effective.end.toDateTime() >= effective.start.toDateTime(), true)
10 Kā medikamentu var iesūtīt tikai piektā līmeņa ierakstu (aktīvas vielas līmeņa ierakstu, piemēram: L02AA03 ethinylestradiol). FHIRPath ID: EndocrineTherapy-con-4
medicationCodeableConcept.coding.all(code.matches('^.{7}$'))
11 Ja tiek aizpildīts lauks Endokrīnās terapijas līnija, tad tam jāatbilst 1.3.6.1.4.1.38760.2.641 klasifikatoram FHIRPath ID: EndocrineTherapy-con-5
iif(extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TherapyLine-v1').value.coding.code.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TherapyLine-v1').value.coding.system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.641', true)
12 Ja Endokrīnās terapijas sākuma datums ir pēc 01.01.2024, tad Endokrīnas terapijas veids ir obligāts FHIRPath ID: EndocrineTherapy-con-6
iif(effective.start >= '2024-01-01T00:00:00.000Z'.toDateTime(), category.coding.where(system='https://vvis.gov.lv/fhir/ValueSet/1.3.6.1.4.1.38760.2.875').code.exists(), true)
13 Vienlaikus var norādīt tikai vienu ārstniecības iestādi – Latvijas no klasifikatora, vai ārvalstu teksta laukā FHIRPath ID: EndocrineTherapy-con-7
(informationSource.reference.exists() implies informationSource.extension.value.exists().not()) and (informationSource.extension.value.exists() implies informationSource.reference.exists().not())
14 Ārstēšanas kartes statuss var būt tikai 2-Iesniegta vai 3-Anulēta FHIRPath ID: EndocrineTherapy-con-8
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$')
15 Endokrīnās ārstēšanas gadījumā jānorāda ārstēšanas veids 4-Endokrīnā ārstēšana FHIRPath ID: EndocrineTherapy-con-9
$this='https://onko.vvis.gov.lv/fhir/StructureDefinition/MedicationStatement/EndocrineTherapy-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 = '4')
16 Ja ārstēšanas kartei tiek uzstādīts statuss "3-Anulēta", tad obligāti ir jānorāda anulēšanas iemesls FHIRPath ID: EndocrineTherapy-con-10
$this='https://onko.vvis.gov.lv/fhir/StructureDefinition/MedicationStatement/EndocrineTherapy-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 = '4')
17 Pārtraukšanas datums nav atļauts, ja ir aizpildīts terapijas beigu datums FHIRPath ID: EndocrineTherapy-con-11
iif(effective.end.exists(), extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/TerminationDateExtension-v1').value.exists().not(), true)
18 Terapijas pārtraukšanas datumam ir jābūt lielākam vai vienādam ar terapijas sākuma datumu FHIRPath ID: EndocrineTherapy-con-12
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)
19 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: EndocrineTherapy-con-13
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)
20 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: EndocrineTherapy-con-14
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 EndocrineTherapy:

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