Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Redirect
locationhttps://etir.org/documentation/error-codes

Warning
titleDeprecated Error code page

This page is the OLD PAGE and should no longer be updated at this point as the reference error code page is located on the eTIR.org website at the following URL: 

https://etir.org/documentation/error-codes


The following SOP explains how to add new error codes on the eTIR.org error code page: How to add a new error code



Table of Contents

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 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 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

fieldI17/I18, E11/E12
Error codeError nameDescriptionPointer is set toObservations

100

Anchor
100
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

Anchor
101
101

Missing fieldA required field is missing in the messageThe pointer is set to the missing fieldAll requests

102

Anchor
102
102

Invalid domain for the valueThe value is outside a defined list of acceptable valuesThe pointer is set to the invalid fieldAll requests

103

Anchor
103
103

Malformed dateA field containing a date value cannot be properly convertedThe pointer is set to the invalid fieldI1/I2, I7/I8, I9/I10, I11/I12, I13/I14, I17/I18, E1/E2, E3/E4, E9/E10, E11/E12, E13/E14

104

Anchor
104
104

Not an integerA numeric field contains a value that is not numericThe pointer is set to the invalid fieldI7/I8, E9/E10, E11/E12, E13/E14

105

Anchor
105
105

Field value length exceeded

A String field contains a value with too many characters

The pointer is set to the invalid fieldAll requests

106

Anchor
106
106

Invalid patternA String field does not match the pattern for the field defined in the XML Schema Definition of the messageThe pointer is set to the invalid fieldAll requests

107

Anchor
107
107

Invalid fieldThe specified field does not follow the order defined in the XML Schema Definition of the messageThe pointer is set to the invalid fieldAll requests

108

Anchor
108
108

Missing XML attributeThe specified XML tag is missing a required attribute (e.g. formatCode for all date fields)The pointer is set to the invalid fieldI1/I2, I7/I8, I9/I10, I11/I12, I13/I14, I17/I18, E1/E2, E3/E4, E9/E10, E11/E12, E13/E14

109

Anchor
109
109

Invalid XML attributeThe specified XML tag has an invalid attribute value (e.g. formatCode for all date fields)The pointer is set to the invalid fieldI1/I2, I7/I8, I9/I10, I11/I12, I13/I14, I17/I18, E1/E2, E3/E4, E9/E10, E11/E12, E13/E14

110

Anchor
110
110

Too many digitsThe number has too many digitsThe pointer is set to the invalid fieldI7/I8, E9/E10

111

Anchor
111
111

Too much precisionThe number has a decimal part with too many digitsThe pointer is set to the invalid fieldI7/I8, E9/E10

120

Anchor
120
120

Invalid eTIR specifications versionThe version specified in the metadata fields is not the one(s) approved to function in the eTIR systemThe pointer is set to the invalid metadata fieldAll messages

151

Anchor
151
151

Condition C001 failureThe condition C001 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

152

Anchor
152
152

Condition C002 failureThe condition C002 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

153

Anchor
153
153

Condition C003 failureThe condition C003 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

154

Anchor
154
154

Condition C004 failureThe condition C004 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

155

Anchor
155
155

Condition C005 failureThe condition C005 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

156

Anchor
156
156

Condition C006 failureThe condition C006 is not satisfiedNo pointerThis condition applies to all response messages

157

Anchor
157
157

Condition C007 failureThe condition C007 is not satisfiedNo pointerThis condition applies to response messages: E9/E10, E13/E14

158

Anchor
158
158

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

159

Anchor
159
159

Condition C009 failureThe condition C009 is not satisfiedNo pointerThis condition applies to response messages: E11/E12

160

Anchor
160
160

Condition C010 failureThe condition C010 is not satisfiedThe pointer is set to the invalid fieldI15/I16, E11/E12

181

Anchor
181
181

Rule R001 failureThe rule R001 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10

182

Anchor
182
182

Rule R002 failureThe rule R002 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10

188

Anchor
188
188

Rule R008 failureThe rule R008 is not satisfiedThe pointer is set to the invalid fieldI7/I8, I15/I16, E9/E10, E11/E12

190

Anchor
190
190

Rule R010 failureThe rule R010 is not satisfiedThe pointer is set to the invalid fieldI17/I18, E11/E12

194

Anchor
194
194

Rule R014 failureThe rule R014 is not satisfiedNo pointerI7/I8

195

Anchor
195
195

Rule R015 failureThe rule R015 is not satisfiedNo pointerI7/I8

2XX - Workflow errors

Error codeError nameDescriptionPointer is set toObservations

200

Anchor
200
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

Anchor
201
201

Invalid guarantee statusThe guarantee is not in a state that allows to perform the required operationRoot of the messageI1/I2, I9/I10, I11/I12, I13/I14

