Siirry pääsisältöön
FromNine
Valikko

Ohjelmistot & pilvi

Integraatiot, jotka pitävät datan liikkeessä ja näyttävät, kun se pysähtyy.

Liitämme CRM- ja ERP-järjestelmät, asianhallinnan ja julkisen sektorin palvelut toisiinsa sopimuksilla, tapahtumilla ja kunnolla toteutetulla identiteetinhallinnalla. Data liikkuu luotettavasti, virheet näkyvät, ja uudet toiminnot, myös tekoäly, voidaan liittää turvallisesti.

Organisaatioille, jotka liittävät järjestelmiään, kumppaneitaan ja Suomi.fi-palveluja toisiinsa ja toimivat myös muissa EU-maissa.

Keskustellaan projektistasiAlustat, joita liitämme
Integraatiot & rajapinnat: osaamisen kerroksetNeljä kerrosta päällekkäin syvyyssuunnassa. Ylhäältä alas: käyttäjät, kuten portaalit, sovellukset ja agentit, rajapintayhdyskäytävä identiteetteineen, tapahtumarunko sekä pohjalla tietojärjestelmät, joissa data on alun perin.01Portaalit, sovellukset ja agentit02Rajapintayhdyskäytävä ja identiteetti03Tapahtumarunko04Lähdejärjestelmät
  1. 01Sopimus edellä suunnitellut rajapinnat OpenAPI- ja AsyncAPI-kuvauksin, versioituina ja dokumentoituina
  2. 02Tapahtumat järjestyksineen, idempotenssin, virhejonojen ja uudelleentoiston kanssa
  3. 03Tietovirrat valvottuina päästä päähän, ja virhejonoilla on nimetyt omistajatiimit

01 Ongelmat

Integraatio-ongelmat, joihin meidät kutsutaan

  1. 01

    Suorat liittymät, joihin kukaan ei uskalla koskea

    Kymmeniä suoria yhteyksiä CRM:n, ERP:n ja räätälöityjen järjestelmien välillä. Yhden kentän muutos tarkoittaa kymmenen liittymän testaamista.

  2. 02

    Kaksoiskappaleita ja hiljaisia virheitä

    Uudelleenyritys luo toisen tilauksen. Epäonnistunut viesti katoaa. Liiketoiminnan käyttäjät kuulevat asiasta asiakkailta.

  3. 03

    Jokainen uusi kanava tarkoittaa uutta integraatiotyötä

    Portaali, mobiilisovellus ja nyt tekoälyavustaja tarvitsevat saman datan, ja jokainen saa oman poimintansa.

  4. 04

    Julkisen sektorin tiedonvaihto on oma projektinsa

    Liittyminen kansalliseen tiedonvaihtopalveluun tai tunnistusratkaisuun vie joka kerta kuukausia tietoturva- ja käyttöönottotyötä.

02 Toimitukset

