Rijbewijsvalidatie SOAP service

Transcriptie

1 Technische documentatie Rijbewijsvalidatie SOAP service AFS 6.x Versiehistorie Versie Datum Auteur Wijzigingen YvdB itiële versie A2SP 1 / 6

2 houd Versiehistorie... 1 leiding... 3 Request... 3 Response... 4 A2SP 2 / 6

3 leiding 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 SOAP Request XML ziet een request bericht er zo uit: <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:rij=" <soapenv:header/> <soapenv:body> <rij:controleren soapenv:encodingstyle=" <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"> </rijbewijsnummer> <geboortedatum xsi:type="xsd:string"> </geboortedatum> </rij:controleren> </soapenv:body> </soapenv:envelope> referentie String (max. 32 karakters) Vrije tekst om de transactie te identificeren (uniciteit niet gegarandeerd) Mogelijke waarde(s) Bijv: Test 01 Facultatief/Verplicht Facultatief gebruiker Mogelijke waarde(s) Facultatief/Verplicht String (max. 50 karakters) (ook in MD5 formaat) A2SP gebruikersaccount Bijv: A2SP12345 Verplicht in wachtwoord String (max. 50 karakters) Wachtwoord behorent bij gebruiker kan ook in MD5 formaat A2SP 3 / 6

4 Mogelijke waarde(s) Facultatief/Verplicht Bijv: geheim, e8636ea013e682faf61f56ce1cb1ab5c Verplicht in rijbewijsnummer String 10 Rijbewijsnummer Mogelijke waarde(s) Facultatief/Verplicht Verplicht eenheid String 8 Geboortedatum van de houder van het rijbewijs Mogelijke waarde(s) YYYYMMDD Facultatief/Verplicht Verplicht Response XML ziet een response bericht er zo uit: <SOAP-ENV:Envelope SOAP-ENV:encodingStyle=" xmlns:soap- ENV=" xmlns:xsd=" xmlns:xsi=" xmlns:ns1=" xmlns:soap- ENC=" <SOAP-ENV:Body> <SOAP-ENV:controlerenResponse> <controlerenreturn xsi:type="ns1:backend_rijbewijsvalidatie_result_controleren"> <zoekrijbewijsnummer xsi:type="xsd:string"> </zoekrijbewijsnummer> <zoekgeboortedatum xsi:type="xsd:string"> </zoekgeboortedatum> <rijbewijsnummer xsi:type="xsd:string"> </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> elementen A2SP 4 / 6

5 zoekrijbewijsnummer en rijbewijsnummer String 10 Rijbewijsnummer (hethaling input) Mogelijke waarde(s) uit zoekgeboortedatum String 8 Geboortedatum van de houder van het rijbewijs (herhaling input) Mogelijke waarde(s) YYYYMMDD uit rijbewijsgeldig String Geboortedatum van de houder van het rijbewijs (herhaling input) Mogelijke waarde(s) J of N (Ja of Nee) meldingsoort String (1 letter) Soort van de RDW resultaat melding Mogelijke waarde(s) I,W,F,S I = formatie W = Waarschuwing F = Foutmelding, gebruikersactie noodzakelijk S = (Applicatie-)Systeemfout, gebruikersactie niet mogelijk meldingnummer teger (max. 3 cijfers) RDW-nummer behorend bij RDW-(fout)melding Mogelijke waarde(s) 29 melding teger (max. 3 cijfers) RDW- (fout)melding (Tekst behorend bij meldingsoort en meldingnummer) Mogelijke waarde(s) RDW: Meldcode bij kenteken onjuist. A2SP 5 / 6

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=" <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 ryb-nr cat datum 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 A2SP 6 / 6