API-Integration

Dynafis API

Rechnungsdaten kontrolliert in ERP-, DMS-, Buchhaltungs- und individuelle Finanzprozesse einbinden.

API-Zugang anfragen API-Verwaltung öffnen Technische Doku öffnen

Workspace-Anmeldung erforderlich

Zugänge und Integrationswege

Workspace External API

im Workspace verfügbar

Dokumente hochladen, Status lesen, Exportformate abrufen, Exporte anfordern und Monatsprozesse integrieren.

Dynafis Convert

öffentlicher Ablauf verfügbar

Öffentlicher Ablauf für Upload, Extraktion, Review, Validierung, Artefakterzeugung und geschützte strukturierte Downloads.

Dynafis Verify / QR

öffentlicher Ablauf verfügbar

Aus Convert erzeugte Prüf-Links und QR-Codes zeigen begrenzte Metadaten. Strukturierte Downloads bleiben geschützt.

Webhooks

im Workspace verfügbar

Dokument-, Rechnungs-, Export- und Monatsprozess-Ereignisse an eigene Systeme zustellen.

API-Schlüssel und Nutzung

im Workspace verfügbar

Scopes, Rate Limits, Nutzung und Sandbox-/Live-Schlüssel im Workspace verwalten.

Implementierungsstatus

POST /api/v1/documents Dokument in den Workspace-Workflow hochladen im Workspace verfügbar

GET /api/v1/documents/{document_id} Dokumentstatus und Metadaten lesen im Workspace verfügbar

GET /api/v1/invoices/{invoice_id} Rechnungs- und Prüfstatus lesen im Workspace verfügbar

GET /api/v1/export-formats Freigegebene Exportformate abrufen im Workspace verfügbar

POST /api/v1/invoices/{invoice_id}/exports Exportanforderung an die interne Pipeline übergeben im Workspace verfügbar

POST /api/convert/jobs Öffentlichen Convert-Vorgang erstellen öffentlicher Ablauf verfügbar

POST /api/convert/jobs/{job_id}/validate Daten gegen den gewählten Zielformat-Prüfer prüfen öffentlicher Ablauf verfügbar

POST /api/convert/jobs/{job_id}/generate Artefakt erzeugen; Download bleibt bis zur Freigabe geschützt öffentlicher Ablauf verfügbar

POST /api/v1/convert/extract Versionierter External-API-Zugang für Convert auf Anfrage / geplant

POST /api/v1/verify-links Versionierter External-API-Zugang für Verify/QR auf Anfrage / geplant

Zugriff und Verantwortung

API-Schlüssel werden im Workspace erzeugt und nur einmal vollständig angezeigt. Scopes, Limits, Nutzung, Webhooks sowie Sandbox-/Live-Trennung werden serverseitig ausgewertet. Schreibende Aufrufe sollten einen Idempotency-Key verwenden.

Klare Produktgrenzen

Die authentifizierte Workspace API deckt Dokumente, Rechnungsstatus, Exportformate, Exportpakete und Monatsprozesse ab. Der öffentliche Convert-Ablauf verwendet eigene /api/convert-Endpunkte. Versionierte /api/v1-Endpunkte für Convert und Verify werden erst dann als verfügbar ausgewiesen, wenn sie implementiert und freigegeben sind.