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

Chiave API di Coordinadora (solo per le tariffe in tempo reale): le tariffe in tempo reale provengono dal Cotizador di Coordinadora tramite il servizio WooCommerce di Coordinadora, lo stesso servizio usato dal plugin ufficiale di Coordinadora. Coordinadora rilascia la chiave API ai clienti con un accordo commerciale attivo. Chiedi al tuo account manager di Coordinadora oppure consulta wc.coordinadora.com. Ti serve anche il codice DANE di 8 cifre della città da cui spedisci. Senza chiave il metodo funziona solo con prezzi fissi.

Prodotti: per una tariffa in tempo reale ogni prodotto nel carrello deve avere peso e dimensioni (lunghezza, larghezza, altezza).

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un 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_coordinadora in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Coordinadora, 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. Inserisci la chiave API, il codice DANE della città di partenza e, se la valuta del negozio non è COP, il tasso di cambio in COP. Aggiungi almeno un prezzo fisso per la Colombia come alternativa (vedi Configurazione).

6. Aggiungi VibeFox Coordinadora a una zona di spedizione che copra la Colombia in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones e scegli i paesi.

7. Assicurati che i tuoi prodotti abbiano peso e dimensioni.

Configurazione

Tutte le impostazioni sono in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Coordinadora. Si applicano a ogni zona di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title (zone): il nome del metodo di spedizione mostrato al cliente per questa zona. Lascialo vuoto per usare il Name globale.

La pagina delle impostazioni mostra avvisi in alto quando le tariffe in tempo reale non possono funzionare o il metodo verrebbe nascosto: il codice DANE di partenza manca o non è valido, manca il tasso di cambio in COP oppure non c'è un prezzo fisso per la Colombia. Ogni volta che salvi le impostazioni, le tariffe in cache vengono cancellate. I numeri si possono digitare con il punto o con la virgola (9,99 = 9.99).

Generali

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

Name: il nome del metodo di spedizione mostrato al cliente al checkout. Predefinito: Coordinadora. Il Title di una zona lo sostituisce.

Tax status: Taxable aggiunge l'imposta di spedizione di WooCommerce alla tariffa, None non la aggiunge. Scegli None se i tuoi prezzi o la tariffa di Coordinadora includono già le imposte.

Tariffe in tempo reale di Coordinadora

Le tariffe in tempo reale vengono richieste per destinazioni in Colombia. Lascia la chiave vuota per usare solo i prezzi fissi.

API key: la tua chiave API WooCommerce di Coordinadora. Non viene mai scritta nel log.

Origin city (DANE code): il codice DANE di 8 cifre della città da cui spedisci, per esempio 11001000 Bogotá, 05001000 Medellín, 76001000 Cali o 08001000 Barranquilla. Viene accettato anche un codice di comune a 5 cifre, che viene completato a 8.

COP per 1 unit of store currency: Coordinadora quota in pesos colombiani. Se la valuta del tuo negozio non è COP, indica quanti COP valgono 1 unità della tua valuta, per esempio 4300. Il tasso serve anche per inviare il valore dichiarato in COP. Se lo lasci vuoto, le tariffe in tempo reale non vengono usate. Se la valuta del negozio è COP, lascialo vuoto.

