Häufige Fehlermeldungen im Portal

Bei der Arbeit im tebio Business-Portal können Fehlermeldungen auftreten, wenn Eingaben unvollständig sind, Berechtigungen fehlen, ein Objekt bereits existiert oder eine Aktion nicht zur aktuellen Konfiguration passt.

Viele Fehlermeldungen werden oben rechts als Benachrichtigung angezeigt. Diese Benachrichtigung enthält häufig einen Fehlercode und eine kurze Beschreibung, zum Beispiel 1305: Duplicate Name.

Dieser Artikel erklärt typische Fehlermeldungen und zeigt, wie Sie diese selbst prüfen oder beheben können.

Grundsätzliches Vorgehen

Wenn eine Fehlermeldung angezeigt wird, prüfen Sie zuerst:

1. Wurde das Formular vollständig ausgefüllt?
2. Sind alle Pflichtfelder befüllt?
3. Ist die gewählte Kombination aus Produkt, Option, Zahlungsmethode oder Status erlaubt?
4. Existiert ein Objekt mit demselben Namen bereits?
5. Haben Sie die erforderliche Rolle oder Berechtigung?
6. Sind Sie in der richtigen Umgebung, zum Beispiel Playground oder Live?
7. Enthält die Fehlermeldung zusätzliche Details oder eine technische Ursache?

Wenn der Fehler weiterhin besteht, notieren Sie den Fehlercode, den vollständigen Fehlertext und den Zeitpunkt des Fehlers.

Daten- und Eingabefehler

Fehler 9998 oder 422: Validierungsfehler

Diese Fehlermeldung tritt auf, wenn ein Formular abgeschickt wird, aber ein oder mehrere Felder nicht den Vorgaben entsprechen.

Typische Ursachen:

• Ein Pflichtfeld wurde nicht ausgefüllt.
• Ein Datum liegt außerhalb des erlaubten Zeitraums.
• Eine Auswahlkombination ist nicht erlaubt.
• Ein Wert hat ein ungültiges Format.
• Eine technische ID oder Referenz ist ungültig.
• Die Eingabe passt nicht zur aktuellen Konfiguration.

Beispiele:

• Startdatum liegt in der Vergangenheit, obwohl nur ein zukünftiges Datum erlaubt ist.
• Es wurde keine erforderliche Option ausgewählt.
• Eine Zahlungsmethode ist für das Produkt nicht erlaubt.
• Eine USt.-ID oder E-Mail-Adresse hat ein ungültiges Format.

Lösung:

• Prüfen Sie das Formular auf markierte Felder.
• Ergänzen Sie fehlende Pflichtangaben.
• Prüfen Sie Auswahlfelder und Kombinationen.
• Lesen Sie zusätzliche Hinweise in der Fehlermeldung.
• Speichern Sie den Datensatz erneut.

Wenn der Fehler bei einer komplexen Konfiguration auftritt, prüfen Sie zusätzlich die zugehörigen Einstellungen, zum Beispiel Produkt, Optionen, Preise, Zahlungsmethoden oder Steuern.

Duplikate und eindeutige Namen

Fehler 1305: Name bereits vergeben

Dieser Fehler tritt auf, wenn Sie ein Objekt mit einem Namen anlegen oder speichern möchten, der bereits verwendet wird.

Typische Ursachen:

• Ein Objekt mit demselben Namen existiert bereits.
• Ein Name muss innerhalb Ihres Tenants eindeutig sein.
• Ein inaktives oder ausgeblendetes Objekt verwendet den Namen bereits.
• Filter in der Übersicht verbergen das vorhandene Objekt.

Häufig betroffene Bereiche:

• Helpdesk-Kategorien
• Helpdesk-Tags
• Produktkategorien
• Eigenschaften
• Nachrichtenvorlagen
• andere konfigurierbare Stammdaten

Lösung:

• Wählen Sie einen eindeutigen Namen.
• Prüfen Sie die jeweilige Übersichtsliste.
• Entfernen oder ändern Sie Filter.
• Prüfen Sie, ob auch inaktive Objekte angezeigt werden können.
• Bearbeiten Sie bei Bedarf das vorhandene Objekt statt ein neues anzulegen.

Ungültige Verknüpfungen

Fehler 9006: Ungültige Verknüpfung oder Tag-Zuweisung

Dieser Fehler kann auftreten, wenn ein Objekt mit einer Eigenschaft, einem Tag oder einer Konfiguration verknüpft werden soll, die in diesem Kontext nicht erlaubt ist.

Typische Ursachen:

