Technische documentatie APK AFS 6.2

Transcriptie

1 Technische documentatie APK AFS 6.2 A2SP 1 / 31

2 Wijzigingshistorie Versie Datum Gewijzigd door Wijzigingen oktober 2011 Gerard van Maurik Initiële versie november 2011 Gerard van Maurik datatype: Backend_Apk_Result_OpvragenGebrekenAdviezenLijst _GebrekAdviesPunt toegevoegd augustus 2013 Yves van den Berg Versie nummer AFS naar 6.1 wegens het MTV project, maar geen inhoudelijke wijzigingen. Beknopte beschrijving steekproefmechanisme toegevoegd maart 2015 Yves van den Berg Uitbereiding van: - Afkeurpunten - Reparatiepunten - Adviespunten - Opm. Met een toelichting-veld van max 30 tekens. A2SP 2 / 31

3 Inhoud Wijzigingshistorie... 2 Inleiding... 4 Datatypes... 4 Cls_Backend_Datas_Rdw_Teller... 4 Cls_Backend_Datas_Rdw_Apk_ApkPunt... 6 Cls_Backend_Datas_Rdw_SteekproefGegevens... 9 Cls_Backend_Datas_Rdw_Apk_GebrekAdviesPunt Berichten Bericht: opvoerengoedkeur Bericht: opvoerenafkeur Bericht: opvragengoedkeur Bericht: opvragenafkeur Steekproeven A2SP 3 / 31

4 Inleiding Dit document beschrijft de APK SOAP service. (RV wordt in een apart document beschreven.) Versie 6.2 implementeert de uitbreidingen van de RDW EKI release Het betreft de mogelijkheid tot het toevoegen van een toelichting bij: - Afkeurpunten - Reparatiepunten - Adviespunten - Opm. Verder is het nu ook mogelijk bij Afkeur reparatiepunten op te geven! En tot slot is de nieuwe lijst met APKPunten beschikbaar via de method opvragengebrekenadviezenlijst. Datatypes Cls_Backend_Datas_Rdw_Teller Dit datatype wordt gebruikt sinds voor de in- of uitvoer van de teller gegevens. WSDL: <xsd:complex name="cls_backend_datas_rdw_teller"> <xsd:all> <xsd:element name="stand" type="xsd:int" /> <xsd:element name="eenheid" type="xsd:string" /> <xsd:element name="statuscode" type="xsd:string" /> </xsd:all> </xsd:complex> elementen stand integer (max. 7 cijfers) De stand v.d. teller eenheid string (1 karakter) De eenheid v.d. teller K (is kilometers) of M (is mijlen) status string (1 karakter) Code die de status aangeeft v.d. teller X of leeg, waarbij X betekend geen teller bijvoorbeeld bij Oldtimers Voorbeeld in SOAP-bericht (zonder statuscode): <teller xsi:type="apk:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int">24000</stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:type="xsd:string"></statuscode> </teller> A2SP 4 / 31

5 Voorbeeld in SOAP-bericht (met statuscode): <teller xsi:type="apk:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int"></stand> <eenheid xsi:type="xsd:string"></eenheid> <statuscode xsi:type="xsd:string">x</statuscode> </teller> A2SP 5 / 31

6 Cls_Backend_Datas_Rdw_Apk_ApkPunt Dit datatype bestond al maar is hernoemt vanwege een nieuwe structuur in de gebruikte datatypes. Voorheen was dit: Backend_Apk_Result_ApkPunt. Het datatype dient altijd als ArrayOf gebruikt te worden. Het wordt gebruikt bij de opvoer- en opvraagberichten. Bij opvoerenafkeur en opvoerengoedkeur wordt dit datatype zowel in het vraag- als antwoordbericht gebruikt (voor de elementen: afkeurpunten, reparatiepunten, adviespunten, opmerking) Bij opvragenafkeur en opvragengoedkeur wordt dit datatype alleen in het antwoordbericht gebruikt (voor de elementen: afkeurpunten, reparatiepunten, adviespunten, opmerking) De lijst met beschikbare APK-punten (codes) kan opgevraagd worden d.m.v. het bericht: opvragengebrekenadviezenlijst. WSDL: <xsd:complex name="cls_backend_datas_rdw_apk_apkpunt"> <xsd:all> <xsd:element name="code" type="xsd:string"/> <xsd:element name="aantal" type="xsd:int"/> <xsd:element name="omschrijving" type="xsd:string"/> <xsd:element name="toelichting" type="xsd:string"/> </xsd:all> </xsd:complex> elementen code string (3 karakters) Code van het APK-punt (afkeur, reparatie, advies of opmerking) A01, B01, RA1, E03 aantal integer Aantal keren dat het APK-punt geconstateerd is 3 omschrijving (alleen in de antwoordberichten: opvragenafkeur, opvragengoedkeur en opvragengebrekenadviezenlijst) string (alleen in response) /omschrijving van het APK-punt Aandrijving/transmissie 5.*.16 toelichting string (max 30) Code van het APK-punt (afkeur, reparatie, advies of opmerking) Toelichting bij APK punt. Niet verplicht A2SP 6 / 31

