Algemeen

Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA-webservices.

Overzicht dienst-specifieke uitzonderingen

Enkel de webservice specifieke foutcodes zijn opgenomen in het overzicht. Voor een volledig overzicht van de MAGDA foutcodes wordt verwezen naar de generieke handleiding (GMW).

Identificatie	Oorsprong	Type	Niveau	Diagnose
12506	MAGDA	FOUT	2	INSZ van de gebruiker beantwoordt niet aan de vormvereisten*
20001	MAGDA	FOUT	3	Ongeldig datumformaat in de vraag
20002	MAGDA	FOUT	3	INSZ in de vraag heeft een ongeldige structuur
20003	MAGDA	FOUT	3	Begindatum van de periode moet kleiner of gelijk zijn aan de einddatum
20005	MAGDA	FOUT	3	Identificatie en/of Hoedanigheid in de vraag komen niet overeen met de Identificatie en/of Hoedanigheid in de Context
30002	KSZ	FOUT	3	Het INSZ is geannuleerd
30003	KSZ	FOUT	3	Onbestaand INSZ
30004	KSZ	FOUT	3	Het INSZ-nummer is vervangen door een ander INSZ-nummer. Voor KSZ is een vervangen INSZ niet meer actief en kan deze dus ook niet meer uitgeschreven worden. Deze uitzondering zal dus steeds een “Niet geslaagd” terug geven in het antwoord.
40006	MAGDA	FOUT	3	Fout in autorisatie
99983	MAGDA	FOUT	3	Magda code niet aanwezig voor teruggekomen broncode, contacteer VIP
99984	MAGDA	WAARSCHUWING	3	Magda beschrijving voor code niet aanwezig, contacteer VIP
99986	MAGDA	FOUT	3	Ongekende foutcode van de bron, contacteer VIP

*Gebruiker in de Context mag niet opgegeven worden.

Voorbeeld

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>13101</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>10:37:19</Tijd>
		</Tijdstip>
		<Diagnose>Combinatie van vraagelementen niet toegelaten of bepaald element niet aanwezig</Diagnose>
	</Uitzondering>
</Uitzonderingen>

<Antwoorden>
	<Antwoord>
		<Referte>1234</Referte>
		<Inhoud>
			<Resultaat Beschrijving=”Niet Geslaagd”>0</Resultaat>
		</Inhoud>
		<Uitzonderingen>
			<Uitzondering>
				<Identificatie>20002</Identificatie>
				<Oorsprong>MAGDA</Oorsprong>
				<Type>FOUT</Type>
				<Tijdstip>
					<Datum>2012-08-23</Datum>
					<Tijd>10:15:49.632</Tijd>
				</Tijdstip>
				<Diagnose>INSZ in de vraag heeft een ongeldige structuur</Diagnose>
			</Uitzondering>
		</Uitzonderingen>
	</Antwoord>
</Antwoorden>

<Antwoorden>
		<Antwoord>
			<Referte>1942</Referte>
			<Inhoud>
				<Resultaat Beschrijving="Niet geslaagd">0</Resultaat>
			</Inhoud>
			<Uitzonderingen>
				<Uitzondering>
					<Identificatie>20001</Identificatie>
					<Oorsprong>MAGDA</Oorsprong>
					<Type>FOUT</Type>
					<Tijdstip>
						<Datum>2012-10-02</Datum>
						<Tijd>12:49:13.183</Tijd>
					</Tijdstip>
					<Diagnose>Ongeldig datumformaat in vraag</Diagnose>
				</Uitzondering>
			</Uitzonderingen>
		</Antwoord>
	</Antwoorden>

<Uitzondering>
	<Identificatie>30004</Identificatie>
	<Oorsprong>KSZ</Oorsprong>
	<Type>FOUT</Type>
	<Tijdstip>
		<Datum>2024-04-26</Datum>
		<Tijd>08:37:19.166</Tijd>
	</Tijdstip>
	<Diagnose>Persoon heeft een nieuw INSZ verkregen</Diagnose>
	<Omstandigheid>SSIN cancelled</Omstandigheid>
	<Annotaties>
		<Annotatie>
			<Naam>Oud INSZ</Naam>
			<Waarde>xxxxxxxxxxx</Waarde>
		</Annotatie>
		<Annotatie>
			<Naam>Nieuw INSZ</Naam>
			<Waarde>xxxxxxxxxxx</Waarde>
		</Annotatie>
	</Annotaties>
