You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 3
Next »
Introduction
The eTIR internation system is based on web services that are exchanged between the different stakeholders. The messages exchanged using these web services are specified and used according to the rules detailed in the eTIR Specifications. When the eTIR internation system receives and processes a message, it performs a serie of validation on the message itself, on the context of related guarantee, holder or transport and issues a response to the system which has sent the message in the first place. If anything goes wrong during these validation and processing steps, an error is sent back in the reponse. This error is presented as an Error code with a Pointer which can be used to point towards a specific field of the message. The list of all error codes is available in the Code List 99 and is also reproduced on this page for ease of reference, and as a living document, representing the latest version of these codes.
Specifications of the Error Codes
- This list of error codes is specific to eTIR as it allows IT teams to better understand errors while implementing the interconnection to the eTIR international system. This should result in a faster implementation overall and more accurate responses to errors on the side of the system sending messages to the eTIR international system.
- Furthermore, a detailed error code system will also greatly simplify the communication between the stakeholders and the Help Desk of the TIR Secretariat to in case of issues, to identify and correct the underlying problem.
- The list of error codes is based on best practices from the IT industry. Like the list of HTTP status codes, all error codes have three digits and are the first digit of the status code defines the class of response:
- 1XX - Validation: validation of the message and its parameters
- 2XX - Workflow: workflow related problems
- 3XX - Functional: other functional problems
- 4XX - Internal: eTIR international system internal problems
- Each class of response has a default error code which indicates at least the class of the error if it cannot be more precise.
List of error codes
1XX - Validation
| Error code | Error name | Description | Pointer is set to | Observations |
|---|
| 100 | Bad Message | The message is invalid and there is no additional precision on the error | Root of the message | This is the default error code for this class |
| 101 | Missing Parameter | A required parameter is missing in the message | The pointer is set to the missing parameter |
|
| 102 | Invalid Domain Value Parameter | A parameter is outside a deifned list of accepted values | The pointer is set to the invalid parameter |
|
| 103 | Maformed Date | A parameter holding a date cannot be properly converted | The pointer is set to the invalid parameter |
|
2XX - Workflow
| Error code | Error name | Description | Pointer is set to | Observations |
|---|
| 200 | Bad State | The state of an internal object is invalid and there is no additional precision on the error | Root of the message | This is the default error code for this class |
3XX - Workflow
| Error code | Error name | Description | Pointer is set to | Observations |
|---|
| 300 | Wrong Operation | An invalid operation was performed and there is no additional precision on the error | Root of the message | This is the default error code for this class |
4XX - Workflow
| Error code | Error name | Description | Pointer is set to | Observations |
|---|
| 400 | eTIR Problem | An internal error in the eTIR international system occured and there is no additional precision on the error | Root of the message | This is the default error code for this class |