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

Andreani-Konto (nur für Live-Tarife): Live-Tarife nutzen die Angebots-API von Andreani. Andreani stellt Geschäftskunden API-Zugangsdaten, einen Kundencode und Vertragsnummern zur Verfügung, 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 API-Passwort, den Kundencode und die Vertragsnummer. Andreani stellt für jeden Dienst einen eigenen Vertrag aus (Lieferung an die Haustür, Abholung in der Filiale). Ohne API-Zugang verwenden Sie feste Preise. Die Filialauswahl funktioniert ohne Zugangsdaten.

VibeFox license key: wird auf vibefox.net gekauft. 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. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Andreani in der Modulliste und klicken Sie dort auf Configure.

3. Geben 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. Legen Sie den Namen, die Tarifquelle, die Länderpreise (zum Beispiel AR=5000) und bei Live-Tarifen die API-Zugangsdaten, den Kundencode und die Vertragsnummer fest (siehe Konfiguration). Klicken Sie auf Save.

Bei der Installation legt das Modul zwei Versanddienstleister an:

Beide Versanddienstleister sind der Zone Argentinien und allen Kundengruppen zugeordnet. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen finden Sie auf der Modulseite: Modules > Module Manager > VibeFox Andreani > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Nach dem Speichern sehen Sie Settings saved. Cached token, branches and rates were cleared. Warnungen zu fehlenden Einstellungen (API-Zugangsdaten, Vertragsnummer, ARS-Wechselkurs, kein Preis für Argentinien, ein gelöschter Versanddienstleister) werden oben auf der Seite angezeigt. Eine Warnung erscheint auch, wenn das Modul die Gewichts- oder Abmessungseinheit des Shops nicht kennt (Gewichte werden dann als kg gelesen, Abmessungen als cm). Beim Speichern wird ein Name mit mehr als 64 Zeichen oder ein Min weight (kg) größer als Max weight (kg) 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.

General

Enable/Disable: schaltet den Versand mit Andreani ein oder aus. Es ist derselbe Schalter wie der Status des Hauptversanddienstleisters unter Shipping > Carriers. Die zweite Option hat einen eigenen Schalter.

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

Tax status: None, oder Taxable mit einer Ihrer Steuerregeln. Mit einer Steuerregel fügt der Shop die Steuer zu den Versandkosten hinzu, daher wird der API-Tarif ohne IVA übernommen. Bei None wird der API-Tarif mit IVA übernommen. Die Einstellung wird in beide Andreani-Versanddienstleister gespeichert.

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 Vertrag des Dienstes, der für die Tarife verwendet wird, zum Beispiel Lieferung an die Haustür. Die zweite Option kann einen anderen Vertrag verwenden, zum Beispiel für die Abholung in der Filiale.

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

Lieferung und Tarife

Delivery modality: die Modalität des Hauptversanddienstleisters. 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 der Standardwährung Ihres Shops, ohne Steuern, eine Zeile pro Land im Format CC=PRICE, zum Beispiel AR=5000. Wird im festen Modus und als Ersatz bei einem API-Fehler verwendet. Länder ohne Zeile erhalten keinen festen Preis. Zeilen in einem anderen Format werden ignoriert, und beim Speichern nennt eine Warnung sie.

ARS exchange rate: Andreani rechnet in argentinischen Pesos. 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 ihn 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 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 Gewicht des Warenkorbs, damit der Versanddienstleister erscheint. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Gewicht des Warenkorbs. Wird es überschritten, wird der Versanddienstleister ausgeblendet. Leer bedeutet 100 kg, 0 bedeutet keine Grenze.

Minimum subtotal: Der Versanddienstleister wird nur angezeigt, wenn die Zwischensumme des Warenkorbs (versandpflichtige Produkte, nach Rabatten, ohne Steuern) mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um ihn immer anzuzeigen.

Ignore shipping zones: bietet Andreani für die unten genannten Länder an, ohne Zonen einzurichten. Wenn Sie es einschalten, werden beide Versanddienstleister allen Zonen zugeordnet, und eine später angelegte Zone wird sofort zugeordnet. Wenn Sie es ausschalten, erhalten die Versanddienstleister ihre vorherigen Zonen zurück.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zu erlauben. Wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist.

Kostenloser Versand

Free shipping: schaltet die Schwelle für kostenlosen Versand ein.

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

Zweite Option

Ein zweiter Andreani-Versanddienstleister mit eigenem Namen, eigener Liefermodalität und eigenem Vertrag, zum Beispiel "a domicilio" beim Hauptversanddienstleister und "retiro en sucursal" hier, um beides anzubieten. Alle anderen Einstellungen werden gemeinsam genutzt.

Enable second option: schaltet den zweiten Versanddienstleister ein oder aus. Es ist derselbe Schalter wie sein Status unter Shipping > Carriers. 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 (Lieferung an die Haustür, Abholung in der Filiale). Lassen Sie das Feld leer, um den globalen Vertrag zu verwenden.

