Kirjanpidon tositteen oikeellisuudesta vastaa aina tuova järjestelmä.
- Tositelajit – statement_series_code
Fennoassa on käytössä eri tositelajit tapahtumatyypeittäin. On suositeltavaa käyttää tositteen tuonnissa tapahtumaa parhaiten kuvaavaa tositelajia, esim. tositelajia CA.
Tämä on Cash-tositelaji, johon ei muodostu automaattisesti tositteita Fennoan käyttöliittymässä ja näin ollen rajapinnan kautta tuodut tositteet ovat helpommin kirjanpitäjän löydettävissä.
Mikäli tositelajia ei anneta, muodostuvat tositteet GL tositelajiin, joka on muistiotositteiden tositelaji – tarkistathan halutun tositelajin aina asiakkaalta.
Tuetut tositelajit
| Statement series name | Series code |
|---|---|
| Cash | CA |
| General ledger 1 | GL |
| General ledger 2 | GL2 |
| General ledger 3 | GL3 |
| General ledger 4 | GL4 |
| General ledger 5 | GL5 |
| General ledger 6 | GL6 |
| Purchace invoice* | PU |
Mikäli annettu tositelaji on virheellinen, palautuu virhe
”status”:”error”,”errors”:[”Given statement series code did not match any statement series”
- Tositteen päivämäärä – entry_date
Mikäli päivämäärää ei anneta, muodostuu tosite kuluvalle päivälle.
Kirjanpidon kauden sulku estää tuonnin suljetulle kaudelle.
Kauden ollessa suljettu, Fennoa palauttaa virheen ”status”:”error”,”errors”:{”entry_date”:[”Accounting is locked until 2024-05-01, please select later entry date”
Mikäli kirjanpidon kausi on suljettu, tulee kauden aukaisua pyytää tilitoimiston käyttäjältä.
Kunkin kuukauden tapahtumat tulee tuoda Fennoaan rajapinnassa viimeistään seuraavan kuukauden ensimmäisinä päivinä.
- Tositteen selitteet
Tositteelle on suositeltavaa tuoda ylätason selite – description – joka kopioituu kaikille tositteen riveille ja sitä voi halutessaan tarkentaa rivikohtaisella selitteellä – row[x][description]
Mikäli ylätason selite puuttuu, eikä selitteitä lisätä rivikohtaisestikaan, jää tosite kokonaan ilman selitteitä.
Käyttöliittymässä on mahdollista pakottaa tilille rivikohtainen selite. Mikäli tällainen asetus on tehty, eikä rivikohtaista selitettä rajapinnassa ole annettu, palautuu virhe ”error”,”errors”:{”Statement”:[{”description”:[”Description is required for account 1021”
- Kirjanpidon tili -account on löydyttävä Fennoasta.
Asiakkaalla käytössä olevat tilit saa noudettua kutsulla GET /accounting_api/get/accounts
Mikäli tiliä ei löydy, palauttaa rajapinta virheen ”status”:”error”,”errors”:[”Account 3001 does not exist”
- Tositteella on aina oltava aina vähintään kaksi riviä (debet / kredit)
Rivien määrää ei ole rajoitettu, mutta tositteen tulee mennä debet /kredit summiltaan tasan.
Mikäli molempia tilejä ei ole annettu, palauttaa rajapinta virheen ”status”:”error”,”errors”:[”Debit\/credit must be equal
Esim useamman myyntitilin tositteen voi tuoda yhdellä vastaviennillä
- Tositteen alv-käsittely määritellään alv-koodilla – vatcode.
Mikäli tositerivin kirjaus sisältää arvonlisäveron, tulee rivillä olla alv-koodi – row[x][vatcode]
ALV-koodit saa noudettua kutsulla GET /accounting_api/get/vatcodes
Huomioithan, että Fennoassa myynneillä ja ostoilla on omat alv-koodinsa. Nämä on eritelty kutsun vastauksessa tyypeittäin
Myynnit – type sales
”id”: ”63”,
”name”: ”Standard”,
”vatpercent”: ”25.50”,
”type”: ”sales”
Ostot – type purchases
”id”: ”58”,
”name”: ”Standard”,
”vatpercent”: ”25.50”,
”type”: ”purchases”
Laskentakohteet – dimensions
Mikäli laskentakohteet ylläpidetään Fennoassa, saat noudettua kohteet kutsulla GET /dimension_api/
Laskentakohteita voi myös luoda rajapinnassa.
Laskentakohdetyyppi on kohteiden ylätaso, jonka alle perustuvat varsinaiset laskentakohteet valittaviksi tositeriville.
Käytössä olevat laskentakohdetyypit ja ID:t saat noudettua GET /dimension_api/get/types
Uuden kohteen lisääminen laskentakohdetyypin alle luodaan kutsulla POST /dimension_api/add
Haluttu laskentakohdetyyppi annetaan kohteen ID:llä – dimension_type_id
Kohteen koodi – code – on suositeltavaa olla numeerinen, koodi on raporteilla näkyvä tunniste. Kohteen nimi – name – näkyy käyttöliittymässä, kun vie hiiren koodin päälle.
Mikäli laskentakohdetyyppiä ei ole luotu Fennoaan, tulee laskentakohdetyyppi luoda kutsulla POST /dimension_api/add/type ennen varsinaisen kohteen tuontia.
Käyttöliittymässä on mahdollista määrittää laskentakohde pakolliseksi tietyille tileille. Mikäli tällainen määritys on tehty eikä laskentakohdetta ole annettu rajapinnassa, palautuu virhe ”error”,”errors”:{”statement_number”:[”Account 3000 – Kustannuspaikka is required dimension”