Suora sanoma-asiointi (web-service) Sanoma-asioinnin tuki

Samankaltaiset tiedostot
Julkinen sanomarajapinta ja

Ajankohtaista Tullista Päivi Maunuksela-Malinen, Tulli Sanoma-asioinnin tuki/eteläinen tullipiiri

INTRASTATIN SANOMA-ASIAKKAIDEN TESTAUSOHJE

INTRASTATIN SANOMA-ASIAKKAIDEN TESTAUSOHJE

INTRASTATIN SANOMA-ASIAKKAIDEN TESTAUSOHJE

Sähköinen asiointi Tullissa. Sanoma-asioinnin tuki

Jos yritys haluaa lupaa yhteen tai osaan järjestelmistä, hakemukseen täytetään vain niitä koskevat kohdat.

Sanomapohjainen asiointi Tullissa

Sanomapohjainen asiointi Tullissa

Sanomapohjainen asiointi Tullissa

Sanomapohjainen asiointi Tullissa


Suora sanoma-asiointi Tullissa. Tekninen opas. Suomen Tulli Päivitys Sähköisen asioinnin tuki

Sanomapohjainen asiointi Tullissa

1(19) ASIAKASOHJE TUONNIN SANOMA-ASIAKKUUS

Suora sanoma-asiointi Tullissa. Tekninen opas. Suomen Tulli Päivitys Sähköisen asioinnin tuki

1(18) ASIAKASOHJE TUONNIN SANOMA ASIAKKUUS

Muutokset suoran sanoma-asioinnin webservicepalvelun

Omakannan Omatietovaranto palvelun asiakastestaus

Suora sanoma-asiointi Tullissa. Tekninen opas. Suomen Tulli Päivitys Sanoma-asioinnin tuki

Suora sanoma-asiointi Tullissa. Tekninen opas. Suomen Tulli Päivitys Sanoma-asioinnin tuki

AREX SANOMA-ASIAKKUUS

HAKEMUS 1 (6) sanoma-asiointiin Tullissa SALASSA PIDETTÄVÄ Suojaustaso IV JulkL (621/1999) 24.1 :n 20 k

PALVELUKUVAUS OHJELMISTOTALOILLE SAMLINK VARMENNEPALVELU

Muutokset suoran sanoma-asioinnin web servicepalvelun

Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke

Tulorekisteri: Varmenne Visma Fivaldi

Suoran sanoma-asioinnin yleisimmät ongelmatilanteet

Muutokset suoran sanoma-asioinnin webservicepalvelun

sertifikaattiratkaisu Apitamopki

SAMLINK VARMENNEPALVELU PALVELUKUVAUS OHJELMISTOTALOILLE

VTJkysely-palvelu. Sovelluskyselyiden rajapintakuvaus

ASIAKASOHJE Tullivarastoinnin sanoma-asiakkuus, versio

AREX EDI-ASIAKASTESTAUS

Poistuvan tavaran netti-ilmoittaminen

Vientitavaran poistumisvaiheen ilmoitukset: varamenettelyohje

VIENNIN SANOMA-ASIAKKUUS

Tulli Suomen sisäkaupan ascii-muotoinen tilastoilmoitus Sivu 1(6) Tilastointi

KanTa-palvelut. Sähköisen lääkemääräyksen testauspalvelun suunnitelma. versio 1.0

Suomi.fi Viestit -palvelun käyttöönotto. Viranomaisen ohje palveluun liittymiseksi

Yleistä tietoa Tulorekisterin varmenteesta

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke

OP Tunnistuksen välityspalvelu

Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke

Koulutus ensisaapumistoimijoille Kuukausi-ilmoitukset Kirsi Sarkkinen

Suomi.fi Viestit -palvelun käyttöönotto. Viranomaisen ohje palveluun liittymiseksi

EU:hun saapuvan tavaran AREX-ilmoitusten varamenettelyohje

Vanhojen potilastietojen arkistointi

TUONNIN EDI-ASIAKKUUS

Tätä ohjekirjaa sovelletaan alkaen.

OnniSMS Rajapintakuvaus v1.1

Attribuutti-kyselypalvelu

tulli.fi versio 0.3, Sanoma-asioinnin testauspalvelun käyttöohje

WebService rajapinnan vaatimukset huomioitu, tarkennettu lennon tietojen ilmoittamista 1.4 muutos 3 Tarkennus lisäkoodien ilmoittamiseen

EMCS-järjestelmän sanomarajapinnan toiminnallinen kuvaus asiakkaille Meeri Nieminen