Prezzi fissi (usati quando non c'è una chiave API, per destinazioni fuori dalla Colombia e come alternativa quando una tariffa in tempo reale non è disponibile)

Prices by country: una tabella di paesi con una colonna Price e prezzi opzionali per dimensione del pacco nella valuta del tuo negozio. La dimensione deriva dal peso del carrello: XS fino a 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL oltre 5 kg. Price si usa quando la colonna della dimensione è 0 o vuota. Fai clic su + Add country per aggiungere una riga e sull'icona della croce per rimuoverla. Il paese * All other countries si applica ai paesi senza una riga propria. Un paese senza riga (e senza *) non ha un prezzo fisso. Una riga con Price 0 e senza prezzo per dimensione dà spedizione gratuita.

Fixed price per: Order addebita il prezzo una sola volta. Item (price × quantity) lo moltiplica per il numero di articoli nel carrello. Vale solo per i prezzi fissi; una tariffa in tempo reale di Coordinadora copre sempre tutto l'ordine.

Condizioni

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

Max weight (kg): nasconde il metodo sopra questo peso del carrello. Predefinito: 25. 0 significa nessun limite.

Minimum order subtotal: mostra il metodo solo se il subtotale del carrello è almeno 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 di WooCommerce.

Free shipping: attiva la consegna gratuita a partire dal subtotale indicato sotto.

Free shipping from: il subtotale del carrello da cui la spedizione è gratuita. Usato solo se Free shipping è attivo. In questo caso non viene inviata alcuna richiesta all'API.

Disponibilità senza zone di spedizione

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

Countries: i paesi di destinazione per questa modalità. Lascia vuoto per usare tutti i paesi verso cui il negozio spedisce. Questo campo si usa solo se Ignore shipping zones è attivo.

Avanzate

Debug log: registra i calcoli delle tariffe in WooCommerce > Status > Logs, origine vfd-coordinadora. Gli errori dell'API vengono sempre registrati, anche con questa opzione disattivata. La chiave API e gli indirizzi dei clienti non vengono mai registrati.

Remove data on uninstall: se attiva, eliminando il plugin vengono rimosse le sue impostazioni, i metodi di zona e le tariffe in cache. La disattivazione non elimina mai i dati.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin controlla prima le condizioni: peso del carrello, subtotale minimo dell'ordine e classi di spedizione escluse. Se si applica la spedizione gratuita, il cliente ottiene una tariffa gratuita e non viene inviata alcuna richiesta a Coordinadora.

Per un indirizzo in Colombia con chiave API, il plugin trova il codice DANE della città di destinazione in quest'ordine: un codice DANE nel campo città (i plugin di dipartimenti e città colombiani per il checkout lo scrivono, per esempio MEDELLIN (ANT) (05001000)), un CAP di 8 cifre oppure l'elenco integrato dei capoluoghi di dipartimento e di circa 40 delle città più grandi. Una città dell'elenco viene verificata rispetto al dipartimento selezionato. Accenti e maiuscole/minuscole non vengono considerati.

Poi il plugin invia a Coordinadora il codice DANE di destinazione e ogni prodotto con la città di partenza, il suo peso (kg), le dimensioni (cm), la quantità e il valore dichiarato (COP). Le unità del negozio vengono convertite automaticamente. Coordinadora restituisce il prezzo in COP e il plugin lo converte nella valuta del negozio. Ogni tariffa è memorizzata in cache per 1 ora. Una richiesta non riuscita viene ricordata per 10 minuti, così un'interruzione di Coordinadora non rallenta ogni aggiornamento del checkout. Il timeout dell'API è di 10 secondi.

Quando una tariffa in tempo reale non è disponibile (errore dell'API, città sconosciuta, prodotto senza peso o dimensioni, impostazioni mancanti), si usa il prezzo fisso. Se non ce n'è uno, il metodo viene nascosto. I dettagli degli errori vanno nel log di WooCommerce, mai al cliente.

Il metodo funziona con il checkout classico e con i 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 o guías (guías), non stampa etichette, non prenota ritiri (recogidas), non traccia i pacchi, non riscuote il contrassegno (recaudo) né offre punti di ritiro Droop; per questo usa il portale di Coordinadora. Non offre la consegna in giornata, e le destinazioni internazionali usano i prezzi fissi.

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 Coordinadora. 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 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, Coordinadora 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 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

Coordinadora 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). Controlla i limiti di peso, Minimum order subtotal e Excluded shipping classes. Senza tariffa in tempo reale deve esistere un prezzo fisso per il paese o per *.

La tariffa in tempo reale non viene mostrata, solo il prezzo fisso: attiva Debug log, ricarica il checkout e apri WooCommerce > Status > Logs, origine vfd-coordinadora. Motivi tipici: la città di destinazione non è riconosciuta, un prodotto non ha peso o dimensioni, mancano il codice DANE di partenza o il tasso COP, oppure Coordinadora ha restituito un errore.

La città di destinazione non è riconosciuta: installa un plugin di dipartimenti e città colombiani per il checkout che scriva il codice DANE nel campo città. Gli sviluppatori possono associare altre città con i filtri vfd_crd_dane_cities e vfd_crd_destination_dane.

La tariffa include le imposte? La tariffa è quella calcolata da Coordinadora. Con Tax status impostato su Taxable, WooCommerce aggiunge l'imposta di spedizione sopra; scegli None se la quotazione la include già.

Le tariffe sembrano obsolete dopo una modifica: salva la pagina delle impostazioni. Così si cancellano le tariffe 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; cancella solo le tariffe in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza, lo stato della licenza di questo plugin e le tariffe in cache vengono sempre rimossi. Impostazioni e metodi di zona vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una reinstallazione futura. Gli ordini esistenti conservano le proprie righe di spedizione.

Coordinadora è un marchio registrato del rispettivo titolare. Questo plugin non è affiliato né approvato da Coordinadora.