Fennoa-rajapinta

Ohje Fennoa-myyntilaskujen API-integraation käyttöön

Tämä ohje auttaa sinua ottamaan Fennoa-myyntilaskujen API-integraation käyttöön. Integraatio mahdollistaa sen, että Eemelissä luodut myyntilaskut voidaan lähettää automaattisesti Fennoaan REST-rajapinnan kautta.
​

Vaihe 1: Rajapinnan lisääminen Eemeliin

1. Siirry Eemelissä kohtaan "Omat tiedot" ja valitse "Rajapinnat".
2. Lisää uusi rajapinta valitsemalla Fennoa ja syöttämällä Fennoasta saamasi API-käyttäjätunnus ja API-avain. Fennoasta saat nämä seuraavasti: Lisää API käyttäjä Fennoa -> Käyttäjät -> Luo uusi API-käyttäjä -> Yleinen API-käyttäjä. Anna nimeksi TEST Eemel. Valitse API-käyttäjän rooliksi myyjä ja ostot. API-käyttäjän luomisen jälkeen saat API-käyttäjätunnuksen ja API-avaimen. Kopio API-käyttäjä ja API-avain talteen, sillä sitä ei näytetä uusiksi. Täytä myös Päivämäärä-kenttä josta lähtien laskut lähetetään Fennoaan.
3. Tallenna tiedot, ja Fennoa-rajapinta on nyt käytettävissä.

Vaihe 2: Myyntilaskujen lähettäminen Fennoaan

1. Kun olet luonut laskun Eemelissä, ja Fennoa-rajapinta on aktivoitu, laskut lähetetään automaattisesti Fennoaan, kun laskun tila muuttuu lähetetyksi. Laskut lähetetään säännöllisin väliajoin eräajossa.
2. Lähetyksessä huomioidaan seuraavat asiat:

• Laskuissa tulee olla täydelliset osoitetiedot ja pankkitiedot määritettynä.
• Lasku lähetetään Fennoaan REST-rajapinnan kautta, ja mukana voivat mennä myös liitteet, jos niitä on lisätty laskuun.

Maksusuorituksia ei kuitenkaan lähetetä Fennoaan.

Vaihe 3: Rajapintalokin tarkastelu

1. Eemelissä on rajapintaloki, josta näet kaikki onnistuneet ja epäonnistuneet lähetykset Fennoaan. Pääset tarkastelemaan tätä toimintoa valitsemalla Fennoa-rajapinnan tiedoista Näytä loki.
2. Jos jokin lähetys epäonnistuu, voit lähettää laskun uudelleen lokin kautta, valitsemalla epäonnistuneen lähetyksen ja painamalla Lähetä uudelleen (tulossa myöhemmin).

Hyvityslaskujen käsittely

1. Hyvityslaskut voidaan lähettää Fennoaan. Jos hyvityslasku viittaa aiempaan laskuun, muokkaukset on sallittu vain ennen kuin alkuperäinen lasku on lähetetty Fennoaan.

Lokitiedot ja virheiden käsittely

1. Rajapintalokiin tallentuu kaikki tiedot Fennoaan lähetetyistä laskuista, mukaan lukien mahdolliset virheet ja lähetyksen ajankohdat.
2. Jos lähetyksessä tapahtuu virhe, lokiin tallentuu virheviesti, ja lasku voidaan lähettää uudelleen, kun ongelma on ratkaistu.

Tämä integraatio tarjoaa tehokkaan ja automatisoidun tavan käsitellä myyntilaskujen lähetykset Fennoaan suoraan Eemelistä.

Päivitetty: 19/07/2026