Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Uitzonderingen (GeefBetalingenHandicap-03.00)

Owned by Bert Van Kets
Last updated: 17 Aug, 2023 by Steven Lories
4 min read

Informatie:

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

Algemeen

Daar bij deze dienst de inhoud van het antwoord van de bron wordt overgenomen geeft MAGDA enkel aan in welke categorie de melding van de bron thuis hoort. Er zijn drie categorieën aangemaakt

  • 70001 : Een antwoord van het Type INFORMATIE of WAARSCHUWING is van de bron ontvangen. Er is inhoud aanwezig.

  • 70002 : Een antwoord van het type FOUT is van de bron ontvangen. Er is geen inhoud aanwezig

  • 70003 : Een SOAP Fault is van de bron ontvangen. Er is geen inhoud aanwezig.

Bij de 70001 en 70002 uitzonderingen dienen de Status elementen in de inhoud van het bericht geëvalueerd te worden volgens het TSS document van KSZ. 

Uitzonderingen die door het MAGDA platform worden vastgesteld en niet van de bron komen worden weergegeven met een Oorsprong = "MAGDA". Dezelfde werking wordt gevolgd als de overige MAGDA-webservices.

Overzicht dienst-specifieke uitzonderingen

Deze uitzonderingen zijn steeds dienst specifiek me volgende vaste waarden:

  • Niveau : 3

  • Type : FOUT

  • Oorsprong : MAGDA.

Identificatie

Toelichting

20002

Opgegeven INSZ voldoet niet aan de Checksum97 controle

20003

Begindatum moet voor de einddatum liggen

16010

Mismatch tussen verwacht formaat en gekregen formaat van het antwoord vanuit de bron.

60004

Onbekende fout bij de bron

60006

Geen antwoord van de bron ontvangen

60013

Fout in toegang naar de bron

60019

Dienst gepauzeerd. Probeer later opnieuw. Contacteer de MAGDA helpdesk.

KSZ Status Codes

Het status element van KSZ bevat de gedetailleerde informatie over hoe de verwerking verlopen is. Hieronder is de lijst te vinden van de Status/Code waarden die deze dienst kan teruggeven volgens de handleiding van de bron. Verdere details over de Status Code waarde is te vinden op KSZ Status element.

  • MSG00000

  • MSG00100

  • HAN20200

  • MSG00005

  • MSG00006

  • MSG00008

  • MSG00011

  • MSG00012

  • MSG00013

  • MSG00021

  • MSG00027

  • MSG00028

  • HAN00008

 

MSG00021 extra uitleg

Dit is een geldig antwoord en betekent dat er minstens één bron-status handicap is met waarde NO_DATA_FOUND. Er is dan gewoon geen dossier bij de gegevensbron handicap voor de opgevraagde periode. De andere-bron status zijn NO_DATA_FOUND of NO_RESULT. Voor alle bron-status met NO_DATA_FOUND is de code die de KSZ terug geeft via HandiserviceV2 MSG00021.

SOAP faults van de bron

Indien de bron een SOAP Fault terug geeft zal MAGDA een uitzondering 70003 terug geven. Deze bevat dan de SOAP Fault details die van de bron ontvangen zijn.

Hieronder de details van de verschillende uitzonderingen met MAGDA code 70003. Deze uitzonderingen hebben steeds

  • Identificatie : 70003

  • Oorsprong : KSZ

  • Type : FOUT

  • Tijdstip : Datum en tijd van het aanmaken van de uitzondering

  • Diagnose : Fatale fout

  • Omstandigheid: FATAL

De informatie in deze tabel opgenomen komt van de bron en is niet in het beheer van MAGDA.

KSZ Status code

MAGDA Annotaties

Naam

Waarde

MSG00002

Source fault code

MSG00002

Source message

Error in communication with the destination/supplier.

Schema validation error on response from backend X

[the schema validation error]

SoapFault received from backend X

[information on the soapfault from backend]

Unexpected response from backend X

[information on the unexpected response]

MSG00003

Source fault code

MSG00003

Source message

Internal Error

MSG00004

Source fault code

MSG00004

Source message

The request has an invalid structure

error message

[the schema validation error]

MSG00014

Source fault code

MSG00014

Source message

Authentication failure - Access not allowed

MSG00015

Source fault code

MSG00015

Source message

Client organization is not authorized to use this web service

MSG00016

Source fault code

MSG00016

Source message

Invalid WS-Security Signature

Annotaties

Bij de uitzonderingen 70001, 70002 en 70003 zullen annotaties worden doorgegeven. Deze annotaties bevatten de foutcode en de bericht die van de bron is ontvangen.

<Uitzonderingen> <Uitzondering> <Identificatie>70003</Identificatie> <Oorsprong>KSZ</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum>2020-05-18</Datum> <Tijd>12:57:28.957</Tijd> </Tijdstip> <Diagnose>Fatale fout</Diagnose> <Omstandigheid>FATAL</Omstandigheid> <Annotaties> <Annotatie> <Naam>status code</Naam> <Waarde>MSG00002</Waarde> </Annotatie> <Annotatie> <Naam>status description</Naam> <Waarde>Error in communication with the destination/supplier</Waarde> </Annotatie> <Annotatie> <Naam>detail</Naam> <Waarde>Unexpected response from supplier</Waarde> </Annotatie> </Annotaties> </Uitzondering> </Uitzonderingen>

Voorbeeld MAGDA Uitzondering

<Uitzonderingen> <Uitzondering> <Identificatie>20002</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum>2020-05-30</Datum> <Tijd>10:36:38</Tijd> </Tijdstip> <Diagnose>Opgegeven INSZ voldoet niet aan de Checksum97 controle</Diagnose> </Uitzondering> </Uitzonderingen>

Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

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

uitgegeven door Digitaal Vlaanderen