Het doel van deze webservice is het opvragen van de huurklasse van een bepaald voertuig op basis van Nederlands kenteken. De huurklasse van het voertuig wordt bepaald aan de hand van een aantal objectieve criteria van het voertuig zoals lengte, catalogusprijs en carrosserievorm.
De webservice is op dezelfde wijze opgezet als de andere ROB-Net BOL-webservices. Er is een WSDL gedefinieerd voor het endpoint. Daarnaast is een separate XSD beschikbaar voor validatie van het vraag- en antwoordbericht.
Aanroepen van de webservice vinden plaats met dezelfde gebruikersnaam en wachtwoord combinatie als de andere BOL-webservices.
ROB-Net biedt toegang tot zowel een productieomgeving als ook een acceptatieomgeving. Voor beide omgevingen zijn aparte endpoints gedefinieerd:
https://services.rob-net.nl/huurklasse/1.0
https://services.stg.rob-net.nl/huurklasse/1.0
Hieronder een voorbeeld van een aanvraag- en antwoordbericht. Hier wordt op basis van het kenteken 8ZSG09
een huurklasse bepaald. Dit voertuig heeft huurklasse C
.
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:UsernameToken>
<wsse:Username>svc307247</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">XXXXX</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<opvragenHuurklasse xmlns="http://rob-net.nl/rental">
<Kenteken>8ZSG09</Kenteken>
</opvragenHuurklasse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<opvragenHuurklasseAntw xmlns="http://rob-net.nl/rental">
<Huurklasse>C</Huurklasse>
</opvragenHuurklasseAntw>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Indien er een onbekend of niet bestaand kenteken wordt meegestuurd dan resulteert dit in een leeg antwoord bericht. Dit gebeurt ook als er geen huurklasse kon worden bepaald. Een leeg antwoordbericht ziet er als volgt uit:
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<opvragenHuurklasseAntw xmlns="http://rob-net.nl/rental"/>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>