Elektronische Rechnungsstellung - Frankreich

Die API für die elektronische Rechnungsstellung – Frankreich ermöglicht die Automatisierung des gesamten Lebenszyklus elektronischer Rechnungen, vereinfacht die Integration in das französische E-Invoicing-System und reduziert die Komplexität der Dokumentenprozesse.

Mit einer einzigen API können Sie den Versand, den Empfang und die Überwachung elektronischer Rechnungen verwalten. Die Plattform leitet jedes Dokument automatisch über den am besten geeigneten Übertragungskanal weiter und nutzt dabei das Peppol-Netzwerk, das französische nationale Netzwerk oder – sofern vorgesehen – alternative Kanäle. Dabei wird jederzeit die Einhaltung der geltenden gesetzlichen Vorschriften gewährleistet.

Neben dem Versand von Rechnungen ermöglicht die API die Konfiguration von Unternehmen, den Empfang eingehender Rechnungen, deren Echtzeitüberwachung sowie den automatischen Empfang von Statusaktualisierungen über Callbacks. Die Integration ist sowohl für ERP- und Verwaltungssoftware als auch für Enterprise-Plattformen ausgelegt, die große Dokumentenmengen verarbeiten.

Die Integrationslogik entspricht der der API für die elektronische Rechnungsstellung in Italien: dieselben Konfigurationsprinzipien, dieselbe asynchrone Verarbeitung und dieselbe Verwendung von Callbacks. Wer den italienischen Dienst bereits nutzt, kann seine Systeme daher schnell auch auf den französischen Markt ausweiten.

Nach dem Versand einer Rechnung werden Statusaktualisierungen des Dokuments automatisch über Callbacks übermittelt, sodass das ERP-System kontinuierlich synchronisiert bleibt, ohne die APIs fortlaufend abfragen zu müssen.

Unternehmens- und Servicekonfiguration

POST /FR-configurations

Die Konfiguration des Unternehmens ist der erste Schritt zur Nutzung der API für die elektronische Rechnungsstellung Frankreich. Über diesen Endpoint können Sie Ihr Unternehmen registrieren, den Versand-, den Empfangsservice oder beide aktivieren – je nach den Anforderungen Ihrer Integration – und die Callbacks konfigurieren, die automatisch Statusaktualisierungen zu den Dokumenten erhalten.

Für das Onboarding genügt die Angabe der SIREN (9 Ziffern) oder der SIRET (14 Ziffern). Der Dienst erstellt automatisch die Unternehmenskonfiguration, ruft die für die steuerliche Identifikation erforderlichen Informationen ab und bereitet die Umgebung für die Verwaltung elektronischer Rechnungen gemäß den französischen Vorschriften vor.

Nach Abschluss der Konfiguration ist das Unternehmen bereit, die aktivierten Dienste zu nutzen – sowohl für den Versand als auch für den Empfang elektronischer Rechnungen oder für beide Funktionen. Es ist nicht erforderlich, unterschiedliche Konfigurationen je nach Übertragungskanal zu verwalten: Die API übernimmt den gesamten Prozess während des gesamten Lebenszyklus des Dokuments.

BEISPIELANFRAGE

Das folgende Beispiel zeigt eine Anfrage zur Konfiguration eines Unternehmens mit Aktivierung der E-Rechnungsdienste und der Definition eines Callbacks, um automatisch Aktualisierungen zum Status der Rechnungen zu erhalten.

{
  "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"
      }
    }
  ]
}

Die Konfiguration wird nur einmal durchgeführt und bildet den Ausgangspunkt der Integration. Ab diesem Zeitpunkt kann das ERP-System elektronische Rechnungen versenden und empfangen, während Statusaktualisierungen der Dokumente automatisch über die konfigurierten Callbacks übermittelt werden.

Versand elektronischer Rechnungen

POST /FR-invoices

Der Endpoint POST /FR-invoices ermöglicht den Versand französischer elektronischer Rechnungen im B2B- und B2G-Bereich über eine einzige API-Anfrage. Es genügt, die Rechnungsdaten zu übermitteln: Der Dienst prüft deren Gültigkeit, erstellt das den französischen Vorschriften entsprechende Format und startet automatisch den Übermittlungsprozess.

