Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Indhold i FMK 1.6.0 adviser ======

:!: Denne side er under udarbejdelse.

Indholdet i adviserne vil i så høj grad som muligt indeholde information, der gør det muligt at identificere, hvilket element der er ændret, samt eventuelle versionsnumre.
Adviser udsendes for personer identificeret ved CPR eller X-eCPR.

Alle XML-skemaer for 1.6.0 adviser i FMK findes under 2026/09/01 og anvender følgende namespacet ''http://fmk-teknik.dk/160/advis''.

I overgangsperioden udsender FMK både de [[fmk:advis:indhold_i_adviseringer|eksisterende adviser]] og 1.6.0 adviser.

I eksemplerne herunder er den omkringliggende NAS ''Notify''-besked udeladt. Eksemplerne viser indholdet i ''NotifyContent''.

===== NAS-topics =====

FMK 1.6.0 anvender følgende NAS-topics:

^ NAS-topic ^ Indhold ^
| ''http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated'' | Ændringer på medicinkortet, lægemiddelordinationer, udleveringsgrundlag, løse recepter, anmodninger om udleveringsgrundlag, bestillinger, udleveringer og Track and Trace-hændelser på bestillinger |
| ''http://www.sundhedsdata.dk/fmk/2026/09/01:PatientOrganisationRelationUpdated'' | Ændringer på patient-organisationsrelationer |
| ''http://www.sundhedsdata.dk/fmk/2026/09/01:PatientRegistrationUpdated'' | Ændringer på patientregistreringer |
| ''http://www.sundhedsdata.dk/fmk/2026/09/01:DispensingCardUpdated'' | Ændringer på dispenseringskort, dispenseringsperioder, registrerede ophældninger og Track and Trace-hændelser på dispenseringsperioder |

===== Fælles opbygning =====

Handlingen fremgår af ''Action''-elementet. Det øvrige indhold udpeger det objekt, som handlingen vedrører.

''PersonIdentifier'' indeholder person-id. Attributten ''source'' angiver, om id'et er et CPR- eller X-eCPR-nummer:

<code xml>
<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
</code>

Ved ændringer under medicinkortet anvendes elementet ''MedicineCardNotification''. ''MedicineCard'' indeholder altid person-id og medicinkortets version på hændelsestidspunktet. Elementet kan desuden indeholde id'er for lægemiddelordination, udleveringsgrundlag, anmodning, bestilling eller udlevering.

Medicinkortets version bumpes kun ved ændringer af lægemiddelordinationer. Ved andre hændelser indeholder adviseringen den aktuelle medicinkortversion på hændelsestidspunktet.

===== Ændringer direkte på medicinkortet =====

Ændringer direkte på medicinkortet adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

^ Handling på medicinkortet ^ Indhold i ''Action'' ^
| Ajourføring af medicinkortet | ''MedicineCardReviewed'' |
| Markering af medicinkortet som ikke ajourført | ''MedicineCardNotReviewed'' |
| Ugyldiggørelse af medicinkortet | ''MedicineCardInvalidated'' |
| Ophævelse af ugyldiggørelse | ''MedicineCardInvalidCleared'' |

**Eksempel - ajourføring af medicinkortet:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>MedicineCardReviewed</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658001002</Version>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Ændringer på lægemiddelordinationer =====

Ændringer på lægemiddelordinationer adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

Adviseringen indeholder medicinkortets version samt lægemiddelordinationens id og version.

^ Handling på lægemiddelordinationen ^ Indhold i ''Action'' ^
| Oprettelse | ''DrugMedicationCreated'' |
| Opdatering | ''DrugMedicationUpdated'' |
| Pausering | ''DrugMedicationPaused'' |
| Ophævelse af pausering | ''DrugMedicationUnpaused'' |
| Seponering | ''DrugMedicationWithdrawn'' |
| Ophævelse af seponering | ''DrugMedicationUnwithdrawn'' |
| Administrativ ugyldiggørelse | ''DrugMedicationInvalidated'' |
| Registrering af PN-kur aktiveringer | ''DrugMedicationEpisodesRegistered'' |
| Tilbageførsel af PN-kur aktiveringer | ''DrugMedicationEpisodesUnregistered'' |

**Eksempel - opdatering af en lægemiddelordination:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>DrugMedicationUpdated</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <DrugMedication>
      <Identifier>1341404077657002001</Identifier>
      <Version>1341404077658002002</Version>
    </DrugMedication>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Udleveringsgrundlag tilknyttet en lægemiddelordination =====

Et udleveringsgrundlag, for eksempel en recept, der er tilknyttet en lægemiddelordination, adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

Adviseringen indeholder medicinkortets version, lægemiddelordinationens id og version samt udleveringsgrundlagets id.

^ Handling på udleveringsgrundlaget ^ Indhold i ''Action'' ^
| Oprettelse | ''WarrantCreated'' |
| Annullering | ''WarrantCancelled'' |
| Erstatning | ''WarrantReplaced'' |
| Tilknytning til lægemiddelordination | ''WarrantAttached'' |
| Ophævelse af tilknytning | ''WarrantDetached'' |
| Markering som ikke aktuel | ''WarrantDeprecated'' |
| Ophævelse af markering som ikke aktuel | ''WarrantUndeprecated'' |
| Afslutning | ''WarrantClosed'' |
| Ugyldiggørelse | ''WarrantInvalidated'' |
| Sletning | ''WarrantDeleted'' |

