Das Wichtigste

Die Benutzer-API des Anbieters und AS4 zwischen Access Points sind unterschiedliche Schnittstellen. Testen Sie Empfang, Versand, Duplikate und Fehler; ein HTTP-Erfolg allein bestätigt keine Zustellung.

Wie wird Software über eine API an Peppol angebunden?

Eine übliche Integration verbindet Ihr Rechnungs- oder ERP-System mit der Schnittstelle des Zustellanbieters. Das Programm bereitet die Daten vor, übergibt den Beleg und übernimmt die Ergebnisse oder empfangene Rechnungen. Der Anbieter erfüllt seine Aufgabe im Zustellnetzwerk.

Die Kunden-API und die Übertragung zwischen Access Points sind unterschiedliche Ebenen. Peppol AS4 beschreibt die Kommunikation zwischen den Anbietern. Die konkreten API-Adressen, die Art der Authentifizierung und das Antwortformat für Ihr Programm bestimmen die Unterlagen des gewählten Anbieters.

Bestätigen Sie den Umfang, bevor mit der Programmierung begonnen wird: nur Versand, nur Empfang oder beide Richtungen. Nennen Sie auch mehrere Unternehmen, Korrekturbelege, Anhänge und die gewünschte Anbindung an die Buchhaltung.

Welche Aufgaben teilen Sie zwischen ERP und Anbieter auf?

Aufgabe Was zu vereinbaren ist
Entstehung der Rechnung Wo die Datenquelle ist und wer den Beleg genehmigt
UBL-Export Wer das XML erstellt und welches Profil oder welche Version unterstützt wird
Adressierung Woher die Peppol ID übernommen wird und wie der Empfänger geprüft wird
Validierung Welche Ebenen ausgeführt werden und wie Fehler zurückgegeben werden
Zustellung Welche Nachrichtenkennung und welches Ergebnis das ERP erhält
Empfang Wie ursprüngliche XML-Dateien, Anhänge und der Empfangszeitpunkt bezogen werden
Meldung Wie das Ergebnis der Daten für die Finanzverwaltung verfolgt wird

Der Anbieter kann ein fertiges XML annehmen oder die Erstellung aus anderen Daten anbieten. Prüfen Sie in beiden Fällen, dass die geschäftliche Bedeutung der Felder erhalten bleibt. Das Mapping erklärt das kommentierte XML-Muster.

Wie gestalten Sie den Versand und die Rückgabe des Ergebnisses?

Speichern Sie den Beleg zuerst und prüfen Sie ihn technisch. Halten Sie bei der Übergabe Ihre eigene Referenz und die Nachrichtenkennung des Anbieters fest. Die Bedeutung der API-Antwort muss erklärt sein: Die Übernahme der Anfrage kann dem endgültigen Ergebnis der Übertragung vorausgehen.

Bei asynchroner Verarbeitung kann das Ergebnis per Webhook kommen, oder das Programm ermittelt es durch wiederholte Abfrage gemäß der Dokumentation. Betrachten Sie diese Möglichkeiten nicht als Pflichtfunktion jeder API. Vereinbaren Sie, wie das Ergebnis zum richtigen Beleg zurückkehrt und was ein Mitarbeiter bei einem Fehler sieht.

Illustrativer Integrationsablauf:

ERP bereitet die Rechnung vor und speichert sie
→ prüft das XML und vergibt eine eigene Referenz
→ übergibt den Beleg an den Anbieter
→ speichert die Nachrichtenkennung
→ übernimmt das Ergebnis der Übertragung
→ zeigt den Status oder eine Korrekturaufgabe an

Das Schema ist keine Definition einer konkreten API. Die Namen der Status und die verfügbaren Bestätigungen übernehmen Sie aus der Dokumentation des Dienstes. Unterscheiden Sie die technische Zustellung von der geschäftlichen Genehmigung durch den Abnehmer.

Was geschieht bei einem Ausfall oder einer wiederholten Anfrage?

