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.

De generieke foutcode zijn te vinden op Overzicht uitzonderingen MAGDA 2.0 webservices

Elementen

Overzicht dienst-specifieke uitzonderingen

Antwoord in detail

Al de onderstaande uitzonderingen hebben als oorsprong "MAGDA".

LED uitzonderingen

Al de onderstaande uitzonderingen hebben als oorsprong "LED".

De foutcode 10010 wordt gebruikt om aan te geven dat een bepaalde (dimensie)waarde niet toegestaan is.

Bijvoorbeeld: bij registreerBewijs een waarde voor de dimensie”Categorie” die geen deel uitmaakt van de geladen Taxonomie. Of ingeval van een geefBewijs het feit dat het INSZ niet toegelaten is (omdat het bijvoorbeeld verouderd is).

De foutcode 10025 wordt gebruikt voor niet toegestane (Binaire- én N-aire Dimensie) combinaties inclusief een niet toegelaten Afzender- Leverancier combinatie De begeleidende uitzonderingsinformatie bevat de informatie die nodig is om te bepalen over welk soort combinatie het gaat.

M.a.w. de foutboodschap bevat naast de unieke foutcode, de namen van de dimensies (bv. “Categorie” en “Graad”) waarvan de waarden werden gecombineerd in het bewijs en waarvan de waardencombinatie ongeldig werd bevonden.

Voor meer uitleg omtrent de voornoemde terminologie: zie de sectie “Taxonomiebeheer” verder in dit document.

De foutcode 20000 wordt gebruikt om aan te geven dat de gevraagde actie (bv. registreerBewijs, annuleerBewijs) ongeldig is o.b.v. de staat van het doelobject op dat moment.

Zo kan men bijvoorbeeld een Bewijs met een bepaalde unieke leveranciercode-bewijsreferteLeverancier maar 1x registreren.

Probeert men het Bewijs met dezelfde leveranciercode-bewijsreferteLeverancier combinatie nogmaals te registreren, dan zal dat fout gaan, en zal men als antwoord de bovenstaande foutcode krijgen.

De foutcode 30000 wordt gebruikt om aan te geven dat het gevraagde verzoek conflicteert met andere parallele verzoeken of LED verwerking. In dat geval wordt het beste, na x aantal (milli)seconden, opnieuw éénmalig geprobeerd. 

De foutcode 90000 wordt gebruikt om aan te geven dat de LED Dienst (tijdelijk) niet beschikbaar is. Dit betekent niet dat er een onverwacht systeemprobleem was langs LED kant. Het betekent dat de LED Dienst bewust (tijdelijk) buiten gebruik werd gesteld, bijvoorbeeld voor onderhoudswerkzaamheden. Ingeval van dergelijke werkzaamheden wordt dit het beste op voorhand naar de betrokken partijen
gecommuniceerd.
LED geeft deze foutcode als de diensten manueel afgezet zijn.

De code 90300 wordt gebruikt om aan te geven dat zich tijdens de verwerking van het verzoek een onverwachtte systeemfout heeft voorgedaan. Bijvoorbeeld, indien tijdens de registratie van een Bewijs onverwacht de databaseconnectie uitvalt, of er zich een geheugenprobleem, of diskspaceprobleem voordoet.
Alle foutcodes veroorzaken een “rollback” in de LED Dienst en vereisen een rollback van de aanroepende partij. Voor alle foutcodes behalve de foutcodes 30000 en 90000 is een “retry” door de “consumer” zinloos.

Voorbeelden

Uitzondering op niveau 1.

<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://registreerbewijs.bewijsregistratiedienst.led.vlaanderen.be" />
	</detail>
</soap:Fault>

Uitzondering op niveau 2.

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>99995</Identificatie>
<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2011-03-10</Datum>
			<Tijd>09:32:39.570</Tijd>
		</Tijdstip>
		<Diagnose>Te veel gelijktijdige bevragingen</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Uitzondering op niveau 3.

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>13202</Identificatie>
<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2011-03-10</Datum>
			<Tijd>09:32:39.570</Tijd>
		</Tijdstip>
		<Diagnose>Gegevens niet opvraagbaar, geen persoonsdossier geregistreerd</Diagnose>
	</Uitzondering>
</Uitzonderingen>