Zum Inhalt

Fehlerbehebung Lizenzierung

Hier finden Sie Lösungen für die häufigsten Lizenzprobleme mit merchantCENTRAL.

„No license key has been configured"

Ursache: Es wurde noch kein License Key in der Lizenz-Einrichtung hinterlegt.

Lösung:

  1. Öffnen Sie die Suche und geben Sie merchantCENTRAL License Setup ein
  2. Klicken Sie auf die Aktion License Key setzen
  3. Geben Sie den Key ein, den Sie von Ihrem Vertriebskontakt erhalten haben
  4. Klicken Sie auf Jetzt validieren

Alternativ: Starten Sie eine kostenlose 30-Tage-Demo.

„The demo period has expired"

Ursache: Ihr 30-Tage-Testzeitraum ist abgelaufen.

Lösung:

  • Kontaktieren Sie Ihren ALTENBRAND-Vertriebskontakt für eine Produktivlizenz
  • Ihre Daten (Bestellungen, Artikel, Einrichtung) bleiben vollständig erhalten — es geht nichts verloren
  • Nach der Aktivierung der Produktivlizenz stehen alle Module sofort wieder zur Verfügung

„The module [Code] is not licensed"

Ursache: Das Modul ist nicht in Ihrer Lizenz enthalten oder wurde deaktiviert.

Lösung:

  1. Öffnen Sie die Lizenz-Übersicht und prüfen Sie den Status des Moduls
  2. Falls das Modul auf Gesperrt oder Abgelaufen steht: Vertrieb kontaktieren
  3. Falls das Modul nicht in der Liste erscheint: Das Modul muss Ihrer Lizenz hinzugefügt werden

„Your merchantCENTRAL license has been suspended"

Ursache: Ihre Lizenz wurde administrativ gesperrt (z. B. wegen offener Rechnungen).

Lösung: Kontaktieren Sie den ALTENBRAND-Support unter support@altenbrand.de.

Offline Grace Period

Was ist die Grace Period?

Wenn der merchantCENTRAL Lizenzserver nicht erreichbar ist (z. B. durch Netzwerkprobleme, Wartung oder Firewall-Einschränkungen), verwendet merchantCENTRAL den zuletzt bekannten Lizenzstatus weiter.

Zeitlicher Ablauf

Zeitraum ohne Serverkontakt Verhalten
0–7 Tage ✅ Normaler Betrieb mit gecachtem Status
7–14 Tage ⚠️ Warnung: „The license has not been validated for X days. Please ensure the license server is reachable."
Mehr als 14 Tage 🛑 Blockade: „The license could not be validated for more than 14 days. Please check your internet connection and contact support."

Wie erkenne ich eine aktive Grace Period?

Wie löse ich eine Grace Period auf?

  1. Internetverbindung prüfen — Kann Business Central https://mclicensing.azurewebsites.net erreichen?
  2. Verbindung testen — Lizenz-Einrichtung → Aktion Verbindung testen
  3. Firewall/Proxy prüfen — Falls Ihr Unternehmen einen Proxy oder Firewall verwendet, muss die URL freigegeben sein
  4. Jetzt validieren — Wenn die Verbindung steht: Aktion Jetzt validieren klicken

Automatische Auflösung

Sobald die Verbindung zum Lizenzserver wiederhergestellt ist, wird die Grace Period beim nächsten automatischen Validierungslauf (spätestens beim nächsten Firmen-Öffnen) aufgelöst.

„Could not connect to the license service"

Ursache: Business Central kann den Lizenzserver nicht erreichen.

Prüfschritte:

  1. License Service URL prüfen:

    • merchantCENTRAL Setup öffnen → Bereich License Service
    • Die URL muss mit https:// beginnen
    • Standard: https://mclicensing.azurewebsites.net

  2. License Function Key prüfen:

    • Im gleichen Bereich muss der Function Key hinterlegt sein
    • Falls „Nicht konfiguriert": Key neu setzen

  3. Netzwerk prüfen:

    • Kann Ihr Business Central ausgehende HTTPS-Verbindungen herstellen?
    • Ist die URL https://mclicensing.azurewebsites.net in der Firewall freigegeben?

  4. Verbindungstest:

    • Lizenz-Einrichtung → Aktion Verbindung testen
    • Der Test gibt Auskunft über die Erreichbarkeit

„License service returned HTTP status ..."

Ursache: Der Server ist erreichbar, antwortet aber mit einem Fehler.

HTTP-Status Bedeutung Maßnahme
401 API-Schlüssel ungültig Function Key in merchantCENTRAL Setup neu eingeben
403 Zugriff verweigert Support kontaktieren
404 Endpunkt nicht gefunden URL in merchantCENTRAL Setup prüfen
500 Serverfehler Kurz warten und erneut versuchen; bei Wiederholung: Support
503 Server vorübergehend nicht verfügbar Später erneut versuchen (Wartung)

Sandbox-Umgebungen — Sonderregeln

In Sandbox-Umgebungen (Testumgebungen) gelten besondere Regeln:

  • ✅ Alle Module sind immer nutzbar — unabhängig vom Lizenzstatus
  • ✅ Kein License Key erforderlich — ein Key kann aber hinterlegt werden
  • ✅ Validierungsintervall: 7 Tage — statt 24 Stunden in Produktion
  • ❌ Keine Abrechnung — Sandbox-Nutzung ist immer kostenlos

Sandbox erkennen

merchantCENTRAL erkennt automatisch, ob Sie sich in einer Sandbox befinden. Das Feld Is Sandbox in der Lizenz-Einrichtung zeigt den Status an.

Lizenz nach Umgebungsmigration

Wenn Sie Ihre Business Central-Umgebung migriert oder umbenannt haben:

  1. Öffnen Sie die Lizenz-Einrichtung
  2. Klicken Sie auf Umgebung erkennen — die neuen Werte werden aktualisiert
  3. Klicken Sie auf Jetzt validieren — der Lizenzserver wird mit den neuen Umgebungsdaten kontaktiert

Neue Tenant ID?

Bei einer Migration auf einen neuen Microsoft-Mandanten ändert sich die Tenant ID. In diesem Fall muss die Lizenz beim ALTENBRAND-Support umgestellt werden.

Support kontaktieren

Kontakt Details
E-Mail support@altenbrand.de
Telefon Siehe Ihre Vertragsunterlagen
Hilfreiche Informationen Lizenzstatus, Fehlermeldung, Tenant ID (aus der Lizenz-Einrichtung)

Verwandte Seiten