In bepaalde omstandigheden kan het zijn dat de dienst een uitzondering (of meerdere uitzonderingen) teruggeeft.
In het kort kunnen er binnen deze dienst uitzonderingen terugkomen op drie niveaus
Niveau 1: typisch zal dit voorkomen bij een fout tegenover de xsd
Niveau 2: voornamelijk op het niveau van autorisatie (context)
Niveau 3: voornamelijk uitzonderingen door de achterliggende dienst, voorbeeld “geen gegevens gevonden”, “onverwachte fout”, … of door specifieke controle op de vraaggegevens
Een uitzondering omvat:
Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA-webservices.
Elementen
Element
Omschrijving
Identificatie
Verplicht. Maxlengte 10. De uitzonderingscode.
Oorsprong
Minlengte 1, maxlengte 5. Duidt de bron aan van de uitzondering (Altijd MAGDA)
Type
Mogelijke waardes:
FOUT
WAARSCHUWING
INFORMATIE
Tijdstip
Optioneel, indien aanwezig zijn Datum en Tijd beide aanwezig.
Datum: formaat jjjj-mm-dd
Tijdstip: formaat uu:mm:ss.sss
Diagnose
Verplicht. De tekstuele omschrijving van de opgetreden uitzondering.
Omstandigheid
Optioneel. Wordt veelal gebruikt om de foutcode van de bron door te geven of voor meer informatie te geven met betrekking tot de uitzondering.
Annotatie
Optioneel, meerdere mogelijk. Is opgebouwd uit een naam/waarde-paar. Wordt in de RegistreerMutatiebewijs 02.00 niet gebruikt.
Voorbeelden
Uitzondering op niveau 1
Fout tegen xsd (ongeldig INSZ)
<soap:Fault>
<faultcode>Server</faultcode>
<faultstring>10001 Fout formaat in de vraag (XSD validatie). Fout:
error: cvc-datatype-valid.1.1: string value 'xxxxxxxxxxx' does not match pattern for INSZType in namespace http://generiek-01_02.vip.vlaanderen.be</faultstring>
<detail>
<ns1:VIPDienstException xmlns:ns1=" http://webservice.registreermutatiebewijsdienst-02_00.led-02_00.vip.vlaanderen.be " />
</detail>
</soap:Fault>