VibeFox Andreani 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), mit dem Standard-Theme.

PHP: 8.0 oder neuer.

Andreani-Konto (nur für Live-Tarife): Live-Tarife nutzen die Angebots-API von Andreani. Andreani stellt Geschäftskunden API-Zugangsdaten, eine Kundennummer und Vertragsnummern zur Verfügung, meist ab etwa 300 Sendungen im Monat. Informationen finden Sie unter developers.andreani.com oder unter ventapyme@andreani.com. Sie benötigen den API-Benutzernamen und das Passwort, die Kundennummer (código de cliente) und die Vertragsnummer. Andreani stellt für jeden Dienst 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 auf einer 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 OpenCart-3-Paket vfd_andreani-oc3-(version).ocmod.zip und das OpenCart-4-Paket vfd_andreani.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_andreani-oc3-(version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, Sie müssen Extensions > Modifications also nicht aktualisieren. Statt des Installers können Sie auch 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 Andreani 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 im Feld License key des Lizenzblocks oben auf der Seite Edit ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_andreani.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 Andreani, 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 ein wie in den Schritten 4 und 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation sind Enable/Disable und Enable second option ausgeschaltet, und Andreani wird an der Kasse erst angeboten, wenn Sie eine Option einschalten und auf Save klicken. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die gespeicherten Andreani-Einstellungen wieder verwendet, beide Optionen sind aber ausgeschaltet: Schalten Sie sie ein und klicken Sie auf Save.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Shipping > VibeFox Andreani > Edit. Die Abschnitte sind links aufgelistet. Eine einzige Schaltfläche Save speichert die gesamte Seite ohne Neuladen. Danach sehen Sie Settings saved. Cached token, branches and rates were cleared. Nur Administratoren mit der Berechtigung zum Ändern dieser Erweiterung können die Einstellungen speichern.

Oben auf der Seite erscheinen Warnungen zu fehlenden Einstellungen: Live-Tarife gewählt, aber ohne API-Benutzernamen und Passwort oder ohne Vertragsnummer, kein ARS exchange rate, wenn die Währung Ihres Shops nicht ARS ist, oder kein Preis für Argentinien in Country prices. Eine Warnung erscheint außerdem, wenn die Gewichts- oder Längeneinheit des Shops der Erweiterung nicht bekannt ist (Gewichte werden dann als kg, Abmessungen als cm gelesen).

Beim Speichern wird ein leerer Name, ein Name mit mehr als 64 Zeichen oder mit einem der Zeichen < > ; = # { }, ein Min weight (kg), das größer als Max weight (kg) ist, oder eine Sort order, die keine ganze Zahl ist, abgelehnt, und es wird nichts gespeichert. Ein Wert, der keine Zahl ist, eine negative Zahl oder ein ARS exchange rate von 0 oder weniger wird nicht gespeichert, und eine Warnung nennt das Feld.

Allgemein

Andreani bietet an der Kasse zwei Optionen: die Hauptoption, die hier und unter Andreani API und Delivery and rates eingerichtet wird, und die Second option. Beide werden im Schritt Versandart unter der Überschrift Andreani angezeigt.

Enable/Disable: schaltet die Hauptoption von Andreani ein oder aus. Standard: aus. Die zweite Option hat einen eigenen Schalter.

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

Tax status: None (the API rate is taken with IVA) (Standard) oder eine Ihrer Steuerklassen. Mit einer Steuerklasse addiert OpenCart Steuern auf die Versandkosten, daher wird der API-Tarif ohne IVA übernommen. Bei None wird der API-Tarif mit enthaltener IVA übernommen. Gilt für beide Optionen.

Sort order: die Position von Andreani unter den Versandarten an der Kasse. Eine ganze Zahl.

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 Benutzername für die Andreani-API.

API password: Ihr Passwort für die Andreani-API. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Clearing the API username removes it too. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

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

Contract number: der für die Tarife genutzte Servicevertrag, zum Beispiel Heimlieferung. Die zweite Option kann einen anderen Vertrag nutzen, zum Beispiel für die Abholung in der Filiale.

Origin branch code: optionale Ursprungsfiliale (sucursalOrigen) für Tarifanfragen. Leer lassen, um die Filiale aus Ihrem Vertrag zu verwenden.

Lieferung und Tarife

Delivery modality: die Modalität der Hauptoption. Der erste Teil gibt an, wo Andreani das Paket abholt (Ihre Adresse oder eine Filiale, bei 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 der Standardwährung Ihres Shops, ohne Steuern, eine Zeile pro Land im Format CC=PREIS, zum Beispiel AR=5000. Verwendet im festen Modus und als Ersatz bei API-Ausfall. Länder ohne Zeile erhalten keinen festen Preis. Zeilen in einem anderen Format werden ignoriert, und eine Warnung listet sie beim Speichern auf.

ARS exchange rate: Andreani rechnet in argentinischen Pesos ab. Nur nötig, wenn die Standardwährung Ihres Shops nicht ARS ist: der Preis von 1 ARS in der Währung Ihres Shops, zum Beispiel 0.001. Ohne diesen Wert werden API-Tarife nicht verwendet.

Default product weight (kg): wird für Produkte ohne Gewicht bei API-Tarifanfragen und bei der Prüfung der Gewichtsgrenzen verwendet. Leer bedeutet 0,5 kg.

Calculation type: Per order (Standard) 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 ganzen Warenkorb und wird nicht multipliziert.

Verfügbarkeit

Min weight (kg): das minimale Warenkorbgewicht, damit die Option erscheint. 0 bedeutet keine Begrenzung (Standard).

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

Minimum subtotal: zeigt die Option nur an, wenn die Zwischensumme des Warenkorbs (Produkte, die versandt werden müssen, nach dem Gutschein, ohne Steuern, in der Standardwährung Ihres Shops) mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Geo zone: bietet Andreani nur für Adressen in dieser Geozone an. All zones (Standard) bedeutet keine Begrenzung. Geozonen werden unter System > Localisation > Geo Zones verwaltet. Wird nicht verwendet, wenn Ignore shipping zones aktiv ist.

Ignore shipping zones: bietet Andreani für die unten genannten Länder an, unabhängig von der Geozone. Standard: aus.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zuzulassen. Wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Kostenloser Versand

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

Free shipping from: die Zwischensumme des Warenkorbs (in der Standardwährung Ihres Shops), ab der der Versand kostenlos ist. Setzt voraus, dass Free shipping aktiv ist.

Zweite Option

Eine zweite Andreani-Option mit eigenem Namen, eigener Liefermodalität und eigenem Vertrag, zum Beispiel "a domicilio" in der Hauptoption und "retiro en sucursal" hier, um beides anzubieten. Alle übrigen Einstellungen werden gemeinsam genutzt.

Enable second option: bietet die zweite Option an der Kasse an. Standard: aus.

Second option name: der Name dieser Option an der Kasse. Standard: Andreani - branch pickup. Pflichtfeld.

Delivery modality: Use global setting oder eine der vier Modalitäten. Standard: Door to branch (Puerta a Sucursal).

Contract number: Andreani stellt für jeden Dienst einen eigenen Vertrag aus (Heimlieferung, Abholung in der Filiale). Leer lassen, um den globalen Vertrag zu verwenden.

Filialauswahl (angezeigt bei Door to branch und Branch to branch)

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 in storage/logs/vfd_andr_debug.log.php. Die Datei ist aus dem Web nicht lesbar. Fehler werden immer protokolliert. Zugangsdaten und Token werden nie protokolliert. Erreicht die Datei 5 MB, wird sie nach vfd_andr_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: ist die Option aktiv, werden beim Deinstallieren der Erweiterung alle Andreani-Einstellungen und das Protokoll gelöscht. Ist sie aus (Standard), bleiben sie für eine erneute Installation erhalten. Filialdaten, die in Bestellungen gespeichert sind, bleiben immer erhalten.

Import / Export

Export: klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Das API-Passwort wird 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. Das gespeicherte API-Passwort bleibt erhalten.

Ablauf an der Kasse

Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Preis jeder aktivierten Andreani-Option. Ist eine Geo zone gesetzt und Ignore shipping zones ausgeschaltet, wird Andreani für Adressen außerhalb der Geozone nicht angeboten. Nur Produkte mit Requires Shipping auf Yes zählen: Andere Produkte fügen kein Gewicht hinzu und sind nicht in der Zwischensumme enthalten. Anschließend prüft die Erweiterung die Länder (wenn Ignore shipping zones aktiv ist), das Warenkorbgewicht (Produktgewichte werden in kg umgerechnet, Produkte ohne Gewicht nutzen Default product weight (kg)) und die Minimum subtotal. Die Zwischensumme ist der Preis der Produkte, die versandt werden müssen, nach dem Gutscheinrabatt und vor Steuern.

Im festen Modus wird der Preis aus Country prices übernommen. In den Live-Modi meldet sich die Erweiterung bei der Andreani-API an und fordert ein Angebot an, mit Ziel-Postleitzahl, Vertrag, Kundennummer, Gewicht in kg, Volumen aus den Produktabmessungen und dem deklarierten Wert (die Warenkorb-Zwischensumme in ARS). Ein Live-Tarif wird nur für eine gültige argentinische Postleitzahl angefragt (4 Ziffern oder ein CPA wie C1425ABC). Der ARS-Betrag wird mit dem ARS exchange rate umgerechnet, wenn die Währung Ihres Shops nicht ARS ist. Der Preis wird in der Standardwährung Ihres Shops berechnet, auf deren Nachkommastellen gerundet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax status angezeigt.

Das Anmelde-Token wird bis zu 23 Stunden gespeichert und automatisch erneuert, wenn Andreani es ablehnt. Angebote werden 1 Stunde lang zwischengespeichert. Ein fehlgeschlagener API-Aufruf wird 5 Minuten lang nicht wiederholt. Alles wird im OpenCart-Cache gespeichert, daher bleibt ein Eintrag nie länger als die Lebensdauer des OpenCart-Caches (standardmäßig 1 Stunde) und wird danach einfach neu angefragt. API-Fehler werden dem Kunden nie angezeigt: Die Option wird ausgeblendet, oder im Ausweichmodus wird der feste Preis verwendet. Der Grund wird im Protokoll festgehalten.

Ist Free shipping aktiv und erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Preis 0. Kostenloser Versand gilt nur dort, wo die Option einen Preis hat: Liefert die Andreani-API keinen Tarif und gibt es keinen festen Preis als Ersatz, wird die Option nicht angezeigt.

Die Erweiterung erstellt keine Andreani-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Verwenden Sie dafür das Andreani-Webportal.

Auf OpenCart 4 klicken Sie an der Kasse im Block der Versandart auf Choose und wählen im Fenster Shipping method options eine Andreani-Option. Die Optionen funktionieren genauso wie unter OpenCart 3; die Filialauswahl wird unter Abholstellen beschrieben.

Abholstellen

Wenn eine Option mit Door to branch oder Branch to branch angeboten wird, erscheinen direkt darunter im Schritt Versandart eine Provinzliste und eine Filialliste. Die Provinz wird anhand der Region der Lieferadresse vorausgewählt. Die Filialliste stammt von der öffentlichen Filial-API von Andreani und wird bis zu 12 Stunden zwischengespeichert (innerhalb der Lebensdauer des OpenCart-Caches). Filialen, die keine Pakete annehmen, werden nicht aufgeführt. Der Schritt Versand selbst wartet nie auf Andreani: Ist die Liste noch nicht im Cache, wird sie im Hintergrund geladen, und der Kunde sieht kurz Loading Andreani branches.... Sind keine Filialen verfügbar, sieht der Kunde No Andreani branches available right now. Please try again later or choose another shipping method.

Die Auswahl wird gespeichert, sobald der Kunde sie trifft. Es wird nur eine Filiale aus der aktuellen Andreani-Liste akzeptiert. Ohne Filiale lässt sich Continue im Schritt Versand nicht ausführen, und der Kunde sieht Please select an Andreani pickup branch. Der Server prüft die Filiale erneut, wenn der Kunde fortfährt. Ist die Filiale nicht mehr in der Liste, sieht der Kunde The selected Andreani branch is not available. Please choose another one.

Auf OpenCart 4 erscheinen die Provinzliste und die Filialliste im Fenster Shipping method options, direkt unter der Andreani-Filialoption, mit denselben Texten und Prüfungen. Continue im Fenster ohne Filiale wird mit Please select an Andreani pickup branch. unter der Option aufgehalten. Lehnt der Shop die Filiale ab, wenn der Kunde fortfährt, wird die Meldung oben auf der Kassenseite angezeigt, und das Fenster bleibt offen. OpenCart 4 behält für die Kasse eine Bestellung und aktualisiert sie bei jeder Bestätigung; die Filiale der Bestellung wird mit aktualisiert und entfernt, wenn der Kunde die Bestellung auf eine andere Versandart ändert.

Eine Filiale, die bei einer Andreani-Option gewählt wurde, gehört nicht zu einer Bestellung mit einer anderen Option oder einer anderen Versandart.

Die Auswahl ist für die Ein-Seiten-Kasse des Standard-Themes von OpenCart 3 und für die Kasse des Standard-Themes von OpenCart 4 gemacht. Ein Theme mit einem anderen Aufbau des Schritts Versand benötigt unter Umständen Anpassungen am Skript der Auswahl.

Bestellungen

Die Bestellung speichert die Liefermodalität und bei den Modalitäten mit Filiale die gewählte Filiale.

Shipping method of the order: die Filiale wird dem Text der Versandart hinzugefügt, zum Beispiel Andreani - branch pickup: und der Filialname. Enthält der Name der Option keine Filiale, wird der Text Pickup branch: (oder Andreani pickup branch:, wenn der Name kein Andreani enthält) vor dem Filialnamen eingefügt, zum Beispiel Andreani - Pickup branch: und der Filialname. Dieser Text erscheint in den Bestell-E-Mails an den Kunden und an den Shop, im Bestellverlauf des Kunden, auf der Rechnung und auf der Bestellseite im Administrationsbereich. Der Text ist von OpenCart auf 128 Zeichen begrenzt; die vollständigen Filialdaten speichert die Erweiterung. Die Erfolgsseite der Bestellung in OpenCart zeigt die Versandart nicht an.

Admin order page: Öffnen Sie unter Sales > Orders eine Bestellung. Ein Bereich Andreani zeigt Andreani modality und bei den Modalitäten mit Filiale Andreani branch (Name, ID und Provinz). Klicken Sie auf Edit, wählen Sie eine andere Provinz und Filiale und klicken Sie auf Save, um sie zu ändern. Sie sehen Branch updated., und die Filiale im Text der Versandart der Bestellung wird ebenfalls ersetzt. Es können nur Filialen aus der Andreani-Liste gespeichert werden. Ist die Liste nicht verfügbar, sehen Sie The Andreani branch list is not available right now - the branch cannot be changed. Das Ändern der Filiale erfordert die Berechtigung zum Ändern für sale/order und Zugriff auf extension/shipping/vfd_andreani (OpenCart 3) oder extension/vfd_andreani/shipping/vfd_andreani (OpenCart 4). Der Bereich wird auch für bereits aufgegebene Andreani-Bestellungen angezeigt, während die Erweiterung deaktiviert ist.

Solange die Erweiterung deaktiviert ist, wird der Bereich Andreani nicht angezeigt. Die Filialdaten bleiben gespeichert, und der Text der Versandart der Bestellung ändert sich nicht. Bestehende Bestellungen behalten ihre Filialdaten.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Andreani ist der erste Block auf Extensions > Extensions > Shipping > VibeFox Andreani > Edit, oberhalb der Einstellungen. Geben 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-andreani und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Administrator-Benutzer mit der Berechtigung Modify für die Erweiterung ändern. Die Texte des Blocks folgen der Sprache des Administrationsbereichs (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, zeigt 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. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer 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 aktiven Schlüssel werden die Andreani-Versandoptionen an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Admin-Benutzer, der im Administrationsbereich im selben Browser angemeldet ist, sieht die Versandart im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Versandart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Administrationsbereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Administrationsbereichs 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. Beim Deinstallieren der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Andreani erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist (bei der zweiten Option außerdem Enable second option), und ob Sie nach der Installation auf Save geklickt haben. Prüfen Sie Geo zone bzw. Ignore shipping zones und Countries. Prüfen Sie, ob Country prices eine Zeile für das Land hat (für feste Preise oder als Ersatz), ferner die Gewichtsgrenzen und die Minimum subtotal. Lesen Sie die Warnungen oben auf der Seite Edit. Prüfen Sie, ob die Produkte Requires Shipping auf Yes haben.

Live-Tarife erscheinen nicht: schalten Sie Debug log ein, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Erweiterungsseite nach. Es zeigt den Grund: fehlende Zugangsdaten oder Vertragsnummer, 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 die 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 der Standardwährung Ihres Shops.

Die Versandsteuer wirkt falsch: Mit einer Steuerklasse in Tax status wird der Andreani-Tarif ohne IVA verwendet, und OpenCart fügt eigene Steuern hinzu. Bei None wird der Tarif mit IVA verwendet und keine Steuer hinzugefügt. Prüfen Sie, ob Steuern in den Shop-Einstellungen aktiviert sind und die Steuerklasse Sätze für Argentinien hat.

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.

Die falsche Provinz ist vorausgewählt: Die Provinz wird aus der Region der Lieferadresse gelesen. Der Kunde kann jederzeit eine andere Provinz wählen.

Tarife wirken nach einer Änderung veraltet: klicken Sie auf der Erweiterungsseite auf Save. Dadurch werden das zwischengespeicherte Token, die Filialliste und die Tarife gelöscht.

Die Seite meldet „Warning: You do not have permission to modify VibeFox Andreani!“: Ihre Administrator-Benutzergruppe darf die Einstellungen möglicherweise nur ansehen. Geben Sie der Gruppe die Berechtigung zum Ändern für extension/shipping/vfd_andreani (OpenCart 3) oder extension/vfd_andreani/shipping/vfd_andreani (OpenCart 4) unter System > Users > User Groups.

Für Entwickler: die Andreani-API-Hosts können über die Einstellung vfd_andr_api_url (für Tests) ersetzt werden; sie hat kein Feld auf der Einstellungsseite.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox Andreani auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt immer den Status, Sort order, Tax status und Geo zone zurück. Die Erweiterung entfernt immer ihre Handler für Kasse und Bestellseite sowie das zwischengespeicherte Token, die Filialliste und die Tarife. Ist Remove data on uninstall aktiv, werden außerdem alle Andreani-Einstellungen und das Debug-Protokoll gelöscht. Ist die Option aus, bleiben die übrigen Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. Filialdaten, die in Bestellungen gespeichert sind, werden nie gelöscht, und bestehende Bestellungen behalten ihre Versandart und Kosten.

Auf OpenCart 4 entfernen Sie die Dateien der Erweiterung ebenfalls, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox Andreani in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) klicken und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Andreani ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Andreani verbunden und wird nicht von Andreani unterstützt.