Guide d'intégration RECEIPT

Guide d’intégration RECEIPT

Ce guide vous explique comment intégrer l’API fiskaly RECEIPT pour remplacer les reçus papier par des reçus numériques légalement conformes dans tous les pays de l’UE.

📘Spécification API détaillée

Pour la référence API complète incluant tous les endpoints, schémas et paramètres, consultez la documentation de l’API RECEIPT. Ce guide couvre le flux d’intégration conceptuel.

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Une organisation fiskaly avec RECEIPT activé (contactez sales@fiskaly.com ou votre gestionnaire de compte)
• Des identifiants API (clé API et secret) pour le service RECEIPT
• Un système de caisse ou une application capable d’effectuer des requêtes HTTPS

Vue d’ensemble de l’intégration

Le flux RECEIPT fonctionne en trois phases :

1. Créer — Votre système de caisse envoie les données de transaction à l’API RECEIPT
2. Livrer — L’API génère un reçu numérique et retourne un mécanisme de livraison (QR code, lien, etc.)
3. Présenter — Le client reçoit le reçu via son canal préféré

Intégration étape par étape

1. S'authentifier

   Obtenez un token d’accès en utilisant vos identifiants de l’API RECEIPT :

   curl -X POST https://receipt.fiskaly.com/api/v1/auth \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "api_secret": "YOUR_API_SECRET"
     }'

   La réponse inclut un access_token valable 24 heures. Incluez-le comme token Bearer dans toutes les requêtes suivantes.

2. Configurer le profil commerçant

   Configurez les informations de votre commerçant qui apparaîtront sur tous les reçus générés :

   • Nom de l’entreprise et forme juridique
   • Adresse et informations de contact
   • Numéros d’identification fiscale
   • Logo (optionnel)
   • Préférences de personnalisation des reçus
3. Créer un reçu

   Après chaque transaction, envoyez les données du reçu à l’API RECEIPT :

   curl -X POST https://receipt.fiskaly.com/api/v1/receipts \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "items": [
         {
           "description": "Product A",
           "quantity": 2,
           "unit_price": 1299,
           "vat_rate": "19.00"
         }
       ],
       "payment": {
         "method": "card",
         "amount": 2598
       }
     }'

   Les montants sont exprimés dans la plus petite unité monétaire (centimes).

4. Présenter le reçu au client

   La réponse de l’API inclut des options de livraison :

   • QR Code — Afficher sur l’écran du système de caisse ou imprimer un petit QR code que le client peut scanner
   • Code statique — Un code persistant lié au commerçant pour les clients réguliers
   • Lien direct — Une URL que le client peut ouvrir dans n’importe quel navigateur

   Le client consulte son reçu sur receipt.fiskaly.com — aucun téléchargement d’application requis.

5. Connecter avec fiskaly SIGN (optionnel)

   Si vous utilisez fiskaly SIGN pour la conformité fiscale, RECEIPT peut automatiquement lier les reçus aux transactions signées. Cela fournit :

   • Inclusion automatique des données de signature fiscale sur le reçu numérique
   • Support de validation par QR code
   • Piste d’audit complète de la transaction à la livraison du reçu

Canaux de livraison

Canal	Comment ça fonctionne	Idéal pour
QR Code	Le client scanne un QR code affiché à l’écran ou imprimé	Système de caisse en magasin, service rapide
Code statique	QR code persistant lié à l’emplacement du commerçant	Présentoirs au comptoir, chevalets de table
E-mail	Reçu envoyé directement à l’e-mail du client	E-commerce, réservations
Lien	URL partageable vers le reçu hébergé	Tout canal de livraison

💡Aucune application requise

RECEIPT fonctionne entièrement via le web. Les clients consultent leurs reçus dans leur navigateur sur receipt.fiskaly.com — aucun téléchargement d’application, création de compte ou inscription nécessaire.

Conformité

Les reçus numériques générés par RECEIPT sont légalement conformes dans tous les pays de l’UE :

• Répond aux exigences des documents électroniques selon la Directive TVA de l’UE
• Conforme aux obligations spécifiques à chaque pays en matière de reçus (Allemagne, Autriche, France, etc.)
• Sécurité des données garantie par la certification ISO 27001 de fiskaly
• Les reçus sont immuables une fois créés — la piste d’audit complète est maintenue

Essayez maintenant

Créez un reçu de démonstration pour voir l’expérience client avant d’intégrer.

Ressources

Pour des informations techniques plus détaillées, téléchargez le guide d’intégration complet :

• Guide d’intégration (PDF) — Référence API complète avec des exemples de requête/réponse
• Référence API RECEIPT — Spécification OpenAPI complète
• Démarrage rapide — Configuration minimale pour créer votre premier reçu
• FAQ — Questions fréquentes sur RECEIPT