VibeFox Bob Go for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

WooCommerce: 5.0 o successivo, installato e attivo. Il plugin non si attiva senza di esso.

PHP: 8.0 o successivo.

Account Bob Go (solo per le tariffe in tempo reale): Bob Go non ha chiavi API. Ti servono un account Bob Go (bobgo.co.za), il tuo negozio WooCommerce installato come canale di vendita nel tuo account Bob Go (Sales channels) e "Rates at checkout" attivo per quel canale, con i tuoi servizi e prezzi impostati lì. Se usi solo 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. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. In alternativa puoi caricare la cartella vfd_bob_go in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Nel tuo account Bob Go, installa il tuo negozio WooCommerce come canale di vendita. Attiva "Rates at checkout" per quel canale e imposta i tuoi servizi e prezzi.

4. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Bob Go, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.

5. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

6. Controlla il dominio del negozio, l'indirizzo di partenza (ship from) e, se la valuta del negozio non è ZAR, il tasso di conversione in ZAR (vedi Configurazione).

7. Aggiungi VibeFox Bob Go a una zona di spedizione per il Sudafrica in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Bob Go. Si applicano a tutte le zone di spedizione. Ogni volta che salvi le impostazioni, le tariffe Bob Go in cache vengono cancellate. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title (zone): il nome mostrato per i prezzi fissi e la spedizione gratuita in questa zona. Lascialo vuoto per usare il Method title globale. Le tariffe Bob Go in tempo reale vengono sempre mostrate con i nomi dei servizi configurati su Bob Go.

Generale

Enable/Disable: attiva o disattiva il metodo in tutte le zone contemporaneamente.

Method title: mostrato al cliente per i prezzi fissi e la spedizione gratuita. Una zona può sostituirlo. Le tariffe Bob Go in tempo reale vengono mostrate con i nomi dei servizi di Bob Go, per esempio "The Courier Guy - Economy". Predefinito: Bob Go.

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 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 un altro errore. Se la valuta del negozio non è ZAR e non è impostato alcun tasso di conversione, avvisa anche che le tariffe in tempo reale non vengono richieste.

Store domain: Bob Go identifica il tuo negozio tramite il dominio. Lascialo vuoto per usare il dominio del tuo sito. Inserisci un altro dominio solo se il tuo canale su Bob Go è installato con un indirizzo diverso, per esempio example.co.za/shop per un negozio in una sottocartella.

ZAR conversion rate: Bob Go quota in rand sudafricani (ZAR). Se la valuta del negozio non è ZAR, inserisci quanto vale 1 ZAR nella valuta del negozio, per esempio 0.05 per EUR. Con questo valore le tariffe vengono convertite e i prezzi dei prodotti vengono inviati a Bob Go in ZAR. Lascialo vuoto per non usare le tariffe Bob Go in tempo reale nella tua valuta (i prezzi fissi continuano a funzionare). Se la valuta del negozio è ZAR, lascialo vuoto. Sono accettati sia il punto sia la virgola come separatore decimale.

Delivery dates: mostra nel nome della tariffa l'intervallo di date di consegna stimato da Bob Go. La stima viene sempre salvata con l'ordine ed è visibile nella schermata dell'ordine.

Spedizione da (indirizzo di partenza)

L'indirizzo di partenza viene inviato a Bob Go con ogni richiesta di tariffe. Se l'indirizzo del tuo negozio in WooCommerce > Settings > General 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, per esempio Johannesburg.

Origin postal code: il codice postale da cui spedisci, per esempio 2001.

Origin street address: l'indirizzo stradale da cui spedisci.

Prezzi fissi (usati nella modalità fissa 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 del negozio, per esempio ZA=99.99. Usa * per tutti gli altri paesi, per esempio *=199.99. Le righe in un altro formato vengono rimosse al salvataggio.

Flat price: il prezzo nella valuta del negozio per i paesi senza una riga sopra. Lascialo vuoto per nascondere il metodo per quei paesi.

Fixed price applies: Per order addebita il prezzo una sola volta. Per item (price × quantity) lo moltiplica per il numero di articoli nel carrello. Le tariffe Bob Go in tempo reale sono sempre per l'intera spedizione.

Condizioni

Minimum weight (kg): nasconde il metodo sotto questo peso del carrello. 0 significa nessun limite.

Maximum weight (kg): nasconde il metodo sopra questo peso del carrello. 0 significa nessun limite (predefinito).

Minimum order amount: mostra il metodo solo quando il subtotale del carrello (dopo sconti, prima delle imposte) è almeno questo importo. Lascialo vuoto per mostrarlo sempre.

Excluded shipping classes: nasconde il metodo se il carrello contiene un prodotto appartenente a una di queste classi di spedizione di WooCommerce.

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 imposte) per la spedizione gratuita. Usato solo quando Free shipping è attivo. In questo caso Bob Go non viene interpellato.

Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non la aggiunge. Le tariffe Bob Go di solito includono già l'IVA. In questo caso scegli None per non far pagare l'imposta due volte.