Saapumisen esittämisilmoitus nettipalvelussa

Tullivarastoinnin ilmoittaminen sähköistyy

VTJ:n pysyvän rakennustunnuksen käyttöönotto

Kuluttajaverkkolaskutus ja esilläpitopalvelu Suomessa

Katso-tunnistautumisen muutos. Visma Fivaldi

Viennin tulli-ilmoitus Internetissä Esittely

Ajankohtaista Ilmoitin.fi:stä

VETUMA rekisteröityminen

TOIMITUSSELOSTE PL 5 Tulorekisteri TULOREKISTERI

Asiakasnumeron haltija on vastuussa tilauksesta ja vastaa laskun maksamisesta toimitusehtojen mukaisesti Oriolalle.

Tullivarastoinnin ilmoitukset annetaan sähköisesti. Verkkoseminaari UTK UTU asiakasprojekti

Visma Software Oy

T2V2 Vaaratilanneilmoitussanomakuvaus

Liittyminen eresepti-palveluun. Yksityisten terveydenhuollon toimijoiden ereseptin käyttöönottoon valmistautuminen

Milloin kannattaa käyttää XML:ää CASE: VR - e-cargo

1 YLEISTÄ 2 2 ASIAKASYRITYKSEN EMCE 365 -AKTIVOINTI 2 3 EMCE VERKKOLASKUJEN KÄYTTÖÖNOTTO ASIAKASYRITYKSELLE 3

Liite 7: Asiakastietoa käsittelevä järjestelmä Sosiaalihuollon asiakastiedon arkisto. Rajapintakäyttötapaukset

Asiakastietoa käsittelevä järjestelmä. Rajapintakäyttötapaukset

Tullivarastoinnin ilmoittaminen sähköistyy. Tullivarastoinnin verkkoseminaari Toukokuu 2018

Sähköinen asiointi vuokrauksessa

Visma Nova Webservice Versio 1.1 /

Vanhojen potilastietojen arkistointi Ohje palvelun käyttöönottajalle

NORDEAN WEB SERVICES YHTEYDEN KÄYTTÖÖNOTTO

Varmennepalvelu - testipenkki. Kansallisen tulorekisterin perustamishanke

Muutokset suoran sanoma-asioinnin webservicepalvelun

Tekninen rajapinta - Soveltamisohje Kansallisen tulorekisterin perustamishanke

Näin teet liittymishakemuksen ja päivität asiakastietojasi

Kanta-liittymisen tietoliikennearkkitehtuuri: Case Eksote. SosKanta-hanke/Kaisa Pesonen

KILPAILUTTAMO PALVELU

WEB SERVICES RAJAPINTA SAMLINKIN TEKNINEN RAJAPINTAKUVAUS OHJELMISTOTALOILLE

CRS ja DAC2 Tekniset asiat. Verohallinto

Asiakastietoa käsittelevä järjestelmä. Rajapintakäyttötapaukset

WS-AINEISTOPALVELUT-VARMENTEET Varmenteen hankinta- ja uusintaohjeet Sähköposti-kanava

Kela Kanta-palvelut Terveydenhuollon todistusten välitys Toiminnalliset prosessit

Sähköisen luvan hakeminen Lahden asiointipalvelusta

OHJE SOSIAALI- JA TERVEYSLAUTAKUNNAN VUODEN 2019 YLEISAVUSTUKSEN SÄHKÖISEN HAKEMUKSEN TÄYTTÄMISEEN

tannuksissa. Sähköisen

Postin tunnistuspalvelu. Palvelun toimintamallin kuvaus. Tunnistuspalvelu 1 (8) Työohjeistus Myyntipisteet

Potilastiedon arkisto Hakemus ja sitoumus. Kela, Kanta-palvelut, Viimeisin versio: kanta.fi > Potilastiedon arkiston käyttöönoton käsikirja

Varmennekuvaus. Väestörekisterikeskuksen varmentajan varmenteita varten. v1.2

Valitse Siirry palveluun

Hyrrä. Hanketukien rahoitusmahdollisuudet Etelä- Pohjanmaalla -koulutuspäivä, Frami Esa Isosaari

Transkriptio:

Suora sanoma-asiointi (web-service) Sanoma-asioinnin tuki

