Fennoaan voidaan tuoda toisessa järjestelmässä tehtyjä myyntilaskuja sekä niiden liitteitä rajapinnan kautta. Rajapinnan kautta lasku voidaan myös hyväksyä sekä lähettää. Varmista ennen integraation tekemistä asiakkaalta millaisen prosessin hän haluaa myyntilaskuille.

HUOM!

  • Asiakas ja tuote kohdistetaan rajapinnassa asiakasnumerolla (customer_no) ja tuotekoodilla (product_no). Mikäli asiakasta ei löydy, rajapinta perustaa asiakaskortin automaattisesti uutena Fennoan juoksevalla asiakasnumerolla. Mikäli tuotetta ei löydy, tuotekortti ei muodostu Fennoaan. Sanomalla suositellaan aina käytettäväksi asiakasnumeroa sekä tuotekoodia jotta tiedot kohdistuvat käyttöliittymässä oikein. Mikäli asiakas ei ylläpidä tuoterekisteriä, on suositeltavaa luoda yleinen tuote, johon laskurivit kohdistetaan. Rajapinta päivittää tuotteen tiedot tuotekortille.
  • Mikäli asiakkaalla on useampia verkkolaskuosoitteita, on suositeltavaa perustaa jokaisesta oma asiakaskortti. Samalla y-tunnuksella / nimellä voi olla eri asiakasnumerot.
  • Mikäli kyseessä on seliterivi ilman hinta-, tuote-, jne tietoja, lähetä vain row[x][description]
  • Fennoa laskee laskurivin Yhteensä-summan automaattisesti rivillä annetun määrän ja hinnan perusteella. Rivin nettosumma on aina yhtä suuri kuin hinta * määrä * (1 – discount_percent / 100). Rivin bruttosumma on aina yhtä suuri kuin nettosumma * (1 + vat_percent / 100)
  • Mikäli laskujen summat tuodaan bruttosummina, tulee laskulla elementtiin include_vat antaa arvo 1 – huomioi, että kuluttajalaskut tulee tuoda aina bruttona
  • Asiakaskohtaiset hinnasto id:t saa noudettua kutsumalla GET/customer_api, vastauksessa sales_pricelist_id
  • Laskentakohteet saa noudettua kutsumalla GET/dimension_api
  • Rajapinnassa luotaville myyntilaskuille on suositeltavaa asettaa oma laskunumerosarjansa Fennoaan (Fennoa > Asetukset > Laskunumerot) Laskunumerosarjan id tulee katsoa käyttöliittymästä. Halutun laskunumerosarjan id annetaan sales_invoice_series_id elementissä.
  • Myyntilaskulla voi olla vain yksi lähetysosoite, tarvittaessa laskun voi reitittää toiseen osoitteeseen käyttöliittymässä
  • Hyvityslaskun mukana tulee aina olla hyvitettävän laskun numero (credited_invoice_no). Hyvityslaskun määrä annetaan miinusmerkkisenä, summa positiivisena.

Myyntilaskujen prosessikuvaukset

Myyntilaskujen luominen

Myyntilaskujen lisätoiminnot

Rajapinnan kautta luodut laskut tulevat Fennoassa Luonnoksiin (Myynnit > Luonnokset), josta ne tulee hyväksyä ja lähettää erikseen. Fennoassa voidaan asetuksin automatisoida laskujen hyväksyntä ja lähetys – HUOM! Tämä asetus automatisoi kaikkien Fennoassa olevien myyntilaskujen hyväksynnän ja lähetyksen.

Mikäli halutaan automatisoida vain rajapinnan kautta luotujen laskujen hyväksyntä ja lähetys, voidaan se tehdä rajapinnan kautta.

Sanoman sisältö

Sanoman suositeltu minimisisältö

  • Asiakasnumero (customer_no)
  • Asiakkaan nimi
  • Osoite
  • Postinumero
  • Postitoimipaikka
  • Maa
  • Verokoodi
  • Laskun päivä
  • Eräpäivä
  • Laskun lähetystapa
  • Vähintään yksi laskurivi
  • Kaikki muut mahdolliset tiedot, kuten esim. toimitusosoite, lisätiedot, sopimustiedot, toimitusehdot, yms. on tarkistettavissa teknisestä dokumentaatiosta. Käythän aina läpi asiakkaan kanssa laskulle halutun sisällön.

Muut huomioitavat

Yleiset

  • Tuova järjestelmä vastaa aina laskujen tietosisällöstä
  • Onnistunut laskun luonti palauttaa laskun ID, joka tulee ottaa talteen
  • Laskun lähetys ja reskontra hoidetaan Fennoassa
    • Laskut voidaan vain tuoda Fennoaan rajapinnan, jonka jälkeen lasku hyväksytään ja lähetetään Fennoassa
      • Fennoassa on mahdollista asetuksin automatisoida laskun hyväksyntä sekä lähetys
    • Laskut voidaan tuonnin jälkeen hyväksyä ja lähettää myös rajapinnan kautta (kts. prosessikuvaus)

