VibeFox Instabee for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

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

PHP: 8.0 o successivo.

Credenziali API Budbee (solo per la selezione del box): una chiave API e un segreto API. Instabee le rilascia ai commercianti con un accordo di consegna. Chiedi al tuo referente Instabee oppure usa il portale commercianti di Instabee. La documentazione API è su developer.budbee.com. Senza credenziali il metodo funziona comunque con prezzi fissi, ma i clienti non possono scegliere un box.

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. Puoi anche caricare la cartella vfd_instabee in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Instabee, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

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

5. Compila la sezione Prezzi e, per il selettore dei box, la tua API key e il tuo API secret Budbee (vedi Configurazione).

6. Aggiungi VibeFox Instabee alle zone di spedizione dei paesi di consegna (per esempio Svezia) in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones e scegli i paesi.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Instabee. Valgono per tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title: il nome di questa tariffa al checkout in questa zona. Lascialo vuoto per usare il Method name generale.

Gli avvisi sopra le impostazioni ti segnalano quando è compilata solo una delle credenziali API, quando non ce ne sono, quando non ci sono prezzi per paese né costo di riserva e quando l'ultima richiesta all'API Budbee non è riuscita (con data, ora e motivo). Ogni volta che salvi le impostazioni, gli elenchi dei box in cache e l'ultimo errore API vengono cancellati.

Generale

Enable/Disable: attiva o disattiva il metodo ovunque, comprese le zone di spedizione. Predefinito: attivo.

Method name: il nome del metodo di spedizione mostrato nel carrello e al checkout. Una zona può sostituirlo con il proprio Title. Predefinito: Instabee parcel box.

Tax status: Taxable aggiunge l'IVA di WooCommerce al costo di spedizione, None non la aggiunge.

Selettore del box (API Budbee)

Con le credenziali API il cliente sceglie al checkout un box vicino al proprio CAP, e il box viene salvato sull'ordine. Servono entrambi i campi. Il selettore resta disattivato finché non sono compilati entrambi.

API key: la tua chiave API Budbee (il nome utente di HTTP Basic).

API secret: il tuo segreto API Budbee (la password di HTTP Basic).

Test environment: usa l'API di staging di Budbee (api.staging.budbee.com). Attivalo solo con credenziali di staging di Instabee. I negozi in produzione lo lasciano disattivato (api.budbee.com). Predefinito: disattivato.

Prezzi (il titolo della sezione mostra la valuta del tuo negozio)

Tutti i prezzi sono nella valuta del negozio. Sono accettate sia la virgola sia il punto decimale (49,90 = 49.90). Un valore che non è un numero non viene salvato, e un messaggio di errore indica il campo.

Calculation type: come viene applicato il prezzo.

Country prices: una tabella con le colonne Country, Price, XS (fino a 1 kg), S (fino a 2 kg), M (fino a 3 kg), L (fino a 5 kg) e XL (oltre 5 kg). Fai clic su + Add country per aggiungere una riga e sulla croce per rimuoverne una. Scegli * Any other country per una riga che si applica a tutti i paesi senza una riga propria. Una fascia vuota o pari a 0 usa la colonna Price. Un Price pari a 0 significa consegna gratuita. Se la riga del paese non ha un prezzo per il peso del carrello, si usa la riga *, poi il Fallback cost. I pesi vengono convertiti dall'unità di peso del negozio in kg.

Fallback cost: usato quando né la riga del paese di destinazione né la riga * danno un prezzo. Lascialo vuoto per nascondere il metodo per quei paesi.

Condizioni

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

Max weight (kg): nasconde il metodo quando il carrello pesa di più. I box per pacchi reggono fino a circa 20 kg. Predefinito: 20. 0 significa nessun limite.

Minimum order amount: mostra il metodo solo quando il subtotale del carrello (dopo sconti, prima delle tasse) raggiunge questo importo. Lascia vuoto per mostrarlo sempre.

Free shipping from: il subtotale del carrello (dopo sconti, prima delle tasse) da cui il metodo è gratuito. Lascia vuoto per non renderlo mai gratuito.

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

Disponibilità senza zone di spedizione

Normalmente aggiungi VibeFox Instabee a una zona di spedizione. In alternativa puoi attivarlo qui per un elenco di paesi.

Ignore shipping zones: offre il metodo nei paesi indicati sotto, anche dove nessuna zona di spedizione lo contiene.

Countries: i paesi di destinazione per questa modalità. Lascia vuoto per usare tutti i paesi verso cui spedisci. Questo campo viene usato solo quando Ignore shipping zones è attivo.

Avanzate

Debug log: scrive i messaggi di debug in WooCommerce > Status > Logs (origine vfd-instabee). Gli errori API vengono sempre registrati, anche con questa opzione disattivata. Le chiavi API e i dati dei clienti non vengono mai registrati.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le impostazioni e le tariffe per zona di questo metodo. Disattivare il plugin non elimina mai le impostazioni. I box salvati sugli ordini vengono mantenuti.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin verifica le condizioni: peso del carrello, importo minimo dell'ordine e classi di spedizione escluse. Se il subtotale del carrello raggiunge Free shipping from, la tariffa è gratuita. Altrimenti il prezzo viene preso dalla riga Country prices del paese di destinazione, dalla riga * o dal Fallback cost. Se non c'è un prezzo, il metodo viene nascosto.

