Allemagne (SIGN DE)

📘API spécialisée

SIGN DE est une API spécialisée — conçue spécifiquement pour la conformité allemande KassenSichV, certifiée BSI et le produit le plus mature de fiskaly. Elle utilise une surface d’API dédiée avec ses propres endpoints et son propre modèle de ressources. Pour l’architecture d’API unifiée multi-pays (couvrant la France, l’Italie, la Suède), consultez L’API unifiée.

Ce que vous devez savoir

L’Allemagne possède les exigences de conformité fiscale les plus complètes de tous les pays pris en charge par fiskaly. Une intégration allemande complète nécessite trois produits fonctionnant ensemble :

Produit	Fonction	Obligatoire ?
SIGN DE	Signe cryptographiquement chaque transaction via un Cloud-TSS certifié BSI	Oui — KassenSichV
DSFINVK DE	Génère des exports de données fiscales prêts pour l’audit à partir des clôtures de caisse	Oui — pour les audits fiscaux
SUBMIT DE	Dépose des déclarations électroniques à ELSTER (interface de l’autorité fiscale allemande)	Oui — depuis 2025
SAFE	Archive les données fiscales pendant 10–30 ans dans des centres de données certifiés	Recommandé

💡Nouveau sur fiskaly ?

Commencez par le Démarrage rapide pour obtenir une transaction signée en 5 minutes. Revenez ici pour le tableau complet.

Qu’est-ce que KassenSichV ?

La Kassensicherungsverordnung (KassenSichV) exige que tous les systèmes d’enregistrement électroniques (ERS) en Allemagne :

• Utilisent un système de sécurité technique (TSS) certifié pour signer chaque transaction
• Maintiennent des pistes d’audit infalsifiables avec des signatures cryptographiques
• Génèrent des exports DSFinV-K pour les auditeurs fiscaux
• Impriment des codes QR sur les reçus contenant les données de signature

Le Cloud-TSS de fiskaly est le premier TSS basé sur le cloud à avoir obtenu la certification BSI, actuellement valable jusqu’en 2033. Pas de matériel, pas de modules cryptographiques locaux — uniquement des appels API.

Effort d’intégration

Pour les chefs de produit estimant le travail :

Phase	Durée	Ce qui se passe
Configuration sandbox	1–2 jours	Création de compte, clés API, première transaction signée
Intégration SIGN DE	3–5 semaines	Provisionnement TSS, signature de transactions, codes QR sur reçus, gestion des erreurs
Intégration DSFINVK DE	2–3 semaines	Mapper le modèle de données POS à la taxonomie DSFINVK DE, implémenter les clôtures de caisse
Intégration SUBMIT DE	1–2 semaines	Enregistrement du contribuable, dépôt des déclarations
Tests de bout en bout	1–2 semaines	Validation complète du flux en sandbox
Mise en production	1 semaine	Provisionnement LIVE, déploiement progressif, configuration du monitoring
Total	8–13 semaines	1–2 développeurs backend avec expérience dans le domaine POS

Consultez le Guide de planification d’intégration pour les exigences d’équipe, les cartes de dépendances et un modèle de calendrier de déploiement.

Aperçu de l’architecture

Votre système de caisse
  |
  |-- POST /auth (clé API + secret) --> Token Bearer (24h)
  |
  |-- PUT /tss/{id} -----------------> Créer + initialiser le TSS (une fois par emplacement)
  |-- PUT /tss/{id}/client/{id} -----> Créer un client (un par terminal POS)
  |
  |-- PUT /tss/{id}/tx/{id} ---------> Démarrer une transaction (état : ACTIVE)
  |-- PUT /tss/{id}/tx/{id} ---------> Terminer une transaction (état : FINISHED)
  |                                     La réponse inclut la signature + les données du code QR
  |
  |-- POST /dsfinvk/closings --------> Soumettre les données de clôture de caisse
  |-- GET  /dsfinvk/exports  --------> Générer le fichier d'export DSFinV-K
  |
  |-- POST /submission/submit -------> Déposer une déclaration à ELSTER

