Rajapintojen käyttäminen

Rajapinnan käyttöönotto

Rajapinnat ovat käytettävissä vain Super-versiossa. Näiden ohjeiden avulla voit aktivoida rajapinnan ja määrittää sen käytön.

1. Rajapintojen aktivoiminen

1. Mene Asetukset (ylävalikon hammasratas-symboli).
2. Valitse Käytettävät toiminnot.
3. Etsi Rajapinnat käytössä? ja aktivoi valitsemalla valintaruutu.

2. Rajapinnan roolin luominen

1. Mene Omat tiedot -> Roolit.
2. Paina Uusi rooli (+).
3. Kirjoita Roolin kuvaukseen esimerkiksi "Rajapinta".
4. Valitse Ei kohdassa Saako kirjautua?.
5. Valitse Ei kohdassa Saako muokata laskuja?.
6. Valitse Kyllä kohdassa Saako käyttää rajapintaa?.
7. Paina Tallenna.

3. Rajapinnan käyttäjän luominen

1. Mene Omat tiedot -> Käyttäjät.
2. Luo uusi käyttäjä ja valitse sille rooliksi juuri luomasi "Rajapinta"-niminen rooli.
3. Uuden käyttäjän salasana lähetetään hänen sähköpostiosoitteeseensa. Käytä tätä käyttäjätunnusta ja salasanaa rajapinnoissa.

4. Rajapintakuvaus ja sen käyttäminen

Laskuja voit tuoda Finvoice-muodossa (tai XML-muodossa, jos olet kytkenyt laskujen tuonnin päälle asetuksista) seuraavien ohjeiden mukaan:

• Lähetä REST-tapaa käyttäen POST-kutsu osoitteeseen: https://app.nettilasku.fi/hook.php.

Yleiset POST-kentät:

• username: käyttäjätunnus
• password: salasana
• asiakasid: asiakas-ID
• komento: komento

Esimerkki myyntilaskujen tuonnista:

• username: rajapinta_username
• password: FOO1234
• asiakasid: 123123
• komento: tuo_laskut
• xml: <?xml version="1.0" encoding="UTF-8"?>`-tägin ympyröimänä.

Esimerkki laskutusasiakkaiden tuonnista:

• username: rajapinta_username
• password: FOO1234
• asiakasid: 123123
• komento: tuo_laskutusasiakkaat
• xml: <?xml version="1.0" encoding="UTF-8"?><customers.....

Rajapintadokumentaatio: https://swagger-ui.nettilasku.fi/?urls.primaryName=v2

Päivitetty: 19/07/2026