Ķirurģija

Apraksts

Informācija par ķirurģisku ārstēšanu.

Ķirurģijas datu apmaiņas nodrošināšanai tiek izmantots FHIR R4B bāzes resurss Procedure, uz kura pamata izveidots FHIR profils Surgery.

Apstrāde

  1. Iesūtot ķirurģijas 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
4 Operācijas veids Standard:
Procedure.category
1..1 A code that classifies the procedure for searching, sorting and display purposes (e.g. "Surgical Procedure"). Operācijas veids:
1.3.6.1.4.1.38760.2.630
5 Operācijas datums Standard:
Procedure.performed dateTime
1..1 Estimated or actual date, date-time, period, or age when the procedure was performed. Allows a period to support complex procedures that span more than one date, and also allows for the length of the procedure to be captured.
6 Operācijas kods (NOMESCO) Standard:
Procedure.code
1..* The specific procedure that is performed. Use text if the exact nature of the procedure cannot be coded (e.g. "Laparoscopic Appendectomy"). (NOMESCO) Ziemeļvalstu ķirurģisko procedūru klasifikācija:
1.3.6.1.4.1.38760.2.175
7 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
8 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

Citi profila obligātie datu lauki:

Nr. Datu lauks FHIR Lauks Kard. FHIR lauka apraksts Detaļas
9 Ārējās sistēmas ieraksta ID Standard:
Procedure.identifier
1..1 External identifier Tiek izmantots identifikatora tips “EXTERNAL_SYSTEM_IDENTIFIER”
10 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
11 Ārstēšanas kartes statuss Extension:
CardStatusExtension
1..1 Ārstēšanas karte var būt statusā 2-Iesniegta vai 3-Anulēta
12 Ā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
13 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
14 Ā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
cardStatusExtensionI1..1Extension(CodeableConcept)
cardStatusDateExtensionI0..1Extension(dateTime)
cardStatusReasonExtensionI0..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
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
encounterΣ I0..0Reference(Encounter)
performedDateTimedateTime
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..0Identifier
displayΣ0..0string
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: Surgery-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 operācijas datums un vai tas ir korekts (nevar būt datums norādīts nākotnē) FHIRPath ID: Surgery-con-2
iif(performedDateTime.exists(), performedDateTime.toDateTime() <= now(), false)
4 Ķirurģijas gadījumā jānorāda ārstēšanas veids 1—Ķirurģija FHIRPath ID: Surgery-con-3
$this='https://onko.vvis.gov.lv/fhir/StructureDefinition/Procedure/Surgery-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 = '1')
5 Ārstēšanas kartes statuss var būt tikai 2-Iesniegta vai 3-Anulēta FHIRPath ID: Surgery-con-4
extension.where(url='https://onko.vvis.gov.lv/fhir/StructureDefinition/CardStatusExtension-v1').value.coding.code.matches('^2$|^3$')
6 Vienlaikus var norādīt tikai vienu ārstniecības iestādi – Latvijas no klasifikatora, vai ārvalstu teksta laukā FHIRPath ID: Surgery-con-5
(performer.actor.reference.exists() implies performer.actor.extension.value.exists().not()) and (performer.actor.extension.value.exists() implies performer.actor.reference.exists().not())
7 Operācijas datums nedrīkst būt agrāk kā 30 dienas pirms diagnozes noteikšanas datuma FHIRPath Validācija tiek definēta Bundle resursa ietvaros ar ID: OncologyBundle-con-38
8 Operācijas 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 Vai ir norādīts vismaz viens operācijas ieraksts FHIRPath Procedure.code.coding kardinalitāte ir uzstādīta 1..*
10 Ja ārstēšanas kartei tiek uzstādīts statuss "3-Anulēta", tad obligāti ir jānorāda anulēšanas iemesls FHIRPath ID: Surgery-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.exists(), true)

Datu iesūtīšanas piemēri

Skatīt Postman kolekcijas struktūru Surgery:

Darbība Nosaukums Apraksts
POST Create Surgery Jaunas ārstēšanas - ķirurģija iesūtīšana
POST Create Surgery (foreign medical institution) Jaunas ārstēšanas - ķirurģija iesūtīšana, norādot ārvalstu ārstniecības iestādi, kurā saņemta ārstēšana.

💡 Visos ārstēšanas piemēros tiek izmantots vienots princips ārvalstu iestādes norādīšanai caur extension “ForeignMedicalInstitutionExtension” lauku, tāpēc piemērs ar ārvalstu iestādi netiek atsevišķi dublēts katrā no ārstēšanām.
POST Create Surgery (2 disease cards references) Jaunas ārstēšanas - ķirurģija iesūtīšana, norādot vairākas slimības kartes.

💡 Visos ārstēšanas piemēros tiek izmantots vienots princips vairāku slimības karšu norādīšanai, tāpēc piemērs netiek atsevišķi dublēts katrā no ārstēšanām.
POST Create Surgery (historical cards) Jaunas ārstēšanas - ķirurģija iesūtīšana, iekļaujot arī vēsturiskos datu laukus
GET Get Surgery Esošas ārstēšanas - ķirurģija izgūšana pēc ID
PUT Update Surgery Esošas ārstēšanas - ķirurģija datu labošana
GET Search for Surgery entry by OncologyBasicDataOfDisease reference Ķirurģijas kartes meklēšana pēc Slimības pamatdatu references