VibeFox DHL Packstation 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.

DHL API key: l'elenco delle sedi proviene dalla DHL Location Finder API gratuita. Registrati sul portale sviluppatori DHL (developer.dhl.com), crea un'app, aggiungi l'API "Location Finder - Unified" e copia la chiave API dell'app. Per questa API non serve un contratto commerciale con DHL. Senza la chiave il metodo è nascosto al checkout. Tieni presente il limite di richieste della tua app DHL: ogni nuova ricerca per CAP o città è una richiesta API.

VibeFox license key: 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_dhl_packstation in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > DHL Packstation, 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 alto nella pagina e fai clic su Activate.

5. Incolla la chiave API DHL, salva, fai clic su Test API key, scegli i tipi di punto e inserisci i prezzi per paese (vedi Configurazione).

6. Aggiungi DHL Packstation a una zona di spedizione (per esempio Germania) in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > DHL Packstation. 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 di spedizione al checkout per questa zona. Lascialo vuoto per usare il Name globale.

Gli avvisi sopra le impostazioni indicano quando la chiave API DHL è vuota e quando le voci dei prezzi per paese non sono nel formato corretto. Ogni volta che salvi le impostazioni, la cache dei punti viene svuotata.

Generale

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

Name: il nome del metodo di spedizione mostrato al cliente. Predefinito: DHL Packstation. Una zona può sostituirlo con il proprio Title.

Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non la aggiunge.

DHL Location Finder API

DHL API key: la chiave API della tua app su developer.dhl.com. Senza di essa il metodo è nascosto al checkout.

Connection test: il pulsante Test API key cerca i punti vicino a 53113 Bonn con la chiave salvata e svuota la cache dei punti. Salva prima le impostazioni. Mostra quanti punti sono stati trovati, oppure che DHL ha rifiutato la chiave (401/403).

Punti di ritiro

Location types: quali punti DHL può scegliere il cliente: Packstation (parcel locker), Post Office (Postfiliale) e DHL Parcel Shop (Paketshop). Per impostazione predefinita tutti e tre. Se non ne è selezionato nessuno, il metodo è nascosto. Per una Packstation il cliente deve inserire il proprio DHL Postnummer.

Search radius (meters): il raggio intorno al CAP o alla città cercati. Predefinito: 5000. DHL consente fino a 25000 m.

Max results: il numero massimo di punti mostrati per ricerca. Predefinito: 20. DHL consente fino a 50.

Shipping address: usa il punto scelto come indirizzo di spedizione dell'ordine. Attivo per impostazione predefinita. La riga di indirizzo 1 diventa per esempio «Packstation 105», la riga 2 «Postnummer» con il numero, più CAP e città del punto, così le etichette stampate dall'ordine arrivano nel posto giusto. Il Postnummer viene inoltre salvato come _shipping_dhl_postnum, il campo letto dal plugin ufficiale «DHL Shipping Germany for WooCommerce».

Prezzi

Country prices: il prezzo per paese di destinazione nella valuta del negozio, nel formato CC:PREZZO, separati da virgole o da a capo. Predefiniti: DE:4.99, AT:5.99. Funziona anche la virgola decimale (DE:4,99).

Other countries: il prezzo per un paese di destinazione che non è in Country prices. Predefinito: 5.99. Lascialo vuoto per nascondere il metodo per questi paesi.

Calculation: 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: il subtotale del carrello da cui questa spedizione è gratuita. Lascia vuoto per non averla mai gratuita.

Disponibilità

Min weight (kg): il peso minimo del carrello. I pesi dei prodotti vengono convertiti dall'unità di misura del negozio. 0 significa nessun limite.

Max weight (kg): il metodo è nascosto sopra questo peso del carrello. Predefinito: 31.5, perché una Packstation accetta pacchi fino a 31,5 kg. 0 significa nessun limite.

Minimum subtotal: mostra il metodo solo se il subtotale del carrello è almeno questo valore. Lascia vuoto per mostrarlo sempre.

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

Ignore shipping zones: offri il metodo per i paesi indicati sotto anche quando la zona corrispondente non lo contiene.

Countries (ignore zones): i paesi di destinazione per questa modalità. Lascia vuoto per tutti i paesi. Usato solo con Ignore shipping zones.

Avanzate

