Was ist SAPI-SK und warum sollte ich es nutzen?

Die standardisierte nationale REST-Schnittstelle zwischen einem Client- oder ERP-System und einem Peppol-Zugangspunkt (sapi-sk.sk). Wir implementieren sie vollständig, Sie sind also nicht an eine proprietäre API-Form von uns gebunden und schreiben die Integration einmal für jeden SAPI-SK Access Point. Einen Überblick ohne technische Details gibt der Artikel SAPI-SK für Entwickler, die vollständige Referenz die Entwicklerdokumentation.

Wie melde ich mich an?

OAuth2 client_credentials: die client_id ist die UUID Ihres API-Tokens und das client_secret das Token vpt_ selbst aus dem Portal (linkes Menü API-Tokens, Reiter API-Schlüssel, Schaltfläche Token erstellen). POST /sapi/auth/token liefert ein Access Token für 15 Minuten und ein Refresh Token für 30 Tage; nutzen Sie das Token die vollen 15 Minuten, ein neues Token für jeden Aufruf ist unnötiger Aufwand. Der Widerruf des API-Tokens im Portal macht sofort sowohl /auth/token als auch /auth/renew ungültig.

Kann ich die API ohne Registrierung ausprobieren?

Ja. Die öffentlichen Sandbox-Zugangsdaten client_id = sandbox und client_secret = sandbox validieren Anfragen wie der Produktivbetrieb, senden aber nie etwas ins Peppol-Netzwerk und liefern Mock-Antworten. Für einen echten Ablauf mit Zustellung, Zustellbestätigung und Webhooks gibt es die Testumgebung test.peppol.verteco.digital, in der Unternehmen automatisch freigegeben werden und die Zustellung über das Peppol-Testnetzwerk läuft, kostenlos und ohne Limits zum Ausprobieren.

Was passiert, wenn der Empfänger nicht im Peppol-Netzwerk ist?

Der Beleg durchläuft zuerst die Validierung. Einen gültigen Beleg übernehmen wir und melden ihn der Finanzverwaltung auch dann, wenn der Empfänger nicht im Netzwerk ist (Antwort ACCEPTED mit undeliverable: true, in der Liste der gesendeten Belege der Status undeliverable). Dieselbe Rechnung muss den Empfänger aber auf anderem Weg erreichen, am besten als XML per E-Mail; sobald er sich registriert, senden Sie sie über Peppol erneut mit demselben Idempotency-Key. Vor dem Versand prüfen Sie den Empfänger über GET /sapi/discovery.

Wie erfahre ich den Zustellstatus?

GET /sapi/document/sent liefert zu jeder Zeile den Status (submitted, delivered, rejected, undeliverable), die Zeiten sentAt, deliveredAt und fsReportedAt und die MLS-Zustellbestätigung. Polling alle 1 bis 5 Minuten ist ein vollwertiger Weg; die Webhooks invoice.delivered, invoice.rejected und invoice.undeliverable sind eine Ergänzung, keine Voraussetzung.

Die Anbindung ist kostenlos. Der Dienst kostet ab €2/Monat zzgl. MwSt. je Unternehmens-ID (IČO), die sendet oder das Datenarchiv eingeschaltet hat; Empfang mit ausgeschaltetem Archiv ist kostenlos (bis 1.000 Rechnungen pro Monat). Während der freiwilligen Phase vor der Pflicht ab 1. 1. 2027 ist alles kostenlos.

Integrationen / Für Entwickler / REST API (SAPI-SK)

SAPI-SK REST API

Verfügbar

SAPI-SK ist die standardisierte nationale REST-Schnittstelle zwischen Ihrem System oder ERP und einem Peppol-Zugangspunkt. Wir implementieren sie vollständig, Sie schreiben die Integration also einmal für jeden SAPI-SK Access Point und sind nicht an eine proprietäre API-Form von uns gebunden. Versand, Empfang, Zustellstatus mit MLS-Bestätigung und die Meldung an die Finanzverwaltung liegen in einer Schnittstelle, mit OpenAPI-3.1-Spezifikation und einer vollwertigen Testumgebung kostenlos.

Plugin im Portal holen Kostenloses Konto erstellen

So funktioniert es

