Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:services:hent_nye_bestillinger [2025-08-22 14:12] – sas
+++ fmk:1.6.0:services:hent_nye_bestillinger [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Hent nye bestillinger ======
-Service anvendes ved apoteket, til at hente nye bestillinger som er adresseret til deres organisation.
+Service anvendes på apoteket til at hente nye bestillinger, som er adresseret til deres organisation.
-====== Forespørgsel ======
+===== Forespørgsel =====
-I forespørgsel til service angives organisationens ''OrganisationIdentifier'' i denne service forventes der at dette altid er et Apotek, primært identificeret med source="EAN-lokationsnummer" (måske SOR i fremtiden).
-Herefter kan der angives en ''MaxResultSize'' Som angiver hvor mange nye bestillinger man maks ønsker returneret fra servicen.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getNewOrdersrequestType|Request]]
+I denne service angives organisationens ''OrganisationIdentifier'', som forventes altid at være et apotek, primært identificeret med source="EAN-lokationsnummer" (måske SOR i fremtiden).
+Herefter kan der angives en ''MaxResultSize'', som angiver hvor mange nye bestillinger der maks. ønskes returneret fra servicen.
 <file xml GetNewOrdersRequest.xml>
@@ Line 14: / Line 17: @@
 </file>
-===== Svar =====
+==== Svar ====
-I svar fra servicen kommer igen apotekets ''OrganisationIdentifier'' samt en række ''Warrants'' elementer med nødvendige oplysninger om de bestillinger adresseret til apoteket..
-''Warrants'' er grupperet per "patient" og elementerne indeholder følgende:
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getNewOrdersresponseType|Response]]
-  * Et ''Patient'' eller ''Organisation'' element, som udpeger ejeren af det udleveringsgrundlag som bestillingen er oprettet på.
-  * En række ''Warrant'' elementer, indeholdende informationer omkring udleveringsgrundlaget og bestillingen
-''Warrant'' elementerne indeholder følgende:
+I svaret fra servicen kommer igen apotekets ''OrganisationIdentifier'' samt en række ''Warrants'' elementer med nødvendige oplysninger om de bestillinger, der er adresseret til apoteket..
-  * ''Identifier'' ID'et på det enkelte udleveringsgrundlag
-  * Optionelt: ''AttachedToDrugMedicationIdentifier'' udpeger den lægemiddelordination som udleveringsgrundlaget er knyttet til
-  * Optionelt: ''CreatedFromDrugMedicationVersion'' udpeger den specifikke version af lægemiddelordinationen som udleveringsgrundlaget er lavet ud fra, bemærk dette kan være en historisk version.
-  * Optionelt: ''DrugMedicationEnded'' informationer omkring hvis lægemiddelordination ikke er aktiv
-  * Optionelt: ''OrderedEffectuationIdentifier'' Udpeger den anmodning om udleveringsgrundlag som dette udleveringsgrundlag er oprettet på baggrund af.
-  * ''AuthorisationDateTime'' tidspunktet for udstedelsen af udleveringsgrundlaget.
-  * ''Created'' Modifikator oplysninger omkring personen bag udleveringsgrundlaget og dennes organisation
-  * Optionelt: ''ReportedByWithoutPerson'' eller ''ReportedBy'' angivelse af modifikator oplysninger på personen som indberettede udleveringsgrundlaget til FMK
-  * Optionelt: ''LatestEffectuationDateTime'' Tidspunkt for seneste udlevering
-  * Optionelt: ''TerminatedDateTime'' Tidspunktet hvor udleveringsgrundlaget blev afsluttet
-  * Optionelt: ''ReimbursementClause'' Oplysninger omkring tilskud
-  * ''ValidFromDate'' Startdatoen for udleveringsgrundlagets gyldighedsperiode
-  * ''ValidToDate'' Slutdatoen for udleveringsgrundlagets gyldighedsperiode
-  * **Typen af udleveringsgrundlag, se punkt nedenfor**
-  * Optionelt: ''Indication'' oplysninger om indikationen for udleveringsgrundlaget
-  * ''Drug'' Oplysninger om lægemidlet
-  * Optionelt: ''DosageText'' Doseringstekst
-  * Optionelt: ''SubstitutionAllowed'' oplysninger om hvorledes substitution er tilladt
-  * Optionelt: ''SupplementaryInformation'' Supplerende oplysninger påsat ved oprettelsen af udleveringsgrundlaget
-  * Optionelt: ''InvalidationReasonText'' Tekst med grunden til at et udleveringsgrundlag er blevet markeret som invalid
-  * Optionelt: ''Deprecated'' Tidpsunkt hvorfra udleveringsgrundlaget er blevet markeret ikke relevant
-  * Optionelt: ''ReplacesWarrantIdentifier'' ID'et på et andet udleveringsgrundlag som er blevet erstattet af dette udleveringsgrundlag
-  * Optionelt: ''ReplacedByWarrantIdentifier'' ID'et på et andet udleveringsgrundlag som er erstatning for dette udleveringsgrundlag
-  * Optionelt: en række ''Order'' elementer, Informationer omkring bestillinger på dette udleveringsgrundlag
-  * Optionelt: En række ''Effectuation'' elementer, Informationer omkring udleveringerne foretaget på dette udleveringsgrundlag
-  * Optionelt: En række ''InvalidEffectuation'' elementer, indeholder en ''Identifier'' indeholdende ID'et på effektueringer som er blevet administrativt slettet fra udleveringsgrundlaget
-  * Optionelt: ''Version'' indeholder versionsnummeret for den nuværende version
-  * Optionelt: ''IsPrivateWarrant'' informationer der markere om udleveringsgrundlaget er privatmarkeret (oplysningen hentes fra lægemiddelordinationen)
-Der findes i praksis 6 forskellige typer af udleveringsgrundlag, hver med forskellige oplysninger. Informationerne omkring disse kan også findes her: [[fmk:1.6.0:xml-elementer:udleveringsgrundlag|udleveringsgrundlag]]
+''Warrants'' er grupperet per "patient" og elementerne indeholder følgende:
+  * Et ''Patient'' eller ''Organisation'' element, som udpeger ejeren af det udleveringsgrundlag, som bestillingen er oprettet på.
+  * En række ''Warrant'' elementer, indeholdende informationer omkring udleveringsgrundlaget og bestillingen.
+''Warrant''-elementerne er beskrevet her: [[fmk:1.6.0:xml-elementer:udleveringsgrundlag|Udleveringsgrundlag]]. Væsentligst for denne service er, at de indeholder ''Identifier'' (ID på udleveringsgrundlaget) samt en række ''Order''-elementer.
 Elementerne ''Order'' indeholder følgende:
