Technische informatie
Technische specificaties
Foutafhandeling
Alle services gebruiken uniform gedefinieerde foutcodes om systeemfouten te melden. Een fout wordt gemeld door middel van een SOAP-fault.
<soapenv:Envelope xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <soapenv:Fault> <faultcode>soapenv:Client</faultcode> <faultstring>SOA-01001</faultstring> <detail> <SystemError Id="44ae07df-bd39-40d2-94f9-f149c047b589" xmlns="https://socialsecurity.be/errors/v1"> <Origin>Consumer</Origin> <Code>SOA-01001</Code> <Message xml:lang="en">Service call not authenticated.</Message> <Environment>Production</Environment> </SystemError> </detail> </soapenv:Fault> </soapenv:Body> </soapenv:Envelope>
Elke foutboodschap bevat naast een foutcode en beschrijving ook een unieke identificatiestring (//SystemError/@Id) waarmee de fout door onze supportdiensten verder kan worden geanalyseerd. Het is belangrijk dat de clienttoepassing steeds deze unieke id logt.
Een overzicht van de mogelijke foutmeldingen vindt u in de volgende tabel.
Code | Beschrijving | Oorzaak | Verklaring |
---|---|---|---|
SOA-00001 | Service error | This is the default error sent to the consumer in case no more details are known. | |
SOA-01001 | Service call not authenticated | Consumer | From the security information provided, either the consumer could not be identified or the credentials provided are not correct. |
SOA-01002 | Service call not authorized | Consumer | The consumer is identified and authenticated, but is not allowed to call the given service. |
SOA-02001 | Service not available. Please contact service desk. | Provider | An unexpected error has occurred. Retries will not work. Service desk may help with root cause analysis. |
SOA-02002 | Service temporarily not available. Please try later. | Provider | An unexpected error has occurred. Retries should work. If the problem persists service desk may help. |
SOA-03001 | Malformed message | Consumer | This is the default error for content related errors in case no more details are known. |
SOA-03002 | Message must be SOAP | Consumer | Message does not respect the SOAP standard. |
SOA-03003 | Message must contain SOAP body | Consumer | Message respects the SOAP standard, but body is missing. |
SOA-03004 | WS-I compliance failure | Consumer | Message does not respect the WS-I standard. |
SOA-03005 | WSDL compliance failure | Consumer | Message is not compliant with WSDL. |
SOA-03006 | XSD compliance failure | Consumer | Message is not compliant with XSD. |
SOA-03007 | Message content validation failure | Consumer | From the message content (conform XSD): extended checks on the element format failed or cross-checks between fields failed. |
De meest voorkomende problemen worden voorgesteld op de FAQ-pagina.