...
- 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 from 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, in case of issue, to identify and correct the underlying issue.
- 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 the first digit of the status code defines the class of response:
- 1XX - Validation: validation of the message and if its parameters
- 2XX - Workflow: workflow related errors
- 3XX - Functional: other functional errors
- 4XX - Internal: eTIR international system internal errors
- 5XX - Customs: errors raised by Customs
- 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
In the following list, the following terms are used:
- Message: An XML message
- Field: An XML element or attribute
- Value: The value mentioned in an XML element or attribute
1XX - Validation errors
| Error code | Error name | Description | Pointer is set to | Observations | ||
|---|---|---|---|---|---|---|
100
| Invalid message | The message is invalid, and no additional details are available for this error | Root of the message | This is the default error code for this class | ||
101
| Missing parameterfield | A required parameter field is missing in the message | The pointer is set to the missing parameterfield | All requests | ||
102
| Invalid domain for the value parameter | A parameter The value is out of a defined list of acceptable values | The pointer is set to the invalid parameterfield | All requests | ||
103
| Malformed date | A parameter field containing a date information value cannot be properly converted | The pointer is set to the invalid parameterfield | I1/I2, I7/I8, I9/I10, I11/I12, I13/I14, E1/E2, E9/E10 | ||
104
| Not an integer | A numeric field is containing data contains a value that is not numeric | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12, E13/E14 | ||
105
| Parameter Value length exceeded | A String field contains a value with too many characters | The pointer is set to the invalid parameterfield | All requests | ||
106
| Invalid pattern | A String field does not match the pattern for the field defined in the XML Schema Definition of the message | The pointer is set to the invalid parameterfield | All requests | ||
107
| Invalid element | The specified element is field does not following follow the order defined in the XML Schema Definition of the schemamessage | The pointer is set to the invalid parameterfield | All requests | ||
151
| Condition C001 failure | The condition C001 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
152
| Condition C002 failure | The condition C002 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
153
| Condition C003 failure | The condition C003 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
154
| Condition C004 failure | The condition C004 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
155
| Condition C005 failure | The condition C005 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
158
| Condition C008 failure | The condition C008 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8, E9/E10, E11/E12 | ||
188
| Rule R008 failure | The rule R008 is not satisfied | The pointer is set to the invalid parameterfield | I7/I8 |
2XX - Workflow errors
...
| Error code | Error name | Description | Pointer is set to | Observations | ||
|---|---|---|---|---|---|---|
300
| Invalid operation | An invalid operation was performed, and no additional details are available for this error | Root of the message | This is the default error code for this class | ||
301
| Guarantee not found | The guarantee was not found in the database | To the guarantee reference (if applicable) | All requests | ||
302
| Guarantee chain not found | The guarantee chain was not found in the database | Root of the message | All requests | ||
303
| Guarantee type not found | The guarantee type was not found in the database | Root of the message | All requests | ||
304
| Customs office not found | The customs office was not found in the database | Root of the message | E9/E10, I7/I8, I9/I10, I11/I12, I13/I14 | ||
305
| Country not found | The country was not found in the database | Root of the message | E9/E10, I7/I8, I9/I10, I11/I12, I13/I14 | ||
306
| Country not connected | The country is not yet connected to the eTIR international system and cannot be part of the itinerary of a TIR transport using the eTIR procedure | ??? | ??? | ||
307
| Control type not found | The control type was not found in the database | To the control type element, if applicable | I9/I10, I11/I12, I13/I14 | ||
320
| Holder/Guarantee mismatch | The holder id parameter value and the guarantee reference parameter value do not match what match what is recorded in the database | Root of the message | I1/I2, I7/I8, E3/E4, E9/E10, E11/E12, E13/E14 | ||
321
| Holder not authorized | The holder is not authorized in the International TIR Data Bank (ITDB) | Root of the message | E1/E2, I1/I2, I9/I10, I11/I12, I13/I14, | ||
322
| Holder not found | The holder is not found in ITDB | The holder/Principal ID | E1/E2, E5/E6, I1/I2, I3/I4, I5/I6, I9/I10, I11/I12, I13/I14 | ||
330
| Guarantee chain not authorized | The guarantee chain is not authorized in the database | Root of the message | I1/I2, E1/E2, E5/E6 | ||
331
| Guarantee chain/Guarantee mismatch | The guarantee chain code parameter value and the guarantee reference parameter value do not match what is recorded in the database | Root of the message | I1/I2, E3/E4 | ||
332
| Guarantee type/Guarantee mismatch | The guarantee type parameter value and the guarantee reference parameter value do not match what match what is recorded in the database | Root of the message | I1/I2, E3/E4 | ||
333
| Declaration reference not found | The FunctionalReferenceID value do not match to what is already recorded in the database | DeclarartionDeclaration/FunctionalReferenceID | E11/E12, E13/E14 | ||
334
| Declaration already cancelled | The declaration could not be modified because it was already cancelled | /DeclarartionDeclaration | E11/E12, E13/E14 |
4XX - Internal errors
...