7 A2SP 7 / 31

8 Voorbeeld in SOAP-bericht (vraagbericht opvoerenafkeur): <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:apk=" xmlns:soapenc=" <soapenv:header/> <soapenv:body> <apk:opvoerenafkeur soapenv:encodingstyle=" <referentie xsi:type="xsd:string">121212</referentie> <gebruiker xsi:type="xsd:string">testuser</gebruiker> <wachtwoord xsi:type="xsd:string">*******</wachtwoord> <certificaatid xsi:type="xsd:string">dummy</certificaatid> <kenteken xsi:type="xsd:string">06ghb1</kenteken> <meldcode xsi:type="xsd:string">0006</meldcode> <teller xsi:type="apk:cls_backend_datas_rdw_teller"> <!--You may enter the following 3 items in any order--> <stand xsi:type="xsd:int">1212</stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:type="xsd:string"></statuscode> </teller> <erkenning xsi:type="xsd:string">l</erkenning> <keurmeesterpasnummer xsi:type="xsd:int">100134</keurmeesterpasnummer> <keurmeesterpincode xsi:type="xsd:string">test01</keurmeesterpincode> <keuringsinstantienummer xsi:type="xsd:string">ki47g02</keuringsinstantienummer> <keuringslocatienummer xsi:type="xsd:string"></keuringslocatienummer> <afkeurpunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"> <item> <code>i37</code> <aantal>1</aantal> <toelichting>koplamp stuk</toelichting> </afkeurpunten> <reparatiepunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"> <item> <code>i37</code> <aantal>1</aantal> <toelichting>lampje vervangen</toelichting> </reparatiepunten> <adviespunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"> <item> <code>ac1</code> <aantal>2</aantal> <toelichting>wordt mogelijk een probleem</toelichting> </adviespunten> <opmerkingen xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"> <item> <code>op1</code> <aantal>2</aantal> <toelichting>dat was het weer!</toelichting> </opmerkingen> </apk:opvoerenafkeur> </soapenv:body> </soapenv:envelope> A2SP 8 / 31

9 Voorbeeld in SOAP-bericht (vraagbericht opvragenafkeur): <afkeurpunten SOAP-ENC:array="ns1:Cls_Backend_Datas_Rdw_Apk_ApkPunt[1]" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">i37</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:type="xsd:string">remverschil op 1 as te groot/voertuig overberemd 5.*.38</omschrijving> <toelichting xsi:type="xsd:string">koplamp stuk</toelichting> </afkeurpunten> Cls_Backend_Datas_Rdw_SteekproefGegevens Dit datatype bestond al maar is hernoemt vanwege een nieuwe structuur in de gebruikte datatypes. Voorheen was dit: Backend_Apk_Result_SteekproefGegevens. Dit datatype komt voor in de antwoordberichten van opvoerenafkeur, opvragenafkeur, opvoerengoedkeur en opvragengoedkeur. WSDL: <xsd:complex name="cls_backend_datas_rdw_steekproefgegevens"> <xsd:all> <xsd:element name="keuringslocatienummer" type="xsd:string" /> <xsd:element name="straat" type="xsd:string" /> <xsd:element name="huisnummer" type="xsd:int" /> <xsd:element name="huisnummertoevoeging" type="xsd:string" /> <xsd:element name="postcode" type="xsd:string" /> <xsd:element name="woonplaats" type="xsd:string" /> <xsd:element name="eindequarantainetijd" type="xsd:string" /> <xsd:element name="aanmaakdatum" type="xsd:string" /> <xsd:element name="bevestigingdatum" type="xsd:string" /> </xsd:all> </xsd:complex> A2SP 9 / 31

10 elementen keuringslocatienummer string (7 karakters) KI nummer war steekproef plaats zou vinden KI47G02 straat string Straat waar steekproef plaats zou vinden Savannahweg huisnummer integer Huisnummer behorend bij de straat 69 huisnummertoevoeging integer Toevoeging behorend bij het huisnummer a postcode String Postcode behorend bij straat 3542 AW woonplaats String Woonplaats behorend bij straat 3542 AW eindequarantainetijd String (HHMM) (HH = uren in 24-uurs notatie MM = minuten) Einde tijd dat de steekproef plaats gevonden moet hebben 1555 aanmaakdatum String (JJJJ-MM-DD HH:MM:SS) Datum/tijd dat de steekproef entry opgeslagen is :30:10 A2SP 10 / 31