Tiedonsiirto Sanomaliikenne asiakkaiden ja Tullin välillä on yhä etenevässä määrin XML-pohjaista. EDIoperaattorien kautta tapahtuvan tiedonsiirron lisäksi XML-sanomien välittäminen on mahdollista myös HTTPS / SOAP protokollan yli. Yrityksen tietojärjestelmät Dataformaatti: EDIFACT tai XML Tiedonsiirto: ( FTP) Tulli: Integraatiot Tulli: Palvelut Ohjelmisto X Integraatiokerros Sovelluskerros EDI-operaattorit( yksityinen verkko) TradeXpress Järjestelmä A Ohjelmisto Y Internet (julkinen verkko) Suora sanoma-asiointi Järjestelmä B Dataformaatti: XML Tiedonsiirto: SOAP (HTTPS) Yhteys yrityksen järjestelmistä muodostetaan julkisen verkon (internet) kautta. Yhteys on salattu. Suora sanomaasiointi tarjoaa Web Service (WS) teknologioihin perustuvan rajapinnan Tullin sanomapohjaisiin palveluihin. 2

Mitä suora sanoma-asiointi (web service) on? Tullin suora sanoma-asiointi perustuu joukkoon yleisiä kansainvälisiä standardeja, jotka tarjoavat mahdollisuuden toteuttaa tietojärjestelmien välistä integraatiota tietoturvallisella tavalla Suorassa sanoma-asioinnissa yrityksen tietojärjestelmä voi lähettää sanomia Tullin tietojärjestelmiin internetin yli, sekä noutaa Tullin järjestelmistä tuotettuja vastaussanomia ns. viestivarastosta Suoraa sanoma-asiointia käytetään kuljetuskerroksena erilaisille XML-pohjaisille tietosisällöille. Tietosisältö (esimerkiksi viennin ELEX-järjestelmälle osoitettu vienti-ilmoitus) istutetaan yleiskäyttöiseen kehyssanomaan, joka välitetään suoran sanoma-asioinnin web service (WS) -palveluun. Tulliin suoran sanoma-asioinnin kautta kuljetettu sovellussanoma (esim. ELEX - järjestelmän vienti-ilmoitus) on rakenteeltaan täysin samanlainen kuin operaattorivälitteisessä sanoma-asioinnissa. 3

Sanomanvälitys WS-pohjaisen sanomarajapinnan kautta Tullin asiakas kytkeytyy Tullin yritysasiakkaille toteutettuun, Web Services (WS) -pohjaiseen rajapintaan. Yrityksen tietojärjestelmä Sanoman kehystiedot Sanoman kehystiedot kuvataan WSDL- ja skeemakuvauksella Sanoman kehystiedot ovat vakiomalliset ja järjestelmästä riippumattomat XML-sovellussanoma on skeemakuvattu ja järjestelmäkohtainen XML-pohjainen sovellussanoma, esim. IE547 Suoran sanomaasioinnin WS-rajapinta Tullin integraatiokerros Tulkitsee kehystietoja ja toimii niiden mukaisesti Tullin järjestelmä, esim. AREX Tulkitsee XMLsovellussanomaa ja toimii sen mukaisesti 4

Sanoma-asiointi Tullin ja asiakkaiden välillä Asiakkaat Sovelluskerros Suora sanomaasiointi Integraatiokerros WS-rajapinta Tulli Sovelluskerros ALA Operatiivista toimintaa/ aikakriittistä Palveluntarjoajat Viestinvälitys VPN-tunnelit EMCS AREX ELEX Passitus ITU Viestinvälitys Valtuutetut sanoma operaattorit Operaattori välitteinen sanoma-asiointi Intrastat MOVE Sanoma-asioinnin tuki 6.3.2017 5

Suoran sanoma-asioinnin mahdollistamat toiminnot Yrityksen yhden tietokokonaisuuden esimerkiksi tulli-ilmoituksen toimittaminen Tullin tietojärjestelmiin Yrityksen yhden tietokokonaisuuden noutaminen Tullin tietojärjestelmistä esimerkiksi vastaus aikaisemmin lähetettyyn tulliilmoitukseen. Sanomien noutaminen voidaan automatisoida yrityksen järjestelmään. Listan tuottamisen yrityksen noutamista odottavien sanomien perustiedoista Tiedote saapuneista vastaussanomista yritykselle, kun yritys on ottanut käyttöönsä sanomatiedotepalvelun 6