Tritt nach dem Versand ein Timeout auf, kann das Ergebnis unbekannt sein: Der Anbieter könnte den Beleg übernommen haben. Ein erneuter Versand muss einen vereinbarten Schutz vor Duplikaten haben. Prüfen Sie, ob die API eine idempotente Anfrage oder das Auffinden der Nachricht anhand Ihrer Referenz unterstützt.

Rechnen Sie bei Webhooks mit wiederholten Ereignissen und prüfen Sie deren Herkunft gemäß der Dokumentation. Speichern Sie beim Empfang die Nachrichtenkennung und auch die Identität der Rechnung; stützen Sie die Prüfung nicht allein auf den Dateinamen. Ein technisches Duplikat der Übertragung und zwei geschäftlich ähnliche Belege sind unterschiedliche Situationen.

Bereiten Sie auch die manuelle Klärung eines Falls vor, der ohne eindeutiges Ergebnis geblieben ist. Markieren Sie ein Ergebnis nicht automatisch als erfolgreich, nur weil kein Fehlercode mehr kommt.

Wie richten Sie den Empfang und die Zugänge mehrerer Unternehmen ein?

Bewahren Sie das bezogene XML auf und vergleichen Sie die Daten mit dem Import in das richtige Unternehmen. Die anschließende Genehmigung, die Kontierung und die Zahlung gehören zu Ihrem Arbeitsablauf. Die offizielle UBL-Struktur hilft zu bestimmen, wohin die Geschäftsdaten gehören.

Halten Sie Test- und Produktionskonten getrennt. Speichern Sie Schlüssel auf dem Server und machen Sie sie nur den nötigen Prozessen zugänglich. Prüfen Sie bei mehreren Steuersubjekten den Umfang jeder Berechtigung, damit die Anfrage eines Unternehmens nicht die Belege eines anderen verarbeiten kann.

Legen Sie auch die Wiederherstellung des Zugangs und den Austausch der Zugangsdaten bei einem Wechsel des Dienstes fest. Ein Betriebsprotokoll soll helfen, ein Problem nachzuverfolgen, ohne unnötig den gesamten Inhalt der Rechnungen in jedes Log zu kopieren.

Was muss vor dem Start einen Test bestehen?

Testen Sie den gewöhnlichen Versand und Empfang, einen ungültigen Beleg, einen unbekannten Empfänger, eine Korrektur und einen wiederholten Import. Ergänzen Sie einen Timeout nach der Übergabe, ein wiederholtes Ereignis und eine vorübergehende Nichtverfügbarkeit des Dienstes. Legen Sie für jedes Szenario das erwartete Ergebnis und das Vorgehen der Bearbeiter fest.

Halten Sie die verwendete Version der Regeln und die Version des Konnektors fest. Vergleichen Sie sie bei einem Update mit den gültigen eDelivery-Spezifikationen. Die Prüfung des Belegs erklärt die Validierung der E-Rechnung.

Ergänzen Sie für den slowakischen Betrieb auch eine Vereinbarung zur Meldung von Daten. Die Finanzverwaltung der Slowakischen Republik (Finančná správa SR) beschreibt die automatische Übertragung über den Digitalen Postboten (Digitálny poštár); die Integration soll es dem Nutzer ermöglichen, ihr Ergebnis nachzuverfolgen. Den allgemeinen Ablauf beschreibt die Zustellung von Rechnungen.

Die Arbeitsorganisation und die Tests mit dem Softwarelieferanten ergänzt die Anleitung zur Anbindung des Buchhaltungsprogramms. Die Umstellung vorhandener Unterlagen behandelt das Vorgehen von PDF zur eFaktúra.

Unterlagen, auf die Sie zurückgreifen können

Geprüfte Quellen

Wir stützen uns auf offizielle Materialien. Die ursprünglichen Unterlagen finden Sie unter den Links unten. Ändern sich die Regeln, aktualisieren wir auch diesen Leitfaden.

Inhalt geprüft 1.10.2026. Im konkreten Steuerfall sind der jeweilige Gesetzeswortlaut und die Umstände der Lieferung maßgeblich.