Voor meer informatie rond de werking van Uitzonderingen in MAGDA 2.0 diensten, zie Werking en overzicht uitzonderingen

Algemeen

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 bevat volgende elementen:

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 (MAGDA of LED)
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 RegistreerBewijs 02.00 niet gebruikt.

Al de onderstaande uitzonderingen hebben als oorsprong "MAGDA".

Identificatie	Niveau	Omschrijving
10001	1	Fout formaat in de vraag (XML validatie) + reden · De doorgestuurde xml is niet geldig tegenover het afgesproken xsd schema
13001	2	Geen machtiging van de afzender in deze hoedanigheid voor de gevraagde dienst · Controleer dienstnaam, dienstversie, afzender identificatie en hoedanigheid
13101	2	Combinatie van vraagelementen niet toegelaten of bepaald element niet aanwezig
13202	3	Gegevens niet opvraagbaar, geen persoonsdossier geregistreerd · Maak een inschrijving aan voor de persoon in kwestie (dienst BeheerInschrijving)
99993	2	Fout formaat in de vraag naar businessdienst toe (XML validatie) · Neem contact op met de toepassingsmanager van Corve
99994	2	Onverwachte fout bij de bron · Neem contact op met de toepassingsmanager van Corve
99995	2	Te veel gelijktijdige bevragingen · Verminder het aantal gelijktijdige bevragingen
99996	2	Bron is tijdelijk niet beschikbaar · Probeer na enige tijd opnieuw, indien de fout zich blijft voordoen neem dan contact op met de toepassingsmanager van Corve
99997	2	Kan antwoord van bron niet interpreteren · Neem contact op met de toepassingsmanager van Corve
99998	2	Fout bij XML validatie antwoord · Neem contact op met de toepassingsmanager van Corve
99999	2	Onverwachte fout, contacteer VIP · Neem contact op met de toepassingsmanager van Corve