Integraation toimintaan vaikuttavat asetukset Fennoassa

  • Tuotaville laskuille asetetaan oma laskunumerosarja ennen laskujen tuomista (Fennoa > Asetukset > Laskunumerot > Luo uusi laskunumerosarja)
  • Kun laskujen tuonti on testattu ja laskujen todettu tulevan Fennoaan oikein, hyväksyntä ja lähetys automatisoida Fennoan asetuksissa asiakkaan näin halutessa (Fennoa > Asetukset > Myyntiasetukset > Automaattinen hyväksyntä). Tämä asetus vaikuttaa kaikkiin myyntilaskuihin, niin rajapinnan kautta tuotuihin kuin Fennoassa tehtyihin laskuihin
  • Mikäli Fennoan asetuksissa on asetettu lähetystavalle laskutuslisä (Fennoa > Asetukset > Myyntiasetukset > Laskuille lisättävät lähetystapakohtaiset lisämaksut), nämä lisätään automaattisesti lähetyksen yhteydessä, jolloin niitä ei tule tuoda APIn kautta

Erityisesti huomioitavat

Integraation toimintaan vaikuttavat asetukset Fennoassa:

  • Kuluttajaverkkolaskuja voidaan tuoda rajapinnan yli, mikäli kuluttajaverkkolaskutus on otettu käyttöön Fennoan kautta
  • Rahoitus- eli factoringlaskuissa Fennoan myyntiasetuksiin tulee olla syötettynä Factoring partner, Sopimusnumero sekä Etukäteismaksu-% (Fennoa > Asetukset > Myyntiasetukset > Factoring). Fennoaan tuotavissa laskuissa tieto factoringin käytöstä annetaan elementissä sales_factoring_partner_id > Yes=1, No=0. HUOM! Mikäli asiakas käyttää laskuilla factoringia, on tieto tuotava laskusanomalla. Tyhjä kenttä tarkoittaa samaa kuin ”ei factoringia”.
  • Oletuksena myynnin desimaaleja on 2. Desimaalien määrän voi vaihtaa Fennoan myyntiasetuksista (Fennoa > Asetukset > Laskutusasetukset > Laskun tarkkuus). Valittavat desimaalimäärät ovat 2, 4 ja 5. Desimaalivalinta koskee sekä lukumäärää että hintaa.
  • EU-palvelumyynti vaatii asiakkaan alv-tunnuksen vat_number
  • Aputoiminimi voidaan tuoda elementissä auxiliary_name_id. Pyydä aputoiminimien ID-lista asiakkaalta.

Myyntilaskun verokoodit ovat:

  • 1 = Domestic sales (S) Default
    • 2 = EU-sales services (K)
    • 3 = EU-sales goods (K)
    • 4 = Construction services (AE)
    • 5 = Scrap metal sales (AE)
    • 6 = Foreign sales, outside of EU (G)
    • 7 = Domestic sales VAT-free (Z)
    • 8 = Triangulation (K)
  • Laskun lähetystapa (delivery_method) on määräävä laskun lähetyskanavaksi, lähetystapojen koodit ovat:**
    • postal, manual, email, finvoice, consumerfinvoice, consumerdirect
    • PEPPOL

Fennoan tukemat verkkolaskuoperaattorit on listattu alla, sanomalla tulee käyttää verkkolaskuoperaattorin tunnusta

 Tunnus                                           Operaattori

HELSFIHHAktia Pankki Oyj
003723327487Apix Messaging Oy
BAWCFI22Basware Oyj
003703575029CGI Suomi Oy
5909000716438Comarch
CREDIFLOWCrediflow Ab
DABAFIHHDanske Bank Oyj
DNBAFIHXDNB Bank ASA
HANDFIHHHandelsbanken
885790000000418HighJump AS
INEXCHANGEInExchange Factorum AB
EXPSYSLexmark Expert Systems AB
003721291126Maventa
003726044706Netbox Finland Oy
NDEAFIHHNordea
003708599126OpenText / Liaison Technologies Oy
OKOYFIHHOP-Pohjola-ryhmä
003710948874OpusCapita Group Oy  Itella
E204503OpusCapita Solutions Oy
PAGEROPagero
003723609900Pagero
POPFFI22Paikallisosuuspankit
PALETTEPalette Software
PEPPOLPEPPOL BIS Billing 3.0
003710948874Posti Messaging Oy
003701150617PostNord Strålfors Oy
003714377140Ropo Capital Oy / Enfo Zender
SBANFIHHS-Pankki Oy
ITELFIHHSäästöpankit
003703575029Telia Finland Oyj
003701011385TietoEVRY Oyj
885060259470028Tradeshift Ab
003722207029Åland Post Ab
AABAFI22Ålandsbanken