VibeFox Mondial Relay for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x. Il checkout funziona con i temi Classic e Hummingbird.

PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.

Account Mondial Relay: il codice Enseigne e la Private Key si ottengono con un account business Mondial Relay: vedi la sezione per professionisti di mondialrelay.fr, la tua area clienti "Connect" o il tuo referente commerciale. Per il selettore della mappa basta il codice Enseigne. L'elenco dei punti più vicini richiede entrambi. Per i test Mondial Relay fornisce il codice Enseigne BDTEST13 con la Private Key PrivateK.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

1. Nel back office vai su Modules > Module Manager e fai clic su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento, fai clic su Configure, oppure trova più tardi VibeFox Mondial Relay nell'elenco dei moduli e fai clic su Configure.

3. Inserisci la tua chiave di licenza VibeFox in License key nel blocco licenza in cima alla pagina Configure e fai clic su Activate (vedi Chiave di licenza).

4. Inserisci il tuo codice Enseigne e, per la modalità elenco, la Private Key. Compila Country prices e fai clic su Save.

All'installazione il modulo crea il corriere Mondial Relay Point Relais con il testo dei tempi di consegna Delivery to a Mondial Relay Point Relais of your choice. Il corriere viene assegnato a tutti i gruppi di clienti e alle zone di Francia, Belgio, Lussemburgo, Spagna, Portogallo e Paesi Bassi. Puoi modificare zone, gruppi di clienti, tempi di consegna, logo e limiti di dimensione in Shipping > Carriers. Non impostare lì i prezzi: il prezzo proviene sempre dal modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox Mondial Relay > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina. Ogni salvataggio cancella anche gli elenchi dei punti di ritiro in cache.

Gli avvisi in cima alla pagina segnalano i problemi che nascondono il corriere: codice Enseigne mancante, Private Key mancante in modalità elenco, nessun prezzo per Francia, Belgio o Spagna, oppure corriere eliminato. I valori che non possono essere salvati vengono segnalati dopo Save: un campo numerico con un valore che non è un numero (o è negativo) mantiene il valore precedente. Un nome più lungo di 64 caratteri, o un Min weight (kg) maggiore di Max weight (kg), viene rifiutato e non si salva nulla. Se l'unità di peso del negozio non è tra quelle note al modulo, un avviso indica che i pesi dei prodotti vengono considerati in kg.

Generale

Enable/Disable: attiva o disattiva Mondial Relay. È lo stesso interruttore dello stato del corriere in Shipping > Carriers.

Name: il nome del corriere mostrato ai clienti al checkout. Predefinito: Mondial Relay Point Relais. Obbligatorio, fino a 64 caratteri.

Tax status: None significa che i prezzi della tabella sono definitivi. L'opzione Taxable con il nome di una regola fiscale significa che PrestaShop aggiunge ai prezzi l'imposta di spedizione di quella regola.

Account Mondial Relay

Brand code (Enseigne): obbligatorio, fino a 8 lettere e cifre, ad esempio BDTEST13 per i test. Usato dalla mappa dei punti di ritiro e dal Web Service. Senza di esso i clienti non possono scegliere un Point Relais, quindi il corriere non viene mostrato al checkout.

Private Key: necessaria solo per il selettore List of nearest points. Dopo il salvataggio il campo resta vuoto e mostra Saved - leave empty to keep it. Inserisci un nuovo valore solo per modificarlo. Per eliminare la chiave salvata, spunta Remove the saved Private Key e fai clic su Save. Quando il codice Enseigne e la Private Key sono impostati, la connessione al Web Service di Mondial Relay viene testata ogni volta che salvi le impostazioni, e un messaggio indica se sono valide.

Selettore del punto di ritiro

Selector: il modo in cui il cliente sceglie un Point Relais.

Tariffe (nella valuta predefinita del negozio, tasse escluse)

Country prices: prezzo per paese di destinazione e peso del pacco. Fai clic su + Add country per aggiungere una riga e sull'icona del cestino per rimuoverne una. Scegli * Default come paese per tutti gli altri paesi. Ogni riga ha una colonna Price e colonne di peso: XS fino a 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg e XL oltre 5 kg. Una colonna di peso vuota o pari a 0 usa la colonna Price. Se anche Price è vuota, la consegna per quel peso è gratuita, quindi compila Price quando usi solo alcune colonne di peso. Decimali con punto o virgola (4.90 o 4,90). Le righe senza alcun prezzo vengono eliminate al salvataggio, e i valori che non sono numeri vengono segnalati e lasciati vuoti.