• Ein Tag ist für diesen Produkttyp nicht zulässig.
• Eine Eigenschaft passt nicht zur ausgewählten Entität.
• Eine Option gehört nicht zum ausgewählten Produkt.
• Eine Verknüpfung ist fachlich nicht erlaubt.
• Ein Objekt wurde geändert oder deaktiviert, während es noch referenziert wird.

Häufig betroffene Bereiche:

• Produktkatalog
• Shop-Produkte
• Produktvarianten
• Optionen
• Eigenschaften
• Helpdesk-Tags

Lösung:

• Prüfen Sie die gewählte Verknüpfung.
• Entfernen Sie nicht unterstützte Tags oder Eigenschaften.
• Prüfen Sie, ob die Option zum ausgewählten Produkt gehört.
• Aktualisieren Sie die Seite und öffnen Sie den Datensatz erneut.
• Speichern Sie anschließend erneut.

Rechnungen und Zahlungen

Fehler 9219: Zahlungs- oder Transaktionsfehler

Dieser Fehler kann auftreten, wenn eine Zahlung, ein Zahlungseinzug oder eine Erstattung nicht erfolgreich verarbeitet werden konnte.

Typische Ursachen:

• Der externe Zahlungsanbieter hat die Transaktion abgelehnt.
• Eine Kreditkarte ist abgelaufen.
• Eine SEPA-Lastschrift wurde abgewiesen.
• Das Konto ist nicht ausreichend gedeckt.
• Der Kontoinhaber hat widersprochen.
• Zahlungsdaten sind unvollständig oder ungültig.
• Die Zahlungsmethode ist nicht mehr gültig.

Lösung:

• Öffnen Sie den betroffenen Kunden, die Rechnung oder die Zahlung.
• Prüfen Sie den Zahlungsstatus.
• Öffnen Sie die Transaktionsdetails, sofern verfügbar.
• Prüfen Sie Rückmeldungen des Zahlungsanbieters.
• Aktualisieren Sie bei Bedarf die Zahlungsmethode.
• Erfassen oder verarbeiten Sie die Zahlung anschließend erneut, wenn der Prozess dies erlaubt.

Weitere Informationen:

• Zahlungseingänge prüfen
• Zahlung erfassen
• Zahlungsmethoden konfigurieren
• Zahlungsstatus

Kommunikation und Versand

Fehler 8560: Fehler beim postalischen Briefversand

Dieser Fehler kann auftreten, wenn ein Brief nicht an den Versanddienstleister übergeben werden konnte.

Typische Ursachen:

• Die Empfängeradresse ist unvollständig.
• Postleitzahl, Ort oder Land fehlen.
• Das PDF-Dokument erfüllt nicht die Layout-Anforderungen.
• Das Adressfenster ist nicht korrekt positioniert.
• Die E-POST- oder Postversand-Konfiguration ist unvollständig.
• Der Versanddienstleister hat die Verarbeitung abgelehnt.

Lösung:

• Prüfen Sie die Adresse des Kunden oder Empfängers.
• Korrigieren Sie fehlende oder ungültige Adressdaten.
• Prüfen Sie die Rechnungsvorlage oder das Dokumentenlayout.
• Prüfen Sie die Konfiguration des postalischen Versandkanals.
• Lösen Sie den Versand anschließend erneut aus, sofern der Prozess dies erlaubt.

Weitere Informationen:

• Kommunikationskanäle einrichten
• Nachrichtenvorlagen verwalten
• Gesendete Nachrichten einsehen
• Rechnungseinstellungen verwalten

Berechtigungen und Zugriff

Zugriff verweigert oder fehlende Berechtigung

Diese Meldung kann auftreten, wenn Ihr Benutzerkonto nicht die erforderliche Rolle oder Berechtigung für eine Aktion besitzt.

Typische Ursachen:

• Ihr Benutzerkonto hat nicht die passende Rolle.
• Die Funktion ist für Ihren Account nicht freigeschaltet.
• Das Produkt Subscription Management wurde noch nicht gebucht.
• Sie greifen auf einen Tenant zu, für den Sie keine Berechtigung haben.
• Eine Aktion ist nur für Administratoren oder bestimmte Rollen verfügbar.

Lösung:

• Prüfen Sie, ob das Produkt Subscription Management gebucht wurde.
• Prüfen Sie Ihre Rollen und Berechtigungen.
• Wenden Sie sich an einen Administrator Ihres Unternehmens.
• Lassen Sie sich bei Bedarf die passende Rolle zuweisen.

Weitere Informationen:

• Erste Schritte im Portal
• Eigenes Benutzerkonto verwalten
• Weitere Benutzer anlegen

Status- und Prozessfehler

Aktion ist im aktuellen Status nicht erlaubt