-  * ''Identifier'' ID'et på den enkelte bestilling
+  * ''Identifier'', ID'et på den enkelte bestilling
-  * Enten ''Created'' eller ''CreatedWithoutPerson'' Modifikator oplysninger på den person/organisation som har oprettet denne bestilling
+  * ''Version'', versionsnummer på den enkelte bestilling
-  * ''ReportedBy'' Modifikator oplysninger omkring personen som indrapporterede denne bestilling
+  * ''Status'', Status for bestillingen
-  * ''Modified'' Modifikator oplysninger på seneste opdaterende person
+  * ''Created'', Modifikatoroplysninger på den person/organisation, som har oprettet denne bestilling
-  * ''OrderedAtPharmacy'' Organisationsoplysninger på det apotek som bestilling er sendt til/oprettet hos
+  * Optionelt: ''ReportedBy'', Modifikatoroplysninger på den person, som indrapporterede denne bestilling
-  * ''Status'' Status for bestillingen
+  * Optionelt: ''Modified'', Modifikatoroplysninger på den person, der seneste har opdateret
+  * ''OrderedAtPharmacy'', Organisationsoplysninger på det apotek, som bestilling er sendt til/oprettet hos
   * Optionelt, max 3: ''DeliveryInstructionText'' Korte tekster med leverings instruktioner
