.png)
API Fidly · v1.0
Connectez vos outils à Fidly.
Boutique en ligne, CRM, caisse, ERP ou application métier : l'API Fidly crée vos factures, les envoie via Peppol, importe vos documents et synchronise vos tiers. Fini la double saisie, votre facturation légale reste centralisée dans Fidly.
✓ API REST en JSON
✓ OAuth2, droits par ressource
✓ Sandbox isolée
✓ Envoi Peppol par API
En bref
01
Vos logiciels parlent à Fidly, automatiquement.
L'API Fidly permet à votre logiciel, ou à celui d'un partenaire, de lire et d'écrire les données de votre entreprise : documents, tiers, comptes bancaires, journaux et identités visuelles. Ce que vous faites dans l'application, votre code peut le faire aussi.
01
Facturer depuis vos outils
Une vente dans votre boutique ou votre CRM crée la facture dans Fidly et l'envoie via Peppol.
02
Importer vos documents
PDF, images ou XML Peppol : Fidly les analyse comme un glisser-déposer.
03
Synchroniser vos données
Clients, fournisseurs, adresses de livraison, comptes et journaux, sans double saisie.
04
Suivre les statuts
Paiement, envoi Peppol, transmission au comptable : tout se lit en temps réel.
Démarrer
02
Quatre étapes jusqu'à votre première facture par API.
1
Créez une clé
Paramètres, onglet API : libellé, environnement (production ou sandbox), durée de validité et permissions.
2
Obtenez un jeton
Votre client_id et votre client_secret s'échangent contre un jeton d'accès valable une heure, renouvelable.
3
Testez en sandbox
Des données de démonstration, les mêmes validations et codes d'erreur qu'en production, sans rien modifier.
4
Passez en production
Une clé de production, et votre intégration travaille sur vos vraies données.
Créer et envoyer via Peppol, en un appel
POST https://api.fidly.be/documents?send_peppol=true
Authorization: Bearer eyJhbGciOi…
{
"type": "sale_invoice",
"relation_id": "8f3c2a…",
"lines": [{
"item_name": "Conseil",
"quantity": 4,
"unit_price": 95,
"vat_code": "standard",
"vat_rate": 21
}]
}
→ 201 : numéro, TVA, totaux et communication structurée calculés par Fidly
Ce que couvre l'API
03
L'étendue de l'API, ressource par ressource.
01
Documents
Lire · créer · modifier · supprimer
–
Types
Factures et notes de crédit de vente, auto-facturation, proformas, et tous les documents reçus (Peppol, e-mail, dépôt…).
Création
Vous donnez le tiers et les lignes (jusqu'à 500) ; Fidly calcule numéro, TVA, totaux, échéance et communication structurée.
TVA
Taux normal, exonération, 0 %, autoliquidation, intracommunautaire, export, non assujetti. Remises et majorations par ligne ou par document.
Envoi Peppol
À la création ou ensuite, avec suivi du statut : envoyé, accepté, refusé. Un envoi en échec se relance.
Fichiers
Téléchargement du PDF et du XML UBL, pièces jointes (PDF, images, CSV, tableurs), import de documents analysés automatiquement.
Paiements
Enregistrement d'un encaissement que Fidly ne voit pas (espèces, compte non suivi), même sur un document déjà envoyé.
Garde-fous
Un document envoyé ou transmis au comptable ne se modifie plus ; seul le dernier numéro d'une séquence se supprime.
02
Relations
Lire · créer · modifier · supprimer
–
Sociétés et contacts
Une seule ressource pour vos clients et fournisseurs, avec adresse, langue, numéro de TVA et identifiant Peppol.
Doublons
Une société déjà connue (même TVA, identifiant ou adresse Peppol) est signalée plutôt que dupliquée.
Adresses de livraison
Enregistrées sur le tiers et réutilisables sur ses documents, avec leur identifiant Peppol (GLN).
03
Comptes bancaires
Lire · créer · modifier
–
Lecture
Comptes connectés (PSD2), issus des extraits CODA ou manuels, avec leur solde quand Fidly le synchronise.
Gestion
Création de comptes manuels (IBAN vérifié) et choix du compte par défaut affiché sur les documents.
04
Journaux
Lire · créer · modifier
–
Numérotation
Format libre (code, année, mois, exercice fiscal, compteur) et remise à zéro mensuelle, annuelle ou par exercice.
Journal par défaut
Un par catégorie (ventes, notes de crédit, achats, entrants) ; il reçoit les documents créés sans journal précisé.
05
Brandings et listes de référence
Lecture
–
Brandings
Les identités visuelles de vos documents, et le choix de celle par défaut.
Références
Unités, devises et pays, traduits en français, néerlandais, anglais et allemand.
06
Sécurité et conventions
Pour vos développeurs
–
Authentification
OAuth2 client credentials, jeton d'une heure, refresh token à usage unique. Secrets stockés hachés chez Fidly.
Clés
Jusqu'à 10 clés actives, validité de 30 jours à 1 an ou illimitée, révocables immédiatement.
Permissions
Créer, lire, modifier, supprimer : chaque action s'autorise ressource par ressource.
Conventions
JSON, listes paginées et filtrables, requêtes tout ou rien, erreurs avec un code lisible et un identifiant de requête pour le support.
Bon à savoir
04
Avant de vous lancer.
Formule
L'API est incluse dans la formule Growth
Avec les prestations, les rappels automatiques et les campagnes e-mail. Une clé sandbox suffit pour développer et tester votre intégration.
À savoir
L'API va plus loin que l'application
Elle accepte des combinaisons que l'interface n'affiche pas, comme des taux de TVA hors taux belges ou plusieurs remises par ligne. L'envoi par e-mail n'est pas encore disponible par API : l'envoi se fait via Peppol.
FAQ
05
Questions sur l'API.
Quelle formule inclut l'API ?
La formule Growth. Vous pouvez créer une clé sandbox pour développer et tester votre intégration avant de passer en production.
Comment obtenir mes clés ?
Dans vos paramètres, onglet API, bouton « Nouvelle clé ». Le client secret n'est affiché qu'une seule fois : conservez-le en lieu sûr.
Puis-je tester sans toucher à mes données ?
Oui. Une clé sandbox travaille sur des données de démonstration, avec exactement les mêmes validations et codes d'erreur qu'en production, mais rien n'est enregistré.
Puis-je envoyer mes factures via Peppol par l'API ?
Oui, à la création ou plus tard, et vous suivez le statut d'envoi jusqu'à l'acceptation par le destinataire. L'envoi par e-mail n'est pas encore disponible via l'API.
Comment limiter ce qu'une intégration peut faire ?
Chaque clé a ses propres permissions (créer, lire, modifier, supprimer) par ressource, une durée de validité, et se révoque à tout moment depuis l'interface.
Quelle formule inclut l'API ?
La formule Growth. Vous pouvez créer une clé sandbox pour développer et tester votre intégration avant de passer en production.
Comment obtenir mes clés ?
Dans vos paramètres, onglet API, bouton « Nouvelle clé ». Le client secret n'est affiché qu'une seule fois : conservez-le en lieu sûr.
Puis-je tester sans toucher à mes données ?
Oui. Une clé sandbox travaille sur des données de démonstration, avec exactement les mêmes validations et codes d'erreur qu'en production, mais rien n'est enregistré.
Puis-je envoyer mes factures via Peppol par l'API ?
Oui, à la création ou plus tard, et vous suivez le statut d'envoi jusqu'à l'acceptation par le destinataire. L'envoi par e-mail n'est pas encore disponible via l'API.
Comment limiter ce qu'une intégration peut faire ?
Chaque clé a ses propres permissions (créer, lire, modifier, supprimer) par ressource, une durée de validité, et se révoque à tout moment depuis l'interface.
Quelle formule inclut l'API ?
La formule Growth. Vous pouvez créer une clé sandbox pour développer et tester votre intégration avant de passer en production.
Comment obtenir mes clés ?
Dans vos paramètres, onglet API, bouton « Nouvelle clé ». Le client secret n'est affiché qu'une seule fois : conservez-le en lieu sûr.
Puis-je tester sans toucher à mes données ?
Oui. Une clé sandbox travaille sur des données de démonstration, avec exactement les mêmes validations et codes d'erreur qu'en production, mais rien n'est enregistré.
Puis-je envoyer mes factures via Peppol par l'API ?
Oui, à la création ou plus tard, et vous suivez le statut d'envoi jusqu'à l'acceptation par le destinataire. L'envoi par e-mail n'est pas encore disponible via l'API.
Comment limiter ce qu'une intégration peut faire ?
Chaque clé a ses propres permissions (créer, lire, modifier, supprimer) par ressource, une durée de validité, et se révoque à tout moment depuis l'interface.
Bonjour je suis Chloé,
Une question sur Fidly, ses fonctionnalités ou sa mise en place ? Je suis là pour vous conseiller et vous accompagner.
Échanger avec nousUne question sur Fidly, ses fonctionnalités ou sa mise en place ? Je suis là pour vous conseiller et vous accompagner.