Siirry pääsisältöön
Kaikki kokoelmatNettilasku taloushallintoMuut lisätoiminnot
Rajapintojen käyttäminen
Rajapintojen käyttäminen
Jarkko Kähkönen avatar
Tekijä: Jarkko Kähkönen
Päivitetty yli vuosi sitten

Rajapinnan käyttöönotto Nettilasku.fi

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:

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"?><Finvoice.....

Voit käyttää PHP

Curl-kirjastoa POST-kutsun lähettämiseen. REST-kutsu palauttaa "OK", jos laskut tuotiin onnistuneesti, muuten virhetekstin.

Esimerkki myyntilaskujen hakemisesta:

  • username: rajapinta_username

  • password: FOO1234

  • asiakasid: 123123

  • komento: hae_laskut_finvoice

  • from_date: 2015-12-01

  • to_date: 2015-12-31

Palauttaa aikavälin laskut Finvoice-XML-muodossa.

Esimerkki myyntireskontran viitesuoritusten hakemisesta:

  • username: rajapinta_username

  • password: FOO1234

  • asiakasid: 123123

  • komento: hae_suoritukset

  • from_date: 2015-12-01

  • to_date: 2015-12-31

Palauttaa aikavälin suoritukset puolipisteillä eroteltuna <NETTILASKU-SUORITUKSET>-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

Mikäli sinulla on kysyttävää, kokeile chat-ikkunaa tai lähetä viesti: tuki@nettilasku.fi.

Vastasiko tämä kysymykseesi?