VibeFox Bob Go for PrestaShop — Guida
Requisiti
PrestaShop: da 8.0 a 9.x.
PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.
Account Bob Go (solo per le tariffe in tempo reale): Bob Go non usa chiavi API. Ti servono un account Bob Go (bobgo.co.za), il tuo negozio installato come canale di vendita WooCommerce nel tuo account Bob Go (Sales channels) e "Rates at checkout" attivo per quel canale. Servizi, prezzi e regole si configurano su Bob Go. Se usi solo i prezzi fissi, non ti serve un account Bob Go.
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 clicca su Upload a module. Scegli il file ZIP del modulo.
2. Al termine del caricamento, clicca su Configure, oppure trova più tardi VibeFox Bob Go nell'elenco dei moduli e clicca 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. Nel tuo account Bob Go, installa il tuo negozio come canale di vendita. Attiva "Rates at checkout" per quel canale e configura servizi e prezzi.
5. Nella pagina Configure controlla il dominio del negozio, l'indirizzo di origine (da cui spedisci) e, se la valuta del negozio non è ZAR, il tasso di conversione in ZAR (vedi Configurazione). Se gli indirizzi sudafricani del negozio non hanno una provincia, clicca su Add South African provinces. Clicca su Save.
All'installazione il modulo crea il corriere Bob Go con il testo dei tempi di consegna Courier delivery (South Africa). Il corriere è attivo, assegnato a tutte le zone e a tutti i gruppi di clienti, e usa per impostazione predefinita le tariffe Bob Go in tempo reale. Puoi modificare zone, gruppi di clienti, tempi di consegna, logo e limiti di dimensione in Shipping > Carriers. Non impostare prezzi lì: il prezzo arriva sempre dal modulo.
Configurazione
Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox Bob Go > Configure. Valgono per tutte le zone del corriere. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina. Ogni salvataggio cancella anche le tariffe Bob Go in cache. I numeri accettano il punto o la virgola come separatore decimale. Se un valore è errato, la pagina mostra un errore e non salva nulla: un valore che non è un numero ("…" must be a number.), un importo o un peso negativo ("…" must be a number of 0 or more.), un ZAR conversion rate pari o inferiore a 0, un Minimum weight superiore al Maximum weight, oppure un Method title di più di 64 caratteri.
Sopra il modulo, la pagina avvisa quando le tariffe in tempo reale non possono funzionare: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., quando gli indirizzi sudafricani non hanno una provincia (vedi Province sudafricane più sotto), o quando l'unità di peso o di dimensione del negozio non viene riconosciuta e viene trattata come kg o cm. Imposta le unità in International > Localization (Local units).
Generale
Enable Bob Go: attiva o disattiva il corriere. È lo stesso interruttore dello stato del corriere in Shipping > Carriers.
Method title: il nome del corriere mostrato al cliente. I servizi Bob Go, ad esempio "The Courier Guy - Economy", compaiono sotto di esso nel checkout con i nomi di Bob Go. Predefinito: Bob Go. Obbligatorio, massimo 64 caratteri.
Shipping cost: come viene calcolato il prezzo.
Il motivo dell'assenza di tariffe in tempo reale viene scritto nel log. Non viene mai mostrato al cliente.
Account Bob Go
Questa sezione spiega cosa ti serve su Bob Go e mostra l'ultima risposta di Bob Go per il dominio del tuo negozio: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401), oppure request failed con il codice di errore, oppure no connection.
Store domain: Bob Go identifica il tuo negozio tramite il dominio. Lascia vuoto il campo per usare il dominio del tuo negozio, mostrato come testo segnaposto. Inserisci un altro dominio solo se il tuo canale su Bob Go è installato con un altro indirizzo, ad esempio example.co.za/shop per un negozio in una sottocartella. Lo schema e la barra finale vengono rimossi.
ZAR conversion rate: Bob Go quota in rand sudafricani (ZAR). Se la valuta predefinita del tuo negozio non è ZAR, inserisci quanto vale 1 ZAR nella tua valuta, ad esempio 0.05. Le tariffe vengono convertite con questo valore e i prezzi dei prodotti vengono inviati a Bob Go in ZAR. Lascia vuoto per non usare le tariffe Bob Go in tempo reale nella tua valuta (i prezzi fissi continuano a funzionare). Il valore deve essere maggiore di 0. Se la valuta del negozio è ZAR, lascia vuoto il campo.
Delivery dates: mostra l'intervallo di date di consegna stimate da Bob Go accanto a ciascun servizio nel checkout. La stima viene sempre salvata con l'ordine e visualizzata nella pagina dell'ordine.
Spedizione da (indirizzo di origine)
L'indirizzo di origine viene inviato a Bob Go con ogni richiesta di tariffe. Se l'indirizzo del negozio in Shop Parameters > Contact > Stores si trova nello stesso paese, i campi vuoti vengono compilati da lì.
Origin country: il paese da cui spedisci. Predefinito: Sudafrica. Bob Go spedisce solo all'interno del Sudafrica.
Origin province: una provincia sudafricana, oppure Store province (if in South Africa).
Origin city / suburb: la città o il quartiere da cui spedisci, ad esempio Johannesburg.
Origin postal code: il codice postale da cui spedisci, ad esempio 2001.
Origin street address: l'indirizzo stradale da cui spedisci.
Province sudafricane: PrestaShop non ha province per il Sudafrica, quindi gli indirizzi dei clienti lì non hanno una provincia, mentre Bob Go ne richiede una. Clicca su Add South African provinces per aggiungere le 9 province (codici EC, FS, GP, KZN, LP, MP, NC, NW, WC) come stati del Sudafrica e mostrare il campo dello stato negli indirizzi sudafricani. Le province già presenti, per codice o per nome, non vengono aggiunte di nuovo. Non cambia nulla finché non clicchi il pulsante. Quando le province sono attive, il campo mostra South African addresses have a province con il loro numero.
Prezzi fissi (usati quando Shipping cost è impostato su Fixed prices (below), e come alternativa quando Bob Go non restituisce tariffe)
Price per country: una riga per paese: un codice paese di 2 lettere, un segno di uguale e il prezzo nella valuta predefinita del negozio, IVA esclusa, ad esempio ZA=99.99. Usa * per tutti gli altri paesi, ad esempio *=199.99 nella riga successiva. Le righe in un altro formato vengono rimosse al salvataggio, e la pagina le elenca in un avviso.
Flat price: il prezzo per i paesi senza una riga sopra. Lascia vuoto per nascondere il corriere per quei paesi.
Fixed price applies: Per order addebita il prezzo una volta. Per item (price × quantity) lo moltiplica per il numero di articoli nel carrello. Le tariffe Bob Go in tempo reale riguardano sempre l'intera spedizione.
Condizioni
Minimum weight: nasconde il corriere sotto questo peso del carrello, in kg. 0 significa nessun limite (predefinito).
Maximum weight: nasconde il corriere sopra questo peso del carrello, in kg. 0 significa nessun limite (predefinito). Se sono impostati entrambi i limiti, il minimo non può superare il massimo.
Minimum order amount: mostra il corriere solo quando il subtotale del carrello (prodotti che richiedono spedizione, dopo sconti, prima delle tasse) raggiunge almeno questo importo. Lascia vuoto per mostrarlo sempre.
Free shipping: attiva la spedizione gratuita quando si raggiunge l'importo d'ordine indicato sotto.
Free shipping from: il subtotale del carrello (dopo sconti, prima delle tasse) per la spedizione gratuita. Viene usato solo quando Free shipping è attivo. In tal caso Bob Go non viene interpellato.
Tax: la regola fiscale del corriere, oppure No tax (predefinito). Le tariffe Bob Go di solito includono già l'IVA. In questo caso lascia No tax per non far pagare l'imposta due volte.
Disponibilità senza zone di spedizione
Ignore shipping zones: se attivo, il corriere viene collegato a tutte le zone, comprese quelle create in seguito, e offerto per i paesi indicati sotto. Se disattivo, viene offerto solo nelle zone del corriere in Shipping > Carriers; le zone che aveva prima vengono ripristinate.
Countries: i paesi di destinazione per questa modalità. Lascia vuoto per consentire tutti i paesi verso cui spedisci. Viene usato solo quando Ignore shipping zones è attivo.
Avanzate
Debug log: registra i calcoli delle tariffe e le richieste a Bob Go in logs/vfd_bobg_debug.log.php nella cartella del modulo. Il file non può essere aperto dal web. Gli indirizzi dei clienti non vengono registrati. Gli errori di Bob Go vengono registrati anche quando è disattivato. Disattivalo quando hai finito.
Log: mostra le dimensioni e le ultime voci del log. Clicca su Clear log per svuotarlo.
Remove data on uninstall: se attivo, la disinstallazione del modulo elimina le impostazioni Bob Go, il corriere, le tariffe in cache e i log. Il servizio Bob Go salvato con gli ordini viene conservato. Se disattivo, tutto viene conservato per una reinstallazione.
Come funziona nel checkout
Nel passaggio di spedizione PrestaShop chiede al modulo il prezzo Bob Go. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nell'importo dell'ordine. Il modulo controlla prima il paese di destinazione (con Ignore shipping zones), il peso del carrello e il Minimum order amount. Se si applica la spedizione gratuita, il corriere viene mostrato come gratuito e non parte nessuna richiesta a Bob Go.
Nelle modalità in tempo reale il modulo invia a Bob Go il dominio del tuo negozio, gli indirizzi di origine e di consegna (con la provincia) e gli articoli del carrello, con i prezzi dei prodotti in ZAR. Le tariffe in tempo reale vengono richieste solo dopo che il cliente ha inserito una città o un codice postale. Le tariffe in ZAR vengono convertite con il ZAR conversion rate quando la valuta del negozio non è ZAR. Il prezzo viene calcolato nella valuta predefinita del negozio e poi mostrato nella valuta del carrello del cliente.
Sotto il corriere Bob Go il cliente vede Choose a delivery service: e un'opzione per ogni servizio Bob Go, con il nome, il prezzo e, se Delivery dates è attivo, le date di consegna stimate. Il primo servizio è selezionato per impostazione predefinita. Quando il cliente sceglie un altro servizio, la scelta viene salvata subito e si aggiornano il prezzo del corriere e il totale del carrello. Il corriere costa quanto costa il servizio scelto. Se un servizio non è più offerto per l'indirizzo, il cliente vede This service is not available for your address any more. Please choose another one. Se il salvataggio non riesce, il messaggio è The service could not be saved. Please try again. L'elenco dei servizi funziona con i temi Classic e Hummingbird.
Le tariffe vengono memorizzate nella cache per 1 ora per ogni richiesta completa, quindi lo stesso carrello non genera una nuova richiesta. Una richiesta non riuscita viene memorizzata nella cache per 5 minuti, e il timeout è di 12 secondi, così un'interruzione di Bob Go non rallenta ogni aggiornamento del checkout. Una richiesta non riuscita non interrompe mai il checkout: il corriere viene nascosto oppure, nella modalità di ripiego, si usa il prezzo fisso. Il motivo viene scritto nel log.
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 mostra solo le tariffe. Non crea spedizioni, lettere di vettura o etichette, non traccia i pacchi, non sincronizza gli ordini con Bob Go e non invia notifiche. Per l'evasione usa la dashboard di Bob Go. Non ha la scelta di punti di ritiro o armadietti automatici. Bob Go spedisce solo all'interno del Sudafrica.
Ordini
Quando l'ordine viene effettuato, il servizio Bob Go scelto, il suo codice e la stima di consegna vengono salvati con l'ordine. Le modifiche successive al carrello o ai prezzi Bob Go non li cambiano.
Nel back office, la pagina dell'ordine mostra un blocco Bob Go con Bob Go service (nome e codice) ed Estimated delivery. Il cliente vede Bob Go service ed Estimated delivery nella pagina dei dettagli dell'ordine nel suo account. Gli ordini con prezzo fisso o spedizione gratuita non hanno un servizio Bob Go.
Chiave di licenza
Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza License — VibeFox Bob Go è il primo blocco di Modules > Module Manager > VibeFox Bob Go > 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 di essi ci sono la riga Product: presta-shipping-bob-go e il link 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 o License expired on con una data. Dopo che l'indirizzo del negozio cambia, 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: quello 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 Bob Go non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. Il frontend di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il corriere è nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non testarlo al checkout. Un promemoria appare 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 il 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 a 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
Bob Go non compare nel checkout: verifica che la licenza sia attiva e che Enable Bob Go 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. Controlla i limiti di peso e il Minimum order amount. In modalità prezzi fissi, verifica che il paese, * o il Flat price abbiano un prezzo. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto.
Non compaiono tariffe Bob Go: apri la pagina del modulo. La sezione Account Bob Go mostra l'ultima risposta di Bob Go. "The WooCommerce channel is not installed on Bob Go" (HTTP 404) significa che il dominio del negozio non è un canale di vendita su Bob Go: controlla Store domain. "Rates at checkout is not enabled" (HTTP 401) significa che la funzione è disattivata per il canale. Assicurati anche che il cliente abbia inserito una città o un codice postale e, per i negozi non in ZAR, che il ZAR conversion rate sia impostato. Attiva il Debug log, ricarica il checkout e controlla il campo Log. Con Bob Go live rates, fixed prices if Bob Go returns no rates, i clienti ricevono comunque il prezzo fisso mentre risolvi il problema.
Il mio negozio non usa i rand: Bob Go quota in ZAR. Inserisci quanto vale 1 ZAR nella valuta del tuo negozio. Senza questo valore il modulo non chiede tariffe a Bob Go. I prezzi fissi continuano a funzionare.
La pagina avvisa che gli indirizzi sudafricani non hanno una provincia: clicca su Add South African provinces nella sezione Spedizione da (indirizzo di origine). Gli indirizzi dei clienti già esistenti ricevono una provincia solo quando vengono modificati.
L'imposta sulla spedizione viene addebitata due volte: le tariffe Bob Go di solito includono l'IVA. Imposta Tax su No tax.
Le tariffe sembrano obsolete dopo una modifica: clicca su Save nella pagina del modulo. Questo svuota la cache delle tariffe Bob Go. Le modifiche nel tuo account Bob Go vengono recepite alla scadenza della cache di 1 ora o al salvataggio delle impostazioni.
La pagina dice che il corriere Bob Go 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 Bob Go e scegli Uninstall. La chiave di licenza, lo stato della licenza e le tariffe in cache vengono sempre rimossi. Se Remove data on uninstall è attivo, il corriere viene eliminato (gli ordini conservano la cronologia) e vengono rimosse le impostazioni, il log e le scelte di servizio dei carrelli aperti. Se è disattivo, il corriere viene solo disattivato e tutte le impostazioni vengono conservate. Reinstallare il modulo, oppure Reset, ridà al corriere salvato lo stato che aveva prima: un corriere attivo torna attivo, uno disattivato resta disattivato. Il servizio Bob Go salvato con gli ordini viene sempre conservato.
Bob Go è un marchio del rispettivo proprietario. Questo modulo non è affiliato a Bob Go né approvato da Bob Go.