Sanoman muodostaminen ja välitys Varsinaisen sovellussanoman ympärille muodostetaan Application Request lohko. Muodostajan allekirjoitus kattaa sen kokonaan Välittäjä upottaa tämän valmiin, allekirjoitetun sanomarakenteen SOAPkirjekuoreen joka on SOAP -sanoman uloin elementti Kirjekuori koostuu otsikko-osasta ja runkoosasta, jotka molemmat puolestaan koostuvat erilaisista elementeistä. Runko-osa on pakollinen. Sovellussanoma (xml-dokumentti) Content (base64-enkoodattu xml-elementti) Application Request (xml-dokumentti) Content (base64-enkoodattu xml-alielementti) Application Request (xml-dokumentti) Content (base64-enkoodattu xml-alielementti) XML Digital Signature ApplicationRequestMessage (base64-enkoodattu xml-elementti) Content (base64-enkoodattu xml-alielementti) XML Digital Signature 1. Luodaan sovelluskohtainen xml-dokumentti, ns. sovellussanoma Esimerkkinä skeema FISummaryDeclaration.xsd 2. Base64-enkoodataan sovellussanoma xmlelementiksi nimeltä Content 3. Luodaan xml-dokumentti ApplicationRequest, joka sisältää Base64- enkoodatun alielementin Content. XML-skeemana on ApplicationRequest.xsd 4. Allekirjoitetaan koko xml-dokumentti ApplicationRequest 5. Base64-enkoodataan xml-dokumentti ApplicationRequest elementiksi nimeltä ApplicationRequestMessage SOAP Message SOAP Envelope SOAP Body RequestHeader (xml-alielementti) ApplicationRequestMessage (base64-enkoodattu xml-alielementti) Content (base64-enkoodattu xml-alielementti) XML Digital Signature 6. Luodaan SOAP-sanoma, johon asetetaan base64- enkoodattu xml-alielementti ApplicationRequestMessage 7. Lähetetään SOAP-sanoma HTTPS-protokollalla ja odotetaan SOAP-vastausta. 7

Sanomien kulku (1) Sanoman lähettäminen asiakkaalta Tulliin, kun yritys käyttää sanomalistausta 1. Asiakas muodostaa sanoman ja välittää sen suoran sanoma-asioinnin web serviceen Asiakkaan järjestelmä 1. Sanoma 2. Tekninen kuittaus Internet 7. Sanomalistan kysely 8. Sanomalista 9. Sanoman nouto 10. Sanoma Suora sanoma-asiointi TESB 6. Viestivarasto 3. Sanoma 5. Sanoma 4. Käsittely Tullin järjestelmä Asiakkaan sanoman käsittely Tullissa: 2. Tullin web service kuittaa asiakkaan sanoman vastaanotetuksi. 3. Integraatiokerros tarkistaa sanoman, ja reitittää sen oikealle järjestelmälle. 4. Tullin järjestemä, esim. ELEX, käsittelee sanoman. 5. Tullin järjestelmä, esim. ELEX, muodostaa asiakkaalle osoitetun sanoman ja lähettää sen TESB:in kautta. 6. TESB tallentaa sanoman viestivarastoon. Sanoma jää viestivarastoon odottamaan noutamista. Asiakkaalle osoitettujen sanomien nouto Tullista: 7. Asiakas pyytää listaa noutamattomista sanomista. 8. Asiakas saa vastauksena listan noutamattomien sanomien id:eistä. 9. Asiakas pyytää yksittäisen sanoman, sanoman id:tä käyttäen. 10. Asiakas saa vastauksena sanoman (10). 9-10. Jokainen uusi sanoma noudetaan yksitellen (kohta 9-10 toistetaan). Asiakas ei saa pyytää sanomalistausta liian usein, koska se kuormittaisi Tullin järjestelmiä liikaa. Raja on yksi sanomalistauspyyntö viidessä minuutissa per sanomaliikenneasiakas. 8

Sanomien kulku (2) Sanoman lähettäminen asiakkaalta Tulliin, kun yritys käyttää sanomatiedotepalvelua Asiakkaan sanoman käsittely Tullissa: Ei muutoksia 1-6 Asiakkaan järjestelmä 1. Sanoma 2. Tekninen kuittaus Internet 7. Sanomatiedote 8. Sanoman nouto 9. Sanoma Suora sanoma-asiointi TESB 6. Viestivarasto 3. Sanoma 5. Sanoma 4. Käsittely Tullin järjestelmä 6. TESB tallentaa sanoman viestivarastoon. 7. TESB lähettää asiakkaalle sanomatiedotteen uudesta noutamista odottavasta sanomasta. Asiakkaan sanomien nouto Tullista: 8. Asiakas noutaa yksittäisen sanoman, sanoman id:tä käyttäen. 9. Asiakas saa vastauksena sanoman. Asiakas saa tiedon uudesta noutamista odottavasta sanomasta heti kun sanoma on tallentunut. Edellytyksenä on että asiakas toteuttaa palvelun sanomatiedotteen vastaanottamista varten. Häiriötilanteissa, esim. mikäli sanomatiedotteen vastaanottaminen ei onnistu, asiakas voi lähettää sanomalistauspyynnön (DownloadList) kuten ennenkin 9