Filialauswahl an der Kasse (angezeigt für 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 logs/vfd_andr_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Fehler werden immer protokolliert. Zugangsdaten und Tokens werden nie protokolliert.

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 eingeschaltet, löscht die Deinstallation des Moduls alle Moduleinstellungen und die Versanddienstleister. Ist sie ausgeschaltet, werden bei der Deinstallation nur die Versanddienstleister deaktiviert. Die in Bestellungen gespeicherten Filialdaten bleiben immer erhalten.

So funktioniert es an der Kasse

Im Lieferschritt fragt PrestaShop das Modul nach dem Preis jedes Andreani-Versanddienstleisters. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft die Länder (wenn Ignore shipping zones eingeschaltet ist), das Gewicht des Warenkorbs (Produktgewichte werden in kg umgerechnet, Produkte ohne Gewicht verwenden Default product weight (kg)) und die Minimum subtotal.

Im festen Modus wird der Preis aus Country prices übernommen. In den Live-Modi meldet sich das Modul bei der Andreani-API an und fordert ein Angebot an, mit der Postleitzahl des Ziels, dem Vertrag, dem Kundencode, dem Gewicht in kg, dem Volumen aus den Produktabmessungen und dem Warenwert (die Zwischensumme des Warenkorbs in ARS). Ein Live-Tarif wird nur für eine gültige argentinische Postleitzahl angefragt. 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 und dann in der Warenkorbwährung des Kunden angezeigt.

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

Ist Free shipping eingeschaltet und erreicht die Zwischensumme des Warenkorbs Free shipping from, beträgt der Preis 0. Kostenloser Versand gilt nur dort, wo der Versanddienstleister einen Preis hat: Liefert die Andreani-API keinen Tarif zurück und gibt es keinen festen Preis als Ersatz, wird der Versanddienstleister nicht angezeigt.

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

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

Abholpunkte

Wenn ein Versanddienstleister mit Door to branch oder Branch to branch ausgewählt ist, erscheinen im Lieferschritt darunter eine Provinzliste und eine Filialliste. 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 aufgelistet. 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 im Warenkorb gespeichert, sobald der Kunde sie trifft. Akzeptiert wird nur eine Filiale aus der aktuellen Andreani-Liste. Ohne Filiale funktionieren Continue im Lieferschritt und die Bestellschaltfläche im Zahlungsschritt nicht, und der Kunde sieht Please select an Andreani pickup branch. Der Server prüft die Filiale erneut, wenn der Kunde weitermacht. Ist die Filiale nicht mehr in der Liste, sieht der Kunde The selected Andreani branch is not available. Please choose another one.

Eine Filiale, die der Kunde unter Andreani gewählt hat, bevor er zu einem anderen Versanddienstleister wechselte, gehört nicht zur Bestellung.

Bestellungen

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

Admin order page: ein Block Andreani zeigt die Modalität und die Filiale (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. Nur Filialen aus der Andreani-Liste können gespeichert werden. Ist die Liste nicht verfügbar, lässt sich die Filiale nicht ändern.

Kunde: die Filiale wird als Andreani pickup branch: auf der Bestellbestätigung und auf der Bestelldetailseite angezeigt.

E-Mails: In der Bestellbestätigung und in der E-Mail über neue Bestellungen an den Shop (Modul Mail alerts) wird die Filiale dem Namen des Versanddienstleisters hinzugefügt. Die E-Mail an den Shop zeigt außerdem die ID der Filiale.

Bestehende Bestellungen behalten ihre Filialdaten.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Andreani ist der erste Block auf Modules > Module Manager > VibeFox Andreani > Configure, über den 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-andreani und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, 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. Nachdem sich die Adresse des Shops geändert hat oder nachdem Sie in Ihrem Konto einen Domainplatz 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 in einer Multistore-Installation. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel werden die Andreani-Versanddienstleister Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der Storefront von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher werden die Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der 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

Andreani erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist (beim zweiten Versanddienstleister außerdem Enable second option). Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes des Kunden und die Kundengruppe abdeckt, oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries. Prüfen Sie, ob Country prices eine Zeile für das Land hat (für feste Preise oder als Ersatz), und prüfen Sie die Gewichtsgrenzen und die Minimum subtotal. Lesen Sie die Warnungen oben auf der Seite Configure. Außerdem können Produkte auf der Produktseite auf bestimmte Versanddienstleister beschränkt sein.

Live-Tarife erscheinen nicht: Schalten Sie das Debug log ein, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an. Es zeigt den Grund: fehlende Zugangsdaten oder Vertragsnummer, eine fehlgeschlagene Anmeldung (falscher Benutzername, falsches Passwort oder falsche 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 der Standardwährung Ihres Shops.

Die Versandsteuer scheint falsch: Mit einer Steuerregel unter Tax status wird der Andreani-Tarif ohne IVA verwendet, und PrestaShop fügt seine eigene Steuer hinzu. Bei None wird der Tarif mit IVA verwendet und keine Steuer hinzugefügt. Prüfen Sie, ob Steuern aktiviert sind und die Steuerregel für Argentinien eingerichtet ist.

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: Klicken Sie auf der Modulseite auf Save. Dadurch werden das zwischengespeicherte Token, die Filialliste und die Tarife gelöscht.

Die Seite meldet, dass ein Andreani-Versanddienstleister nicht gefunden wurde: Der Versanddienstleister 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 Andreani und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Das zwischengespeicherte Token, die Filialliste und die Tarife werden ebenfalls immer entfernt. Ist Remove data on uninstall eingeschaltet, werden die Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Protokoll sowie die Filialauswahl von Warenkörben ohne Bestellung werden entfernt. Ist die Option ausgeschaltet, werden die Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Eine erneute Installation des Moduls oder ein Reset des Moduls gibt beiden Versanddienstleistern ihren früheren Status zurück. Filialdaten in Bestellungen werden nie gelöscht.

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