11 bevestigingdatum String (JJJJ-MM-DD HH:MM:SS) Datum/tijd dat de keuringsinstantie de steekproef bevestigd heeft bij de RDW :58:10 A2SP 11 / 31

12 Cls_Backend_Datas_Rdw_Apk_GebrekAdviesPunt Dit datatype bestond al maar is hernoemt vanwege een nieuwe structuur in de gebruikte datatypes. Voorheen was dit: Backend_Apk_Result_OpvragenGebrekenAdviezenLijst_GebrekAdviesPunt. Het datatype dient altijd als ArrayOf gebruikt te worden. Het wordt gebruikt bij het bericht: opvragengebrekenadviezenlijst. WSDL <complex name="cls_backend_datas_rdw_apk_gebrekadviespunt"> <all> <element name="code" type="xsd:string"/> <element name="omschrijving" type="xsd:string"/> <element name="ingangsdatum" type="xsd:string"/> <element name="einddatum" type="xsd:string"/> <element name="soort" type="xsd:string"/> </all> </complex> elementen code String (3 karakters) Code van het punt (afkeur, reparatie, advies of opmerking) A01, B01, RA1, E03 omschrijving String (max. 100 karakters) /omschrijving van het punt Overeenstemmen voertuiggegevens/kentekenplaten/vin 5.*.1 ingangsdatum String Datum vanaf het punt geldig is. Dit element is nog niet in gebruik NULL einddatum String Datum totdat het punt geldig is. Dit element is nog niet in gebruik NULL soort String (3 karakters) Categorie/soort van het punt ADV = Adviespunt AFK = Afkeurpunt (ook bij goedkeur te gebruiken als reparatiepunt ) OPM = Opmerking RAP = Reparatie-adviespunt A2SP 12 / 31

13 Voorbeeld in SOAP-antwoordbericht: opvragengebrekenadviezenlijst <gebrekenadvieslijst array="ns1:cls_backend_datas_rdw_apk_gebrekadviespunt[98]" type="ns1:arrayofcls_backend_datas_rdw_apk_gebrekadviespunt"> <item type="ns1:cls_backend_datas_rdw_apk_gebrekadviespunt"> <code type="xsd:string">a01</code> <omschrijving type="xsd:string"> Overeenstemmen voertuiggegevens/kentekenplaten/vin 5.*.1 </omschrijving> <ingangsdatum nil="true"/> <einddatum nil="true"/> <soort type="xsd:string">afk</soort> <item type="ns1:cls_backend_datas_rdw_apk_gebrekadviespunt"> <code type="xsd:string">ac1</code> <omschrijving type="xsd:string"> Er is een band aanwezig met een profieldiepte van 1,6 t/m 2,5 mm (alleen voor APK 2) </omschrijving> <ingangsdatum nil="true"/> <einddatum nil="true"/> <soort type="xsd:string">adv</soort> <item type="ns1:cls_backend_datas_rdw_apk_gebrekadviespunt"> <code type="xsd:string">ac2</code> <omschrijving type="xsd:string"> Er is een schokdemper aanwezig die lekkage vertoont. </omschrijving> <ingangsdatum nil="true"/> <einddatum nil="true"/> <soort type="xsd:string">adv</soort> </gebrekenadvieslijst> Berichten In de volgende paragraven worden de gewijzigde berichten beschreven. In de WSDL en SOAP-berichten code zijn de elementen die in rood weergegeven worden van naam en/of datatype gewijzigd. Bericht: opvoerengoedkeur WSDL: <message name="opvoerengoedkeurrequest"> <part name="referentie" type="xsd:string" /> <part name="gebruiker" type="xsd:string" /> <part name="wachtwoord" type="xsd:string" /> <part name="certificaatid" type="xsd:string" /> <part name="kenteken" type="xsd:string" /> <part name="meldcode" type="xsd:string" /> <part name="teller" type="tns:cls_backend_datas_rdw_teller" /> <part name="erkenning" type="xsd:string" /> <part name="keurmeesterpasnummer" type="xsd:int" /> <part name="keurmeesterpincode" type="xsd:string" /> <part name="keuringsinstantienummer" type="xsd:string" /> <part name="keuringslocatienummer" type="xsd:string" /> <part name="reparatiepunten" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> <part name="adviespunten" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> <part name="opmerkingen" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> </message> elementen referentie string A2SP 13 / 31