Toimijat suorassa sanoma- asioinnissa Sanomailmoittaja Osapuoli, jolla on velvollisuus antaa Tullille ilmoitus- tai vastaavia tietoja ja joka käyttää tähän sanomapohjaista asiointia. Menettelystä riippuen sanomailmoittaja voi olla päämies, edustaja (esimerkiksi huolintaliike) tai muu Jos kyse on esimerkiksi tulli-ilmoittamisesta, Tullin päätökset kohdistuvat sanoma-ilmoittajaan. Jos sanomailmoittaja on edustaja, päätökset kohdistuvat myös sanomailmoittajan päämieheen Sanomailmoittaja voi toimia yksin, ilman erityisiä palveluntarjoajia, tai sanomailmoittajan on mahdollista käyttää palveluntarjoajaa sanomien muodostamiseen ja välittämiseen Palveluntarjoaja Osapuoli, joka voi ottaa hoitaakseen tiettyjä suoraan sanoma-asiointiin liittyviä teknisiä rooleja. Tekniset roolit liittyvät sanomien muodostamiseen ja välittämiseen. 10

Roolit suorassa sanoma-asioinnissa Tekniset roolit liittyvät sanomien muodostamiseen ja välittämiseen. Roolit viittaavat toimijoihin puhtaasti teknisessä merkityksessä. Termeillä ei viitata esimerkiksi sanomien tietosisältöjen tarkoittamiin toimijoihin (esim. kuljetusliike, huolintaliike). Suorassa sanoma-asioinnissa tekninen roolijako on oltava sama käytetystä järjestelmästä riippumatta. Ei ole mahdollista, että yritys käyttäisi esimerkiksi ELEX-järjestelmässä palveluntarjoajaa sanomien välittämiseen, mutta välittäisi AREX-järjestelmässä sanomansa itse. Muodostaja Yritys, jonka tietojärjestelmä rakentaa sanomat Tullin edellyttämässä määrämuodossa ja allekirjoittaa sanomat sähköisellä XML-allekirjoituksella Asiakkaan palvelupyynnöt välitetään Tulliin HTTPS-yhteyttä käyttäen, ja suoran sanoma-asioinnin web service -palvelun vaatimilla kuljetuskehyksillä varustettuna. Välittäjä Yritys, jonka tietojärjestelmä on internetin yli tietoliikenneyhteydessä Tullin suoran sanoma-asioinnin web service -palveluun Välittäjällä ei tarkoiteta vaikkapa tavaran tai kuljetuksen välittäjää. 11

Suoran sanoma-asioinnin toimijat ja roolit Sanomailmoittaja Sanomailmoittaja (muodostaa Ja välittää) Varmenne XML-allekirjoitusta ja HTTPS-yhteyttä varten Sanoman tiedot muodossa XXX SOAP sanoma / sovellussanoma Palveluntarjoaja (muodostaa ja välittää) Varmenne XML-allekirjoitusta ja HHTPS-yhteyttä varten SOAP sanoma / sovellussanoma ASIAKAS PALVELU HTTPS Suoran sanoma-asioinnin web service -rajapinta HTTPS 12 12

Suoran sanoma-asioinnin toimijat ja roolit 1. Sanomailmoittaja voi toimia yksin, ilman erityisiä palveluntarjoajia, jolloin sanomailmoittajan ohjelmisto tekee kaikki työvaiheet: Muodostaa liiketoiminnallisen eli Tullin määrittelyjen mukaisen sovelluskohtaisen sanoman, allekirjoittaa sen ja sijoittaa allekirjoitetun sanoman ohjeiden mukaiseen tietoelementtiin. Luo SOAP-sanoman, johon edellisessä vaiheessa luotu tietoelementti on laitettu. Välittää SOAP-sanoman Tullin suoran sanoma-asioinnin web service -palveluun, käyttäen HTTPS -tiedonsiirtoa. Sanomailmoittaja noutaa sille osoitetut sanomat Tullin suoran sanoma-asioinnin web service -palvelusta. 13

