VibeFox Estafeta 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.

Account DrEnvio (solo per le tariffe in tempo reale): le tariffe Estafeta in tempo reale provengono da DrEnvio, partner di Estafeta in Messico. Crea un account su drenvio.com, attiva Estafeta, imposta lì il tuo indirizzo di ritiro e copia la chiave API dal pannello DrEnvio. È la stessa chiave usata dal plugin ufficiale DrEnvio. Se usi solo i tuoi prezzi, non ti serve un account DrEnvio.

Prodotti: i prodotti devono avere un peso per le tariffe in tempo reale.

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_estafeta in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

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

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

5. Inserisci la chiave API DrEnvio e, facoltativamente, il CAP di origine. Se la valuta del tuo negozio non è MXN, inserisci il MXN exchange rate. Imposta un prezzo per paese per MX o un costo di riserva se il metodo deve restare visibile quando DrEnvio non ha una tariffa.

6. Aggiungi VibeFox Estafeta alla tua zona Messico 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 Estafeta. Si applicano a tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title (zone): il nome di questa opzione al checkout. Lascialo vuoto per usare il Name globale.

In cima alla pagina il plugin mostra degli avvisi: manca la chiave API DrEnvio, la valuta del negozio non è MXN senza un tasso di cambio, oppure non c'è un prezzo per paese per MX né un costo di riserva (in tal caso il metodo viene nascosto se non c'è una tariffa in tempo reale). Ogni volta che salvi le impostazioni, le tariffe DrEnvio in cache vengono cancellate. I campi numerici accettano il punto o la virgola decimale. Un valore che non è un numero valido viene cancellato e segnalato al salvataggio.

Generale

Enable/Disable: attiva o disattiva la spedizione Estafeta in tutte le zone contemporaneamente. Predefinito: attivo.

Name: il nome del metodo di spedizione mostrato al cliente al checkout. Predefinito: Estafeta.

Tax status: Taxable permette a WooCommerce di aggiungere le imposte al costo di spedizione, None non lo fa. Se i prezzi DrEnvio includano l'IVA dipende dal tuo account DrEnvio. Se includono già l'IVA, scegli None. Predefinito: Taxable.

Tariffe in tempo reale (API DrEnvio)

Viene offerto il servizio Estafeta più economico per l'indirizzo. Senza chiave si usano i prezzi della sezione successiva.

DrEnvio API key: la chiave API del tuo pannello DrEnvio.

Origin country: il codice paese a due lettere dell'indirizzo di ritiro. Predefinito: MX. Viene inviato solo insieme al CAP di origine.

Origin postcode: il CAP a 5 cifre dell'indirizzo di ritiro. Lascialo vuoto per usare l'indirizzo di origine salvato nel tuo account DrEnvio. Un CAP che non ha 5 cifre viene cancellato al salvataggio.

MXN exchange rate: DrEnvio fornisce preventivi in pesos messicani. Serve solo se la valuta del tuo negozio non è MXN: il valore di 1 MXN nella valuta del tuo negozio, per esempio 0.05. Senza di esso le tariffe in tempo reale non vengono usate.

Prezzi senza tariffa in tempo reale

Usati quando non c'è una chiave API o DrEnvio non restituisce una tariffa Estafeta (API non disponibile, CAP sconosciuto, CAP non ancora inserito). I prezzi sono nella valuta del tuo negozio.

Country prices: un paese di destinazione per riga, nel formato CC:PRICE, per esempio MX:150. Usa il punto o la virgola decimale, senza separatore delle migliaia. Le parti in un altro formato vengono ignorate e segnalate al salvataggio.

Fallback cost: il prezzo quando non ci sono né una tariffa in tempo reale né un prezzo per paese. Lascialo vuoto per nascondere il metodo; 0 significa spedizione gratuita.

Calculation type: Per order addebita il prezzo una sola volta. Per item (price x number of items) lo moltiplica per il numero di articoli spedibili. Questo vale per Country prices e Fallback cost. Una tariffa DrEnvio in tempo reale è sempre il prezzo dell'intero pacco.

Condizioni

Free shipping from: la spedizione è gratuita quando il subtotale del carrello raggiunge questo importo. In tal caso non viene inviata alcuna richiesta a DrEnvio. Lascialo vuoto per non offrire mai la spedizione gratuita.

Minimum subtotal: mostra il metodo solo quando il subtotale del carrello è almeno pari a questo importo. Lascialo vuoto per mostrarlo sempre.

Min weight (kg): il peso minimo del carrello perché il metodo compaia. 0 significa nessun limite.

