Ohjelmistokehittäjälle
Tällä sivulla on koostetusti sanoma-asioinnin sanomakuvaukset, XML-skeemat sekä API-palveluihin liittyvää teknistä ohjeistusta. Sanoma-asioinnin oppaat löytyvät sivulta Näin haet sanoma-asiakkaaksi.
Sanomakuvaukset
Lähde: Unionin tullikoodeksin delegoitu asetus (EU) 2015/2446 – Konsolidoitu versio 25.2.2025
| Koodi | Ilmoitus / tiedonanto / unionitavaroiden tullioikeudellista asemaa koskeva todiste | Tullimenettelykoodit, jotka ovat mahdollisia Suomeen annettavassa ilmoituksessa |
|---|---|---|
| A1 | Poistumisen yleisilmoitus | |
| A2 | Poistumisen yleisilmoitus – pikalähetykset (ei käytössä Suomessa) | |
| A3 | Jälleenvientitiedonanto | |
| B1 | Vienti-ilmoitus ja jälleenvienti-ilmoitus | 10, 11, 23, 31 |
| B2 | Erityismenettely – jalostus – ulkoista jalostusta koskeva ilmoitus | 21, 22 |
| B3 | Unionitavaroiden tullivarastointia koskeva ilmoitus (ei käytössä Suomessa) | 76, 77 |
| B4 | Vientiä koskeva ilmoitus erityisten veroalueiden kanssa käytävässä kaupassa | 10 |
| C1 | Yksinkertaistettu vienti-ilmoitus | 10, 11, 21, 22, 23, 31 |
| C2 | Tavaroiden esittäminen tullille ilmoittajan kirjanpitoon tehtävän merkinnän tapauksessa tai kun tulli-ilmoitus annetaan ennen tavaroiden esittämistä viennissä | |
| D1 | Erityismenettely – passitusilmoitus | |
| D2 | Erityismenettely – passitusilmoitus, jossa toimitettavia tietoja vaaditaan vähemmän – rautatie-, ilma- ja merikuljetus | |
| D3 | Erityismenettely – passitus – sähköisen kuljetusasiakirjan käyttö tulli-ilmoituksena – ilma- ja merikuljetus | |
| E1 | Unionitavaroiden tullioikeudellista asemaa koskeva todiste eli T2L/T2LF | |
| E2 | Tavaraluettelo tullikäyttöön | |
| G3 | Tavaroiden esittäminen tullille | |
| G4 | Väliaikaisen varastoinnin ilmoitus | |
| G5 | Saapumistiedonanto, kun tavaroita siirretään väliaikaisessa varastoinnissa | |
| H1 | Vapaaseen liikkeeseen luovutusta koskeva ilmoitus ja erityismenettely – erityiskäyttö – tiettyä käyttötarkoitusta koskeva ilmoitus | 01, 07, 40, 42, 43, 44, 45, 46, 48, 61, 63, 68 |
| H2 | Erityismenettely – varastointi – tullivarastointia koskeva ilmoitus | 71 |
| H3 | Erityismenettely – erityiskäyttö – väliaikaista maahantuontia koskeva ilmoitus | 53 |
| H4 | Erityismenettely – jalostus – sisäistä jalostusta koskeva ilmoitus | 51 |
| H5* | Tuontia koskeva ilmoitus erityisten veroalueiden kanssa käytävässä kaupassa | 40, 61 |
| H6 | Tulli-ilmoitus postiliikenteessä vapaaseen liikkeeseen luovutusta varten (ei käytössä Suomessa) | |
| H7 | Vähäarvoisten tavaroiden tuonti-ilmoitus | 4000 |
| I1 | Yksinkertaistettu tuonti-ilmoitus | 01, 07, 40, 42, 43, 44, 45, 46, 48, 51, 53, 61, 63, 68, 71 |
| I2 | Tavaroiden esittäminen tullille ilmoittajan kirjanpitoon tehtävän merkinnän (EIDR) tapauksessa | 01, 07, 40, 42, 43, 44, 45, 46, 48, 51, 53, 61, 63, 68, 71 |
*Suomessa sanomakuvauksissa on käytössä kansallisesti tarkennetut tyyppikoodit H5-verorajailmoituksesta:
- H5E – Tuontia koskeva verorajailmoitus erityisten veroalueiden kanssa käytävässä kaupassa (esim. tuonti toisesta EU-maasta verorajan yli Ahvenanmaalle)
- Tähän ilmoitukseen on voitu viitata myös H5EU-koodilla.
- H5N – Kansallinen yksinkertaistettu verorajailmoitus, alv-rekisteröimätön tai alv-rekisteröity
- H5P – Kansallinen yksinkertaistettu verorajailmoitus, veroraja-asiakkaan yhteenvetoilmoitus.
Tullin tarjoama Fintaric-jakelupalvelu sisältää EU:n Taric-tiedot sekä kansalliset lisäykset koneluettavassa muodossa. Jakelupalvelu on kaikille avoin, ja ohjelmistokehittäjät voivat hyödyntää sitä tarjotessaan asiakkailleen tullinimikkeistöön ja tulli-ilmoittamiseen liittyviä palveluita.
Fintaric-jakelupalvelua voi käyttää Suomi.fi-palveluväylän tai Tullin tarjoaman rajapinnan kautta.
Vaihtoehto 1: Käyttö Suomi.fi-palveluväylän kautta
Pääset käyttämään Fintaric-jakelupalvelua Suomi.fi-palveluväylän kautta. Aloita käyttöönotto tekemällä käyttölupahakemus Digi- ja väestötietovirastolle. Katso tarkempi ohjeistus Digi- ja väestötietoviraston sivulta Palveluväylä. Kuvaus Fintaric-jakelupalvelusta on palveluväylän liityntäkatalogissa: Tulli-Fintaric-Service.
Vaihtoehto 2: Jakelupalvelun käyttö Tullin rajapinnan kautta
Fintaric-jakelupalvelua voi käyttää myös liittymättä Suomi.fi-palveluväylään. Rajapinnan käyttö vaatii, että yrityksellä on käytössä Digi- ja väestötietoviraston myöntämä palvelinvarmenne. Erillistä rekisteröintiä ei tarvita.
WSDL-kuvausten nouto:
Testiympäristö: https://api-test.tulli.fi:4443/fintaric/TradersExport?WSDL
Tuotantoympäristö: https://api.tulli.fi:4443/fintaric/TradersExport?WSDL
Jakelupalvelun osoitteet:
Testiympäristö: https://api-test.tulli.fi:4443/fintaric/TradersExport
Tuotantoympäristö: https://api.tulli.fi:4443/fintaric/TradersExport
Lisätietoja Tullin yritysneuvonnasta
Saapumistunnuskyselyn rajapintapalvelulla esitäytetty ilmoitus
Kuljetusliike voi helpottaa asiakkaansa tuonti-ilmoittamista saapumistunnuskyselyn (GoodsShipmentInfo, GSI) rajapintapalvelulla. Sen avulla asiakas saa täytettäväksi esitäytetyn ilmoituksen Tullin asiointipalvelussa. Esitäytetty tieto on esimerkiksi varaston tunnistenumero.
Asiakas saa tiedot ilmoitukseen saapumistunnuskyselyllä eli syöttämällä asiointipalvelussa lähetyksen saapumistunnuksen tai rahtikirjan numeron. Näiden avulla rajapintapalvelu hakee lähetyksen tietoja ilmoitukseen kuljetusliikkeen tietojärjestelmästä.
Rajapintapalvelun käyttöönoton ohjeet
Kuljetusliike toteuttaa palvelun omaan järjestelmäänsä Tullin määrittelyn mukaan ja hakee Tullilta luvan rajapintapalvelun kytkemiseksi Tullin järjestelmään. Rajapinnan toimivuus on testattava Tullin kanssa.
Lupa haetaan Luvat ja päätökset -palvelussa, jossa kohdassa ”Ilmoitukset, joihin lupaa haetaan” valitaan ”Yritykseni haluaa toimittaa Tullille ennakkotietoja tuonti-ilmoitusta varten (GoodsShipmentInfo)”.
Lisätietoja Tullin yritysneuvonnasta