14 Tekst om een transactie te markeren of te kunnen herkennen Test A2SP Facultatief gebruiker string A2SP gebruikersnaam a2sp12345 wachtwoord String Het wachtwoord behorend bij gebruiker Topsercet certificaatid String Het serienummer van het RDW cliënt certificaat Kan leeg blijven als het certificaat met de transactie meegezonden wordt Facultatief kenteken String (6 karakters) (zonder streepjes) Het kenteken v.h. voertuig dat goed gekeurd wordt 09RXB8 meldcode String (4 cijfers) Het kenteken v.h. voertuig dat goed gekeurd wordt 1234 teller Cls_Backend_Datas_Rdw_Teller (zie beschrijving bij: Datatypes) Inforamatie over de teller Zie voor voorbeeld bij beschrijving: Datatypes erkenning String (1 karakter) Erkening voor keuring (licht of zwaar) l ((kleine letter L) licht) of z (zwaar) A2SP 14 / 31

15 keurmeesterpasnummer Integer (6 cijfers) Pasnummer van de uitvoerende keurmeester keurmeesterpincode String (5 karaketers) Pincode/wachtwoord behorend bij pasnummer van de uitvoerende keurmeester PINC11 keuringsinstantienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie AB12C34 keuringslocatienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie voor mobiele locaties AB12D56 Facultatief reparatiepunten ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere punt(en) die bij de keuring gerepareerd zijn Zie voor voorbeeld bij beschrijving: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt adviespunten ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere adviespunt(en) Zie voor voorbeeld bij beschrijving: A2SP 15 / 31

16 Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt Facultatief opmerkingen ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere uitgevoerde reparatie-punt(en) Zie voor voorbeeld bij beschrijving: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt Facultatief A2SP 16 / 31

17 Voorbeeld SOAP-vraagbericht: <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:apk=" xmlns:soapenc=" <soapenv:header/> <soapenv:body> <apk:opvoerengoedkeur soapenv:encodingstyle=" <referentie xsi:type="xsd:string">test A2SP</referentie> <gebruiker xsi:type="xsd:string">test12345</gebruiker> <wachtwoord xsi:type="xsd:string">geheim</wachtwoord> <certificaatid xsi:type="xsd:string">dummy Cert</certificaatId> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <meldcode xsi:type="xsd:string">1234</meldcode> <teller xsi:type="apk:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int"> </stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:type="xsd:string"></statuscode> </teller> <erkenning xsi:type="xsd:string">l</erkenning> <keurmeesterpasnummer xsi:type="xsd:int">test12345</keurmeesterpasnummer> <keurmeesterpincode xsi:type="xsd:string">pinc11</keurmeesterpincode> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> <keuringslocatienummer xsi:type="xsd:string"></keuringslocatienummer> <reparatiepunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[2]"> <item xsi:type="ns1:backend_apk_result_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <item xsi:type="ns1:backend_apk_result_apkpunt"> <code xsi:type="xsd:string">e03</code> <aantal xsi:type="xsd:int">1</aantal> </reparatiepunten> <adviespunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"/> <opmerkingen xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"/> </apk:opvoerengoedkeur> </soapenv:body> </soapenv:envelope> A2SP 17 / 31

18 Voorbeeld SOAP-antwoordbericht: <SOAP-ENV:Envelope SOAP-ENV:encodingStyle=" xmlns:soap-env=" xmlns:xsd=" xmlns:xsi=" xmlns:ns1=" xmlns:soap-enc=" <SOAP-ENV:Body> <SOAP-ENV:opvoerenGoedkeurResponse> <opvoerengoedkeurreturn xsi:type="ns1:backend_apk_result_opvoerengoedkeur"> <apkid xsi:type="xsd:int">247</apkid> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <identificatienummer xsi:nil="true"/> <erkenning xsi:type="xsd:string">al</erkenning> <merk xsi:type="xsd:string">opel</merk> <type xsi:type="xsd:string">vectra-b; X1.7DT</type> <teller xsi:type="ns1:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int"> </stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:nil="true"/> </teller> <transactiecode xsi:type="xsd:string">lrnz</transactiecode> <datummelding xsi:type="xsd:string"> </datummelding> <tijdmelding xsi:type="xsd:string">1513</tijdmelding> <vervaldatumkeuring xsi:type="xsd:string"> </vervaldatumkeuring> <steekproef xsi:type="xsd:boolean">false</steekproef> <steekproefgegevens xsi:nil="true" xsi:type="ns1:cls_backend_datas_rdw_steekproefgegevens"/> <naamkeuringsinstantie xsi:type="xsd:string"> Automot. Application Service Provider (A2SP) </naamkeuringsinstantie> <straatkeuringsinstantie xsi:type="xsd:string"> Savannahweg</straatKeuringsinstantie> <huisnummerkeuringsinstantie xsi:type="xsd:string"> 69 </huisnummerkeuringsinstantie> <postcodecijferskeuringsinstantie xsi:type="xsd:int"> 3542 </postcodecijferskeuringsinstantie> <postcodeletterskeuringsinstantie xsi:type="xsd:string"> AW </postcodeletterskeuringsinstantie> <keuringsinstantienummer xsi:type="xsd:string"> KI47G02 </keuringsinstantienummer> <naamkeurmeester xsi:type="xsd:string"> ASP Utrecht </naamkeurmeester> <pasnummerkeurmeester xsi:type="xsd:string"> </pasnummerkeurmeester> <reparatiepunten SOAP-ENC:array="ns1:Cls_Backend_Datas_Rdw_Apk_ApkPunt[2]" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:nil="true"/> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">e03</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:nil="true"/> </reparatiepunten> A2SP 18 / 31

