Changelog van de API

Deze changelog somt de evoluties van de API v1 op, van de meest recente naar de oudste. De regels die voor deze evoluties gelden, staan beschreven in het versiebeleid.

Elke vermelding is als volgt ingedeeld:

5 oktober 2026#

Openstelling van de API voor integraties van derden.

Integratietokens#

• Toevoeging: GET /v1/auth/tokens, POST /v1/auth/tokens en DELETE /v1/auth/tokens/{token} om integratietokens aan te maken, op te lijsten en in te trekken.
• Toevoeging: bevoegdheden read, write en sync, optionele vervaldatum van 1 tot 730 dagen, datum van het laatste gebruik.
• Toevoeging: fouten 403 token_ability_missing (met required_ability) en session_token_required, fout 422 token_limit_reached.

Zie Authenticatie.

Webhooks#

• Toevoeging: eindpunten per kantoor met GET, POST, PATCH en DELETE /v1/firms/{firm}/webhooks.
• Toevoeging: testverzending POST .../webhooks/{webhook}/test en logboek GET .../webhooks/{webhook}/deliveries.
• Toevoeging: catalogus GET /v1/webhooks/events.
• Toevoeging: gebeurtenissen document.imported, document.booked, entry.posted, entry.reversed, bank.transaction_imported, vat.declaration_validated, fiscal_year.closed, peppol.status_changed, third_party.created, third_party.updated en webhook.test.
• Toevoeging: HMAC-SHA256-handtekening in de header X-Novafisko-Signature, headers X-Novafisko-Event en X-Novafisko-Delivery.
• Toevoeging: 8 leveringspogingen met een oplopende wachttijd van 1 tot 64 minuten.

Zie Webhooks en Handtekeningen verifiëren.

Demomodus#

• Toevoeging: POST /v1/auth/demo opent een demosessie zonder account, 24 uur geldig, op een fictief kantoor dat elke nacht wordt gereset.
• Toevoeging: veld is_demo in het antwoord van GET /v1/auth/me.
• Toevoeging: fout 403 demo_mode op de externe effecten en fout 503 demo_unavailable.

Zie Overzicht.

Documentatie#

• Toevoeging: OpenAPI 3.1-specificatie in JSON en in YAML, Postman-collectie en interactieve referentie.
• Toevoeging: integratiegidsen en use cases stap voor stap.

Geschiedenis en synchronisatie#

• Toevoeging: wijzigingsgeschiedenis met GET history, detail van een revisie en geschiedenis per record.
• Toevoeging: terugdraaien van een revisie of van een volledige bewerking met POST history/{revision}/revert en POST history/operations/{operation}/revert.
• Toevoeging: prullenbak met GET trash, herstel en definitieve verwijdering. De bestaande verwijderingen plaatsen het record voortaan in de prullenbak en antwoorden met de header X-Trashed: 1.
• Toevoeging: offline synchronisatie met sync/bootstrap, sync/pull, sync/push, sync/status en sync/conflicts.
• Toevoeging: idempotentie van de schrijfbewerkingen met X-Client-Mutation-Id en antwoord X-Idempotent-Replay: 1.
• Toevoeging: optimistische vergrendeling met X-Base-Version en antwoord 409 conflict.
• Toevoeging: veld version op de resources die door de geschiedenis worden gevolgd.
• Toevoeging: activiteitenlogboek GET activity per dossier en GET /v1/firms/{firm}/activity per kantoor.
• Toevoeging: connectiviteitstest GET /v1/ping. Elk antwoord 503 draagt voortaan een code.

Zie Idempotentie en Continu synchroniseren.

Documentimport#

• Toevoeging: document-imports om PDF-, afbeeldings-, XML- en ZIP-bestanden te uploaden, te analyseren, te corrigeren en te valideren.
• Toevoeging: ondertekend voorbeeld van het geüploade bestand.

Zie Een aankoopfactuur doorsturen.

Exports#

• Toevoeging: formaten PDF en XLSX voor alle exports, naast CSV, met de parameter format.
• Toevoeging: gedetailleerde catalogus in GET exports (veld catalog), pdf-voorbeeld via ondertekende URL en header X-Export-Fingerprint.
• Wijziging: het volledige dossier (exports/full-dossier/{fiscalYear}) bevat voortaan de pdf's, de CSV's, de CODA-bestanden, de stukken en een manifest.json in versie 2.

Zie Het volledige dossier exporteren.

Licentie, bedrijfsopzoeking, Peppol en integraties#

• Toevoeging: licentie van het kantoor, activering en vrijgave van een sleutel, publieke tarieftabel en simulator.
• Toevoeging: bedrijfsopzoeking lookup/*, bedrijfsfiches en referentielijsten van de rechtsvormen en de NACE-codes.
• Toevoeging: Peppol-registratie van een dossier, instelling van het transport, directory en Peppol-status van de derden.
• Toevoeging: catalogus van integraties per dossier, activering, test, synchronisatie en logboek van de uitvoeringen.
• Toevoeging: dagboekregels, bankregels, analytische codes, budgetten en aanmaningen van de derden.

4 oktober 2026#

Eerste versie van de API v1, gebruikt door de NovaFisko-applicaties.

• Toevoeging: authenticatie met token via auth/login, auth/me en auth/logout.
• Toevoeging: kantoren, team en toewijzing van de dossiers.
• Toevoeging: dossiers met initialisatie van het rekeningenstelsel, de dagboeken, de btw-codes en het boekjaar volgens het landenpakket (België, Frankrijk, Luxemburg).
• Toevoeging: stamgegevens (rekeningen, dagboeken, derden, btw-codes, boekjaren en periodes).
• Toevoeging: vrije boekingen, aankoop- en verkoopfacturen, tegenboeking.
• Toevoeging: documenten en bankverrichtingen geïmporteerd uit Novadesko, bankafpunting en CODA-bestanden.
• Toevoeging: vaste activa en afschrijvingsplannen.
• Toevoeging: btw-aangiften, Intervat-XML-bestand, klantenlisting en intracommunautaire opgave.
• Toevoeging: staten (proef- en saldibalans, grootboek, balans per periode, balans en resultatenrekening, balansen van de derden, ouderdomsbalans) en verrichtingen bij het einde van het boekjaar.
• Toevoeging: terugkerende boekingen en kwaliteitscontroles.
• Toevoeging: CSV-exports en volledig dossier in ZIP.

Op de hoogte blijven#

De changelog wordt bijgewerkt bij elke uitrol die de API raakt. De uitfaseringen worden bovendien gemeld via de headers Deprecation en Sunset, beschreven in het versiebeleid.

Zie ook#

• Versiebeleid
• Releasenotes van de applicatie
• API-referentie
• Overzicht van de API