Debug log: registra le richieste API e i passaggi del checkout in WooCommerce > Status > Logs, origine vfd-dhl-packstation. Gli errori API vengono sempre registrati, anche quando è disattivato. La chiave API, il Postnummer e gli indirizzi dei clienti non vengono mai registrati.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le sue impostazioni e i suoi metodi di zona. La disattivazione non cancella mai nulla. I punti scelti restano negli ordini.

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 per il paese di destinazione (o il prezzo per gli altri paesi) e applica la spedizione gratuita se il subtotale è abbastanza alto.

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 crea spedizioni DHL, non stampa etichette e non traccia i pacchi. Usa il portale clienti business di DHL o un plugin per le etichette: l'ordine contiene già l'indirizzo della Packstation e il Postnummer nel formato previsto. Il plugin non calcola tariffe DHL in tempo reale e non mostra una mappa. Se l'API DHL non è raggiungibile, il cliente vede un messaggio e non può usare questo metodo finché non torna a funzionare. Non è prevista l'immissione manuale di un numero di Packstation.

Punti di ritiro

Quando il cliente seleziona DHL Packstation, sotto l'opzione di spedizione compare un selettore. Vengono caricati i punti DHL vicini al CAP o alla città di spedizione. Il cliente può cercare un altro CAP o un'altra città. I punti sono raggruppati per tipo (Packstation, Post Office, Parcel Shop) e ordinati per distanza.

Per una Packstation il cliente deve inserire il DHL Postnummer, il proprio numero cliente DHL di 6-12 cifre, che si trova nell'app DHL o nell'account DHL. Per gli altri punti è facoltativo. L'ordine non può essere completato senza un punto di ritiro o con un Postnummer non valido. Questo controllo viene eseguito sul server, anche per il checkout a blocchi.

I risultati delle ricerche vengono memorizzati in cache per 12 ore. Una ricerca fallita viene memorizzata per 10 minuti, così il checkout non attende DHL a ogni aggiornamento. Il timeout dell'API è di 12 secondi.

Il punto (ID, tipo, numero, nome, indirizzo) e il Postnummer vengono salvati nell'ordine. Sono mostrati nella schermata dell'ordine sotto l'indirizzo di spedizione, nella pagina di ringraziamento, in My account > Orders e nelle e-mail degli ordini (HTML e testo semplice) come DHL pickup location e DHL Postnummer.

Nella schermata dell'ordine fai clic su Edit accanto al punto, cerca per CAP o città, scegli un altro punto, cambia il Postnummer e fai clic su Save location. Ogni modifica aggiunge una nota all'ordine. Se Shipping address è attivo, anche l'indirizzo di spedizione viene aggiornato. Ricarica la pagina per vederlo.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in alto in WooCommerce > Settings > Shipping > DHL Packstation. 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 il suo slot di dominio. Liberalo dal tuo account vibefox.net.

Senza una chiave attiva, DHL Packstation non viene mostrata ai clienti al checkout. I gestori del negozio con l'accesso effettuato la vedono ancora, contrassegnata con (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 controllato di nuovo automaticamente in background.

Risoluzione dei problemi

DHL Packstation 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). Verifica che la DHL API key sia compilata, che sia selezionato almeno un tipo di punto, che il paese di destinazione abbia un prezzo (o che sia impostato Other countries) e che le regole di peso, subtotale e classe di spedizione non lo nascondano.

Non compare nessun punto: fai clic su Test API key. Se DHL rifiuta la chiave (401/403), controlla la chiave e che la tua app abbia l'API "Location Finder - Unified". Attiva Debug log e apri WooCommerce > Status > Logs, origine vfd-dhl-packstation. Verifica che non sia stato raggiunto il limite di richieste della tua app DHL.

Nessun punto vicino a un indirizzo: aumenta Search radius (meters) o Max results, oppure lascia che il cliente cerchi un altro CAP o un'altra città.

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. Cancella solo la cache dei punti. Per rimuovere il plugin, disattivalo ed eliminalo dalla pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin vengono sempre rimossi, così come la cache dei punti. Impostazioni e metodi di zona vengono rimossi solo se era attiva l'opzione Remove data on uninstall. Altrimenti restano per una reinstallazione successiva. I punti scelti restano negli ordini, e gli ordini esistenti conservano le loro righe di spedizione.

DHL e Packstation sono marchi dei rispettivi proprietari. Questo plugin non è affiliato a DHL né approvato da DHL.