Overzicht van de API

De NovaFisko-API is de interface die de applicatie zelf gebruikt op het web, op de computer en op mobiel. Alles wat u ziet in de tabbladen Boekingen, Documenten, Bank, Btw, Exports of Peppol loopt via deze API. Uw integratie heeft dus exact dezelfde mogelijkheden: een dossier aanmaken, een factuur met haar pdf doorsturen, het grootboek lezen, het volledige dossier van een boekjaar downloaden of de wijzigingen continu volgen.

In het kort#

Met een minimale aanroep, zonder authenticatie, controleert u of de dienst antwoordt:

curl https://api.novafisko.com/v1/status

{
  "ok": true,
  "time": "2026-10-05T08:12:44+00:00"
}

GET /v1/ping geeft dezelfde informatie terug in de vorm {"ok": true, "server_time": "..."} zonder de database te raadplegen. Gebruik deze route als connectiviteitstest.

Omgevingen#

Er bestaat geen afzonderlijke testhost. De sandbox is een demokantoor dat op dezelfde API draait: u krijgt een token met één aanroep, zonder een account aan te maken.

curl -X POST https://api.novafisko.com/v1/auth/demo \
  -H "Content-Type: application/json" \
  -d '{"locale": "fr", "device_name": "integration-sandbox"}'

{
  "token": "412|Qm9uam91ciBsZSBtb2RlIGTDqW1v",
  "user": {
    "id": 9034,
    "name": "Visiteur démo",
    "email": "demo-7f3a9c@demo.novafisko.com",
    "locale": "fr",
    "is_platform_admin": false,
    "is_demo": true,
    "firms": [
      {"public_token": "Fd7hQ2mN8sXa", "name": "Fiduciaire Démo", "role": "manager"}
    ],
    "managed_firms": [
      {"public_token": "Fd7hQ2mN8sXa", "name": "Fiduciaire Démo"}
    ]
  },
  "demo": {
    "firm": {"public_token": "Fd7hQ2mN8sXa", "name": "Fiduciaire Démo"},
    "companies": [
      {"public_token": "k3Jd9fPq2LmX", "code": "COMPTOIR", "name": "Le Comptoir Montois SRL"},
      {"public_token": "Pw8sTz4YbN1c", "code": "PIXELWERK", "name": "Pixelwerk SRL"},
      {"public_token": "Lb5vRe7HuK2d", "code": "LAMBERT", "name": "Lambert Électricité"},
      {"public_token": "Sc2oUv9XaM6e", "code": "SCENES", "name": "Scènes Ouvertes ASBL"}
    ],
    "expires_at": "2026-10-06T08:12:44+00:00",
    "resets_at": "2026-10-06T03:15:00+02:00"
  }
}

Het demokantoor bevat vier fictieve Belgische dossiers met twee boekjaren, boekingen, bankafschriften, btw-aangiften en te valideren documenten. U kunt er vrij in schrijven.

Als het demokantoor tijdelijk niet beschikbaar is, antwoordt de aanroep 503 met de code demo_unavailable.

Formaten#

• De request-body's zijn in JSON (Content-Type: application/json), behalve bij het uploaden van bestanden, waarvoor multipart/form-data wordt gebruikt.
• De antwoorden zijn altijd in JSON, ook de fouten, behalve de exports (PDF, XLSX, CSV, ZIP, XML), die het bestand teruggeven.
• De datums volgen het formaat ISO 8601, de bedragen zijn decimale strings met een punt. De details staan in Conventies.
• De fouten volgen één enkele vorm {message, code, errors}, beschreven in Fouten en limieten.

Beschikbare tools#

De specificatie beschrijft elke route met haar parameters, schema's en voorbeelden. U kunt ze importeren in Postman, Insomnia of Bruno, of een client genereren met de tool van uw keuze.

Wat de API dekt#

Waar te beginnen#

1. Vraag een token aan: lees Authenticatie.
2. Neem de Conventies door om valkuilen rond formaten te vermijden.
3. Volg een use case, bijvoorbeeld Een aankoopfactuur doorsturen.
4. Sluit de webhooks aan om op de hoogte te worden gebracht van wijzigingen in plaats van de API te bevragen.

Zie ook#

• Authenticatie
• Fouten en limieten
• Versiebeleid
• API-referentie