Journal des modifications de l'API

Ce journal recense les évolutions de l'API v1, de la plus récente à la plus ancienne. Les règles qui encadrent ces évolutions sont décrites dans la politique de version.

Chaque entrée est classée ainsi :

5 octobre 2026#

Ouverture de l'API aux intégrations tierces.

Jetons d'intégration#

• Ajout : GET /v1/auth/tokens, POST /v1/auth/tokens et DELETE /v1/auth/tokens/{token} pour créer, lister et révoquer des jetons d'intégration.
• Ajout : capacités read, write et sync, expiration facultative de 1 à 730 jours, date de dernière utilisation.
• Ajout : erreurs 403 token_ability_missing (avec required_ability) et session_token_required, erreur 422 token_limit_reached.

Voir Authentification.

Webhooks#

• Ajout : points de réception par cabinet avec GET, POST, PATCH et DELETE /v1/firms/{firm}/webhooks.
• Ajout : envoi de test POST .../webhooks/{webhook}/test et journal GET .../webhooks/{webhook}/deliveries.
• Ajout : catalogue GET /v1/webhooks/events.
• Ajout : événements 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 et webhook.test.
• Ajout : signature HMAC-SHA256 dans l'en-tête X-Novafisko-Signature, en-têtes X-Novafisko-Event et X-Novafisko-Delivery.
• Ajout : 8 tentatives de livraison avec délai croissant de 1 à 64 minutes.

Voir Webhooks et Vérifier les signatures.

Mode démonstration#

• Ajout : POST /v1/auth/demo ouvre une session de démonstration sans compte, valable 24 heures, sur un cabinet fictif réinitialisé chaque nuit.
• Ajout : champ is_demo dans la réponse de GET /v1/auth/me.
• Ajout : erreur 403 demo_mode sur les effets externes et erreur 503 demo_unavailable.

Voir Vue d'ensemble.

Documentation#

• Ajout : spécification OpenAPI 3.1 en JSON et en YAML, collection Postman et référence interactive.
• Ajout : guides d'intégration et cas d'usage pas à pas.

Historique et synchronisation#

• Ajout : historique des modifications avec GET history, détail d'une révision et historique par enregistrement.
• Ajout : retour en arrière d'une révision ou d'une opération complète avec POST history/{revision}/revert et POST history/operations/{operation}/revert.
• Ajout : corbeille avec GET trash, restauration et purge définitive. Les suppressions existantes placent désormais l'enregistrement dans la corbeille et répondent avec l'en-tête X-Trashed: 1.
• Ajout : synchronisation hors ligne avec sync/bootstrap, sync/pull, sync/push, sync/status et sync/conflicts.
• Ajout : idempotence des écritures avec X-Client-Mutation-Id et réponse X-Idempotent-Replay: 1.
• Ajout : verrou optimiste avec X-Base-Version et réponse 409 conflict.
• Ajout : champ version sur les ressources suivies par l'historique.
• Ajout : journal d'activité GET activity par dossier et GET /v1/firms/{firm}/activity par cabinet.
• Ajout : sonde GET /v1/ping. Toute réponse 503 porte désormais un code.

Voir Idempotence et Synchroniser en continu.

Importateur de documents#

• Ajout : document-imports pour déposer des fichiers PDF, image, XML et ZIP, les analyser, les corriger et les valider.
• Ajout : aperçu signé du fichier déposé.

Voir Pousser une facture d'achat.

Exports#

• Ajout : formats PDF et XLSX pour tous les exports, en plus du CSV, avec le paramètre format.
• Ajout : catalogue détaillé dans GET exports (champ catalog), aperçu PDF par URL signée et en-tête X-Export-Fingerprint.
• Changement : le dossier complet (exports/full-dossier/{fiscalYear}) contient désormais les PDF, les CSV, les fichiers CODA, les pièces et un manifest.json en version 2.

Voir Exporter le dossier complet.

Licence, détection d'entreprise, Peppol et intégrations#

• Ajout : licence du cabinet, activation et libération d'une clé, grille tarifaire publique et simulateur.
• Ajout : détection d'entreprise lookup/*, fiches d'entreprise et référentiels des formes juridiques et des codes NACE.
• Ajout : inscription Peppol d'un dossier, réglage du transport, annuaire et statut Peppol des tiers.
• Ajout : catalogue d'intégrations par dossier, activation, test, synchronisation et journal des exécutions.
• Ajout : règles de journaux, règles bancaires, codes analytiques, budgets et relances des tiers.

4 octobre 2026#

Première version de l'API v1, utilisée par les applications NovaFisko.

• Ajout : authentification par jeton avec auth/login, auth/me et auth/logout.
• Ajout : cabinets, équipe et attribution des dossiers.
• Ajout : dossiers avec initialisation du plan comptable, des journaux, des codes TVA et de l'exercice selon le pack pays (Belgique, France, Luxembourg).
• Ajout : référentiels (comptes, journaux, tiers, codes TVA, exercices et périodes).
• Ajout : écritures libres, factures d'achat et de vente, extourne.
• Ajout : documents et mouvements bancaires importés de Novadesko, rapprochement bancaire et fichiers CODA.
• Ajout : immobilisations et plans d'amortissement.
• Ajout : déclarations TVA, fichier Intervat XML, listing clients et relevé intracommunautaire.
• Ajout : états (balance, grand livre, balance par période, bilan et compte de résultats, balances des tiers, balance âgée) et opérations de fin d'exercice.
• Ajout : écritures récurrentes et contrôles de qualité.
• Ajout : exports CSV et dossier complet en ZIP.

Rester informé#

Le journal est mis à jour à chaque déploiement qui touche l'API. Les dépréciations sont en outre signalées par les en-têtes Deprecation et Sunset décrits dans la politique de version.

Voir aussi#

• Politique de version
• Notes de version de l'application
• Référence de l'API
• Vue d'ensemble de l'API