Differences

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

--- fmk:1.6.0:services:hent_nye_bestillinger [2025-09-12 12:29] – [Svar] 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
+''Warrants'' er grupperet per "patient" og elementerne indeholder følgende:
-  * Optionelt: ''CreatedFromDrugMedicationVersion'' udpeger den specifikke version af lægemiddelordinationen som udleveringsgrundlaget er lavet ud fra, bemærk dette kan være en historisk version.
+  * Et ''Patient'' eller ''Organisation'' element, som udpeger ejeren af det udleveringsgrundlag, som bestillingen er oprettet på.
-  * Optionelt: ''DrugMedicationEnded'' informationer omkring hvis lægemiddelordination ikke er aktiv
+  * En række ''Warrant'' elementer, indeholdende informationer omkring udleveringsgrundlaget og bestillingen.
-  * 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]]
+''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>
+  <OrganisationIdentifier source="EAN-Lokationsnummer">5790001381615</OrganisationIdentifier>
-	<Warrants>
+  <Warrants>
-		<Patient>
+    <Patient>
-			<Person>
+      <Person>
-				<Name>
+        <PersonIdentifier source="CPR">2008050321</PersonIdentifier>
-					<GivenName>Hans</GivenName>
+        <Name>
-					<SurName>Madsen</SurName>
+          <GivenName>Hans</GivenName>
-				</Name>
+          <SurName>Madsen</SurName>
-				<NameProtected/>
+        </Name>
-				<PersonIdentifier source="CPR">2008050321</PersonIdentifier>
+        <NameProtected/>
-				<BirthDate>2005-08-20</BirthDate>
+        <BirthDate>2005-08-20</BirthDate>
-				<Gender>male</Gender>
+        <Gender>male</Gender>
-			</Person>
+      </Person>
-			<Address>
+      <AddressLine>Falskgade 123</AddressLine>
-				<StreetName>Falskgade</StreetName>
+      <AddressLine>9000 Aalborg</AddressLine>
-				<StreetBuildingIdentifier>123</StreetBuildingIdentifier>
+      <AddressProtected/>
-				<PostCodeIdentifier>9000</PostCodeIdentifier>
+    </Patient>
-				<DistrictName>Aalborg</DistrictName>
+    <Warrant>
-			</Address>
+      <Identifier>68163103813</Identifier>
-			<AddressProtected/>
+      <AttachedToDrugMedicationIdentifier>3213513136</AttachedToDrugMedicationIdentifier>
-		</Patient>
+      <CreatedFromDrugMedicationVersion>435135103510</CreatedFromDrugMedicationVersion>
-		<Warrant>
+      <AuthorisationDateTime>2025-09-12T12:00:00Z</AuthorisationDateTime>
-			<Identifier>68163103813</Identifier>
+      <Created>
-			<AttachedToDrugMedicationIdentifier>3213513136</AttachedToDrugMedicationIdentifier>
+        <By>
-			<CreatedFromDrugMedicationVersion>435135103510</CreatedFromDrugMedicationVersion>
+          <HealthcareProfessional>
-			<AuthorisationDateTime>2025-09-12T12:00:00Z</AuthorisationDateTime>
+            <Identifier source="Autorisation">12345</Identifier>
-			<Created>
+            <Name>Jørgn Madsen</Name>
-				<By>
+          </HealthcareProfessional>
-					<HealthcareProfessional>
+          <Role>Læge</Role>
-						<Identifier source="Autorisation">12345</Identifier>
+          <Organisation>
-						<Name>Jørgn Madsen</Name>
+            <Identifier source="Yder">123456</Identifier>
-					</HealthcareProfessional>
+            <Type>Yder</Type>
-					<Role>Læge</Role>
+            <Name>Allé lægerne</Name>
-					<Organisation>
+            <AddressLine>...</AddressLine>
-						<Name>Allé lægerne</Name>
+            <TelephoneNumber>...</TelephoneNumber>
-						<AddressLine>...</AddressLine>
+            <EmailAddress>...</EmailAddress>
-						<TelephoneNumber>...</TelephoneNumber>
+          </Organisation>
-						<EmailAddress>...</EmailAddress>
+        </By>
-						<Type>Yder</Type>
+        <DateTime>2025-09-12T12:00:00Z</DateTime>
-						<Identifier source="Yder">123456</Identifier>
+      </Created>
-					</Organisation>
+      <ValidFromDate>2025-09-12Z</ValidFromDate>
-				</By>
+      <ValidToDate>2027-09-12Z</ValidToDate>
-				<DateTime>2025-09-12T12:00:00Z</DateTime>
+      <Prescription>
-			</Created>
+        <PackageNumber date="2025-09-12" source="Medicinpriser">599668</PackageNumber>
-			<ValidFromDate>2025-09-12Z</ValidFromDate>
+        <PackageSize>
-			<ValidToDate>2027-09-12Z</ValidToDate>
+          <Value>98.00</Value>
-			<Prescription>
+          <UnitCode date="2025-09-12" source="Medicinpriser">ST</UnitCode>
-				<PackageNumber date="2025-09-12" source="Medicinpriser">599668</PackageNumber>
+          <UnitText>stk.</UnitText>
-				<PackageSize>
+        </PackageSize>
-					<Value>98.00</Value>
+        <PackageQuantity>2</PackageQuantity>
-					<UnitCode date="2025-09-12" source="Medicinpriser">ST</UnitCode>
+        <IterationNumber>3</IterationNumber>
-					<UnitText>stk.</UnitText>
+        <IterationInterval>2</IterationInterval>
-				</PackageSize>
+        <IterationIntervalUnit>uger</IterationIntervalUnit>
-				<PackageQuantity>2</PackageQuantity>
+      </Prescription>
-				<IterationNumber>3</IterationNumber>
+      <Indication>
-				<IterationInterval>2</IterationInterval>
+        <FreeText>Skal tages mod dine smerter</FreeText>
-				<IterationIntervalUnit>uger</IterationIntervalUnit>
+      </Indication>
-			</Prescription>
+      <Drug>...</Drug>
-			<Indication>
+      <DosageText>Tag 1 om aftenen</DosageText>
-				<FreeText>Skal tages mod dine smerter</FreeText>
+      <SubstitutionAllowed/>
-			</Indication>
+      <Order>
-			<Drug>...</Drug>
+        <Identifier>3313581313</Identifier>
-			<DosageText>Tag 1 om aftenen</DosageText>
+        <Created>
-			<SubstitutionAllowed>true</SubstitutionAllowed>
+          <By>
-			<SupplementaryInformation>Husk at altid tage medicin sammen med mad</SupplementaryInformation>
+            <RoleSpecific>
-			<Order>
+              <Description>Bodstedet Vinduet</Description>
-				<Identifier>3313581313</Identifier>
+              <Description>Bestillings-systemet</Description>
-				<Created>
+            </RoleSpecific>
-					<By>
+            <Role>System</Role>
-						<RoleSpecific>
+            <Organisation>
-							<NameLine>Bodstedet Vinduet</NameLine>
+              <Identifier source="SOR">68135103581313</Identifier>
-							<NameLine>Bestillings-systemet</NameLine>
+              <Type>bosted</Type>
-						</RoleSpecific>
+              <Name>Bodstedet Vinduet</Name>
-						<Role>System</Role>
+              <AddressLine>Adelgade 42</AddressLine>
-						<Organisation>
+            </Organisation>
-							<Name>Bodstedet Vinduet</Name>
+          </By>
-							<AddressLine>Adelgade 42</AddressLine>
+          <DateTime>2013-10-01T00:00:00Z</DateTime>
-							<Type>bosted</Type>
+        </Created>
-							<Identifier source="SOR">68135103581313</Identifier>
+        <OrderedAtPharmacy>
-						</Organisation>
+          <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
-					</By>
+          <Type>Apotek</Type>
-					<DateTime>2013-10-01T00:00:00Z</DateTime>
+          <Name>Apoteket ved hovedgaden</Name>
-				</Created>
+        </OrderedAtPharmacy>
-				<OrderedAtPharmacy>
+        <Status>Bestilt</Status>
-					<Name>Apoteket ved hovedgaden</Name>
+        <Delivery>
-					<Type>Apotek</Type>
+          <Priority>send til patientadresse samme dag</Priority>
-					<Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
+        </Delivery>
-				</OrderedAtPharmacy>
+      </Order>
-				<Status>Bestilt</Status>
+      <Version>3513581310303</Version>
-				<Delivery>
+    </Warrant>
-					<Priority>send til patientadresse samme dag</Priority>
+  </Warrants>
-				</Delivery>
+  <Warrants>...</Warrants>
-			</Order>
+  <Warrants>...</Warrants>
-			<Version>3513581310303</Version>
+  <Warrants>...</Warrants>
-		</Warrant>
+  <Warrants>...</Warrants>
-	</Warrants>
+  <Warrants>...</Warrants>
-	<Warrants>...</Warrants>
-	<Warrants>...</Warrants>
-	<Warrants>...</Warrants>
-	<Warrants>...</Warrants>
-	<Warrants>...</Warrants>
 </GetNewOrdersResponse>
 </file>