VibeFox CTT for OpenCart — Hilfe
Anforderungen
OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).
PHP: 8.0 oder neuer.
CTT-E-Commerce-Konto (nur für Live-Preise und CTT-Punkte): Live-Preise und die Lieferung an einen CTT-Punkt nutzen die CTT-E-Commerce-API. Sie benötigen ein CTT-E-Commerce-Konto auf enviosecommerce.ctt.pt (für Kunden mit einem CTT-Expresso-Vertrag, oder fragen Sie bei CTT ein Angebot an). Erstellen Sie auf der Schlüsselverwaltungsseite dieses Kontos ein Paar aus öffentlichem und privatem Schlüssel. Die App ID (X-APPID) stellt CTT für Ihre Integration aus: Fragen Sie Ihren CTT-E-Commerce-Ansprechpartner. CTT entscheidet außerdem, welche API-Funktionen (Kostenschätzung, CTT-Punkte) Ihre App ID nutzen darf. Schließlich benötigen Sie die Carrier ID von CTT für Ihr Konto. Die Einstellungsseite listet die Transportunternehmen Ihres Kontos auf, sobald die Schlüssel gespeichert sind. Wenn Sie nur die Preistabelle und die Lieferung an die Adresse verwenden, benötigen Sie keine API-Schlüssel.
VibeFox-Lizenzschlüssel: erworben auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.
Installation
Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 vfd_ctt-oc3-(version).ocmod.zip und das Paket für OpenCart 4 vfd_ctt.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.
OpenCart 3
1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_ctt-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, daher müssen Sie Extensions > Modifications nicht aktualisieren. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.
2. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox CTT und klicken Sie auf Install (die grüne +-Schaltfläche).
3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite Edit ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
5. Füllen Sie die Preistabelle aus (mindestens eine Zeile Portugal oder * Default), aktivieren Sie Enable/Disable und/oder Enable CTT point option und klicken Sie auf Save. Optional tragen Sie die CTT-API-Schlüssel, die App ID und die Carrier ID ein und aktivieren Live rates (siehe Konfiguration).
OpenCart 4
1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_ctt.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.
2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).
3. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox CTT, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).
4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 4 und 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.
Nach der ersten Installation sind beide Versandoptionen deaktiviert, bis Sie eine einschalten und speichern. Wenn Sie die Erweiterung nach einer Deinstallation ohne Entfernen der Daten erneut installieren, werden die aufbewahrten Einstellungen wieder verwendet, und die Erweiterung wird wieder aktiviert, wenn eine der Optionen eingeschaltet war.
Konfiguration
Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox CTT > Edit. Die Abschnitte stehen links. Eine Save-Schaltfläche unten speichert die gesamte Seite ohne Neuladen. Die Preise und Bedingungen gelten für beide CTT-Optionen. Jedes Speichern löscht die zwischengespeicherten CTT-Antworten: das API-Token, die Transportunternehmen, die Preise und die CTT-Punktlisten. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.
Warnungen oben auf der Seite weisen auf eine leere Preistabelle, einen fehlenden Preis für Portugal, unvollständige API-Schlüssel bei aktiven Live-Preisen oder CTT-Punktoption, eine fehlende Carrier ID, eine Shopwährung ungleich EUR ohne Wechselkurs, eine fehlgeschlagene Verbindung zur CTT-API sowie einen Shop ohne Gewichtsklasse mit der Einheit kg oder Längenklasse mit der Einheit cm hin (Produkteinheiten werden dann anhand ihres Einheitennamens umgerechnet; prüfen Sie System > Localisation > Weight Classes und Length Classes). Ist ein Name leer, ungültig oder länger als 64 Zeichen, ist Min weight (kg) größer als Max weight (kg), oder ist Sort Order, die Steuerklasse oder die Geozone ungültig, zeigt die Seite einen Fehler und nichts wird gespeichert. Andere ungültige Werte werden als Warnungen gemeldet, der Rest wird gespeichert: eine ungültige Zahl wird nicht gespeichert, ein Wechselkurs von 0 oder weniger wird gelöscht, eine ungültige Produktgröße wird auf den Standard zurückgesetzt, ein unbekanntes Ziel oder eine doppelte Zeile in der Preistabelle wird entfernt, ein ungültiger Tabellenpreis bleibt leer.
Allgemein
Die Erweiterung bietet an der Kasse bis zu zwei Optionen: CTT-Lieferung an die Adresse des Kunden und Lieferung an einen CTT-Punkt oder ein Paketfach. Die Preise und Bedingungen gelten für beide.
Enable/Disable: schaltet die CTT-Lieferung an die Adresse des Kunden ein oder aus.
Name: der Name der Versandart, den der Kunde an der Kasse sieht, zum Beispiel "CTT Expresso". Standard: CTT. Bis zu 64 Zeichen.
Tax class: die Steuerklasse der Versandkosten. OpenCart fügt diese Steuer (zum Beispiel IVA) auf die Preise auf. --- None --- bedeutet, dass die Preise endgültig sind. Wird von beiden Optionen verwendet.
Sort Order: die Position von CTT unter den Versandarten an der Kasse. Eine ganze Zahl.
Lieferung an einen CTT-Punkt oder ein Paketfach
Die zweite CTT-Option. Der Kunde sucht CTT-Punkte nach Postleitzahl oder Ort (die Lieferadresse wird automatisch durchsucht) und muss vor dem Fortfahren einen auswählen. Dafür werden die CTT-API-Schlüssel und die Carrier ID benötigt. Ohne sie ist es eine Option ohne Punktauswahl.
Enable CTT point option: bietet die Lieferung an einen CTT-Punkt oder ein Paketfach an. Standard: aus.
CTT point option name: der Name dieser Option an der Kasse. Standard: CTT point / parcel locker. Bis zu 64 Zeichen.
CTT-E-Commerce-API (Live-Preise, CTT-Punkte) (optional; ohne Schlüssel wird die Preistabelle verwendet)
Public key: der öffentliche Schlüssel von der Schlüsselverwaltungsseite Ihres CTT-E-Commerce-Kontos.
Private key: der geheime Schlüssel, mit dem jede Anfrage signiert wird (HMAC-SHA256). Er wird nie an CTT gesendet und nicht im Protokoll geschrieben.
Beide Schlüssel werden nach dem Speichern nie wieder angezeigt. Die Feldbeschreibung lautet dann Saved - leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Setzen Sie das Häkchen bei Remove the saved public and private key und speichern Sie, um beide zu löschen. Wenn nichts gespeichert ist, zeigt der Abschnitt No keys saved.
App ID (X-APPID): der von CTT ausgestellte Anwendungsschlüssel, der im Header X-APPID gesendet wird.
Carrier ID: die ID des CTT-Transportunternehmens in Ihrem Konto, verwendet für Live-Preise und die Suche nach CTT-Punkten. Nachdem die Schlüssel und die App ID gespeichert wurden, werden die Transportunternehmen Ihres Kontos unter dem Feld aufgelistet (Carriers of your CTT account:), wobei diejenigen, die CTT-Punkte unterstützen, mit CTT points markiert sind. Nur Zahlen.
Live rates: fragt bei CTT den Preis (Kostenschätzung) an, sobald der Kunde Straße, Postleitzahl und Ort eingegeben hat. Solange die Adresse unvollständig ist und wenn CTT keinen Preis liefert, wird die Preistabelle verwendet. CTT bezeichnet diesen Preis als Schätzung. Standard: aus.
Service ID: optional. Liefert CTT mehrere Dienste, wird der mit dieser ServiceId verwendet. Leer lassen, um den günstigsten zu verwenden.
Exchange rate: CTT-Preise sind in Euro. Wenn die Standardwährung Ihres Shops eine andere ist, geben Sie an, wie viele Einheiten Ihrer Shopwährung 1 Einheit der CTT-Währung entsprechen. Ohne diesen Wert werden Live-Preise in einer anderen Währung nicht verwendet, und die Preistabelle gilt.
Default product size (cm): Länge x Breite x Höhe, die an CTT für Produkte ohne Abmessungen gesendet werden. Standard: 30x20x15. Produkte mit Abmessungen verwenden ihre eigenen. Abmessungen werden in cm und Gewichte in Gramm umgerechnet, anhand der Längen- und Gewichtsklassen der Produkte.
Preise (der Abschnittstitel zeigt die Standardwährung Ihres Shops)
Geben Sie die Preise Ihres CTT-Vertrags oder der öffentlichen Preisliste von CTT auf ctt.pt in der Standardwährung des Shops ohne Steuer ein. Bei ausgeschalteten Live-Preisen legt diese Tabelle den Preis fest. Bei eingeschalteten Live-Preisen ist sie der Ersatzpreis.
Price table: eine Zeile pro Ziel. Wählen Sie ein Land, Portugal - Azores, Portugal - Madeira oder * Default (other destinations). Jede Zeile hat einen Grundpreis Price und optionale Preise für die Größen XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Ein leerer (oder 0) Größenpreis verwendet den Grundpreis. Eine Zeile, in der beide leer sind, blendet die Methode aus. Die Zeile Azores gilt für portugiesische Postleitzahlen 9500-9999, die Zeile Madeira für 9000-9499. Ohne sie gilt die Zeile Portugal. Klicken Sie auf Add destination, um eine Zeile hinzuzufügen, und auf die Schaltfläche × zum Entfernen. Preise akzeptieren einen Dezimalpunkt oder ein Komma. Die Tabelle ist nach der Installation leer.
Calculation: so wird der Tabellenpreis ermittelt.
Ein Live-Preis von CTT gilt immer für die gesamte Sendung.
Bedingungen
Min weight (kg): das minimale Warenkorbgewicht, damit die CTT-Optionen erscheinen. 0 bedeutet keine Grenze.
Max weight (kg): die CTT-Optionen werden bei einem Warenkorbgewicht über diesem Wert ausgeblendet. Standard: 30 (CTT-Pakete wiegen bis zu 30 kg). 0 bedeutet keine Grenze. Min weight (kg) darf nicht größer sein als Max weight (kg).
Minimum order amount: die CTT-Optionen nur anzeigen, wenn die Zwischensumme der versandpflichtigen Produkte (nach dem Gutschein, vor Steuern) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Kostenloser Versand
Free shipping: schaltet die kostenlose CTT-Lieferung ab dem unten angegebenen Betrag ein.
Free shipping from: die Zwischensumme der versandpflichtigen Produkte (nach dem Gutschein, vor Steuern), ab der die CTT-Optionen 0 kosten. Gilt nur für Ziele mit einem Preis. Wird nur verwendet, wenn Free shipping eingeschaltet ist.
Verfügbarkeit
Normalerweise werden die CTT-Optionen in der unten ausgewählten Geozone angeboten. All Zones bedeutet überall. Mit Ignore shipping zones wird die Geozone nicht geprüft, und Countries entscheidet.
Geo Zone: die Geozone der Lieferadresse. Geozonen werden unter System > Localisation > Geo Zones verwaltet.
Ignore shipping zones: die Geozone nicht prüfen; CTT in den unten genannten Ländern anbieten.
Countries: die Zielländer für diesen Modus. Standard: Portugal. Leer lassen, um alle Länder zu erlauben. Wird nur mit Ignore shipping zones verwendet.
Erweitert
Debug log: protokolliert die Preisberechnung und die CTT-API-Aufrufe in storage/logs/vfd_ctt_debug.log.php (bei OpenCart 4 in system/storage/logs/vfd_ctt_debug.log.php). Die Datei kann nicht über das Web gelesen werden. CTT-API-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Schlüssel, Token und Kundenadressen werden nie protokolliert. Erreicht die Datei 5 MB, wird sie nach vfd_ctt_debug.old.log.php verschoben und ein neues Protokoll begonnen.
Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.
Remove data on uninstall: wenn eingeschaltet, löscht die Deinstallation der Erweiterung die Einstellungen, das Protokoll und die CTT-Punkte nicht abgeschlossener Kassenvorgänge. Wenn ausgeschaltet (Standard), bleiben die Einstellungen für eine erneute Installation erhalten. Bestellungen, einschließlich des gewählten CTT-Punkts, werden nie verändert.
Import / Export
Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Der öffentliche und der private Schlüssel werden nicht exportiert.
Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen, zum Beispiel in einem anderen Shop. Die Werte werden wie bei einem normalen Speichern geprüft. Die gespeicherten Schlüssel bleiben erhalten.
So funktioniert es an der Kasse
Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem CTT-Preis. Mit Ignore shipping zones wird CTT nur für ein Land in Countries angeboten (leer = alle Länder); andernfalls, wenn eine Geo Zone gesetzt ist, nur für Adressen innerhalb davon. Nur Produkte mit Requires Shipping auf Yes zählen: andere Produkte erhöhen das Gewicht nicht und sind nicht im Bestellwert enthalten. Die Erweiterung prüft das Warenkorbgewicht und den Mindestbestellwert. Bei eingeschalteten Live rates und einer vollständigen Adresse sendet sie an CTT die Lieferadresse und für jede Warenkorbposition die Menge, das Gewicht in Gramm und die Abmessungen in cm und verwendet den zurückgegebenen Preis. Andernfalls, oder wenn CTT keinen Preis liefert (API-Fehler, Zeitüberschreitung, keine Abdeckung, eine Funktion, die für Ihre App ID nicht aktiviert ist), stammt der Preis aus der Tabelle. Gilt kostenloser Versand, beträgt der Preis 0. Beide Optionen erhalten denselben Preis. Der Preis wird in der Standardwährung des Shops berechnet, auf deren Dezimalstellen gerundet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax class angezeigt.
Ein CTT-Preis wird 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 5 Minuten gemerkt, damit die Kasse bei jeder Aktualisierung nicht auf CTT wartet. Das API-Token, die Liste der Transportunternehmen und die CTT-Punktlisten werden ebenfalls zwischengespeichert, höchstens für die Lebensdauer des OpenCart-Caches (standardmäßig 1 Stunde). API-Fehler erreichen den Kunden nie: Es wird der Tabellenpreis verwendet, oder die Methode wird ausgeblendet, wenn das Ziel keinen Preis hat.
Mit eingetragenen API-Schlüsseln sendet die Erweiterung die Lieferadresse, Produktgewichte und -abmessungen sowie die URL Ihres Shops an CTT, um einen Preis oder die nächsten CTT-Punkte zu erhalten.
Die Erweiterung erstellt keine Sendungen, druckt keine Etiketten, beantragt keine Abholungen, stellt keine Sendungsnummern bereit und zeigt keine Karte der CTT-Punkte an. Es gibt eine Preistabelle und einen Satz API-Einstellungen für beide Optionen.
Bei OpenCart 4 klickt der Kunde im Versandart-Block der Kassenseite auf Choose und wählt im Fenster Shipping method options eine CTT-Option aus. Die Preise sind dieselben wie bei OpenCart 3.
Abholpunkte
Wenn der Kunde im Schritt der Versandart die CTT-Punktoption auswählt, erscheinen darunter ein Suchfeld und eine Liste. Die Postleitzahl der Lieferadresse wird eingetragen und automatisch gesucht. Der Kunde kann andere CTT-Punkte nach Postleitzahl oder Ort suchen (Schaltfläche Search) und wählt einen aus der Liste. Die Auswahl wird sofort gespeichert. Nur ein Punkt aus der CTT-Liste für diese Suche wird akzeptiert.
Vor dem Fortfahren muss der Kunde einen Punkt wählen. Wenn der Kunde auf Continue klickt, prüft die Erweiterung den Punkt auf dem Server. Ohne Punkt sieht der Kunde Please select a CTT point., bei einem Punkt, der nicht in der CTT-Liste steht, The selected CTT point is not in the CTT list for this search. Please choose the CTT point again. Wenn CTT nicht erreichbar ist, sieht der Kunde CTT points cannot be loaded right now. Please try again in a few minutes or choose another shipping method.
Die Punktauswahl ist nur aktiv, wenn der öffentliche Schlüssel, der private Schlüssel, die App ID und die Carrier ID ausgefüllt sind. Sie ist für das Standard-Theme von OpenCart und dessen Kasse gemacht; andere Themes benötigen unter Umständen Anpassungen.
Bei OpenCart 4 erscheinen das Suchfeld und die Liste im Fenster Shipping method options, unter der CTT-Punktoption. Die Schaltfläche Continue des Fensters lässt den Kunden nur mit einem gültigen Punkt weitergehen, mit denselben Meldungen. OpenCart 4 behält für die Kasse eine Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; der CTT-Punkt der Bestellung wird dabei mit aktualisiert.
Der gewählte Punkt wird der Versandart der Bestellung hinzugefügt, zum Beispiel CTT point / parcel locker: .... So sieht ihn der Kunde im Bestellverlauf seines Kontos und in den Bestell-E-Mails; er wird auf der Rechnung gedruckt und unter Sales > Orders angezeigt. Die Erfolgsseite der OpenCart-Bestellung zeigt die Versandart nicht an.
Auf der Bestellseite im Admin zeigt das Feld CTT point über dem Verlauf den Namen und die ID des Punkts. Zum Ändern geben Sie unter Change CTT point eine Postleitzahl oder einen Ort ein, klicken auf Search, wählen einen Punkt und klicken auf Save. Die Seite zeigt CTT point updated., der Text der Versandart der Bestellung wird aktualisiert, und ein Verlaufseintrag CTT point changed to: ... wird ohne Benachrichtigung des Kunden hinzugefügt. Das Ändern des Punkts erfordert die Berechtigung zum Ändern von Bestellungen (sale/order) und die API-Einstellungen. Das Feld wird auch für CTT-Bestellungen angezeigt, während die Erweiterung deaktiviert ist.
Lizenzschlüssel
Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox CTT ist der erste Block auf Extensions > Extensions > Shipping > VibeFox CTT > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-ctt und der Link Manage licenses and domains in your account, der zu Ihrem vibefox.net-Konto führt. Nur Admin-Benutzer mit der Berechtigung zum Ändern dieser Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).
Wenn der Schlüssel nicht akzeptiert wird, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Wenn der Lizenzserver nicht erreicht werden kann, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.
Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne einen aktiven Schlüssel wird CTT Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Methode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Methode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie für 7 Tage auszublenden. Bestehende Bestellungen sind nicht betroffen.
Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Admins oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.
Fehlerbehebung
CTT erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable (oder Enable CTT point option) eingeschaltet ist. Prüfen Sie Geo Zone oder Ignore shipping zones und Countries. Prüfen Sie, ob das Ziel eine Zeile in der Preistabelle hat (oder eine Zeile * Default), das Warenkorbgewicht innerhalb von Min weight und Max weight liegt, der Minimum order amount erreicht ist und die Produkte Requires Shipping auf Yes haben.
Der Kunde kann keinen CTT-Punkt wählen: die Auswahl erscheint nur unter der CTT-Punktoption, und nur wenn der öffentliche Schlüssel, der private Schlüssel, die App ID und die Carrier ID ausgefüllt sind. Prüfen Sie die Warnungen oben auf der Einstellungsseite, schalten Sie das Debug log ein und sehen Sie im Feld Log auf der Erweiterungsseite nach.
Live-Preise erscheinen nicht: bis der Kunde Straße, Postleitzahl und Ort eingegeben hat, wird die Preistabelle verwendet. Prüfen Sie die Warnungen und das Protokoll. Die Antwort "405" bedeutet, dass die Funktion für Ihre App ID nicht aktiviert ist: Fragen Sie bei CTT nach. In einem Shop, der nicht in Euro arbeitet, tragen Sie den Exchange rate ein.
Die Verbindung zur CTT-API ist fehlgeschlagen: die Warnung oben auf der Einstellungsseite zeigt den Fehler. Prüfen Sie die Schlüssel und die App ID. Die Erweiterung wiederholt den Versuch nach einigen Minuten automatisch.
Preise mit oder ohne MwSt.: mit einer ausgewählten Tax class fügt OpenCart diese Steuer auf den Preis auf. Mit --- None --- ist der Preis endgültig.
Preise wirken nach einer Änderung veraltet: klicken Sie auf der Erweiterungsseite auf Save. Dadurch werden die zwischengespeicherten CTT-Antworten gelöscht.
Die Seite zeigt "Warning: You do not have permission to modify VibeFox CTT!": Ihre Admin-Benutzergruppe darf die Einstellungen möglicherweise nur ansehen. Geben Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_ctt (OpenCart 3) oder extension/vfd_ctt/shipping/vfd_ctt (OpenCart 4) unter System > Users > User Groups.
Für Entwickler: die CTT-API-Adresse kann mit der Einstellung vfd_ctt_api_url ersetzt werden (für Tests); sie hat kein Feld auf der Einstellungsseite.
Deinstallation
Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox CTT auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt den Status der Erweiterung, Sort Order, Tax class und Geo Zone immer zurück. Die zwischengespeicherten CTT-Antworten und das API-Token werden immer entfernt. Ist Remove data on uninstall eingeschaltet, werden außerdem die Einstellungen, das Protokoll und die CTT-Punkte von Kassenvorgängen entfernt, die nie zu Bestellungen wurden. Ist es ausgeschaltet, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. In Bestellungen gespeicherte CTT-Punkte bleiben immer erhalten, und bestehende Bestellungen behalten ihre Versandart und Kosten.
Um auch die Dateien der Erweiterung zu entfernen, gehen Sie bei OpenCart 4 nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox CTT auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.
CTT ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit CTT verbunden und wird nicht von CTT unterstützt.