VibeFox Frenet 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 Frenet (solo per i preventivi in tempo reale): crea un account gratuito nel pannello Frenet (painel.frenet.com.br), attiva i corrieri che usi e copia il tuo token API. Se usi solo prezzi fissi, non ti serve un account Frenet.

Prodotti: compila peso e dimensioni per prezzi accurati. I prodotti senza questi dati vengono quotati come 0,3 kg e 16 × 11 × 2 cm (la scatola minima Correios).

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

2. Fai clic su Activate.

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

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

5. Incolla il token API e inserisci il CEP di partenza. Se la valuta del negozio non è il BRL, inserisci il tasso di cambio del BRL. Facoltativamente aggiungi prezzi fissi e un costo di riserva.

6. Aggiungi VibeFox Frenet a una zona di spedizione per il Brasile 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 Frenet. 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 che il cliente vede per questa zona. Lascialo vuoto per usare il Method title globale.

In cima alla pagina il plugin mostra avvisi: nessun token API (vengono usati solo prezzi fissi, oppure il metodo non viene mai mostrato se non ci sono nemmeno prezzi fissi), nessun CEP di partenza a 8 cifre, oppure una valuta del negozio diversa dal BRL senza tasso di cambio. Ogni volta che salvi le impostazioni, i preventivi in cache vengono cancellati. I campi dei prezzi accettano sia il punto sia la virgola come separatore decimale.

Generali

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

Method title: il nome del metodo di spedizione mostrato nel carrello e al checkout. Una zona può sostituirlo. Predefinito: Frenet.

Preventivi Frenet in tempo reale

Frenet confronta i corrieri attivi nel tuo account Frenet e restituisce i loro prezzi per il carrello. I preventivi in tempo reale vengono richiesti solo per indirizzi in Brasile con un CEP completo a 8 cifre.

API token: il tuo token API Frenet, dal pannello Frenet. Lascialo vuoto per usare solo prezzi fissi.

Origin CEP: il codice postale (CEP) da cui vengono spediti i pacchi, per esempio 00000-000. Lascialo vuoto per usare il codice postale del negozio, se l'indirizzo del negozio è in Brasile. Un CEP senza 8 cifre viene segnalato al salvataggio.

Service to offer: Cheapest service (predefinito) oppure Fastest service. Frenet restituisce più servizi e il metodo mostra un solo prezzo.

BRL exchange rate: Frenet quota in real brasiliani. Se la valuta del tuo negozio non è il BRL, indica quanto vale 1 BRL nella valuta del tuo negozio, per esempio 0.16. Con questo valore vengono convertiti il preventivo e il valore dichiarato dell'ordine. Senza di esso i preventivi in tempo reale non vengono usati. Non serve se la valuta del negozio è il BRL.

Prezzi fissi

Vengono usati quando non c'è un token API, per i paesi che Frenet non serve e ogni volta che Frenet non restituisce un prezzo (API non disponibile, CEP non servito).

Price per country: una tabella con le colonne Country, Price, XS, S, M, L e XL, con prezzi nella valuta del negozio. Fai clic su + Add country per aggiungere una riga e sulla croce (×) per rimuoverne una. Le colonne di dimensione dipendono dal peso del carrello: XS fino a 1 kg, S fino a 2 kg, M fino a 3 kg, L fino a 5 kg, XL oltre 5 kg. Price viene usato quando la colonna di dimensione è vuota. Un Price di 0 significa spedizione gratuita per quel paese. Usa * Default per tutti gli altri paesi. Le righe senza alcun prezzo vengono rimosse al salvataggio.

Fallback cost: viene usato quando né Frenet né la tabella forniscono un prezzo. Lascialo vuoto per nascondere il metodo.

Fixed price applies: Per order addebita il prezzo una sola volta. Per item (price × quantity) lo moltiplica per il numero di articoli. Vale solo per i prezzi fissi e per il costo di riserva. I preventivi Frenet coprono già l'intero carrello.

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. Predefinito: 30. 0 significa nessun limite.

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

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

