VibeFox Coordinadora for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

Coordinadora-API-Schlüssel (nur für Live-Tarife): Live-Tarife stammen vom Coordinadora Cotizador über den Coordinadora-WooCommerce-Dienst, den auch das offizielle Coordinadora-Plugin nutzt. Coordinadora stellt den API-Schlüssel Kunden mit einer aktiven Geschäftsvereinbarung aus. Wenden Sie sich an Ihren Coordinadora-Ansprechpartner oder sehen Sie auf wc.coordinadora.com nach. Sie benötigen außerdem den 8-stelligen DANE-Code der Stadt, von der Sie versenden. Ohne Schlüssel arbeitet der Versanddienst nur mit Festpreisen.

Produkte: Für einen Live-Tarif benötigt jedes Produkt im Warenkorb Gewicht und Abmessungen (Breite, Höhe, Tiefe).

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Klicken Sie nach Abschluss des Uploads auf Configure, oder suchen Sie VibeFox Coordinadora später in der Modulliste und klicken Sie auf Configure.

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie den API-Schlüssel, den DANE-Code der Ausgangsstadt und, falls Ihre Standardwährung nicht COP ist, den COP-Wechselkurs ein. Legen Sie mindestens einen Festpreis für Kolumbien als Ersatz an (siehe Konfiguration). Klicken Sie auf Save.

5. Stellen Sie sicher, dass Kolumbien in Ihrem Shop aktiv ist und Ihre Produkte Gewicht und Abmessungen haben.

Bei der Installation legt das Modul den Versanddienst Coordinadora mit dem Lieferzeittext Courier delivery in Colombia an. Der Versanddienst wird allen Zonen und allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenlimits können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Coordinadora > Configure. Sie gelten für alle Zonen des Versanddienstes. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern leert außerdem die zwischengespeicherten Coordinadora-Tarife. Zahlen können mit Punkt oder Komma eingegeben werden (9,99 = 9.99).

Die Seite lässt das Speichern nicht zu und zeigt eine Fehlermeldung, wenn eine Zahl oder ein Tabellenpreis ungültig oder negativ ist, COP per 1 unit of store currency 0 ist, Min weight größer als Max weight ist oder Name länger als 64 Zeichen ist. Es wird nichts gespeichert, bis Sie die Eingabe korrigieren.

Die Seite zeigt oben Warnungen an, wenn Live-Tarife nicht funktionieren können oder der Versanddienst ausgeblendet würde: Origin city (DANE code) ist leer oder ungültig, COP per 1 unit of store currency fehlt, obwohl Ihre Standardwährung nicht COP ist, oder es gibt keinen Festpreis für Kolumbien (oder *). Ohne API-Schlüssel und ohne einen solchen Festpreis wird der Versanddienst für kolumbianische Adressen nie angezeigt. Eine Warnung erscheint auch, wenn die Gewichts- oder Maßeinheit des Shops unter International > Localization (Local units) dem Modul unbekannt ist; Produktgewichte werden dann als kg und Abmessungen als cm gelesen.

General

Enable Coordinadora: schaltet den Versanddienst ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstes unter Shipping > Carriers.

Name: der Name des Versanddienstes, den der Kunde an der Kasse sieht. Standard: Coordinadora. Pflichtfeld.

Tax: die Steuerregel des Versanddienstes oder No tax. Mit einer Regel fügt PrestaShop die Versandsteuer auf den Tarif auf. Wählen Sie No tax, wenn Ihre Preise oder der Coordinadora-Tarif die Steuer bereits enthalten.

Live Coordinadora rates

Live-Tarife werden für Ziele in Kolumbien abgefragt. Lassen Sie den Schlüssel leer, um nur Festpreise zu verwenden.

API key: Ihr Coordinadora-WooCommerce-API-Schlüssel von Coordinadora. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten. Der Schlüssel wird nie in das Protokoll geschrieben.

Remove the saved API key: wird nur angezeigt, wenn ein Schlüssel gespeichert ist. Aktivieren Sie es und klicken Sie auf Save, um den Schlüssel zu löschen; der Versanddienst verwendet dann nur noch Festpreise.

Origin city (DANE code): der 8-stellige DANE-Code der Stadt, von der Sie versenden, zum Beispiel 11001000 Bogotá, 05001000 Medellín, 76001000 Cali oder 08001000 Barranquilla. Ein 5-stelliger Gemeindecode wird ebenfalls akzeptiert und auf 8 Stellen ergänzt.

