APIEntwicklerREST · DSGVO · EU-ServerAktualisiert 20. Oktober 2026

Rechnungen per API auf Absetzbarkeit prüfen

Die Steuerscan REST API analysiert Rechnungen und Belege per KI auf steuerliche Absetzbarkeit nach deutschem Steuerrecht — DSGVO-konform auf EU-Servern (Frankfurt), 1 Credit pro Analyse.

2–4 s
Antwortzeit
pro Analyse
1 Credit
pro Analyse
5 Credits gratis bei Registrierung
§9, §35a
EStG
Geprüfte Gesetzesparagraphen

Was ist die Steuerscan API?

Die Steuerscan REST API analysiert Rechnungen und Belege per KI auf steuerliche Absetzbarkeit nach deutschem Steuerrecht — DSGVO-konform auf EU-Servern (Frankfurt), 1 Credit pro Analyse.

Einfache REST API

Ein einziger POST-Endpunkt. Datei als Form-Data, API-Key im Header — in jeder Sprache und jedem Tool integrierbar.

DSGVO-konform

Verarbeitung ausschließlich auf EU-Servern (Frankfurt). Daten werden nach der Analyse sofort gelöscht und nie zum KI-Training verwendet.

Günstig & flexibel

1 Credit = 1 Analyse. Keine monatlichen Gebühren, keine Mindestabnahme. Credits verfallen nie. 5 Credits gratis bei Registrierung.

API-Schlüssel erstellen

Registrieren Sie sich, erhalten Sie 5 Credits gratis und erstellen Sie Ihren ersten API-Key in wenigen Sekunden.

Kostenlos starten →

Schnellstart

1

API-Schlüssel erstellen

Registrieren Sie sich bei Steuerscan (5 Credits gratis) und erstellen Sie unter Dashboard → API-Schlüssel einen neuen Schlüssel. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt.

2

Request senden

Senden Sie einen POST-Request mit Ihrer Rechnung als Form-Data:

curl -X POST https://api.steuerscan.de/api/v1/process \
  -H "X-API-Key: sk_live_IHR_SCHLÜSSEL" \
  -F "file=@rechnung.pdf" \
  -F "job_description=Software Developer"
TestbetriebEchtbetrieb
Endpunkt/api/v1/test/process/api/v1/process
API-Schlüsselsk_test_...sk_live_...
Kostenkostenlos1 Credit / Analyse
3

Ergebnis auswerten

Die API liefert ein strukturiertes JSON-Objekt zurück:

{
  "results": {
    "mode": "final",
    "result": {
      "kategorie": "Arbeitsmittel",
      "abzugsart": "Werbungskosten",
      "absetzbar": true,
      "absetzbar_fuer_bestimmte_berufe": false,
      "verdict": "absetzbar",
      "confidence": "high",
      "missing_information": [],
      "requires_user_confirmation": false,
      "grund": "Der Laptop ist als Arbeitsmittel nach §9 EStG...",
      "bedingungen": [],
      "hinweise": ["Für Arbeitnehmer ohne Vorsteuerabzug gilt die GWG-Grenze inklusive Umsatzsteuer."],
      "quellen": ["https://www.gesetze-im-internet.de/estg/__9.html"]
    },
    "preliminary_reason": null,
    "context_tree": null
  },
  "credits_remaining": 42
}

Welche Parameter nimmt die API entgegen?

X-API-KeyHEADERERFORDERLICH

Ihr API-Schlüssel. Beginnt mit sk_live_ (Echtbetrieb) oder sk_test_ (Testbetrieb, kostenlos).

fileBODYERFORDERLICH

Die Rechnung oder der Beleg als Form-Data. Unterstützte Formate: PDF, JPG, JPEG, PNG, HEIC, HEIF. Maximale Dateigröße: 4 MB.

job_descriptionBODYOPTIONAL

Berufsbezeichnung des Nutzers (z.B. Software Developer). Verbessert die Analyse für berufsbedingte Ausgaben nach §9 EStG.

Große Dateien

Upload-Limit: 4 MB pro Datei.

