FiscalLayer | E-Invoice Compliance Infrastructure

API-Referenz

Integrieren Sie FiscalLayer-Validierung in Ihre Systeme mit unserer REST-API.

Basis-URL

https://api.fiscallayer.de/v1

Alle API-Endpunkte werden von dieser Basis-URL bedient. HTTPS ist erforderlich.

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel im X-API-Key-Header:

Header

X-API-Key: your_api_key_here

Während der Demo-Phase werden API-Schlüssel auf Anfrage bereitgestellt. Kontaktieren Sie uns für Zugang.

Rechnung validieren

POST/invoices/validate

Reichen Sie eine Rechnung zur synchronen Validierung ein. Gibt sofort Ergebnisse zurück.

Request Body

{
  "content": "<base64_encoded_invoice>",
  "filename": "invoice.xml",
  "options": {
    "skipExternalValidation": false
  }
}

Response

{
  "decision": "OK" | "WARNING" | "ERROR",
  "format": "xrechnung" | "zugferd" | "peppol-bis",
  "diagnostics": [...],
  "summary": {...}
}

Async Jobs

POST/jobs

Für große Dateien oder Stapelverarbeitung erstellen Sie einen asynchronen Job:

GET/jobs/:id

Fragen Sie diesen Endpunkt ab, um den Job-Status zu prüfen und Ergebnisse abzurufen.

Response-Codes

200Erfolg - Validierung abgeschlossen

400Ungültige Anfrage - ungültiges Eingabeformat

401Nicht autorisiert - ungültiger oder fehlender API-Schlüssel

429Rate begrenzt - zu viele Anfragen

Beispielanfrage

cURL

curl -X POST https://api.fiscallayer.de/v1/invoices/validate \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Li4u",
    "filename": "invoice.xml"
  }'

API-Zugang erhalten

Probieren Sie zuerst die Demo aus, dann kontaktieren Sie uns für API-Zugangsdaten.

Demo ausprobieren