Skip to content
TheChatArchiveThe Chat Archive
DeepSeekdeepseek-r1-0528· DeepSeekHugging Face LMArena Human Preference 140K

Welche Endpunkte und Datenfelder sind für den automatisierten Belegupload über die…

From a Chatbot Arena battleThe same person sent this prompt to two anonymous models at once. Compare it with Googlegemma-3-27b-it’s answer.
  1. User

    Welche Endpunkte und Datenfelder sind für den automatisierten Belegupload über die Lexoffice API mit N8N nötig?

  2. DeepSeek 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:
      {
        "Authorization": "Basic {base64(client_id:client_secret)}",
        "Content-Type": "application/x-www-form-urlencoded"
      }
      
      Body:
      {
        "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-data mit zwei Teilen:
      • Teil 1 (Datei):

        • Key: file
        • Typ: File
        • Daten: Binäre Datei (z.B. PDF, JPEG, PNG).
          Maximalgröße: 10 MB.
      • 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)
            }
          }
          

    Pflichtfelder im Überblick

    FeldPflichtBeschreibung
    voucherDate✔️Belegdatum
    voucherItems✔️Array mit Belegpositionen
    → amount✔️Netto-Betrag pro Position
    type: "voucher"✔️Muss immer voucher sein

    Optionale Felder

    • voucherNumber: Belegnummer (z.B. Rechnungsnummer)
    • remark: Freitext-Kommentar
    • contactId: Lexoffice-Kontakt-ID (aus Kontakt-API)
    • taxAmount/taxRatePercent: Steuerdaten
    • categoryId: Buchungskategorie-ID (aus Kategorie-API)

    Empfohlene n8n-Nodes

    1. OAuth2 Node: Für Authentifizierung.
    2. 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/contacts abgerufen 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}).

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.