Elektronische Rechnungsstellung - Deutschland

Die API für die elektronische Rechnungsstellung in Deutschland ermöglicht die Integration der vollständigen Verwaltung der deutschen elektronischen Rechnungsstellung in Ihre Software über eine einzige REST-API. Unternehmen können konfiguriert, elektronische Rechnungen versendet und empfangen, deren Status überwacht sowie der gesamte Dokumentenlebenszyklus automatisiert werden. Dadurch wird die Integration mit den nach deutschem Recht vorgesehenen Systemen erheblich vereinfacht.

Die API wurde für Softwarehäuser, ERP-Systeme, E-Commerce-Plattformen und Unternehmen entwickelt, die auf dem deutschen Markt tätig sind. Dank eines einfachen, skalierbaren Integrationsmodells lässt sie sich problemlos in bestehende Geschäftsprozesse integrieren und reduziert den Entwicklungsaufwand erheblich.

Die Lösung verwaltet den gesamten Rechnungsübertragungsprozess automatisch, stellt Statusaktualisierungen der Dokumente über Callbacks bereit und ermöglicht die direkte Integration der elektronischen Rechnungsstellung in ERP-Systeme, Anwendungen und Softwareplattformen.

Unternehmenskonfiguration und Dienste

POST /DE-configurations

Die Unternehmenskonfiguration ist der erste Schritt zur Nutzung der API für die elektronische Rechnungsstellung in Deutschland. Über diesen Endpoint können Sie ein Unternehmen registrieren, den Versand, den Empfang oder beide Dienste aktivieren und die Callbacks konfigurieren, die automatisch Statusaktualisierungen der Dokumente empfangen.

Während des Onboarding-Prozesses wird die Legal Entity erstellt und die Kennung DE:VAT im Peppol-Netzwerk registriert. Dadurch kann das Unternehmen elektronische Rechnungen gemäß den deutschen gesetzlichen Vorgaben austauschen.

Nach Abschluss der Konfiguration kann das Unternehmen die aktivierten Dienste für den Versand, den Empfang oder beide Funktionen nutzen. Alle Aktualisierungen des Dokumentenlebenszyklus werden automatisch über Callbacks übermittelt, sodass das ERP-System stets synchron bleibt, ohne regelmäßig API-Anfragen ausführen zu müssen.

BEISPIELANFRAGE

Zur Konfiguration des Unternehmens muss eine Anfrage an POST /DE-configurations gesendet werden. Im folgenden Beispiel werden sowohl der Versand als auch der Empfang elektronischer Rechnungen aktiviert sowie ein Callback eingerichtet, um Statusaktualisierungen der Dokumente zu empfangen.

{
  "fiscal_id": "DE123456789",
  "name": "Mustermann GmbH",
  "email": "[email protected]",
  "customer_invoice": true,
  "supplier_invoice": true,
  "address": {
    "street_address": "Hauptstraße 42",
    "zip_code": "10115",
    "city": "Berlin",
    "country": "DE"
  },
  "api_configurations": [
    {
      "event": "customer-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/de/out"
      }
    },
    {
      "event": "supplier-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/de/in"
      }
    }
  ]
}

Versand elektronischer Rechnungen

POST /DE-invoices

Der Endpoint POST /DE-invoices ermöglicht den Versand einer deutschen elektronischen B2B- oder B2G-Rechnung über eine einzige API-Anfrage. Nach Eingang des Dokuments überprüft Openapi dessen Gültigkeit, erstellt automatisch das nach deutschem Recht erforderliche Format und übernimmt den gesamten Übertragungsprozess.

Für Rechnungen an Unternehmen (B2B) erstellt die API automatisch Dokumente im Format ZUGFeRD, während für Rechnungen an die deutsche öffentliche Verwaltung (B2G) das Format XRechnung verwendet wird. Ihre Anwendung muss keine unterschiedlichen Logiken implementieren: Es genügt, die Rechnungsdaten zu übermitteln. Die Plattform erstellt automatisch das passende Format entsprechend dem Empfänger.

Die Übertragung erfolgt über das Peppol-Netzwerk gemäß den deutschen gesetzlichen Vorgaben. Der gesamte Zustellprozess, die Statusüberwachung und sämtliche Benachrichtigungen werden automatisch von der API verwaltet und vereinfachen so die Integration in bestehende Unternehmenssysteme.

