VibeFox Andreani for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

Andreani-Konto (nur für Live-Tarife): Live-Tarife nutzen die Andreani-Angebots-API. Andreani stellt Geschäftskunden API-Zugangsdaten, einen Kundencode und Vertragsnummern aus, in der Regel ab etwa 300 Sendungen im Monat. Siehe developers.andreani.com oder schreiben Sie an ventapyme@andreani.com. Sie benötigen den API-Benutzernamen und das Passwort, den Kundencode und die Vertragsnummer. Andreani stellt für jeden Service einen eigenen Vertrag aus (Heimlieferung, Abholung in der Filiale). Ohne API-Zugang verwenden Sie feste Preise. Die Filialauswahl funktioniert ohne Zugangsdaten.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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_andreani per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Andreani oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Legen Sie den Namen, die Tarifquelle und die Länderpreise fest (zum Beispiel AR=5000) und für Live-Tarife die API-Zugangsdaten, den Kundencode und die Vertragsnummer (siehe Configuration).

6. Gehen Sie zu WooCommerce > Settings > Shipping > Shipping zones, öffnen oder erstellen Sie eine Zone für Argentinien und fügen Sie VibeFox Andreani hinzu. Im Zonenfenster können Sie den Titel, die Liefermodalität und einen anderen Vertrag für diese Option festlegen. Sie können auch Ignore shipping zones aktivieren und stattdessen Länder auswählen.

Konfiguration

Die wichtigsten Einstellungen finden Sie unter WooCommerce > Settings > Shipping > VibeFox Andreani. Sie gelten für alle Versandzonen. Warnungen zu fehlenden Einstellungen (API-Zugangsdaten, Vertragsnummer, Wechselkurs, kein Preis für Argentinien) werden oben auf der Seite angezeigt. Jedes Mal, wenn Sie die Einstellungen speichern, werden der zwischengespeicherte Token, die Filialliste und die Tarife gelöscht.

Zonenfenster (wenn Sie die Methode einer Versandzone hinzufügen)

Title: der Name dieser Option an der Kasse. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Delivery modality: Use global setting oder eine der vier Modalitäten (siehe unten). Fügen Sie die Methode einer Zone zweimal hinzu, zum Beispiel Haus bis Haus und Abholung in der Filiale, um beides anzubieten.

Contract number: der Andreani-Vertrag für diese Option. Lassen Sie das Feld leer, um den globalen Vertrag zu verwenden.

Allgemein

Enable/Disable: schaltet den Versand mit Andreani in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandmethode, den der Kunde an der Kasse sieht. Standard: Andreani.

Tax status: Taxable bedeutet, dass WooCommerce Steuern auf die Versandkosten aufschlägt, daher wird der API-Tarif ohne IVA übernommen. None bedeutet, dass der API-Tarif mit enthaltener IVA übernommen wird.

Andreani API (für Live-Tarife erforderlich)

Environment: Sandbox / QA (apisqa.andreani.com) (Standard) oder Production (apis.andreani.com). Verwenden Sie die Umgebung, zu der Ihre Zugangsdaten gehören.

API username: Ihr Andreani-API-Benutzername.

API password: Ihr Andreani-API-Passwort.

Client code: der von Andreani bereitgestellte Kundencode (código de cliente), zum Beispiel CL0000000.

Contract number: der Vertrag des Services, der für die Tarife verwendet wird, zum Beispiel Heimlieferung. Eine Zone kann einen anderen Vertrag verwenden, zum Beispiel für die Abholung in der Filiale.

Origin branch code: optionale Ausgangsfiliale (sucursalOrigen) für Tarifangebote. Lassen Sie das Feld leer, um die in Ihrem Vertrag hinterlegte Filiale zu verwenden.

Lieferung und Tarife

Delivery modality: Der erste Teil gibt an, wo Andreani das Paket abholt (Ihre Adresse oder eine Filiale, in der Sie es abgeben). Der zweite Teil gibt an, wo der Kunde es erhält.

Rate source: wie der Preis berechnet wird.