1Legen Sie ein Konto im Portal an und fügen Sie ein Unternehmen hinzu. Öffnen Sie im linken Menü API-Tokens und klicken Sie auf dem Reiter API-Schlüssel auf Token erstellen. Das Token vpt_ wird nur einmal angezeigt; für SAPI-SK ist die client_id die Token-ID (UUID) und das client_secret das Token selbst.
2Probieren Sie den ganzen Ablauf auf test.peppol.verteco.digital: eine vollständige Kopie des Portals mit getrennten Daten, in der Unternehmen automatisch freigegeben werden und die Zustellung real über das Peppol-Testnetzwerk läuft. Es genügt, die Domain zu tauschen und in der Testumgebung erstellte Tokens zu verwenden. Für einen schnellen Test ohne Registrierung gibt es die öffentlichen Zugangsdaten client_id = sandbox und client_secret = sandbox (es wird nie etwas zugestellt).
3Holen Sie ein Access Token über POST /sapi/auth/token (grant_type client_credentials; 15 Minuten gültig, Refresh Token 30 Tage). Senden Sie einen Beleg über POST /sapi/document/send mit den Kopfzeilen X-Peppol-Participant-Id und Idempotency-Key; vor dem Versand können Sie POST /sapi/document/validate und GET /sapi/discovery aufrufen.
4Laden Sie empfangene Belege über GET /sapi/document/receive (Parameter ?since und ?until für inkrementelles Abholen) und den Status gesendeter über GET /sapi/document/sent, oder über die Webhooks invoice.delivered, invoice.rejected und invoice.undeliverable.
5Beim Wechsel in die Produktion tauschen Sie die Domain gegen peppol.verteco.digital und legen ein Produktionskonto samt Tokens an. Den Versand schaltet das Verifizierungsmerkmal frei, das das Unternehmen durch die Auswahl von Verteco als Anbieter auf dem Portal der Finanzverwaltung erhält.

Was die Integration löst

✓Versand (POST /sapi/document/send), Sammelversand von bis zu 100 Belegen (POST /sapi/document/batch) und Validierung ohne Versand (POST /sapi/document/validate)
✓Empfang von Belegen mit dem Filter ?since und ?until, Original-XML, HTML, PDF und Anhänge zu jedem empfangenen Beleg
✓Status gesendeter Belege mit MLS-Zustellbestätigung, den Zeiten sentAt, deliveredAt und fsReportedAt und der Zeitleiste des Belegs (events)
✓Idempotency-Key: ein wiederholter Aufruf stellt eine Rechnung nie zweimal zu; nach der Korrektur eines Fehlers senden Sie den Beleg erneut mit demselben Schlüssel
✓OpenAPI-3.1-Spezifikation unter /api/v1/openapi.json: Import in Postman oder Generierung eines typisierten Clients (TS, Java, PHP, Python)
✓Mit einem Token bedienen Sie mehrere Unternehmen über die Kopfzeile X-Peppol-Participant-Id; Sandbox und Testumgebung sind kostenlos

Häufige Fragen: E-Rechnungen für REST API (SAPI-SK)