BEISPIELANFRAGE

Das folgende Beispiel zeigt eine Anfrage zum Versand einer elektronischen B2B-Rechnung über den Endpoint POST /DE-invoices.

{
  "document_number": "INV-2026-001",
  "issue_date": "2026-06-26",
  "currency": "EUR",
  "type": "380",
  "sender": {
    "name": "Mustermann GmbH",
    "fiscal_id": "DE123456789",
    "vat_id": "DE123456789",
    "address": {
      "street_address": "Unter den Linden 34-37",
      "city": "Berlin",
      "zip_code": "10115",
      "country": "DE"
    }
  },
  "recipient": {
    "name": "Customer GmbH",
    "vat_id": "DE987654321",
    "email": "[email protected]"
  },
  "invoice_lines": [
    {
      "description": "IT consulting services",
      "quantity": 50,
      "unit_price": 100.00,
      "total_net_amount": 5000.00,
      "tax_rate": 19,
      "unit_of_measure": "HUR"
    }
  ],
  "tax_subtotals": [
    {
      "taxable_amount": 5000.00,
      "tax_amount": 950.00,
      "tax_rate": 19,
      "tax_category": "standard"
    }
  ],
  "payment_means": [
    {
      "payment_mode": "credit_transfer",
      "financial_account": "DE89370400440532013000",
      "due_date": "2026-07-26",
      "amount": 5950.00
    }
  ]
}

Hinweis: Das Beispiel zeigt den Versand einer B2B-Rechnung. In diesem Fall muss die PDF-Version des Dokuments beigefügt werden. Die API konvertiert sie automatisch in eine ZUGFeRD-Datei, die dem PDF/A-3-Standard entspricht, indem sie die EN-16931-Daten in das PDF einbettet. Für Rechnungen an die öffentliche Verwaltung (B2G) ist kein PDF erforderlich. Es genügt, die Leitweg-ID anzugeben; die API erstellt anschließend automatisch eine Rechnung im XRechnung-Format.

Intelligentes Rechnungsrouting

Die deutsche elektronische Rechnungsstellung sieht je nach Empfängertyp unterschiedliche Übertragungswege vor. Mit der API für die elektronische Rechnungsstellung in Deutschland ist keine spezielle Geschäftslogik erforderlich: Das ERP-System sendet die Rechnung immer an denselben REST-Endpoint, während die Plattform automatisch den am besten geeigneten Übertragungskanal auswählt.

Bei B2B-Rechnungen wird der Empfänger anhand der deutschen Umsatzsteuer-Identifikationsnummer (DE:VAT) identifiziert und das Dokument im ZUGFeRD-Format erstellt. Für Rechnungen an die öffentliche Verwaltung (B2G) wird hingegen die Leitweg-ID (DE:LWID) verwendet und das Dokument im XRechnung-Format erzeugt, wie es die deutsche Gesetzgebung vorsieht.

Für Rechnungen an die öffentliche Verwaltung wird empfohlen, zusätzlich die E-Mail-Adresse des Empfängers anzugeben, da derzeit nicht alle deutschen Behörden über das Peppol-Netzwerk erreichbar sind.

Dank dieses Ansatzes genügt die Integration eines einzigen API-Endpoints. Openapi übernimmt die gesamte Komplexität der Auswahl des Übertragungskanals sowie der Zustellung der Rechnung und gewährleistet gleichzeitig die Einhaltung der deutschen gesetzlichen Anforderungen.

Überwachung des Rechnungsstatus

Nach dem Versand einer elektronischen Rechnung ermöglicht die API die Überwachung ihres gesamten Lebenszyklus. Jedes Dokument wird vom Versand bis zur endgültigen Zustellung verfolgt, sodass das ERP-System jederzeit den aktuellen Übertragungsstatus kennt.

Statusaktualisierungen werden automatisch über Callbacks übermittelt, sodass keine kontinuierlichen API-Abfragen erforderlich sind. Bei jeder Statusänderung erhält das System eine Benachrichtigung mit allen Informationen, die für die Synchronisierung des ERP-Systems mit dem Zustellprozess erforderlich sind.