</Uitzondering>

Overzicht mogelijke annotaties

Er kunnen annotaties terugkomen in het antwoord. Dit zal alleen in bepaalde gevallen voorkomen wanneer een inschrijving bij KSZ niet geslaagd is.

In het geval van een vervangen of vervangen en daarna geannuleerd INSZ nummer kunnen er annotaties teruggeven worden met als naam “Nieuw INSZ” en “Oud INSZ” die respectievelijk als waarde het nieuwe INSZ en het oude INSZ geven. Bij een inschrijving van een oud INSZ zal de inschrijving falen met een uitzondering 30004 en moet de afnemer zelf de inschrijving doen met het nieuw INSZ. Bij het inschrijven van een geannuleerd INSZ bij de KSZ zal een uitzondering 30002 gegeven worden.

In het geval dat het bevraagd INSZ eerst vervangen is en daarna het nieuw INSZ geannuleerd is wordt uitzondering 30002 geegeven een annotaties opgegeven met het oud en het nieuw, geannuleerd INSZ.

Andere annotaties die de MAGDA dienst achterliggend van KSZ ontvangt zullen niet door MAGDA worden omgezet maar gewoon in hun KSZ vorm worden doorgegeven. Dit is bijvoorbeeld het geval in onderstaand voorbeeld waar de inschrijvingsdienst van KSZ niet actief was. De waarde “InscriptionService.addInscription” verwijst hier naar de interne dienst bij KSZ.

Voorbeeld:

<Antwoorden>
    <Antwoord>
      <Referte>1942</Referte>
      <Inhoud>
          <Resultaat Beschrijving="Niet geslaagd">0</Resultaat>
      </Inhoud>
      <Uitzonderingen>
          <Uitzondering>
            <Identificatie>60009</Identificatie>
            <Oorsprong>MAGDA</Oorsprong>
            <Type>FOUT</Type>
            <Tijdstip>
                <Datum>2012-10-02</Datum>
                <Tijd>13:54:47.589</Tijd>
            </Tijdstip>
            <Diagnose>Er heeft zich een technisch probleem voorgedaan</Diagnose>
            <Omstandigheid>INSC00002</Omstandigheid>
            <Annotaties>
                <Annotatie>
                  <Naam>Service ID</Naam>
                  <Waarde>InscriptionService.addInscription</Waarde>
                </Annotatie>
            </Annotaties>
          </Uitzondering>
      </Uitzonderingen>
    </Antwoord>
</Antwoorden>

Inschrijven van een geannuleerd INSZ

Indien een INSZ geannuleerd is kan deze dienst op 2 manieren reageren afhankelijk of ook bij KSZ een inschrijving wordt gedaan of niet. Daar MAGDA niet kan controleren of het INSZ geannuleerd is zal de inschrijving slagen indien er niet bij de KSZ wordt ingeschreven. De enigste validatie die kan gedaan worden is of de opgegeven data voldoet aan de voorwaarden zoals omschreven op de vraag pagina. De inschrijving bij MAGDA zal slagen en er zal een positief antwoord worden terug gegeven.

De KSZ kan echter wel controleren of er een dossier bestaat voor het opgegeven INSZ. Indien het INSZ geannuleerd is, is het dossier gesloten. De KSZ geeft nooit gegevens terug van een gesloten dossier waardoor zij een foutmelding teruggeven waarin staat dat het bevraagd INSZ niet gevonden wordt. Indien het INSZ niet bestaat wordt een uitzondering 30003 “Onbestaand INSZ“ opgegeven. Indien het INSZ bestaat maar geannuleerd is zal een uitzondering 30002 “Het INSZ is geannuleerd” teruggegeven worden. Indien bij een uitzondering 30002 annotaties aanwezig zijn is het INSZ eerst vervangen en daarna het nieuw INSZ geannuleerd. Zie ook de opmerking over de annotaties hierboven.

Op deze pagina

1 Algemeen
2 Overzicht dienst-specifieke uitzonderingen
3 Voorbeeld
4 Overzicht mogelijke annotaties
5 Inschrijven van een geannuleerd INSZ

Binnen deze handleiding

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

Uitzonderingen (RegistreerInschrijving-02.00)

Informatie:

Algemeen

Overzicht dienst-specifieke uitzonderingen

Voorbeeld

Overzicht mogelijke annotaties

Inschrijven van een geannuleerd INSZ

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid