URL de base et environnements

Tous les produits fiskaly fournissent des environnements TEST et LIVE séparés. Les clés API générées dans un environnement ne fonctionnent qu’avec les ressources de cet environnement.

Produits SIGN

Produit	URL de base test	URL de base live	Chemin API
SIGN DE	https://kassensichv-middleware.fiskaly.com/api/v2	https://kassensichv.fiskaly.com/api/v2	/api/v2
SIGN AT	https://rksv.fiskaly.com/api/v1	https://rksv.fiskaly.com/api/v1	/api/v1
SIGN ES	https://test.es.sign.fiskaly.com/api/v1	https://live.es.sign.fiskaly.com/api/v1	/api/v1
SIGN IT	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Chemins versionnés
SIGN FR	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Chemins versionnés

Autres produits

Produit	URL de base test	URL de base live	Chemin API
DSFINVK DE	https://dsfinvk.fiskaly.com/api/v1	https://dsfinvk.fiskaly.com/api/v1	/api/v1
RECEIPT	https://receipt.fiskaly.com/api/v1	https://receipt.fiskaly.com/api/v1	/api/v1
E-INVOICE	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Chemins versionnés
HUB	https://hub.fiskaly.com/api/v0	https://hub.fiskaly.com/api/v0	/api/v0

Headers obligatoires

Tous les produits

Header	Valeur	Obligatoire
Authorization	Bearer <access_token>	Toutes les requêtes authentifiées
Content-Type	application/json	Toutes les requêtes avec body

API plus récentes (SIGN IT, SIGN FR, E-INVOICE)

Ces API partagent une plateforme commune et nécessitent des headers supplémentaires :

Header	Valeur	Obligatoire
X-Api-Version	2026-02-03 (actuel)	Toutes les requêtes
X-Idempotency-Key	UUIDv4	Toutes les requêtes POST et PATCH
X-Scope-Identifier	UUID organisation	Lors du ciblage d’une UNIT spécifique

SIGN ES

Header	Valeur	Obligatoire
Content-Type	application/json	Toutes les requêtes

📘Note

SIGN ES encapsule tous les corps de requêtes dans une enveloppe content : {"content": {...}}. Cela s’applique à l’authentification et à tous les appels API.

Comportement des environnements

⚠️LIVE est permanent

Les enregistrements créés dans l’environnement LIVE ont valeur légale. Les transactions dans SIGN DE sont signées par le TSS certifié BSI. Les enregistrements dans SIGN IT et SIGN FR sont transmis à l’autorité fiscale respective. Développez et testez toujours en TEST d’abord.

Comportement	TEST	LIVE
Envoi à l’autorité fiscale	Non	Oui
Validation de certification	Simulée	Réelle
Conservation des données	Standard	Selon les exigences légales
Limites de fréquence	Standard	Standard

💡Basculement d'environnement

Lorsque vous êtes prêt à passer en production, générez de nouvelles clés API dans l’environnement LIVE via le HUB. Consultez le guide Passer à LIVE pour les instructions étape par étape.

État du service

Surveillez tous les endpoints du service fiskaly sur status.fiskaly.com.