COP per 1 unit of store currency: Coordinadora rechnet in kolumbianischen Pesos. Wenn Ihre Standardwährung nicht COP ist, geben Sie an, wie viele COP einer Einheit Ihrer Währung entsprechen, zum Beispiel 4300. Der Kurs wird auch verwendet, um den deklarierten Wert in COP zu übermitteln. Lassen Sie das Feld leer, werden keine Live-Tarife verwendet. Der Kurs muss größer als 0 sein. Wenn Ihre Standardwährung COP ist, lassen Sie das Feld leer.

Festpreise (werden verwendet, wenn kein API-Schlüssel vorhanden ist, für Ziele außerhalb Kolumbiens und als Ersatz, wenn kein Live-Tarif verfügbar ist)

Prices by country: eine Tabelle mit Ländern, einer Spalte Price und optionalen Preisen je Paketgröße, in Ihrer Standardwährung, ohne Steuer. Die Größe ergibt sich aus dem Warenkorbgewicht: XS bis 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL über 5 kg. Price wird verwendet, wenn die Größenspalte 0 oder leer ist. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Das Land * All other countries gilt für Länder ohne eigene Zeile. Ein Land ohne Zeile (und ohne *) erhält keinen Festpreis. Eine Zeile mit Price 0 und ohne Größenpreis ergibt kostenlosen Versand.

Fixed price per: Order berechnet den Preis einmal. Item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Dies gilt nur für Festpreise; ein Live-Tarif von Coordinadora deckt immer die gesamte Bestellung ab.

Bedingungen

Min weight: blendet den Versanddienst unterhalb dieses Warenkorbgewichts aus, in kg. 0 bedeutet kein Limit.

Max weight: blendet den Versanddienst oberhalb dieses Warenkorbgewichts aus, in kg. Standard: 25 (wird auch verwendet, wenn das Feld leer ist). 0 bedeutet kein Limit. Er darf nicht kleiner als Min weight sein.

Minimum order subtotal: zeigt den Versanddienst nur an, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) mindestens diesem Betrag entspricht. Leer lassen, um ihn immer anzuzeigen.

Free shipping: aktiviert kostenlose Lieferung ab der unten angegebenen Zwischensumme.

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, vor Steuern), ab der der Versand kostenlos ist. Wird nur verwendet, wenn Free shipping aktiviert ist. In diesem Fall wird keine API-Anfrage gestellt.

Countries: bietet Coordinadora nur für diese Zielländer an. Es werden nur aktive Länder angezeigt. Leer lassen, um alle Länder der Versandzonen zuzulassen.

Erweitert

Debug log: schreibt Tarifberechnungen in logs/vfd_crd_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler und unvollständige Einstellungen werden immer protokolliert, auch wenn diese Option deaktiviert ist. API-Schlüssel und Kundenadressen werden nie protokolliert.

Log: zeigt die Größe und die neuesten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: wenn aktiviert, löscht die Deinstallation des Moduls die Coordinadora-Einstellungen, den Versanddienst, die zwischengespeicherten Tarife und die Protokolle. Ist sie deaktiviert, bleibt alles für eine erneute Installation erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Coordinadora-Preis. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht in der Anfrage enthalten. Das Modul prüft zuerst die Bedingungen: erlaubte Länder, Warenkorbgewicht und Mindestzwischensumme der Bestellung. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Coordinadora gesendet.

Für eine Adresse in Kolumbien mit API-Schlüssel ermittelt das Modul den DANE-Code der Zielstadt in dieser Reihenfolge: einen DANE-Code im Ortsfeld (Module für kolumbianische Departements und Städte schreiben ihn hinein, zum Beispiel MEDELLIN (ANT) (05001000)), eine 8-stellige Postleitzahl oder die integrierte Liste der Departement-Hauptstädte und rund 40 größten Städte. Hat die Adresse ein Departement (Bundesstaat), wird eine Stadt aus der Liste dagegen geprüft. Akzente und Groß- und Kleinschreibung werden ignoriert.