Country prices: ein fester Preis pro Zielland in Ihrer Shopwährung, eine Zeile pro Land im Format CC=PRICE, zum Beispiel AR=5000. Wird im festen Modus und als Ersatz bei API-Ausfall verwendet. Zeilen in einem anderen Format werden ignoriert, und beim Speichern erscheint eine Warnung mit diesen Zeilen.

ARS exchange rate: Andreani rechnet in argentinischen Pesos. Nur nötig, wenn Ihre Shopwährung nicht ARS ist: der Preis von 1 ARS in Ihrer Shopwährung, zum Beispiel 0.001. Ohne ihn werden keine API-Tarife verwendet. Feste Preise sind immer in Ihrer Shopwährung.

Default product weight (kg): wird für Produkte ohne Gewicht verwendet, wenn API-Tarife angefragt und Gewichtsgrenzen geprüft werden. Standard: 0.5.

Calculation type: Per order berechnet den Preis einmal. Per item (price x number of items) multipliziert den festen Preis aus Country prices mit der Anzahl der Artikel im Warenkorb. Ein Live-Tarif von Andreani gilt bereits für den gesamten Warenkorb und wird nicht multipliziert.

Verfügbarkeit

Min weight (kg): das minimale Warenkorbgewicht, damit die Methode angezeigt wird. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Warenkorbgewicht. Wird es überschritten, wird die Methode ausgeblendet. Standard: 100. 0 bedeutet keine Grenze.

Minimum subtotal: Die Methode wird nur angezeigt, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Excluded shipping classes: Gehört ein Artikel im Warenkorb zu einer ausgewählten WooCommerce-Versandklasse, wird die Methode ausgeblendet.

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. Lassen Sie das Feld leer, um alle Länder zuzulassen. Wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Kostenloser Versand

Free shipping: aktiviert die Schwelle für kostenlosen Versand.

Free shipping from: die Zwischensumme des Warenkorbs, ab der der Versand kostenlos ist. Setzt voraus, dass Free shipping aktiviert ist.

Filialauswahl an der Kasse (angezeigt für Haus bis Filiale und Filiale bis Filiale)

Province select width: die CSS-Breite der Provinzliste, zum Beispiel 100% oder 300px. Standard: 100%.

Branch select width: die CSS-Breite der Filialliste, zum Beispiel 100% oder 400px. Standard: 100%.

Erweitert

Debug log: protokolliert API-Anfragen und Tarifberechnungen unter WooCommerce > Status > Logs (Quelle „vfd-andreani“). Fehler werden immer protokolliert. Zugangsdaten und Token werden nie protokolliert.

Remove data on uninstall: Ist die Option aktiv, werden beim Löschen des Plugins alle seine Einstellungen und Zonenmethoden entfernt. Das Deaktivieren löscht nie etwas. Filialdaten in Bestellungen bleiben immer erhalten.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin das Warenkorbgewicht (Produktgewichte werden in kg umgerechnet, Produkte ohne Gewicht verwenden Default product weight (kg)), die Minimum subtotal und die Excluded shipping classes.

Im festen Modus wird der Preis aus Country prices übernommen. In den Live-Modi meldet sich das Plugin bei der Andreani-API an und fordert ein Angebot an, mit Postleitzahl des Ziels, Vertrag, Kundencode, Gewicht in kg, Volumen aus den Produktabmessungen und dem deklarierten Wert (die Zwischensumme des Warenkorbs in ARS). Ein Live-Tarif wird nur für eine gültige argentinische Postleitzahl angefordert. Der ARS-Betrag wird mit ARS exchange rate umgerechnet, wenn Ihre Shopwährung nicht ARS ist.

Der Anmeldetoken wird 23 Stunden zwischengespeichert und automatisch erneuert, wenn Andreani ihn ablehnt. Angebote werden 1 Stunde zwischengespeichert. Ein fehlgeschlagener API-Aufruf wird 5 Minuten lang nicht wiederholt. API-Fehler werden dem Kunden nie angezeigt: Die Methode wird ausgeblendet oder im Ersatzmodus wird der feste Preis verwendet. Der Grund wird im Protokoll festgehalten.

