Informations techniques
Traitement des erreurs
Tous les services utilisent des codes d'erreur uniformément définis pour signaler les erreurs système. Une erreur est signalée par une 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>
Outre un code d'erreur et une description, tout message d'erreur contient une chaîne d'identification unique (//SystemError/@Id) qui permet à nos services de support de suivre l'erreur (système). Il est important que l’application client enregistre toujours cet ID unique.
Vous trouverez un aperçu des messages d'erreur possibles dans le tableau ci-dessous.
Code | Description | Cause | Explication |
---|---|---|---|
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. |
Les problèmes les plus courants sont présentés sur la page de FAQ.