VibeFox GLS ParcelShop for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x. La selezione del ParcelShop funziona nei temi Classic e Hummingbird.

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

GLS: il modulo non usa né richiede un account GLS o una chiave API. La mappa dei ParcelShop è pubblica. Per spedire i pacchi ai ParcelShop scelti serve un contratto con GLS.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un 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 GLS ParcelShop nell'elenco dei moduli e fai clic su Configure.

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

4. Imposta i prezzi: almeno una riga di Country prices (per esempio * Default) oppure un Fallback cost (vedi Configurazione), poi fai clic su Save.

All'installazione il modulo crea il corriere GLS ParcelShop con il testo dei tempi di consegna Delivery to a GLS ParcelShop of your choice. Il corriere viene assegnato a tutti i gruppi di clienti e alle zone dei paesi della mappa GLS (in un negozio standard di solito Europe ed Europe (non-EU)). Puoi modificare zone, gruppi di clienti, testo dei tempi di consegna e logo 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 GLS ParcelShop > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina.

Gli avvisi in cima alla pagina segnalano problemi di configurazione: il corriere non è stato trovato, l'unità di peso del negozio non è riconosciuta dal modulo (imposta kg, g, lb o oz in International > Localization, Local units), non è impostato alcun prezzo, oppure alcuni o tutti i Countries (ignore zones mode) selezionati non sono coperti dalla mappa GLS. Un numero non valido o negativo viene rifiutato con un messaggio che indica il campo, e viene mantenuto il valore precedente. Gli altri campi vengono comunque salvati.

General

La sezione elenca i paesi coperti dalla mappa GLS. Il corriere non viene offerto per gli altri paesi di destinazione.

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

Name: il nome del metodo di spedizione mostrato al cliente (il nome del corriere). Predefinito: GLS ParcelShop. Obbligatorio, massimo 64 caratteri.

Tax status: la regola fiscale del corriere. None significa che la spedizione non è tassata. Scegli una regola fiscale per rendere la spedizione imponibile.

Prices

I prezzi si inseriscono nella valuta predefinita del negozio, al netto delle imposte. I decimali possono usare la virgola o il punto (4,99 oppure 4.99). Il prezzo viene mostrato al cliente nella valuta del carrello.

Calculation type: come viene applicato il prezzo.

Country prices: una tabella con una riga per ogni paese di destinazione. Fai clic su Add country per aggiungere una riga e sull'icona del cestino per rimuoverne una. Ogni riga ha un Country, un Price e cinque 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. Viene usata la colonna corrispondente al peso del carrello. Una colonna di peso lasciata a 0 usa la colonna Price. La riga * Default viene usata per i paesi che non hanno una riga propria. Le nuove righe partono con * Default e 0 in ogni colonna, e una riga con tutti i prezzi a 0 dà la consegna gratuita: quindi scegli il paese e inserisci i prezzi prima di salvare. Se un valore della tabella non è un numero valido, l'intera tabella non viene salvata e il messaggio elenca i valori errati.

Fallback cost: il prezzo usato quando la tabella non ha una riga per il paese di destinazione e non c'è una riga * Default. Lascialo vuoto per nascondere il corriere per questi paesi.

Free shipping from: il subtotale del carrello (dopo gli sconti, al netto delle imposte) a partire dal quale la consegna con GLS ParcelShop è gratuita. Lascialo vuoto se la consegna non è mai gratuita.

Availability

Minimum weight (kg): nasconde il corriere quando il carrello pesa meno. Il peso viene convertito dall'unità di peso del tuo negozio. Vuoto o 0 significa nessun limite.

Maximum weight (kg): nasconde il corriere quando il carrello pesa di più. Predefinito: 20. I GLS ParcelShop di solito accettano pacchi fino a 20 kg, quindi verifica il tuo contratto con GLS. Vuoto o 0 significa nessun limite. Se il minimo è maggiore del massimo, entrambi i pesi vengono rifiutati con un messaggio e vengono mantenuti i valori precedenti.