Fallback cost: usato per i paesi senza riga nella tabella. Lascialo vuoto per nascondere il corriere per quei paesi.

Calculation type: come viene calcolato il prezzo.

Free shipping from: il subtotale del carrello (dopo gli sconti, senza tasse) da cui la consegna è gratuita. Lascialo vuoto se non prevedi la spedizione gratuita.

Disponibilità

Min weight (kg): nasconde il corriere quando il carrello pesa meno. 0 significa nessun limite.

Max weight (kg): nasconde il corriere quando il carrello pesa di più. Mondial Relay accetta pacchi fino a 30 kg nei Points Relais. Predefinito: 30. 0 significa nessun limite. Un campo vuoto significa 30 kg. Non può essere inferiore a Min weight (kg).

Minimum subtotal: mostra il corriere solo quando il subtotale del carrello (prodotti che richiedono la spedizione, dopo gli sconti, senza tasse) raggiunge almeno questo importo. Lascialo vuoto per mostrarlo sempre.

Ignore shipping zones: offre il corriere per i paesi indicati sotto, oppure per tutti i paesi supportati se l'elenco è vuoto, anche dove le zone del corriere non li includono. Finché è attiva, il corriere viene collegato a ogni zona attiva, comprese quelle che creerai in seguito. Quando la disattivi, il corriere riprende le zone che aveva prima.

Countries (ignore zones): i paesi di destinazione per quella modalità. Questo campo viene usato solo quando Ignore shipping zones è attiva. L'elenco contiene solo i paesi con Points Relais.

Avanzate

Debug log: scrive i calcoli delle tariffe e le chiamate al Web Service in logs/vfd_mrel_debug.log.php, nella cartella del modulo. Il file non può essere aperto dal web. Gli errori vengono sempre registrati, anche con questa opzione disattivata. Le chiavi e i dati dei clienti non vengono mai registrati.

Log: mostra la dimensione e le ultime voci del registro. Fai clic su Clear log per svuotarlo.

Remove data on uninstall: se attiva, la disinstallazione del modulo elimina le impostazioni e il corriere. Se disattiva, la disinstallazione disattiva soltanto il corriere. I punti di ritiro salvati negli ordini vengono conservati.

Come funziona al checkout

Il corriere viene offerto solo per i paesi con Points Relais: Francia, Belgio, Lussemburgo, Spagna, Portogallo e Paesi Bassi. Viene nascosto quando i clienti non potrebbero scegliere un punto: senza codice Enseigne, oppure in modalità elenco senza Private Key.

Nel passaggio di spedizione PrestaShop chiede al modulo il prezzo. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel subtotale. Il modulo controlla il peso del carrello e il subtotale minimo. Il prezzo proviene dalla riga del paese (o dalla riga *): la colonna di peso, altrimenti Price. Senza riga si usa il costo di ripiego. Se non c'è un prezzo, il corriere viene nascosto. Se il subtotale raggiunge Free shipping from, il prezzo diventa 0. Il prezzo viene calcolato nella valuta predefinita del negozio e poi mostrato nella valuta del carrello del cliente.

Se modifichi il corriere in Shipping > Carriers dopo che ha ricevuto ordini, PrestaShop lo salva come nuova versione del corriere. Il modulo segue automaticamente la nuova versione.

Il modulo non richiede tariffe in tempo reale: Mondial Relay non dispone di un'API pubblica per le tariffe. Non crea spedizioni, non stampa etichette e non traccia i pacchi. Crea le spedizioni nel tuo spazio "Connect" di Mondial Relay usando il numero di Point Relais mostrato nell'ordine. La consegna a domicilio (Domicile) non viene offerta.

Punti di ritiro

Quando il cliente seleziona il corriere Mondial Relay nel passaggio di consegna, sotto di esso compare un riquadro Mondial Relay pickup point.

Modalità mappa: il pulsante Choose a Point Relais apre in una finestra la mappa ufficiale di Mondial Relay per il paese di consegna, il codice postale e il peso del pacco. Dopo che il cliente ha scelto un punto, questo viene mostrato come Selected: e il pulsante diventa Change Point Relais. Il widget della mappa viene caricato da widget.mondialrelay.com e la sua libreria di mappe da unpkg.com solo quando il cliente apre la mappa. Menzionalo nella tua informativa sulla privacy.