Mitä toimitamme

  1. 01 Rajapintastrategia ja rajapintojen hallinta

    Rajapinta edellä -suunnittelu OpenAPI- ja AsyncAPI-sopimuksin, versiointikäytäntö, sitä valvova yhdyskäytävä ja kehittäjäportaali, josta tiimit löytävät olemassa olevat rajapinnat ja käyttävät niitä uudelleen.

    Mitä teemme

    • Rajapintakartta ja omistajuudet
    • Suunnitteluohjeet ja katselmointiprosessi
    • Yhdyskäytävän säännöt tietoturvalle, kiintiöille ja versioinnille
    • Kehittäjäportaali ja rajapintaluettelo

    Mitä saat

    • Tiimiesi käyttöön ottamat rajapintaohjeet
    • Yhdyskäytävän konfiguraatio koodina
    • Luettelo dokumentoiduista rajapinnoista

  2. 02 Tapahtumapohjainen integraatio

    Viestinvälittäjät, muutostiedon kaappaus ja outbox-malli sekä yksityiskohdat, jotka ratkaisevat, toimiiko kokonaisuus: järjestys, idempotentit vastaanottajat, virhejonot ja uudelleentoisto.

    Mitä teemme

    • Tapahtumamalli ja nimeämiskäytännöt
    • Outbox ja muutostiedon kaappaus lähdejärjestelmissä
    • Vastaanottajien idempotenssi ja järjestystakuut
    • Virhejonot ja uudelleentoiston työkalut

    Mitä saat

    • Tapahtumarunko tuotannossa
    • Skeemarekisteri ja yhteensopivuussäännöt
    • Uudelleentoiston ja palautuksen toimintaohje

  3. 03 Integraatioalustat, valittuina tietovirroittain

    SAP Integration Suitella, MuleSoftilla ja pilvinatiiveilla integraatiopalveluilla on kullakin paikkansa. Kerromme, milloin iPaaS voittaa räätälöidyn koodin ja milloin ei.

    Mitä teemme

    • Nykyisen välitysohjelmiston arviointi
    • Alustan valinta kokonaiskustannusten perusteella
    • Uudelleenkäytettävät muunnokset ja liittimet
    • Siirtymä vanhasta välitysohjelmistosta

    Mitä saat

    • Integraatioalustan päätösmuistio
    • Integraatiomallien kirjasto
    • Siirtymäsuunnitelma nykyisille liittymille

  4. 04 Identiteetti ja luottamus järjestelmien välillä

    OAuth 2.0 ja OpenID Connect, molemminpuolinen TLS, palvelujen välinen identiteetti sekä integraatio asukkaiden ja yritysten sähköiseen tunnistamiseen: Suomessa Suomi.fi-tunnistus ja Suomi.fi-valtuudet, muissa maissa kunkin maan kansalliset ratkaisut.

    Mitä teemme

    • Käyttäjien ja palvelujen identiteettiarkkitehtuuri
    • Tunnisteiden suunnittelu, oikeuslaajuudet ja suostumukset
    • Tunnistusratkaisuihin liittymisen ja hyväksynnän tuki
    • Valmistautuminen eurooppalaiseen digitaalisen identiteetin lompakkoon

    Mitä saat

    • Identiteettisuunnitelma ja uhkamalli
    • Tunnistusintegraatio tuotannossa
    • Palveluidentiteetit ja salaisuuksien kierrätys käytössä

  5. 05 Julkisen sektorin yhteentoimivuus

    Liittymät kansallisiin tiedonvaihtopalveluihin, Suomessa Suomi.fi-palveluväylään ja Suomi.fi-viesteihin, muiden EU-maiden vastaaviin alustoihin sekä EU:n yhden kerran periaatteeseen perustuvaan tekniseen järjestelmään (OOTS).

    Mitä teemme

    • Liittyminen yhdessä palvelun ylläpitäjän kanssa
    • Vastaavuudet kansallisiin tietostandardeihin
    • Kunkin tiedonvaihtopalvelun tietoturva- ja lokitusvaatimukset
    • Yhden kerran periaatteen mukaisen todistusmateriaalin vaihdon suunnittelu

    Mitä saat

    • Hyväksytty liittymä tiedonvaihtopalveluun
    • Tietovastaavuuksien dokumentaatio
    • Ylläpitäjän kanssa sovitut toimintamenettelyt

  6. 06 Operatiivinen näkyvyys liiketoiminnan käyttäjille

    Tietovirtojen valvonta, jota liiketoiminnan käyttäjät osaavat lukea, täsmäytys järjestelmien välillä ja virhejonot, joilla on omistaja, joka myös käsittelee ne.

    Mitä teemme

    • Tietovirtojen valvonta liiketoiminnan tasolla
    • Täsmäytysraportit järjestelmien välillä
    • Virheiden luokittelu ja ohjaus
    • Hälytykset tietovirran omistajittain

    Mitä saat

    • Integraationäkymä liiketoimintaprosesseittain
    • Täsmäytystarkistukset tuotannossa
    • Omistajuuskartta jokaiselle virhejonolle

03 Arkkitehtuuri

Havainnollistava viitearkkitehtuuri

Lähdejärjestelmistä lähtee kaksi polkua. Synkroniset pyynnöt kulkevat järjestelmärajapintojen ja yhdyskäytävän kautta, joka tarkistaa identiteetin, oikeuslaajuudet ja kiintiöt. Muutokset julkaistaan tapahtumina outboxin tai muutostiedon kaappauksen kautta, ja vastaanottajat käsittelevät ne idempotentisti.

Epäonnistuneet viestit päätyvät virhejonoon, josta ne voi toistaa, eivät lokitiedostoon. Valvontakaista näyttää jokaisen tietovirran liiketoiminnan käsittein, jotta prosessin omistajat näkevät, kun virta pysähtyy.

Piirroksen kerrokset

