VibeFox Coordinadora for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 5.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
Coordinadora-API-Schlüssel (nur für Live-Tarife): Live-Tarife stammen aus dem Coordinadora Cotizador über den Coordinadora-WooCommerce-Dienst, denselben Dienst, den das offizielle Coordinadora-Plugin nutzt. Coordinadora stellt den API-Schlüssel Kunden mit einer aktiven Geschäftsvereinbarung aus. Fragen Sie Ihren Coordinadora-Kundenbetreuer oder sehen Sie auf wc.coordinadora.com nach. Sie benötigen außerdem den 8-stelligen DANE-Code der Stadt, aus der Sie versenden. Ohne Schlüssel funktioniert die Versandart nur mit Festpreisen.
Produkte: Für einen Live-Tarif braucht jedes Produkt im Warenkorb ein Gewicht und Abmessungen (Länge, Breite, Höhe).
VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.
Installation
1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner vfd_coordinadora per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Coordinadora oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie den API-Schlüssel, den DANE-Code der Versandstadt und, falls die Shop-Währung nicht COP ist, den COP-Wechselkurs ein. Legen Sie mindestens einen Festpreis für Kolumbien als Ausweichlösung an (siehe Konfiguration).
6. Fügen Sie VibeFox Coordinadora unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu, die Kolumbien abdeckt, oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.
7. Stellen Sie sicher, dass Ihre Produkte Gewicht und Abmessungen haben.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Coordinadora. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:
Title (zone): der Name der Versandart, den der Kunde für diese Zone sieht. Leer lassen, um den globalen Name zu verwenden.
Die Einstellungsseite zeigt oben Warnungen an, wenn Live-Tarife nicht funktionieren können oder die Methode ausgeblendet würde: Der DANE-Code des Versandorts fehlt oder ist ungültig, der COP-Wechselkurs fehlt oder es gibt keinen Festpreis für Kolumbien. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Tarife gelöscht. Zahlen dürfen mit Punkt oder Komma eingegeben werden (9,99 = 9.99).
Allgemein
Enable/Disable: schaltet Coordinadora in allen Zonen gleichzeitig ein oder aus.
Name: der Name der Versandart, den der Kunde an der Kasse sieht. Standard: Coordinadora. Ein Title der Zone überschreibt ihn.
Tax status: Taxable fügt die WooCommerce-Versandsteuer zum Tarif hinzu, None nicht. Wählen Sie None, wenn Ihre Preise oder das Angebot von Coordinadora bereits Steuern enthalten.
Live-Tarife von Coordinadora
Live-Tarife werden für Ziele in Kolumbien angefragt. Lassen Sie den Schlüssel leer, um nur Festpreise zu verwenden.
API key: Ihr WooCommerce-API-Schlüssel von Coordinadora. Er wird nie im Protokoll gespeichert.
Origin city (DANE code): der 8-stellige DANE-Code der Stadt, aus der Sie versenden, zum Beispiel 11001000 Bogotá, 05001000 Medellín, 76001000 Cali oder 08001000 Barranquilla. Auch ein 5-stelliger Gemeindecode wird akzeptiert und auf 8 Stellen ergänzt.
COP per 1 unit of store currency: Coordinadora rechnet in kolumbianischen Pesos. Wenn die Währung Ihres Shops nicht COP ist, geben Sie an, wie viele COP einer Einheit Ihrer Währung entsprechen, zum Beispiel 4300. Der Kurs wird auch genutzt, um den deklarierten Wert in COP zu übermitteln. Lassen Sie das Feld leer, werden keine Live-Tarife verwendet. Ist die Shop-Währung COP, lassen Sie es leer.
Festpreise (werden verwendet, wenn kein API-Schlüssel vorhanden ist, für Ziele außerhalb Kolumbiens und als Ausweichlösung, 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 der Währung Ihres Shops. 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 sie 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. Das gilt nur für Festpreise; ein Live-Tarif von Coordinadora deckt immer die gesamte Bestellung ab.
Bedingungen
Min weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.
Max weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 25. 0 bedeutet keine Grenze.
Minimum order subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Excluded shipping classes: blendet die Methode aus, wenn ein Artikel im Warenkorb zu einer dieser WooCommerce-Versandklassen gehört.
Free shipping: aktiviert kostenlose Lieferung ab der unten angegebenen Zwischensumme.
Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Wird nur verwendet, wenn Free shipping aktiviert ist. In diesem Fall wird keine API-Anfrage gesendet.
Verfügbarkeit ohne Versandzonen
Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch wenn sie keiner Versandzone hinzugefügt wurde.
Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die der Shop liefert. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.
Erweitert
Debug log: protokolliert die Tarifberechnungen unter WooCommerce > Status > Logs, Quelle vfd-coordinadora. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. API-Schlüssel und Kundenadressen werden nie protokolliert.
Remove data on uninstall: Wenn aktiviert, entfernt das Löschen des Plugins seine Einstellungen, Zonenmethoden und zwischengespeicherten Tarife. Deaktivieren löscht nie Daten.
So funktioniert es an der Kasse
Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Warenkorbgewicht, Mindest-Zwischensumme der Bestellung und ausgeschlossene Versandklassen. Gilt kostenloser Versand, erhält der Kunde einen kostenlosen Tarif, und es wird keine Anfrage an Coordinadora gesendet.
Bei einer Adresse in Kolumbien mit API-Schlüssel ermittelt das Plugin den DANE-Code der Zielstadt in dieser Reihenfolge: einen DANE-Code im Ortsfeld (Plugins für kolumbianische Departements und Städte an der Kasse schreiben ihn, zum Beispiel MEDELLIN (ANT) (05001000)), eine 8-stellige Postleitzahl oder die integrierte Liste der Departement-Hauptstädte und rund 40 größten Städte. Eine Stadt aus der Liste wird mit dem gewählten Departement abgeglichen. Akzente sowie Groß- und Kleinschreibung werden ignoriert.
Danach sendet das Plugin an Coordinadora den DANE-Code des Ziels sowie jedes Produkt mit der Versandstadt, seinem Gewicht (kg), seinen Abmessungen (cm), seiner Menge und seinem deklarierten Wert (COP). Shop-Einheiten werden automatisch umgerechnet. Coordinadora liefert den Preis in COP, und das Plugin rechnet ihn in die Währung Ihres Shops um. Jedes Angebot 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, ein Produkt ohne Gewicht oder Abmessungen, fehlende Einstellungen), wird der Festpreis verwendet. Gibt es keinen, wird die Methode ausgeblendet. Fehlerdetails gehen in das WooCommerce-Protokoll, nie zum Kunden.
Die Methode funktioniert in der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit der WooCommerce-Speicherung für hohe Leistung (HPOS) kompatibel.
Das Plugin 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. Eine Same-Day-Lieferung berechnet es nicht, und internationale Ziele verwenden die Festpreise.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Coordinadora. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.
Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt ihren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird Coordinadora Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen bleiben unverändert.
Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
Coordinadora erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum order subtotal und Excluded shipping classes. Ohne Live-Tarif muss ein Festpreis für das Land oder für * vorhanden sein.
Der Live-Tarif wird nicht angezeigt, nur der Festpreis: Aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-coordinadora. Typische Ursachen: Die Zielstadt wird nicht erkannt, einem Produkt fehlen Gewicht oder Abmessungen, der DANE-Code des Versandorts oder der COP-Wechselkurs fehlt, oder Coordinadora hat einen Fehler zurückgegeben.
Die Zielstadt wird nicht erkannt: Installieren Sie ein Plugin für kolumbianische Departements und Städte an der Kasse, das den DANE-Code in das Ortsfeld schreibt. Entwickler können weitere Städte mit den Filtern vfd_crd_dane_cities und vfd_crd_destination_dane zuordnen.
Enthält der Tarif Steuern? Der Tarif ist der Betrag, den Coordinadora angibt. Mit Tax status auf Taxable fügt WooCommerce die Versandsteuer hinzu; wählen Sie None, wenn das Angebot sie bereits enthält.
Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Tarife gelöscht.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.
Deinstallation
Deaktivieren des Plugins behält alle Einstellungen; es löscht nur die zwischengespeicherten Tarife. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die zwischengespeicherten Tarife werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandzeilen.
Coordinadora ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Coordinadora verbunden noch wird es von Coordinadora unterstützt.