Welche Endpunkte und Datenfelder sind für den automatisierten Belegupload über die…
- User
Welche Endpunkte und Datenfelder sind für den automatisierten Belegupload über die Lexoffice API mit N8N nötig?
Assistant
Für den automatisierten Belegupload in Lexoffice via API mit n8n sind folgende Endpunkte und Datenfelder erforderlich:
1. Authentifizierung
- Endpunkt:
https://app.lexoffice.de/api/oauth2/authorize(nur für initialen OAuth-Flow) - Token-Endpunkt:
https://app.lexoffice.de/api/oauth2/token
Header:
Body:{ "Authorization": "Basic {base64(client_id:client_secret)}", "Content-Type": "application/x-www-form-urlencoded" }{ "grant_type": "refresh_token", "refresh_token": "{{n8n_credentials.refresh_token}}" }
2. Beleg-Upload (Hauptendpunkt)
- Endpunkt:
POST https://api.lexoffice.io/v1/files - Header:
{ "Authorization": "Bearer {{access_token}}", "Accept": "application/json" } - Body:
multipart/form-datamit zwei Teilen:-
Teil 1 (Datei):
- Key:
file - Typ:
File - Daten: Binäre Datei (z.B. PDF, JPEG, PNG).
Maximalgröße: 10 MB.
- Key:
-
Teil 2 (Metadaten):
- Key:
body - Typ:
JSON-String
Beispiel-Struktur:{ "type": "voucher", "voucher": { "voucherDate": "2023-12-31", // Pflichtfeld (YYYY-MM-DD) "voucherItems": [ // Mindestens 1 Posten { "amount": 100.0, // Pflicht (Netto-Betrag) "taxAmount": 19.0, // Optional "taxRatePercent": 19, // Optional "categoryId": "8f8664a8-fd86-11e1-a21f-0800200c9a66" // Optional (Kategorie-ID) } ], "voucherNumber": "RE-12345", // Optional (Belegnummer) "remark": "Beispieltext", // Optional "contactId": "12345678-abcdefgh-1234" // Optional (Kontakt-ID) } }
- Key:
-
Pflichtfelder im Überblick
Feld Pflicht Beschreibung voucherDate✔️ Belegdatum voucherItems✔️ Array mit Belegpositionen → amount✔️ Netto-Betrag pro Position type: "voucher"✔️ Muss immer vouchersein
Optionale Felder
voucherNumber: Belegnummer (z.B. Rechnungsnummer)remark: Freitext-KommentarcontactId: Lexoffice-Kontakt-ID (aus Kontakt-API)taxAmount/taxRatePercent: SteuerdatencategoryId: Buchungskategorie-ID (aus Kategorie-API)
Empfohlene n8n-Nodes
- OAuth2 Node: Für Authentifizierung.
- HTTP Request Node: Konfiguration für den Upload:
- Method: POST
- URL:
https://api.lexoffice.io/v1/files - Authentication: OAuth2
- Body > Multipart Form Data:
file: Binärdaten (aus vorherigem Read-Node)body: JSON-String (wie oben)
Fehlerbehandlung
- Status 400: Ungültige Metadaten (validiere die JSON-Struktur).
- Status 413: Datei zu groß (>10 MB).
- Status 429: Rate Limit erreicht (max. 5 Requests/Sekunde).
Hinweise
- Kontakt-IDs können über den Endpunkt
GET /v1/contactsabgerufen werden. - Kategorie-IDs via
GET /v1/categories?type=voucheritems. - Teste den Upload zunächst manuell (z.B. mit Postman) bevor du n8n automatisierst.
Bei korrekter Ausführung antwortet Lexoffice mit HTTP 201 und einem
Location-Header (z.B.https://api.lexoffice.io/v1/files/{fileId}).- Endpunkt:
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.