Naar de inhoud
Documentatie
Handleiding API Demo
Nederlands
De applicatie openen

Het grootboek lezen

Use case stap voor stap om via de NovaFisko-API de proef- en saldibalans en daarna het grootboek van een rekening te lezen, met het voortschrijdend saldo.

Bijgewerkt op 05-10-2026 Deze pagina bewerken

Deze gids haalt de proef- en saldibalans van een boekjaar op, en daarna het detail van de bewegingen van een rekening met haar voortschrijdend saldo. Hij is bedoeld voor tools voor rapportering, consolidatie en dashboards.

Vereisten: een token met de bevoegdheid read en de public_token van het dossier.

Stap 1: het boekjaar vinden

De staten worden altijd berekend voor een boekjaar, aangeduid met zijn id.

curl https://api.novafisko.com/v1/companies/k3Jd9fPq2LmX/fiscal-years \
  -H "Authorization: Bearer $NOVAFISKO_TOKEN"

[
  {
    "id": 6,
    "code": "2025",
    "starts_on": "2025-01-01T00:00:00.000000Z",
    "ends_on": "2025-12-31T00:00:00.000000Z",
    "is_closed": true,
    "closed_at": "2026-03-14T10:22:05.000000Z",
    "periods": []
  },
  {
    "id": 7,
    "code": "2026",
    "starts_on": "2026-01-01T00:00:00.000000Z",
    "ends_on": "2026-12-31T00:00:00.000000Z",
    "is_closed": false,
    "closed_at": null,
    "periods": [
      {"id": 85, "number": 1, "label": "01/2026", "starts_on": "2026-01-01T00:00:00.000000Z", "ends_on": "2026-01-31T00:00:00.000000Z", "is_locked": true}
    ]
  }
]

Stap 2: de proef- en saldibalans lezen

De balans geeft voor elke rekening met bewegingen de totalen debet en credit en het saldo. Het is het natuurlijke vertrekpunt: ze toont welke rekeningen een gedetailleerde blik verdienen.

curl "https://api.novafisko.com/v1/companies/k3Jd9fPq2LmX/fiscal-years/7/trial-balance?from=2026-01-01&to=2026-09-30" \
  -H "Authorization: Bearer $NOVAFISKO_TOKEN"
Parameter Standaard Beschrijving
from begin van het boekjaar Begindatum, inbegrepen
to einde van het boekjaar Einddatum, inbegrepen
include_empty false true om de rekeningen op te nemen waarvan de totalen nul zijn 
{
  "fiscal_year": "2026",
  "from": "2026-01-01",
  "to": "2026-09-30",
  "lines": [
    {
      "account_id": 90,
      "number": "440000",
      "label": "Fournisseurs",
      "type": "liability",
      "debit": "48210.35",
      "credit": "55120.80",
      "debit_balance": "0.00",
      "credit_balance": "6910.45",
      "balance": "-6910.45"
    },
    {
      "account_id": 118,
      "number": "604000",
      "label": "Achats de marchandises",
      "type": "expense",
      "debit": "31874.20",
      "credit": "412.00",
      "debit_balance": "31462.20",
      "credit_balance": "0.00",
      "balance": "31462.20"
    }
  ],
  "totals": {
    "debit": "412587.14",
    "credit": "412587.14",
    "is_balanced": true,
    "result": "18240.66"
  }
}

Het veld balance heeft een teken: positief voor een debetsaldo, negatief voor een creditsaldo. totals.result is het resultaat van de periode, positief voor een winst en negatief voor een verlies. totals.is_balanced moet altijd de waarde true hebben.

Stap 3: het grootboek van een rekening lezen

Het grootboek wordt rekening per rekening gelezen, met de account_id uit de balans of uit GET accounts.

curl "https://api.novafisko.com/v1/companies/k3Jd9fPq2LmX/fiscal-years/7/general-ledger/118?from=2026-07-01&to=2026-09-30" \
  -H "Authorization: Bearer $NOVAFISKO_TOKEN"