19 <adviespunten xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <opmerkingen xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <meldingsoort xsi:type="xsd:string">i</meldingsoort> <meldingnummer xsi:type="xsd:int">367</meldingnummer> <melding xsi:type="xsd:string"> RDW: Afmelden gelukt, eerstvolgende om 15:13, indien binnen openingstijden. </melding> </opvoerengoedkeurreturn> </SOAP-ENV:opvoerenGoedkeurResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> A2SP 19 / 31

20 Bericht: opvoerenafkeur WSDL: <message name="opvoerenafkeurrequest"> <part name="referentie" type="xsd:string" /> <part name="gebruiker" type="xsd:string" /> <part name="wachtwoord" type="xsd:string" /> <part name="certificaatid" type="xsd:string" /> <part name="kenteken" type="xsd:string" /> <part name="meldcode" type="xsd:string" /> <part name="teller" type="tns:cls_backend_datas_rdw_teller" /> <part name="erkenning" type="xsd:string" /> <part name="keurmeesterpasnummer" type="xsd:int" /> <part name="keurmeesterpincode" type="xsd:string" /> <part name="keuringsinstantienummer" type="xsd:string" /> <part name="keuringslocatienummer" type="xsd:string" /> <part name="afkeurpunten" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> <part name="adviespunten" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> <part name="opmerkingen" type="tns:arrayofcls_backend_datas_rdw_apk_apkpunt" /> </message> elementen referentie string Tekst om een transactie te markeren of te kunnen herkennen Test A2SP Facultatief gebruiker string A2SP gebruikersnaam a2sp12345 wachtwoord String Het wachtwoord behorend bij gebruiker Topsercet certificaatid String Het serienummer van het RDW cliënt certificaat Kan leeg blijven als het certificaat met de transactie meegezonden wordt Facultatief kenteken String (6 karakters) (zonder streepjes) Het kenteken v.h. voertuig dat goed gekeurd wordt 09RXB8 A2SP 20 / 31

21 meldcode String (4 cijfers) Het kenteken v.h. voertuig dat goed gekeurd wordt 1234 teller Cls_Backend_Datas_Rdw_Teller (zie beschrijving bij: Datatypes) Inforamatie over de teller Zie voor voorbeeld bij beschrijving: Datatypes erkenning String (1 karakter) Erkening voor keuring (licht of zwaar) l ((kleine letter L) licht) of z (zwaar) keurmeesterpasnummer Integer (6 cijfers) Pasnummer van de uitvoerende keurmeester keurmeesterpincode String (5 karaketers) Pincode/wachtwoord behorend bij pasnummer van de uitvoerende keurmeester PINC11 keuringsinstantienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie AB12C34 keuringslocatienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie voor mobiele locaties AB12D56 Facultatief A2SP 21 / 31

22 afkeurpunten ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere punt(en) waarop het voertuig is afgekeurd Zie voor voorbeeld bij beschrijving: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt adviespunten ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere adviespunt(en) Zie voor voorbeeld bij beschrijving: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt Facultatief opmerkingen ArrayOfCls_Backend_Datas_Rdw_Apk_ApkPunt (zie beschrijving bij: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt) Een of meerdere uitgevoerde reparatie-punt(en) Zie voor voorbeeld bij beschrijving: Datatypes - Cls_Backend_Datas_Rdw_Apk_ApkPunt Facultatief A2SP 22 / 31

