Hilfe & Troubleshooting: Häufige Probleme lösen

Auch in einem automatisierten System kann mal Sand im Getriebe sein. Meistens liegt es an fehlenden Daten oder kleinen Konfigurationsfehlern.

Fehler-Diagnose & System-Log

DolmiDesk besitzt ein intelligentes Logging-System. Statt einfach nur "Fehler" anzuzeigen, erhältst Du oft einen genauen Fehler-Code (z.B. E201) in der Status-Spalte. Zusätzlich wird im Hintergrund ein detailliertes Protokoll geschrieben.

Das System-Log

Wenn ein Prozess fehlschlägt und Du nicht weißt warum:

1. Klicke im Menü auf DolmiDesk™ > 🛠️ System-Log anzeigen.
2. Es öffnet sich (oder entsteht) ein Tabellenblatt namens SystemLog.
3. Dort siehst Du Schritt für Schritt, was das System getan hat.

info

Das Log leert sich bei jedem neuen Prozess-Start (Klick auf einen Button) automatisch. Es zeigt immer nur den letzten durchgeführten Vorgang an.

Liste der Fehler-Codes

Wenn in der Spalte "Status" (Aufträge) oder im Log einer dieser Codes auftaucht, kannst Du das Problem hier identifizieren:

Code	Bedeutung	Lösung / Handlungsempfehlung
E101	API-Key fehlt	In den Skript-Einstellungen fehlt der DIRECTIONS_API_KEY für Google Maps. Bitte Konfiguration prüfen.
E102	Kalender nicht gefunden	Die in der Config angegebene Kalender-ID (meist Deine E-Mail) existiert nicht oder Du hast keinen Zugriff darauf.
E103	Tabellenblatt fehlt	Ein wichtiges Blatt (z.B. "Rechnungen") wurde umbenannt oder gelöscht.
E201	Keine Vorlage	Häufigster Fehler. Dem Empfänger ist für diesen Auftragstyp (z.B. "Vorort") keine Rechnungsvorlage zugewiesen. Prüfe den Tab Empfänger.
E202	Empfänger unbekannt	Der Name des Empfängers konnte keinem Eintrag in den Stammdaten zugeordnet werden (auch nicht per Fuzzy-Suche).
E203	Kunde unbekannt	Der Kunde im Kalender-Termin stimmt nicht mit der Datenbank überein. Prüfe Schreibweisen.
E204	Adresse fehlt	Ein Vorort-Termin hat keinen Ort im Kalender eingetragen.
E301	Maps API Fehler	Google Maps konnte keine Route berechnen (0 km). Prüfe, ob Start- und Zieladresse korrekt sind und mit dem gewählten Verkehrsmittel erreichbar sind.
E302	PDF Fehler	Der Export des Tabellenblatts als PDF ist gescheitert (oft Server-Timeout bei Google). Versuche es erneut.
E303	Mail Fehler	Der Entwurf konnte nicht in Gmail gespeichert werden. Prüfe Deine Gmail-Speicherplatz-Quota.

Was tun, wenn nichts hilft?

Wenn Du einen Fehler nicht selbst beheben kannst, benötigt der Entwickler Einsicht in den Ablauf. Dank des neuen Logs musst Du keine Screenshots von Deinem Kalender machen (Datenschutz!).

So gehst Du vor:

1. Führe die Aktion, die den Fehler verursacht, einmalig aus (z.B. Klick auf "Rechnung erstellen").
2. Warte, bis der Fehler auftritt.
3. Öffne das Menü DolmiDesk™ > 🛠️ System-Log anzeigen.
4. Exportiere den Inhalt des Blattes SystemLog.
5. Sende diesen Auszug an den Support.

Datenschutz-Hinweis: Das Log enthält technische IDs und Fehlermeldungen, aber versucht, Klarnamen von Kunden zu vermeiden, wo es möglich ist. Bitte prüfe das Log trotzdem kurz, bevor Du es versendest.

Der "Not-Aus" (Reset)

Wenn gar nichts mehr geht oder Du das Gefühl hast, Daten sind inkonsistent:

