VibeFox DPD Pickup for WooCommerce — Guida
Requisiti
WordPress: 5.8 o successivo.
WooCommerce: 7.0 o successivo, installato e attivo. Il plugin non si attiva senza WooCommerce.
PHP: 8.0 o successivo.
Credenziali DPD Baltic (Lituania, Lettonia, Estonia): l'elenco dei punti di ritiro proviene dal servizio web di DPD Baltic. Ti servono il nome utente e la password dell'API che DPD rilascia ai propri clienti business. Chiedili al tuo account manager DPD o al servizio clienti DPD del tuo paese. Un unico account elenca i punti di ritiro di Lituania, Lettonia ed Estonia.
DPD Slovacchia: la ricerca pubblica dei parcelshop di DPD Slovacchia non richiede credenziali.
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 clicca su Install Now. Puoi anche caricare la cartella vfd_dpd_pickup in /wp-content/plugins/ tramite FTP.
2. Clicca su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox DPD Pickup, oppure clicca 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 clicca su Activate.
5. Scegli la tua API DPD. Per DPD Lituania, Lettonia o Estonia inserisci il nome utente e la password dell'API. Inserisci i prezzi per paese e salva. Clicca su Refresh pickup points per verificare la connessione (vedi Configurazione).
6. Aggiungi VibeFox DPD Pickup alle tue zone di spedizione in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Valgono per 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 per questa zona. Lascialo vuoto per usare il Name globale.
Gli avvisi sopra le impostazioni ti segnalano quando il nome utente o la password di DPD Baltic sono vuoti e quando non sono impostati prezzi. Ogni volta che salvi le impostazioni, la cache dei punti di ritiro viene svuotata.
Generali
Enable/Disable: attiva o disattiva il metodo in tutte le zone contemporaneamente.
Name: il nome del metodo di spedizione mostrato al checkout. Predefinito: DPD Pickup Point.
Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non la aggiunge.
Elenco dei punti di ritiro DPD
I punti di ritiro vengono caricati da DPD e memorizzati nella cache per 24 ore.
DPD API: la società DPD con cui hai il tuo account. Gli account Baltic usano il servizio web del proprio paese.
API username (Baltic): il tuo nome utente del servizio web DPD Baltic. Non serve per DPD Slovacchia.
API password (Baltic): la tua password del servizio web DPD Baltic. Non serve per DPD Slovacchia.
Pickup points: il pulsante Refresh pickup points svuota la cache e carica subito i punti di ritiro da DPD: Lituania, Lettonia ed Estonia con l'API Baltic, oppure una ricerca di prova a Bratislava per DPD Slovacchia. Mostra il risultato per ogni paese. Salva prima le impostazioni.
Prezzi
I prezzi di spedizione sono fissi per paese, nella valuta del negozio. I prezzi DPD non vengono richiesti tramite l'API.
Country prices: una riga per paese: CC:price, per esempio EE:3.50. È accettata la virgola decimale. Predefiniti: SK:3.50, LT:4.00, LV:4.00, EE:4.00.
Fallback cost: il prezzo per i paesi che non sono in Country prices. Predefinito: 5.00. Lascialo vuoto per offrire il metodo solo nei paesi elencati.
Calculation type: Per order addebita il prezzo una sola volta. Per item (price x quantity) lo moltiplica per il numero di articoli nel carrello.
Free shipping from: la spedizione è gratuita quando il subtotale dell'ordine (dopo i coupon) raggiunge questo importo. Lascia vuoto per disattivare.
Disponibilità
Il metodo viene nascosto anche quando DPD non restituisce punti di ritiro per l'indirizzo del cliente o quando l'API DPD non è raggiungibile, perché un ordine non può essere consegnato senza un punto di ritiro.
Min weight (kg): il peso minimo del carrello. I pesi dei prodotti vengono convertiti dall'unità di peso del tuo negozio. Vuoto o 0 significa nessun limite.
Max weight (kg): i carrelli più pesanti non vedono il metodo. Predefinito: 31.5. 0 significa nessun limite. Verifica i limiti di peso dei pacchi per i punti di ritiro e gli armadietti DPD Pickup del tuo paese.
Minimum subtotal: mostra il metodo solo quando il subtotale dell'ordine è almeno questo importo. Lascia vuoto per mostrarlo sempre.
Excluded shipping classes: il metodo viene nascosto quando il carrello contiene un prodotto di una di queste classi di spedizione di WooCommerce.
Ignore shipping zones: offre il metodo per i paesi indicati sotto, anche quando la zona di spedizione del cliente non lo contiene. Disattivato significa che aggiungi il metodo alle zone di spedizione come di consueto.
Countries: i paesi di destinazione per quella modalità. Lascia vuoto per tutti i paesi. Usato solo con Ignore shipping zones.
Selettore del punto di ritiro
City order: mostra prima le città principali (Tallinn, Riga, Vilnius, Bratislava e altre). Attivo per impostazione predefinita.
City list width: la larghezza CSS dell'elenco delle città, per esempio 100% o 300px. Predefinito: 100%.
Pickup point list width: la larghezza CSS dell'elenco dei punti di ritiro, per esempio 100% o 400px. Predefinito: 100%.
Avanzate
Debug log: registra le richieste API e i passaggi del checkout in WooCommerce > Status > Logs, origine vfd-dpd-pickup. Gli errori API vengono sempre registrati, anche quando questa opzione è disattivata. Le credenziali non vengono mai registrate.
Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le sue impostazioni e i metodi di zona. La disattivazione non elimina mai le impostazioni. Il punto di ritiro salvato negli ordini viene sempre conservato.
Come funziona al checkout
Quando il cliente inserisce un indirizzo di spedizione, WooCommerce chiede al plugin un prezzo. Il plugin controlla il peso del carrello, il subtotale minimo e le classi di spedizione escluse, prende il prezzo del paese (o il costo di riserva) e applica la spedizione gratuita se il subtotale è abbastanza alto. Poi carica i punti di ritiro DPD per l'indirizzo. Se DPD non ne restituisce nessuno, non è raggiungibile o mancano le credenziali Baltic, il metodo viene nascosto.
Un elenco di punti di ritiro viene memorizzato nella cache per 24 ore. Una richiesta non riuscita viene ricordata per 5 minuti, così un'interruzione di DPD non rallenta mai il checkout. Il timeout dell'API è di 15 secondi.
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 richiede a DPD i prezzi, non crea spedizioni DPD, non stampa etichette, non crea distinte, non prenota ritiri da corriere, non traccia i pacchi e non mostra una mappa. Sono supportati solo il servizio web DPD Baltic e la ricerca parcelshop di DPD Slovacchia.
Punti di ritiro
Quando il cliente seleziona DPD Pickup, sotto il metodo compaiono un elenco di città e un elenco di punti di ritiro. La città dell'indirizzo del cliente è preselezionata. Con DPD Slovacchia il cliente inserisce prima la città e il CAP, poi vede i punti vicini. Un punto di ritiro è obbligatorio. Il server verifica che il punto appartenga al paese e all'indirizzo del cliente, quindi una scelta falsificata o non aggiornata viene rifiutata.
Il punto scelto viene salvato nell'ordine. Compare nella schermata dell'ordine sotto l'indirizzo di spedizione, nella pagina di ringraziamento, in My account > Orders e nelle e-mail dell'ordine (HTML e testo semplice) come DPD pickup point. Il nome salvato nell'ordine proviene da DPD, non dal browser.
Nella schermata dell'ordine clicca su Edit accanto al punto di ritiro, scegli una città e un altro punto. Il punto viene verificato con l'elenco DPD per l'indirizzo dell'ordine. Per cambiare il punto l'ordine deve avere una città e un CAP di spedizione.
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 DPD Pickup. Incolla la chiave in License key e clicca 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 il suo posto per il dominio. Liberalo nel tuo account vibefox.net.
Senza una chiave attiva, DPD Pickup non viene mostrato ai clienti al checkout. Gli amministratori del negozio connessi 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 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 controllato di nuovo automaticamente in background.
Risoluzione dei problemi
DPD Pickup 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 sia consentito). Controlla gli avvisi in cima alla pagina delle impostazioni e clicca su Refresh pickup points. Controlla i limiti di peso e di subtotale, le classi di spedizione escluse e che il paese abbia un prezzo (o un costo di riserva).
"Login failed" dopo Refresh pickup points: DPD ha rifiutato le credenziali Baltic, quindi non è possibile caricare alcun punto di ritiro. Controlla nome utente e password dell'API con DPD.
DPD Slovacchia non mostra punti: i punti compaiono quando il cliente ha inserito la città e il CAP. DPD elenca solo i punti entro 50 km da quell'indirizzo.
Trovare la causa: attiva il Debug log. Ogni decisione viene scritta in WooCommerce > Status > Logs, origine vfd-dpd-pickup. Gli errori API vengono sempre registrati. Nome utente e password dell'API non vengono mai scritti nel log.
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 clicca su Check now. Se l'indirizzo del sito è cambiato, clicca 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. Svuota solo la cache dei punti di ritiro. Per rimuovere il plugin, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi, così come la cache dei punti di ritiro. Impostazioni e metodi di zona vengono rimossi solo se era attiva l'opzione Remove data on uninstall. Altrimenti restano per una successiva reinstallazione. Il punto di ritiro salvato negli ordini non viene mai eliminato e gli ordini esistenti mantengono le loro righe di spedizione.
DPD è un marchio dei rispettivi proprietari. Questo plugin non è affiliato a DPD né approvato da DPD.