23 Voorbeeld SOAP-vraagbericht: <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:apk=" xmlns:soapenc=" <soapenv:header/> <soapenv:body> <apk:opvoerenafkeur soapenv:encodingstyle=" <referentie xsi:type="xsd:string">test A2SP</referentie> <gebruiker xsi:type="xsd:string">test1234</gebruiker> <wachtwoord xsi:type="xsd:string">geheim</wachtwoord> <certificaatid xsi:type="xsd:string">dummy Cert</certificaatId> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <meldcode xsi:type="xsd:string">1234</meldcode> <teller xsi:type="apk:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int">24000</stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:type="xsd:string"></statuscode> </teller> <erkenning xsi:type="xsd:string">l</erkenning> <keurmeesterpasnummer xsi:type="xsd:int">123456</keurmeesterpasnummer> <keurmeesterpincode xsi:type="xsd:string">pinc11</keurmeesterpincode> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> <keuringslocatienummer xsi:type="xsd:string"></keuringslocatienummer> <afkeurpunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"> <item xsi:type="ns1:backend_apk_result_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <item xsi:type="ns1:backend_apk_result_apkpunt"> <code xsi:type="xsd:string">e04</code> <aantal xsi:type="xsd:int">1</aantal> <toelichting xsi:type="xsd:string">wel erg snel</toelichting> </afkeurpunten> <adviespunten xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"/> <opmerkingen xsi:type="apk:arrayofcls_backend_datas_rdw_apk_apkpunt" soapenc:array="apk:cls_backend_datas_rdw_apk_apkpunt[]"/> </apk:opvoerenafkeur> </soapenv:body> </soapenv:envelope> A2SP 23 / 31

24 Voorbeeld SOAP-antwoordbericht: <SOAP-ENV:Envelope SOAP-ENV:encodingStyle=" xmlns:soap-env=" xmlns:xsd=" xmlns:xsi=" xmlns:ns1=" xmlns:soap- ENC=" <SOAP-ENV:Body> <SOAP-ENV:opvoerenAfkeurResponse> <opvoerenafkeurreturn xsi:type="ns1:backend_apk_result_opvoerenafkeur"> <apkid xsi:type="xsd:int">248</apkid> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <identificatienummer xsi:nil="true"/> <erkenning xsi:type="xsd:string">al</erkenning> <merk xsi:type="xsd:string">opel</merk> <type xsi:type="xsd:string">vectra-b; X1.7DT</type> <teller xsi:type="ns1:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int">24000</stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:nil="true"/> </teller> <transactiecode xsi:type="xsd:string">zzkr</transactiecode> <datummelding xsi:type="xsd:string"> </datummelding> <tijdmelding xsi:type="xsd:string">1727</tijdmelding> <vervaldatumkeuring xsi:type="xsd:string">0</vervaldatumkeuring> <steekproef xsi:type="xsd:boolean">false</steekproef> <steekproefgegevens xsi:nil="true" xsi:type="ns1:cls_backend_datas_rdw_steekproefgegevens"/> <naamkeuringsinstantie xsi:type="xsd:string"> Automot. Application Service Provider (A2SP) </naamkeuringsinstantie> <straatkeuringsinstantie xsi:type="xsd:string"> Savannahweg</straatKeuringsinstantie> <huisnummerkeuringsinstantie xsi:type="xsd:string"> 69 </huisnummerkeuringsinstantie> <postcodecijferskeuringsinstantie xsi:type="xsd:int"> 3542 </postcodecijferskeuringsinstantie> <postcodeletterskeuringsinstantie xsi:type="xsd:string"> AW </postcodeletterskeuringsinstantie> <keuringsinstantienummer xsi:type="xsd:string"> KI47G02 </keuringsinstantienummer> <naamkeurmeester xsi:type="xsd:string">asp Utrecht</naamKeurmeester> <pasnummerkeurmeester xsi:type="xsd:string">100134</pasnummerkeurmeester> <afkeurpunten SOAP-ENC:array="ns1:Cls_Backend_Datas_Rdw_Apk_ApkPunt[2]" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:nil="true"/> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">e04</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:nil="true"/> <toelichting xsi:type="xsd:string">wel erg snel</toelichting> </afkeurpunten> <adviespunten xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <opmerkingen xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <meldingsoort xsi:type="xsd:string">i</meldingsoort> A2SP 24 / 31