Lähdejärjestelmät
ERP, CRM ja asianhallinta säilyttävät määräysvallan omaan dataansa.
Synkroniset rajapinnat
Versioidut järjestelmärajapinnat yhdyskäytävän takana OAuth 2.0:lla, mTLS:llä ja kiintiöillä.
Tapahtumat
Outbox, viestinvälittäjä, virhejono ja integraatioalustan muunnokset.
Käyttäjät
Portaalit, sovellukset, agentit, kumppanit ja julkisen sektorin tiedonvaihto, sähköinen tunnistus mukana, kun asukkaat asioivat.
Havainnollistava esimerkki

  1. Lähdejärjestelmät

    • ERP, CRM ja asianhallinta

  2. Synkroniset rajapinnat

    • Järjestelmä­rajapinnat
    • Rajapintayhdyskäytävä: OAuth 2.0, mTLS, kiintiöt

  3. Tapahtumat

    • Outbox ja muutostiedon kaappaus
    • Viestinvälittäjä
    • Virhejono ja uudelleentoisto
    • Integraatioalustan muunnokset

  4. Käyttäjät

    • Portaalit, sovellukset ja agentit
    • Kumppanien ja julkisen sektorin tiedonvaihto
    • Identiteetti: OIDC, mTLS, sähköinen tunnistus

  5. Ylläpito

    • Tietovirtojen valvonta, täsmäytys, virhejonot omistajineen
Rajapinnat ja tapahtumarunko rinnakkain

Havainnollistava arkkitehtuuri, ei asiakkaan järjestelmä.

Lue kaavio tekstinä

Pääreitti kulkee lähdejärjestelmistä versioitujen järjestelmärajapintojen ja rajapintayhdyskäytävän kautta portaaleihin, sovelluksiin ja agentteihin.

Rinnakkain lähdejärjestelmät julkaisevat muutokset outboxin ja muutostiedon kaappauksen kautta viestinvälittäjälle, joka toimittaa ne kumppanien ja julkisen sektorin tiedonvaihtoon sekä integraatioalustalle muunnoksia varten. Epäonnistuneet viestit menevät virhejonoon, josta ne voi toistaa. Identiteettipalvelut OAuthilla, mTLS:llä ja sähköisellä tunnistuksella suojaavat kumppanien tiedonvaihdon.

Alla oleva valvontakaista näyttää tietovirtojen tilan, täsmäytyksen ja virhejonot omistajineen.

04 Näkökohdat ja rajat

Tekniset näkökohdat ja rajat

  • Täsmälleen kerran on suunnittelua, ei asetus

    Miten hoidamme sen

    Oletamme, että viestit saapuvat kahdesti tai väärässä järjestyksessä, ja suunnittelemme vastaanottajat idempotenteiksi. Avaimet ja järjestyssäännöt sovitaan tapahtumatyypeittäin.

    Rajat ja riippuvuudet

    Kaikki vanhat järjestelmät eivät hyväksy idempotenssiavaimia tai kerro, mitä ne ovat käsitelleet. Niiden ympärille lisäämme täsmäytyksen sen sijaan, että teeskentelisimme.

  • iPaaS ei ole aina vastaus

    Miten hoidamme sen

    Alustat voittavat monissa vakioliittimissä ja muunnoksissa. Räätälöidyt palvelut voittavat monimutkaisessa logiikassa, suurissa volyymeissa ja tiukoissa viivevaatimuksissa. Kirjaamme valinnan integraatioittain.

    Rajat ja riippuvuudet

    Lisenssimallit muuttuvat. Tänään edullinen alusta voi muuttua integraatiobudjettisi suurimmaksi eräksi, joten mallinnamme kustannukset usean vuoden ajalle.

  • Julkisen sektorin palvelut määräävät oman tahtinsa

    Miten hoidamme sen

    Valmistelemme liittymisasiakirjat, tietoturvanäytön ja testisuunnitelmat ajoissa ja työskentelemme palvelun ylläpitäjän kanssa ensimmäisestä viikosta lähtien.

    Rajat ja riippuvuudet

    Hyväksynnän ja liittymisen aikataulut määrää palvelun ylläpitäjä, emme me. Suunnittelemme niiden mukaan ja kerromme, missä kohtaa ne ovat kriittisellä polulla.

  • Tekoäly tarvitsee kapeat rajapinnat

    Miten hoidamme sen

    Agentit ja avustajat saavat omat, rajatut rajapintansa käyttörajoineen ja auditointilokeineen, eivät samaa laajaa pääsyä kuin sisäiset palvelut.

    Rajat ja riippuvuudet

    Rajapinnan avaaminen agentille lisää riskiä. Käymme jokaisen läpi tietoturvatiimisi kanssa ennen käyttöönottoa.

05 Työtapa

Miten työskentelemme