Minimum cart subtotal: offre il corriere solo quando il subtotale del carrello (dopo gli sconti, al netto delle imposte) raggiunge questo importo. Lascialo vuoto se non c'è un minimo.

Ignore shipping zones: se attivo, il corriere viene collegato a tutte le zone, comprese quelle disattivate, e viene offerto per i paesi selezionati qui sotto, anche se non fanno parte delle sue zone. Anche le zone create in seguito vengono collegate. Quando lo disattivi, il corriere riottiene le zone che aveva prima e viene offerto solo in quelle. Predefinito: disattivato.

Countries (ignore zones mode): i paesi di destinazione per questa modalità. Lascialo vuoto per usare tutti i paesi della mappa GLS. I paesi non coperti dalla mappa GLS vengono saltati. Questo campo viene usato solo quando Ignore shipping zones è attivo.

Advanced

Debug log: scrive i calcoli delle tariffe e le scelte dei ParcelShop in logs/vfd_glps_debug.log.php, nella cartella del modulo. Il file non può essere aperto dal web. Gli errori vengono sempre registrati. Nel registro non vengono salvati dati personali dei clienti. Disattiva il registro quando hai finito.

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

Remove data on uninstall: se attivo, la disinstallazione del modulo elimina le impostazioni, il corriere e il registro. Se disattivo, tutto viene conservato per una nuova installazione. Il ParcelShop salvato negli ordini viene sempre conservato.

Come funziona al checkout

Quando PrestaShop mostra il passaggio della consegna, chiede al modulo il prezzo di GLS ParcelShop. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel subtotale del carrello. Il modulo verifica prima le condizioni: il paese di consegna è coperto dalla mappa GLS (ed è selezionato in Countries (ignore zones mode) quando quella modalità è attiva), il peso del carrello e il subtotale minimo del carrello. Se il subtotale del carrello raggiunge Free shipping from, la consegna è gratuita. Altrimenti il prezzo viene preso dalla riga del paese (o dalla riga * Default) e dalla colonna di peso, oppure da Fallback cost. Se non viene trovato alcun prezzo, il corriere viene nascosto.

Quando il cliente seleziona GLS ParcelShop, sotto il corriere compare un riquadro GLS ParcelShop con il pulsante Select GLS ParcelShop. Il pulsante apre la mappa ufficiale dei GLS ParcelShop per il paese di consegna. Dopo aver scelto un ParcelShop, vengono mostrati il suo nome e il suo indirizzo, e il pulsante diventa Change ParcelShop. La scelta viene salvata nel carrello, quindi resta disponibile quando il passaggio della consegna si aggiorna o la pagina viene ricaricata. Se l'indirizzo di consegna passa a un altro paese, il cliente deve scegliere di nuovo un ParcelShop.

Quando il cliente fa clic su Continue nel passaggio della consegna, il modulo verifica che sia stato scelto un ParcelShop e che si trovi nel paese di consegna. In caso contrario, il cliente vede Please select a GLS ParcelShop. oppure The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. e resta nel passaggio della consegna. Se il ParcelShop non può essere salvato, il cliente vede The ParcelShop could not be saved. Please try again. Se lo script della mappa GLS non può essere caricato, il cliente vede un messaggio che lo invita a ricaricare la pagina o a scegliere un altro metodo di spedizione.

La mappa GLS viene eseguita nel browser del cliente. Al checkout il modulo carica lo script della mappa da map.gls-croatia.com, e la mappa carica i dati dei ParcelShop e i riquadri della mappa da GLS. GLS riceve i normali dati della richiesta del visitatore (indirizzo IP, browser). Dal tuo server non viene inviato nulla a GLS.

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

Il modulo non riceve tariffe GLS in tempo reale, non crea spedizioni GLS, non stampa etichette e non traccia i pacchi. Non ha un elenco dei ParcelShop sul tuo server, quindi non può verificare l'ID del ParcelShop presso GLS. Consegna a GLS l'ID del ParcelShop dell'ordine nel modo che usi di solito (MyGLS, il tuo software GLS o un altro modulo).

