Fehlerprotokolle | PDF CreateMate

Wenn ein Dokument nicht generiert werden kann, zeichnet PDF CreateMate detaillierte Fehlerinformationen auf, die dir bei der Diagnose des Problems helfen. Du kannst die Fehlerprotokolle für jede Vorlage direkt in der App einsehen.

Fehlerprotokolle anzeigen

Gehe zu Vorlagen und öffne die Vorlage
Klicke auf die Registerkarte Fehlerprotokolle
Durchsuche die Liste der Fehler, sortiert nach den neuesten

Jeder Fehlereintrag zeigt:

Detail	Beschreibung
Fehlercode	Eindeutige Kennung (z. B. E5001, E6001)
Schritt	In welchem Generierungsschritt der Fehler aufgetreten ist (z. B. „PDF-Konvertierung", „HubSpot-Upload")
Schweregrad	Entweder Fehler (Generierung fehlgeschlagen) oder Warnung (Generierung mit Problemen fortgesetzt)
Meldung	Benutzerfreundliche Beschreibung des Problems
Dokument	Der HubSpot-Datensatz, der den Fehler ausgelöst hat (mit Datensatz-ID und Status)
Zeitstempel	Wann der Fehler aufgetreten ist

Fehler filtern

Nutze die Filter oben in der Registerkarte Fehlerprotokolle, um Ergebnisse einzugrenzen:

Nach Schweregrad — Nur Fehler oder nur Warnungen anzeigen
Nach Schritt — Fehler aus einem bestimmten Generierungsschritt anzeigen
Aktualisieren — Klicke auf die Aktualisieren-Schaltfläche, um die neuesten Fehler zu laden

Die Registerkarte zeigt auch die Anzahl der Fehler in den letzten 24 Stunden für schnelle Statusüberprüfungen.

Fehler-Stufen

Die Dokumentengenerierung durchläuft mehrere Stufen. Fehler werden danach kategorisiert, wo sie aufgetreten sind:

Stufe	Was passiert	Häufige Fehler
Jobinitialisierung	Template- und Konto-Validierung	Template nicht gefunden, HubSpot-Konto inaktiv
HubSpot-Datenabruf	Datensatz-Eigenschaften abrufen	Datensatz nicht gefunden, API-Rate limitiert, fehlende Eigenschaften
Kreditprüfung	Prüfung auf ausreichende Credits	Nicht genügend Credits
Dokumenterstellung	Dokumenten-Datensatz erstellen	Erstellung fehlgeschlagen
DOCX-Verarbeitung	Platzhalter ersetzen, Bilder verarbeiten	Datei nicht gefunden, Platzhalter-Ersetzung fehlgeschlagen, Bildfehler
PDF-Konvertierung	Konvertierung ins PDF-Format	Konvertierung fehlgeschlagen, Timeout, Datei beschädigt
Wasserzeichenanwendung	Wasserzeichen anwenden	Wasserzeichen-Bild nicht gefunden
HubSpot-Upload	Upload zu HubSpot	Upload fehlgeschlagen, Eigenschaft-Aktualisierung fehlgeschlagen
Signaturablauf	Signatur-Ablauf einrichten	Signatur-URL-Generierung fehlgeschlagen
Cloud-Synchronisierung	Upload zu Google Drive	Authentifizierung fehlgeschlagen, Ordner nicht gefunden

Häufige Fehler und Lösungen

Jeder Fehlercode zeigt in der App seine eigene Meldung an — die folgende Tabelle fasst Ursache und Lösung an einem Ort zusammen. Codes mit uns oder Anbieter bedeuten, dass das Problem bei uns liegt, nicht an deiner Vorlage oder deinem Konto; ein erneuter Versuch löst das Problem meist, sobald wir die Ursache behoben haben.

Jobinitialisierung

Code	Ursache	Lösung
E1001	Die Vorlage existiert nicht mehr — sie wurde möglicherweise gelöscht.	Erstelle sie erneut oder stelle sie aus deiner Vorlagenliste wieder her.
E1002	Du hast keinen Zugriff auf diese Vorlage.	Bitte einen Inhaber deiner Organisation, sie mit dir zu teilen.
E1003	Dein HubSpot-Konto ist nicht verbunden.	Verbinde dein HubSpot-Konto in den Einstellungen erneut.
E1004	Wir konnten dein Organisationskonto nicht finden (unsere Seite).	Kontaktiere den Support mit dem Code E1004.