Die von der API zurückgegebenen Status stellen die wichtigsten Phasen des Lebenszyklus einer Rechnung (NEW, SENT, DONE und ERROR) dar und werden anhand der vom Übertragungsnetzwerk empfangenen Benachrichtigungen automatisch aktualisiert. Dadurch kann schnell überprüft werden, ob eine Rechnung übernommen, zugestellt wurde oder aufgrund eines Fehlers ein Eingreifen erforderlich ist.

Rechnungsabfrage

Die API für die elektronische Rechnungsstellung in Deutschland ermöglicht es, gesendete und empfangene Rechnungen jederzeit abzurufen und dabei ihren aktuellen Status sowie alle zugehörigen Daten zu erhalten. Die Abfrage-Endpoints ermöglichen die einfache Integration von Such-, Überwachungs- und Synchronisierungsfunktionen in das eigene Verwaltungssystem.

Es ist sowohl möglich, die vollständige Liste der vom Dienst verarbeiteten elektronischen Rechnungen als auch die Details eines bestimmten Dokuments abzurufen, einschließlich Stammdaten, Rechnungspositionen, Beträgen, Anhängen und dem aktuellen Status der Übertragung.

Rechnungsliste

GET /DE-invoices

Der Endpoint GET /DE-invoices gibt die Liste der vom Dienst verarbeiteten elektronischen Rechnungen zurück. Die Antwort enthält die wichtigsten Identifikationsdaten jedes Dokuments sowie den jeweiligen Status und ermöglicht so die einfache Überwachung des Lebenszyklus der Rechnungen direkt im eigenen Verwaltungssystem.

BEISPIELANFRAGE

Das folgende Beispiel zeigt, wie die Liste der von der API verwalteten elektronischen Rechnungen abgerufen werden kann.

{
  "data": [
    {
      "document_number": "DE-2026-001",
      "issue_date": "2026-06-26",
      "due_date": "2026-07-26",
      "currency": "EUR",
      "type": "380",
      "total_amount_including_tax": 1190,
      "total_amount_excluding_tax": 1000,
      "total_tax_amount": 190,
      "leitweg_id": null,
      "buyer_reference": null,
      "commitment_number": null,
      "sender": {
        "name": "Mustermann GmbH",
        "vat_number": "DE123456789",
        "vat_id": "DE123456789",
        "leitweg_id": null,
        "email": "[email protected]",
        "address": {
          "street_address": "Hauptstraße",
          "street_number": "42",
          "zip_code": "10115",
          "city": "Berlin",
          "country": "DE"
        }
      },
      "recipient": {
        "name": "Mustermann GmbH",
        "vat_number": "DE123456789",
        "vat_id": "DE123456789",
        "leitweg_id": null,
        "email": "[email protected]",
        "address": {
          "street_address": "Hauptstraße",
          "street_number": "42",
          "zip_code": "10115",
          "city": "Berlin",
          "country": "DE"
        }
      },
      "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"
        }
      ],
      "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",
        "invoice_type": "ZUGFeRD",
        "leitweg_id": null,
        "submission_date": "2026-06-26T10:00:00Z"
      },
      "create_at": "2026-06-26T10:00:00Z"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

Rechnungsdetails

GET /DE-invoices/{id}

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

Die Antwort enthält alle Informationen zur Rechnung, den aktuellen Status des Dokuments sowie die Daten zum Übertragungsprozess.

Bei Bedarf kann der Parameter refresh=true verwendet werden, der die Synchronisierung mit dem Übertragungssystem erzwingt und den aktuellsten verfügbaren Status zurückgibt.

BEISPIELANFRAGE

Das folgende Beispiel zeigt, wie die Details einer Rechnung unter Erzwingen der Aktualisierung des Dokumentenstatus abgerufen werden können.

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

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