**Eksempel - oprettelse af et udleveringsgrundlag:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>WarrantCreated</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <DrugMedication>
      <Identifier>1341404077657002001</Identifier>
      <Version>1341404077658002002</Version>
      <Warrant>
        <Identifier>32768</Identifier>
      </Warrant>
    </DrugMedication>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Løse recepter =====

En løs recept er et udleveringsgrundlag, der ikke er tilknyttet en lægemiddelordination. Ændringer på løse recepter adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

Adviseringen indeholder medicinkortets aktuelle version og id'et på den løse recept.

^ Handling på den løse recept ^ Indhold i ''Action'' ^
| Oprettelse | ''LoosePrescriptionCreated'' |
| Afslutning | ''LoosePrescriptionClosed'' |
| Ugyldiggørelse | ''LoosePrescriptionInvalidated'' |
| Sletning | ''LoosePrescriptionDeleted'' |
| Registrering af udlevering | ''LoosePrescriptionHandoverRegistered'' |
| Tilbageførsel af udlevering | ''LoosePrescriptionHandoverWithdrawn'' |

Ved en udlevering indeholder ''LoosePrescription'' desuden et ''Handover''-element med udleverings-id.

**Eksempel - registrering af en udlevering på en løs recept:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>LoosePrescriptionHandoverRegistered</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <LoosePrescription>
      <Identifier>32768</Identifier>
      <Handover>
        <Identifier>1341404189632004002</Identifier>
      </Handover>
    </LoosePrescription>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Udleveringer =====

Udleveringer på et udleveringsgrundlag, der er tilknyttet en lægemiddelordination, adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

^ Handling på udleveringen ^ Indhold i ''Action'' ^
| Registrering | ''WarrantHandoverRegistered'' |
| Tilbageførsel | ''WarrantHandoverWithdrawn'' |
| Administrativ ugyldiggørelse | ''WarrantHandoverInvalidated'' |

Adviseringen indeholder medicinkortets version, lægemiddelordinationens id og version, udleveringsgrundlagets id og udleveringens id.

Hvis udleveringen vedrører en lægemiddeladministration, kan ''Handover'' desuden indeholde ''DrugAdministrationIdentifier''.

**Eksempel - registrering af en udlevering:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>WarrantHandoverRegistered</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <DrugMedication>
      <Identifier>1341404077657002001</Identifier>
      <Version>1341404077658002002</Version>
      <Warrant>
        <Identifier>32768</Identifier>
        <Handover>
          <Identifier>1341404189632004002</Identifier>
        </Handover>
      </Warrant>
    </DrugMedication>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Anmodninger om udleveringsgrundlag =====

Anmodninger om et udleveringsgrundlag, for eksempel receptanmodninger, adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

Adviseringen indeholder medicinkortets version, lægemiddelordinationens id og version samt anmodningens id.

^ Handling på anmodningen ^ Indhold i ''Action'' ^
| Oprettelse | ''RequestForWarrantCreated'' |
| Afvisning eller annullering | ''RequestForWarrantCancelled'' |
| Opfyldelse ved oprettelse af udleveringsgrundlag | ''RequestForWarrantFulfilled'' |
| Sletning | ''RequestForWarrantDeleted'' |
| Videresendelse | ''RequestForWarrantForwarded'' |

Ved ''RequestForWarrantFulfilled'' indeholder ''RequestForWarrant'' desuden id'et for det udleveringsgrundlag, der opfyldte anmodningen.

**Eksempel - opfyldelse af en anmodning:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>RequestForWarrantFulfilled</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <DrugMedication>
      <Identifier>1341404077657002001</Identifier>
      <Version>1341404077658002002</Version>
      <RequestForWarrant>
        <Identifier>1341404077678001001</Identifier>
        <Warrant>
          <Identifier>32768</Identifier>
        </Warrant>
      </RequestForWarrant>
    </DrugMedication>
  </MedicineCard>
</MedicineCardNotification>
</code>

Ved opfyldelse udsendes der også et separat advis om oprettelse af udleveringsgrundlaget.

===== Bestillinger =====

Bestillinger på et udleveringsgrundlag adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

^ Handling på bestillingen ^ Indhold i ''Action'' ^
| Oprettelse | ''OrderCreated'' |
| Opdatering, herunder annullering | ''OrderUpdated'' |
| Kvittering for modtagelse | ''OrderAcknowledged'' |

Adviseringen indeholder medicinkortets version, lægemiddelordinationens id og version, udleveringsgrundlagets id og bestillingens id.

**Eksempel - oprettelse af en bestilling:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>OrderCreated</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <DrugMedication>
      <Identifier>1341404077657002001</Identifier>
      <Version>1341404077658002002</Version>
      <Warrant>
        <Identifier>32768</Identifier>
        <Order>
          <Identifier>1341404077678001002</Identifier>
        </Order>
      </Warrant>
    </DrugMedication>
  </MedicineCard>