Danach sendet das Modul an Coordinadora den DANE-Code des Ziels und jedes Produkt mit der Ausgangsstadt, seinem Gewicht (kg), seinen Abmessungen (cm), seiner Menge und seinem deklarierten Wert (COP). Der deklarierte Wert ist die Zeilensumme des Produkts vor Steuern und vor Warenkorbrabatten. Shop-Einheiten werden automatisch umgerechnet. Coordinadora liefert den Preis in COP; das Modul rechnet ihn in Ihre Standardwährung und dann in die Warenkorbwährung des Kunden um. Jeder Tarif wird 1 Stunde zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten gemerkt, damit ein Ausfall bei Coordinadora nicht jede Aktualisierung der Kasse verlangsamt. Das API-Timeout beträgt 10 Sekunden.

Ist kein Live-Tarif verfügbar (API-Fehler, unbekannte Stadt, Produkt ohne Gewicht oder Abmessungen, fehlende Einstellungen), wird der Festpreis verwendet. Gibt es keinen, wird der Versanddienst für diesen Warenkorb ausgeblendet. Fehlerdetails gehen in das Debug-Protokoll, nie an den Kunden.

Wenn Sie den Versanddienst unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstes. Das Modul folgt automatisch der neuen Version.

Das Modul berechnet nur Tarife. Es erstellt keine Sendungen oder Versandbelege (guías), druckt keine Etiketten, bucht keine Abholungen (recogidas), verfolgt keine Pakete, zieht keine Nachnahme (recaudo) ein und bietet keine Droop-Abholstellen an; dafür nutzen Sie das Coordinadora-Portal. Internationale Ziele verwenden die Festpreise.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Coordinadora ist der erste Block auf Modules > Module Manager > VibeFox Coordinadora > Configure, 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-shipping-coordinadora und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Mitarbeiter mit der Berechtigung Configure für das Modul ändern. Die Texte des Blocks folgen der Sprache des Back Office (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. Nach einer Änderung der Shopadresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird der Versanddienst Coordinadora Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Das PrestaShop-Shop-Frontend weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienst auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, es aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen bleiben unberührt.

Wenn eine Lizenz abläuft, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: 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 oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Coordinadora erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist und Enable Coordinadora eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienst die Zone des Landes und die Kundengruppe des Kunden abdeckt. Prüfen Sie Countries, die Gewichtslimits und Minimum order subtotal. Ohne Live-Tarif muss ein Festpreis für das Land oder * vorhanden sein. Produkte können auf der Produktseite auch auf bestimmte Versanddienste beschränkt werden.

Der Live-Tarif wird nicht angezeigt, nur der Festpreis: aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite nach. Typische Ursachen: die Zielstadt wird nicht erkannt, ein Produkt hat kein Gewicht oder keine Abmessungen, der DANE-Code der Ausgangsstadt oder der COP-Kurs fehlt, oder Coordinadora hat einen Fehler zurückgegeben.

Die Zielstadt wird nicht erkannt: installieren Sie ein Modul für kolumbianische Departements und Städte an der Kasse, das den DANE-Code in das Ortsfeld schreibt. Entwickler können weitere Städte über die Modul-Hooks actionVfdCrdDaneCities und actionVfdCrdDestinationDane zuordnen oder die API-Adresse mit actionVfdCrdApiUrl ändern.

Enthält der Tarif die Steuer? Der Tarif ist der Betrag, den Coordinadora angibt. Mit einer Tax-Regel fügt PrestaShop die Versandsteuer hinzu; wählen Sie No tax, wenn der Tarif sie bereits enthält.

Tarife wirken nach einer Änderung veraltet: klicken Sie auf der Modulseite auf Save. Das leert die zwischengespeicherten Tarife.

Die Seite meldet, dass der Versanddienst Coordinadora nicht gefunden wurde: der Versanddienst wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Coordinadora und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus und die zwischengespeicherten Tarife werden immer entfernt. Ist Remove data on uninstall aktiviert, wird der Versanddienst gelöscht (Bestellungen behalten ihren Verlauf) und die Einstellungen und das Protokoll werden entfernt. Ist die Option deaktiviert, wird der Versanddienst nur deaktiviert und alle Einstellungen bleiben erhalten. Eine erneute Installation des Moduls oder ein Reset stellt den gespeicherten Versanddienst in dem Status wieder her, den er vorher hatte: Ein Versanddienst, den Sie ausgeschaltet hatten, bleibt ausgeschaltet.

Coordinadora ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Coordinadora verbunden und wird von Coordinadora nicht empfohlen.