Selvitämme sotkun ennen kuin rakennamme, ja jätämme jokaiselle tietovirralle omistajan.

  1. 01

    Kartoitetaan tietovirrat

    Jokainen liittymä, sen volyymi, sen vikahistoria ja sen liiketoimintaomistaja.

    TuotosIntegraatiokartta ja riskijärjestys

  2. 02

    Sovitaan säännöt

    Rajapintaohjeet, tapahtumakäytännöt, identiteettimalli ja alustavalinta.

    TuotosIntegraatio-ohjeet ja päätösmuistiot

  3. 03

    Siirretään tietovirta kerrallaan

    Riskialttiimmat tietovirrat ensin, ja täsmäytys toimii vanhan liittymän rinnalla, kunnes luvut täsmäävät.

    TuotosSiirretyt tietovirrat ja täsmäytysnäyttö

  4. 04

    Ylläpidetään näkyvästi

    Näkymät liiketoimintaprosesseittain ja virhejonot nimettyine omistajineen.

    TuotosTietovirtojen omistajuuskartta ja näkymät

06 Ihmisen ohjaus

Missä ihmiset pitävät ohjat

Integraatiot toimivat ilman jatkuvaa valvontaa. Vastuu siitä, mikä menee pieleen, kuuluu silti aina ihmisille.

  • Jokaisella virhejonolla on omistaja

    Epäonnistuneet viestit menevät tiimille, joka vastaa niistä, kontekstin ja uudelleentoiston kanssa, eivät yhteiseen lokiin.

  • Sopimusmuutokset katselmoidaan

    Rikkovat rajapinta- tai tapahtumamuutokset käydään läpi käyttäjien kanssa ennen julkaisua.

  • Uudelleentoistot ovat harkittuja

    Viestien toistaminen lähdejärjestelmään on valtuutettu toimi, ja siitä kirjataan, kuka sen teki ja miksi.

07 Teknologiat

Teknologiat, joita käytämme

Integraatioalustat
  • SAP Integration Suite
  • MuleSoft
  • Azure Integration Services
  • AWS:n ja Google Cloudin integraatiopalvelut
Tapahtumat ja tietovirrat
  • Apache Kafka
  • RabbitMQ
  • Pilvipalvelujen viestinvälittäjät
  • Debezium muutostiedon kaappaukseen
Rajapinnat
  • OpenAPI ja AsyncAPI
  • Rajapintayhdyskäytävät ja kehittäjäportaalit
  • GraphQL, kun se sopii
  • Sopimustestaus
Identiteetti
  • OAuth 2.0 ja OpenID Connect
  • Molemminpuolinen TLS
  • Keycloak ja pilvipalvelujen identiteetinhallinta
  • Kansalliset sähköisen tunnistamisen ratkaisut

Teknologian mainitseminen kuvaa kokemustamme. Se ei tarkoita kumppanuutta toimittajan kanssa eikä toimittajan suositusta.

08 Esimerkki

Havainnollistava esimerkki

Havainnollistava esimerkki

Verkkolaskut julkisille hankintayksiköille suoraan ERP-järjestelmästä

01Tilanne
Laboratoriotarvikkeiden tukkukauppa myy hyvinvointialueille ja kunnille. Osa laskuista lähtee PDF-tiedostoina sähköpostilla, ja hankintayksiköt palauttavat ne. Tilausviitteitä puuttuu, ja maksut viivästyvät.
02Mitä rakentaisimme
ERP-järjestelmästä muodostetaan EN 16931 -muotoiset verkkolaskut, jotka lähtevät Peppol-palveluntarjoajan kautta. Integraatio tarkistaa tilausviitteen ja pakolliset kentät ennen lähetystä, ja virheelliset laskut jäävät nimetyn tiimin jonoon.
03Missä ihmiset päättävät
Taloushallinto hyväksyy poikkeavat laskut ja hyvityslaskut ennen lähetystä. Palautuneet laskut käsittelee ihminen, ja korjattu lasku lähtee vasta hyväksynnän jälkeen.
04Mitä mittaisimme
Ensimmäisellä kerralla hyväksyttyjen laskujen osuus, palautettujen laskujen määrä ja aika laskutuksesta maksuun.

09 Toimialat

Toimialallasi

  • Julkinen sektori

    Yhden kerran periaatteen mukainen tiedonvaihto, Suomi.fi-tunnistus ja -valtuudet asukkaille ja yrityksille sekä lokitus, jota kansalliset palvelut edellyttävät. Tutustu työhömme julkisella sektorilla.

  • Valmistava teollisuus

    ERP, MES ja toimittajaportaalit liitettyinä tapahtumilla, jotta suunnittelu, tuotanto ja huolto näkevät saman kuvan.

  • Rahoitusala

    Ydinjärjestelmät, CRM ja kumppanirajapinnat liitettyinä vahvalla identiteetillä, auditointilokilla ja täsmäytyksellä, johon taloushallinto luottaa.

