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>
123 gebr20321 <wachtwoord xsi:type="xsd:string">********* 9231554698 19661004
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>
9231564698 19661104 9231564698 N <meldingSoort xsi:type="xsd:string"/> <meldingNummer xsi:nil="true"/> <melding xsi:type="xsd:string"/>
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>
SOAP-ENV:Server A2SP: Missende of onjuiste veld(en): geboortedatum
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
