Page tree
Skip to end of metadata
Go to start of metadata

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 series 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 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 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 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 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 codeError nameDescriptionPointer is set toObservations

100

Invalid MessageThe message is invalid and no additional details are available for this errorRoot of the messageThis is the default error code for this class

101

Missing ParameterA required parameter is missing in the messageThe pointer is set to the missing parameterAll requests

102

Invalid Domain Value ParameterA parameter value is out of a defined list of acceptable valuesThe pointer is set to the invalid parameterAll requests

103

Malformed DateA parameter containing a date information cannot be properly convertedThe pointer is set to the invalid parameterI7/I8, I9/I10, I11/I12, I13/I14, E1/E2, E9/E10

104

Not an integerA numeric field is containing data that is not numericThe pointer is set to the invalid parameterI7/I8, E9/E10

151

Condition C001 failureThe condition C001 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

152

Condition C002 failureThe condition C002 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

153

Condition C003 failureThe condition C003 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

154

Condition C004 failureThe condition C004 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

155

Condition C005 failureThe condition C005 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

158

Condition C008 failureThe condition C008 is not satisfiedThe pointer is set to the invalid parameterI7/I8, E9/E10

2XX - Workflow

Error codeError nameDescriptionPointer is set toObservations

200

Invalid StateThe state of an internal object is invalid and no additional details are available for this errorRoot of the messageThis is the default error code for this class

201

Guarantee not acceptableThe guarantee is not in a state that allow to accept itRoot of the messageI1/I2, I9/I10

203

Guarantee not cancellableThe guarantee is not in a state that allow to cancel itRoot of the messageE3/E4

204

Guarantee already registeredThe guarantee has already been registeredRoot of the messageE1/E2

205

Guarantee already cancelledThe guarantee is already cancelled or the request to cancel it has already been sentRoot of the messageE3/E4

210

Operation already startedThe operation is already startedRoot of the messageI9/I10

211

Operation already terminatedThe operation has already been completedRoot of the messageI11/I12

212

Operation already dischargedThe operation is already dischargedRoot of the messageI13/I14

213

Operation not yet startedThe operation is not yet startedRoot of the messageI11/I12, I13/I14

220

Declaration not yet receivedThe operation cannot be started because the declaration was not receivedRoot of the messageI9/I10

299

Duplicate messageThe same message was already received from the same sourceRoot of the messageI9/I10, I11/I12, I13/I14

3XX - Technical errors

Error codeError nameDescriptionPointer is set toObservations

300

Invalid OperationAn invalid operation was performed and no additional details are available for this errorRoot of the message

This is the default error code for this class

301

Guarantee not foundThe guarantee was not found in the databaseTo the guarantee reference (if applicable)All requests

302

Guarantee chain not foundThe guarantee chain was not found in the databaseRoot of the messageAll requests

303

Guarantee type not foundThe guarantee type was not found in the databaseRoot of the messageAll requests

304

Customs Office not foundThe customs office was not found in the databaseRoot of the messageE9/E10, I7/I8, I9/I10, I11/I12, I13/I14

305

Country not foundThe country was not found in the databaseRoot of the messageE9/E10, I7/I8, I9/I10, I11/I12, I13/I14

306

Control type not foundThe control type was not found in the databaseTo the control type element, if applicableI9/I10, I11/I12, I13/I14

320

Holder/Guarantee mismatch

The holder id parameter and the guarantee reference parameter do not match what is recorded in the database

Root of the messageI1/I2, I7/I8, E3/E4, E9/E10

321

Holder not authorizedThe holder is not authorized in the International TIR Data Bank (ITDB)Root of the messageE1/E2, I9/I10, I11/I12, I13/I14

330

Guarantee chain not authorizedThe guarantee chain is not authorized in the databaseRoot of the messageI1/I2, E1/E2

331

Guarantee chain/Guarantee mismatchThe guarantee chain code parameter and the guarantee reference parameter do not match what is recorded in the databaseRoot of the messageI1/I2, E3/E4

332

Guarantee type/Guarantee mismatchThe guarantee type parameter and the guarantee reference parameter do not match what is recorded in the databaseRoot of the messageI1/I2, E3/E4

340

Multiple operations foundThis code is used when operations are duplicated in the databaseRoot of the messageI9/I10, I11/I12, I13/I14

4XX - Internal errors

Error codeError nameDescriptionPointer is set toObservations

400

eTIR ProblemAn internal error in the eTIR international system occurred and no additional details are available for this errorRoot of the messageThis is the default error code for this class
  • No labels