Rijbewijsvalidatie dienst (PDF)

Technische documentatie
Rijbewijsvalidatie SOAP service
AFS 6.x
Versiehistorie
Versie Datum
Auteur
Wijzigingen
1.0
YvdB
Initiële versie
© A2SP
3-4-2014
1/6
Inhoud
Versiehistorie....................................................................................................................................................... 1
Inleiding ............................................................................................................................................................... 3
Request ................................................................................................................................................................ 3
Response ............................................................................................................................................................. 4
© A2SP
2/6
Inleiding
Dit document beschrijft de werking van de dienst tellerstand. Deze dienst is een vrij eenvoudige dienst: op
basis van het rijbewijsnummer + geboortedatum retourneert de dienst een Ja of een Nee (geldig of niet
geldig). Meer gegevens worden er niet teruggegeven ivm met privacywetgeving.
URLs
Zie https://wsdldocacceptatie.cartalk.nl/version61/
SOAP Request
In XML ziet een request bericht er zo uit:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:rij="https://services.cartalk.nl/6.0/Soap/RijbewijsValidatie">
<soapenv:Header/>
<soapenv:Body>
<rij:controleren soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<referentie xsi:type="xsd:string">123</referentie>
<gebruiker xsi:type="xsd:string">gebr20321</gebruiker>
<wachtwoord xsi:type="xsd:string">*********</wachtwoord>
<rijbewijsnummer xsi:type="xsd:string">9231554698</rijbewijsnummer>
<geboortedatum xsi:type="xsd:string">19661004</geboortedatum>
</rij:controleren>
</soapenv:Body>
</soapenv:Envelope>
referentie
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String (max. 32 karakters)
Vrije tekst om de transactie te identificeren (uniciteit niet gegarandeerd)
Bijv: Test 01
In
Facultatief
gebruiker
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String (max. 50 karakters) (ook in MD5 formaat)
A2SP gebruikersaccount
Bijv: A2SP12345
In
Verplicht in
wachtwoord
Type
Beschrijving
String (max. 50 karakters)
Wachtwoord behorent bij gebruiker kan ook in MD5 formaat
© A2SP
3/6
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
Bijv: geheim, e8636ea013e682faf61f56ce1cb1ab5c
In
Verplicht in
rijbewijsnummer
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String 10
Rijbewijsnummer
1204555
In
Verplicht
eenheid
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String 8
Geboortedatum van de houder van het rijbewijs
YYYYMMDD
In
Verplicht
Response
In XML ziet een response bericht er zo uit:
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns1="https://services.cartalk.nl/6.1/Soap/RijbewijsValidatie" xmlns:SOAPENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<SOAP-ENV:controlerenResponse>
<controlerenReturn xsi:type="ns1:Backend_RijbewijsValidatie_Result_Controleren">
<zoekRijbewijsnummer xsi:type="xsd:string">9231564698</zoekRijbewijsnummer>
<zoekGeboortedatum xsi:type="xsd:string">19661104</zoekGeboortedatum>
<rijbewijsnummer xsi:type="xsd:string">9231564698</rijbewijsnummer>
<rijbewijsGeldig xsi:type="xsd:string">N</rijbewijsGeldig>
<meldingSoort xsi:type="xsd:string"/>
<meldingNummer xsi:nil="true"/>
<melding xsi:type="xsd:string"/>
</controlerenReturn>
</SOAP-ENV:controlerenResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Beschrijving elementen
© A2SP
4/6
zoekRijbewijsnummer en rijbewijsnummer
Type
String 10
Beschrijving
Rijbewijsnummer (hethaling input)
Mogelijke waarde(s) 1204555
In/Uit
uit
Facultatief/Verplicht zoekGeboortedatum
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String 8
Geboortedatum van de houder van het rijbewijs (herhaling input)
YYYYMMDD
uit
-
rijbewijsGeldig
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String
Geboortedatum van de houder van het rijbewijs (herhaling input)
J of N (Ja of Nee)
Uit
-
meldingSoort
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
String (1 letter)
Soort van de RDW resultaat melding
I,W,F,S
I = Informatie
W = Waarschuwing
F = Foutmelding, gebruikersactie noodzakelijk
S = (Applicatie-)Systeemfout, gebruikersactie niet mogelijk
Uit
-
meldingNummer
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
Integer (max. 3 cijfers)
RDW-nummer behorend bij RDW-(fout)melding
29
Uit
-
melding
Type
Beschrijving
Mogelijke waarde(s)
In/Uit
Facultatief/Verplicht
Integer (max. 3 cijfers)
RDW- (fout)melding (Tekst behorend bij meldingSoort en meldingNummer)
RDW: Meldcode bij kenteken onjuist.
Uit
-
© A2SP
5/6
Naast deze meldingen is het belangrijk om rekening te houden met SOAP foutmeldingen (exceptions).
Bijvoorbeeld als de datum verkeerd geschreven is:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>A2SP: Missende of onjuiste veld(en): geboortedatum</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Set van testgegevens
Op de test/acceptatie omgeving:
Geboorte
datum
22-02-1940
19-01-1970
07-07-1977
20-06-1947
08-06-1961
21-03-1968
© A2SP
ryb-nr
9231554891
9231554902
9231554913
9231554924
9231554935
9231554946
cat
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
AL,AM,AZ,B,BE,C,C1,C1E,CE,D,D1,D1E,DE
6/6

Download Report