ERA FHIR specification
1.0.0 - draft
ERA FHIR specification - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft as of 2026-06-25 |
<OperationDefinition xmlns="http://hl7.org/fhir">
<id value="DigitalHealthService-dispense"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition DigitalHealthService-dispense</b></p><a name="DigitalHealthService-dispense"> </a><a name="hcDigitalHealthService-dispense"> </a><p>URL: [base]/DeviceRequest/[id]/$DigitalHealthService-dispense</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>performer</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/references.html#Reference">Reference</a> (<a href="http://hl7.org/fhir/R4/organization.html" title="http://hl7.org/fhir/StructureDefinition/Organization">Organization</a>)</td><td/><td><div><p>Lunastuksen kirjaava sovellustarjoaja-organisaatio (Reference(Organization)). Tallennetaan luotavan Provenance-resurssin agent-elementtiin.</p>
</div></td></tr><tr><td>IN</td><td>registerType</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Coding">Coding</a></td><td>https://gen.kanta.fi/fhir/ValueSet/fipta-vs-registertype (Required)</td><td><div><p>Rekisteritunnus (rekisterin tyyppi, Kanta-koodisto fipta-vs-registertype). Tallennetaan luotavan Provenance-resurssin DigitalHealthServiceProvenance-profiilin extension:registerType-laajennukseen. Pakollinen jokaiselle arkistoitavalle resurssille (CC-007).</p>
</div></td></tr><tr><td>IN</td><td>registerSpecifier</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a></td><td/><td><div><p>Rekisteritunnuksen tarkenne (Kanta RegisterSpecifier-laajennus). Pakollinen täsmälleen silloin kun registerType on työterveys (koodi 4); muutoin sitä ei saa antaa. Tallennetaan luotavan Provenance-resurssin extension:registerSpecifier-laajennukseen.</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/devicerequest.html">DeviceRequest</a></td><td/><td><div><p>Päivitetty DigitalHealthServiceRequest-määräys, jonka status on siirtynyt arvoon completed ja jonka DigitalHealthServiceFulfilledDateTime-laajennus (fulfilledDateTime) on asetettu samaksi kuin luodun Provenance-resurssin recorded-aikaleima (DP-009).</p>
</div></td></tr><tr><td>OUT</td><td>provenance</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/references.html#Reference">Reference</a> (<a href="StructureDefinition-DigitalHealthServiceProvenance.html" title="http://atostek.com/dipko/fhir/StructureDefinition/DigitalHealthServiceProvenance">DIPKO Digital Health Service Provenance</a>)</td><td/><td><div><p>Referenssi palvelinpuolella luotuun Provenance-resurssiin, joka noudattaa DigitalHealthServiceProvenance-profiilia ja kirjaa lunastuksen (agent = performer, target = päivitetty määräys, recorded = tilamuutoksen ajankohta, extension:registerType = annettu rekisteritunnus).</p>
</div></td></tr></table></div>
</text>
<url
value="http://atostek.com/dipko/fhir/OperationDefinition/DigitalHealthService-dispense"/>
<version value="1.0.0"/>
<name value="DigitalHealthServiceDispense"/>
<title value="DIPKO Digital Health Service - Dispense"/>
<status value="draft"/>
<kind value="operation"/>
<date value="2026-06-25"/>
<publisher value="Atostek"/>
<contact>
<name value="Atostek"/>
<telecom>
<system value="url"/>
<value value="https://atostek.com/"/>
</telecom>
</contact>
<description
value="Kirjaa digisovellusmääräyksen (DigitalHealthServiceRequest) lunastuksen: siirtää määräyksen tilasta active tilaan completed ja luo palvelinpuolella Provenance-resurssin. Palauttaa päivitetyn määräyksen ja viittauksen luotuun Provenance-resurssiin. Vain lähtötila active sallitaan."/>
<code value="DigitalHealthService-dispense"/>
<resource value="DeviceRequest"/>
<system value="false"/>
<type value="false"/>
<instance value="true"/>
<parameter>
<name value="performer"/>
<use value="in"/>
<min value="1"/>
<max value="1"/>
<documentation
value="Lunastuksen kirjaava sovellustarjoaja-organisaatio (Reference(Organization)). Tallennetaan luotavan Provenance-resurssin agent-elementtiin."/>
<type value="Reference"/>
<targetProfile
value="http://hl7.org/fhir/StructureDefinition/Organization"/>
</parameter>
<parameter>
<name value="registerType"/>
<use value="in"/>
<min value="1"/>
<max value="1"/>
<documentation
value="Rekisteritunnus (rekisterin tyyppi, Kanta-koodisto fipta-vs-registertype). Tallennetaan luotavan Provenance-resurssin DigitalHealthServiceProvenance-profiilin extension:registerType-laajennukseen. Pakollinen jokaiselle arkistoitavalle resurssille (CC-007)."/>
<type value="Coding"/>
<binding>
<strength value="required"/>
<valueSet
value="https://gen.kanta.fi/fhir/ValueSet/fipta-vs-registertype"/>
</binding>
</parameter>
<parameter>
<name value="registerSpecifier"/>
<use value="in"/>
<min value="0"/>
<max value="1"/>
<documentation
value="Rekisteritunnuksen tarkenne (Kanta RegisterSpecifier-laajennus). Pakollinen täsmälleen silloin kun registerType on työterveys (koodi 4); muutoin sitä ei saa antaa. Tallennetaan luotavan Provenance-resurssin extension:registerSpecifier-laajennukseen."/>
<type value="string"/>
</parameter>
<parameter>
<name value="return"/>
<use value="out"/>
<min value="1"/>
<max value="1"/>
<documentation
value="Päivitetty DigitalHealthServiceRequest-määräys, jonka status on siirtynyt arvoon completed ja jonka DigitalHealthServiceFulfilledDateTime-laajennus (fulfilledDateTime) on asetettu samaksi kuin luodun Provenance-resurssin recorded-aikaleima (DP-009)."/>
<type value="DeviceRequest"/>
</parameter>
<parameter>
<name value="provenance"/>
<use value="out"/>
<min value="1"/>
<max value="1"/>
<documentation
value="Referenssi palvelinpuolella luotuun Provenance-resurssiin, joka noudattaa DigitalHealthServiceProvenance-profiilia ja kirjaa lunastuksen (agent = performer, target = päivitetty määräys, recorded = tilamuutoksen ajankohta, extension:registerType = annettu rekisteritunnus)."/>
<type value="Reference"/>
<targetProfile
value="http://atostek.com/dipko/fhir/StructureDefinition/DigitalHealthServiceProvenance"/>
</parameter>
</OperationDefinition>