Rechnungen mit JavaScript automatisch analysieren
Binden Sie die Steuerscan API in Ihre JavaScript- oder Node.js-Anwendung ein — mit fetch und FormData, ohne externe Abhängigkeiten.
Voraussetzungen
- ✓Node.js 18+ — fetch() ist seit Node.js 18 nativ verfügbar
- ✓API-Schlüssel — kostenlos erstellen unter Dashboard → API-Schlüssel
- ✓Keine npm-Pakete nötig — fetch und FormData sind in Node.js 18+ und jedem modernen Browser eingebaut
Registrieren Sie sich kostenlos und erhalten Sie 5 Credits gratis – damit lässt sich die API ohne Risiko ausprobieren.
Node.js-Beispiel
Vollständiges Beispiel zum Lesen einer Rechnung von der Festplatte und Senden an die API. Keine externen Abhängigkeiten — alle verwendeten APIs sind in Node.js 18+ eingebaut.
import { readFile } from "fs/promises";
const API_KEY = "sk_live_IHR_SCHLÜSSEL"; // oder sk_test_... zum Testen
const API_URL = "https://api.steuerscan.de/api/v1/process";
// Zum Testen: const API_URL = "https://api.steuerscan.de/api/v1/test/process";
async function analyseRechnung(dateipfad, beruf = "") {
const dateiinhalt = await readFile(dateipfad);
const dateiname = dateipfad.split("/").pop();
if (dateiinhalt.byteLength > 4 * 1024 * 1024) {
throw new Error("Datei ist größer als 4 MB. Bitte verkleinern bzw. komprimieren Sie sie vor dem Upload.");
}
const formData = new FormData();
formData.append("file", new Blob([dateiinhalt]), dateiname);
if (beruf) formData.append("job_description", beruf);
const response = await fetch(API_URL, {
method: "POST",
headers: { "X-API-Key": API_KEY },
body: formData,
});
if (!response.ok) {
const error = await response.json();
const message = response.status === 413 ? error.message : error.detail;
throw new Error(`API-Fehler ${response.status}: ${message}`);
}
return response.json();
}
// Beispielaufruf
const ergebnis = await analyseRechnung("./rechnung.pdf", "Software Developer");
if (ergebnis.results.mode === "final") {
const { kategorie, absetzbar, grund } = ergebnis.results.result;
console.log(`Kategorie: ${kategorie}`);
console.log(`Absetzbar: ${absetzbar}`);
console.log(`Begründung: ${grund}`);
} else {
console.log(`Kontext erforderlich: ${ergebnis.results.preliminary_reason}`);
}
console.log(`Credits: ${ergebnis.credits_remaining} verbleibend`);Große Fotos vor dem Upload verkleinern
Für Bilder, die größer als 4 MB sind, können Sie vor dem Upload die längste Kante begrenzen und das Foto als JPEG mit Qualität 85 speichern.
import sharp from "sharp";
// Einmalig installieren: npm install sharp
await sharp("./rechnung.jpg")
.resize({ width: 2500, height: 2500, fit: "inside", withoutEnlargement: true })
.jpeg({ quality: 85 })
.toFile("./rechnung-komprimiert.jpg");Browser-Beispiel (File-Input)
Direkte Nutzung im Browser über ein <input type="file">-Element. Funktioniert in jedem modernen Browser ohne zusätzliche Bibliotheken.
// HTML: <input type="file" id="datei" accept=".pdf,.jpg,.png">
// <button onclick="analysieren()">Analysieren</button>
async function analysieren() {
const input = document.getElementById("datei");
const datei = input.files[0];
if (!datei) return alert("Bitte eine Datei auswählen.");
if (datei.size > 4 * 1024 * 1024) {
return alert("Datei ist größer als 4 MB. Bitte verkleinern bzw. komprimieren Sie sie vor dem Upload.");
}
const formData = new FormData();
formData.append("file", datei);
const response = await fetch("https://api.steuerscan.de/api/v1/process", {
method: "POST",
headers: { "X-API-Key": "sk_live_IHR_SCHLÜSSEL" },
body: formData,
});
if (!response.ok) {
const err = await response.json();
const message = response.status === 413 ? err.message : err.detail;
alert(`Fehler: ${message}`);
return;
}
const ergebnis = await response.json();
if (ergebnis.results.mode === "final") {
const r = ergebnis.results.result;
console.log(`${r.kategorie} – ${r.absetzbar ? "absetzbar" : "nicht absetzbar"}`);
} else {
console.log(`Kontext erforderlich: ${ergebnis.results.preliminary_reason}`);
}
}Antwort-Struktur
Die API gibt 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 ...",
"bedingungen": [],
"hinweise": ["GWG bis 800€ ..."],
"quellen": ["https://www.gesetze-im-internet.de/estg/__9.html"]
},
"preliminary_reason": null,
"context_tree": null
},
"credits_remaining": 42
}Bei mode: "needs_context" starten Sie am context_tree.root_node_id und folgen nach jeder Auswahl dem next_node_id, bis ein Ergebnis-Knoten erreicht ist. Diese Auswahl erfolgt lokal mit der vorhandenen Antwort und verbraucht weder einen weiteren API-Request noch einen zusätzlichen Credit.
Fehlerbehandlung
Wrapper mit zentraler Behandlung der wichtigsten HTTP-Fehlercodes (401 = ungültiger Schlüssel, 403 = keine Credits mehr, 413 = Datei zu groß). Bei 413 antwortet das Gateway mit {"message": "Request Entity Too Large"} statt mit dem üblichen Fehlerformat.
async function analyseRechnungMitFehler(dateipfad) {
try {
const ergebnis = await analyseRechnung(dateipfad);
return ergebnis;
} catch (error) {
if (error.message.includes("401")) {
console.error("Ungültiger API-Schlüssel.");
} else if (error.message.includes("403")) {
console.error("Keine Credits mehr. Bitte Credits kaufen.");
} else if (error.message.includes("413")) {
console.error("Datei zu groß. Gateway-Meldung:", error.message);
} else {
console.error("Fehler:", error.message);
}
return null;
}
}Häufige Fragen
Node.js 18 oder neuer. fetch() ist seit Node.js 18 nativ verfügbar — keine zusätzlichen Pakete nötig.
Ja, die Steuerscan API lässt sich auch direkt im Browser nutzen. Bei Produktivanwendungen sollten Sie den API-Schlüssel jedoch über Ihren eigenen Server weiterleiten, damit er nicht im Browser-Code sichtbar ist.
Nein, aber fetch() und FormData sind in jedem modernen Browser und Node.js 18+ eingebaut — ein SDK ist nicht nötig.
Weitere Integrationen
Jetzt kostenlos starten
Registrieren Sie sich, erhalten Sie 5 Credits gratis und integrieren Sie die Steuerscan API in wenigen Minuten in Ihre JavaScript-Anwendung.