Facturino / Documentation / Changelog

Changelog

Toute évolution de l'API est documentée ici dès sa publication. La version active est annoncée dans le header Facturino-Version renvoyé sur chaque réponse. La politique de dépréciation (préavis 12 mois minimum, aucune suppression silencieuse) est détaillée dans Versions de l'API.

L'API est en pré-lancement. La version initiale 2026-03-01 sera publiée à l'ouverture du service. L'entrée ci-dessous récapitule la couverture du premier release. À partir de cette date, chaque version contractuelle apparaîtra ici en respectant la politique de dépréciation.

Versions

2026-03-01

À paraître
  • Ajouté Premier release public de l'API Facturino : 130 endpoints REST sous `/v1/*` couvrant la facturation électronique française (Factur-X EN 16931, CIUS-FR, e-reporting, cycle de vie DGFiP).
  • Ajouté Modèle BYOPA (Bring Your Own PA) : 4 Plateformes Agréées supportées en production + un connecteur générique AFNOR XP Z12-013.
  • Ajouté 4 SDKs officiels (Node, Python, PHP, Go) avec auto-pagination, retry exponentiel et types stricts.
  • Ajouté Format d'erreur stable inspiré de Stripe : `error.type`, `error.code`, `error.param`, `error.request_id`, `doc_url`, `hint`.
  • Ajouté Webhooks signés HMAC-SHA256 avec tolérance temporelle de 5 minutes, idempotence par `event_id` et retries exponentiels.
  • Ajouté Idempotence native via header `Idempotency-Key` sur les requêtes POST.
  • Ajouté Le header `Facturino-Version` est renvoyé sur toutes les réponses HTTP — annonce la version contractuelle utilisée pour traiter la requête.
  • Ajouté Endpoint `/v1/usage` exposant les compteurs de quota (factures, devis, requêtes API) en temps réel.
  • Ajouté Endpoint `/v1/billing/subscription` pour consulter le plan, la date de renouvellement et l'état de l'abonnement.

Comment être notifié des changements

  • Surveillez le header Facturino-Version renvoyé sur chaque réponse — il indique la version contractuelle utilisée pour traiter votre requête.
  • Surveillez le header Facturino-Version renvoyé par l'API et la page Versions de l'API : il n'existe pas d'évènement webhook de dépréciation. Toute dépréciation est annoncée dans le changelog et sur la page versioning, avec un préavis de 12 mois minimum.
  • Consultez régulièrement cette page : nous ne diffusons pas de notifications e-mail globales, mais chaque entrée du changelog liste précisément les endpoints et champs concernés.

Notre engagement

  • Préavis 12 mois minimum sur toute dépréciation.
  • Aucune suppression silencieuse : un champ ou endpoint déprécié reste fonctionnel jusqu'à sa date de retrait annoncée.
  • Aucun changement cassant sans nouvelle version contractuelle annoncée (voir Versioning).
  • Préservation du contrat : l'ajout d'un champ ou d'un endpoint n'est jamais un breaking change.