Skip to content

DATEV Integration

DATEV kann ZUGFeRD-Rechnungen (PDF/A-3 mit eingebettetem CII-XML) automatisch importieren und verbuchen. thelawin.dev erzeugt genau dieses Format.

Warum ZUGFeRD fuer DATEV?

  • Automatischer Import: DATEV Unternehmen online erkennt ZUGFeRD-PDFs und liest Rechnungsdaten automatisch aus
  • Keine manuelle Erfassung: Rechnungsnummer, Betrag, USt-ID, Positionen werden direkt uebernommen
  • Belegbild inklusive: Das PDF dient gleichzeitig als visueller Beleg und maschinenlesbarer Datensatz
  • Steuerberater-ready: Dein Steuerberater kann die Rechnungen direkt in DATEV verarbeiten

Empfohlenes Format

Fuer maximale DATEV-Kompatibilitaet:

json
{
  "format": "zugferd",
  "profile": "en16931",
  "template": "classic",
  "locale": "de",
  "invoice": {
    "number": "RE-2026-001",
    "date": "2026-01-15",
    "due_date": "2026-02-14",
    "currency": "EUR",
    "seller": {
      "name": "Mustermann GmbH",
      "street": "Musterstrasse 1",
      "city": "Berlin",
      "postal_code": "10115",
      "country": "DE",
      "vat_id": "DE123456789",
      "email": "info@mustermann.de"
    },
    "buyer": {
      "name": "Beispiel AG",
      "street": "Beispielweg 42",
      "city": "Muenchen",
      "postal_code": "80331",
      "country": "DE",
      "vat_id": "DE987654321"
    },
    "items": [
      {
        "description": "Beratungsleistung IT-Infrastruktur",
        "quantity": 8,
        "unit": "HUR",
        "unit_price": 150.00,
        "vat_rate": 19
      },
      {
        "description": "Software-Lizenz (jaehrlich)",
        "quantity": 1,
        "unit": "C62",
        "unit_price": 499.00,
        "vat_rate": 19
      }
    ],
    "payment": {
      "iban": "DE89370400440532013000",
      "bic": "COBADEFFXXX",
      "terms": "Zahlbar innerhalb 30 Tagen netto"
    }
  }
}

Wichtig fuer DATEV

  • Profil en16931 verwenden (nicht minimum oder basic)
  • USt-ID bei Seller und Buyer angeben (wenn vorhanden)
  • Zahlungsinformationen (IBAN, Zahlungsziel) vollstaendig ausfuellen
  • Einheitencodes korrekt verwenden (HUR=Stunde, C62=Stueck, DAY=Tag)

Profile und DATEV-Kompatibilitaet

ProfilDATEV-ImportDaten
minimumEingeschraenktNur Basisdaten (Summe, Datum)
basicGutPositionen ohne Details
en16931EmpfohlenVollstaendige Positionen, USt, Zahlungsinfos
extendedVollstaendigAlle Felder inkl. Zusatzinfos

Workflow: ERP → thelawin.dev → DATEV

Dein ERP/CRM → Rechnungsdaten als JSON
    → POST api.thelawin.dev/v1/generate
    → ZUGFeRD PDF (PDF/A-3 + CII XML)
    → Upload in DATEV Unternehmen online
    → Steuerberater verbucht automatisch

curl-Beispiel

bash
curl -s -X POST https://api.thelawin.dev/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: env_sandbox_demo" \
  -d @rechnung.json \
  | jq -r '.pdf_base64' | base64 -d > RE-2026-001.pdf

Validierung vor dem DATEV-Import

Nutze /v1/validate um sicherzustellen dass die Rechnung DATEV-kompatibel ist:

bash
curl -s -X POST https://api.thelawin.dev/v1/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: env_sandbox_demo" \
  -d @rechnung.json | jq '.valid, .errors'

Naechste Schritte

ZUGFeRD 2.4 & Factur-X 1.0.8 compliant