Suoran sanoma-asioinnin toimijat ja roolit 2. Vaihtoehtoisesti sanomailmoittaja voi antaa sanomien välittämisen ja toisen yrityksen niin sanotun palveluntarjoajan tehtäväksi Tässä tapauksessa sanomailmoittaja ei tuota Tullin määritysten mukaista sovelluskohtaista sanomaa, vaan toimittaa sanomien muodostamiseen tarvittavan tietoaineiston eteenpäin palveluntarjoajalle omassa sisäisessä muodossaan. Tällöin sanomailmoittajan ohjelmisto ei myöskään voi XML -allekirjoittaa sanomaa sähköisesti. Palveluntarjoaja muuntaa sanomat oikeaan sähköiseen tietomuotoon, muodostaa (ja XML-allekirjoittaa) sanomailmoittajan liiketoiminnalliset sanomat sekä välittää ne Tullin suoran sanoma-asioinnin web service -palveluun. Lähettämisen lisäksi sanomanvälitykseen kuuluu, että palveluntarjoaja noutaa sanomailmoittajalle osoitetut sanomat Tullin suoran sanoma-asioinnin web service - palvelusta. 14

Suoran sanoma-asiakkuuden edellytykset Suora sanoma-asiointi edellyttää yritykseltä: Lupaa suoraan sanoma-asiointiin Tietoliikenneyhteyksiä (internet-yhteys) sanomien välittämiseen Väestörekisterikeskuksen (VRK) palvelinvarmenteen hankkimista sanoman muodostamiseen ja välittämiseen (varmennemyynti@vrk.fi) Tietoliikenneohjelmiston, jolla yritys muodostaa oikeanlaisen sovellus- ja kehyssanoman ja on tietoliikenneyhteydessä Tullin suoran sanoma-asioinnin web service-palveluun Tullilta on saatavissa maksuton suoran sanoma-asioinnin esimerkkitoteutus malliksi yrityksen ohjelmiston toteuttajalle Suoran sanomayhteyden toimivuuden testausta Tullin kanssa. 15

Hakeutuminen (1) Hakemus sanoma-asiointiin Tullissa (tullilomake 934s, kohta E) Hakemus löytyy osoitteesta www.tulli.fi Hakemuksessa ilmoitetaan onko kyseessä uusi hakemus vai muutos aikaisempaan suoran sanoma-asioinnin lupaan Jos yritys toimii sekä suorana sanomailmoittajana että palveluntarjoajana valitaan hakemuksesta useampi vaihtoehto, muuten ainoastaan yksi vaihtoehto Yrityksen, joka haluaa toimia joko suorana sanomailmoittajana tai palveluntarjoajana on haettava lupaa asioinnin käyttämiseen. Lupahakemuksen käsittelyssä sanomailmoittajan ja mahdollisen palveluntarjoajan hakemukset kytketään yhteen siten, että palveluntarjoajan on teknisesti mahdollista välittää sanomia sanomailmoittajan puolesta Jos yritys ottaa käyttöön sanomatiedotepalvelun, täytetään kohta E.4 ja ilmoitetaan osoite mihin sanomatiedotteet toimitetaan Sekä sanomailmoittaja että palveluntarjoaja sitoutuvat noudattamaan lupahakemuslomakkeessa mainittuja käyttöehtoja. Tulli ei vastaa sanomailmoittajan valitseman palveluntarjoajan toiminnasta. Palveluntarjoajan käyttäminen ei myöskään vaikuta sanomailmoittajan vastuisiin suhteessa Tulliin. 16

Hakeutuminen (2) Suoran sanoma-asioinnin asiakkaaksi hakeutuva yritys toimittaa sanoma-asioinnin hakemuksen (tullilomake 943s) Tullin Lupakeskukseen kirjeitse, tai sähköpostilla Hakemus täyttöohjeineen on käännetty myös ruotsin- ja englannin kielelle Asiakkaan on ensin lähetettävä sanoma-asioinnin hakemus Tulliin ja vasta sen jälkeen haettava VRK:lta palvelinvarmennetta. 17

Toimijoiden tunnistus suorassa sanoma-asioinnissa Internet HTTPS SOAP-sanoma Sovellussanoma XML-allekirjoitus (sisältää varmenteen) 1. HTTPSasiakasvarmenne 2. Tulli 18

