API REST

Une API, quelques lignes de code.

Un POST JSON pour émettre, un webhook pour recevoir. ediflo convertit en Factur-X / CII / UBL, valide et transmet à la PDP, vous gardez votre logiciel.

Obtenir ma clé API Documentation
Émission : POST /v1/invoices Réception : webhook
bash, ediflo API
$ curl -X POST api.ediflo.io/v1/invoices
-H "Authorization: Bearer sk_live_..."
-d '{ "invoiceId":"F-2026-0847", "amount":1250.00 }'
✓ 201 Created · converti en Factur-X, transmis à la PDP
status: SUBMITTED → APPROVED
Émission

Envoyez une facture en un appel

Vous postez votre facture en JSON, ediflo s'occupe du format légal, de la validation Schematron et de la transmission à la plateforme agréée. Pas de XML à manipuler.

  • Conversion automatique Factur-X / CII / UBL
  • Validation Schematron avant envoi (erreurs lisibles)
  • Idempotence : un même appel n'envoie jamais deux fois
  • Réponse immédiate avec l'identifiant de suivi
// 1 requete suffit
const res = await fetch('https://api.ediflo.io/v1/invoices', {
  method: 'POST',
  headers: { 'X-API-Key': 'sk_live_...' },
  body: JSON.stringify({
    invoiceId: 'F-2026-0847',
    amount: 1250.00,
    buyer: { siret: '12345678900010' }
  })
});

// { "status": "SUBMITTED", "id": "inv_..." }
// Votre endpoint recoit l'evenement
POST /webhooks/ediflo
X-Signature-256: sha256=9f2c...

{
  "event": "invoice.received",
  "invoiceId": "F-2026-0848",
  "direction": "INBOUND",
  "seller": { "siren": "823456789" }
}
Réception

Recevez en temps réel, sans polling

Chaque facture fournisseur reçue et chaque changement de statut déclenchent un webhook signé HMAC vers votre endpoint. Vous synchronisez votre logiciel instantanément.

  • Événements émission et réception
  • Signature X-Signature-256 pour vérifier l'origine
  • Re-livraison automatique en cas d'échec
  • Repli en polling : GET /v1/invoices/unseen
Formats & conformité

Le format légal, sans y penser

Vous envoyez vos données ; ediflo génère le format normalisé EN 16931 attendu par l'administration et la plateforme. Conforme, validé, transmis.

Factur-X CII UBL Schematron EN 16931
Conversion & transmission
Votre JSON Factur-XCIIUBL PDP

Validé Schematron, conforme EN 16931

Développeurs

Pensé pour s'intégrer proprement

Auth flexible

Clé API X-API-Key ou OAuth2 client_credentials. Clés privées, publiques (widget) et serveur.

Webhooks signés

HMAC SHA-256, re-livraison automatique, journal des envois. Vous ne ratez aucun événement.

Idempotence

Rejouez un appel sans risque de doublon.

Rate limiting

Quotas par plan, en-têtes X-RateLimit.

Sandbox

Environnement de test isolé avant la prod.

Prêt à simplifier votre facturation ?

Créez votre compte en 30 secondes et envoyez votre première facture électronique.

Commencer gratuitement

Compte gratuit • Sans carte bancaire