203

Anchor
203
203

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

204

Anchor
204
204

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

205

Anchor
205
205

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

210

Anchor
210
210

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

211

Anchor
211
211

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

212

Anchor
212
212

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

213

Anchor
213
213

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

214

Anchor
214
214

Operation ID already registeredThe "refusal to start" is an operation on its own and must have a unique operation IDRoot of the messageI17/I18

215

Anchor
215
215

Operation sequence already registeredThe "refusal to start" is an operation on its own and must have a unique operation sequenceRoot of the messageI17/I18

216

Anchor
216
216


Refusal to start not authorizedThe "refusal to start" cannot be performed because of the current guarantee status or because it is the first operation for this transportRoot of the messageI17/I18

220

Anchor
220
220


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

299

Anchor
299
299

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

3XX - Functional errors

/E2, E5/E6331Guarantee chain chain code 332332333334Declaration already cancelled modified cancelled E11/E12, E13/E14
Error codeError nameDescriptionPointer is set toObservations

300

Anchor
300
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

Anchor
301
301

Guarantee not foundThe guarantee was not found in the databaseTo the guarantee reference (if applicable)I1/I2, I5/I6, I7/I8, I9/I10, I11/I12, I13/I14, I17/I18, E3/E4, E5/E6, E9/E10, E11/E12, E13/E14

302

Anchor
302
302

Guarantee chain not foundThe guarantee chain was not found in the databaseRoot of the messageI9/I10, I11/I12, I13/I14, I17/I18, E1/E2, E3/E4

303

Anchor
303
303

Guarantee type not foundThe guarantee type was not found in the databaseRoot of the messageI9/I10, I11/I12, I13/I14, I17/I18, E1/E2, E3/E4

304

Anchor
304
304

Customs office not foundThis error code is not used in the eTIR specifications v4.3, except in the context of the message pair I19/I20Root of the messageI19/I20

305

Anchor
305
305

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

306

Anchor
306
306

Control type not foundThe control type was not found in the databaseTo the control type field, if applicableI9/I10, I11/I12, I17/I18

307

Anchor
307
307

Declaration not foundThe related declaration was not found in the database
I7/I8

308

Anchor
308
308

Forward information not foundThe eTIR international system could not find information on whom to forward the message toRoot of the messageE9/E10 / E11/E12, E13/E14

309

Anchor
309
309

Seals information already registeredThe information received about the mentioned seal was already recorded in the database

TransportEquipment/Seal/ID

I9/I10, I11/I12

310

Anchor
310
310

Seals information should not be sentThe seal's information should not be sent in the record declaration data message TransportEquipment/Seal/IDI7/I8

320

Anchor
320
320

Holder/Guarantee mismatch

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

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

321

Anchor
321
321

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

322

Anchor
322
322

Holder not foundThe holder is not found in ITDBThe holder/Principal IDE1/E2, E5/E6, I1/I2, I3/I4, I5/I6, I9/I10, I11/I12, I13/I14

330

Anchor
330
330

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

331

Anchor
331
331

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

332

Anchor
332
332

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

333

Anchor
333
333

Declaration reference not foundThe FunctionalReferenceID value does not match what is already recorded in the database
 
Declaration/FunctionalReferenceIDE11/E12, E13/E14

334

Anchor

334

332Guarantee type/Guarantee mismatchThe guarantee type value and the guarantee reference value do not match what is recorded in the databaseRoot of the messageI1/I2, E3/E4
Anchor
333333Declaration reference not foundThe FunctionalReferenceID value does not match what is already recorded in the database
 
Declaration/FunctionalReferenceIDE11/E12, E13/E14
Anchor
334334

334

Declaration already cancelledThe declaration could not be modified because it was already cancelled
 
DeclarationE11/E12, E13/E14

335

Anchor
335
335

Transport equipment not registredThe transport equipment not found in the databaseConsignment/TransportEquipment/IDI9/I10, I11/I12

336

Anchor
336
336

Declaration already receivedThe declaration could not be registred because it was already receivedInterGov/DeclarationI7/I8

4XX - Internal errors

Error codeError nameDescriptionPointer is set toObservations

400

Anchor
400
400

eTIR internal errorAn 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

5XX - Customs errors

Error codeError nameDescriptionPointer is set toObservations

500

Anchor
500
500

Customs declaration processing errorThe message was not accepted by customs and no additional details are available for this errorRoot of the messageThis is the default error code for this class

501

Anchor
501
501

Advance TIR data not accepted

Customs did not accept the advance TIR dataRoot of the messageE9/E10

502

Anchor
502
502

Advance amendment data not accepted

Customs did not accept the advance amendment dataRoot of the messageE11/E12