Peppol-Integration für Ihre App: E-Rechnungen über KRONENWERK senden

Sie integrieren den Peppol-Versand über KRONENWERK in Ihre Anwendung, indem Sie den Rechnungsentwurf mit POST /invoices/drafts anlegen, die Rechnung im Produkt ausstellen und übermitteln lassen und invoice.issued an Ihrem Webhook-Endpunkt empfangen. KRONENWERK ist kein Peppol Access Point. Es sendet und empfängt über Peppol durch einen akkreditierten Access-Point-Anbieter (Storecove), sobald das Unternehmen unter Einstellungen → Zustellung angebunden ist, und der produktive Versand hängt von diesem Konto und seiner Konfiguration ab. Die Funktion ist MIT EINSCHRÄNKUNGEN UNTERSTÜTZT.

Was Peppol für einen Integrator ist

Peppol ist ein Vier-Ecken-Zustellnetzwerk: Ihr Unternehmen (Ecke 1) übergibt ein Dokument an seinen Access Point (Ecke 2), der über das SML/SMP-Verzeichnis den Access Point des Empfängers (Ecke 3) ermittelt und an das empfangende Unternehmen (Ecke 4) zustellt. Dokumente sind strukturiertes UBL nach Peppol BIS Billing 3.0, einer Implementierung der EN 16931. Teilnehmer werden über Kennungen wie eine Umsatzsteuernummer unter einem Schema aus den OpenPeppol-Codelisten adressiert, die im Netzwerk verbindlich sind und regelmäßig aktualisiert werden (v9.7 mit Stand 2. Juli 2026). Der Mechanismus wird unter Peppol erklärt, Kennungen unter Peppol-Kennungen und die praktische Seite unter Senden und Empfangen über Peppol.

Für einen Entwickler ist die Konsequenz einfach: Sie sprechen nie direkt mit dem Netzwerk. Der Access Point von jemandem tut das, und die Frage ist, wessen. Einen eigenen Access Point zu bauen bedeutet OpenPeppol-Mitgliedschaft, Akkreditierung, ein AS4-Gateway und SMP-Veröffentlichung. KRONENWERK zu nutzen bedeutet, dass der Access Point der von Storecove ist, die Anbindung dem Unternehmen gehört und Ihr Code nur mit der KRONENWERK-API spricht.

Der Ablauf: Entwurf, Ausstellung, Übermittlung, Webhook

1. Ihre App legt den Kunden an mit POST /customers. Geben Sie dem Kunden ein Land und eine USt-IdNr.: Die Peppol-Teilnehmerkennung eines belgischen Empfängers wird aus seiner Unternehmens- oder Umsatzsteuernummer abgeleitet, und ein Kunde ohne eine solche kann im Netzwerk nicht adressiert werden.
2. Ihre App startet den Entwurf mit POST /invoices/drafts und einem Idempotency-Key. Die Antwort ist ein Entwurf im Zustand DRAFT mit dem Nummernvorschlag des Verkäufers und den Zahlungsbedingungen des Kunden.
3. Eine Person stellt den Entwurf im Produkt aus. KRONENWERK berechnet das Steuerergebnis, prüft die USt-IdNr. gegen VIES, rendert für einen belgischen Verkäufer Peppol BIS Billing 3.0 UBL, validiert es und verbraucht die Nummer. invoice.issued wird in diesem Moment für Ihren Endpunkt in die Warteschlange gestellt.
4. Die Rechnung wird aus dem Produkt übermittelt. Die Übermittlung ist eine eigene, protokollierte Aktion auf der ausgestellten Rechnung, kein Nebeneffekt der Ausstellung: Das Ländermodul benennt den Weg (Peppol für Belgien), der angebundene Access-Point-Anbieter befördert das Dokument, und das Ergebnis wird bei der Rechnung festgehalten. Ist das Ergebnis unbekannt — ein Timeout, nachdem die Anfrage abgegangen ist —, verweigert das Produkt einen erneuten Versand, bis ein Abgleichsaufruf die Gegenseite gefragt hat, ob sie das Dokument hält. Ein unbekanntes Ergebnis zu wiederholen ist der Weg, wie aus einer Rechnung zwei werden.
5. Ihre App empfängt invoice.issued, verifiziert KRONENWERK-Signature, dedupliziert anhand von KRONENWERK-Event-Id und speichert invoiceId und number. Später folgen invoice.paid oder invoice.cancelled.

Was ein Entwickler konfigurieren muss

