Ohjeet

API

Rakenna mitä tahansa Trusterin päälle

Laskutus ilman käsityötä

Trusterin kumppani-API poistaa laskutuksesta käsityön: perustat tekijät kerran omalla tunnisteellasi, ja sen jälkeen yksi erä kantaa jopa 5 000 riviä — työt, palkkiot, päivärahat, kilometrit ja kuitilliset kulut samassa lähetyksessä, vaikka sadoille tekijöille kerralla. Suomessa käsitelty erä muuttuu yhdeksi koontilaskuksi.

Yksi virheellinen rivi ei kaada koko erää: jokainen rivi saa oman kuittauksensa (hyväksytty, karanteenissa tai hylätty), ja karanteeniin jäänyt rivi korjataan ja lähetetään uudelleen samalla tunnisteella. Uudelleenyritykset ovat turvallisia — idempotenssiavain palauttaa alkuperäisen vastauksen, eikä sama rivi voi laskuttua kahdesti.

Dokumentaatio on julkinen: interaktiivinen API-dokumentaatio (api.truster.com/api/v2/docs), koneluettava OpenAPI-kuvaus ja integraatio-opas (api.truster.com/api/v2/guide) ovat luettavissa ilman kirjautumista. Opas on kirjoitettu niin, että voit antaa sen tekoälyllesi ja pyytää integraation.

Alkuun päivässä, ei viikoissa

  1. 01

    Pyydä API-avain

    Saat avaimen asiakaspalvelustamme — sk_test_… hiekkalaatikkoon; tuotantoavaimen (sk_live_…) saat, kun avaamme tuotannon. Avain määrää myös markkinan (Suomi tai Ruotsi), ja GET /settings kertoo heti, mitä sillä saa tehdä.

  2. 02

    Avaa dokumentaatio

    API-dokumentaatio ja integraatio-opas ovat julkisia: api.truster.com/api/v2/docs ja /api/v2/guide. Ei kirjautumista, ei NDA:ta.

  3. 03

    Anna tekoälyn integroida

    Anna tekoälyllesi (Claude, Cursor, Copilot…) integraatio-oppaan tai OpenAPI-kuvauksen osoite ja pyydä yhdistämään järjestelmäsi Trusteriin — opas on kirjoitettu juuri tätä varten.

  4. 04

    Testaa hiekkalaatikossa

    Rakenna ja testaa sk_test_-avaimella hiekkalaatikossa ennen kuin mitään laskutetaan oikeasti. Kun kaikki toimii, avaamme tuotannon.

Dokumentaatio on avoin

Selaa rajapintaa interaktiivisessa dokumentaatiossa tai lue integraatio-opas — molemmat ilman kirjautumista.

Erät ja rivit

Jopa 5 000 riviä erässä. Lisää, muokkaa, siirrä ja poista rivejä omalla externalRowId-tunnisteellasi — Trusterin sisäisiä tunnisteita ei tarvita missään.

Työntekijät

Perusta tekijä henkilötunnuksella tai tekijän omalla jakokoodilla, jolloin henkilötunnusta ei tarvitse käsitellä lainkaan.

Päivärahat ja kilometrit

Päivärahat, kilometrikorvaukset ja Suomessa myös ateriakorvaukset hinnoitellaan verottajan virallisilla taksoilla. Taksat ja ALV-käsittelyt saat suoraan rajapinnasta.

Kuitit

Liitä kuitti kuluriville: tekoäly lukee myyjän, päivän, summat ja ALV:n ja tarkistaa ne ilmoitettua summaa vasten.

Koontilasku

Suomessa käsitelty erä muuttuu yhdeksi koontilaskuksi, jonka tiedot luet rajapinnasta.

Webhookit

Kuittien käsittely ja tekijöiden tilamuutokset tulevat järjestelmääsi webhookeina, joten kuitteja ei tarvitse pollata. Erän ja laskun tilan luet rajapinnasta.

Yksi kutsu, valmis lasku

Rajapinta vastaa JSONilla — ja webhook vie tapahtuman järjestelmääsi.

Kuvitus: rajapintakutsu luo laskun — pyyntö lähetetään, palvelin vastaa 200 OK ja webhook toimittaa tapahtuman omaan järjestelmään.

Rivejä erässä
5 000
Rivityypit
Työ · palkkio · korvaus · kulu
Markkinat
Suomi · Ruotsi
Hiekkalaatikko
sk_test_-avaimet

Tarkistettu 25. syyskuuta 2026

Ensimmäinen integraatio päivissä

Pyydä API-avain asiakaspalvelusta tai varaa demo, niin käydään rajapinta läpi teidän käyttötapauksellanne.