Übersicht
Die Invovate Rechnungs-API ermöglicht Entwicklern die automatisierte Erstellung professioneller Rechnungen über einen einfachen HTTP-POST-Aufruf. Sie können zwischen einer strukturierten JSON-Antwort mit allen Berechnungen oder einem direkten PDF-Download wählen. Die API unterstützt 11 Sprachen, mehr als 20 Währungen und 5 Designvorlagen — ideal für deutsche Freiberufler, SaaS-Unternehmen und Buchhaltungsanwendungen.
Kostenlos starten
40 Anfragen/Stunde, keine Kreditkarte
JSON oder PDF
Wählen Sie Ihr Ausgabeformat
MwSt.-Berechnung
Pro Position oder global (19%/7%)
Mehrsprachig
de, en, fr, nl, es und mehr
Basis-URL:
https://invovate.com/api
Schnellstart
Ihre erste Rechnung in drei Schritten erstellen:
Schritt 1 — Konto erstellen
Registrieren Sie sich kostenlos auf invovate.com und verifizieren Sie Ihre E-Mail-Adresse.
Registrieren Sie sich kostenlos auf invovate.com und verifizieren Sie Ihre E-Mail-Adresse.
Schritt 2 — API-Schlüssel abrufen
Öffnen Sie das Dashboard und klicken Sie auf "API-Schlüssel generieren". Ihr Schlüssel beginnt mit
Öffnen Sie das Dashboard und klicken Sie auf "API-Schlüssel generieren". Ihr Schlüssel beginnt mit
inv_.
Schritt 3 — Ersten Aufruf durchführen
curl -X POST https://invovate.com/api/generate-invoice \
-H "Content-Type: application/json" \
-H "Authorization: Bearer inv_ihrApiSchluessel" \
-d '{
"from": {"name": "Muster GmbH"},
"to": {"name": "Kunde GmbH"},
"items": [{"description": "Beratung", "quantity": 1, "unit_price": 2000, "tax_rate": 19}],
"invoice": {"currency": "EUR", "language": "de"}
}'
Authentifizierung
Die API unterstützt drei Authentifizierungsmethoden:
1. API-Schlüssel (empfohlen für serverseitige Nutzung)
Authorization: Bearer inv_ihrApiSchluesselHier
2. Sitzungs-Cookie (für Webanwendungen)
Wenn Sie über den Browser eingeloggt sind, wird das Sitzungs-Cookie inv_session automatisch mitgesendet.
3. Anonym (ohne Authentifizierung)
Aufrufe ohne Authentifizierung sind möglich, aber auf JSON-Ausgabe beschränkt und werden per IP-Adresse limitiert. Geeignet zum Testen der API.
Sicherheit: Verarbeiten Sie Ihren API-Schlüssel niemals in clientseitigem Code oder speichern Sie ihn in einem Git-Repository. Verwenden Sie Umgebungsvariablen auf Ihrem Server.
Limits & Tarife
| Tarif | Preis | Pro Stunde | Pro Woche |
|---|---|---|---|
| Kostenlos | 0 € | 40 | 400 |
| Starter | 9 €/Monat | 200 | 4.000 |
| Pro | 29 €/Monat | 1.000 | 40.000 |
| Enterprise | Auf Anfrage | Unbegrenzt | Unbegrenzt |
Die Limits werden über die Antwort-Header zurückgegeben:
X-RateLimit-Limit-Hourly: 40
X-RateLimit-Remaining-Hourly: 39
X-RateLimit-Reset-Hourly: 1712123456
X-RateLimit-Limit-Weekly: 400
X-RateLimit-Remaining-Weekly: 399
X-RateLimit-Reset-Weekly: 1712345678
Rechnung erstellen
POST
/api/generate-invoice
Erstellt eine Rechnung und gibt entweder JSON mit allen Berechnungen oder eine binäre PDF-Datei zurück.
Anforderungsformat
Absender (from)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| from.name | string | Ja | Ihr Unternehmensname |
| from.address | string | Nein | Ihre Unternehmensadresse |
| from.email | string | Nein | Ihre E-Mail-Adresse |
| from.tax_id | string | Nein | USt-IdNr. (z.B. DE123456789) |
Empfänger (to)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| to.name | string | Ja | Name des Kunden oder Unternehmens |
| to.address | string | Nein | Adresse des Kunden |
| to.email | string | Nein | E-Mail-Adresse des Kunden |
Rechnungsdaten (invoice)
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| invoice.number | string | Auto | Rechnungsnummer |
| invoice.date | string | Heute | Rechnungsdatum (JJJJ-MM-TT) |
| invoice.due_date | string | — | Fälligkeitsdatum (JJJJ-MM-TT) |
| invoice.currency | string | USD | Währungscode (z.B. EUR) |
| invoice.language | string | en | Sprachcode (z.B. de) |
| invoice.terms | string | — | Zahlungsbedingungen |
| invoice.po_number | string | — | Bestellnummer |
Positionen (items-Array)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| description | string | Ja | Beschreibung der Leistung oder des Produkts |
| quantity | number | Ja | Anzahl der Einheiten |
| unit_price | number | Ja | Preis pro Einheit (netto) |
| discount | number | Nein | Rabatt (Prozent oder Betrag) |
| discount_type | string | percent | "percent" oder "amount" |
| tax_rate | number | Nein | MwSt.-Satz pro Position (z.B. 19) |
Weitere Felder
| Feld | Typ | Beschreibung |
|---|---|---|
| global_tax | number | Globaler MwSt.-Satz (gilt wenn kein positionsspezifischer Satz gesetzt) |
| global_discount | number | Rabatt auf den Gesamtbetrag |
| global_discount_type | string | "percent" oder "amount" |
| amount_paid | number | Bereits bezahlter Betrag (für Teilzahlung) |
| notes | string | Anmerkungen am Ende der Rechnung |
| refund_policy | string | Rückerstattungsrichtlinie |
| template | string | Vorlagenname: classic, modern, bold, minimal, navy |
| output | string | "json" (Standard) oder "pdf" |
Antwortformat
JSON-Antwort (output: "json")
{
"success": true,
"invoice": {
"number": "RE-2026-042",
"date": "2026-04-03",
"due_date": "2026-05-03",
"currency": "EUR",
"language": "de",
"template": "classic",
"from": { "name": "Muster GmbH", "tax_id": "DE123456789" },
"to": { "name": "Kunde GmbH" },
"items": [
{
"description": "Webentwicklung",
"quantity": 1,
"unit_price": 2000,
"discount": 0,
"tax_rate": 19,
"tax_amount": 380.00,
"line_total": 2380.00
}
],
"subtotal": 2000.00,
"global_discount": 0,
"total_tax": 380.00,
"grand_total": 2380.00,
"amount_paid": 0,
"balance_due": 2380.00,
"notes": "Vielen Dank fuer Ihren Auftrag!"
},
"meta": {
"processing_ms": 12,
"credits_remaining": { "hourly": 39, "weekly": 399 },
"rate_limits": {
"hourly": { "limit": 40, "used": 1, "reset_at": 1712123456 },
"weekly": { "limit": 400, "used": 1, "reset_at": 1712345678 }
}
}
}
PDF-Antwort (output: "pdf")
Gibt eine binäre PDF-Datei mit folgenden Headern zurück:
Content-Type: application/pdf
Content-Disposition: attachment; filename="rechnung.pdf"
Fehlercodes
{
"success": false,
"error": { "message": "Mindestens eine Position ist erforderlich" }
}
| HTTP-Status | Bedeutung |
|---|---|
| 400 | Validierungsfehler — prüfen Sie Ihr Anforderungsformat |
| 401 | Authentifizierung erforderlich oder API-Schlüssel ungültig |
| 403 | E-Mail-Adresse nicht verifiziert |
| 429 | Ratenlimit überschritten |
| 500 | Interner Serverfehler |
Authentifizierungs-Endpoints
| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | /api/auth/register | Konto mit E-Mail und Passwort erstellen |
| POST | /api/auth/login | Einloggen, gibt Sitzungs-Cookie zurück |
| POST | /api/auth/logout | Ausloggen |
| GET | /api/auth/me | Aktuelle Benutzerinfos und API-Schlüssel abrufen |
| POST | /api/auth/generate-api-key | Neuen API-Schlüssel generieren (verifizierte E-Mail erforderlich) |
Codebeispiele
cURL — PDF-Rechnung mit MwSt.
curl -X POST https://invovate.com/api/generate-invoice \
-H "Content-Type: application/json" \
-H "Authorization: Bearer inv_ihrApiSchluessel" \
-d '{
"from": {
"name": "Webdesign Berlin GmbH",
"address": "Unter den Linden 10, 10117 Berlin",
"tax_id": "DE123456789"
},
"to": {
"name": "Auftraggeber GmbH",
"address": "Maximilianstr. 1, 80539 Muenchen",
"email": "[email protected]"
},
"invoice": {
"number": "RE-2026-042",
"date": "2026-04-03",
"due_date": "2026-05-03",
"currency": "EUR",
"language": "de",
"terms": "30 Tage netto"
},
"items": [
{"description": "Website-Entwicklung", "quantity": 1, "unit_price": 4500, "tax_rate": 19},
{"description": "SEO-Beratung", "quantity": 10, "unit_price": 120, "tax_rate": 19}
],
"notes": "Vielen Dank fuer Ihren Auftrag!",
"template": "modern",
"output": "pdf"
}' --output rechnung.pdf
JavaScript (Node.js)
// Rechnung mit der Invovate API erstellen
const response = await fetch('https://invovate.com/api/generate-invoice', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer inv_ihrApiSchluessel'
},
body: JSON.stringify({
from: { name: 'Muster GmbH', tax_id: 'DE123456789' },
to: { name: 'Kunde GmbH', email: '[email protected]' },
invoice: { number: 'RE-001', currency: 'EUR', language: 'de', due_date: '2026-05-03' },
items: [{ description: 'Beratungsleistung', quantity: 8, unit_price: 150, tax_rate: 19 }],
output: 'json'
})
});
const data = await response.json();
if (data.success) {
console.log('Gesamtbetrag (inkl. MwSt.):', data.invoice.grand_total, 'EUR');
console.log('Verbleibende Anfragen (stundlich):', data.meta.credits_remaining.hourly);
}
Python
import requests
API_KEY = "inv_ihrApiSchluessel"
URL = "https://invovate.com/api/generate-invoice"
rechnung = {
"from": { "name": "Freelancer Hamburg", "tax_id": "DE123456789" },
"to": { "name": "Kundenunternehmen GmbH", "address": "Koenigsallee 1, 40212 Duesseldorf" },
"invoice": { "number": "RE-2026-001", "currency": "EUR", "language": "de", "terms": "30 Tage netto" },
"items": [
{"description": "Grafikdesign", "quantity": 1, "unit_price": 1200, "tax_rate": 19},
{"description": "Druckdaten", "quantity": 3, "unit_price": 80, "tax_rate": 19}
],
"output": "pdf"
}
response = requests.post(URL, json=rechnung, headers={"Authorization": f"Bearer {API_KEY}"})
if response.status_code == 200:
with open("rechnung.pdf", "wb") as f:
f.write(response.content)
print("Rechnung gespeichert als rechnung.pdf")
else:
print(f"Fehler: {response.json()['error']['message']}")
Unterstützte Sprachen
| Code | Sprache | Schreibrichtung |
|---|---|---|
de | Deutsch | LTR |
en | Englisch | LTR |
nl | Niederländisch | LTR |
fr | Französisch | LTR |
es | Spanisch | LTR |
it | Italienisch | LTR |
pt | Portugiesisch | LTR |
ru | Russisch | LTR |
hi | Hindi | LTR |
ja | Japanisch | LTR |
ar | Arabisch | RTL |
PDF-Vorlagen
| Name | Stil |
|---|---|
classic | Blauer Akzent, abwechselnde graue Zeilen (Standard) |
modern | Teal/Cyan, klares modernes Design |
bold | Dunkle Anthrazit-Kopfzeile, hoher Kontrast |
minimal | Hellgrau, randlos |
navy | Tiefblaue Kopfzeile mit goldenem Akzentstreifen |
Unterstützte Währungen
EUR, USD, GBP, JPY, CAD, AUD, CHF, CNY, INR, AED, SAR, SGD, NZD, KRW, BRL, MXN, ZAR, SEK, NOK, DKK