La Unified API de fiskaly est une architecture d’intégration unique qui couvre plusieurs pays. Intégrez-la une fois. Chaque nouveau pays ne nécessite que quelques petits ajustements de conformité spécifiques au pays, pas une réécriture de votre intégration.
| Pays | Produit | Groupe |
|---|---|---|
| 🇫🇷 France | SIGN FR | SIGN |
| 🇮🇹 Italie | SIGN IT | SIGN |
| 🇵🇹 Portugal | SIGN PT | SIGN |
| 🇸🇪 Suède | SIGN SE | SIGN |
| 🇪🇸 Espagne | SIGN ES Aperçu | SIGN |
| 🇦🇹 Autriche | SIGN AT Aperçu | SIGN |
| 🇧🇪 Belgique | E-INVOICE BE | E-INVOICE |
| 🇩🇪 Allemagne | E-INVOICE DE | E-INVOICE |
| 🇮🇹 Italie | E-INVOICE IT | E-INVOICE |
Documentation spécifique par pays
Section intitulée « Documentation spécifique par pays »La spécification API s’adapte à votre sélection de marché. Utilisez le sélecteur de pays en haut des pages de la spec pour choisir les marchés que vous intégrez — la documentation affiche alors exactement ce qui s’applique à votre sélection :
- Le texte sans drapeau est la base commune qui s’applique à tous les pays sélectionnés.
- Les blocs marqués d’un drapeau de pays (par exemple 🇮🇹 ou 🇫🇷) fournissent des informations supplémentaires spécifiques à ce pays — champs supplémentaires, comportement différent ou exigences additionnelles pour ce marché.
- Le bouton Download exporte un fichier OpenAPI adapté à votre sélection actuelle.
Le même principe de guidance spécifique par pays se retrouve dans les guides de cette section — chaque groupe de pays dans la barre latérale couvre les spécificités de son marché.
URL de base
Section intitulée « URL de base »| Environnement | URL |
|---|---|
| Test | test.api.fiskaly.com |
| Live | live.api.fiskaly.com |
Headers requis
Section intitulée « Headers requis »| Header | Description |
|---|---|
X-Api-Version | Date de version de l’API, ex. 2026-06-01 |
X-Scope-Identifier | ID de l’Organization |
X-Idempotency-Key | UUIDv4 — requis sur chaque POST et PATCH |
Authorization | Bearer <access_token> |
Versionnement
Section intitulée « Versionnement »La Unified API utilise un versionnement basé sur le calendrier (YYYY-MM-DD). La dernière version est 2026-06-01.
| Version | SIGN | E-INVOICE |
|---|---|---|
2026-06-01 | FR, IT, PT, SE, ES, AT | BE, DE, IT |
2026-05-04 | FR, IT, PT | BE, DE |
2026-02-03 | FR, IT | BE, DE |
vs. API Spécialisées
Section intitulée « vs. API Spécialisées »| Unified API | API Spécialisées | |
|---|---|---|
| Pays | FR, IT, PT, SE, ES1, AT1, BE2, DE2 | DE, AT, ES |
| URL de base | Partagée entre les pays | Spécifique au produit |
| ID des ressources | Générés par le serveur | UUID générés par le client |
| Gestion de l’organisation | Intégrée à l’API | API de gestion séparée |
| Ajouter un pays | Ajustements de schéma mineurs | Nouvelle intégration requise |
1 disponible via les deux API · 2 e-invoice uniquement
SIGN DE est une API Spécialisée. L’intégration à la Unified API est déjà en cours. La facturation électronique pour l’Allemagne fait déjà partie de la Unified API.