Quando il cliente seleziona la tariffa Instabee e le credenziali API sono impostate, sotto la tariffa compare un selettore Parcel box per Svezia, Finlandia, Danimarca, Paesi Bassi e Belgio. Mostra i box vicini al CAP dell'indirizzo di spedizione, ordinati per distanza, con nome, indirizzo e distanza. Il cliente può digitare un altro CAP e fare clic su Search. Finché non viene inserito un CAP, il selettore ne chiede uno. Se non viene trovato nessun box, al cliente viene chiesto di provare un altro CAP o di scegliere un altro metodo di spedizione.

Il box è obbligatorio. Quando l'ordine viene effettuato, il plugin verifica sul server che il box scelto sia nell'elenco Budbee per quel CAP. Altrimenti il cliente vede Please choose an Instabee parcel box. Il nome del box viene preso dall'elenco Budbee, non dal browser.

Il plugin invia a Budbee solo il paese di destinazione e il CAP, mai nomi, indirizzi, e-mail o dati dell'ordine. Gli elenchi dei box sono memorizzati nella cache per 12 ore per CAP, un CAP senza box per 1 ora e una richiesta non riuscita per 5 minuti, così un'API lenta o guasta non rallenta ogni aggiornamento del checkout. Il timeout dell'API è di 10 secondi.

Se l'API Budbee non è raggiungibile, al cliente viene comunicato che l'ordine può essere effettuato senza scegliere un box. L'ordine viene poi contrassegnato e sarai tu a scegliere il box quando prenoti la spedizione. Un box scelto in precedenza che non può essere verificato in quel momento viene conservato e contrassegnato come non verificato.

Il selettore funziona sul checkout classico e sui blocchi Carrello e Checkout. Il plugin è compatibile con l'archiviazione ad alte prestazioni degli ordini (HPOS) di WooCommerce.

Il plugin non calcola tariffe in tempo reale, non prenota spedizioni, non stampa etichette, non fornisce numeri o e-mail di tracciamento, non offre fasce orarie di consegna Budbee Home né mostra una mappa. Prenota il pacco per il box scelto negli strumenti commerciali di Instabee / Budbee.

Punti di ritiro

Il box scelto viene salvato sull'ordine e mostrato in questi punti:

Schermata ordine dell'amministrazione: sotto l'indirizzo di spedizione, come Instabee parcel box con il nome del box, l'indirizzo e il Box ID. Se il box non è stato verificato al checkout, viene contrassegnato come not verified (Budbee API was unavailable at checkout). Se non è stato scelto alcun box perché l'API non era disponibile, la schermata lo indica e ti ricorda di scegliere il box quando prenoti la spedizione.

Pagina di ringraziamento e pagina ordine di Il mio account: il nome e l'indirizzo del box.

E-mail dell'ordine: in HTML e testo semplice. Le e-mail al negozio mostrano anche l'ID del box. Se non è stato scelto alcun box perché l'API non era disponibile, lo segnalano solo le e-mail al negozio.

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 Instabee. 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 ricontrollare lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link 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 posto di dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Instabee non viene mostrato ai clienti al checkout. I gestori del negozio con l'accesso lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin 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 ricontrollato automaticamente in background.

Risoluzione dei problemi

Instabee non compare al checkout: verifica 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 consentito). Verifica che il paese abbia un prezzo, oppure che esista una riga * o un Fallback cost. Controlla i limiti di peso, Minimum order amount ed Excluded shipping classes. Un avviso sopra le impostazioni ti segnala quando non è configurato alcun prezzo.

I clienti non vedono l'elenco dei box: l'elenco compare solo quando sono impostati API key e API secret, per Svezia, Finlandia, Danimarca, Paesi Bassi e Belgio, e una volta inserito un CAP. L'ultimo errore API viene mostrato sopra le impostazioni. I dettagli sono in WooCommerce > Status > Logs (origine vfd-instabee). Attiva Debug log per maggiori dettagli.

HTTP 401 o 403 nel log: Budbee ha rifiutato la chiave o il segreto API. Controllali e verifica che Test environment corrisponda alle tue credenziali (credenziali di staging solo con l'ambiente di test attivo).

Nessun box per un CAP: Budbee non serve quel CAP. Il cliente può cercare un altro CAP o scegliere un altro metodo di spedizione.

Elenchi dei box vecchi dopo una modifica: salva la pagina delle impostazioni. Così vengono cancellati gli elenchi dei box in cache.

Altri paesi per la ricerca dei box: gli sviluppatori possono cambiare l'elenco dei paesi con il filtro vfd_ibee_box_countries.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera un posto 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

Disattivare il plugin cancella solo gli elenchi dei box in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave e lo stato della licenza di questo plugin, gli elenchi dei box in cache e l'ultimo errore API vengono sempre rimossi. Impostazioni, metodi delle zone e dati di versione vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. I box salvati sugli ordini vengono sempre mantenuti e gli ordini esistenti conservano le proprie righe di spedizione.

Instabee e Budbee sono marchi dei rispettivi titolari. Questo plugin non è affiliato né approvato da Instabee o Budbee.