Free shipping from: il subtotale del carrello (dopo gli sconti, prima delle tasse) da cui la spedizione è gratuita. Lascialo vuoto per non offrire mai la spedizione gratuita.

Tax status: Taxable aggiunge al costo di spedizione l'imposta di WooCommerce, None non la aggiunge. I prezzi Frenet sono prezzi finali del corriere; scegli None se WooCommerce non deve aggiungervi tasse.

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

Disponibilità senza zone di spedizione

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

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

Avanzate

Debug log: registra ogni richiesta e risposta di preventivo in WooCommerce > Status > Logs, origine vfd-frenet. Gli errori dell'API vengono sempre registrati. Il token non viene mai registrato e il CEP del cliente viene abbreviato. Disattivalo quando hai finito.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse tutte le impostazioni di Frenet e i metodi di zona. Disattivare il plugin non elimina mai le impostazioni. I preventivi in cache vengono sempre rimossi.

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, l'importo minimo dell'ordine e le classi di spedizione escluse. Se si applica la spedizione gratuita, il metodo viene mostrato con prezzo zero e nessuna richiesta viene inviata a Frenet.

Per un indirizzo in Brasile con un CEP completo a 8 cifre, il plugin invia a Frenet il CEP di partenza e quello di destinazione, ogni articolo del carrello (peso in kg, dimensioni in cm, quantità, SKU e categorie), il valore dell'ordine in BRL e il primo coupon applicato. Nessuna richiesta viene fatta finché il CEP è incompleto. Frenet restituisce i servizi dei corrieri attivi. I servizi con errore o senza prezzo vengono saltati. Il plugin sceglie il servizio più economico o quello più veloce e converte il prezzo nella valuta del negozio. Corriere, servizio e 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 per lo stesso carrello e lo stesso indirizzo. Una richiesta non riuscita, o un CEP che nessun corriere attivo serve, viene ricordata per 10 minuti. Il timeout dell'API è di 10 secondi. In questi casi il cliente non vede alcun errore: viene usato il prezzo fisso o il costo di riserva, oppure il metodo viene nascosto se non ce n'è nessuno. Per gli indirizzi fuori dal Brasile si usano solo i prezzi fissi.

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

Il plugin calcola solo le tariffe. Non crea spedizioni, non stampa etichette né traccia i pacchi; Frenet offre queste funzioni nel proprio pannello. Mostra un servizio Frenet per carrello, non più di uno, e non prevede punti di ritiro o armadietti. Frenet quota solo all'interno del Brasile; per gli altri paesi usa i prezzi fissi.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Shipping > VibeFox Frenet. 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 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 lo slot del dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Frenet non viene mostrato ai clienti al checkout. I gestori del negozio che hanno effettuato l'accesso 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 dei 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 controllato di nuovo automaticamente in background.

Risoluzione dei problemi

Frenet 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 order amount ed Excluded shipping classes. Motivi tipici: il cliente non ha ancora inserito un CEP completo a 8 cifre e non ci sono prezzi fissi, oppure Frenet non ha restituito alcun servizio per il percorso e non c'è un prezzo fisso.

I preventivi in tempo reale non compaiono: attiva Debug log, ricarica il checkout e apri WooCommerce > Status > Logs, origine vfd-frenet. Il log indica il motivo: token rifiutato (HTTP 401 o 403), nessun CEP di partenza, nessun tasso di cambio BRL, nessun corriere attivo nel pannello Frenet, oppure i messaggi dei servizi saltati.

Il mio negozio vende in euro o in dollari: Frenet risponde in BRL. Inserisci il BRL exchange rate (quanto vale 1 BRL nella valuta del tuo negozio).

Le tariffe sembrano obsolete dopo una modifica: salva la pagina delle impostazioni. Così vengono cancellati i preventivi 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 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

Disattivare il plugin mantiene tutte le impostazioni e cancella solo i preventivi in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin, i preventivi in cache e i vecchi file di log vengono sempre rimossi. Impostazioni e metodi di zona vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti conservano le righe di spedizione con il corriere Frenet.

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