Größere Anfragen werden bereits vom API-Gateway abgelehnt, bevor sie Steuerscan erreichen: HTTP 413 mit Body {"message": "Request Entity Too Large"} — dieses Format weicht vom üblichen Fehlerformat {"detail": {"error": ..., "message": ...}} ab. Ab ca. 10 MB kann die Verbindung ohne lesbare Antwort abbrechen. Es wird kein Credit verbraucht.

Empfehlung: Prüfen Sie die Dateigröße vor dem Upload clientseitig; verkleinern Sie Fotos vorher, z. B. auf eine längste Kante von 2500 px und JPEG-Qualität 85.

Bei Dateien zwischen 4 MB und der Gateway-Grenze lehnt die API mit HTTP 400 und {"detail": {"error": "file_too_large", ...}} ab.

PDFs über 4 MB vorab komprimieren oder auf die relevanten Seiten kürzen – analysiert werden ohnehin nur die ersten 3 Seiten.

Weitere Hinweise finden Sie im n8n-Rezept für große Dateien.

Was gibt die API zurück?

Sofortiges Ergebnis

Bei mode: "final" lesen Sie die Abzugsfelder aus results.result.

{
  "results": {
    "mode": "final",
    "result": {
      "kategorie": "Arbeitsmittel",
      "abzugsart": "Werbungskosten",
      "absetzbar": true,
      "absetzbar_fuer_bestimmte_berufe": false,
      "verdict": "absetzbar",
      "confidence": "high",
      "missing_information": [],
      "requires_user_confirmation": false,
      "grund": "Der Laptop ist als Arbeitsmittel nach §9 EStG...",
      "bedingungen": [],
      "hinweise": ["Für Arbeitnehmer ohne Vorsteuerabzug gilt die GWG-Grenze inklusive Umsatzsteuer."],
      "quellen": ["https://www.gesetze-im-internet.de/estg/__9.html"]
    },
    "preliminary_reason": null,
    "context_tree": null
  },
  "credits_remaining": 42
}

Kontext erforderlich

Bei mode: "needs_context" starten Sie am root_node_id. Nach einer Auswahl suchen Sie in den Optionen das passende value und öffnen den Knoten aus next_node_id. Das wiederholen Sie, bis type: "result" erreicht ist. Dessen result enthält dieselben Abzugsfelder wie ein sofortiges Ergebnis.

{
  "results": {
    "mode": "needs_context",
    "result": null,
    "preliminary_reason": "Die Zahlungsart entscheidet über die Absetzbarkeit.",
    "context_tree": {
      "root_node_id": "payment",
      "nodes": {
        "payment": {
          "type": "question",
          "question_id": "payment_method",
          "options": [
            {"value": "cashless", "next_node_id": "cashless_result"},
            {"value": "cash", "next_node_id": "cash_result"}
          ]
        },
        "cashless_result": {
          "type": "result",
          "result": {
            "kategorie": "Haushaltsnahe Dienstleistungen",
            "abzugsart": "Steuerermäßigung",
            "absetzbar": true,
            "absetzbar_fuer_bestimmte_berufe": false,
            "verdict": "absetzbar",
            "confidence": "high",
            "missing_information": [],
            "requires_user_confirmation": false,
            "grund": "Die unbar bezahlte Leistung ist nach §35a EStG begünstigt.",
            "bedingungen": [],
            "hinweise": [],
            "quellen": ["https://www.gesetze-im-internet.de/estg/__35a.html"]
          }
        },
        "cash_result": {
          "type": "result",
          "result": {
            "kategorie": null,
            "abzugsart": null,
            "absetzbar": false,
            "absetzbar_fuer_bestimmte_berufe": false,
            "verdict": "nicht_absetzbar",
            "confidence": "high",
            "missing_information": [],
            "requires_user_confirmation": false,
            "grund": "Bar gezahlte Leistungen sind nach §35a EStG nicht begünstigt.",
            "bedingungen": [],
            "hinweise": ["Für die Steuerermäßigung ist eine unbare Zahlung erforderlich."],
            "quellen": ["https://www.gesetze-im-internet.de/estg/__35a.html"]
          }
        }
      }
    }
  },
  "credits_remaining": 42
}