{
  "account_id": 118,
  "from": "2026-07-01",
  "to": "2026-09-30",
  "opening_balance": "20918.75",
  "movements": [
    {
      "line_id": 5388,
      "entry_id": 1790,
      "entry_date": "2026-07-03",
      "journal": "ACH",
      "document": "2026/000171",
      "label": "Fûts 20 L blonde",
      "reference": "F-2026-0611",
      "third_party": "Brasserie des Collines SA",
      "debit": "980.00",
      "credit": "0.00",
      "balance": "21898.75",
      "reconciliation_code": null
    },
    {
      "line_id": 5521,
      "entry_id": 1842,
      "entry_date": "2026-09-30",
      "journal": "ACH",
      "document": "2026/000212",
      "label": "Fûts 20 L blonde",
      "reference": "F-2026-0918",
      "third_party": "Brasserie des Collines SA",
      "debit": "1250.00",
      "credit": "0.00",
      "balance": "31462.20",
      "reconciliation_code": null
    }
  ],
  "totals": {
    "debit": "10955.45",
    "credit": "412.00",
    "balance": "31462.20"
  }
}
Veld Beschrijving
opening_balance Overgedragen saldo: bewegingen van het boekjaar vóór from
movements[].balance Voortschrijdend saldo na de beweging
movements[].document Stuknummer in het formaat boekjaar/nummer met zes cijfers
movements[].reconciliation_code Afpuntcode, null als de lijn niet is afgepunt
totals.balance Eindsaldo: opening_balance plus de debetbedragen min de creditbedragen

De bewegingen zijn gesorteerd op datum, daarna op boeking en daarna op lijnpositie. Deze route is niet gepagineerd: beperk de periode met from en to voor rekeningen met zeer veel bewegingen.

Stap 4: teruggaan naar de boeking

Elke beweging draagt een entry_id. De volledige boeking, met al haar lijnen, leest u als volgt:

curl https://api.novafisko.com/v1/companies/k3Jd9fPq2LmX/entries/1842 \
  -H "Authorization: Bearer $NOVAFISKO_TOKEN"

Volledig voorbeeld: het hele grootboek in Python

import os
import requests

BASE = "https://api.novafisko.com/v1"
COMPANY = "k3Jd9fPq2LmX"
FISCAL_YEAR = 7

session = requests.Session()
session.headers.update({
    "Authorization": f"Bearer {os.environ['NOVAFISKO_TOKEN']}",
    "Accept": "application/json",
})

balance = session.get(
    f"{BASE}/companies/{COMPANY}/fiscal-years/{FISCAL_YEAR}/trial-balance", timeout=60
).json()
assert balance["totals"]["is_balanced"]

ledger = {}
for line in balance["lines"]:
    # One call per account that actually moved during the year
    ledger[line["number"]] = session.get(
        f"{BASE}/companies/{COMPANY}/fiscal-years/{FISCAL_YEAR}/general-ledger/{line['account_id']}",
        timeout=60,
    ).json()

for number, account in sorted(ledger.items()):
    print(number, account["totals"]["balance"], len(account["movements"]), "movements")
Tip

Als u het volledige grootboek in één enkel bestand nodig hebt, gebruik dan de export: GET exports/general-ledger?format=csv&fiscal_year_id=7. Hij aanvaardt account_from en account_to om een rekeningbereik af te bakenen. Zie Het volledige dossier exporteren.

Andere beschikbare staten

Route Inhoud
fiscal-years/{id}/balance-by-period Balans uitgesplitst per periode
fiscal-years/{id}/financial-statements Balans en resultatenrekening
journals/{id}/entries Boek van een dagboek, met from en to
third-party-balance/{type} Balans van de klanten (customer) of van de leveranciers (supplier)
aged-balance/{type} Ouderdomsbalans
fiscal-years/{id}/consistency Coherentiecontroles van het boekjaar
integrity Integriteitscontrole van het dossier
Opmerking

Een onbekend boekjaar of een boekjaar dat tot een ander dossier behoort, antwoordt 404. Hetzelfde geldt voor een rekening van een ander dossier.

Zie ook