Page History
...
Indholdet i CDA headeren er fælles for alle danske CDA dokumenter, og er ligeledes forankret hos MedCom, se under under MedCom CDA Header v. 1.4.
Systemer der tilsluttes Aftaleoversigten, skal godkendes af MedCom ud fra en certificering. Testprotokollerne for certificering til Aftaleoversigten, hvor version 1.1 er gældende for afsendelse og version 1.0 er gældende for modtagelse, kan findes på MedCom's hjemmeside under: Testprotokoller for modtagelse og afsendelse af Aftaler.
Der er enkelte afvigelser i test-protokollerne for afsendelse og modtagelse af Aftaler, der ikke er defineret under forretningsreglerne. Følgende tabel viser disse afvigelser
...
| Kode | Beskrivelse | Eksempel |
ID for aftalen ClinicalDocument.id | 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 ansvalig 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 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> |
...
Hvis Aftalen er placeret på patientens hjemadressehjem-adresse, sættes participant@typecode til “SBJ” som beskrevet i afsnit 5.3.1
...
Eksempler på mødested for virtuelle aftaler:
1 - Hvor borgerens hjemadresse hjem-adresse (og telefonnummer) er kendt:
<participant typeCode="SBJ">
<participantRole classCode="SDLOC">
<templateId root="1.2.208.184.14.11.3" extension="2019-09-10" />
<addr use="H">
<streetAddressLine>Hindbærvej 23</streetAddressLine>
<streetAddressLine>Hjallese</streetAddressLine>
<city>Odense S</city>
<postalCode>5260</postalCode>
</addr>
<telecom value="tel:35986256" use="H"/>
<playingEntity classCode="PLC">
<name>Virtuel aftale</name>
</playingEntity>
</participantRole>
</participant>
2 -Hvor borgerens hjemadresse hjem-adresse (og telefonnummer) ikke er kendt:
<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>
Parterne er på forskellige stadier med hensyn til udrulning af deres aftaleløsninger, det er derfor ikke et krav at virtuelle aftaler skal understøttes, men det skal ses som en mulighed, således at patienten får så komplet en Aftaleoversigt som muligt.
Ved at understøtte virtuelle aftaler som foreslået ovenfor, vil det ikke have indvirkning for de parter der allerede har udrullet deres aftaleløsninger, da Aftaler med adresse på patientens hjemadresse hjem-adresse er en del af den gældende standard.
...
WSDL til DROS'en findes under: Snitfladebeskrivelse og endpoints og på https://wsdl.nspop.dk/#dros
Igen som når aftaler hentes ud, så skal selve ClinicalDocument oprettes som en MIME attachment, se eksemplet for detaljer.
...
Følgende roller anvendes i forbindelse med Et samlet patientoverblik.
Rollenavn | Rettighed | Notation som indsættes i SOSI IdKort ved udstedelse |
nspSundAssistR2 | Giver ret til at læse |
urn:dk:healthcare:national-federation-role:code:41001:value:SundAssistR1
nspSundAssistR2
Aftaleoversigten Giver også adgang til at læse andre dokumenter, der deles via dokumentdelingsinfrastrukturen jvf. Sundhedslovens §42a stk. 4 (Se overordnet dokumentation for nationale roller 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
Bemærk: SEB-dokumentationen samt vejledningen ved oprettelse af en rolle er ved at blive tilrettet, så rettigheden for nspSundAsisstR2 afspejler ovenstående.
Håndtering af Spærring og Fuldmagt
...
| 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 |