Beachten Sie, was nicht auf der Liste steht: kein SMP, kein AS4-Zertifikat, keine OpenPeppol-Mitgliedschaft auf Ihrer Seite. Beachten Sie auch, was die API nicht kann: Sie kann das Unternehmen nicht an das Netzwerk anbinden, nicht übermitteln und das Übermittlungsprotokoll nicht lesen. Das sind Einstellungen und Handlungen, die eine Person im Produkt vornimmt.

Beispielanfragen

curl -X POST https://kronenwerk.org/api/extern/v1/customers \
  -H "Authorization: Bearer greif_live_…" \
  -H "Idempotency-Key: crm-account-88213" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Voorbeeld BV",
    "street": "Rue de l'"'"'Exemple 12",
    "postalCode": "1000",
    "city": "Bruxelles",
    "country": "BE",
    "vatId": "BE0123456789",
    "email": "invoices@example.be"
  }'

curl -X POST https://kronenwerk.org/api/extern/v1/invoices/drafts \
  -H "Authorization: Bearer greif_live_…" \
  -H "Idempotency-Key: crm-account-88213-2026-09" \
  -H "Content-Type: application/json" \
  -d '{ "customerId": "3f2b…" }'

Die Kundenantwort enthält die Partnernummer aus der eigenen Nummernfolge des Unternehmens (zum Beispiel K-0042) und die Felder wie gespeichert: id, number, name, contact, email, phone, street, postalCode, city, country, vatId, currency, customer, supplier, archived, createdAt. Name, Straße, Postleitzahl und Ort sind Pflicht, weil die EN 16931 eine Adresse in Bestandteilen führt und ein Kunde ohne Straße einer ist, an den kein Dokument adressiert werden kann. Die Rechnungs-API wird auf der Seite zur Rechnungs-API vollständig beschrieben.

Empfang über Peppol

In Belgien gilt die Pflicht, strukturierte Rechnungen über Peppol zu empfangen, für mehrwertsteuerpflichtige Unternehmen ohne Schwellenwert, sodass eine Anbindung, die nur sendet, die halbe Pflicht wäre. Sobald das Unternehmen angebunden ist, kommen eingehende Peppol-Dokumente beim Access-Point-Anbieter an, werden an KRONENWERK übergeben, als Eingangsrechnungen eingelesen und validiert. Ihre Integration erfährt davon über den Webhook purchase.recorded, der purchaseId, kind, documentNumber, supplierName, supplierId, documentDate, dueDate, currency, netMinor, taxMinor und grossMinor enthält. Das eingehende Dokument selbst wird nicht über die API bereitgestellt. Der belgische Kontext steht auf der Belgien-Übersicht und der Länderseite Belgien.

Alternativen, ehrlich verglichen

Wenn Ihre Anforderung ein vollautomatischer Versand ohne ausstellende Person ist, ist die API von KRONENWERK das heute nicht, und ein Direktvertrag mit einem Anbieter ist die ehrliche Empfehlung. Der Peppol-Leitfaden für Entwickler behandelt, was Sie in diesem Fall bauen müssten; Peppol vs. nationale Netze erklärt, wo Peppol der Weg ist und wo ein nationales System (KSeF, französische plateformes agréées).

Wie KRONENWERK das handhabt

MIT EINSCHRÄNKUNGEN UNTERSTÜTZT KRONENWERK erzeugt bei der Ausstellung Peppol BIS Billing 3.0 UBL für belgische Verkäufer und sendet und empfängt über Peppol durch einen akkreditierten Access-Point-Anbieter (Storecove), sobald das Unternehmen unter Einstellungen → Zustellung angebunden ist. KRONENWERK ist selbst kein akkreditierter oder zertifizierter Peppol Access Point. Der produktive Versand hängt vom Storecove-Konto und der Konfiguration des Unternehmens ab, und die Übermittlung ist eine Handlung, die eine Person nach der Ausstellung im Produkt vornimmt. Der Anteil der API sind der Kunde, der Entwurf, das Auslesen und die Webhooks, im Enterprise-Plan. Der Peppol-Weg ist für belgische Verkäufer verdrahtet; für deutsche Verkäufer erzeugt das Produkt XRechnung oder ZUGFeRD für E-Mail oder Download und benennt keinen Übermittlungsweg, weil das deutsche Recht keinen benennt. Die französische Übermittlung ist ein anderer Mechanismus und NOCH NICHT BEREIT — siehe Französische Plattformen. Produktdetails: E-Rechnung.