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/referencelists every dataset, with its path and the fields of a record.GET /api/reference/{entityType}/activereturns the records in force, for exampleGET /api/reference/transport-modes/active. It takes the usualfilter,query,order-by,page-numberandpage-sizeparameters.GET /api/reference/{entityType}/versiontells 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:
| Code | Mode | Use it when | What goes in plate_registration_no | nationality |
|---|---|---|---|---|
1 | Maritime transport | The leg is on the open sea, port to port | The vessel's IMO number, otherwise its name or registration number | The flag state |
2 | Rail transport | The goods travel on a railway | The wagon number, otherwise the train number | The state of registration |
3 | Road transport | The goods travel on a road vehicle | The plate or registration number | The state of registration |
4 | Air transport | The goods travel by aircraft | The aircraft's registration mark | The state of registry |
8 | Inland water transport | The leg stays on a lake, river or canal | The vessel's registration number or name | The 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.5mail,7fixed transport installation and9not 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.