HubSpot-Datenabruf

Code	Ursache	Lösung
E2001	Der HubSpot-Datensatz wurde gelöscht oder existiert nicht.	Nichts zu tun — der Datensatz ist nicht mehr vorhanden.
E2002	Das API-Limit von HubSpot wurde erreicht.	Warte ein paar Minuten und versuche es erneut.
E2003	Deine HubSpot-Verbindung ist abgelaufen oder wurde widerrufen.	Verbinde dein HubSpot-Konto in den Einstellungen erneut.
E2004	HubSpot hat die Anfrage aus einem Grund abgelehnt, der nicht in den Codes unten enthalten ist. Die Meldung zitiert HubSpots eigene Begründung.	Versuche es erneut; kontaktiere den Support mit dem Code, falls es weiterhin auftritt.
E2005	Eine von deiner Vorlage benötigte Eigenschaft fehlt im Datensatz.	Fülle die fehlende HubSpot-Eigenschaft aus oder passe die Feldzuordnungen der Vorlage an.
E2006	PDF CreateMate wurde keine Berechtigung erteilt, diesen Datensatz zu lesen.	Verbinde dein HubSpot-Konto in den Einstellungen erneut und bestätige die angeforderten Berechtigungen.
E2007	HubSpot selbst war nicht erreichbar.	Warte ein paar Minuten und versuche es erneut — kein Problem mit deinem Konto oder deiner Vorlage.

Kreditprüfung

Code	Ursache	Lösung
E3001	Deine Organisation hat nicht genügend Credits.	Kaufe mehr Credits unter Abrechnung in der Seitenleiste oder richte Budget-Benachrichtigungen ein.
E3002	Wir konnten dein Guthaben nicht prüfen und haben daher gestoppt, bevor wir dich belastet haben (unsere Seite).	Versuche es in ein paar Minuten erneut.

Dokumenterstellung

Code	Ursache	Lösung
E4001	Wir konnten das Dokument auf unserer Seite nicht starten. Es wurde nichts berechnet.	Versuche es erneut; kontaktiere den Support mit dem Code E4001, falls es weiterhin fehlschlägt.
E4002	Das Dokument wurde gelöscht und konnte nicht wiederhergestellt werden.	Erstelle es erneut über den HubSpot-Datensatz.

DOCX-Verarbeitung

Code	Ursache	Lösung
E5001	Die Vorlagendatei fehlt im Speicher.	Lade deine Vorlage im Template-Builder erneut hoch.
E5002	Die Vorlagendatei ist beschädigt oder ungültig.	Lade eine gültige Datei hoch.
E5003	Die Vorlagendatei überschreitet das Größenlimit.	Reduziere die Dateigröße.
E5004	Ein Speicherproblem auf unserer Seite. Es wurde nichts berechnet.	Versuche es in ein paar Minuten erneut.
E5005	Ein Platzhalter in deiner Vorlage ist fehlerhaft.	Überprüfe die Platzhalter deiner Vorlage; kontaktiere den Support mit dem Code E5005.
E5006	Ein Bild im Dokument konnte nicht verarbeitet werden.	Überprüfe das Bildformat.
E5007	Ein Unterschriftsbild fehlt.	Füge zuerst eine Unterschrift hinzu.
E5008	Der Wert zur Erstellung eines QR-Codes oder Barcodes fehlt oder ist ungültig.	Überprüfe, ob dieses Feld in HubSpot einen gültigen Wert hat.
E5009	Fehlerhaftes HTML in einem HubSpot-Feld.	Überprüfe den HTML-Inhalt dieses Feldes.
E5010	Wir konnten das Word-Dokument nicht fertigstellen (unsere Seite). Es wurde nichts berechnet.	Versuche es erneut; kontaktiere den Support mit dem Code E5010.

PDF-Konvertierung

