VibeFox Servientrega 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.

Servientrega-Konto (nur für Live-Tarife): Live-Tarife nutzen den Servientrega Cotizador Corporativo (Firmen-Angebots-API). Sie benötigen ein Servientrega-Firmenkonto (Kreditkonto) mit Zugriff darauf. Sie brauchen drei Angaben: den Benutzer, das Passwort und den Abrechnungscode (código de facturación, meist beginnend mit SER). Das sind Ihre SISCLINET-Zugangsdaten, die Ihr Servientrega-Firmenberater ausstellt. Wenn Sie nur feste Preise nutzen, benötigen Sie kein Servientrega-Konto.

Serverzugriff (nur für Live-Tarife): Ihr Server muss web.servientrega.com per HTTP auf Port 8058 (Angebots-API) und Port 8081 (Webservice zur Passwortverschlüsselung) erreichen können.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert 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. Sie können auch den Ordner vfd_servientrega per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Servientrega, 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. Für Live-Tarife geben Sie Benutzer, Passwort und Abrechnungscode ein, wählen das Servientrega-Produkt, tragen den DANE-Code des Versandorts ein und, falls die Shopwährung nicht COP ist, den Währungsumrechnungskurs (siehe Konfiguration).

6. Optional fügen Sie feste Preise je Land und Gewicht sowie Ausweichkosten hinzu.

7. Fügen Sie VibeFox Servientrega unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Servientrega. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name, den Kunden für diese Zone sehen. Leer lassen, um den globalen Method title zu verwenden.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Servientrega-Angebote und das Login-Token gelöscht. Wenn Live-Tarife mit den gespeicherten Einstellungen nicht funktionieren können, zeigt ein Hinweis über den Einstellungen den Grund an: fehlender Benutzer, Passwort oder Abrechnungscode, ein fehlender Umrechnungskurs oder ein fehlender DANE-Code des Versandorts.

Allgemein

Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.

Method title: der Name der Versandmethode, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: Servientrega.

Servientrega-API (Live-Tarife für Kolumbien) (optional; ohne Zugangsdaten werden nur die festen Preise verwendet)

User (login): Ihr Servientrega- / SISCLINET-Benutzer.

Password: Ihr Servientrega- / SISCLINET-Passwort, so wie Sie es eingeben. Das Plugin lässt es vor der Anmeldung vom Servientrega-Webservice verschlüsseln, wie es auch der offizielle Servientrega-Client tut.

Billing code: der código de facturación Ihres Servientrega-Kontos, in SISCLINET angezeigt. Er beginnt meist mit SER.

Alle drei Felder werden für Live-Tarife benötigt. Live-Tarife werden nur für Ziele in Kolumbien angefragt. Andere Länder verwenden die festen Preise.

Servientrega product: der Dienst aus Ihrer Servientrega-Vereinbarung, für den ein Tarif angefragt wird.

Das abgerechnete Gewicht ist das größere aus tatsächlichem und volumetrischem Gewicht.

Currency conversion rate: Servientrega berechnet Tarife in COP. Wenn die Währung Ihres Shops nicht COP ist, geben Sie den Wert von 1 COP in der Währung Ihres Shops ein, zum Beispiel 0.00023. Der deklarierte Paketwert wird auf dieselbe Weise in COP umgerechnet. Lassen Sie das Feld leer, wenn Ihre Shopwährung COP ist. Wenn Ihr Shop eine andere Währung nutzt und dieses Feld leer ist, werden keine Live-Tarife verwendet und die festen Preise gelten. Das Plugin ruft keine Wechselkurse ab. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Versand ab (für Live-Tarife verwendet)

Origin city (DANE code): der 8-stellige DANE-Code der Gemeinde, von der Sie versenden, zum Beispiel 11001000 Bogotá, 05001000 Medellín, 76001000 Cali oder 08001000 Barranquilla. Ein 5-stelliger Gemeindecode wird ebenfalls akzeptiert. Ist das Feld leer und liegt die Shopadresse unter WooCommerce > Settings > General in Kolumbien, wird die Gemeinde der Shopadresse verwendet.

Feste Preise (werden verwendet, wenn kein Live-Tarif vorliegt: keine Zugangsdaten, ein Ziel außerhalb Kolumbiens, eine unbekannte Gemeinde, ein fehlender Umrechnungskurs, ein API-Fehler oder keine Abdeckung für die Route)

Price per country: eine Tabelle mit Ländern und Preisen in Ihrer Shopwährung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine Zeile zu entfernen. Price gilt für jedes Gewicht. Die Gewichtsspalten XS ≤1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg und XL >5 kg ersetzen den Preis für dieses Gewicht, wenn sie über 0 liegen. Die Zeile * Default gilt für alle Länder ohne eigene Zeile.

Fallback cost: wird verwendet, wenn kein Live-Tarif vorliegt und keine Zeile der Tabelle passt. Leer lassen, um die Methode in diesem Fall auszublenden.

Fixed price applies: wie feste Preise berechnet werden.

Live-Tarife von Servientrega gelten immer pro Sendung.

Bedingungen

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet keine Grenze.

Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 50. 0 bedeutet keine Grenze.

Minimum order amount: zeigt die Methode nur, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Free shipping from: die Lieferung ist kostenlos, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. Das gilt nur, wenn die Methode einen Preis hat: ein Tabellenpreis oder die Ausweichkosten (dann wird keine Anfrage an Servientrega gesendet) oder ein Live-Tarif. Leer lassen, um nie kostenlosen Versand anzubieten.

Excluded shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.

