VibeFox 99Minutos for WooCommerce — Guida
Requisiti
WordPress: 5.8 o successivo.
WooCommerce: 5.0 o successivo, installato e attivo. Il plugin non si attiva senza WooCommerce.
PHP: 8.0 o successivo.
Chiave API 99minutos (solo per la verifica della copertura): richiedila al tuo account manager 99minutos oppure nel portale sviluppatori 99minutos (developers.99minutos.com). Le chiavi sandbox e live sono diverse. Se usi solo la matrice dei prezzi, non ti serve una chiave API.
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_99minutos in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox 99Minutos, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.
4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.
5. Compila la Price matrix (almeno una riga, ad esempio «* Default») e, facoltativamente, la chiave API e la modalità di verifica della copertura (vedi la sezione «Configurazione»).
6. Aggiungi VibeFox 99Minutos a una zona di spedizione in WooCommerce > Settings > Shipping > Shipping zones che copra Messico, Colombia, Cile o Perù.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox 99Minutos. Valgono per tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:
Method title (zone): il nome che i clienti vedono in questa zona. Lascialo vuoto per usare il Method title globale.
Al salvataggio delle impostazioni, la pagina ti avvisa se la matrice dei prezzi è vuota o se è stata scelta una modalità di verifica della copertura senza chiave API.
Generale
Enable/Disable: abilita 99Minutos in tutte le zone di spedizione contemporaneamente. Il metodo deve comunque essere aggiunto a una zona di spedizione che copra Messico, Colombia, Cile o Perù. Predefinito: attivo.
Method title: il nome del metodo di spedizione mostrato al cliente al checkout. Una zona può sostituirlo. Predefinito: 99Minutos.
Tax status: Taxable aggiunge l'imposta WooCommerce al costo di spedizione, None non la aggiunge.
API 99minutos (verifica della copertura) (facoltativo)
L'API serve solo a verificare se 99minutos consegna al CAP del cliente. Il prezzo arriva sempre dalla matrice.
Coverage check: se e come viene verificato il CAP.
Con la verifica della copertura, il metodo compare solo dopo che il cliente ha inserito un CAP. I risultati vengono memorizzati nella cache: coperto per 6 ore, non coperto per 30 minuti, errore API per 5 minuti. A 99minutos viene inviato solo il CAP.
API key: la tua chiave API 99minutos, inviata come token Bearer all'endpoint di verifica della copertura di 99minutos. È obbligatoria quando la verifica della copertura è attiva. Il campo è mascherato.
Environment: Sandbox (test) (predefinito) oppure Production. Sandbox e live usano chiavi API diverse, quindi scegli l'ambiente che corrisponde alla tua chiave.
Tariffe
I prezzi sono espressi nella valuta del tuo negozio e vengono usati così come inseriti, senza conversione.
Price matrix: una tabella di paesi di destinazione e prezzi. Fai clic su + Add country per aggiungere una riga e sulla crocetta per rimuoverla. Ogni riga ha un Country, un Base price e i prezzi per le dimensioni 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). Un prezzo di dimensione vuoto o pari a 0 ricade sul Base price. La riga * Default si applica ai paesi senza una riga propria. Sono accettati sia il punto sia la virgola come separatore decimale; i prezzi negativi vengono salvati come 0. Finché la matrice non ha almeno una riga, il metodo non viene mostrato al checkout.
Calculation: Per order — size by the total cart weight (predefinito) applica un unico prezzo in base alla dimensione del pacco dell'intero carrello. Per item — each unit priced by its own weight applica a ogni unità il prezzo della dimensione del proprio peso e poi somma i risultati.
Free shipping: attiva la spedizione gratuita da un subtotale del carrello.
Free shipping from: il subtotale del carrello (dopo gli sconti, al netto delle imposte) a partire dal quale la tariffa è 0. Usato solo se Free shipping è attivo.
Restrizioni
Min weight (kg): nasconde il metodo se il carrello è più leggero. 0 significa nessun limite. I pesi dei prodotti vengono convertiti dall'unità di peso del tuo negozio.
Max weight (kg): nasconde il metodo se il carrello è più pesante. Predefinito: 25. 0 significa nessun limite.
Minimum subtotal: mostra il metodo solo se il subtotale del carrello (dopo gli sconti, al netto delle imposte) è almeno pari a questo importo. Lascia vuoto per mostrarlo sempre.
Excluded shipping classes: nasconde il metodo se un articolo del carrello appartiene a una di queste classi di spedizione WooCommerce.
Restrict countries: offre il metodo solo per i paesi indicati sotto. È un filtro aggiuntivo rispetto alle zone di spedizione: il metodo va comunque aggiunto a una zona. Utile quando una zona copre più paesi.
Countries: scelta dei paesi 99minutos (Messico, Colombia, Cile, Perù). Usato solo se Restrict countries è attivo. Lascia vuoto per consentire tutti i paesi 99minutos.
Avanzate
Debug log: registra i calcoli delle tariffe in WooCommerce > Status > Logs (origine «vfd-99minutos»). Gli errori API vengono registrati anche quando l'opzione è disattivata. Le chiavi API e i nomi e gli indirizzi dei clienti non vengono mai registrati.
Remove data on uninstall: se attiva, l'eliminazione del plugin rimuove le sue impostazioni e la cache di copertura. La disattivazione non elimina nulla. I metodi di spedizione nelle zone e gli ordini vengono comunque conservati.
Come funziona al checkout
Il metodo viene offerto solo se il paese di consegna è Messico, Colombia, Cile o Perù (e se è nell'elenco Countries quando Restrict countries è attivo). Quando il cliente inserisce un indirizzo di consegna, il plugin controlla i limiti di peso del carrello, Minimum subtotal ed Excluded shipping classes.
Se è attiva una modalità di verifica della copertura, il plugin chiede poi all'API 99minutos se il CAP è coperto. Il timeout della richiesta è di 10 secondi e la risposta viene memorizzata nella cache, quindi lo stesso CAP non genera una nuova richiesta. Gli errori API non vengono mai mostrati al cliente: in modalità Strict il metodo viene nascosto, in modalità Soft si usa il prezzo della matrice. La spedizione gratuita non aggira la verifica della copertura.
Il prezzo viene preso dalla riga della matrice del paese di consegna oppure dalla riga * Default. Se non esiste nessuna delle due, il metodo viene nascosto. Se Free shipping è attivo e il subtotale del carrello raggiunge Free shipping from, la tariffa è 0.
Il metodo funziona con il checkout classico e con i blocchi Carrello e Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS).
Il plugin non ottiene tariffe in tempo reale da 99minutos: i prezzi arrivano sempre dalla tua matrice. Non crea spedizioni né ordini in 99minutos, non stampa etichette (guides), non traccia i pacchi, non offre punti di ritiro Punto99 e non gestisce il pagamento in contrassegno. Crea le spedizioni nel tuo account 99minutos come al solito.
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 99Minutos. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, ad 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. Liberalo nel tuo account vibefox.net.
Senza una chiave attiva, 99Minutos non viene mostrato ai clienti al checkout. I gestori del negozio che hanno effettuato l'accesso lo vedono comunque, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e provare 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 ricontrollato automaticamente in background.
Risoluzione dei problemi
99Minutos non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che il metodo sia aggiunto alla zona dell'indirizzo del cliente. Il paese di consegna deve essere Messico, Colombia, Cile o Perù. Controlla che la Price matrix abbia una riga per quel paese o una riga * Default, e verifica i limiti di peso, Minimum subtotal, Excluded shipping classes e Restrict countries.
Il metodo compare solo dopo che è stato inserito un CAP: è il comportamento previsto con la verifica della copertura. In modalità Strict compare solo se l'API conferma la copertura.
Il metodo è sempre nascosto in modalità Strict: attiva Debug log, ricarica il checkout e apri WooCommerce > Status > Logs (origine «vfd-99minutos»). Un errore HTTP 401 o 403 significa che la chiave API è stata rifiutata: controlla la chiave e che Environment corrisponda (le chiavi sandbox e live sono diverse). Usa la modalità Soft se i clienti devono comunque ricevere il prezzo della matrice quando l'API non è disponibile.
Il prezzo non è quello che ti aspettavi: controlla Calculation (per ordine o per articolo), i pesi dei prodotti e l'unità di peso del tuo negozio. Un prezzo di dimensione vuoto o pari a 0 ricade sul Base price.
Altri paesi: gli sviluppatori possono modificare l'elenco dei paesi supportati con il filtro vfd_99m_supported_countries.
Il blocco licenza mostra un errore: segui il messaggio nel blocco. Ad 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 conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo dalla pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Impostazioni e cache della copertura vengono rimosse solo se era attiva l'opzione Remove data on uninstall. Altrimenti restano disponibili per una reinstallazione futura. I metodi di spedizione nelle zone e gli ordini esistenti vengono conservati.
99minutos è un marchio del rispettivo proprietario. Questo plugin non è affiliato a 99minutos né approvato da 99minutos.