Responsabilités

Votre responsabilité (fournisseur de système de caisse)

• Intégrer le TSS fiskaly dans votre ERS
• S’assurer que chaque transaction est signée avant la génération du reçu
• Imprimer des codes QR contenant les données de signature sur les reçus
• Générer les clôtures de caisse DSFINVK DE en fin de journée
• Déposer les déclarations via SUBMIT DE
• Gérer les délais d’expiration correctement (voir gestion des erreurs)

Responsabilité de votre client (contribuable)

• Disposer d’un ERS avec TSS intégré rattaché à son compte
• Livrer les exports TSS et DSFinV-K aux auditeurs dans les délais requis
• Maintenir des sauvegardes des données fiscales (conservation de 10–30 ans, deux emplacements physiques recommandés)

Responsabilité de fiskaly

• Exploiter et maintenir le Cloud-TSS certifié (SLA de disponibilité 99,9 %)
• Fournir des mises à jour logicielles et des correctifs de sécurité (gratuitement)
• Gérer les renouvellements de certification
• Maintenir la disponibilité et les performances de l’API

Liste de vérification de conformité pour la mise en production

Avant de lancer en production, vérifiez :

• Pour chaque emplacement/boutique, assurez-vous d’avoir un TSS individuel créé, défini sur UNINITIALIZED, PIN administrateur défini et TSS défini sur INITIALIZED
• Client créé pour chaque terminal POS
• Chaque transaction est signée (cycle de vie démarrage + finalisation)
• Le reçu inclut le code QR KassenSichV (référence de format)
• Le code QR se valide correctement (outil de validation)
• Les clôtures de caisse DSFINVK DE se génèrent avec succès
• La déclaration SUBMIT DE est acceptée par ELSTER
• Le délai d’expiration de la signature est de 3–5 secondes et ne bloque pas le processus de paiement
• La logique de nouvelle tentative gère les erreurs 5xx avec un backoff exponentiel
• L’administrateur est déconnecté après le provisionnement
• L’environnement LIVE est provisionné séparément du TEST

⚠️Une signature manquante n'invalide pas un reçu

Si le TSS est indisponible, émettez le reçu avec une note telle que “TSS non disponible” et incluez la transaction non signée dans votre export DSFinV-K. Voir gestion des erreurs pour plus de détails.

Documentation

Pour commencer

Introduction

Contexte KassenSichV, acquisition de Deutsche Fiskal, détails de certification

Guide pour les nouveaux clients

Étape par étape : configuration du compte jusqu'à la première transaction signée avec des exemples de code

Détails techniques

Architecture TSS, flux de données des transactions et processus de signature cryptographique

Guides

Gestion des erreurs

Stratégie de délai d'expiration, logique de nouvelle tentative et que faire quand le TSS est indisponible

Tutoriel Postman

Exploration interactive de l'API — sans code requis

Manuel du tableau de bord

Gérer les organisations, les clés API et les TSS via l'interface web

Conformité

Données du reçu

Champs obligatoires du reçu et spécification du contenu du code QR

Validation du code QR

Valider que vos codes QR sont conformes à KassenSichV

Certification

Documents de certification BSI et périodes de validité

Produits associés

DSFINVK DE

Export de données fiscales — obligatoire pour l'Allemagne, référence les données SIGN DE

SUBMIT DE

Déclaration ELSTER — obligatoire pour l'Allemagne depuis 2025

SAFE

Archivage à long terme des exports fiscaux (recommandé)

Référence

Référence API (SIGN DE v2)

Documentation interactive des endpoints avec tous les schémas

Glossaire

Termes KassenSichV : TSS, ERS, DSFinV-K et plus

Support

Comment obtenir de l'aide, collections d'exemples et canaux de contact