</MedicineCardNotification>
</code>

===== Dispenseringskort og dispenseringsperioder =====

Ændringer på dispenseringskort og dispenseringsperioder adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:DispensingCardUpdated

^ Handling ^ Indhold i ''Action'' ^
| Oprettelse af dispenseringskort | ''DispensingCardCreated'' |
| Lukning af dispenseringskort | ''DispensingCardClosed'' |
| Statusændring på dispenseringsperiode | ''DispensingPeriodStatusChanged'' |
| Registrering af ophældning | ''DispensingRegistered'' |

Adviseringen indeholder person-id og dispenseringskortets id. Ved handlinger på en dispenseringsperiode indeholder adviseringen også periodens id.

Ved ''DispensingPeriodStatusChanged'' indeholder adviseringen både ''OldStatus'' og ''NewStatus''. Ved ''DispensingRegistered'' indeholder den id'et for den registrerede ophældning.

**Eksempel - statusændring på en dispenseringsperiode:**

<code xml>
<DispensingCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>DispensingPeriodStatusChanged</Action>
  <DispensingCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Identifier>1341404077657003001</Identifier>
    <DispensingPeriod>
      <Identifier>1341404077657003002</Identifier>
      <OldStatus>ReadyForPacking</OldStatus>
      <NewStatus>PackingStarted</NewStatus>
    </DispensingPeriod>
  </DispensingCard>
</DispensingCardNotification>
</code>

===== Patient-organisationsrelationer =====

Ændringer på patient-organisationsrelationer adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:PatientOrganisationRelationUpdated

^ Handling ^ Indhold i ''Action'' ^
| Oprettelse af relation | ''RelationCreated'' |
| Fjernelse af relation | ''RelationRemoved'' |

Adviseringen indeholder person-id og relation-id. Relationstype og organisation medsendes ikke.

**Eksempel - oprettelse af en relation:**

<code xml>
<PatientOrganisationRelationNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>RelationCreated</Action>
  <RelationIdentifier>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Identifier>12313213211001001</Identifier>
  </RelationIdentifier>
</PatientOrganisationRelationNotification>
</code>

===== Patientregistreringer =====

Ændringer på patientregistreringer adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:PatientRegistrationUpdated

^ Handling ^ Indhold i ''Action'' ^
| Oprettelse af registrering | ''RegistrationCreated'' |
| Fjernelse af registrering | ''RegistrationRemoved'' |

Adviseringen indeholder person-id og registrerings-id. Registreringstype og organisation medsendes ikke.

**Eksempel - fjernelse af en patientregistrering:**

<code xml>
<PatientRegistrationNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>RegistrationRemoved</Action>
  <RegistrationIdentifier>
    <PersonIdentifier source="X-eCPR">X123456789</PersonIdentifier>
    <Identifier>12313213211001001</Identifier>
  </RegistrationIdentifier>
</PatientRegistrationNotification>
</code>

===== Track and Trace =====

Track and Trace-hændelser på bestillinger adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:MedicineCardUpdated

Track and Trace-hændelser på dispenseringsperioder adviseres på følgende NAS-topic:

  http://www.sundhedsdata.dk/fmk/2026/09/01:DispensingCardUpdated

''Action'' er ''TrackAndTraceUpdated''. Adviseringen indeholder id for Track and Trace-hændelsen samt id'et for den bestilling eller dispenseringsperiode, som hændelsen vedrører.

**Eksempel - Track and Trace-hændelse på en bestilling:**

<code xml>
<MedicineCardNotification xmlns="http://fmk-teknik.dk/160/advis">
  <Action>TrackAndTraceUpdated</Action>
  <MedicineCard>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Version>1341404077658002001</Version>
    <Order>
      <Identifier>1341404077678001002</Identifier>
      <TrackAndTraceEventIdentifier>1341404077678001003</TrackAndTraceEventIdentifier>
    </Order>
  </MedicineCard>
</MedicineCardNotification>
</code>

Ved en Track and Trace-hændelse på en dispenseringsperiode anvendes ''DispensingCardNotification'', hvor ''DispensingPeriod'' indeholder ''TrackAndTraceEventIdentifier''.

===== Manglende adviser =====

Hvis adviser kan være gået tabt, udsendes et ''LostAdvis'' på alle NAS-topics for 1.6.0 adviser.

''ResumeAt'' angiver tidspunktet, hvor udsendelsen af adviser blev genoptaget. Efter modtagelse skal systemet synkronisere de relevante data igen.

<code xml>
<LostAdvis xmlns="http://fmk-teknik.dk/160/advis">
  <ResumeAt>2026-09-30T12:00:00Z</ResumeAt>
</LostAdvis>
</code>

===== Handlinger som endnu ikke udsendes =====

Følgende handlinger findes i 2026/09/01-skemaet, men udsendes endnu ikke:

^ Område ^ Handlinger ^
| Lægemiddeladministration | ''DrugAdministrationCreated'', ''DrugAdministrationRemoved'', ''DrugAdministrationInvalidated'' |
| Bestilling | ''OrderDeleted'' |