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
- Import 3.0 MIGs (deployed in all import declarations: declarations for special procedures, simplified declarations and declarations for release for free circulation as well as customs warehousing declarations on 2 September 2023)
- Import 2.1 MIGs (deployed in all import declarations: declarations for special procedures, simplified declarations and declarations for release for free circulation as well as customs warehousing declarations in autumn 2022)
Entry
- MIGs for temporary storage declarations and presentation notifications (v. 2.5 deployed on 2 September 2023)
Export
- ELEX and UTU export (differences)
- Export MIGs (to be deployed in spring 2024)
Transit
Guarantee query
- AREX MIGs (zip) Version 1.5 amendment 6, updated on 31 May 2024
- ELEX MIGs (zip) Version 2.2 amendment 1, updated on 8 June 2022
- System-specific MIG files Updated on 17 September 2012
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:
- Test environment: https://api-test.tulli.fi:4443/fintaric/TradersExport?WSDL
- Production environment: https://api.tulli.fi:4443/fintaric/TradersExport?WSDL
Addresses to the distribution service:
- Test environment: https://api-test.tulli.fi:4443/fintaric/TradersExport
- Production environment: https://api.tulli.fi:4443/fintaric/TradersExport
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 online service “Applying for a message exchange authorisation”. 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.