Disponibilità senza zone di spedizione

Ignore shipping zones: offre Bob Go per i paesi indicati sotto, anche se non è aggiunto a una zona di spedizione.

Countries: i paesi di destinazione per questa modalità. Lascialo vuoto per usare tutti i paesi in cui spedisci. Usato solo quando Ignore shipping zones è attivo.

Avanzate

Debug log: registra i calcoli delle tariffe e le richieste a Bob Go in WooCommerce > Status > Logs, origine "vfd_bob_go". Gli indirizzi dei clienti non vengono registrati. Gli errori dell'API vengono registrati anche quando questa opzione è disattivata.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse tutte le impostazioni Bob Go, i metodi di zona e le tariffe in cache. La disattivazione del plugin non elimina mai nulla.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, il plugin controlla il peso del carrello, Minimum order amount ed Excluded shipping classes. Se si applica la spedizione gratuita, il cliente vede il metodo come Bob Go (free) e nessuna richiesta viene inviata a Bob Go.

Nelle modalità in tempo reale il plugin invia a Bob Go il dominio del tuo negozio, gli indirizzi di partenza e di consegna 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. Ogni servizio restituito da Bob Go viene mostrato come un'opzione di spedizione separata con il nome Bob Go e, se Delivery dates è attivo, con le date di consegna stimate. Le tariffe in ZAR vengono convertite con il ZAR conversion rate quando la valuta del negozio non è ZAR.

Le tariffe vengono memorizzate nella cache per 1 ora per carrello e indirizzo, quindi lo stesso carrello non genera una nuova richiesta. Una richiesta non riuscita viene memorizzata 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 metodo viene nascosto oppure, nella modalità con alternativa, viene usato il prezzo fisso. Il motivo viene scritto nel log di WooCommerce.

Il codice del servizio Bob Go scelto e la stima di consegna vengono salvati con la riga di spedizione dell'ordine e mostrati nella schermata dell'ordine come Bob Go service ed Estimated delivery.

Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin mostra solo tariffe. Non crea spedizioni, lettere di vettura o etichette, non traccia i pacchi, non sincronizza gli ordini con Bob Go e non invia notifiche via e-mail. Per l'evasione usa la dashboard di Bob Go (o la sincronizzazione degli ordini propria di Bob Go). Non offre la scelta di punti di ritiro o armadietti automatici (Bob Box, Pargo) né un campo aggiuntivo per il quartiere al checkout. Bob Go spedisce solo all'interno del Sudafrica.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Shipping > VibeFox Bob Go. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino alla quale la licenza è attiva e il tuo dominio. Usa Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il collegamento Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un solo dominio. Rimuovere la chiave da un sito non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Bob Go non viene mostrato ai clienti al checkout. I gestori del negozio collegati lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene controllato di nuovo automaticamente in background.

Risoluzione dei problemi

Bob Go non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo e che il metodo sia aggiunto alla zona del paese del cliente (oppure che Ignore shipping zones sia attivo e il paese sia consentito). Controlla i limiti di peso, Minimum order amount ed Excluded shipping classes. In modalità fissa, verifica che il paese, * o Flat price abbiano un prezzo.

Non vengono mostrate tariffe Bob Go: apri le impostazioni del plugin. La sezione Bob Go account mostra l'ultima risposta di Bob Go. "Channel is not installed" (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 ZAR conversion rate sia impostato. Attiva Debug log e apri WooCommerce > Status > Logs (origine "vfd_bob_go") per i dettagli. 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 il rand: Bob Go quota in ZAR. Inserisci quanto vale 1 ZAR nella valuta del negozio (per esempio 0.05 per EUR). Senza questo dato il plugin non richiede tariffe a Bob Go. I prezzi fissi continuano a funzionare.

L'imposta sulla spedizione viene addebitata due volte: le tariffe Bob Go di solito includono già l'IVA. Imposta Tax status su None.

Le tariffe sembrano obsolete dopo una modifica: salva la pagina delle impostazioni. Questo cancella le tariffe Bob Go in cache. Le modifiche nel tuo account Bob Go vengono recepite alla scadenza della cache di 1 ora o al salvataggio delle impostazioni.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera uno slot nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

La disattivazione del plugin conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Impostazioni, metodi di zona e tariffe in cache vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano disponibili per una reinstallazione successiva. Gli ordini esistenti mantengono le loro righe di spedizione.

Bob Go è un marchio del suo rispettivo titolare. Questo plugin non è affiliato a Bob Go né approvato da Bob Go.