Skip to main content

Reference data

ITS validates eTD fields against its current reference data. The Portal displays the relevant country, station and other values when a person prepares or reviews a declaration. Use the currently agreed dataset with your integration and investigate a validation error using its error code and correlation ID.

Your system can read the same lists ITS validates against, on its partner entry, with the token it uses for declarations. The reads are listed in the ITS API reference:

  • GET /api/reference lists every dataset, with its path and the fields of a record.
  • GET /api/reference/{entityType}/active returns the records in force, for example GET /api/reference/transport-modes/active. It takes the usual filter, query, order-by, page-number and page-size parameters.
  • GET /api/reference/{entityType}/version tells you whether a list changed since you last fetched it, so you can refresh a local copy only when it did.

Partner systems can only read these lists. The Secretariat maintains them.

Mode of transport​

You state a mode for every means of transport you name: means_of_transport.at_departure, means_of_transport.crossing_border when you declare it, and the vehicle on a stamp when an office records one. There is no default. A means of transport without transport_mode is refused with ERR-015 on that field.

Five modes are in force. Each names a kind of conveyance:

CodeModeUse it whenWhat goes in plate_registration_nonationality
1Maritime transportThe leg is on the open sea, port to portThe vessel's IMO number, otherwise its name or registration numberThe flag state
2Rail transportThe goods travel on a railwayThe wagon number, otherwise the train numberThe state of registration
3Road transportThe goods travel on a road vehicleThe plate or registration numberThe state of registration
4Air transportThe goods travel by aircraftThe aircraft's registration markThe state of registry
8Inland water transportThe leg stays on a lake, river or canalThe vessel's registration number or nameThe state of registry

Maritime (1) or inland water (8)? The water decides, not the vessel. A leg that crosses the sea is maritime, whatever sails it. A leg confined to inland waters, such as Lake Victoria, Lake Tanganyika, the Congo, the Nile or the Zambezi, is inland water, even on a large ship.

The field is named plate_registration_no because the adopted Transit Document words boxes 15 and 17 that way. It holds whatever identifies the means of transport for its mode, up to 35 characters, with no format imposed.

Codes you do not send. All four are refused with VAL-ETD-003:

  • 6, multimodal. It describes a journey, not a means of transport. State each means of transport's own mode and let them differ where they do, for example rail to the border and road across it. ITS then reports the declaration as multimodal.
  • 5 mail, 7 fixed transport installation and 9 not applicable. None names a means of transport.

ITS returns the mode in words beside the code, as transport_mode_name, and prints it inside boxes 15 and 17 of the Transit Document under Mode of transport.