Die Auswahl wird ausschließlich lokal in Ihrer Anwendung ausgewertet. Senden Sie keine Folgeanfrage: Das kostet weder einen weiteren API-Request noch einen zusätzlichen Credit.

results.mode"final" | "needs_context"

Zeigt, ob das Ergebnis sofort feststeht oder lokal noch eine Kontextauswahl nötig ist.

results.resultobject | null

Vollständiges Abzugsergebnis bei mode „final“. Bei „needs_context“ ist dieses Feld null; vollständige Ergebnisse stehen dann in den Ergebnis-Knoten des context_tree.

results.preliminary_reasonstring | null

Kurze Erklärung, warum noch Kontext benötigt wird. Nur bei mode „needs_context“ gesetzt.

results.context_treeobject | null

Validierter Entscheidungsbaum für mode „needs_context“. Starten Sie bei root_node_id und folgen Sie der gewählten Option über next_node_id bis zu einem Ergebnis-Knoten.

results.result.abzugsartstring | null

Übergeordnete Einordnung, z.B. „Werbungskosten“ oder „Steuerermäßigung“.

results.result.kategoriestring | null

Steuerliche Kategorie der Ausgabe (z.B. „Arbeitsmittel", „Reisekosten“); null bei nicht absetzbaren Ausgaben.

results.result.absetzbarboolean

true, wenn die Ausgabe steuerlich absetzbar ist.

results.result.absetzbar_fuer_bestimmte_berufeboolean

true, wenn die Absetzbarkeit nur für bestimmte Berufsgruppen gilt.

results.result.grundstring

Begründung der Entscheidung mit Verweis auf die relevante Rechtsgrundlage.

results.result.bedingungenstring[]

Liste von Bedingungen, die für die Absetzbarkeit erfüllt sein müssen.

results.result.hinweisestring[]

Zusätzliche steuerliche Hinweise, z.B. zu GWG-Grenzen oder Sonderregelungen.

results.result.quellenstring[]

Amtliche Quellen, die die Einschätzung stützen.

credits_remaininginteger

Verbleibende Credits auf Ihrem Konto nach dieser Analyse.

Was bedeuten Fehler 400, 401, 403 und 413?

400Datei zu groß
{"detail": {"error": "file_too_large", "message": "Datei ist zu groß (4.20MB). Maximale Größe ist 4 MB."}}
401Ungültiger API-Schlüssel
{"detail": "Invalid API key"}
403Keine Credits
{"detail": "Insufficient credits"}
413Anfrage zu groß
{"message": "Request Entity Too Large"}

Welche Sprachen und Tools werden unterstützt?

Häufige Fragen zur API

Die API akzeptiert PDF, JPG, JPEG, PNG, HEIC und HEIF. Die maximale Dateigröße beträgt 4 MB pro Datei.

Eine Analyse dauert typischerweise 2–4 Sekunden: OCR-Erkennung des Dokuments, KI-Analyse nach deutschem Steuerrecht (§9, §35a, §4 EStG) und Rückgabe des strukturierten JSON-Ergebnisses.

Ja. Die gesamte Verarbeitung läuft auf AWS-Servern in Frankfurt (eu-central-1). Hochgeladene Dokumente werden nach der Analyse sofort gelöscht und nie zum KI-Training verwendet.

1 Credit pro Analyse. Bei der Registrierung erhalten Sie 5 Credits gratis. Credits verfallen nie. Es gibt keine Grundgebühr oder Mindestabnahme.

Ja. Mit einem Test-API-Schlüssel (sk_test_...) rufen Sie den Endpunkt /api/v1/test/process kostenlos auf. Er liefert eine statische Testantwort ohne echte KI-Analyse und ohne Credits zu verbrauchen.

Steuerscan API im Web

Bereit für den ersten API-Call?
Erstellen Sie jetzt unter Dashboard → API-Schlüssel Ihren ersten Schlüssel — oder sehen Sie sich die Preise an. 5 Credits gratis bei Registrierung, keine Grundgebühr.