Max weight (kg): il peso massimo del carrello. Il metodo viene nascosto se viene superato. Predefinito: 30. 0 significa nessun limite.

Excluded shipping classes: se un articolo del carrello appartiene a una di queste classi di spedizione di WooCommerce, il metodo viene nascosto.

I pesi dei prodotti vengono convertiti dall'unità del tuo negozio in kg.

Disponibilità senza zone di spedizione

Ignore shipping zones: offri il metodo per i paesi indicati sotto, anche senza averlo aggiunto a una zona di spedizione.

Countries: i paesi di destinazione per questa modalità. Lascialo vuoto per tutti i paesi. Viene usato solo quando Ignore shipping zones è attivo.

Avanzate

Debug log: registra le richieste API e il calcolo delle tariffe in WooCommerce > Status > Logs, origine vfd-estafeta. Gli errori dell'API vengono sempre registrati. La chiave API e gli indirizzi dei clienti non vengono mai registrati.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse tutte le sue impostazioni e i metodi di zona. Disattivare il plugin non elimina mai nulla.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin controlla prima il peso del carrello, il subtotale minimo e le classi di spedizione escluse. Se si applica la spedizione gratuita, il metodo viene mostrato con prezzo zero e non viene inviata alcuna richiesta a DrEnvio.

Altrimenti il plugin invia a DrEnvio il paese e il CAP di destinazione, il peso del carrello, il numero di articoli e il subtotale, oltre al CAP di origine se ne hai impostato uno. I CAP messicani devono avere 5 cifre; finché il cliente non ne inserisce uno, non viene fatta alcuna richiesta. DrEnvio restituisce i preventivi di tutti i corrieri del tuo account. Il plugin usa solo i preventivi Estafeta, ignora i prezzi a zero, sceglie il più economico e lo converte nella valuta del tuo negozio. Il servizio Estafeta e il tempo di consegna vengono salvati con la riga di spedizione dell'ordine e mostrati nella schermata dell'ordine nell'area di amministrazione.

Ogni risposta viene memorizzata nella cache per 1 ora. Una richiesta non riuscita o un percorso senza tariffa Estafeta viene ricordato per 5 minuti, così un'API lenta o guasta non blocca mai ogni aggiornamento del checkout. Il timeout dell'API è di 12 secondi. In questi casi il cliente non vede alcun errore: viene usato il prezzo per paese o il costo di riserva, oppure il metodo viene nascosto se non è impostato nessuno dei due.

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

Il plugin calcola solo le tariffe. Non crea spedizioni, non stampa etichette (guías) e non traccia i pacchi; crea la spedizione nel tuo account DrEnvio o Estafeta. Il cliente non può scegliere un servizio Estafeta specifico né un ufficio Estafeta, e i tassi di cambio non vengono aggiornati automaticamente.

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 Estafeta. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino a cui 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 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 per il dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Estafeta non viene mostrato ai clienti al checkout. Gli amministratori del negozio che hanno effettuato l'accesso lo vedono ancora, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e testare 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 per gli aggiornamenti e il supporto serve il rinnovo. Lo stato viene ricontrollato automaticamente in background.

Risoluzione dei problemi

Estafeta 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 gli avvisi in cima alla pagina delle impostazioni, i limiti di peso, Minimum subtotal ed Excluded shipping classes. Senza una chiave API, oppure quando DrEnvio non ha una tariffa Estafeta, il metodo richiede un prezzo per paese per la destinazione o un costo di riserva.

Le tariffe in tempo reale non compaiono: attiva il Debug log, ricarica il checkout e apri WooCommerce > Status > Logs, origine vfd-estafeta. Il log indica il motivo: nessuna chiave API, nessun tasso di cambio per un negozio non in MXN, un CAP mancante o non valido, una chiave API rifiutata (HTTP 401 o 403), oppure nessuna tariffa Estafeta per il percorso.

Il prezzo include l'IVA? Dipende dal tuo account DrEnvio. Se i prezzi DrEnvio 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 DrEnvio in cache.

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 mantiene tutte le impostazioni e cancella solo la cache delle tariffe. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugin. La chiave di licenza e lo stato della licenza di questo plugin, le tariffe in cache e i vecchi file di log vengono sempre rimossi. Le impostazioni e i metodi di zona vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una futura reinstallazione. Gli ordini non vengono mai toccati e gli ordini esistenti mantengono le loro righe di spedizione.

Estafeta e DrEnvio sono marchi dei rispettivi proprietari. Questo plugin non è affiliato né approvato da Estafeta o DrEnvio.