Tax status: Taxable fügt den Versandkosten die WooCommerce-Steuer hinzu, None nicht. Die Angebote von Servientrega (ValorTotal) enthalten bereits die Gebühren des Transportunternehmens. Wählen Sie None, wenn Sie keine Steuer darauf aufschlagen möchten.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Servientrega für die unten genannten Länder an, auch wenn die Methode keiner Versandzone hinzugefügt wurde.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie versenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Erweitert

Debug log: schreibt Tarifberechnungen und API-Fehler in das WooCommerce-Protokoll: WooCommerce > Status > Logs, Quelle vfd_servientrega. Zugangsdaten, Token und Kundenadressen werden nicht protokolliert. Schalten Sie das Protokoll nach Abschluss wieder aus.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins alle Servientrega-Einstellungen, Zonenmethoden und zwischengespeicherten Angebote. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Dann sucht es nach einem Preis: dem Live-Tarif von Servientrega, danach der Preistabelle und schließlich den Ausweichkosten. Gibt es keinen Preis, wird die Methode ausgeblendet. Gilt kostenloser Versand, wird die Methode mit einem Preis von 0 angezeigt.

Für ein Ziel in Kolumbien mit hinterlegten Zugangsdaten ermittelt das Plugin den DANE-Code der Gemeinde des Kunden. Es verwendet einen DANE-Code, der als Postleitzahl oder im Ortsfeld eingegeben wurde, oder gleicht Departamento und Stadt mit der integrierten Tabelle von rund 1.130 Gemeinden ab. Akzente und "D.C." werden ignoriert. Ein Stadtname, der nur in einem Departamento vorkommt, wird auch ohne Angabe des Departamento gefunden.

Anschließend sendet das Plugin an Servientrega ein Paket pro Bestellung: das Gesamtgewicht, umgerechnet von Ihrer Shop-Einheit in kg, und eine Box mit Länge und Breite des größten Artikels sowie dem Gesamtvolumen aller Artikel, umgerechnet in cm. Produkte ohne Maße zählen als 10 × 10 × 10 cm. Der deklarierte Wert ist die Zwischensumme des Warenkorbs, umgerechnet in COP, mindestens 6.000 COP. Servientrega liefert den Gesamtbetrag in COP zurück, und das Plugin rechnet ihn in Ihre Shopwährung um.

Das Login-Token wird bis zu seinem Ablauf gespeichert, höchstens 4 Tage. Ein abgelehntes Token wird einmal automatisch erneuert. Jedes Angebot wird 1 Stunde pro Route und Paket zwischengespeichert, sodass derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage (Verschlüsselung, Anmeldung oder Angebot) wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf Servientrega warten muss. Das Timeout beträgt 10 Sekunden pro Anfrage.

Gibt es keinen Live-Tarif, stammt der Preis aus der Tabelle der festen Preise, danach aus Fallback cost. Trifft keines von beiden zu, wird die Methode ausgeblendet. Der Kunde sieht nie einen API-Fehler. Der Grund wird im Debug-Protokoll festgehalten.

Die Methode funktioniert an der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Spanische Übersetzungen (Kolumbien, Spanien) sind enthalten.

Das Plugin berechnet nur Tarife. Es erstellt keine Versandscheine (guías), Etiketten oder Sticker, beantragt keine Abholungen, verfolgt oder storniert keine Sendungen und lässt Kunden keine Servientrega-Filiale (Centro de Soluciones) wählen. Den Versandschein erstellen Sie in SISCLINET oder in Ihrem Servientrega-Portal. Nachnahme (logística de recaudo) wird nicht berechnet. Live-Angebote gelten nur für Inlandssendungen innerhalb Kolumbiens. Ecuador, Peru, Panama und internationale Sendungen verwenden die festen Preise.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Servientrega. 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 funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Servientrega Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Servientrega 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 amount und Excluded shipping classes. Ohne Live-Tarif prüfen Sie, ob das Land oder * Default einen Preis hat oder Fallback cost gesetzt ist.

Live-Tarife erscheinen nicht: aktivieren Sie das Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd_servientrega. Häufige Gründe: ein fehlender Umrechnungskurs (die Shopwährung ist nicht COP), kein DANE-Code des Versandorts, Departamento oder Stadt des Kunden sind noch nicht eingegeben oder keine bekannte Gemeinde, falsche Zugangsdaten oder keine Abdeckung für die Route. Feste Preise decken diese Fälle ab, wenn Sie sie festlegen.

Anmeldung schlägt fehl: prüfen Sie Benutzer, Passwort und Abrechnungscode bei Ihrem Servientrega-Firmenberater. Nach einer fehlgeschlagenen Anmeldung wartet das Plugin 10 Minuten, bevor es erneut versucht. Speichern Sie die Einstellungen, um sofort erneut zu versuchen.

Die Stadt des Kunden wird nicht erkannt: Departamento und Stadt werden mit der integrierten DANE-Tabelle abgeglichen. Bei seltenen Schreibweisen kann der Kunde den 8-stelligen DANE-Code als Postleitzahl eingeben. Entwickler können ihn mit dem Filter vfd_svtg_dane_code zuordnen.

Tarife wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Servientrega-Angebote und das Token gelöscht.

Für Entwickler: die Filter vfd_svtg_quote_request und vfd_svtg_default_dimensions passen die Angebotsanfrage und die Abmessungen von Produkten ohne Maße an. vfd_svtg_api_base und vfd_svtg_soap_url ändern die Endpunkte, zum Beispiel wenn Servientrega Ihnen einen anderen Server nennt.

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

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren Sie es und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden, zwischengespeicherte Angebote und Token werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandzeilen.

Servientrega ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Servientrega verbunden und wird von Servientrega weder unterstützt noch empfohlen.