Zapier Integration

Erstelle EU-konforme E-Rechnungen automatisch mit Zapier und thelawin.dev. Nutze den Webhooks by Zapier Action, um per HTTP Request ZUGFeRD-PDFs zu generieren.

Voraussetzungen

• Zapier Account (Free oder hoeher)
• thelawin.dev API Key (zum Testen: env_sandbox_demo)

Zap erstellen: Trigger → Rechnung → Aktion

Schritt 1: Trigger waehlen

Waehle einen beliebigen Trigger als Ausloeser:

Trigger	Use Case
Google Sheets — New Row	Neue Zeile in Tabelle = neue Rechnung
Stripe — New Payment	Zahlung erhalten = Rechnung erstellen
Typeform — New Entry	Formular-Eingang = Rechnung
Schedule — Every Day/Week	Wiederkehrende Rechnungen
Webhook — Catch Hook	Eigener Trigger per HTTP

Schritt 2: Webhooks by Zapier (Custom Request)

Fuege als Action Webhooks by Zapier → Custom Request hinzu:

Feld	Wert
Method	POST
URL	https://api.thelawin.dev/v1/generate
Data	(siehe unten)
Headers	Content-Type: application/json
	X-API-Key: env_sandbox_demo

Data (JSON):

{
  "format": "zugferd",
  "template": "minimal",
  "locale": "de",
  "invoice": {
    "number": "RE-2026-001",
    "date": "2026-01-15",
    "currency": "EUR",
    "seller": {
      "name": "Deine Firma GmbH",
      "street": "Musterstrasse 1",
      "city": "Berlin",
      "postal_code": "10115",
      "country": "DE",
      "vat_id": "DE123456789"
    },
    "buyer": {
      "name": "Kunde AG",
      "city": "Muenchen",
      "country": "DE"
    },
    "items": [
      {
        "description": "Beratungsleistung",
        "quantity": 8,
        "unit": "HUR",
        "unit_price": 150.00,
        "vat_rate": 19
      }
    ]
  }
}

Dynamische Felder

Ersetze statische Werte durch Zapier-Variablen aus dem Trigger:

• "name": "" (aus Google Sheets)
• "unit_price": (aus Stripe)

Schritt 3: Ergebnis verarbeiten

Die Response enthaelt pdf_base64 und filename. Nutze weitere Zapier Actions:

PDF per Email senden:

1. Fuege Code by Zapier (JavaScript) hinzu, um Base64 in eine Datei-URL zu konvertieren
2. Fuege Gmail → Send Email hinzu mit dem PDF als Attachment

PDF in Google Drive speichern:

1. Code by Zapier → Base64 dekodieren
2. Google Drive → Upload File

PDF in Dropbox speichern:

• Aehnlich wie Google Drive, mit Dropbox → Upload File

Beispiel-Zap: Google Sheets → ZUGFeRD-PDF → Gmail

1. Trigger: Google Sheets — New Spreadsheet Row
2. Action 1: Webhooks by Zapier — Custom Request (an thelawin.dev)
3. Action 2: Gmail — Send Email (mit PDF-Link im Body)

Dynamisches JSON mit Sheets-Spalten:

{
  "invoice": {
    "number": "{{Rechnungsnummer}}",
    "date": "{{Datum}}",
    "buyer": {
      "name": "{{Kundenname}}",
      "city": "{{Stadt}}"
    },
    "items": [
      {
        "description": "{{Leistung}}",
        "quantity": {{Menge}},
        "unit_price": {{Einzelpreis}}
      }
    ]
  }
}

Vor-Validierung (kostenlos)

Nutze /v1/validate bevor du das PDF erzeugst — kostet keine Credits:

Feld	Wert
Method	POST
URL	https://api.thelawin.dev/v1/validate

Die Response zeigt valid: true/false und eventuelle Fehler.

Haeufige Fehler

Fehler	Ursache	Loesung
401 Unauthorized	API Key fehlt	Headers pruefen: X-API-Key
422 Validation Error	JSON ungueltig oder Pflichtfelder fehlen	errors[].path in Response lesen
Zapier zeigt "Task Halted"	HTTP 4xx/5xx Response	Response-Body in Zapier History pruefen

Naechste Schritte

• Invoice Formats — ZUGFeRD, XRechnung, Peppol, FatturaPA
• Templates — minimal, classic, compact
• n8n Guide — Alternative fuer Self-Hosted-Workflows