Ist Free shipping aktiviert und erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Tarif 0. Kostenloser Versand gilt nur dort, wo die Methode einen Preis hat: Liefert die Andreani-API keinen Tarif (und gibt es keinen festen Preis als Ersatz), wird die Methode nicht angezeigt. Bei Per item wird der feste Preis mit der Anzahl der Artikel multipliziert.

Die Methode funktioniert in der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit dem High-Performance-Bestellspeicher (HPOS) von WooCommerce kompatibel.

Das Plugin erstellt keine Andreani-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Dafür nutzen Sie das Andreani-Webportal.

Abholstellen

Bei Door to branch oder Branch to branch erscheinen unter der Andreani-Option an der Kasse eine Provinzliste und eine Filialliste, sowohl in der klassischen Kasse als auch im Kassen-Block. Die Provinz wird anhand der Lieferadresse vorausgewählt. Die Filialliste stammt aus der öffentlichen Filial-API von Andreani und wird 12 Stunden zwischengespeichert. Filialen, die keine Pakete ausgeben, werden nicht aufgeführt. Sind keine Filialen verfügbar, sieht der Kunde eine Meldung und kann eine andere Versandart wählen.

Die Bestellung kann nicht ohne Filiale abgeschlossen werden: Der Kunde sieht Please select an Andreani pickup branch. Dies wird auf dem Server für beide Kassen geprüft.

Die gewählte Filiale wird in der Bestellung gespeichert. Im Bestellbildschirm des Admins werden Modalität und Filiale unter der Lieferadresse angezeigt. Klicken Sie auf Edit, um eine andere Provinz und Filiale zu wählen. Der Kunde sieht die Filiale als Andreani pickup branch auf der Bestellseite und in den Bestell-E-Mails (HTML und Nur-Text). Bestehende Bestellungen behalten ihre Filialdaten.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Andreani. 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 Andreani 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 Seite Plugins und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Andreani erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone der Kundenadresse hinzugefügt wurde (oder Ignore shipping zones aktiviert ist und das Land erlaubt ist). Prüfen Sie, ob Country prices eine Zeile für das Land hat (für feste Preise oder als Ersatz), und kontrollieren Sie die Gewichtsgrenzen, die Minimum subtotal und die Excluded shipping classes. Lesen Sie die Warnungen oben auf der Einstellungsseite.

Live-Tarife erscheinen nicht: Aktivieren Sie das Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs (Quelle „vfd-andreani“). Dort steht der Grund: fehlende Zugangsdaten oder Vertragsnummer, eine fehlgeschlagene Anmeldung (falscher Benutzername, Passwort oder Umgebung), noch keine gültige argentinische Postleitzahl, kein Wechselkurs oder ein HTTP-Fehler von Andreani. Mit Andreani API, fixed price if the API fails erhalten Kunden weiterhin den festen Preis, während Sie das Problem beheben.

Mein Shop rechnet nicht in argentinischen Pesos: Setzen Sie ARS exchange rate auf den Wert von 1 ARS in Ihrer Shopwährung.

Die Versandsteuer wirkt falsch: Ist Tax status auf Taxable gesetzt, wird der Andreani-Tarif ohne IVA verwendet und WooCommerce fügt seine eigene Steuer hinzu. Bei None wird der Tarif mit IVA verwendet und WooCommerce fügt keine Steuer hinzu. Prüfen Sie bei Taxable, ob die Steuern in WooCommerce eingerichtet sind.

Keine Filialen in der Liste: Die Filial-API von Andreani hat nicht geantwortet. Eine fehlgeschlagene Anfrage wird nach 5 Minuten wiederholt. Prüfen Sie das Protokoll.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden der zwischengespeicherte Token, die Filialliste und die 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

Beim Deaktivieren des Plugins bleiben alle Einstellungen erhalten, nur die Caches werden geleert. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie der zwischengespeicherte Token, die Filialliste und die Tarife werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Filialdaten in Bestellungen werden nie gelöscht.

Andreani ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Andreani verbunden und wird nicht von Andreani empfohlen.