Palvelinvarmenne (1) Käyttötarkoitus: Tullin integraatiokerros tunnistaa suoran sanoma-asioinnin toimijat palvelinvarmenteiden avulla. Muodostaessaan HTTPS -tietoliikenneyhteyden suoran sanoma-asioinnin web service - palveluun asiakas (välittäjä) tunnistautuu palvelinvarmenteella. Sanomaa muodostettaessa sanoma allekirjoitetaan palvelinvarmenteella, joka tallentuu sovellussanomaa ympäröivään kehyssanomaan. Tieto asiakkaasta (muodostaja) välittyy Tulliin. Asiakas voi käyttää samaa varmennetta testi- ja tuotantoympäristöissä. Tullin hyväksymät palvelinvarmenteet: Tulli hyväksyy ainoastaan Väestörekisterikeskuksen (VRK) myöntämät palvelinvarmenteet Varmenne sisältää haltijan EU VAT -numeron (Suomessa maakoodi ja Y-tunnus ilman väliviivaa) Varmenteen saaminen kestää noin viisi arkipäivää. 19

Palvelinvarmenne (2) Palvelinvarmenteen uusiminen: Palvelinvarmenne on kerrallaan voimassa 2 vuotta. Sanomia ei voi lähettää Tullille vanhentuneella varmenteella VRK muistuttaa Tullin asiakkaita vanhenevista varmenteista, mutta asiakas on itse vastuussa varmenteen uusimisesta. Yrityksen ei tarvitse ilmoittaa Tullille varmenteen uusimisesta. Palvelinvarmenteen tarvitsevat: Sanomailmoittaja silloin kun sen tietojärjestelmä muodostaa sekä välittää sanoman. Tällöin käytössä on vain yksi asiakkaan palvelinvarmenne Vain sanomailmoittaja tarvitsee palvelinvarmenteen. Palveluntarjoaja silloin kun sanomailmoittaja toimittaa sanomien muodostamiseen tarvittavan tietoaineiston palveluntarjoajalle, joka muodostaa ja XML -allekirjoittaa sanomailmoittajan liiketoiminnalliset sanomat sekä välittää sanomat. Palveluntarjoaja tarvitsee yhden palvelinvarmenteen, sanomailmoittaja ei tarvitse lainkaan palvelinvarmennetta. 20

Varmenteen haku 1. Posti, sähköposti, fax 2. 4. Varmennehakemus Sähköposti 3. Sähköposti ASIAKAS VRK VARMENTEEN HAKU: 1. 2. 3. 4. Täytä ja lähetä varmennehakemus VRK:lle http://www.fineid.fi/palvelinvarmenne Tee tekninen varmennepyyntö palvelimelta ja lähetä se VRK:lle VRK toimittaa varmenteen Asenna VRK:n toimittama varmenne palvelimelle 21

Yrityskohtainen neuvonta ennen testauksia Lupakäsittelyn jälkeen asiakastestaaja lähettää yritykselle ehdotus testausajaksi kirjeen, jossa kysytään myös tarvitseeko hakija yrityskohtaista neuvontaa Neuvontatapaaminen tulisi pitää noin kahta viikkoa ennen testauksen aloittamista Jos yritys tarvitsee neuvontaa, tullin yritysneuvoja ottaa yhteyttä hakemuksessa sanoma-asiointiin Tullissa ilmoitettuun yhteyshenkilöön ja sopii tapaamisen ajankohdan Neuvontakäynnin tarkoituksena on käydä läpi testaukseen liittyviä asioita, kuten suoraan sanoma-asiointiin liittyvät toimenpiteet (esim. varmenteen hankkiminen ), testauksen kulku sekä tarvittaessa järjestelmäkohtaiset toimintaperiaatteet 22

Asiakastestaukset Suorassa sanoma-asioinnissa jokaisen sanomailmoittajan on käytävä läpi Tullin asiakastestaus. Testaus suoritetaan asiakaskohtaisesti riippumatta siitä, onko sanomailmoittajan mahdollisesti käyttämällä palveluntarjoajalla muita, jo tuotannossa olevia sanomailmoittajia Suoran sanoma-asioinnin yhteyden testaus Järjestelmäkohtaiset testaukset järjestelmästä riippuen tekninen testaus Tullin laatimilla testitapauksilla + rinnakkaistestaus yrityksen omalla ilmoitusmateriaalilla tai tekninen testaus yrityksen omalla ilmoitusmateriaalilla 23

