Die Wahl der falschen E-Invoicing-API im Jahr 2026 wird zu einem kostspieligen Fehler. Die Compliance-Vorgaben wurden um Polen (KSeF), Rumänien (ANAF), Frankreich (PPF), Malaysia (LHDN), Belgien, Dänemark und weitere Länder erweitert, und die Geschwindigkeit nimmt zu. Eine Ein-Länder-Lösung, die Ihnen 2023 gedient hat, wird die nächsten drei Jahre nicht überstehen. Dieser Leitfaden zeigt auf, was eine produktionsreife E-Invoicing-API heute leisten muss, und vergleicht dann exakt, wie sich die API von Docnova nach jedem Kriterium schlägt.
Worauf Sie bei einer E-Invoicing-API achten sollten
Die erste Frage betrifft den Umfang: Behandelt die API jedes Land als vollwertigen Bürger oder werden neue Märkte nachträglich hinzugefügt? Suchen Sie nach länderspezifischen Einreichungs-Endpunkten anstelle eines generischen “Rechnung senden”-Aufrufs, der lokale Formatierungsanforderungen stillschweigend ignoriert. Sie benötigen außerdem eine klare Versionierung, vorhersehbare Fehlercodes, die mit dem eigenen Fehlerwortschatz jeder Steuerbehörde übereinstimmen, und eine Sandbox-Umgebung, die das Produktionsverhalten eng genug widerspiegelt, um Ihren Testergebnissen zu vertrauen. Überprüfen Sie schließlich, ob der Anbieter die Logik zur Einhaltung von Formatänderungen, neuen Zertifikatsanforderungen, dem Umgang mit Ausfallzeiten von Behörden oder ob diese Last auf Ihr Team fällt, pflegt.
Authentifizierung und Sicherheit
Die JWT-basierte Authentifizierung ist 2026 der Standard. Abgesehen von Login und Token-Aktualisierung bietet eine ausgereifte API die Verwaltung von API-Schlüsseln, damit Server-zu-Server-Integrationen niemals mit Benutzeranmeldeinformationen in Berührung kommen. Docnovas API-Schlüsselsystem, zugänglich unter ERP Management-Einstellungen, ermöglicht es Teams, benannte Schlüssel mit expliziten Ablaufdaten zu generieren. Jeder Schlüssel wird nur zum Zeitpunkt der Generierung vollständig angezeigt und in allen nachfolgenden Ansichten maskiert. Einzelne Schlüssel können über einen AKTIV-Schalter aktiviert oder deaktiviert werden, ohne die gesamte Integration zu widerrufen, was für die Rotation von Anmeldeinformationen in der Produktion unerlässlich ist. Der Standard-Authentifizierungsfluss verwendet POST /auth/login zur JWT-Ausstellung und POST /auth/refresh für Token-Erneuerung; API-Schlüssel folgen demselben JWT-Schema für ERP- und Systemintegrationen.
Multi-Länder-Unterstützung
Eine glaubwürdige E-Invoicing-API im Jahr 2026 deckt mindestens die Märkte ab, auf denen Ihre Kunden heute tätig sind, und die, auf denen Mandate als nächstes kommen. Docnova stellt länderspezifische Einreichungsendpunkte für Polen bereit (POST /rechnung/PL → KSeF), Rumänien (POST /rechnung/RO → ANAF), Frankreich (POST /rechnung/FR → PPF), Malaysia (POST /rechnung/MEIN → LHDN), Dänemark (POST /rechnung/DK → NemHandel), Belgien (POST /rechnung/BE), Kroatien (POST /rechnung/HR), Schweden (POST /rechnung/SE), Serbien (POST /waybill/RS), und ÄgyptenPOST /egypt-rechnung → ETA). Jeder Ländercode enthält außerdem die entsprechenden Endpunkte für Zertifikate und Sitzungstoken, sodass der vollständige Authentifizierungs-Handshake mit jeder Steuerbehörde serverseitig gehandhabt wird. Das Peppol-Netzwerk wird separat über POST /peppol/registrieren und GET /peppol für grenzüberschreitenden Dokumentenaustausch.
Webhook- und Ereignisunterstützung
TODO: Überprüfen: Webhook/Event-Push-Endpunkte Es wurden keine Webhook-spezifischen Endpunkte im Quellcode des API-Katalogs gefunden. Überprüfen Sie dies anhand der Backend-Controller, bevor Sie sie veröffentlichen.
Echtzeit-Ereignisbereitstellung ist für Rechnungsworkflows wichtig: Ihr ERP sollte den Moment kennen, in dem eine Einreichung erfolgreich ist oder eine Steuerbehörde eine Ablehnung zurückgibt, ohne abzufragen. Prüfen Sie bei der Bewertung einer E-Rechnungs-API, ob diese ausgehende Webhook-Bereitstellung für mindestens Statusänderungen bei der Einreichung, Genehmigungen durch die Behörde und Zahlungsereignisse bietet. Prüfen Sie, ob bei fehlgeschlagener Zustellung automatische Wiederholungsversuche erfolgen und ob die Ereignisnutzlast die eigene Referenz-ID der Behörde zur Abstimmung enthält. Docnovas API enthält POST /rechnung/zahlung für die Aufzeichnung von Zahlungsereignissen und länderspezifischen Token-Endpunkten, die den Status von Berechtigungssitzungen verwalten; für spezifische Konfigurationen von Webhook-Pushes konsultieren Sie die Docnova-Entwicklerdokumentation oder wenden Sie sich an das Integrationsteam.
Wie die API von Docnova funktioniert
Docnovas REST API folgt durchgängig einem ressourcenorientierten Design. CRUD-Operationen befinden sich unter /{ressource} Zum Beispiel, GET /rechnung, POST /rechnung, PUT /rechnung/{id}), länderspezifische Einreichungen erweitern die gleiche Ressource mit einem nachgestellten Ländercode (/rechnung/PL, /rechnung/RO), und untergeordnete Ressourcen verwenden die /{ressource}/{id}/{unterressource} Muster. Alle Endpunkte außer Pfaden unter /öffentlich/** und /auth/** einen gültigen JWT im Authorization-Header erfordern.
Die API-Schlüsselverwaltungsfunktion in den ERP-Managementeinstellungen entspricht direkt diesen Integrationen: Jeder API-Schlüssel vom Typ „Unternehmen“ ermächtigt ein verbundenes ERP oder ein externes System, im Namen dieses Unternehmens zu handeln. Schlüssel tragen ein Ablaufdatum, eine Gültigkeit von einem Jahr ist üblich und sie können einzeln deaktiviert werden. Die Endpunkte der Partnerverzeichnisse (/partner/*) und Business-Partner-Netzwerkendpunkte (/geschäftspartner/*sind verfügbar, um lieferanten- oder kundenorientierte Integrationen aufbauend auf dem Rechnungs-Kern zu erstellen.
Fazit
An e-Rechnungs-API Im Jahr 2026 baubar, benötigt JWT sowie API-Schlüssel-Authentifizierung, länderspezifische Einreichungs-Endpunkte, die durch echte Autoritätsintegrationen unterstützt werden, und einen klaren Weg zu den Märkten, die Sie nächstes Jahr benötigen werden. Docnova deckt all diese Punkte ab mit einer dokumentierten REST-API, verwalteten API-Schlüssel mit Ablauf- und Umschaltfunktionen sowie länderspezifischen Endpunkten, die heute zehn Gerichtsbarkeiten abdecken. Testen Sie Docnova kostenlos oder buchen Sie eine Demo unter docnova.ai.