Facturation électronique - France

L'API de Facturation Électronique - France permet d'automatiser l'ensemble du cycle de vie des factures électroniques, en simplifiant l'intégration avec le système français de facturation électronique et en réduisant la complexité des flux documentaires.

Grâce à une API unique, vous pouvez gérer l'émission, la réception et le suivi des factures électroniques. La plateforme achemine automatiquement chaque document via le canal de transmission le plus approprié, en utilisant le réseau Peppol, le réseau national français ou, lorsque cela est prévu, des canaux alternatifs, tout en garantissant la conformité avec la réglementation en vigueur.

En plus de l'envoi des factures, l'API permet de configurer les entreprises, de recevoir les factures fournisseurs, d'en suivre l'état en temps réel et de recevoir des mises à jour automatiques via des callbacks. L'intégration est conçue pour s'adapter aussi bien aux logiciels de gestion qu'aux plateformes d'entreprise traitant d'importants volumes de documents.

La logique d'intégration reprend celle de l'API de Facturation Électronique Italie : mêmes principes de configuration, même gestion asynchrone et même utilisation des callbacks. Les utilisateurs du service italien peuvent ainsi étendre rapidement leurs systèmes au marché français.

Après l'envoi d'une facture, les mises à jour relatives à l'état du document sont automatiquement notifiées via des callbacks, permettant au logiciel de gestion de rester constamment synchronisé sans avoir à interroger continuellement les API.

Configuration de l'entreprise et des services

POST /FR-configurations

La configuration de l'entreprise constitue la première étape pour utiliser l'API de Facturation Électronique France. Grâce à cet endpoint, vous pouvez enregistrer votre entreprise, activer le service d'émission, le service de réception ou les deux, selon les besoins de votre intégration, et configurer les callbacks qui recevront automatiquement les mises à jour concernant l'état des documents.

Pour finaliser l'onboarding, il suffit de fournir le SIREN (9 chiffres) ou le SIRET (14 chiffres). Le service crée automatiquement la configuration de l'entreprise, récupère les informations nécessaires à son identification fiscale et prépare l'environnement pour la gestion des factures électroniques conformément à la réglementation française.

Une fois la configuration terminée, l'entreprise est prête à utiliser les services activés, que ce soit pour l'émission des factures électroniques, leur réception ou les deux fonctionnalités. Il n'est pas nécessaire de gérer des configurations différentes selon le canal de transmission : l'API prend en charge l'ensemble du processus tout au long du cycle de vie du document.

EXEMPLE DE REQUÊTE

L'exemple suivant montre une requête de configuration de l'entreprise avec l'activation des services de facturation électronique et la définition d'un callback permettant de recevoir automatiquement les mises à jour relatives aux factures.

{
  "fiscal_id": "21750001600019",
  "vat_id": "FR12217500016",
  "name": "Your Company FR",
  "email": "[email protected]",
  "customer_invoice": true,
  "supplier_invoice": true,
  "address": {
    "street_address": "Rue de Rivoli 42",
    "zip_code": "75001",
    "city": "Paris",
    "country": "FR"
  },
  "api_configurations": [
    {
      "event": "customer-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/fr/out"
      }
    }
  ]
}

La configuration est effectuée une seule fois et constitue le point de départ de l'intégration. À partir de ce moment, le logiciel de gestion pourra envoyer et recevoir des factures électroniques, tandis que les mises à jour relatives à l'état des documents seront automatiquement notifiées via les callbacks configurés.

Envoi d'une facture électronique

POST /FR-invoices

L'endpoint POST /FR-invoices permet d'envoyer des factures électroniques françaises B2B et B2G au moyen d'une seule requête API. Il suffit de transmettre les données de la facture : le service en vérifie la validité, génère le format conforme à la réglementation française et lance automatiquement le processus de transmission.

L'intégration est conçue pour simplifier au maximum le travail des développeurs. Le logiciel de gestion envoie toujours la facture au même endpoint REST, tandis que la plateforme prend automatiquement en charge toutes les opérations nécessaires à la livraison du document.

Pour les factures destinées à l'administration publique française, le document est acheminé vers le canal prévu par la réglementation. Pour les factures B2B, le service identifie automatiquement le canal de transmission le plus approprié en fonction de la configuration du destinataire.

EXEMPLE DE REQUÊTE

L'exemple suivant montre l'envoi d'une facture électronique. Une fois la requête reçue, le service prend en charge le document et gère automatiquement son processus de transmission.

