Dokumentation für Integrationen zu Lookup, Validierung, Versand, Empfang, Webhooks und Audit-Ausgaben. Beschreibt den empfohlenen Deployment-Ansatz, Sicherheitsregeln und Integrationsszenarien.
Verfügbare Endpunkte können je nach Umgebung und Deployment-Typ variieren. Produktivschlüssel gehören auf den Server, nicht in den Browser. Das öffentliche Frontend darf private Produktivrouten nicht direkt aufrufen.
Private API-Schlüssel gehören auf den Server, nicht in Browser-JS. Versand und Retries sollten einen Idempotency-Key verwenden.
Endpunkte berücksichtigen nicht nur den Versand, sondern auch Empfang, Freigaben, Response-Codes, Evidence-Pakete und den Archiv-Flow.
Ein Integrator braucht einen kurzen Quickstart, Payload-Beispiele, Retry-Regeln, Webhooks und einen klaren Unterschied zwischen Test- und Prod-Modus.
Für Enterprise-Kunden ist ein vollautomatisierter Ablauf wichtig: Das System nimmt einen Feed entgegen, validiert ihn, konvertiert ihn, sendet ihn und gibt die finalen Artefakte zurück ins Archiv oder ERP.
Die Integration berücksichtigt einen JSON/XML-Feed, Batch-Verarbeitung und sichere Kanäle wie SFTP. Das Interface Control Document kann die Form einer OpenAPI/Swagger-Spezifikation mit Mapping- und Retry-Regeln haben.
Bei einem Fehler sollte das System einen detaillierten Grund, die Rule-ID, den XML-Knoten und eine Korrekturempfehlung zurückgeben. Die Korrekturquelle bleibt das Quellsystem, und eFaktúra centrum gibt das Ergebnis per Webhook zurück.
Enterprise-Kunden brauchen oft die finale XML- und PDF-Datei zurück, ein Portal zur Übersicht verarbeiteter Rechnungen und die Möglichkeit, eine eigene, gebrandete PDF-Vorlage vorzubereiten.
Vertrag für Feed, Mapping, Fehlerkatalog, Versionierung und Checkliste für Enterprise-Teams.
Delivery-Lifecycle, Callback-Payloads, Signaturmodell, Retries und Event-Reihenfolge.
Rückgabe des finalen XML/PDF, individuelles Vorlagenpaket und Archiv-Übergabe ins interne System des Kunden.
Promotion-Checkliste, Test-Payloads, Idempotenz-Schutzmaßnahmen und Cutover-Regeln vor dem Livegang.
Rule-IDs, Schweregrad, XML-Pfad, Korrekturhinweise und ein Owner-Modell für Enterprise-Triage.
Namenskonventionen, Manifeste, ACK-Dateien, Teil-Retry und Nachvollziehbarkeit für Corporate-Feeds.
EU-Datenresidenz, Audit-Logs, Aufbewahrung und das Enterprise-Betriebsmodell für die technische Prüfung.
SSO, Lifecycle und Rollen-Governance für Corporate-Tenants und Integrationsteams.
Pay-as-you-go API, Pläne für Steuerberater und Enterprise-Middleware in einem kommerziellen Modell.
Trennung von Admin-, Buchhalter- und Entwicklerrechten inklusive API-Keys und Audit-Rollen.
Prioritätsliste von Systemen für den slowakischen Markt mit Kompatibilitätsstatus. Der Import funktioniert bereits mit POHODA XML, KROS-Exporten, Money/MRP CSV und ISDOC; weitere direkte Konnektoren kommen schrittweise dazu.
Technische Baseline für Edge-Header, CORS, Payload-Kontrollen, Auth und Enterprise-Hardening.
Statusseite, Webhook-Delivery-Log, Correlation-IDs und Incident-Reporting für Enterprise-Support.
e-Discovery-Paket für Kunden, die einen XML/PDF/Log-Export für einen Zeitraum benötigen.
Regeln, PO-Matching, Disputes und Smart Intake für fortgeschrittenere Automatisierungsszenarien.
Factur-X, Clearance und Roaming als Multi-Country-Richtung für weitere Integrationen.
Partner-Lookup im Format 0245:2020123456. Ausgabe: Registrierung, Name, unterstützte Dokumente, Readiness-Status und empfohlener Kanal.
Die XML-Validierung liefert rule_id, den Schweregrad des Problems und eine Korrekturempfehlung. In einer lokalen Übersicht sollte immer klar gekennzeichnet sein, dass es sich nicht um ein Produktivergebnis handelt.
Excel, CSV oder vorbereitete Exporte als Eingabe, ein ZIP mit fertigen XML-Dateien oder ein Batch-Report als Ausgabe. Geeignet für einen schrittweisen Übergang ohne neues ERP.
Vorbereitung und Versand des Dokuments über einen angebundenen zertifizierten Partner, mit Schwerpunkt auf Idempotency-Key, Transmission-ID, Evidence und nachfolgenden Response-Events.
Übersicht über ACK, NACK, Ablehnung und weitere Events inklusive geschäftlicher Bedeutung und Verarbeitungszeitachse.
Paket für Audit oder interne Prüfung: Payload, Validierungszusammenfassung, Response-Events, Regelversion und Verarbeitungszeitachse.
Die folgenden Beispiele dienen als Sandbox- oder serverseitiges Integrationsmuster. Produktiv-URL, Autorisierung und verfügbare Endpunkte hängen vom gewählten Deployment ab.
Die Transportebene hat die Zustellung ins Netzwerk oder an den Empfänger bestätigt.
Transport- oder Business-Ablehnung. Öffnet typischerweise den Remediation-Flow.
Bedingte Annahme, Timeout oder ein Konflikt in den Workflow-Daten.
Das Dokument wurde abgeschlossen und mit einem Evidence-Paket zur Archivierung markiert.
Die finale XML- und PDF-Datei sind bereit für die Rückgabe ins interne Archiv oder Billing-System des Kunden.
Eingaben mit geringem Vertrauen sollten durch manuelle Prüfung laufen, nicht durch autonomen Versand.
Peppol ID, Steuernummer, IBAN und Partner-Kennungen müssen vor einem Batch validiert werden.
Ein ACK bedeutet keine geschäftliche Annahme. Der Workflow sollte auf das nächste Response-Event warten.
Bei einem nicht bereiten Partner einen empfohlenen Kanal zurückgeben, nicht nur eine "Partner nicht gefunden"-Meldung.