Workflow-Dokumentation

Nebenkostenabrechnung
per Prompt

Versorgerrechnungen rein. Prompt absetzen. Fertige PDFs raus. So funktioniert der Workflow im Detail.

Kategorie Development · AI Workflow
Tools Claude MCP · Google Drive · claude.ai
Output Vollautomatische PDF-Generierung per Prompt
01 · Setup

Einmaliges Setup: Google Drive als Datenquelle verbinden

Der erste Schritt ist Claude Schreibzugriff auf Google Drive zu erteilen. In claude.ai unter Konnektoren Google Drive verbinden und Schreibrechte autorisieren. Ab diesem Moment kann Claude selbstständig Dateien lesen, verarbeiten und neue Dateien erstellen.

📁 Nebenkostenabrechnung/
📁Stammdaten MieterCSV mit Mieterdaten, Flächen, Vorauszahlungen
📁Abrechnungen VersorgerPDFs aller Versorger
📁Erstellte NebenkostenabrechnungenOutput: fertige PDFs pro Mieter

Die Ordnerstruktur ist bewusst einfach gehalten. Drei Ordner, drei Funktionen: Eingabe der Stammdaten, Eingabe der Versorgerrechnungen, Ausgabe der fertigen Abrechnungen. Claude navigiert diese Struktur selbstständig sobald ein Prompt abgesetzt wird.

Datenschutzhinweis

Mieterdaten sind personenbezogene Daten gemäß DSGVO. Bevor echte Mieter-, Verbrauchs- oder Zahlungsdaten in einen KI-Dienst eingegeben werden, sollte die Datenschutzkonformität des jeweiligen Anbieters geprüft und gegebenenfalls rechtlicher Rat eingeholt werden.

02 · Workflow

Von der Versorgerrechnung zum fertigen PDF

1
Versorgerrechnungen in Drive ablegen

PDFs der Jahresrechnungen aller Versorger in den Ordner „Abrechnungen Versorger" hochladen. Keine spezielle Formatierung nötig. Claude liest das Rohdokument.

2
Prompt absetzen

Der Workflow startet mit einem Kontext-Prompt: Stammdaten, Objekt, Abrechnungszeitraum. Danach folgen Kostenpositionen und pro Mieter ein PDF-Auftrag. Die genauen Prompts sind in Block 03 dokumentiert.

3
Claude liest und extrahiert

Claude öffnet alle Versorger-PDFs, extrahiert Beträge, Zeiträume und Kostenpositionen. Parallel werden Stammdaten und Mieterflächen aus der CSV geladen.

4
Berechnung pro Mieter

Kostenanteil nach Wohnfläche und Verbrauch berechnet. Vorauszahlungen gegengerechnet. Nachzahlung oder Guthaben ermittelt. Alle Pflichtangaben nach § 556 BGB eingebaut.

5
PDFs generiert und zurück in Drive hochgeladen

Fertige Abrechnungen landen automatisch im Ordner „Erstellte Nebenkostenabrechnungen". Benannt nach Schema: NK_2024_[Nachname].pdf.

„Versorgerrechnungen rein. Prompts absetzen. Fertige Abrechnungs-PDFs raus. Der Workflow funktioniert, aber er braucht mehrere Iterationsschritte bis das Ergebnis wirklich versandfertig ist."

Ergebnis

📄
NK_2024_Max_Mustermann.pdf
223,81 € Guthaben
📄
NK_2024_Erika_Musterfrau.pdf
238,73 € Guthaben
📄
NK_2024_Klaus_Schmidt.pdf
208,88 € Guthaben
03 · Prompts

Die Prompts die den Workflow steuern

Der gesamte Workflow wird über fünf wiederverwendbare Prompts gesteuert. Einmal eingerichtet, kann er jedes Jahr mit denselben Prompts wiederholt werden.

Prompt 1: Kontext & Stammdaten
Ich möchte Nebenkostenabrechnungen erstellen. Erstelle für jeden Mieter eine rechtssichere PDF-Abrechnung gemäß § 556 BGB mit vollständiger Kostenaufstellung, Verbrauchsnachweis und Abschlussrechnung. Stammdaten Vermieter: - Name: [Name] - Adresse: [Straße, PLZ Ort] - IBAN: [IBAN] Objekt: - Adresse: [Straße, PLZ Ort] - Gesamtwohnfläche: [xxx] m² - Abrechnungszeitraum: 01.01.2025-31.12.2025
Prompt 2: Kostenpositionen
Hier sind die Gesamtkosten für das Objekt 2025: - Energieversorger Gas: 2.847,32 € / Verbrauch - Wasserwerk: 1.091,12 € / Verbrauch - Abfallentsorgung: 659,52 € / Wohnfläche - Gebäudeversicherung: 1.535,17 € / Wohnfläche
Prompt 3: Abrechnung erstellen
Erstelle die Nebenkostenabrechnung als PDF für: - Name: Max Mustermann - Wohnfläche: 75 m² - Personen: 3 - Vorauszahlung: 150 € / Monat - Wärme: 11.200 kWh - Wasser: 84 m³

