Indhold

Overblik

Læsevejledning

Dette dokument er rettet mod udviklere, der skal udvikle eller teste services, der har grænseflader mod services i DDTV.

Snitflader

Til denne type anvender, findes der en snitflade til IDSAS. WSDL'erne er både udstillet med og uden sikkerheds-headers:


SnitfladeEndpoint
Uden sikkerheds-headerdentist<server>/ddtv-dentist-service/service-contract/wsdl/DDTV_Dentist.wsdl
Med sikkerheds-headerdentist<server>/ddtv-dentist-service/service-contract/secure-wsdl/DDTV_Dentist.wsdl

dentist<server>/ddtv-dentist-service/service-contract/xsd/20250501/DDTV_Common.xsd

dentist<server>/ddtv-dentist-service/service-contract/xsd/dgws/wsse.xsd

dentist<server>/ddtv-dentist-service/service-contract/xsd/dgws/saml.xsd

dentist<server>/ddtv-dentist-service/service-contract/xsd/dgws/medcom.xsd

Datoen "20250501" angiver versionen af snitfladen. Der kan potentielt findes andre versioner, men det anbefales, at man anvender den nyeste.

Operationer

Dentist Accept

Angiver at en tandlæge eller klinikassistent har accepteret ansøgning om tandlæge fra en borger.

Elementer

ddtvDentistAcceptRequest

Element

Beskrivelse

Type

Obligatorisk

dentistChoiceToken

GUID der oprindeligt blev genereret (af den centrale DDTV service)  
da borgeren valgte tandlægen på Sundhed.dk 

String

Ja

ddtvDentistAcceptResponse

Element

Beskrivelse

Type

Obligatorisk

personID

ID på borgeren (CPR)

PersonID

Ja

personName

Borgerens navn

string

Ja

personPhoneNumber

Telefon nummer

string

Nej

PersonID

Element

Beskrivelse

Type

Obligatorisk

id

Angiver borgerens ID (CPR-nummer uden bindestreg).

string

Ja

classification

Typen af ID som OID, e.g. OID:1.2.208.176.1.2 for CPR.

string

Ja

Eksempler

Dentist Accept request 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/">
   <soapenv:Body>
      <ns:ddtvDentistAcceptRequest>
         <dentistChoiceToken>24dfc5ae-5d13-4111-958b-df9c1bfca0bc</dentistChoiceToken>
      </ns:ddtvDentistAcceptRequest>
   </soapenv:Body>
</soapenv:Envelope>
Dentist Accept response 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:ddtvDentistAcceptResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/">
         <personID>
            <id>1811804807</id>
            <classification>OID:1.2.208.176.1.2</classification>
         </personID>
         <personName>Peter Test Naur</personName>
         <personPhoneNumber>+4512345678</personPhoneNumber>
      </ns2:ddtvDentistAcceptResponse>
   </soap:Body>
</soap:Envelope>

Dentist Reject

Angiver at en tandlæge eller klinikassistent har afvist en ansøgning om tandlæge fra en borger.

ddtvDentistRejectRequest

Element

Beskrivelse

Type

Obligatorisk

dentistChoiceToken

GUID der oprindeligt blev genereret (af den centrale DDTV service)  
da borgeren valgte tandlægen på Sundhed.dk 

String

Ja

rejectReason

0: Tandlægen afviste eksplicit

1: Anmodningen fik timeOut

Byte

Ja

ddtvDentistRejectResponse

Element

Beskrivelse

Type

Obligatorisk

OK/Fail

Giver status OK eller fejlmeddelelse

-

Ja

Eksempler

Dentist Reject request 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/">
   <soapenv:Body>
      <ns:ddtvDentistRejectRequest>
         <dentistChoiceToken>24dfc5ae-5d13-4111-958b-df9c1bfca0bc</dentistChoiceToken>
         <rejectReason>0</rejectReason>
      </ns:ddtvDentistRejectRequest>
   </soapenv:Body>
</soapenv:Envelope>
Dentist Reject response 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:ddtvDentistRejectResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/">
         <status>true</status>
      </ns2:ddtvDentistRejectResponse>
   </soap:Body>
</soap:Envelope>

Understøttelse af brugerhistorier

BrugerhistorieUdførsel
Dentist AcceptUdføres ved at kalde Dentist Accept.
Dentist RejectUdføres ved at kalde Dentist Reject.

Kald af DDTV

Mange programmeringssprog har understøttelse for at danne kode ud fra en snitfladebeskrivelse (WSDL). Det er op til anvenderen at finde en passende udviklingsstak og passende biblioteker, der kan hjælpe med denne proces.

Udover behovet for at kunne generere klientkode ud fra en WSDL, så vil succesfuld anvendelse af DDTV kræve, at der medsendes gyldig identifikation (gyldigt SOSI Idkort) i kaldet.

Yderligere dokumentation:

Whitelisting

For at kunne benytte DDTV skal organisationen også være whitelistet til at anvende servicen.
Opret supporthenvendelse om whitelistning.

Der er whitelistning til både Test og Produktion.

  • No labels