25 <meldingnummer xsi:type="xsd:int">367</meldingnummer> <melding xsi:type="xsd:string"> RDW: Afmelden gelukt, eerstvolgende om 00:00, indien binnen openingstijden. </melding> </opvoerenafkeurreturn> </SOAP-ENV:opvoerenAfkeurResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Bericht: opvragengoedkeur WSDL: <message name="opvragengoedkeurrequest"> <part name="referentie" type="xsd:string" /> <part name="gebruiker" type="xsd:string" /> <part name="wachtwoord" type="xsd:string" /> <part name="certificaatid" type="xsd:string" /> <part name="kenteken" type="xsd:string" /> <part name="erkenning" type="xsd:string" /> <part name="keuringsinstantienummer" type="xsd:string" /> </message> elementen Referentie string Tekst om een transactie te markeren of te kunnen herkennen Test A2SP Facultatief Gebruiker string A2SP gebruikersnaam a2sp12345 Wachtwoord String Het wachtwoord behorend bij gebruiker Topsercet certificaatid String Het serienummer van het RDW cliënt certificaat Kan leeg blijven als het certificaat met de transactie meegezonden wordt Facultatief kenteken String (6 karakters) (zonder streepjes) Het kenteken v.h. voertuig dat goed gekeurd wordt 09RXB8 A2SP 25 / 31

26 erkenning String (1 karakter) Erkening voor keuring (licht of zwaar) l ((kleine letter L) licht) of z (zwaar) keuringsinstantienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie AB12C34 Voorbeeld SOAP-vraagbericht: <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:apk=" <soapenv:header/> <soapenv:body> <apk:opvragengoedkeur soapenv:encodingstyle=" <referentie xsi:type="xsd:string">test A2SP</referentie> <gebruiker xsi:type="xsd:string">test12345</gebruiker> <wachtwoord xsi:type="xsd:string">geheim</wachtwoord> <certificaatid xsi:type="xsd:string">dummy Cert</certificaatId> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <erkenning xsi:type="xsd:string">l</erkenning> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> </apk:opvragengoedkeur> </soapenv:body> </soapenv:envelope> A2SP 26 / 31

27 Voorbeeld SOAP-antwoordbericht: <SOAP-ENV:Envelope SOAP-ENV:encodingStyle=" xmlns:soap-env=" xmlns:xsd=" xmlns:xsi=" xmlns:ns1=" xmlns:soap- ENC=" <SOAP-ENV:Body> <SOAP-ENV:opvragenGoedkeurResponse> <opvragengoedkeurreturn xsi:type="ns1:backend_apk_result_opvragengoedkeur"> <apkid xsi:type="xsd:int">247</apkid> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <meldcode xsi:type="xsd:string">1234</meldcode> <erkenning xsi:type="xsd:string">l</erkenning> <datummelding xsi:type="xsd:string"> </datummelding> <tijdmelding xsi:type="xsd:string">1513</tijdmelding> <teller xsi:type="ns1:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int"> </stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:nil="true"/> </teller> <transactiecode xsi:type="xsd:string">lrnz</transactiecode> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> <keurmeesternummer xsi:type="xsd:string">123456</keurmeesternummer> <geldigheidsduur xsi:type="xsd:string"> </geldigheidsduur> <reparatiepunten SOAP-ENC:array="ns1:Cls_Backend_Datas_Rdw_Apk_ApkPunt[2]" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:type="xsd:string"> Overeenstemmen voertuiggegevens/kentekenplaten/vin 5.*.1 </omschrijving> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">e03</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:type="xsd:string"> Aandrijving/transmissie 5.*.16 </omschrijving> </reparatiepunten> <adviespunten xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <opmerkingen xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <steekproef xsi:type="xsd:boolean">false</steekproef> <steekproefgegevens xsi:nil="true" xsi:type="ns1:cls_backend_datas_rdw_steekproefgegevens"/> <meldingsoort xsi:nil="true"/> <meldingnummer xsi:nil="true"/> <melding xsi:nil="true"/> </opvragengoedkeurreturn> </SOAP-ENV:opvragenGoedkeurResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> A2SP 27 / 31

28 Bericht: opvragenafkeur WSDL: <message name="opvragengoedkeurrequest"> <part name="referentie" type="xsd:string" /> <part name="gebruiker" type="xsd:string" /> <part name="wachtwoord" type="xsd:string" /> <part name="certificaatid" type="xsd:string" /> <part name="kenteken" type="xsd:string" /> <part name="erkenning" type="xsd:string" /> <part name="keuringsinstantienummer" type="xsd:string" /> </message> elementen referentie string Tekst om een transactie te markeren of te kunnen herkennen Test A2SP Facultatief gebruiker string A2SP gebruikersnaam a2sp12345 wachtwoord String Het wachtwoord behorend bij gebruiker Topsercet certificaatid String Het serienummer van het RDW cliënt certificaat Kan leeg blijven als het certificaat met de transactie meegezonden wordt Facultatief kenteken String (6 karakters) (zonder streepjes) Het kenteken v.h. voertuig dat goed gekeurd wordt 09RXB8 erkenning String (1 karakter) Erkening voor keuring (licht of zwaar) l ((kleine letter L) licht) of z (zwaar) A2SP 28 / 31