Code	Ursache	Lösung
E6001	Die PDF-Konvertierung ist fehlgeschlagen — auf unserer Seite, nicht an deiner Vorlage.	Versuche es in ein paar Minuten erneut.
E6002	Die Konvertierung hat zu lange gedauert und wurde abgebrochen. Große oder komplexe Dokumente können das verursachen.	Versuche es erneut oder vereinfache die Vorlage, falls es weiterhin passiert.
E6003	Unser PDF-Konvertierungsdienst ist vorübergehend nicht verfügbar.	Warte — mit deiner Vorlage oder deinen Credits ist alles in Ordnung.
E6006	Die erstellte PDF-Datei war beschädigt und wurde daher nicht ausgeliefert. Es wurde nichts berechnet.	Versuche es erneut; kontaktiere den Support mit dem Code E6006.

Wasserzeichenanwendung

Code	Ursache	Lösung
E7001	Unser Wasserzeichenbild fehlt — das Dokument wurde trotzdem erstellt, nur ohne Wasserzeichen.	Für dich nichts zu tun; das Dokument ist nutzbar. Wir wurden benachrichtigt.
E7002	Wir konnten das Wasserzeichen nicht anwenden — das Dokument wurde trotzdem erstellt und ist nutzbar.	Keine Aktion erforderlich.

HubSpot-Upload

Code	Ursache	Lösung
E8001	Die generierte Datei konnte nicht zu HubSpot hochgeladen werden.	Überprüfe deine HubSpot-Verbindung; versuche es erneut.
E8002	HubSpot hat die Datei nicht auf der konfigurierten Eigenschaft akzeptiert.	Überprüfe, ob die Eigenschaft noch existiert und PDF CreateMate Schreibrechte hat; kontaktiere den Support, falls es weiterhin auftritt.
E8003	Ein Speicherproblem auf unserer Seite beim Speichern der fertigen Datei. Es wurde nichts berechnet.	Versuche es in ein paar Minuten erneut.
E8005	Der für die Vorlage gewählte HubSpot-Ordner wurde gelöscht oder verschoben.	Wähle im Schritt Einstellungen der Vorlage unter HubSpot-Ordner einen anderen Ordner; erstelle das Dokument erneut.

Signaturablauf

Code	Ursache	Lösung
E9001	Wir konnten die Signatur-URL nicht generieren (unsere Seite).	Versuche es erneut.
E9002	Wir konnten die HubSpot-Erinnerungsaufgabe nicht erstellen (unsere Seite).	Versuche es erneut.
E9003	Der Signatur-Link wurde erstellt, aber HubSpot hat ihn nicht am Datensatz gespeichert.	Prüfe, ob die Eigenschaft für die Signatur-URL noch existiert und PDF CreateMate sie beschreiben darf, und erstelle das Dokument erneut.

Cloud-Synchronisierung

Code	Ursache	Lösung
E10001	Die Google Drive-Authentifizierung ist fehlgeschlagen, meist weil das Service-Konto keinen Zugriff mehr hat.	Teile deinen Google Drive-Ordner erneut mit dem Service-Konto. Siehe Cloud-Sync-Einrichtung.
E10002	Wir konnten nicht zum Cloud-Speicher hochladen (unsere Seite).	Versuche es erneut.
E10003	Der konfigurierte Drive-Ordner wurde nicht gefunden.	Überprüfe deine Cloud-Sync-Einstellungen.

Fehler vs. Warnungen

Fehler bedeuten, dass die Dokumentengenerierung fehlgeschlagen ist. Das Problem muss behoben werden, bevor das Dokument erstellt werden kann.
Warnungen bedeuten, dass das Dokument generiert wurde, aber etwas Unerwartetes aufgetreten ist (z. B. eine unkritische Eigenschaft konnte nicht aktualisiert werden oder ein Wasserzeichen konnte nicht angewendet werden). Das Dokument ist trotzdem nutzbar.

Tipps

Überprüfe die Fehlerprotokolle nach Massengenerierungen — Wenn einige Dokumente in einem Batch fehlschlagen, zeigen die Fehlerprotokolle genau, welche Datensätze Probleme hatten und warum
Verwende Fehlercodes beim Kontaktieren des Supports — Fehlercodes (z. B. E6001) helfen unserem Team, Probleme schneller zu diagnostizieren
Überwache die 24-Stunden-Anzahl — Ein plötzlicher Anstieg der Fehler kann auf ein HubSpot-API-Problem oder eine Konfigurationsänderung hinweisen