Generelt
Graviditetsplan (GCP) er en service, som er beregnet til at give et overblik over planlagte, aftalte og gennemførte aktiviteter i et graviditetsforløb.
Ved initiering består graviditetsplanan af de aktiviteter, som indgår i et fælles nationalt basis-graviditetsforløb. Såfremt der opstår komplikationer under graviditetsforløbet kan der tilføjes yderligere aktiviteter.
Graviditetsplanen giver de sundhedsfaglige et tværorganisatorisk, koordineret overblik over planlagte, aftalte og gennemførte aktiviteter i graviditetsforløbet, og fastholder og kommunikerer nye tiltag overfor den gravide. Dette gøres ved bl.a. at tilføje, udføre eller fjerne planlagte
aktiviteter.
Graviditetsplanen kan betragtes som en form for kalender, hvori der optræder aktiviteter på konkrete datoer. Planen initialiseres på baggrund af en skabelon, der består af planlagte aktiviteter. En
planlagt aktivitet er en aktivitet, der ikke er bundet til en specifik dato, men blot tilrettelagt med et offset i forhold til graviditetsforløbets start.
Et eksempel på en planlagt aktivitet kan være Nakkefoldsskanning og doubletest, der kan gennemføres fra gestationsuge 11 til 14. Den planlagte aktivitet har derfor en titel, der hedder
Nakkefoldsscanning og en planlagt start som “uge 11”. Ved initialisering af en Graviditetsplan fastlægges planlagte aktiviteter til konkrete datoer (18. september 2021).
Konkrete aktiviteter i en Graviditetsplan kan initialiseres på baggrund af planlagte aktiviteter i en skabelon.
En Graviditetsplan indeholder følgende:
- Patientidentifikation
- Graviditetsforløb ID
- Status
- Titel
- Beskrivelse
- Mål
- 0 eller flere Aktiviteter
En aktivitet i en Graviditetsplan indeholder:
- Status
- Titel (planlagt, udført, annulleret mv)
- Beskrivelse
- Mål
- Planlagt Periode
- Performer (hvem er udførende)
- Sted
- Reference (til henvisning mv)
Servicen opsamler registrering af, hvem der gennem tiden har opdateret de forskellige elementer i planen og dennes aktiviteter. Disse oplysninger udstilles ved hent af data..
Snitflade
GCP servicen anvendes igennem en DGWS-snitflade, som skal kaldes med et MOCES niveau 4 medarbejdercertifikat, eller igennem IDWS-snitflade (borgere)
Snitfladerne skal kaldes gennem NSP'ens DCC endpoint (afkoblingskomponenten).
Server-URL'er for de forskellige test-miljøer kan findes på Endpoints for eksterne testmiljøer.
Graviditetsplanen kan desuden hentes som et "on demand"-dokument via Dokumentdelingsservicen (DDS).
WSDL-filer | |
|---|---|
| Graviditetsplan DGWS | <server>/gcp/wsdl/dgws |
| Graviditetsplan IDWS | <server>/gcp/wsdl/idws |
Serviceoperationer
GCP indeholder følgende serviceoperationer, som er tilgængelig for anvendere:
Operation | Beskrivelse |
|---|---|
CreateCarePlan_2020_03 | Opret ny Graviditetsplan, evt. på basis af skabelon |
GetCarePlan (ITI-43) | Hent borgerens aktuelle Graviditetsplan (via dokumentdelingsservicen) |
UpdateCarePlan_2020_03 | Redigering af borgerens aktuelle Graviditetsplan |
DeleteCarePlan_2020_03 | Slet borgerens aktuelle Graviditetsplan. Efter sletning er data tilgængelige som historik i 2 år før sletningen foretages fysisk. |
CreateCarePlanActivity_2020_03 | Opret en aktivitet i Graviditetsplan |
UpdateCarePlanActivity_2020_03 | Opdater en aktivitet i Graviditetsplan |
DeleteCarePlanActivity_2020_03 | Slet en aktivitet fra Graviditetsplan |
AddCarePlanActivities_2020_03 | Tilføj planlagte aktiviteter fra en identificeret skabelon |
CreateCarePlan
Request-eksempel: CreateCarePlan-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Title | Graviditetsplanens navn | String | Nej |
| Description | Beskrivelse. Såfremt dette ikke angives vil beskrivelse blive taget fra skabelonen | String | Ja |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| Goal | Målet med planen. Angives enten struktureret med kode/system/display eller som fritekst. | - | Ja |
| Goal.Code | Kode for planens mål | String | Ja |
| Goal.System | Kodesystem for planens mål | String | Ja |
| Goal.Display | Tekst for koden for planens mål | String | Ja |
| Goal.Text | Planens mål som fritekst | String | Ja |
| Status | Status for planen, enten new eller active | String | Nej |
| EpisodeOfCareLabel | Forløbslabel | String | Ja |
| Template | Navn på Graviditetsplan skabelon. Såfremt dette angives, vil Graviditetsplanen blive oprettet med de aktiviteter, der findes i skabelonen. | String | Ja |
| OffsetDate | Den dato, der tages udgangspunkt i, når template-aktiviteter dateres. Skal angives når Template er angivet. | Dato | Ja |
Response-eksempel: CreateCarePlan-response.xml
UpdateCarePlan
Request-eksempel: UpdateCarePlan-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Version | Den version af Graviditetsplanen, der ønskes opdateret. | Integer | Nej |
| Title | Graviditetsplanens navn | String | Nej |
| Description | Beskrivelse. Såfremt dette ikke angives vil beskrivelse blive taget fra skabelonen | String | Ja |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| Goal | Målet med planen. Angives enten struktureret med kode/system/display eller som fritekst. | - | Ja |
| Goal.Code | Kode for planens mål | String | Ja |
| Goal.System | Kodesystem for planens mål | String | Ja |
| Goal.Display | Tekst for koden for planens mål | String | Ja |
| Goal.Text | Planens mål som fritekst | String | Ja |
| Status | Status for planen, enten new eller active | String | Nej |
| EpisodeOfCareLabel | Forløbslabel | String | Ja |
Response-eksempel: updateCarePlanResponse.xml
DeleteCarePlan
Request-eksempel: DeleteCarePlan-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Version | Den version af Graviditetsplanen, der ønskes slettet. | Integer | Nej |
| PregnancyCourseId | GraviditetsforløbsID. | String | Nej |
| Status | Status for afsluttet Graviditetsplan. Dette kan være cancelled, aborted, completed eller obsolete | String | Nej |
Response-eksempel: DeleteCarePlan-response.xml
CreateCarePlanActivity
Request-eksempel: CreateCarePlanActivity-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| CarePlanVersion | Den aktuelle version af Graviditetsplanen | Integer | Nej |
| Title | En brugerrettet titel på Aktiviteten | String | Nej |
| Description | En brugerrettet beskrivelse af Aktivitetens formål og scope. Kan fx anvendes til en uddybning af formål og mål. | String | Ja |
| Reference | Reference til eksterne objekter som aktiviteten vedrører. Fx en henvisning. | String | Ja |
| Goal | Målene med at udføre Aktiviteten. Angives enten struktureret med kode/system/display eller som fritekst. | - | Ja |
| Goal.Code | Kode for aktivitetens mål | String | Ja |
| Goal.System | Kodesystem for aktivitetens mål | String | Ja |
| Goal.Display | Tekst for koden for aktivitetens mål | String | Ja |
| Goal.Text | Aktivtetens mål som fritekst | String | Ja |
| Code | Detaljeret beskrivelse af aktiviteten angivet med kode og/eller tekst | - | Ja |
| Code.Code | Kode på beskrivelsen | String | Ja |
| Code.System | Kodesystem for aktivitetens kode | String | Ja |
| Code.Display | Tekst for koden for aktivitetens kode | String | Ja |
| Code.Text | Aktivitetens kode som fritekst | String | Ja |
| Kind | Aktivitetens type. Fx en konsultation (appointment), en spørgeskema (task) eller kommunikation til kommunen (communicationRequest). Se https://www.hl7.org/fhir/valueset-care-plan-activity-kind.html for værdisæt. | String | Ja |
| Status | Aktivitetens status. Kan fx sættes til "completed" når Aktiviteten er gennemført. Se https://www.hl7.org/fhir/valueset-care-plan-activity-status.html for værdisæt. | String | Nej |
| ActivityPerformer | Hvem eller hvilken organisation forventes at udføre aktiviteten | Performer | Ja |
| ActivityLocation | Hvor forventes aktiviteten udført | Location | Ja |
| ScheduledString | Tidspunktet for hvornår en aktivitet forventes udført angives for graviditetsforløb som fosterets gestationsalder (estimerede alder) i hele uger. En aktivitet skal f.eks. udføres når fosteret er i uge 20 - altså 20 uger gammel. | String | Ja |
| ScheduledPeriode | Forventet start- og/eller sluttidspunkt for aktiviteten | - | Ja |
| ScheduledPeriode.Start | Forventet starttidspunkt for aktiviteten | DateTime | Ja |
| ScheduledPeriode.End | Forventet sluttidspunkt for aktiviteten | DateTime | Ja |
Response-eksempel: CreateCarePlanActivity-response.xml
UpdateCarePlanActivity
Request-eksempel: UpdateCarePlanActivity-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| CarePlanVersion | Den aktuelle version af CarePlanen | Integer | Nej |
| ActivityID | ID på den aktivitetet der ønskes opdateret. | String | Nej |
| Title | En brugerrettet titel på Aktiviteten | String | Nej |
| Description | En brugerrettet beskrivelse af Aktivitetens formål og scope. Kan fx anvendes til en uddybning af formål og mål. | String | Ja |
| Reference | Reference til eksterne objekter som aktiviteten vedrører. Fx en henvisning. | String | Ja |
| Goal | Målene med at udføre Aktiviteten. Angives enten struktureret med kode/system/display eller som fritekst. | - | Ja |
| Goal.Code | Kode for aktivitetens mål | String | Ja |
| Goal.System | Kodesystem for aktivitetens mål | String | Ja |
| Goal.Display | Tekst for koden for aktivitetens mål | String | Ja |
| Goal.Text | Aktivtetens mål som fritekst | String | Ja |
| Code | Detaljeret beskrivelse af aktiviteten angivet med kode og/eller tekst | - | Ja |
| Code.Code | Kode på beskrivelsen | String | Ja |
| Code.System | Kodesystem for aktivitetens kode | String | Ja |
| Code.Display | Tekst for koden for aktivitetens kode | String | Ja |
| Code.Text | Aktivitetens kode som fritekst | String | Ja |
| Kind | Aktivitetens type. Fx en konsultation (appointment), en spørgeskema (task) eller kommunikation til kommunen (communicationRequest). Se https://www.hl7.org/fhir/valueset-care-plan-activity-kind.html for værdisæt. | String | Ja |
| Status | Aktivitetens status. Kan fx sættes til "completed" når Aktiviteten er gennemført. Se https://www.hl7.org/fhir/valueset-care-plan-activity-status.html for værdisæt. | String | Nej |
| ActivityPerformer | Hvem eller hvilket organisation forventes at udføre Aktiviteten | Performer | Ja |
| ActivityLocation | Hvor forventes Aktiviteten udført | Location | Ja |
| ScheduledString | Tidspunktet for hvornår en aktivitet forventes udført angives for graviditetsforløb som fosterets gestationsalder (estimerede alder) i hele uger. En aktivitet skal f.eks. udføres når fosteret er i uge 20 - altså 20 uger gammel. | String | Ja |
| ScheduledPeriode | Forventet start- og/eller sluttidspunkt for aktiviteten | - | Ja |
| ScheduledPeriode.Start | Forventet starttidspunkt for aktiviteten | DateTime | Ja |
| ScheduledPeriode.End | Forventet sluttidspunkt for aktiviteten | DateTime | Ja |
Response-eksempel: UpdateCarePlanActivity-response.xml
DeleteCarePlanActivity
Request-eksempel: DeleteCarePlanActivity-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| CarePlanVersion | Den aktuelle version af CarePlanen | Integer | Nej |
| ActivityID | ID på den aktivitetet der ønskes opdateret. | String | Nej |
Response-eksempel: DeleteCarePlanActivity-response.xml
AddCarePlanActivities
Request-eksempel: AddCarePlanActivities-request.xml
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonIdentifier | Personens cprnr. | String | Nej |
| Author | Den enhed, der er forfatter til oplysningerne, eksempelvis en fødselsafdeling eller en lægepraksis. | - | Nej |
| Author.OrganisationId | Foratterenheds ID, i form af SOR-id. Dette kan være en ID på kommune, sygehusafdeling eller lægepraksis. | String | Nej |
| Author.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| Responsible | Den organisation, der er ansvarlig for oplysningerne, eksempelvis en region eller en lægepraksis. | - | Nej |
| Responsible.OrganisationId | Ansvarlig enheds ID, i form af SOR-id. Dette kan være en ID på kommune, region eller lægepraksis. | String | Nej |
| Responsible.OrganisationIdSource | Typen af enheds-ID | SOR | Nej |
| PregnancyCourseId | GraviditetsforløbsID | String | Nej |
| CarePlanVersion | Den aktuelle version af CarePlanen | Integer | Nej |
| Template | Navn på CarePlan skabelon. Såfremt dette angives, vil CarePlanen blive oprettet med de aktiviteter, der findes i skabelonen. | String | Nej |
| OffsetDate | Den dato, der tages udgangspunkt i, når template-aktiviteter dateres. Skal angives når Template er angivet. | Dato | Nej |
Response-eksempel: AddCarePlanActivities-response.xml
Performer
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| PersonName.GivenName | Fornavn | String | Ja |
| PersonName.MiddleName | Mellemnavn | String | Ja |
| PersonName.SurName | Efternavn | String | Ja |
| Identfier | Organisationens SOR-kode | String | Ja |
| IdentifierType | Identifiertype | SOR | Ja |
| OrgName | Navn på organisation | String | Ja |
| Address.StreetAddressLine1 | Vejnavn og -nummer | String | Ja |
| Address.StreetAddressLine2 | Evt. anden linje af adressen | String | Ja |
| Address.PostalCode | Postnummer | String | Ja |
| Address.City | Bynavn | String | Ja |
| Address.Country | Land | String | Ja |
| TelephoneNumber.Value | Telefonnummer | String | Ja |
| TelephoneNumber.Use | Typen af telefonnummer. Dette kan være home, work eller mobile. Dette skal angives hvis telefonnummer er udfyldt. | String | Ja |
| FaxNumber.Value | Faxnummer | String | Ja |
| FaxNumber.Use | Typen af faxnummer. Dette kan være home, work eller mobile. Dette skal angives hvis faxnummer er udfyldt. | String | Ja |
| EmailAddress.Value | E-mail adresse | String | Ja |
| EmailAddress.Use | Typen af e-mail adresse . Dette kan være home, work eller mobile. Dette skal angives hvis e-mail adresse er udfyldt. | String | Ja |
Location
| Element | Beskrivelse | Type | Optionel |
|---|---|---|---|
| Name | Navn på lokation | ||
| Identfier | Organisationens SOR-kode | String | Ja |
| IdentifierType | Identifiertype | SOR | Ja |
| Address.StreetAddressLine1 | Vejnavn og -nummer | String | Ja |
| Address.StreetAddressLine2 | Evt. anden linje af adressen | String | Ja |
| Address.PostalCode | Postnummer | String | Ja |
| Address.City | Bynavn | String | Ja |
| Address.Country | Land | String | Ja |
| TelephoneNumber.Value | Telefonnummer | String | Ja |
| TelephoneNumber.Use | Typen af telefonnummer. Dette kan være home, work eller mobile. Dette skal angives hvis telefonnummer er udfyldt. | String | Ja |
| FaxNumber.Value | Faxnummer | String | Ja |
| FaxNumber.Use | Typen af faxnummer. Dette kan være home, work eller mobile. Dette skal angives hvis faxnummer er udfyldt. | String | Ja |
| EmailAddress.Value | E-mail adresse | String | Ja |
| EmailAddress.Use | Typen af e-mail adresse . Dette kan være home, work eller mobile. Dette skal angives hvis e-mail adresse er udfyldt. | String | Ja |
CDA dokument fra Dokumentdelingsservice (DDS)
Data skal som nævnt ovenfor hentes igennem DDS, og har form af et HL7-CDA dokument (Clinical Document Architecture).
Følgende implementeringsguide beskrivelser strukturen af XML dokumentet:
20210104 CPD–GCP Implementation Guide v0.91.pdf