Suoran sanoma-asioinnin yhteyden testaus Yhteyden testauksella varmistetaan, että yrityksen ohjelmisto on yhteensopiva Tullin suoran sanomaasiointi palvelun kanssa Yhteyden tekninen toimivuus varmistetaan ennen järjestelmäkohtaisilla sanomilla tehtävää testausta Suoran sanoma-asioinnin yhteydentestaus koostuu kolmesta testitapauksista (neljästä, jos asiakas ottaa käyttöönsä sanomatiedotepalvelun) Yhteys toimii, jos suoran sanoma-asioinnin web service palvelu kuittaa asiakkaan sanoman vastaanotetuksi. Lisäksi asiakkaan on pystyttävä noutamaan vastaussanoma Tullin viestivarastosta. Vastaussanoman asiasisällöllä (hyväksyntä, hylkäys, jne.) ei ole merkitystä tietoliikenneyhteyden testauksen kannalta. Yhteyden testaus on pakollista paitsi, jos yritys jo käyttää suoraa sanoma-asiointia johonkin Tullin järjestelmään tai käyttää sellaista välittäjää, joka on jo aiemmin tehnyt teknisen yhteyden testauksen. 24

Lupa suoraan sanoma-asiointiin ja tuotantoon siirto Hyväksytysti suoritettujen testausten jälkeen yritykselle lähetetään sanoma-asioinnin lupapäätös, jossa ilmoitetaan suorien yhteyksien käyttöönottopäivä järjestelmäkohtaisesti (esim. AREX-järjestelmä), paitsi jos palveluntarjoaja toimii vain välittäjänä Yrityksen tulee ilmoittaa asiakastestaajalle (tai Tullin sähköisen palvelukeskuksen EDI-tukeen) ensimmäisestä lähettämästään tuotannon sanomasta Asiakastestaaja (tai Tullin sähköisen tullauskeskuksen EDI-tuki) valvoo tuotannon aloitusta ensimmäisten sanomien osalta 25

Yrityksessä tapahtuvien muutosten ilmoittaminen (1) Muutosten ilmoittaminen koskee sekä suoraa sanomailmoittajaa, että yrityksen käyttämää palveluntarjoajaa Yrityksessä tapahtuvia muutoksia voivat olla esimerkiksi: Y-tunnuksen muutos (yrityksen lähetettävä uusi lupahakemus) Ohjelman muutos (uusintatestauksen tarpeen selvitys) Yritys laajentaa suoran sanoma-asioinnin käyttöä Tullin toiseen tietojärjestelmään Yritys lähettää muutoshakemuksen lomakkeesta 934s_14, jossa kertoo laajentavansa suoran sanoma-asioinnin käyttöä toiseen Tullin tietojärjestelmään ja täyttää kohdan B ja E 26

Yrityksessä tapahtuvien muutosten ilmoittaminen (2) Palveluvarmenteen muutokset Palveluvarmenteen muutoksista on lisätietoja osoitteessa varmennemyynti@vrk.fi Palveluntarjoajan vaihtuminen Suoran sanomailmoittajan on lähetettävä uusi hakemuslomake. Vastuusyistä on tärkeätä, että Tulli saa sanomailmoittajalta kirjallisesti uuden palveluntarjoajan tiedot, jolloin voidaan tarvittaessa varmistua sanomailmoittajan nimenomaisesti valtuuttaneen jonkun muun yrityksen (palveluntarjoajan) toimimaan puolestaan Sanomailmoittajan sanomia voi välittää (lähettää ja noutaa) kerrallaan vain yksi toimija, joko sanomailmoittaja itse tai yksi palveluntarjoaja. Välittäjän muutokset on aikataulutettava siten, että sanomailmoittaja + mahdolliset vanha ja uusi palveluntarjoaja tietävät milloin muutos astuu voimaan 27

Suoran sanoma-asioinnin käyttöönoton aikataulu Suora sanoma-asiointi on mahdollista tällä hetkellä Tullin seuraaviin järjestelmiin: Yleisilmoitusjärjestelmä AREX Valmisteverojärjestelmä EMCS Viennin ELEX-järjestelmä Vienti-ilmoitukset Saapuminen poistumispaikalle ilmoitukset Ahvenanmaan verorajajärjestelmä ALA Tuonnin ITU-järjestelmä Passitusjärjestelmä Sisäkaupan tilastoilmoitusjärjestelmä Intrastat 28

Lisätietoa suorasta sanoma-asioinnista löytyy Tullin internetsivuilta oppaista: Sanomapohjainen asiointi Tullissa: Johdanto sanomapohjaiseen asiointiin (myös ruotsin- ja englanninkielisenä) Sanomapohjainen asiointi Tullissa: Suoran sanoma-asioinnin tekninen opas (myös ruotsin- ja englanninkielisenä) 29