Suomi

Suomi.fi-palvelut ja verkkolasku osaksi järjestelmiä

Suomessa julkiset palvelut nojaavat yhteisiin kansallisiin palveluihin. Digi- ja väestötietovirasto (DVV) tuottaa Suomi.fi-palvelut: tunnistuksen, viestit, valtuudet ja palveluväylän. Suomi.fi-tunnistuksessa käyttäjä tunnistautuu esimerkiksi pankkitunnuksilla, mobiilivarmenteella tai varmennekortilla.

Laki sähköisestä laskutuksesta (241/2019) antaa hankintayksiköille oikeuden vaatia toimittajilta EN 16931 -muotoisia verkkolaskuja. Ulkomaiset toimittajat voivat lähettää verkkolaskuja valtiolle Peppolin kautta, ja Suomen Peppol-viranomaisena toimii Valtiokonttori.

Yhteentoimiva Eurooppa -säädös ja eIDAS 2 tuovat tähän eurooppalaisen kerroksen: rajat ylittävän yhteentoimivuuden arvioinnit ja eurooppalaisen digitaalisen identiteetin lompakon. DVV:n mukaan Suomen lompakkosovellus julkaistaan vuonna 2027. Suunnittelemme integraatiokerrokset, joissa kansalliset palvelut ja tunnistusratkaisut ovat sovittimia vakaiden sisäisten sopimusten takana, joten uusi maa tarkoittaa uutta sovitinta eikä taustajärjestelmien uudelleentyöstöä.

Kysymyksiä integraatioista ja rajapinnoista

Kannattaako käyttää integraatioalustaa vai rakentaa räätälöidyt integraatiot?

Molempia, eri tietovirtoihin. Vakioliittimet, muunnokset ja kumppanien liittäminen puoltavat alustaa. Suurivolyymiset, viiveherkät tai logiikkaa vaativat tietovirrat puoltavat usein räätälöityjä palveluja. Päätämme tietovirroittain ja kirjaamme perusteet.

Kuuluvatko Salesforce-, SAP- ja Odoo-integraatiot palveluun?

Kuuluvat. Liitämme niitä säännöllisesti toisiinsa sekä räätälöityihin ja julkisen sektorin järjestelmiin. FromNine on kaikkien kolmen kumppani (Salesforce Summit Partner, SAP Gold Partner, Odoo Gold Partner), joten integraatiotiimimme työskentelevät alustojen asiantuntijoiden rinnalla. Tutustu SAP-integraatioihimme.

Miten verkkolaskut julkisille hankintayksiköille hoidetaan?

Liitämme ERP-järjestelmäsi Peppol-verkkoon palveluntarjoajan kautta, jotta laskut lähtevät EN 16931 -muodossa ja tilausviitteet ja pakolliset kentät tarkistetaan ennen lähetystä. Laki sähköisestä laskutuksesta (241/2019) antaa hankintayksiköille oikeuden vaatia tätä muotoa, eikä sähköpostilla lähetetty PDF ole verkkolasku. Suomen Peppol-viranomaisena toimii Valtiokonttori.

Onnistuuko Suomi.fi-tunnistuksen ja muiden kansallisten tunnistusratkaisujen integrointi?

Kyllä. Integroimme asukkaiden ja yritysten tunnistusratkaisuja, Suomessa Suomi.fi-tunnistuksen ja Suomi.fi-valtuudet, ja suunnittelemme ratkaisut eurooppalaista digitaalisen identiteetin lompakkoa varten, jota jäsenvaltiot ottavat käyttöön eIDAS 2:n nojalla. DVV:n mukaan Suomen lompakkosovellus julkaistaan vuonna 2027. Liittymisvaatimukset vaihtelevat palveluittain, ja otamme ne huomioon ajoissa.

Meillä on vanha välitysohjelmisto. Pitääkö se korvata?

Ei kerralla. Kartoitamme, mitä sen päällä ajetaan, siirrämme riskialttiimmat tai kalleimmat tietovirrat ensin ja pidämme täsmäytyksen käytössä, kunnes jokainen siirretty tietovirta on todettu toimivaksi.

Tuo liittymä, joka pettää useimmin

Näytämme, miten tekisimme siitä valvottavan, idempotentin ja omistetun, ja mitä saman tekeminen muille vaatisi.

Keskustellaan projektistasiAsiakaspalvelun tuki