Tässä ohjeessa kuvataan, miten kirjanpitodataa voidaan hakea Finago Procountor API -rajapinnan kautta ulkoiseen järjestelmään jatkokäsittelyä ja raportointia varten.
API-rajapinnan kautta on mahdollista hakea joko muutamia valmiita kirjanpitoraportteja tai vaihtoehtoisesti noutaa kirjanpitodata tositteittain.
Rajapinnan kautta saatavat valmiit kirjanpidon raportit
Finago Procountoa API -rajapinnan kautta on haettavissa seuraavat raportit:
Tuloslaskelma, kassavirta ja tase
POST/reports/accounting
Tuloslaskelma (INCOME_STATEMENT)
Kassavirta (CASH_FLOW)
Tase (BALANCE_SHEET)
Pääkirja
POST/reports/generalledger/{id}
Pääkirjatilit
POST/reports/ledgeraccounts
Esimerkki Tase -raportin hakemisesta
Haetaan tase-raportti, joka sisältää liiketapahtumiksi luokitellut tositteet
POST /reports/accounting{
"startDate": "2025-11-01",
"endDate": "2025-11-30",
"receiptStatus": [
"PARTLY_PAID",
"PAYMENT_DENIED",
"PAID",
"MARKED_PAID",
"APPROVED",
"PAYMENT_QUEUED",
"PAYMENT_SENT_TO_BANK",
"NOT_SENT",
"SENT"
],
"type": "BALANCE_SHEET",
"options": {
"receiptType": [
"SALES_INVOICE",
"PURCHASE_INVOICE",
"TRAVEL_INVOICE",
"BILL_OF_CHARGES",
"JOURNAL",
"SALARY",
"VAT_FORM",
"EMPLOYER_CONTRIBUTION",
"PERIODIC_TAX_RETURN",
"VAT_SUMMARY",
"SALES_ORDER",
"PURCHASE_ORDER",
"REFERENCE_PAYMENT",
"BANK_STATEMENT_AS_RECEIPT",
"RECEIPT_FOR_OPENING_ACCOUNTS"
],
"reportLanguage": "fi"
}
}
Kirjanpitodatan hakeminen tositteittain
Käyttötapaus
Asiakkaalla on ulkoinen raportointijärjestelmä, johon kaikki kirjanpitotiedot halutaan viedä. Data haetaan tosite kerrallaan, ja kerätään sekä summataan ulkoisessa järjestelmässä. Yleensä vain liiketapahtumat sisältyvät kuukauden viralliseen kirjanpitoon ja ALV-yhteenvetoon.
Käytettävät rajapinnat
GET /ledgerreceipts endpoint hakee listan kirjanpitotositteista ja niiden ID-tunnisteista.
Yksittäinen tosite haetaan käyttämällä GET /ledgerreceipts/{id} endpointia.
Dimensiot ovat tositteella tietokannan ID-tunnisteina, ja, ne täytyy yhdistää ulkoisen järjestelmän dimensioihin, kuten esimerkiksi kustannuspaikkoihin. Dimensioiden tiedot haetaan rajapinnasta GET /dimensions/{dimensionId} endpointilla.
Tilikartan hakeminen Procountor API:n kautta: GET /coa
Käytössä olevat ALV-statukset: GET /vats/default
Seurantajaksot ja tilikaudet: GET /fiscalyears
Muokkausaikaleima (modified) näyttää, milloin tilikautta tai seurantajaksoa on viimeksi muokattu
Hakusuodattimet
Kirjanpidon tositteita voidaan suodattaa tositteen tilan (status) perusteella. Vain liiketapahtumat sisältyvät viralliseen kirjanpitoon ja ALV-yhteenvetoon.
Tallennetun tositteen ID-tunniste on hyvä säilyttää. Tunnisteen avulla tosite voidaan tarvittaessa myöhemmin hakea, päivittää tai mitätöidä API:n kautta.
Huomioitavaa.
Käyttäjäoikeuksien tulee olla riittävät kaikkien haluttujen kirjatositetyyppien hakemiseen. Esimerkiksi palkkatietojen hakeminen edellyttää, että on vähintään katseluoikeuset palkanmaksuun.