{
  "document_number": "INV-2026-001",
  "issue_date": "2026-05-12",
  "currency": "EUR",
  "total_amount_including_tax": 61.20,
  "sender": {
    "name": "Your Company",
    "fiscal_id": "YourCompanyFiscalId",
    "vat_id": "FR12345678901"
  },
  "recipient": {
    "name": "Customer Company",
    "fiscal_id": "CustomerFiscalId",
    "email": "[email protected]"
  },
  "invoice_lines": [
    {
      "description": "Professional Service",
      "quantity": 1,
      "unit_price": 250.00,
      "tax_rate": 20
    }
  ]
}

Après l'envoi, une confirmation technique de la prise en charge de la requête est renvoyée. Le traitement de la facture se poursuit de manière asynchrone et les mises à jour relatives à la livraison, à l'acceptation, au rejet ou au paiement sont automatiquement notifiées via des callbacks.

Suivi du cycle de vie des factures

CALLBACK Statuts du document

Après l'envoi de la facture, le service renvoie immédiatement une confirmation technique de la prise en charge de la requête. Le traitement du document se poursuit de manière asynchrone et chaque mise à jour est automatiquement notifiée via des callbacks.

Contrairement au système italien, où le Système d'Échange communique principalement le résultat de la transmission, le processus français se poursuit même après la livraison de la facture. Le destinataire peut en effet accepter le document, le contester, le refuser ou notifier son paiement.

Pour cette raison, il est possible de suivre l'ensemble du cycle de vie de la facture à travers une série de statuts mis à jour automatiquement tout au long du processus.

Les notifications sont automatiquement envoyées aux endpoints configurés lors de la phase d'onboarding, permettant au logiciel de gestion de rester constamment synchronisé avec l'évolution des documents sans avoir à effectuer de requêtes périodiques aux API.

Consultation des factures

GET /FR-invoices

L'endpoint GET /FR-invoices permet de récupérer la liste des factures électroniques associées à l'entreprise configurée, qu'elles soient émises ou reçues. Les documents sont renvoyés avec leurs informations détaillées ainsi que l'état mis à jour du processus de traitement.

Ce service est utile pour synchroniser votre logiciel de gestion, créer des tableaux de bord de suivi ou récupérer rapidement l'historique des factures traitées par la plateforme.