Was ist SAPI-SK und warum sollte ich es nutzen?: Die standardisierte nationale REST-Schnittstelle zwischen einem Client- oder ERP-System und einem Peppol-Zugangspunkt (sapi-sk.sk). Wir implementieren sie vollständig, Sie sind also nicht an eine proprietäre API-Form von uns gebunden und schreiben die Integration einmal für jeden SAPI-SK Access Point. Einen Überblick ohne technische Details gibt der Artikel SAPI-SK für Entwickler, die vollständige Referenz die Entwicklerdokumentation.
Wie melde ich mich an?: OAuth2 client_credentials: die client_id ist die UUID Ihres API-Tokens und das client_secret das Token vpt_ selbst aus dem Portal (linkes Menü API-Tokens, Reiter API-Schlüssel, Schaltfläche Token erstellen). POST /sapi/auth/token liefert ein Access Token für 15 Minuten und ein Refresh Token für 30 Tage; nutzen Sie das Token die vollen 15 Minuten, ein neues Token für jeden Aufruf ist unnötiger Aufwand. Der Widerruf des API-Tokens im Portal macht sofort sowohl /auth/token als auch /auth/renew ungültig.
Kann ich die API ohne Registrierung ausprobieren?: Ja. Die öffentlichen Sandbox-Zugangsdaten client_id = sandbox und client_secret = sandbox validieren Anfragen wie der Produktivbetrieb, senden aber nie etwas ins Peppol-Netzwerk und liefern Mock-Antworten. Für einen echten Ablauf mit Zustellung, Zustellbestätigung und Webhooks gibt es die Testumgebung test.peppol.verteco.digital, in der Unternehmen automatisch freigegeben werden und die Zustellung über das Peppol-Testnetzwerk läuft, kostenlos und ohne Limits zum Ausprobieren.
Was passiert, wenn der Empfänger nicht im Peppol-Netzwerk ist?: Der Beleg durchläuft zuerst die Validierung. Einen gültigen Beleg übernehmen wir und melden ihn der Finanzverwaltung auch dann, wenn der Empfänger nicht im Netzwerk ist (Antwort ACCEPTED mit undeliverable: true, in der Liste der gesendeten Belege der Status undeliverable). Dieselbe Rechnung muss den Empfänger aber auf anderem Weg erreichen, am besten als XML per E-Mail; sobald er sich registriert, senden Sie sie über Peppol erneut mit demselben Idempotency-Key. Vor dem Versand prüfen Sie den Empfänger über GET /sapi/discovery.
Wie erfahre ich den Zustellstatus?: GET /sapi/document/sent liefert zu jeder Zeile den Status (submitted, delivered, rejected, undeliverable), die Zeiten sentAt, deliveredAt und fsReportedAt und die MLS-Zustellbestätigung. Polling alle 1 bis 5 Minuten ist ein vollwertiger Weg; die Webhooks invoice.delivered, invoice.rejected und invoice.undeliverable sind eine Ergänzung, keine Voraussetzung.
Was kostet das?: Die Anbindung ist kostenlos. Der Dienst kostet ab €2/Monat zzgl. MwSt. je Unternehmens-ID (IČO), die sendet oder das Datenarchiv eingeschaltet hat; Empfang mit ausgeschaltetem Archiv ist kostenlos (bis 1.000 Rechnungen pro Monat). Während der freiwilligen Phase vor der Pflicht ab 1. 1. 2027 ist alles kostenlos.

Starten Sie heute: die Auswahl auf dem Portal der Finanzverwaltung genügt

Empfang kostenlos · ohne Bindung und versteckte KostenErfüllen Sie Ihre gesetzliche Pflicht für 2027 in 2 Minuten

Verteco auf dem Portal der Finančná správa auswählen →Klicken Sie auf dem Portal auf „Pokračovať" (Weiter), melden Sie sich an (slovensko.sk / eID oder Ihre FS-Portal-Zugangsdaten) und bestätigen Sie die Auswahl. Den Rest erledigen wir automatischZertifizierter Anbieter der Finančná správa (EFSK000031) · keine Vertragsbindung · Sie können den Anbieter jederzeit wechseln

Wie läuft die Auswahl ab? (3 Schritte, ~2 Minuten)

1Klicken Sie auf die Schaltfläche oben. Die offizielle Seite der Finančná správa „Výber certifikovaného poskytovateľa" (Auswahl des zertifizierten Anbieters) öffnet sich mit vorausgewähltem Verteco. Klicken Sie auf „Pokračovať" (Weiter).
2Melden Sie sich beim Portal der Finančná správa an, über slovensko.sk (eID / Personalausweis mit Chip) oder mit Ihren PFS-Zugangsdaten, und bestätigen Sie die Anbieterauswahl.
3Fertig. Sie erhalten eine E-Mail mit den Anmeldedaten. Konto, Unternehmen und Peppol-Netzwerkregistrierung erstellen wir automatisch. Hält bereits ein anderer Anbieter Ihren Empfangseintrag, übernehmen wir ihn nicht: Sie erhalten die Anleitung mit dem Migrationscode, oder Sie legen im Portal fest, dass der Empfang dort bleibt und Sie über uns nur versenden.
Keine eID? Beim Portal der Finančná správa können Sie sich auch mit PFS-Kennung und Passwort anmelden. Oder registrieren Sie sich hier mit E-Mail und Passwort, fügen Sie Ihr Unternehmen manuell hinzu und schließen Sie die Auswahl später ab.
Ihr Unternehmen erscheint nicht bei der Auswahl des Steuersubjekts? Angezeigt werden nur Subjekte, für die Sie im FS-Portal autorisiert sind. Fügen Sie die Autorisierung in der Persönlichen Internetzone hinzu (Autorizácie → Pridať autorizovaného používateľa) und schließen Sie die Auswahl ab.
Ausführliche Anleitung zur Auswahl im FS-Portal (auf Slowakisch) →

Verwandt: Peppol-Prüfung eines Unternehmens · Leitfaden E-Rechnung 2027 · Preisliste · alle Integrationen