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:

	Snitflade	Endpoint
Uden sikkerheds-header	dentist	<server>/ddtv-dentist-service/service-contract/wsdl/DDTV_Dentist.wsdl
Med sikkerheds-header	dentist	<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

<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>

<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

<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>

<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

Brugerhistorie	Udførsel
Dentist Accept	Udføres ved at kalde Dentist Accept.
Dentist Reject	Udfø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.