Modalità elenco: un menu a tendina - Choose a Point Relais - mostra i 10 punti più vicini al codice postale di consegna, con la distanza. Il punto scelto viene mostrato con i suoi orari di apertura. L'elenco viene caricato dal tuo server, quindi nessuno script di terze parti viene eseguito nel browser. Gli elenchi sono memorizzati nella cache per 12 ore, una risposta vuota per 1 ora, e una richiesta non riuscita viene ricordata per 5 minuti. Il timeout del Web Service è di 10 secondi. Senza codice postale il cliente vede Enter your postcode to see the nearest pickup points. Se non viene trovato alcun punto o l'elenco non è disponibile, il cliente vede un messaggio come "L'elenco dei punti di ritiro non è disponibile al momento. Usa la mappa." e gli viene offerta la mappa.

Il punto scelto viene salvato subito nel carrello. Il punto è obbligatorio. Senza punto il cliente vede Please choose a Mondial Relay pickup point. e non può proseguire al pagamento. Un punto in un paese diverso da quello dell'indirizzo di consegna viene rifiutato. In modalità elenco il punto viene inoltre verificato con l'elenco per l'indirizzo.

Quando l'ordine viene effettuato, il punto resta associato all'ordine. La pagina dell'ordine nel back office mostra il blocco Mondial Relay pickup point con nome del punto, indirizzo e Point Relais number (ad esempio FR-066974). Il cliente vede il punto nella pagina di conferma dell'ordine e nei dettagli dell'ordine nel suo account. Nell'e-mail di conferma dell'ordine e nell'e-mail di nuovo ordine del modulo Avvisi via e-mail, il punto viene aggiunto dopo il nome del corriere.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox acquistata su vibefox.net. Il blocco licenza License — VibeFox Mondial Relay è il primo blocco di Modules > Module Manager > VibeFox Mondial Relay > Configure, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopo di che il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto ci sono la riga Product: presta-shipping-mondialrelay e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con l'autorizzazione Configure per il modulo possono cambiare la chiave. I testi del blocco seguono la lingua del back office (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: il dominio del negozio principale, anche in una configurazione multistore. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, il corriere Mondial Relay non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. La vetrina di PrestaShop non sa che sei connesso al back office, quindi il corriere viene nascosto anche a te: puoi configurare il modulo prima di acquistare una chiave, ma non testarlo al checkout. Un promemoria compare in Modules > Module Manager nella scheda Alerts. Gli ordini esistenti non sono interessati.

Quando una licenza scade, il modulo continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. Disinstallare o ripristinare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Mondial Relay non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable sia attivo. In Shipping > Carriers verifica che il corriere copra la zona del paese del cliente e il suo gruppo di clienti, oppure attiva Ignore shipping zones. Controlla gli avvisi in cima alla pagina del modulo: il corriere viene nascosto senza codice Enseigne, in modalità elenco senza Private Key, per un paese senza prezzo, fuori dai limiti di peso e di subtotale, e per i paesi senza Points Relais. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto.

Test del Web Service fallito dopo il salvataggio: il messaggio mostra l'errore di Mondial Relay, ad esempio un codice Enseigne o una chiave di sicurezza non validi. Verifica il codice Enseigne e la Private Key con Mondial Relay.

L'elenco dei punti è vuoto o non disponibile: il cliente deve prima inserire un codice postale di consegna. Se il Web Service non funziona, al suo posto viene offerta la mappa. Attiva Debug log, ricarica il checkout e controlla il campo Log nella pagina del modulo per il motivo.

La mappa non si apre: la mappa viene caricata da widget.mondialrelay.com e unpkg.com. Verifica che un blocco di privacy o di script non le blocchi. Se la mappa non può essere caricata, il cliente vede "La mappa di Mondial Relay non può essere caricata. Riprova più tardi o scegli un altro metodo di spedizione."

La pagina dell'ordine indica No Point Relais was saved for this order: l'ordine è stato effettuato senza un punto del paese di consegna. Il motivo viene scritto nel registro. Chiedi al cliente il Point Relais prima di creare la spedizione.

La pagina indica che il corriere Mondial Relay non è stato trovato: il corriere è stato eliminato in Shipping > Carriers. Reimposta il modulo in Modules > Module Manager per ricrearlo.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox Mondial Relay e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi. Gli elenchi dei punti di ritiro in cache vengono sempre rimossi. Se Remove data on uninstall è attivo, il corriere viene eliminato (gli ordini conservano la cronologia), e vengono eliminati le impostazioni, il registro e i punti dei carrelli senza ordine. Se è disattivo, il corriere viene solo disattivato e tutte le impostazioni vengono conservate. Reinstallare il modulo ripristina lo stato del corriere di prima. I punti di ritiro salvati negli ordini vengono sempre conservati.

Mondial Relay è un marchio registrato del rispettivo titolare. Questo modulo non è affiliato a Mondial Relay né da essa approvato.