Page History
| Table of Contents | ||
|---|---|---|
|
Indledning
Denne vejledning beskriver de tekniske forudsætninger i forhold til at implementere Aftaleoversigten i et lokalt fagsystem eller en borgerportal. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at disse kan vurdere hvordan Aftaleoversigten kan implementeres i systemerne.Det er vigtigt at forretningsregler og indhold i Aftaleoversigten også læses i forbindelse med ønsket tilslutning til Aftaleoversigten.
IHE XDS Metadata
På nationalt plan er der udarbejdet en indholdsprofil for et CDA XML-dokument (APD-DK 2.0.1), der kan beskrive en aftale med en patient. Indholdsprofilen er forankret hos MedCom.
Disse dokumenter skal, på nationalt plan, opbevares i et “IHE XDS Repository”, og der skal foretages en registrering af dokumentet i det nationale “IHE XDS Registry”, således at aftaledokumenter kan fremfindes på tværs af sundhedsvæsenets aktører.
For aktører i sundhedsvæsenet, der ikke ønsker at etablere et eget “repository”, etableres et statsligt “repository” til opbevaring af aftaledokumenter.
...
De standardiserede IHE XDS-snitflader kan anvendes til at give patienter det samlede overblik over deres aftaler via sundhed.dk eller borgerrettede kanaler, såsom borgerapps (fx MinSundhed og MinLæge).
Aktører i løsningen
Som beskrevet ovenfor kan forskellige aktører i sundhedsvæsenet registrere aftaler med patienten, og de samme aktører kan ligeledes fremsøge og hente information om patientens aftaler. På den måde åbnes der op for at læger, kommuner og hospitaler kan danne sig et overblik over de aftaler der er lavet med en patient, og patienten får samtidig mulighed for at se sine aftaler på tværs af de forskellige aktører.
...
I de følgende afsnit, beskrives det hvordan DK-APD 2.0.1 anvendes, samt hvilke forretningsregler lokale fagsystemer og borgerportaler skal implementere for at understøtte Aftaleoversigten.
Anden dokumentation
Teknisk oversigt
Udveksling af patientens Aftaleoversigt foregår via den nationale infrastruktur til dokumentdeling. Denne understøtter referencearkitekturen for deling af dokumenter og billeder.
...
For detaljeret teknisk dokumentation omkring dokumentdeling via NSP, se NSP'ensDokumentdelingsservice.
Teknisk implementering
Den centrale komponent i Aftaleoversigten er det nationale registry, hvor søgbar metadata information om dokumenter opbevares, herunder aftaledokumenter. Denne komponent implementeres af “Document Registry” i nedenstående figur.
...
NSP stiller et nationalt dokument repository til rådighed til opbevaring af dokumenter til Aftaleoversigten. De parter, der implementerer løsninger som en del af Aftaleoversigten, kan vælge imellem at benytte det nationale dokument repository, at implementere deres eget repository, eller implementere en “On Demand Document Source”.
Fælles for disse løsninger er dog at metadata skal registreresenten i det nationale dokument registry, eller også i efter dokument-registry som har integration til den nationale delingsinfrastruktur.
Indhold i Aftaleoversigt
Først og fremmest skal man kende til det indholdsformat, der benyttes til aftaledokumenter. Formatet er XML, og indholdet er specificeret som en dansk profil af CDA. Den danske profil for CDA Appointment (APD-DK 2.0.1) er forankret hos MedCom der står for den danske profilering. Se under MedCom APD-DK, hvor både beskrivelse af standarden samt forskellige aftale eksempler opbevares. Bemærk at der findes eksempler til alle versioner af APD-DK.Eksempler til APD-DK 2.0.1 findes i version 2.0 folderen.
Update 20/10-2020: Der er udgivet en Errata, hvori der er enkelte præciseringer samt rettelser af fejl i forhold til APD-DK 2.0.1, Errata'en kan hentes på MedCom's hjemmeside, og er gældende sammen med APD-DK 2.0.1 profilen.
...
Systemer der tilsluttes Aftaleoversigten, skal godkendes af MedCom ud fra en certificering. Testprotokollerne for certificering til Aftaleoversigten, kan findes på MedCom's hjemmeside under: Testprotokoller for modtagelse og afsendelse af Aftaler. Version 1.1 er gældende for afsendelse og version 1.0 er gældende for modtagelse.
Der er enkelte afvigelser i test-protokollerne for afsendelse og modtagelse af aftaler, der ikke er defineret under forretningsreglerne. Nedenstående tabel viser disse afvigelser.
| Krav ID | Krav | Afvigelse |
|---|---|---|
| Afsendelse krav 4.7 | Redegør for hvordan erstatnings CPR håndteres | Der er ingen forretningsregel, der definerer at erstatnings-CPR skal kunne benyttes. Der er ikke noget krav til systemet, at de skal anvende erstatnings CPR-numre til afsendelse af Aftaler. |
| Afsendelse krav 4.24 | Aftaler som uploades skal, hvis de er del af et repetitionsmønster, uploades et år frem i tiden | Forretningsregel #3 definerer: at repetitionsmønsteret er gentaget 6 måneder frem, afhængigt af om repetitionerne stadig foregår. Systemet der skal tilsluttes Aftaleoversigten, skal kunne håndtere et repetitionsmønster på 6 måneder, eller 3 mdr. i forhold til servicelovsaftaler som forretningsregel #3 angiver. |
| Afsendelse krav 4.27 | Opret en ny aftale med angivelse af forløbs-label og forløbs-id | Oprettelse af Aftale med forløbslabel og forløbs-id er ikke et krav i forhold til forretningsreglerne for Aftaleoversigten. CDA-Profilen (APD-DK 2.0.1) er en profil, der giver fagsystemer, som har behov for at dele forløbslabel og forløbs-id mulighed for det. Der er ikke noget krav til at systemet kan oprette Aftaler med forløbslabel og forløbs-id. |
| Modtagelse krav 4.2 | Vis aftale-indhold (aftale med region) fra testeksempel 1.5, hvor følgende er beskrevet: Vis aftale forløbs-label og alle forløbs-id som er angivet i testeksemplet. Vis at det kun er muligt at se forløbs-label i detaljeret visning (hvis dette er muligt). Vis at det hverken er muligt at se forløbs-id i simpel eller evt. detaljeret visning. Forløbs-id skal som minimum vises i det hentede CDA dokument | Visning af aftaler med forløbslabel og forløbs-id, er ikke et krav i forhold til forretningsreglerne for Aftaleoversigten. Fagsystemerne skal dog kunne håndtere modtagelse af aftaler, hvori forløbslabel og forløbs-id er inkluderet. Der er ikke noget krav til,at systemet kan vise aftaler med forløbslabel og forløbs-id. |
Yderligere information om om hvordan CDA dokumenter er opbygget, kan findes hos IHE, under: IHE - Hvad er HL7 CDA?
Aftaler i APD-DK 2.0.1 indeholder information, som defineret i nedenstående tabel
| Kode | Beskrivelse | Eksempel |
ID for aftalen | Den unikke identifikation for aftalen | <id |
Patienten aftalen omhandler ...recordTarget.patientRole | Patientens Navn og CPR nr. | <patientRole classCode="PAT"> <id extension="2512489996" root="1.2.208.176.1.2" assigningAuthorityName="CPR"/> <patient classCode="PSN" determinerCode="INSTANCE"> <name> <given>Nancy</given> <given>Ann</given> <family>Berggren</family> </name> <administrativeGenderCode code="F" codeSystem="2.16.840.1.113883.5.1"/> <birthTime value="19481225000000+0000"/> </patient> </patientRole> |
Ansvarlig for aftalen ClinicalDocument.author | Den organisation og person der er ansvarlig for aftalen Der kan tilføjes et ekstra "author" element, efter den aftale ansvarlige, dette vil være rekvirenten for aftalen hvis en sådan er tilgængelig. <code code="REFB" codeSystem="2.16.840.1.113883.5.90" codeSystemName="ParticipationType (HL7) Code System" displayName="ParticipationReferredBy"/> Bemærk at "code" er ændret på baggrund af tastefejl, til "REFB" - dette kan ses i Errata_APD-DK-v2.0.1_20_10_2020 | <author typeCode="AUT" contextControlCode="OP"> <time value="20190816100000+0100"/> <assignedAuthor classCode="ASSIGNED"> <id extension="378631000016009" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> <addr use="WP"> <assignedPerson classCode="PSN" determinerCode="INSTANCE"><name> </assignedAuthor> </author> |
Forvalter for CDA dokumentet, hvori aftalen indgår ClinicalDocument.custodian | Forvalteren er den myndighed, der sørger for opbevaring og udlevering af CDA-dokumentet ved relevante forespørgsler. Forvalteren er ligeledes ansvarlig for at CDA-dokumentet behandles på lovlig og forsvarlig vis, når det er i forvalterens varetægt. Forvalteren er ikke ansvarlig for det sundhedsspecifikke indhold i CDA-dokumentet. | <custodian typeCode="CST"> <assignedCustodian classCode="ASSIGNED"> <representedCustodianOrganization classCode="ORG" determinerCode="INSTANCE"> <id extension="378631000016009" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> </representedCustodianOrganization> </assignedCustodian> </custodian> |
Start dato og tidspunkt for aftalen documentationOf.serviceEvent. templateId | Start dato og tidspunkt for aftalen | <documentationOf typeCode="DOC"> <serviceEvent classCode="MPROT" moodCode="EVN"> <templateId root="1.2.208.184.200.1.11" extension="2019-09-10"/> <effectiveTime> <low value="20191231090000+0100"/> <high value="20191231120000+0100"/> </effectiveTime> </serviceEvent> </documentationOf> |
Slut dato og tidspunkt for aftalen documentationOf.serviceEvent. templateId | Slut dato og tidspunkt for aftalen | <documentationOf typeCode="DOC"> <serviceEvent classCode="MPROT" moodCode="EVN"> <templateId root="1.2.208.184.200.1.11" extension="2019-09-10"/> <effectiveTime> <low value="20191231090000+0100"/> <high value="20191231120000+0100"/> </effectiveTime> </serviceEvent> </documentationOf> |
Indikation om tidspunkterne i aftalen er vejledende <body>.encounter.preCondition templateId code | Hvis tidspunkterne i aftalen er vejledende vil | <precondition> <templateId root="1.2.208.184.14.11.5" extension="2019-09-10" /> <criterion> <code code="GuidedIntervalType" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes"/> <text>Tidspunktet er vejledende</text> </criterion> </precondition> |
Status for aftalen <body>.encounter.statusCode code="active"
| Status for aftalen Bemærk: Status skal altid have værdien "active" | <statusCode code="active" /> |
Version for aftalen standarden documentationOf.serviceEvent.id templateId | Feltet indeholder hvilken version af aftalestandarden dokumentet er baseret på. Bemærk: Feltet er først indført fra version 2.0, og vil derfor ikke findes i de tidligere versioner af aftalestandarden (1.0 og 1.1) | <documentationOf> <serviceEvent> <templateId root="1.2.208.184.200.1.10" extension="2019-09-10"/> <!--This id @extension equals the identification and version of the CDA profile--> <id root="1.2.208.184.100.3" extension="apd-v2.0" assigningAuthorityName="MedCom"/> </serviceEvent> </documentationOf> |
| Aftaletypen <body>.encounter.code | Aftalen kan være af typerne: Regional, Kommunal, Praksis - dette kommer sig til udtryk ud fra følgende værdier Kommunal: MunicipalityAppointment Regional: RegionalAppointment Praksis: PractitionerAppointment | <code code="MunicipalityAppointment" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes"> </code> |
Repetitionsmønster for aftalen <body>.encounter.preCondition templateId code | Viser om aftalen er en del af et repeterende aftalemønster | <precondition> <templateId root="1.2.208.184.14.11.4" extension="2019-09-10" /> <criterion> <code code="RepeatingAppointmentType" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes"/> <value xsi:type="II" root="1.2.208.184" extension="06b2b3bb-dac5-446f-aa19-ed5c46d8b0b7" assigningAuthorityName="MedCom" /> </criterion> </precondition> |
Udførende for aftalen <body>.encounter.performer | Den udførende organisation i forhold til aftalen Bemærk: Den udførende organisation, er ofte også den ansvarlige organisation for aftalen. | <performer typeCode="PRF"> <assignedEntity classCode="ASSIGNED"> <id extension="378631000016009" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> <addr use="WP"> <streetAddressLine>Vestergade 5</streetAddressLine> <postalCode>3000</postalCode> <city>Odense</city> </addr> <telecom value="tel:66113333-3" use="WP"/> <representedOrganization classCode="ORG" determinerCode="INSTANCE"> <name>Hjemmehjælp, afdeling City, Odense Kommune</name> </representedOrganization> </assignedEntity> </performer> |
Lokation for aftalen encounter.participant | Den lokation hvor aftalen udføres,
For virtuelle aftaler, se afsnit nedenfor | Lokation #1 <participant typeCode="LOC"> <participantRole classCode="SDLOC"> <templateId root="1.2.208.184.14.11.3" extension="2019-09-10" /> <id extension="240901000016000" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> <addr use=”WP”> <playingEntity classCode="PLC"> </participantRole> </participant> Lokation #2 <participant typeCode="DST"> <participantRole classCode="SDLOC"> <templateId root="1.2.208.184.14.11.3" extension="2019-09-10" /> <addr use=”WP”> <playingEntity classCode="PLC"> </participantRole> </participant> Lokation #3 <participant typeCode="SBJ"> <participantRole classCode="SDLOC"> <templateId root="1.2.208.184.14.11.3" extension="2019-09-10" /> <addr use=”WP”> <playingEntity classCode="PLC"> <name>Borgers Hjemmeadresse</name> </playingEntity> </participantRole> </participant> |
Årsag til aftalen <body>.encounter.entryRelationship. | Årsagen til at der er indkaldt til aftalen | <entryRelationship typeCode="RSON"> <observation classCode="OBS" moodCode="EVN"> <code code="NI" displayName="Hjemmehjælp"/> </observation> </entryRelationship> |
Visning af felterne i Aftaleoversigten
Nedenstående tabel viser hvilke elementer i en aftale, der skal vises til slutbrugerne af Aftaleoversigten i de forskellige visninger.
...
Detaljeret visning: Er hvis alle detaljer om aftalen, skal kunne ses.
Nr. | Dataelement | Beskrivelse | Påkrævet | Vises for slutbruger i simpel visning | Vises for slutbruger i detaljeret visning (optionel) |
1 | Appointment unique id | Entydigt id for Aftalen | Nej | Nej | Nej |
2 | Document unique id | Entydigt id for CDA dokumentet | Ja | Nej | Nej |
3 | Patient | Entydig identifikation af patienten | Ja | Ja | Ja |
4 | Appointment responsible, ”placer” | Den organisation som er ansvarlig for Aftalen | Ja | Nej | Ja |
5 | Appointment requester, ”filler” | Den organisation som har bestilt Aftalen, rekvirent, henviser | Nej | Nej | Ja |
6 | Appointment custodian, Steward | Den organisation som har ansvaret for CDA dokumentet | Ja | Nej | Ja |
7 | Start date and time | Tidspunkt for start af Aftalen | Ja | Ja | Ja |
8 | End date and time | Tidspunkt for slut af Aftalen Dette tidspunkt er optionelt, men er det til stede skal det vises for slutbrugeren. | Nej | Ja | Ja |
9 | EpisodeOfCare label | Information ang. overordnet patientforløb (forløbs-label) | Nej | Nej | Ja |
10 | EpisodeOfCare id | Information ang. deltaljeret patientforløb (forløbs-id) | Nej | Nej | Ja |
11 | APD-DK version | APD-DK version af CDA dokumentet | Ja | Nej | Nej |
12 | Organization that plans to perform the appointment. ”performer” | Den ansvarlige organisation for gennemførelse af Aftalen | Ja | Ja | Ja |
13 | The location of the appointment | Mødested for Aftalen. | Ja | Ja | Ja |
14 | Information if the appointment time is guiding | Visning hvis aftale tidspunktet er vejledende | Nej | Ja | Ja |
15 | The Reason for the appointment | Årsag til Aftalen | Ja | Ja | Ja |
16 | The Appointment Status | Status for Aftalen (kun status aktiv er mulig) | Ja | Nej | Nej |
17 | The appointment is repetitive | Angivelse af at aftalen er del at et gentagene mønster | Nej | Ja | Ja |
18 | The appoitment type | Aftale er regional, praksis, kommunal | Ja | Nej | Nej |
Virtuelle aftaler
En virtuel aftale, er defineret som en aftale med sundhedsvæsnet, hvor den sundhedsfaglige kommunikerer med patienten via live videokonference og eller chat. Alle aspekter af aftalen, er som hvis patienten og den sundhedsfaglige sad overfor hinanden.
Der er mulighed for at vise både patienten og sundhedsfaglige fra parterne at der ligger en virtuel aftale med patienten. Dette kan gøres ved at indkalde til en aftale, hvor mødestedet er patientens bopælsadresse, og så beskrive i brødtekst at det er en virtuel aftale.
...
<participant typeCode="SBJ">
<participantRole classCode="SDLOC">
<templateId root="1.2.208.184.14.11.3" extension="2019-09-10" />
<addr nullFlavor="NI" />
<telecom nullFlavor="NI"/>
<playingEntity classCode="PLC">
<name>Virtuel aftale</name>
</playingEntity>
</participantRole>
</participant>
Tekniske forudsætninger
Aftaleoversigten udstilles via services på NSP'en. Disse skal tilgås gennem en afkoblingskomponent "DCC'en" DCC'en viderestiller kald til underliggende services, så der er ikke en WSDL for DCC'en. Se DCC Dokumentation for adgang til services gennem DCC'en.
...
- IPF Open eHealth Integration Platform
http://oehf.github.io/ipf/ipf-platform-camel-ihe/ - IPF Commons IHE XDS
https://mvnrepository.com/artifact/org.openehealth.ipf.commons/ipf-commons-ihe-xds
Søgning på Aftaler
For at søge på en patients Aftaleoversigt, skal der laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice.
...
Yderligere information omkring forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS
Hentning af Aftaler
For at hente en patients Aftaleoversigt, skal der laves en ITI-43 forespørgsel via NSP'ens dokumentdelingsservice.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<RetrieveDocumentSetResponse xmlns="urn:ihe:iti:xds-b:2007" xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns3="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns4="http://www.w3.org/2000/09/xmldsig#" xmlns:ns5="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns6="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns7="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" xmlns:ns8="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns9="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns10="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns11="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns12="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0"><ns9:RegistryResponse status="urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success"/><DocumentResponse><HomeCommunityId>urn:oid:1.2.208.176.43210.8.20.11</HomeCommunityId><RepositoryUniqueId>1.2.208.176.43210.8.20.11</RepositoryUniqueId><DocumentUniqueId>6946778998876148702.7192223840203720416.1528441845022</DocumentUniqueId><mimeType>text/xml</mimeType><Document><xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:8110ae30-37ff-4306-9c98-0ec153181a9f-68078@urn%3Aihe%3Aiti%3Axds-b%3A2007"/></Document></DocumentResponse></RetrieveDocumentSetResponse></soap:Body></soap:Envelope> --uuid:52a6c54a-20db-4aba-bf36-2ac132997b00 Content-Type: application/octet-stream Content-Transfer-Encoding: binary Content-ID: <8110ae30-37ff-4306-9c98-0ec153181a9f-68078@urn:ihe:iti:xds-b:2007> <?xml version="1.0" encoding="UTF-8" standalone="no"?> <ClinicalDocument xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hl7-org:v3 ../../PHMR/Schema/CDA_SDTC.xsd" xmlns="urn:hl7-org:v3" classCode="DOCCLIN" moodCode="EVN"> <realmCode code="DK" /> <typeId root="2.16.840.1.113883.1.3" extension="POCD_HD000040" /> <!-- MedCom DK CDA APD profile OID --> <templateId root="1.2.208.184.14.1" /> <id extension="aa2386d0-79ea-11e3-981f-0800200c9a66" root="1.2.208.184" assigningAuthorityName="MedCom" /> <!-- LOINC code for appointment date --> <code code="39289-4" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC" displayName="Dato og tidspunkt for møde mellem patient og sundhedsperson" /> <!-- title = "Aftale for" + patient id --> <title>Aftale for 2512489996</title> <effectiveTime value="20170113100000+0100" /> <confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25" /> <languageCode code="da-DK" /> <!-- information about the patient --> <recordTarget typeCode="RCT" contextControlCode="OP"> <patientRole classCode="PAT"> <id extension="2512489996" root="1.2.208.176.1.2" assigningAuthorityName="CPR" /> <addr use="H"> <streetAddressLine>Skovvejen 12</streetAddressLine> <streetAddressLine>Landet</streetAddressLine> <postalCode>5700</postalCode> <city>Svendborg</city> <country>Danmark</country> </addr> <telecom value="tel:65123456" use="H" /> <telecom value="mailto:nab@udkantsdanmark.dk" use="WP" /> <patient classCode="PSN" determinerCode="INSTANCE"> <name> <given>Nancy</given> <given>Ann</given> <family>Berggren</family> </name> <administrativeGenderCode code="F" codeSystem="2.16.840.1.113883.5.1" /> <birthTime value="19481225000000+0000" /> </patient> </patientRole> </recordTarget> <!-- the health care organisation and person responsible for the appointment --> <author typeCode="AUT" contextControlCode="OP"> <time value="20170216100000+0100" /> <assignedAuthor classCode="ASSIGNED"> <id extension="242621000016001" root="1.2.208.176.1.1" assigningAuthorityName="SOR" /> <addr use="WP"> <streetAddressLine>Valdemarsgade 53</streetAddressLine> <postalCode>5700</postalCode> <city>Svendborg</city> <country>Danmark</country> </addr> <telecom value="tel:65113333-1" use="WP" /> <assignedPerson classCode="PSN" determinerCode="INSTANCE"> <name> <prefix>Læge</prefix> <given>Jens</given> <family>Jensen</family> </name> </assignedPerson> <representedOrganization classCode="ORG" determinerCode="INSTANCE"> <name>OUH Radiologisk Afdeling (Svendborg)</name> <telecom nullFlavor="NI" /> <addr use="WP"> <streetAddressLine nullFlavor="NI" /> </addr> </representedOrganization> </assignedAuthor> </author> <!-- the organisation responsible for maintaing the CDA document --> <custodian typeCode="CST"> <assignedCustodian classCode="ASSIGNED"> <representedCustodianOrganization classCode="ORG" determinerCode="INSTANCE"> <id extension="515361000016007" root="1.2.208.176.1.1" assigningAuthorityName="SOR" /> <name>OUH Klinisk IT (Odense)</name> <telecom value="tel:66113333-2" use="WP" /> <addr use="WP"> <streetAddressLine>J. B. Winsløwsvej 4 1</streetAddressLine> <postalCode>5000</postalCode> <city>Odense C</city> <country>Danmark</country> </addr> </representedCustodianOrganization> </assignedCustodian> </custodian> <!-- the date and time for when the service event will take place --> <documentationOf typeCode="DOC"> <serviceEvent classCode="MPROT" moodCode="EVN"> <effectiveTime> <low value="20180831110000+0100" /> <high value="20180831120000+0100" /> </effectiveTime> </serviceEvent> </documentationOf> <!-- CDA Body --> <component typeCode="COMP" contextConductionInd="true"> <structuredBody classCode="DOCBODY" moodCode="EVN"> <component typeCode="COMP" contextConductionInd="true"> <section classCode="DOCSECT" moodCode="EVN"> <!-- DK APD Plan of treatment section template --> <templateId root="1.2.208.184.14.11.1" extension="2017-03-10" /> <code code="18776-5" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC" displayName="Plan of care note" /> <title>Aftale</title> <text>Aftale-tekst-her</text> <entry> <encounter moodCode="APT" classCode="ENC"> <!-- DK APD Planned Encounter template --> <templateId root="1.2.208.184.14.11.2" extension="2017-03-10" /> <id root="1.2.208.184" extension="9a6d1bac-17d3-4195-89a4-1121bc809b4d" assigningAuthorityName="MedCom" /> <code code="185353001" displayName="Aftale dato" codeSystemName="SNOMED CT" codeSystem="2.16.840.1.113883.6.96"> </code> <statusCode code="active" /> <!-- time period for the planned health care service --> <effectiveTime> <low value="20170531110000+0100" /> <high value="20170531120000+0100" /> </effectiveTime> <!-- responsible organisation/person for the health care service --> <performer typeCode="PRF"> <assignedEntity classCode="ASSIGNED"> <id extension="320161000016005" root="1.2.208.176.1.1" assigningAuthorityName="SOR" /> <addr use="WP"> <streetAddressLine>Valdemarsgade 53</streetAddressLine> <postalCode>5700</postalCode> <city>Svendborg</city> <country>Danmark</country> </addr> <telecom value="tel:66113333-3" use="WP" /> <assignedPerson classCode="PSN" determinerCode="INSTANCE"> <name> <prefix>Læge</prefix> <given>Anders</given> <family>Andersen</family> </name> </assignedPerson> <representedOrganization classCode="ORG" determinerCode="INSTANCE"> <name>OUH Radiologisk Ambulatorium (Nyborg)</name> <telecom nullFlavor="NI" /> <addr use="WP"> <streetAddressLine nullFlavor="NI" /> </addr> </representedOrganization> </assignedEntity> </performer> <!-- organisation/person who are requesting the appointment (placer) --> <author typeCode="AUT" contextControlCode="OP"> <time value="20170216100000+0100" /> <assignedAuthor classCode="ASSIGNED"> <id extension="48681000016007" root="1.2.208.176.1.1" assigningAuthorityName="SOR" /> <addr use="WP"> <streetAddressLine>Toldbodvej 9</streetAddressLine> <postalCode>5700</postalCode> <city>Svendborg</city> <country>Danmark</country> </addr> <telecom value="tel:62214518" use="WP" /> <assignedPerson classCode="PSN" determinerCode="INSTANCE"> <name> <given>Anders</given> <family>Andersen</family> </name> </assignedPerson> <representedOrganization classCode="ORG" determinerCode="INSTANCE"> <name>Lægerne Toldbodvej</name> <telecom nullFlavor="NI" /> <addr use="WP"> <streetAddressLine nullFlavor="NI" /> </addr> </representedOrganization> </assignedAuthor> </author> <!-- location for the planned health care service --> <participant typeCode="LOC"> <participantRole classCode="SDLOC"> <!-- DK Service Delivery Location template --> <templateId root="1.2.208.184.14.11.3" extension="2017-03-10" /> <id extension="320161000016005" root="1.2.208.176.1.1" assigningAuthorityName="SOR" /> <addr use="WP"> <streetAddressLine>Vestergade 17</streetAddressLine> <postalCode>5800</postalCode> <city>Nyborg</city> <country>Danmark</country> </addr> <telecom value="tel:66113333-4" use="WP" /> <playingEntity classCode="PLC"> <name>OUH Radiologisk Ambulatorium (Nyborg)</name> </playingEntity> </participantRole> </participant> <!-- reason for the planned health care service --> <entryRelationship typeCode="RSON"> <observation classCode="OBS" moodCode="RQO"> <code code="NI" displayName="Ekkokardiografi (Ultralydsundersøgelse af hjertet)" /> </observation> </entryRelationship> </encounter> </entry> </section> </component> </structuredBody> </component> </ClinicalDocument> |
Oprettelse af Aftaler
Oprettelse af aftaler foregår via dokumentregistreringsservicen (DROS). Detaljeret dokumentation er beskrevet under: Dokumentregistreringsservice.
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
<ProvideAndRegisterDocumentSetRequest xmlns:lcm="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns="urn:ihe:iti:xds-b:2007"> <lcm:SubmitObjectsRequest> <rim:RegistryObjectList> <rim:ExtrinsicObject id="10614913492668759151.7526722965054630547.1561027587628" lid="17744819518467516435.5289508129896542596.1561027587628" mimeType="text/xml" objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"> <rim:Slot name="creationTime"> <rim:ValueList> <rim:Value>20170531120000</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="serviceStartTime"> <rim:ValueList> <rim:Value>20190101010101</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="serviceStopTime"> <rim:ValueList> <rim:Value>20200101010101</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="sourcePatientId"> <rim:ValueList> <rim:Value>2512489996^^^&1.2.208.176.1.2&ISO</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Aftale for 2512489996" xml:lang="en-US"/> </rim:Name> <rim:Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:0f2732cd-628f-4df7-821c-ede951749ccd" nodeRepresentation=""> <rim:Slot name="authorInstitution"> <rim:ValueList> <rim:Value>OUH Radiologisk Afdeling (Svendborg)^^^^^&1.2.208.176.1.1&ISO^^^^242621000016001</rim:Value> </rim:ValueList> </rim:Slot> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:03549911-5dd4-4406-8157-2f0c76cf6565" nodeRepresentation="001"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>1.2.208.184.100.9</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Klinisk rapport" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:fa1a078e-43e8-4cc3-a177-a670656b56e9" nodeRepresentation="urn:ad:dk:medcom:appointmentsummary:full"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>1.2.208.184.100.10</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="DK PHMR schema" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:21648bfe-b78c-46d2-8bb1-80017f618775" nodeRepresentation="550621000005101"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.96</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="hjemmesygepleje" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:a0594198-3c4a-4039-a269-18a970de3abf" nodeRepresentation="408443003"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.96</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="almen medicin" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:98128f66-7cfc-480d-b1cf-14bedac10132" nodeRepresentation="39289-4"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.1</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Dato og tidspunkt for møde mellem patient og sundhedsperson" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:ExternalIdentifier id="urn:uuid:7c0f749b-679d-4ac4-b039-0e4a6cd1378f" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" registryObject="10614913492668759151.7526722965054630547.1561027587628" value="2512489996^^^&1.2.208.176.1.2&ISO"> <rim:Name> <rim:LocalizedString value="XDSDocumentEntry.patientId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:c8eb9924-b511-4883-8736-a6c24e329ee7" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" registryObject="10614913492668759151.7526722965054630547.1561027587628" value="10613314401450021042.16485562384221947016.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSDocumentEntry.uniqueId"/> </rim:Name> </rim:ExternalIdentifier> </rim:ExtrinsicObject> <rim:RegistryPackage id="7874116232104445829.6778506344390820751.1561027587628" lid="7874116232104445829.6778506344390820751.1561027587628" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"> <rim:Slot name="submissionTime"> <rim:ValueList> <rim:Value>20170531120000</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="7874116232104445829.6778506344390820751.1561027587628" xml:lang="en-US"/> </rim:Name> <rim:Classification classificationScheme="urn:uuid:aa543740-bdda-424e-8c96-df4873be8500" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:3f20f9c0-ef4b-449d-985b-2e923431e1d8" nodeRepresentation="39289-4"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.1</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Dato og tidspunkt for møde mellem patient og sundhedsperson" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:a7058bb9-b4e4-4307-ba5b-e3f0ab85e12d" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:b28dc026-efd5-40bc-895c-f978127be6fd" nodeRepresentation=""> <rim:Slot name="authorInstitution"> <rim:ValueList> <rim:Value>OUH Radiologisk Afdeling (Svendborg)^^^^^&1.2.208.176.1.1&ISO^^^^242621000016001</rim:Value> </rim:ValueList> </rim:Slot> </rim:Classification> <rim:ExternalIdentifier id="urn:uuid:a541991d-f8b3-47f1-8dab-78cec036815f" identificationScheme="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="2512489996^^^&1.2.208.176.1.2&ISO"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.patientId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:d49106ed-2ccf-403b-a785-4d5a1bd25242" identificationScheme="urn:uuid:96fdda7c-d067-4183-912e-bf5ee74998a8" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="7874116232104445829.6778506344390820751.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.uniqueId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:9bdc2b25-a86b-4088-9ae8-1e1d7027214d" identificationScheme="urn:uuid:554ac39e-e3fe-47fe-b233-965d2a147832" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="7874116232104445829.6778506344390820751.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.sourceId"/> </rim:Name> </rim:ExternalIdentifier> </rim:RegistryPackage> <rim:Classification classificationNode="urn:uuid:a54d6aa5-d40d-43f9-88c5-b4633d873bdd" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:6e17db47-168b-49bc-bbaa-c2570e255cf2"/> <rim:Association associationType="urn:oasis:names:tc:ebxml-regrep:AssociationType:HasMember" id="5855258517755215834.4341855612522046622.1561027587628" sourceObject="7874116232104445829.6778506344390820751.1561027587628" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" targetObject="10614913492668759151.7526722965054630547.1561027587628"> <rim:Slot name="SubmissionSetStatus"> <rim:ValueList> <rim:Value>Original</rim:Value> </rim:ValueList> </rim:Slot> </rim:Association> </rim:RegistryObjectList> </lcm:SubmitObjectsRequest> <Document id="10614913492668759151.7526722965054630547.1561027587628"> <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:d028af6e-dc46-4049-b3bd-a4496767e42d@urn%3Aihe%3Aiti%3Axds-b%3A2007"/> </Document> </ProvideAndRegisterDocumentSetRequest> |
Ændring af Aftaler
Ændring af aftaler er tilsvarende oprettelse af aftaler. Fagsystemet skal blot sikre sig, at aftaleid'et er det samme, når dokumentet oprettes (husk at aftale-id og dokument-id ikke er det samme - se beskrivelsen ovenfor).
...
Arbejdsgangene omkring ændringer af en aftale med patienten, og derved deling af aftalen, foregår ofte som automatiske processer og system-til-system-kommunikation. Derfor kan der både benyttes et medarbejdercertifikat (MOCES) eller et Funktionscertifikat (FOCES) til deling af aftaler via Dokumentregistreringsservicen.
Sletning af Aftaler
Der er ikke udstillet funktionalitet til at slette aftaler for fagsystemerne.
Aftaler bliver automatisk slettet 2 år efter udførelsestidspunktet, hvilket er fastsat lovgivningsmæssigt.
...
Arbejdsgangene omkring sletning af en aftale med patienten, og derved stoppe deling af aftalen foregår ofte som automatiske processer og system-til-system-kommunikation. Derfor kan der både benyttes et medarbejdercertifikat (MOCES) eller et Funktionscertifikat (FOCES).
Sikkerhed, roller og rettigheder
Sundhedspersoner, med en sundhedsfaglig autorisation har adgang til Aftaleoversigten. Sundhedspersoner uden sundhedsfaglig autorisation skal have tilknyttet en rettighed før de kan få adgang. Lokale organisationer kan enten tildele disse rettigheder via Sundhedsstyrelsens Elektroniske Brugerstyring (SEB), eller tildele rettigheden via den lokale identifikations- og rettighedsstyring.
...
Følgende roller anvendes i forbindelse med Aftaleoversigten:
Rollenavn | Rettighed | Notation som indsættes i SOSI IdKort ved udstedelse |
nspSundAssistR2 | Giver ret til at læse Aftaleoversigten Giver også adgang til at læse andre dokumenter, der deles via dokumentdelingsinfrastrukturen jvf. Sundhedslovens §42a stk. 4 Se detaljeret beskrivelse af alle nationale roller her: Beskrivelse af de nationale roller i produktion - NSP services - Global Site (nspop.dk) samt overordnet dokumentation for SEB her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk) | urn:dk:healthcare:national-federation-role:code:41002:value:SundAssistR2 |
En sundhedsperson kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedsstyring eller via SEB.
Håndtering af Frabedelse og Fuldmagt
Frabedelse af deling af sundhedsdata
...
Information angående angivelse af fuldmagter via dokumentdelingsservicen, kan ses i HSUID header dokumentation.
Ændringslog
| Version | Dato | Ændring | Ændring foretaget af |
|---|---|---|---|
| 2.0 | 2025-07-16 | Opdateret til ny version | SDS |
Historisk log:
| 0.8 | 2019-12-06 | Udkast til Teknisk implementeringsguide til Aftaleoversigt | SDS |
| 0.9 | 2019-12-20 | Opdateret på baggrund af indkommende kommentarer | SDS |
| 1.0 | 2020-01-06 | Offentlig efter afsluttet kommenteringsrunde | SDS |
| 1.0.1 | 2020-01-10 | Uddybning af den tekniske dokumentation angående: Ændring af aftaler samt opdatering af aftaler | SDS |
| 1.1 | 2020-03-27 | Tilrettet efter opdatering af testprotokol for CDA profilen | SDS |
| 1.1.1 | 2020-05-11 | Præciseret ordlyden omkring brug af medarbejdercertifikater (MOCES) og Funktionscertifikater (FOCES) | SDS |
| 1.2 | 2020-05-22 | Tilrettet efter mindre opdatering af DK-APD fra 2.0 til 2.0.1 | SDS |
| 1.2.1 | 2020-06-26 | Præcisering omkring hvilke felter i aftalen, der skal vises for slutbrugerne i henhold til testprotokollen | SDS |
| 1.2.2 | 2020-08-21 | Præcisering af forvalter ("custodian") begrebet i CDA dokumentet | SDS |
| 1.2.3 | 2020-10-21 | Tilføjelse af Errata til APD-DK 2.0.1 | SDS |
| 1.2.4 | 2020-10-26 | Præciseringer af SOR ved de forskellige lokationstyper | SDS |
| 1.2.5 | 2021-03-04 | Præcisering af "Ændring af aftaler" | SDS |
| 1.2.6 | 2021-08-16 | Præciseret angivelse af IHE's søgeparamtre for ITI-18 | SDS |
| 1.2.7 | 2022-01-28 | Opdateret med beskrivelse af virtuelle aftaler | SDS |
| 1.2.8 | 2022-04-27 | Ændret endpoints til dokumentregistrering til DROS, da DRS udfases i henhold til NSP-28724 | SDS |
| 1.2.9 | 2023-03-01 | Rettet link til MedCom CDA Header v. 1.4. | SDS |
| 1.2.10 | 2023-03-20 | Rettet rettighed for nspSundAssistR2 - rollen giver kun adgang til Aftaleoversigten og Fælles Stamkort | SDS |
| 1.2.11 | 2024-03-12 | Rettet rettighed for nspSundAssistR2 - rollen giver adgang til alle dokumenter der deles via dokumentdelingsinfrastrukturen | SDS |
| 1.2.12 | 2025-03-24 | Spærring ændret til frabedelse | SDS |