Guide d'intégration SAFE

Guide d’intégration — fiskaly SAFE

fiskaly SAFE fournit un archivage automatique des données fiscales provenant des services fiskaly connectés (SIGN DE, SIGN AT, DSFinV-K, etc.) sans nécessiter de téléversements manuels ni d’appels API directs. L’archivage est configuré et géré via le fiskaly HUB.

📘SAFE vs SAFE flex

Ce guide couvre SAFE (archivage automatique géré par le HUB). Si vous avez besoin d’un contrôle API total sur ce qui est archivé et quand, consultez plutôt le Guide d’intégration SAFE flex. Pour une comparaison, voir SAFE vs SAFE flex.

Prérequis

Avant de commencer, assurez-vous de disposer de :

• Une organisation fiskaly active avec au moins un service connecté (p. ex., SIGN DE, DSFinV-K)
• L’accès au fiskaly HUB avec des permissions d’administrateur
• Un environnement LIVE ou TEST avec un TSS actif ou des données fiscales

Fonctionnement de SAFE

SAFE archive automatiquement les exports de vos services fiskaly connectés selon un calendrier que vous configurez dans le HUB. Le processus est entièrement géré :

1. fiskaly génère des exports depuis vos services connectés (exports TSE, clôtures DSFinV-K, etc.)
2. SAFE archive les données dans un stockage cloud certifié dans la juridiction légalement requise
3. Les données restent consultables et exportables pour les audits (niveaux d’accès Z1, Z2, Z3)

Aucune modification du code n’est nécessaire dans votre intégration de caisse enregistreuse — SAFE se connecte à vos services fiskaly existants.

Configuration via le fiskaly HUB

1. Se connecter au HUB

   Rendez-vous sur hub.fiskaly.com et connectez-vous avec les identifiants de votre organisation. Sélectionnez l’organisation pour laquelle vous souhaitez configurer SAFE.

2. Activer SAFE

   Allez dans Services > SAFE dans la navigation du HUB. Cliquez sur Activer SAFE pour activer l’archivage automatique pour votre organisation. Il vous sera demandé de sélectionner votre emplacement de stockage (pays) en fonction de vos exigences légales.

3. Configurer le calendrier d'archivage

   Choisissez la fréquence d’export pour l’archivage automatique :

   Fréquence	Idéal pour
   Quotidienne	Les opérations à fort volume nécessitant des archives quasi en temps réel
   Hebdomadaire	Les opérations de commerce de détail standard
   Mensuelle	Les opérations à faible volume ou les activités saisonnières

   Le calendrier détermine la fréquence à laquelle SAFE récupère les nouveaux exports de vos services connectés et les archive.

4. Sélectionner les services connectés

   Choisissez quels services fiskaly doivent alimenter SAFE :

   • SIGN DE — Archive les exports de transactions TSE
   • SIGN AT — Archive les exports RKSV/DEP
   • DSFinV-K — Archive les exports de clôture de point de vente
   • Des services supplémentaires au fur et à mesure qu’ils deviennent disponibles

   Chaque service est activé indépendamment. Vous pouvez ajouter ou supprimer des services à tout moment.

5. Vérifier la première archive

   Après la première exécution planifiée, vérifiez la section SAFE > Archives dans le HUB. Vous devriez voir :

   • Des entrées d’archive avec horodatages et service source
   • Le nombre de fichiers et le stockage total utilisé
   • Des indicateurs de statut (Traité, En attente, Échoué)

   Si la première archive se termine avec succès, SAFE est pleinement opérationnel.

💡Tester d'abord dans l'environnement de test

Configurez et testez SAFE dans votre environnement TEST avant de l’activer en LIVE. Le comportement est identique, mais vous pouvez vérifier le flux d’archivage sans affecter les données de production.

Accès aux données archivées

Via le HUB

1. Allez dans SAFE > Archives dans le HUB
2. Utilisez les filtres pour affiner par plage de dates, service ou statut d’archive
3. Cliquez sur n’importe quelle entrée d’archive pour afficher les détails et télécharger les fichiers
4. Utilisez le bouton Exporter pour télécharger les archives en masse (format ZIP)

Via l’API

Les données archivées sont également accessibles via l’API SAFE pour un accès programmatique :

# Lister les archives de votre organisation
curl -X GET "https://safe.fiskaly.com/api/v0/archives" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Télécharger une archive spécifique
curl -X GET "https://safe.fiskaly.com/api/v0/archives/{archive_id}/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o archive.zip

Pour la documentation API complète, consultez la Référence API SAFE.

Support pour les audits

SAFE prend en charge trois niveaux d’accès pour les audits tels que définis par les autorités fiscales allemandes (et des exigences analogues dans d’autres pays) :

Niveau d’accès	Description	Comment SAFE aide
Z1 — Accès direct	L’auditeur accède directement au système	Fournir à l’auditeur un accès en lecture seule via le HUB
Z2 — Accès indirect	Le contribuable fournit les données sur demande de l’auditeur	Exporter depuis SAFE et remettre à l’auditeur
Z3 — Support de données	Export lisible par machine sur support de stockage	Télécharger les archives SAFE dans des formats standards

Conservation et conformité

• Les données archivées sont conservées pendant la période de conservation légalement requise (généralement 10 ans en Allemagne, 7 ans en Autriche)
• L’emplacement de stockage est déterminé par le pays configuré lors de l’activation
• Les données sont stockées de manière inaltérable dans des centres de données certifiés Google Cloud
• Un journal d’audit complet de toutes les opérations d’archivage est maintenu

⚠️Responsabilité de conservation

Bien que SAFE gère l’archivage technique, vous restez responsable de vous assurer que votre calendrier d’archivage capture toutes les données légalement requises. Consultez votre conseiller fiscal pour les exigences de conservation spécifiques à votre juridiction.

Résolution des problèmes

Problème	Cause	Résolution
Aucune archive n’apparaît	Le calendrier n’a pas encore été déclenché	Attendez la prochaine exécution planifiée, ou déclenchez une archive manuelle depuis le HUB
Statut d’archive « Échoué »	Le service source n’a pas de nouvelles données, ou la génération d’export a échoué	Vérifiez le statut du service connecté dans le HUB ; vérifiez que le TSS est actif
Données manquantes dans l’archive	La portée d’export n’inclut pas la plage de dates attendue	Vérifiez que le calendrier d’archivage couvre la période ; recherchez les lacunes dans les données source

Prochaines étapes

Guide SAFE flex

Contrôle API complet pour les flux d'archivage personnalisés

Détails de conformité

Exigences légales d'archivage par pays

Configuration HUB SAFE

Configuration détaillée du HUB pour SAFE