29 keuringsinstantienummer String (7 karaketers) Nummer van de uitvoerende keuringsinstantie AB12C34 Voorbeeld SOAP-vraagbericht: <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:apk=" <soapenv:header/> <soapenv:body> <apk:opvragenafkeur soapenv:encodingstyle=" <referentie xsi:type="xsd:string">test A2SP</referentie> <gebruiker xsi:type="xsd:string">test12345</gebruiker> <wachtwoord xsi:type="xsd:string">geheim</wachtwoord> <certificaatid xsi:type="xsd:string">dummy Cert</certificaatId> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <erkenning xsi:type="xsd:string">l</erkenning> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> </apk:opvragenafkeur> </soapenv:body> </soapenv:envelope> A2SP 29 / 31

30 Voorbeeld SOAP-antwoordbericht: <SOAP-ENV:Envelope SOAP-ENV:encodingStyle=" xmlns:soap-env=" xmlns:xsd=" xmlns:xsi=" xmlns:ns1=" xmlns:soap- ENC=" <SOAP-ENV:Body> <SOAP-ENV:opvragenAfkeurResponse> <opvragenafkeurreturn xsi:type="ns1:backend_apk_result_opvragenafkeur"> <apkid xsi:type="xsd:int">248</apkid> <kenteken xsi:type="xsd:string">09rxb8</kenteken> <meldcode xsi:type="xsd:string">1234</meldcode> <erkenning xsi:type="xsd:string">l</erkenning> <datummelding xsi:type="xsd:string"> </datummelding> <tijdmelding xsi:type="xsd:string">1727</tijdmelding> <teller xsi:type="ns1:cls_backend_datas_rdw_teller"> <stand xsi:type="xsd:int">24000</stand> <eenheid xsi:type="xsd:string">k</eenheid> <statuscode xsi:nil="true"/> </teller> <transactiecode xsi:type="xsd:string">zzkr</transactiecode> <keuringsinstantienummer xsi:type="xsd:string">ab12c34</keuringsinstantienummer> <keurmeesternummer xsi:type="xsd:string">123456</keurmeesternummer> <geldigheidsduur xsi:type="xsd:string">0</geldigheidsduur> <afkeurpunten SOAP-ENC:array="ns1:Cls_Backend_Datas_Rdw_Apk_ApkPunt[2]" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">a01</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:type="xsd:string"> Overeenstemmen voertuiggegevens/kentekenplaten/vin 5.*.1 </omschrijving> <item xsi:type="ns1:cls_backend_datas_rdw_apk_apkpunt"> <code xsi:type="xsd:string">e03</code> <aantal xsi:type="xsd:int">1</aantal> <omschrijving xsi:type="xsd:string"> Aandrijving/transmissie 5.*.16 </omschrijving> </afkeurpunten> <adviespunten xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <opmerkingen xsi:nil="true" xsi:type="ns1:arrayofcls_backend_datas_rdw_apk_apkpunt"/> <steekproef xsi:type="xsd:boolean">false</steekproef> <steekproefgegevens xsi:nil="true" xsi:type="ns1:cls_backend_datas_rdw_steekproefgegevens"/> <meldingsoort xsi:nil="true"/> <meldingnummer xsi:nil="true"/> <melding xsi:nil="true"/> </opvragenafkeurreturn> </SOAP-ENV:opvragenAfkeurResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> A2SP 30 / 31

31 Steekproeven Er kunnen door de RDW steekproeven gedaan worden op een afgemelde auto. Om te voorkomen dat op een of andere manier een klant dit niet in de gaten heeft worden vervolgmeldingen door A2SP geblokkeerd (d.w.z. er volgt een foutmelding op een poging tot afmelden) totdat een steekproef expliciet is afgemeld. Er zijn 2 methods mbt tot steekproeven: 1. bevestigsteekproef 2. controleersteekproef De eerste is bedoeld om een steekproef op basis van APKid te bevestigen. De tweede is bedoeld om te controleren of een steekproef openstaat. Bij opvoerengoedkeur() of opvoerenafkeur() zal het responsebericht gegevens over een potentiële steekproef bevatten: 'steekproef' => true, 'steekproefgegevens' => ( 'keuringslocatienummer' => NULL, 'straat' => NULL, 'huisnummer' => NULL, 'huisnummertoevoeging' => NULL, 'postcode' => '', 'woonplaats' => NULL, 'eindequarantainetijd' => '11:53:00', 'aanmaakdatum' => ' :23:27', 'bevestigingdatum' => ' :00:00', ) A2SP 31 / 31