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	Example	Pointer is set to	Observations
100	Bad Message	The message is invalid and there is no additional precision on the error	N/A	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
151	Condition C001 failure	The condition is not fulfilled		The pointer is set to the invalid parameter
152	Condition C002 failure	The condition is not fulfilled		The pointer is set to the invalid parameter
154	Condition C004 failure	The condition is not fulfilled		The pointer is set to the invalid parameter
155	Condition C005 failure	The condition is not fulfilled		The pointer is set to the invalid parameter
158	Condition C008 failure	The condition is not fulfilled		The pointer is set to the invalid parameter

2XX - Workflow

Error code	Error name	Description	Example	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	N/A	Root of the message	This is the default error code for this class
201	Guarantee not startable	Guarantee is not in a state that allow to accept it		Root of the message
202	Holder status exception	The state of the holder is not what it should have been to realize the current operation		Root of the message
203	Guarantee not cancellable	The state of the guarantee does not allow for cancellation		Root of the message
210	Operation already started	Operation already started		Root of the message
211	Operation already terminated	Operation already terminated		Root of the message
212	Operation already discharged	Operation already discharged		Root of the message
213	Operation not yet started	Operation not yet started		Root of the message
299	Duplicate message	We received the same message from the same source already		Root of the message

3XX - Technical errors

Error code	Error name	Description	Example	Pointer is set to	Observations
300	Wrong Operation	An invalid operation was performed and there is no additional precision on the error	N/A	Root of the message	This is the default error code for this class
301	Guarantee not found	Guarantee not found in our DB		To the guarantee reference (if applicable)
302	Guarantee chain not found	Guarantee chain not found in DB		Root of the message
303	Guarantee type not found	Guarantee type not found in DB		Root of the message
304	Customs not found	Customs not found in DB		Root of the message
305	Country not found	Country not found in DB		Root of the message
320	Holder/Guarantee mismatch	The holder id parameter and the guarantee reference parameter does not match what we have in DB		Root of the message
321	Holder not active	Holder not active		Root of the message
330	Guarantee chain not authorized	Guarantee chain not authorized		Root of the message
340	Multiple operations found	Used when operations are duplicated in the DB		Root of the message

4XX - Internal errors

Error code	Error name	Description	Example	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	N/A	Root of the message	This is the default error code for this class

Page tree

Error Management