Das erste PDF ist schnell erstellt. Ob es aussieht, wie es aussehen soll, ist eine andere Frage.

03c · Iteration

Iteration gehört zum Prozess

Das ist keine Schwäche des Workflows, sondern der Realität geschuldet: KI generiert beim ersten Versuch ein funktionierendes Dokument, aber kein layouttreues. Redundante Angaben, inkonsistente Abstände, Felder die doppelt erscheinen oder Informationen die an der falschen Stelle landen: all das ist beim ersten Durchlauf normal.

In der Praxis bedeutet das: Nach dem ersten PDF-Output folgt ein Redigier-Schritt. Man schaut sich das Ergebnis an, identifiziert was nicht stimmt, und gibt Claude präzises Feedback per Prompt.

Prompt: Layout korrigieren
Das Layout hat folgende Probleme: - Die Vermieteradresse erscheint doppelt - Der Abrechnungszeitraum fehlt in der Kopfzeile - Die Kostenaufstellung hat zu wenig Abstand zur Zusammenfassung - Die Nachzahlung soll optisch hervorgehoben werden Bitte das PDF mit diesen Korrekturen neu erstellen.

Je präziser das Feedback, desto schneller konvergiert das Layout. In diesem Projekt waren es mehrere solcher Iterationsschritte bis das PDF das Ergebnis hatte, das man einem Mieter tatsächlich zustellen würde. Das gehört zum Prozess dazu.

04 · Alternative Methode

Ohne Google Drive: Drag & Drop

Wer Google Drive nicht einrichten möchte, kann Versorgerrechnungen auch direkt per Drag & Drop in das Claude Chat-Fenster ziehen. Claude extrahiert dann selbstständig alle relevanten Daten aus dem Dokument und fährt mit dem Workflow fort.

Diese Methode eignet sich besonders wenn die Versorgerrechnungen als Foto oder Scan vorliegen oder wenn der Workflow einmalig und ohne Drive-Anbindung genutzt werden soll.

Prompt: Drag & Drop Variante
Ich habe dir diese Versorgerrechnung hochgeladen. Extrahiere daraus alle relevanten Daten für eine Nebenkostenabrechnung: - Versorger und Abrechnungszeitraum - Alle Kostenpositionen mit Beträgen - Gesamtbetrag - Empfohlener Umlageschlüssel

Danach weiter mit Prompt 1 aus Block 03: Stammdaten setzen und Abrechnung erstellen.

05 · Reflexion

Was dieser Workflow zeigt und was er nicht ist

Das ist kein fertiges Produkt. Es ist ein funktionierender Proof of Concept der demonstriert, dass ein vollständiger Datenfluss von der Versorgerrechnung bis zum generierten PDF möglich ist. Das finale Layout erfordert zusätzliche Iterationsschritte, wie in Block 03c dokumentiert.

Hinweis

Alle in dieser Dokumentation verwendeten Daten sind Mockdaten. Vermieter, Mieter, Adressen, Beträge und Zählerstände sind fiktiv und dienen ausschließlich der Demonstration des Workflows.

In einem echten Einsatz würden echte Zählerstände, echte Mietverträge und eine rechtliche Prüfung hinzukommen.

Vollständiger end-to-end Datenfluss funktioniert
Claude liest PDFs aus Google Drive ohne manuelle Extraktion
Berechnung und PDF-Generierung in einem Schritt
Output direkt zurück in Drive hochgeladen
Echte Nutzerdaten noch nicht integriert
Kein automatischer Trigger, bewusste Entscheidung, siehe unten
Rechtliche Prüfung durch Fachanwalt ausstehend

Der fehlende automatische Trigger ist keine technische Lücke. Es ist eine bewusste Entscheidung: Ein Agent, der ohne Prüfschritt Nebenkostenabrechnungen generiert und versendet, nimmt dem Vermieter genau die Kontrolle weg, die ihm Vertrauen gibt. § 556 BGB kennt keine Fehlertoleranz. Das mentale Modell des Nutzers auch nicht. Automatisierung ist das richtige Werkzeug wenn Vertrauen bereits etabliert ist. Nicht um es herzustellen.

Die Geschichte dahinter

Wie dieses Projekt entstand, welche UX-Entscheidungen dahinterstecken und was Contextual Inquiry damit zu tun hat.

Case Study lesen →