Die Integration wurde entwickelt, um die Arbeit der Entwickler so einfach wie möglich zu gestalten. Das ERP-System sendet die Rechnung immer an denselben REST-Endpoint, während die Plattform automatisch alle für die Zustellung des Dokuments erforderlichen Vorgänge übernimmt.

Bei Rechnungen an die französische öffentliche Verwaltung wird das Dokument über den gesetzlich vorgesehenen Übertragungskanal weitergeleitet. Bei B2B-Rechnungen ermittelt der Dienst dagegen automatisch den am besten geeigneten Übertragungskanal anhand der Konfiguration des Empfängers.

BEISPIELANFRAGE

Das folgende Beispiel zeigt den Versand einer elektronischen Rechnung. Sobald die Anfrage eingegangen ist, übernimmt der Dienst das Dokument und verwaltet den gesamten Übermittlungsprozess automatisch.

{
  "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
    }
  ]
}

Nach dem Versand wird eine technische Bestätigung über die erfolgreiche Entgegennahme der Anfrage zurückgegeben. Die Verarbeitung der Rechnung erfolgt asynchron, und Aktualisierungen bezüglich Zustellung, Annahme, Ablehnung oder Zahlung werden automatisch über Callbacks übermittelt.

Überwachung des Lebenszyklus von Rechnungen

CALLBACK Dokumentenstatus

Nach dem Versand der Rechnung gibt der Dienst sofort eine technische Bestätigung über die erfolgreiche Entgegennahme der Anfrage zurück. Die Verarbeitung des Dokuments erfolgt asynchron und jede Aktualisierung wird automatisch über Callbacks übermittelt.

Im Gegensatz zum italienischen System, bei dem das Sistema di Interscambio hauptsächlich das Ergebnis der Übermittlung mitteilt, wird der französische Prozess auch nach der Zustellung der Rechnung fortgesetzt. Der Empfänger kann das Dokument annehmen, beanstanden, ablehnen oder dessen Zahlung bestätigen.

Aus diesem Grund kann der gesamte Lebenszyklus der Rechnung anhand einer Reihe von Statuswerten überwacht werden, die während des gesamten Prozesses automatisch aktualisiert werden.

Die Benachrichtigungen werden automatisch an die während des Onboardings konfigurierten Endpoints gesendet, sodass das ERP-System kontinuierlich mit dem Status der Dokumente synchronisiert bleibt, ohne regelmäßige API-Abfragen durchführen zu müssen.

Abfrage von Rechnungen

GET /FR-invoices

Der Endpoint GET /FR-invoices ermöglicht den Abruf der Liste aller elektronischen Rechnungen des konfigurierten Unternehmens, sowohl ausgehender als auch eingehender Rechnungen. Die Dokumente werden mit allen Detailinformationen sowie dem aktuellen Status des Verarbeitungsprozesses zurückgegeben.

Dieser Dienst eignet sich zur Synchronisierung des ERP-Systems, zum Aufbau von Monitoring-Dashboards oder zum schnellen Abruf des Verlaufs der über die Plattform verarbeiteten Rechnungen.

{
  "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
}

Die Antwort enthält sämtliche Informationen zur Rechnung, einschließlich der Angaben zum Absender und Empfänger, der detaillierten Rechnungspositionen, der Beträge, der Zahlungsinformationen, der Anhänge sowie des aktuellen Status des Übermittlungsprozesses. Mit den Abfrage-Endpoints können jederzeit die aktuellen Daten der vom Dienst verarbeiteten elektronischen Rechnungen abgerufen werden.

Rechnungsdetails

GET /FR-invoices/{id}

Um die Details einer bestimmten Rechnung abzurufen, kann der Endpoint GET /FR-invoices/{id} verwendet werden. Dabei ist die Dokument-ID anzugeben, die während des Versand- oder Empfangsvorgangs zurückgegeben wurde.

Die Antwort enthält alle Informationen zur Rechnung, den aktuellen Dokumentenstatus sowie die Daten zum Übermittlungsprozess.

Bei Bedarf kann der Parameter refresh=true verwendet werden. Dadurch wird eine Synchronisierung mit dem Übertragungssystem erzwungen und der aktuellste verfügbare Status zurückgegeben.

BEISPIELANFRAGE

Das folgende Beispiel zeigt, wie die Details einer Rechnung mit Aktualisierung ihres Status in Echtzeit abgerufen werden können.

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

