For software developers

This page contains the message implementing guidelines (MIGs) for message exchange, the XML schemas as well as technical guidance relating to API services. You can find the guides for message exchange on the page How to apply for message exchange customer status.

Message implementing guidelines

Import and customs warehousing

Entry

Export and exit

Transit

Guarantee query

 Source: Delegated Act of the Union Customs Code (EU) 2015/2446 – Consolidated version 25.2.2025

Code  Declaration / notification / proof of the customs status of Union goods Customs procedure codes that can be used in a declaration submitted to Finland
A1 Exit summary declaration  
A2 Exit summary declaration – express consignments (not used in Finland)  
A3 Re-export notification  
B1 Export declaration and re-export declaration 10, 11, 23, 31
B2 Special procedure – processing – declaration for outward processing 21, 22
B3 Declaration for Customs warehousing of Union goods (not used in Finland) 76, 77
B4 Declaration for dispatch of goods in the context of trade with special fiscal territories 10
C1 Export Simplified declaration 10, 11, 21, 22, 23, 31
C2 Presentation of goods to customs in case of entry in the declarant’s records or in the context of customs declarations lodged prior to the presentation of the goods at export  
D1 Special procedure – transit declaration  
D2 Special procedure –Transit declaration with reduced dataset – (transport by rail, air and maritime transport)  
D3 Special procedure – Transit – Use of an electronic transport document as customs declaration – (transport by air and maritime transport)  
E1 Proof of the customs status of Union goods (T2L/T2LF)  
E2 Customs goods manifest  
G3 Presentation of goods to customs  
G4 Temporary storage declaration  
G5 Arrival notification in case of movement of goods under temporary storage  
H1 Declaration for release for free circulation and Special procedure — specific use — declaration for end-use 01, 07, 40, 42, 43, 44, 45, 46, 48, 61, 63, 68
H2 Special procedure — storage — declaration for customs warehousing 71
H3 Special procedure — specific use — declaration for temporary admission 53
H4 Special procedure – processing – declaration for inward processing 51
H5* Declaration for the introduction of goods in the context of trade with special fiscal territories 40, 61
H6 Customs declaration in postal traffic for release for free circulation (not used in Finland)  
H7 Import declaration for low value goods 4000
I1 Import Simplified declaration 01, 07, 40, 42, 43, 44, 45, 46, 48, 51, 53, 61, 63, 68, 71
I2 Presentation of goods to customs in case of entry in the declarant’s records (EIDR)   01, 07, 40, 42, 43, 44, 45, 46, 48, 51, 53, 61, 63, 68, 71


*In Finland, message descriptions use nationally specified type codes from the H5 tax border declaration:

  • H5E – Import tax border declaration in trade with special fiscal territories (e.g. import from another EU country across the tax border to Åland)
    • This declaration may also have been referred to with the code H5EU.
  • H5N – National simplified tax border declaration, not registered for VAT or registered for VAT
  • H5P – National simplified tax border declaration, recapitulative statement for tax border customers 

XML schemas

Other interface transactions

The Fintaric distribution service provided by Customs contains the data from the EU Taric database as well as the national additions in machine-readable format. The distribution service is open to all and software developers may use it when offering their customers services pertaining to the customs nomenclature and customs declaration.

The Fintaric distribution service is available via the Suomi.fi portal or via the Customs interface.

Alternative 1: Using the distribution service via the Suomi.fi Data Exchange Layer

You can use the Fintaric distribution service via the Suomi.fi Data Exchange Layer. Start using it by submitting an application to the Digital and Population Data Services Agency. For more detailed guidance, go to the page Data Exchange Layer on the website of the Digital and Population Data Services Agency. A description of the Fintaric distribution service is available in the API Catalogue of the Data Exchange Layer: Tulli-FINTARIC-Service.

Alternative 2: Using the distribution service via the Customs interface

The Fintaric distribution service is also available without using the Suomi.fi Data Exchange Layer. The interface requires the company to obtain a server certificate from the Digital and Population Data Services Agency (DVV). No separate registration is required.

Retrieving WSDL descriptions:

Addresses to the distribution service:

You can get more information from Customs Business Information.

Pre-completed declaration for the GoodsShipmentInfo web service

Transport companies can make it easier for their customers to submit import declarations via the GoodsShipmentInfo (GSI) web service. With the service, customers receive pre-completed declarations for finalisation in the Customs e-service. A pre-filled detail can be, for example, identification of warehouse.

Customers receive information for their declaration with an arrival ID query, that is, by entering the consignment’s arrival ID or consignment note number in the e-service. With that information, the GSI web service retrieves data on the consignment for the declaration from the data system of the transport company.

Guidance on the implementation of the GSI web service

The transport company implements the service in its own system based on specifications from Customs, and applies authorisation from Customs for linking the web service with the Customs system. The functionality of the web service must be tested with Customs.

You can apply for authorisation via the Authorisations and Decisions Service. Under “Declarations for which the authorisation is applied”, select “My company intends to submit advance information to Customs for the import declaration (GoodsShipmentInfo)”.

You can get more information from Customs Business Information. 

Updated: