Facturation électronique - Allemagne

L'API de Facturation Électronique Allemagne permet d'intégrer dans vos logiciels la gestion complète de la facturation électronique allemande via une unique API REST. Il est possible de configurer les entreprises, d'envoyer et de recevoir des factures électroniques, de suivre leur statut et d'automatiser l'ensemble du cycle documentaire, simplifiant ainsi l'intégration avec les systèmes prévus par la réglementation allemande.

Conçue pour les éditeurs de logiciels, les ERP, les plateformes e-commerce et les entreprises opérant sur le marché allemand, l'API permet de réduire la complexité du développement grâce à un modèle d'intégration simple, évolutif et facilement intégrable aux processus métier existants.

La solution gère automatiquement le processus de transmission des factures, fournit des mises à jour sur le statut des documents via des callbacks et permet d'intégrer la facturation électronique directement dans les logiciels de gestion, les applications et les plateformes logicielles.

Configuration de l'entreprise et des services

POST /DE-configurations

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

Lors de la phase d'onboarding, la Legal Entity est créée et l'identifiant DE:VAT est enregistré sur le réseau Peppol, permettant à l'entreprise d'échanger des factures électroniques conformément aux exigences de la réglementation allemande.

Une fois la configuration terminée, l'entreprise est prête à utiliser les services activés, que ce soit pour l'envoi des factures électroniques, leur réception ou les deux. Toutes les mises à jour du cycle de vie des documents sont automatiquement notifiées via des callbacks, ce qui permet au logiciel de gestion de rester synchronisé sans avoir à effectuer des requêtes périodiques vers les API.

EXEMPLE DE REQUÊTE

Pour configurer l'entreprise, il est nécessaire d'envoyer une requête à POST /DE-configurations. Dans l'exemple suivant, les services d'envoi et de réception des factures électroniques sont activés et une callback est configurée pour recevoir les mises à jour de l'état des documents.

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

Envoi de factures électroniques

POST /DE-invoices

L'endpoint POST /DE-invoices permet d'envoyer une facture électronique allemande B2B ou B2G à l'aide d'une seule requête API. Une fois le document reçu, Openapi en vérifie la validité, génère automatiquement le format requis par la réglementation allemande et gère l'ensemble du processus de transmission.

Pour les factures destinées aux entreprises (B2B), l'API génère automatiquement des documents au format ZUGFeRD, tandis que pour les factures destinées à l'administration publique allemande (B2G), elle utilise le format XRechnung. L'application n'a pas besoin d'implémenter des logiques différentes : il suffit d'envoyer les données de la facture et la plateforme produira automatiquement le format approprié en fonction du destinataire.

La transmission s'effectue via le réseau Peppol, conformément aux modalités prévues par la réglementation allemande. L'ensemble du processus de livraison, le suivi du statut du document et les notifications sont gérés automatiquement par l'API, simplifiant ainsi l'intégration avec les systèmes d'entreprise.

EXEMPLE DE REQUÊTE

L'exemple suivant montre une requête d'envoi d'une facture électronique B2B via l'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
    }
  ]
}

Remarque : l'exemple montre l'envoi d'une facture B2B. Dans ce cas, il est nécessaire de joindre le PDF du document. L'API le convertit automatiquement en un fichier ZUGFeRD conforme à la norme PDF/A-3 en intégrant les données structurées EN 16931. Pour les factures destinées à l'administration publique (B2G), le PDF n'est pas requis : il suffit de renseigner le Leitweg-ID, et l'API générera automatiquement une facture au format XRechnung.

Routage intelligent des factures

La facturation électronique allemande prévoit différents modes de transmission selon le type de destinataire. Avec l'API de Facturation Électronique Allemagne, il n'est pas nécessaire d'implémenter une logique spécifique : le logiciel de gestion envoie toujours la facture au même endpoint REST, et la plateforme identifie automatiquement le canal de livraison le plus approprié.

Pour les factures B2B, le destinataire est identifié grâce au numéro de TVA allemand (DE:VAT) et le document est généré au format ZUGFeRD. Pour les factures destinées à l'administration publique (B2G), le Leitweg-ID (DE:LWID) est utilisé et le document est généré au format XRechnung, conformément à la réglementation allemande.

Pour les factures destinées à l'administration publique, il est recommandé de renseigner également l'adresse e-mail du destinataire, car toutes les administrations allemandes ne sont pas encore accessibles via le réseau Peppol.

Grâce à cette approche, il suffit d'intégrer un seul endpoint API, Openapi prenant en charge toute la complexité liée au choix du canal de transmission et à la livraison de la facture, tout en garantissant la conformité aux exigences de la réglementation allemande.

Suivi du statut des factures

Après l'envoi d'une facture électronique, l'API permet de suivre l'ensemble de son cycle de vie. Chaque document est suivi depuis son envoi jusqu'à sa livraison finale, permettant au logiciel de gestion de connaître en temps réel le statut de la transmission.

Les mises à jour sont automatiquement transmises via des callbacks, éliminant ainsi la nécessité d'interroger continuellement les API. À chaque changement de statut, le système reçoit une notification contenant toutes les informations nécessaires pour synchroniser le logiciel de gestion avec le processus de livraison.

Les statuts renvoyés par l'API représentent les principales étapes du cycle de vie de la facture (NEW, SENT, DONE et ERROR) et sont automatiquement mis à jour en fonction des notifications reçues du réseau de transmission. Il est ainsi possible de vérifier rapidement si une facture a été prise en charge, livrée ou si elle nécessite une intervention en raison d'une erreur.

Consultation des factures

L'API de Facturation Électronique Allemagne permet de consulter à tout moment les factures envoyées et reçues, en récupérant leur statut mis à jour ainsi que toutes les données associées. Les endpoints de consultation permettent d'intégrer facilement des fonctionnalités de recherche, de suivi et de synchronisation au sein de votre logiciel de gestion.

Il est possible d'obtenir aussi bien la liste complète des factures électroniques traitées par le service que le détail d'un document spécifique, comprenant les informations d'identification, les lignes de facture, les montants, les pièces jointes et le statut actuel de la transmission.

Liste des factures

GET /DE-invoices

L'endpoint GET /DE-invoices renvoie la liste des factures électroniques traitées par le service. La réponse comprend les principales informations d'identification de chaque document ainsi que son statut, permettant de suivre facilement le cycle de vie des factures directement depuis votre logiciel de gestion.

EXEMPLE DE REQUÊTE

L'exemple suivant montre comment récupérer la liste des factures électroniques gérées par l'API.

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

Détail d'une facture

GET /DE-invoices/{id}

Pour obtenir le détail d'une facture spécifique, vous pouvez utiliser l'endpoint GET /DE-invoices/{id} en indiquant l'identifiant du document renvoyé lors de son envoi ou de sa réception.

La réponse comprend toutes les informations relatives à la facture, son statut actuel ainsi que les données concernant le processus de transmission.

Si nécessaire, vous pouvez utiliser le paramètre refresh=true, qui force la synchronisation avec le système de transmission et renvoie le statut le plus récent disponible.

EXEMPLE DE REQUÊTE

L'exemple suivant montre comment récupérer le détail d'une facture en forçant la mise à jour de son statut.

GET /DE-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 pour vérifier le statut d'un document spécifique, synchroniser des systèmes externes ou mettre à jour manuellement les informations lorsque cela est nécessaire.

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

Réception des factures électroniques fournisseurs

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

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

Chaque événement supplier-invoice contient toutes 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, éliminant ainsi la nécessité de gérer manuellement les factures reçues.

CONFIGURATION DES CALLBACKS

Pour recevoir automatiquement les factures fournisseurs, il suffit de configurer une callback lors de la phase d'onboarding de l'entreprise.

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

Chaque nouvelle facture reçue génère automatiquement une callback vers l'endpoint configuré, permettant au logiciel de gestion de récupérer le document et de lancer immédiatement les processus internes sans effectuer d'appels API supplémentaires.

À qui s'adresse l'API de Facturation Électronique Allemagne ?

L'API de Facturation Électronique Allemagne est conçue pour toutes les organisations qui souhaitent intégrer et automatiser la gestion des factures électroniques allemandes 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 allemande grâce à une intégration API unique, sans avoir à gérer la complexité des différents formats et canaux de transmission.

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

Grâce à la génération automatique des formats ZUGFeRD et XRechnung, au routage intelligent des factures, aux callbacks en temps réel et à un modèle d'intégration commun aux API de Facturation Électronique Italie et France, 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.