{
  "data": [
    {
      "document_number": "INV-2026-001",
      "issue_date": "2026-05-12",
      "currency": "EUR",
      "type": "380",
      "amount_including_tax": 61.2,
      "total_amount_including_tax": 61.2,
      "amount_excluding_tax": 51,
      "total_amount_excluding_tax": 51,
      "tax_amount": 10.2,
      "total_tax_amount": 10.2,
      "sender": {
        "name": "ACME France SARL",
        "fiscal_id": "21750001600019",
        "siren": "217500016",
        "siret": "21750001600019",
        "vat_id": "FR12217500016",
        "email": "[email protected]",
        "address": {
          "street_address": "Rue de Rivoli 42",
          "zip_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "recipient": {
        "name": "ACME France SARL",
        "fiscal_id": "21750001600019",
        "siren": "217500016",
        "siret": "21750001600019",
        "vat_id": "FR12217500016",
        "email": "[email protected]",
        "address": {
          "street_address": "Rue de Rivoli 42",
          "zip_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "invoice_lines": [
        {
          "description": "Wireless Mouse",
          "quantity": 2,
          "unit_price": 25.5,
          "tax_rate": 20,
          "total_net_amount": 51,
          "unit_of_measure": "C62",
          "nature": "standard",
          "tax_category": "standard"
        }
      ],
      "payment_means": [
        {
          "payment_mode": "sepa_credit_transfer",
          "due_date": "2026-06-12",
          "amount": 61.2,
          "financial_account": "FR7630006000011234567890123"
        }
      ],
      "tax_subtotals": [
        {
          "taxable_amount": 51,
          "tax_amount": 10.2,
          "vat_rate": 20,
          "tax_category": "standard"
        }
      ],
      "chorus_pro_service_code": "SERVICES_TECH",
      "commitment_number": "PO-12345",
      "attachments": [
        {
          "document": "JVBERi0xLjcKJeLjz9MK...",
          "mime_type": "application/pdf",
          "filename": "INV-2026-001.pdf",
          "description": "Invoice PDF",
          "document_id": "INV-2026-001"
        }
      ],
      "id": "645a3f2b1c0d9e8f7a6b5c4d",
      "state": "NEW",
      "details": {
        "external_status": "submitted",
        "network": "fr-dgfip",
        "siren": "217500016",
        "siret": "21750001600019",
        "service_code": "SERVICES_TECH",
        "commitment_number": "PO-12345",
        "invoice_type": "Factur-X",
        "submission_date": "2026-05-12T15:30:00Z"
      },
      "create_at": "2026-05-12T15:30:00Z"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

La réponse inclut toutes les informations relatives à la facture, notamment les informations de l'expéditeur et du destinataire, le détail des lignes du document, les montants, les modalités de paiement, les pièces jointes ainsi que l'état actuel du processus de transmission. Les endpoints de consultation permettent de récupérer à tout moment les données actualisées des factures électroniques traitées par le service.

Détail d'une facture

GET /FR-invoices/{id}

Pour obtenir le détail d'une facture spécifique, il est possible d'utiliser l'endpoint GET /FR-invoices/{id} en indiquant l'identifiant du document renvoyé lors de la phase d'envoi ou de réception.

La réponse comprend toutes les informations de la facture, l'état actuel du document ainsi que les données relatives au processus de transmission.

Lorsque cela est nécessaire, il est possible d'utiliser le paramètre refresh=true, qui force la synchronisation avec le système de transmission et renvoie l'état le plus récent disponible.

EXEMPLE DE REQUÊTE

L'exemple suivant montre comment récupérer le détail d'une facture en mettant à jour son état en temps réel.

GET /FR-invoices/645a3f2b1c0d9e8f7a6b5c4d?refresh=true

Dans la plupart des cas, les mises à jour sont reçues automatiquement via des callbacks. Les endpoints de consultation constituent un outil supplémentaire permettant de vérifier l'état d'un document spécifique ou de synchroniser des systèmes externes lorsque cela est nécessaire.

Réception des factures électroniques fournisseurs

L'API de Facturation Électronique France permet de recevoir automatiquement les factures électroniques émises par les fournisseurs, en centralisant l'ensemble du cycle fournisseurs directement au sein de votre logiciel de gestion.

Après avoir activé le service lors de la configuration de l'entreprise, chaque facture destinée à l'organisation est automatiquement récupérée et mise à disposition via les callbacks configurés, quel que soit le canal utilisé pour sa transmission.

Chaque événement supplier-invoice contient les informations nécessaires pour identifier le document et lancer automatiquement les processus d'enregistrement, de comptabilisation ou d'approbation dans le logiciel de gestion.

CONFIGURATION DES CALLBACKS

Pour recevoir automatiquement les factures fournisseurs, il suffit de configurer un endpoint de callback lors de l'onboarding de l'entreprise.

{
  "api_configurations": [
    {
      "event": "supplier-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/fr/in"
      }
    }
  ]
}

Chaque nouvelle facture reçue est automatiquement envoyée à l'endpoint configuré, permettant au logiciel de gestion d'acquérir le document et de lancer immédiatement les processus internes sans appels supplémentaires aux API.

La facturation électronique française prévoit plusieurs canaux de transmission, utilisés selon le type de destinataire et les modalités de réception configurées. Cela rend l'intégration plus complexe que dans d'autres systèmes nationaux.

Avec l'API de Facturation Électronique France, il n'est pas nécessaire d'implémenter une logique différente pour chaque canal. Le logiciel de gestion envoie toujours la facture au même endpoint REST, et la plateforme sélectionne automatiquement le canal de transmission le plus approprié.

Pour les factures destinées à l'administration publique française (B2G), le document est transmis directement via Chorus Pro, conformément aux modalités prévues pour les organismes publics.

Cette approche permet de développer une intégration API unique, en laissant à la plateforme toute la complexité liée à la sélection du canal de transmission et à la gestion des évolutions réglementaires.

À qui s'adresse l'API de Facturation Électronique France

L'API de Facturation Électronique France est conçue pour toutes les organisations souhaitant intégrer et automatiser la gestion des factures électroniques françaises directement dans leurs logiciels. C'est la solution idéale pour les éditeurs de logiciels, les développeurs, les ERP et les Independent Software Vendors (ISV) qui souhaitent ajouter rapidement la conformité à la réglementation française grâce à une intégration API unique, sans avoir à gérer la complexité des différents canaux de transmission.

Elle s'adresse également aux entreprises italiennes et internationales ayant des clients, des fournisseurs ou des établissements en France, ainsi qu'aux plateformes e-commerce, marketplaces et logiciels de comptabilité qui doivent émettre et recevoir automatiquement des factures électroniques, sans oublier les cabinets professionnels et les sociétés de conseil qui gèrent les processus administratifs et fiscaux de leurs clients.

Grâce au routage intelligent des factures, aux callbacks en temps réel et à la logique d'intégration commune avec l'API de Facturation Électronique Italie, la solution s'adapte aussi bien aux projets à faible volume qu'aux plateformes d'entreprise traitant des milliers de documents chaque jour, tout en réduisant les délais de développement, les coûts de maintenance et la complexité opérationnelle.