-  * Optionelt: ''Delivery'' element med oplysnigner om leveringssted
+  * Optionelt: ''Delivery'', Oplysninger om leveringssted
-  * Optionelt: ''EffectuationIdentifier'' ID på den tilknyttede effektuering.
+  * Optionelt: ''CancellationReason'', Årsag til annullering
+  * Optionelt: ''HandoverIdentifier'' ID på den tilknyttede udlevering.
+<file xml GetNewOrdersResponse.xml>
+<GetNewOrdersResponse>
+  <OrganisationIdentifier source="EAN-Lokationsnummer">5790001381615</OrganisationIdentifier>
+  <Warrants>
+    <Patient>
+      <Person>
+        <PersonIdentifier source="CPR">2008050321</PersonIdentifier>
+        <Name>
+          <GivenName>Hans</GivenName>
+          <SurName>Madsen</SurName>
+        </Name>
+        <NameProtected/>
+        <BirthDate>2005-08-20</BirthDate>
+        <Gender>male</Gender>
+      </Person>
+      <AddressLine>Falskgade 123</AddressLine>
+      <AddressLine>9000 Aalborg</AddressLine>
+      <AddressProtected/>
+    </Patient>
+    <Warrant>
+      <Identifier>68163103813</Identifier>
+      <AttachedToDrugMedicationIdentifier>3213513136</AttachedToDrugMedicationIdentifier>
+      <CreatedFromDrugMedicationVersion>435135103510</CreatedFromDrugMedicationVersion>
+      <AuthorisationDateTime>2025-09-12T12:00:00Z</AuthorisationDateTime>
+      <Created>
+        <By>
+          <HealthcareProfessional>
+            <Identifier source="Autorisation">12345</Identifier>
+            <Name>Jørgn Madsen</Name>
+          </HealthcareProfessional>
+          <Role>Læge</Role>
+          <Organisation>
+            <Identifier source="Yder">123456</Identifier>
+            <Type>Yder</Type>
+            <Name>Allé lægerne</Name>
+            <AddressLine>...</AddressLine>
+            <TelephoneNumber>...</TelephoneNumber>
+            <EmailAddress>...</EmailAddress>
+          </Organisation>
+        </By>
+        <DateTime>2025-09-12T12:00:00Z</DateTime>
+      </Created>
+      <ValidFromDate>2025-09-12Z</ValidFromDate>
+      <ValidToDate>2027-09-12Z</ValidToDate>
+      <Prescription>
+        <PackageNumber date="2025-09-12" source="Medicinpriser">599668</PackageNumber>
+        <PackageSize>
+          <Value>98.00</Value>
+          <UnitCode date="2025-09-12" source="Medicinpriser">ST</UnitCode>
+          <UnitText>stk.</UnitText>
+        </PackageSize>
+        <PackageQuantity>2</PackageQuantity>
+        <IterationNumber>3</IterationNumber>
+        <IterationInterval>2</IterationInterval>
+        <IterationIntervalUnit>uger</IterationIntervalUnit>
+      </Prescription>
+      <Indication>
+        <FreeText>Skal tages mod dine smerter</FreeText>
+      </Indication>
+      <Drug>...</Drug>
+      <DosageText>Tag 1 om aftenen</DosageText>
+      <SubstitutionAllowed/>
+      <Order>
+        <Identifier>3313581313</Identifier>
+        <Created>
+          <By>
+            <RoleSpecific>
+              <Description>Bodstedet Vinduet</Description>
+              <Description>Bestillings-systemet</Description>
+            </RoleSpecific>
+            <Role>System</Role>
+            <Organisation>
+              <Identifier source="SOR">68135103581313</Identifier>
+              <Type>bosted</Type>
+              <Name>Bodstedet Vinduet</Name>
+              <AddressLine>Adelgade 42</AddressLine>
+            </Organisation>
+          </By>
+          <DateTime>2013-10-01T00:00:00Z</DateTime>
+        </Created>
+        <OrderedAtPharmacy>
+          <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
+          <Type>Apotek</Type>
+          <Name>Apoteket ved hovedgaden</Name>
+        </OrderedAtPharmacy>
+        <Status>Bestilt</Status>
+        <Delivery>
+          <Priority>send til patientadresse samme dag</Priority>
+        </Delivery>
+      </Order>
+      <Version>3513581310303</Version>
+    </Warrant>
+  </Warrants>
+  <Warrants>...</Warrants>
+  <Warrants>...</Warrants>
+  <Warrants>...</Warrants>
+  <Warrants>...</Warrants>
+  <Warrants>...</Warrants>
+</GetNewOrdersResponse>
+</file>