Diese Meldung kann auftreten, wenn eine Aktion fachlich nicht zum aktuellen Status eines Objekts passt.

Typische Ursachen:

• Eine Subscription ist bereits gekündigt.
• Eine Bestellung wurde bereits abgeschlossen oder storniert.
• Eine Rechnung ist bereits finalisiert.
• Eine Zahlung wurde bereits verarbeitet.
• Eine Kampagne läuft bereits oder ist deaktiviert.
• Eine Änderung ist nach Start eines Prozesses nicht mehr erlaubt.

Lösung:

• Prüfen Sie den aktuellen Status des Objekts.
• Prüfen Sie den Ereignisverlauf.
• Verwenden Sie die dafür vorgesehene Folgeaktion, zum Beispiel Stornieren, Korrigieren oder neue Bestellung erstellen.
• Wiederholen Sie die Aktion nicht unverändert, wenn der Statuskonflikt weiterhin besteht.

Weitere Informationen:

• Ereignisverlauf einsehen
• Rechnung stornieren
• Subscription kündigen
• Bestellung stornieren

Generelle Portal-Fehler

Chunk load failure oder wiederholte Seiten-Reloads

Diese Meldung kann auftreten, wenn während Ihrer Sitzung ein neues Update des tebio Business-Portals bereitgestellt wurde.

Der Browser versucht dann möglicherweise, ältere Programmdateien zu laden, die nach dem Update nicht mehr verfügbar sind. Das Portal versucht in der Regel automatisch, die Seite neu zu laden.

Typische Hinweise:

• Chunk load failure
• Loading chunk failed
• wiederholtes automatisches Neuladen
• Meldung wie Reloading - attempt ...

Lösung:

• Warten Sie kurz, bis der automatische Reload abgeschlossen ist.
• Wenn das Problem bestehen bleibt, schließen Sie den Browser-Tab vollständig.
• Öffnen Sie das tebio Business-Portal erneut.
• Laden Sie die Seite mit geleertem Cache neu:
  • Windows: Strg + F5
  • Mac: Cmd + Shift + R
• Falls erforderlich, melden Sie sich neu an.

Reference failure

Diese Meldung weist meist auf ein temporäres Darstellungs- oder Ladeproblem im Browser hin.

Typische Ursachen:

• Die Seite wurde nicht vollständig geladen.
• Eine Komponente konnte nicht korrekt dargestellt werden.
• Der Browser verwendet veraltete zwischengespeicherte Dateien.
• Eine Portalansicht wurde während einer Aktualisierung geöffnet.

Lösung:

• Laden Sie die Seite neu.
• Öffnen Sie den betroffenen Datensatz erneut.
• Schließen Sie den Browser-Tab und öffnen Sie das Portal neu.
• Leeren Sie den Browser-Cache, falls das Problem weiterhin besteht.

Problem besteht weiterhin

Wenn Sie eine Fehlermeldung nicht selbst lösen können, dokumentieren Sie möglichst genau, was passiert ist.

Bitte halten Sie folgende Informationen bereit:

• Fehlercode
• vollständiger Fehlertext
• Zeitpunkt des Fehlers
• betroffener Bereich im Portal
• betroffener Kunde, Bestellung, Subscription, Rechnung oder Zahlung
• Umgebung: Playground oder Live
• Screenshot der Fehlermeldung
• Schritte, die zum Fehler geführt haben
• ob der Fehler reproduzierbar ist
• Browser und Betriebssystem

Diese Informationen helfen dem tebio Support, das Problem schneller einzugrenzen.

Typische Fehler vermeiden

Fehlermeldung nur als Screenshot senden

Ein Screenshot ist hilfreich, aber oft reicht er allein nicht aus. Notieren Sie zusätzlich Fehlercode, Uhrzeit und betroffene Ressource.

Seite mehrfach schnell neu laden

Bei laufenden Prozessen kann mehrfaches schnelles Neuladen zu Verwirrung führen. Warten Sie kurz und prüfen Sie anschließend den aktuellen Status.

Aktion unverändert wiederholen

Wenn eine Fehlermeldung auf ungültige Daten oder einen Statuskonflikt hinweist, behebt eine unveränderte Wiederholung das Problem meist nicht.

Playground und Live verwechseln

Prüfen Sie, ob Sie sich in der richtigen Umgebung befinden. Konfigurationen, Produkte, Zahlungsmethoden und Daten können sich zwischen Playground und Live unterscheiden.

Verwandte Themen

• Business FAQ
• Technical Troubleshooting
• Support kontaktieren: Welche Informationen werden benötigt?
• Fehlerbehandlung
• Events nachvollziehen
• Glossar