1. Löschen: Lösche die problematische Zeile in Aufträge oder Rechnungen.
2. Bereinigen: Lösche eventuell verwaiste Tabellenblätter (z.B. "RE-2025-XXX").
3. Neu starten: Importiere den Auftrag neu aus dem Kalender.

Das System ist "stateless" konzipiert – es merkt sich nichts Kompliziertes. Ein Neu-Import löst 99% aller logischen Probleme.

Häufige Probleme & Lösungen

Hier findest Du Lösungen für fast jedes Szenario.

Probleme beim Import (Kalender)

Das Skript importiert gar keine Termine

Symptom: Du klickst auf "Importieren", es lädt kurz, aber es erscheinen keine neuen Zeilen in Aufträge.

Mögliche Ursachen:

1. Falsche Farbe: Haben die Termine im Kalender die Farbe MAUVE (oder was in der Config steht)?
2. Zu alt: Liegen die Termine weiter zurück als der Wert Tage_Zurueck in der Config (Standard: 7 Tage)?
3. Falscher Kalender: Prüfe in der Config, ob bei Kalender_ID exakt die ID Deines Kalenders steht (meist Deine E-Mail-Adresse). Wie Du Deine Kalender-ID findest, steht hier.
4. Schon da: Das Skript importiert keine Duplikate. Wenn die Event-ID (ganz rechts im Sheet) schon existiert, wird der Termin ignoriert.
   • Lösung: Lösche die Zeile im Sheet, wenn Du sie neu importieren willst.

Der Kunde oder Empfänger wird nicht erkannt (Rote Felder)

Symptom: Der Auftrag ist da, aber Spalte C oder D ist leer oder rot markiert.

Ursache: Das Skript findet die Bezeichnung aus dem Kalender nicht in den Stammdaten.

• Kalender: Kunde: Max Mustermann
• Tabelle Kunden: Max M. Mustermann

Lösung: Die Schreibweise muss identisch sein. Die Tippfehler-Erkennung (Fuzzy-Suche) hilft nur bei kleinen Abweichungen.

1. Kopiere den Namen aus dem Kalender.
2. Füge ihn in der Tabelle Kunden in die Spalte Bezeichnung ein.
3. Gehe zurück zu Aufträge und wähle den Namen im Dropdown erneut aus.

Reisezeit / Distanz ist leer oder 0

Symptom: Der Auftrag ist importiert, aber Fahrdistanz ist leer.

Ursachen:

1. Adresse falsch: Google Maps findet die Adresse nicht (z.B. Tippfehler, PLZ fehlt).
2. Typ Online: Wenn der Auftrag als Online oder Absage erkannt wurde, ist 0 km korrekt.
3. API Limit: (Sehr selten) Dein tägliches kostenloses Kontingent bei Google Maps ist aufgebraucht.
4. API Key fehlt: Prüfe in den Skripteinstellungen (Erweiterungen > Apps Script > Einstellungen), ob DIRECTIONS_API_KEY gesetzt ist.
5. Verkehrsmittel: Das gewählte Verkehrsmittel (Auto, Fahrrad, Fußweg) ist für die Route ungeeignet.

Die Reisekette stimmt nicht (Falsche Startadresse)

Symptom: Du fährst von Termin A zu Termin B, aber Termin B berechnet die Anreise von Zuhause (statt von A).

Ursache:

1. Zeitabstand: Liegen mehr als 2 Stunden (Config: Max_Stunden_Kette) dazwischen? Dann nimmt das System an, Du warst zwischendurch zuhause.
2. Reihenfolge: Hast Du einen Termin im Kalender gelöscht oder verschoben, aber im Sheet nicht?

Lösung (Der "Reboot"):

1. Lösche alle Aufträge dieses Tages im Tab Aufträge.
2. Klicke erneut auf Importieren.
3. Jetzt wird die Kette für den ganzen Tag sauber neu berechnet.

Probleme beim Erstellen (Entwurf)

Status springt auf "Fehler"

Symptom: Du klickst "Rechnung erstellen", es rödelt, und dann steht Fehler in der Zeile. Kein Tab wird erstellt.

Häufigste Ursache: Fehlende Vorlage! Das System weiß nicht, welches Design es nutzen soll.

Checkliste:

1. Schaue, wer der Empfänger ist (z.B. "Amtsgericht").
2. Schaue, was der Typ ist (z.B. "Vorort").
3. Gehe in den Tab Empfänger.
4. Prüfe die Zeile "Amtsgericht" und die Spalte Vorlage Vorort.
5. Ist das Feld leer? -> Wähle eine Vorlage aus.
6. Existiert das Blatt? -> Heißt das Tabellenblatt unten wirklich noch so, wie es hier im Dropdown steht? (Vielleicht wurde es umbenannt?).

Lösung: Korrigiere den Eintrag im Empfänger-Tab. Dann lösche die Fehler-Rechnung (Menü > Löschen) und erstelle sie neu.

Rechnungsnummer ist doppelt / Tab existiert schon

Symptom: Fehlermeldung "Tab Name existiert schon".

Ursache: Du hast vermutlich einen alten Entwurf (z.B. RE-2025-050) nicht gelöscht oder exportiert, aber das System versucht, diese Nummer erneut zu vergeben (weil sie in der Liste als "nächste freie Nummer" gilt).

Lösung:

1. Suche den Tab RE-2025-050 unten in der Leiste.
2. Ist er wichtig? Exportiere ihn. Ist er Müll? Lösche ihn.
3. Versuche es erneut.

Falsche Preise (0 €) im Entwurf

Symptom: Die Rechnung ist da, aber Fahrtkosten oder Honorar sind 0 oder falsch.

Ursache: Die "Matrix" greift nicht.

1. Hat der Empfänger das richtige Abrechnungsmodell zugewiesen?
2. Sind in der Tabelle Fahrtpauschalen Werte für dieses Modell hinterlegt?
3. Datumsproblem: Sind die Zeiten als Text statt als Zeit formatiert?

Lösung: Prüfe die Stammdaten. Da die Preise beim Erstellen "fixiert" werden, musst Du die fehlerhafte Rechnung löschen und neu erstellen, damit die Änderungen wirksam werden.

Probleme beim Export (PDF & Mail)

Fehler "We're sorry, a server error occurred"

Symptom: Der PDF-Export bricht mit einer generischen Google-Fehlermeldung ab.

Ursache: Das Tabellenblatt ist zu "schwer". Google versucht oft, 10.000 leere Zeilen mitzudrucken.

Lösung:

1. Gehe in Deine Vorlage (z.B. Vorlage Standard).
2. Lösche alle ungenutzten Zeilen unterhalb des Rechnungsendes (Markieren -> Rechtsklick -> Zeilen löschen).
3. Lösche alle ungenutzten Spalten rechts.
4. Das Skript versucht dies automatisch zu beheben ("Range-Fix"), aber saubere Vorlagen helfen enorm.

Anhänge fehlen in der E-Mail

Symptom: PDF ist da, aber der Laufzettel aus dem Kalender fehlt.

Ursachen:

1. Event gelöscht: Der Termin existiert im Kalender nicht mehr (oder wurde verschoben, wodurch er eine neue ID hat).
2. Zugriff: Die Datei im Kalender gehört nicht Dir (sondern wurde von jemand anderem eingeladen) und Du hast keine Kopierrechte.

Lösung: Das Skript zeigt eine Warnung ("Kalender-Warnung"). Prüfe den Termin im Kalender. Du kannst Anhänge auch manuell in den Gmail-Entwurf ziehen, bevor Du sendest.

E-Mail Entwurf öffnet sich nicht / Button fehlt

Symptom: Das Popup zeigt keinen roten "E-Mail öffnen" Knopf.

Ursache: Die Berechtigung für Gmail fehlt in der technischen Konfiguration (appsscript.json).

Lösung: Siehe Installations-Anleitung Schritt 6. Der Scope https://www.googleapis.com/auth/gmail.modify muss vorhanden sein.

Meine Signatur fehlt in der E-Mail

Symptom: Der Text ist da, aber "Mit freundlichen Grüßen..." fehlt.

Ursache: Der Dienst "Gmail API" ist im Skript-Editor nicht aktiviert.

Lösung:

1. Gehe zu Erweiterungen > Apps Script.
2. Klicke links bei "Dienste" auf +.
3. Füge Gmail API hinzu (Bezeichner: Gmail).