In den meisten Fällen werden Statusaktualisierungen automatisch über Callbacks empfangen. Die Abfrage-Endpoints stellen ein zusätzliches Werkzeug dar, um den Status eines bestimmten Dokuments zu überprüfen oder externe Systeme bei Bedarf zu synchronisieren.

Empfang eingehender elektronischer Rechnungen

Die API für die elektronische Rechnungsstellung Frankreich ermöglicht den automatischen Empfang elektronischer Rechnungen von Lieferanten und zentralisiert den gesamten Eingangsrechnungsprozess direkt innerhalb Ihres ERP-Systems.

Nachdem der Dienst während der Unternehmenskonfiguration aktiviert wurde, wird jede an das Unternehmen gerichtete Rechnung automatisch erfasst und über die konfigurierten Callbacks bereitgestellt – unabhängig davon, über welchen Übertragungskanal sie zugestellt wurde.

Jedes Ereignis supplier-invoice enthält alle erforderlichen Informationen, um das Dokument zu identifizieren und automatisch die Prozesse zur Registrierung, Verbuchung oder Freigabe im ERP-System zu starten.

CALLBACK-KONFIGURATION

Um eingehende Rechnungen automatisch zu empfangen, genügt es, während des Unternehmens-Onboardings einen Callback-Endpoint zu konfigurieren.

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

Jede neu eingehende Rechnung wird automatisch an den konfigurierten Endpoint gesendet, sodass das ERP-System das Dokument übernehmen und die internen Prozesse unmittelbar starten kann, ohne zusätzliche API-Aufrufe durchführen zu müssen.

Für die französische elektronische Rechnungsstellung stehen verschiedene Übertragungskanäle zur Verfügung, die je nach Empfängertyp und den konfigurierten Empfangsmodalitäten genutzt werden. Dadurch ist die Integration komplexer als in anderen nationalen Systemen.

Mit der API für die elektronische Rechnungsstellung Frankreich müssen keine unterschiedlichen Logiken für die einzelnen Übertragungskanäle implementiert werden. Das ERP-System sendet die Rechnung stets an denselben REST-Endpoint, während die Plattform automatisch den am besten geeigneten Übertragungsweg auswählt.

Bei Rechnungen an die französische öffentliche Verwaltung (B2G) wird das Dokument dagegen direkt über Chorus Pro gemäß den für öffentliche Einrichtungen geltenden Verfahren übermittelt.

Dieser Ansatz ermöglicht die Entwicklung einer einzigen API-Integration, während die Plattform die gesamte Komplexität der Auswahl des Übertragungskanals sowie die Verwaltung gesetzlicher Änderungen übernimmt.

Für wen ist die API für die elektronische Rechnungsstellung Frankreich geeignet?

Die API für die elektronische Rechnungsstellung Frankreich wurde für alle Unternehmen entwickelt, die die Verwaltung französischer elektronischer Rechnungen direkt in ihre Software integrieren und automatisieren möchten. Sie ist die ideale Lösung für Softwarehäuser, Entwickler, ERP-Anbieter und Independent Software Vendors (ISV), die die Einhaltung der französischen Vorschriften schnell über eine einzige API-Integration ermöglichen möchten, ohne sich um die Komplexität der verschiedenen Übertragungskanäle kümmern zu müssen.

Sie richtet sich außerdem an italienische und internationale Unternehmen mit Kunden, Lieferanten oder Niederlassungen in Frankreich, an E-Commerce-Plattformen, Marktplätze und Buchhaltungssoftware, die elektronische Rechnungen automatisch versenden und empfangen müssen, sowie an Steuerberater, Wirtschaftsprüfungsgesellschaften und Beratungsunternehmen, die die administrativen und steuerlichen Prozesse ihrer Kunden verwalten.

Dank der intelligenten Weiterleitung von Rechnungen, der Echtzeit-Callbacks und der mit der API für die elektronische Rechnungsstellung Italien gemeinsamen Integrationslogik eignet sich die Lösung sowohl für Projekte mit geringem Dokumentenaufkommen als auch für Enterprise-Plattformen, die täglich Tausende von Dokumenten verarbeiten. Gleichzeitig werden Entwicklungszeiten, Wartungskosten und die operative Komplexität deutlich reduziert.