{
  "data": {
    "document_number": "DE-2026-001",
    "issue_date": "2026-06-26",
    "due_date": "2026-07-26",
    "currency": "EUR",
    "type": "380",
    "total_amount_including_tax": 1190,
    "total_amount_excluding_tax": 1000,
    "total_tax_amount": 190,
    "leitweg_id": null,
    "buyer_reference": null,
    "commitment_number": null,
    "sender": {
      "name": "Mustermann GmbH",
      "vat_number": "DE123456789",
      "vat_id": "DE123456789",
      "leitweg_id": null,
      "email": "[email protected]",
      "address": {
        "street_address": "Hauptstraße",
        "street_number": "42",
        "zip_code": "10115",
        "city": "Berlin",
        "country": "DE"
      }
    },
    "recipient": {
      "name": "Mustermann GmbH",
      "vat_number": "DE123456789",
      "vat_id": "DE123456789",
      "leitweg_id": null,
      "email": "[email protected]",
      "address": {
        "street_address": "Hauptstraße",
        "street_number": "42",
        "zip_code": "10115",
        "city": "Berlin",
        "country": "DE"
      }
    },
    "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"
      }
    ],
    "attachments": [
      {
        "document": "JVBERi0xLjcKJeLjz9MK...",
        "mime_type": "application/pdf",
        "filename": "INV-2026-001.pdf",
        "description": "Invoice PDF",
        "document_id": "INV-2026-001"
      }
    ],
    "id": "645a3f2b1c0d9e8f7a6b5c4d",
    "state": "NEW",
    "direction": "outgoing",
    "details": {
      "external_status": "submitted",
      "invoice_type": "ZUGFeRD",
      "leitweg_id": null,
      "submission_date": "2026-06-26T10:00:00Z"
    },
    "create_at": "2026-06-26T10:00:00Z",
    "updated_at": "2026-06-26T10:00:00Z"
  },
  "success": true,
  "message": "Invoice sent successfully",
  "error": null
}

Empfang eingehender elektronischer Rechnungen

Die API für die elektronische Rechnungsstellung in Deutschland ermöglicht den automatischen Empfang elektronischer Rechnungen von Lieferanten und zentralisiert den gesamten Eingangsrechnungsprozess direkt im eigenen Verwaltungssystem.

Nachdem der Empfangsservice während der Unternehmenskonfiguration aktiviert wurde, wird jede an das Unternehmen gerichtete Rechnung automatisch übernommen und unabhängig vom verwendeten Übertragungskanal über die konfigurierten Callbacks bereitgestellt.

Jedes supplier-invoice-Ereignis enthält alle Informationen, die erforderlich sind, um das Dokument zu identifizieren und automatisch die Erfassungs-, Buchungs- oder Freigabeprozesse im Verwaltungssystem zu starten. Dadurch entfällt die Notwendigkeit, eingehende Rechnungen manuell zu verarbeiten.

CALLBACK-KONFIGURATION

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

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

Jede neu empfangene Rechnung erzeugt automatisch einen Callback an den konfigurierten Endpoint. Dadurch kann das Verwaltungssystem das Dokument übernehmen und die internen Prozesse sofort starten, ohne weitere API-Aufrufe durchführen zu müssen.

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

Die API für die elektronische Rechnungsstellung in Deutschland wurde für alle entwickelt, die die Verwaltung deutscher elektronischer Rechnungen direkt in ihre Software integrieren und automatisieren möchten. Sie ist die ideale Lösung für Softwarehäuser, Entwickler, ERP-Systeme und Independent Software Vendors (ISV), die die Einhaltung der deutschen Vorschriften schnell über eine einzige API-Integration umsetzen möchten, ohne sich mit der Komplexität der verschiedenen Formate und Übertragungskanäle befassen zu müssen.

Sie richtet sich außerdem an italienische und internationale Unternehmen mit Kunden, Lieferanten oder Niederlassungen in Deutschland, an E-Commerce-Plattformen, Marktplätze und Buchhaltungssoftware, die elektronische Rechnungen automatisch versenden und empfangen müssen, sowie an Steuerkanzleien und Beratungsunternehmen, die die Verwaltungs- und Steuerprozesse ihrer Kunden verwalten.

Dank der automatischen Erstellung der Formate ZUGFeRD und XRechnung, dem intelligenten Rechnungsrouting, Echtzeit-Callbacks und einem gemeinsamen Integrationsmodell mit den APIs für die elektronische Rechnungsstellung in Italien und Frankreich eignet sich die Lösung sowohl für Projekte mit geringem Rechnungsvolumen als auch für Enterprise-Plattformen, die täglich Tausende von Dokumenten verarbeiten. Dadurch werden Entwicklungszeiten, Wartungskosten und die betriebliche Komplexität reduziert.