Introduction à fiskaly

fiskaly fournit des API cloud de conformité fiscale pour les systèmes de caisse européens. Si votre logiciel gère des transactions en espèces ou par carte dans un pays soumis à des lois de signature fiscale, fiskaly gère la complexité réglementaire à votre place.

Cette page répond aux trois questions que chaque nouveau client pose : que fait fiskaly, quels produits me faut-il et quel est l’effort d’intégration.

💡Vous voulez juste écrire du code ?

Passez directement au Démarrage rapide — accès au sandbox et première transaction signée en moins de 5 minutes.

Ce que fait fiskaly

Les pays européens exigent que les caisses enregistreuses électroniques signent cryptographiquement les transactions, génèrent des exports prêts pour l’audit et, dans certains cas, transmettent des données aux autorités fiscales en temps réel. Les réglementations, les formats et les exigences de certification diffèrent selon les pays.

fiskaly remplace tout cela par une seule API REST :

1. Vous envoyez les données de transaction (montants, taux de TVA, type de paiement)
2. fiskaly les signe avec un module cryptographique certifié (TSS, SCU, etc.)
3. Vous recevez une signature à imprimer sur le reçu (souvent sous forme de QR code)
4. fiskaly conserve la piste d’audit et génère des exports conformes à la demande

Pas de matériel. Pas de modules cryptographiques locaux. Pas de dépôt manuel. L’infrastructure de signature fonctionne dans des centres de données cloud certifiés et est toujours à jour avec les évolutions réglementaires.

De quels produits avez-vous besoin ?

Cela dépend des pays dans lesquels vous opérez et de vos obligations. Voici le cadre décisionnel :

Question	Produit	Obligatoire ?
Traitez-vous des transactions POS en DE, AT, FR, ES, IT ou SE ?	Sign DE / AT / FR / ES / IT / SE (signature numérique, par pays)	Oui — obligatoire légalement
Opérez-vous en Allemagne ?	DSFinV-K (export fiscal)	Oui — obligatoire pour les audits
Opérez-vous en Allemagne ?	SUBMIT DE (déclaration ELSTER)	Oui — obligatoire depuis 2025
Opérez-vous en Allemagne ?	Management API (gestion org)	Optionnel
Devez-vous archiver des données fiscales pendant 10 à 30 ans ?	SAFE	Recommandé
Émettez-vous des factures B2B en Belgique (ou bientôt DE/FR/IT/PL) ?	E-Invoice	Oui (BE), à venir pour les autres
Voulez-vous remplacer les reçus papier ?	eReceipt	Optionnel

Point de départ le plus courant : SIGN DE + DSFINVK DE + SUBMIT DE pour une intégration POS uniquement en Allemagne. Cela couvre l’obligation légale complète.

📘Pour les chefs de produit

Consultez le Guide de planification de l’intégration pour les estimations d’effort, les exigences en matière d’équipe, les cartographies des dépendances et un modèle de calendrier de déploiement que vous pouvez adapter à votre feuille de route.

Comment fonctionne l’API (tous les produits)

Chaque produit fiskaly suit le même schéma d’intégration :

1. S'authentifier

   POST /auth avec votre clé et votre secret API. Vous recevez un token Bearer valable 24 heures et un token de rafraîchissement valable 48 heures.

2. Provisionner les ressources (une seule fois)

   Créez la ressource de signature pour votre pays : un TSS en Allemagne, une SCU en Autriche, une unité de signature en France/Italie/Espagne. Chaque ressource correspond à un emplacement physique ou à un terminal POS.

3. Signer les transactions

   Pour chaque transaction, utilisez PUT pour envoyer les données de transaction (état, montants, taux de TVA) à la ressource de signature. La réponse inclut une signature cryptographique.

4. Générer les exports

   À la demande ou selon un calendrier, déclenchez des exports de données conformes (DSFINVK DE, export TSS, archive) via l’API.

Deux architectures API

fiskaly propose deux architectures API, toutes deux activement supportées :

API Spécialisées (SIGN DE, SIGN AT, SIGN ES) — conçues sur mesure pour les réglementations d’un seul pays. Endpoints approfondis, optimisés et spécifiques à chaque pays avec des modèles de ressources dédiés.

API Unifiée (SIGN FR, SIGN IT, SIGN SE à venir) — un modèle de ressources partagé entre les pays. Intégrez une fois, ajoutez un autre pays en modifiant le schéma de payload.

	API Spécialisées	API Unifiée
Pays	Allemagne, Autriche, Espagne	France, Italie, Suède (à venir)
Gestion des orgs	Management API séparée	Intégrée dans l’API du produit
Ajouter un pays	Intégrer une API séparée	Modifier le schéma de payload
Idéal pour	Profondeur dans un seul pays	Expansion multi-pays

Consultez L’API Unifiée pour la comparaison complète, le modèle de ressources et le guide d’intégration.

Expansion multi-pays

Le chemin d’expansion dépend des pays que vous ajoutez :

• Ajouter un autre pays de l’API Unifiée (ex. FR + IT) : ~1 semaine. Mêmes URL de base, mêmes headers, même modèle de ressources — seule la section fiscalization du Taxpayer et le schéma de payload du Record changent.
• Ajouter une autre API Spécialisée (ex. DE + AT) : 1 à 3 semaines. Schémas similaires mais surfaces et endpoints API différents.
• Mélanger les architectures (ex. DE + FR) : Vous intégrez les deux. Elles partagent le même schéma d’authentification Bearer mais ont des modèles de ressources et des URL de base différents.

Environnements

fiskaly fournit deux environnements pour chaque produit :

Environnement	Objectif	Données	Facturation
TEST (Sandbox)	Développement et tests d’intégration	Éphémères — peuvent être réinitialisées	Gratuit
LIVE (Production)	Transactions réelles avec signatures réelles	Permanentes — pertinentes pour l’audit	Facturées selon contrat

Toutes les nouvelles organisations démarrent en TEST. Vous basculez en LIVE via le HUB après avoir terminé votre intégration.

⚠️TEST et LIVE sont séparés

Les ressources créées en TEST n’existent pas en LIVE. Prévoyez une étape de provisionnement dans votre checklist de mise en production.

Nos produits

SIGN DE (Allemagne)

KassenSichV — Cloud-TSS certifié BSI, valable jusqu'en 2033

SIGN AT (Autriche)

RKSV — signature cloud avec intégration FinanzOnline

SIGN FR (France)

NF525 — signature certifiée avec mode replay hors ligne

SIGN ES (Espagne)

TicketBAI et Verifactu — envoi XML en temps réel

SIGN IT (Italie)

Corrispettivi telematici — RT cloud avec loterie des reçus

SIGN SE (Suède)

InfraSec TCS — signature basée sur des certificats X.509

Prochaines étapes

Démarrage rapide (Développeurs)

Premier appel API en moins de 5 minutes. Sandbox, cURL et exemples multi-langages.

Planification de l'intégration (PM)

Estimations d'effort, exigences d'équipe, cartographies des dépendances et modèles de déploiement.

Référence API

Tous les endpoints des produits, URL de base, authentification et limites de fréquence.

Intégration IA et agents

Serveur MCP, endpoints lisibles par machine et bonnes pratiques pour les intégrations basées sur l'IA.