Punti di ritiro

Quando l'ordine viene effettuato, il ParcelShop del carrello viene salvato con l'ordine: il suo ID, il suo nome con l'indirizzo e il suo paese. Non cambia più con il carrello.

Pagina dell'ordine nel back office: un blocco GLS ParcelShop mostra il nome e l'indirizzo del ParcelShop, con il ParcelShop ID e il paese. Se un ordine GLS ParcelShop non ha un ParcelShop, il blocco mostra No ParcelShop was selected for this order.

Pagine del cliente: il ParcelShop viene mostrato nella pagina di conferma dell'ordine e nella pagina dei dettagli dell'ordine nell'account del cliente.

E-mail: il ParcelShop viene aggiunto al nome del corriere nell'e-mail di conferma dell'ordine inviata al cliente. L'e-mail di nuovo ordine per il commerciante (modulo Mail alerts) include anch'essa l'ID del ParcelShop.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco di licenza License — VibeFox GLS ParcelShop è il primo blocco di Modules > Module Manager > VibeFox GLS ParcelShop > Configure, sopra le impostazioni. Inserisci la chiave in License key e fai clic su Activate. Dopodiché 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 compaiono la riga Product: presta-shipping-gls-parcelshop e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con il permesso 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 oppure 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 GLS ParcelShop non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. La vetrina di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il corriere viene nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non puoi provarlo al checkout. Nella pagina Modules > Module Manager, nella scheda Alerts, compare un promemoria. 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 controllato di nuovo 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 reimpostare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

GLS ParcelShop 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 gruppo del cliente (oppure attiva Ignore shipping zones e controlla Countries (ignore zones mode)). Verifica che il paese di destinazione sia uno dei paesi della mappa GLS e che abbia un prezzo (una riga di paese, la riga * Default o Fallback cost). Controlla i limiti di peso e il Minimum cart subtotal. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto. Attiva il Debug log e controlla il campo Log per vedere il motivo.

La mappa non si apre: il cliente vede "The GLS ParcelShop map could not be loaded..." quando lo script GLS viene bloccato, per esempio da un blocco pubblicità o privacy, da una politica di sicurezza dei contenuti (CSP) oppure da un'interruzione di GLS. Consenti map.gls-croatia.com nella tua politica di sicurezza dei contenuti.

La consegna è gratuita per un paese per errore: controlla la riga di quel paese in Country prices. Una riga in cui il Price e tutte le colonne di peso sono 0 dà la consegna gratuita.

La tabella o un campo non sono stati salvati: un valore non è un numero valido. Il messaggio in cima alla pagina indica il valore. Usa cifre con la virgola o il punto come separatore decimale.

La pagina indica che il corriere GLS ParcelShop non è stato trovato: il corriere è stato eliminato in Shipping > Carriers. Reimposta il modulo in Modules > Module Manager per ricrearlo. Reset mantiene lo stato di un corriere esistente: un corriere disattivato resta disattivato.

Un ordine non ha un ParcelShop e il registro indica che il ParcelShop del carrello è già salvato in un altro ordine: un carrello è diventato due ordini. Il primo ordine mantiene il ParcelShop. Consegna a GLS a mano il secondo ordine.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox GLS ParcelShop e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi.Se Remove data on uninstall è attivo, il corriere viene eliminato (gli ordini conservano lo storico), e vengono rimossi le impostazioni, il registro e i ParcelShop dei carrelli senza ordine. Se è disattivo, il corriere viene solo disattivato e tutte le impostazioni vengono conservate. Reinstallando il modulo, il corriere salvato riprende il suo stato precedente. Il ParcelShop salvato negli ordini viene sempre conservato.

GLS è un marchio del rispettivo proprietario. Questo modulo non è affiliato a GLS né approvato da GLS.