VibeFox DPD Pickup for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato su 3.0.5.0) o 4.0.2 e versioni successive (testato su 4.1.0.3).

PHP: 8.0 o successivo.

Credenziali DPD Baltic (Lituania, Lettonia, Estonia): l'elenco dei punti di ritiro proviene dal servizio web DPD Baltic. Ti servono il nome utente e la password dell'API che DPD fornisce ai propri clienti business. Chiedi al tuo account manager DPD o al servizio clienti DPD del tuo paese. Un account DPD Baltic elenca i punti di ritiro di Lituania, Lettonia ed Estonia.

DPD Slovacchia: la ricerca pubblica dei parcelshop DPD Slovacchia non richiede credenziali.

Classe di peso: i pesi dei prodotti vengono convertiti in kg. Il tuo negozio deve avere una classe di peso con unità kg in System > Localisation > Weight Classes (OpenCart ne include una per impostazione predefinita).

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un dominio.

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 vfd_dpd_pickup-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 vfd_dpd_pickup.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file vfd_dpd_pickup-oc3-(version).ocmod.zip. L'estensione non aggiunge modifiche OCMOD, quindi non serve aggiornare Extensions > Modifications. In alternativa all'Installer, puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo di estensione Shipping. Trova VibeFox DPD Pickup e clicca su Install (il pulsante verde +).

3. Clicca su Edit (il pulsante a forma di matita) per aprire la pagina delle impostazioni.

4. Inserisci la tua chiave di licenza VibeFox in License key nel blocco della licenza in cima alla pagina Edit e clicca su Activate (vedi Chiave di licenza).

5. Scegli la tua API DPD. Per DPD Lituania, Lettonia o Estonia inserisci nome utente e password dell'API. Controlla i prezzi per paese, attiva Enable/Disable e clicca su Save. Poi clicca su Refresh pickup points per verificare la connessione (vedi Configurazione).

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file vfd_dpd_pickup.ocmod.zip. Non rinominare il file: OpenCart 4 ricava il codice dell'estensione dal nome del file, e un pacchetto rinominato non funziona.

2. Il pacchetto compare nell'elenco delle estensioni installate nella stessa pagina. Clicca su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo di estensione Shipping. Trova VibeFox DPD Pickup, clicca su Install (il pulsante verde +), poi su Edit (il pulsante a forma di matita).

4. Inserisci la chiave di licenza e le impostazioni come nei passaggi 4 e 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni.

Dopo l'installazione il metodo è disattivato finché non attivi Enable/Disable e salvi. Se reinstalli l'estensione dopo una disinstallazione, vengono usate di nuovo le impostazioni che hai conservato.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Shipping > VibeFox DPD Pickup > Edit. Le sezioni sono elencate a sinistra. Un unico pulsante Save salva l'intera pagina senza ricaricarla. Ogni salvataggio cancella anche gli elenchi dei punti di ritiro memorizzati nella cache. Solo gli utenti amministratori con il permesso di modifica per questa estensione possono salvare le impostazioni, aggiornare i punti di ritiro o svuotare il registro.

Gli avvisi in cima alla pagina segnalano quando il nome utente o la password DPD Baltic sono vuoti, o quando non sono impostati prezzi (in entrambi i casi il metodo non viene mostrato al checkout), e quando il negozio non ha una classe di peso con unità kg (i pesi dei prodotti vengono allora letti dal nome della loro unità, e le unità sconosciute sono trattate come kg). Alcuni valori bloccano il salvataggio, e in tal caso non viene salvato nulla: un Name vuoto o più lungo di 64 caratteri, un Sort order che non è un numero intero e un Min weight (kg) maggiore del Max weight (kg). Un valore che non è un numero, o un numero negativo, in un campo di importo o di peso non viene salvato: il campo diventa vuoto e un avviso lo indica, mentre le altre impostazioni vengono salvate. Le righe di Country prices che non sono nel formato CC:PRICE vengono elencate in un avviso e ignorate.

Generale

Il metodo viene offerto nella zona geografica impostata in Availability (tutte le zone se nessuna è impostata), oppure con Ignore shipping zones nei paesi scelti lì.

Enable/Disable: mostra o nasconde DPD Pickup al checkout. Predefinito: disattivato.

Name: il nome del metodo di spedizione mostrato al cliente al checkout. Predefinito: DPD Pickup Point. Obbligatorio, al massimo 64 caratteri.

Tax class: la classe fiscale applicata al prezzo di spedizione, oppure None (predefinito) per nessuna imposta.

Sort order: la posizione del metodo nell'elenco dei metodi di spedizione. Un numero intero.

Elenco dei punti di ritiro DPD

I punti di ritiro vengono caricati da DPD e memorizzati nella cache (vedi Come funziona al checkout).

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 necessario per DPD Slovacchia. Svuotarlo cancella anche la password salvata.

API password (Baltic): la tua password del servizio web DPD Baltic. Non necessaria per DPD Slovacchia. Dopo il salvataggio il campo resta vuoto e mostra Saved - leave empty to keep it. Inserisci un nuovo valore solo se vuoi modificarlo.

Pickup points: il pulsante Refresh pickup points svuota la cache e carica ora i punti di ritiro da DPD: Lituania, Lettonia ed Estonia per l'API Baltic, e una ricerca di prova a Bratislava per DPD Slovacchia. Mostra il numero dei punti di ritiro o l'errore per paese. Salva prima le impostazioni.

Prezzi

I costi di spedizione sono fissi per paese, nella valuta predefinita del tuo negozio, IVA esclusa. I prezzi DPD non vengono richiesti all'API.

Country prices: una riga per paese: CC:prezzo, per esempio EE:3.50. È accettata la virgola decimale. Predefinito: 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 (predefinito) addebita il prezzo una 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 gli sconti, prima delle imposte) raggiunge questo importo. Lascialo vuoto per disattivarla.

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 punto di ritiro.

Min weight (kg): il peso minimo del carrello. I pesi dei prodotti vengono convertiti dalla loro classe di peso. Vuoto o 0 significa nessun limite.

Max weight (kg): i carrelli più pesanti non vedono il metodo. Predefinito: 31.5. Vuoto o 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 se il subtotale dell'ordine (dopo gli sconti, prima delle imposte) è almeno questo importo. Lascialo vuoto per mostrarlo sempre.

Geo zone: offre il metodo solo per gli indirizzi in questa zona geografica. All zones (predefinito) significa nessun limite. Le zone geografiche si gestiscono in System > Localisation > Geo Zones. Non usato con Ignore shipping zones.

Ignore shipping zones: se attivo, la zona geografica non viene verificata e il metodo viene offerto nei paesi indicati sotto. Se disattivo (predefinito), viene usata solo la zona geografica indicata sopra.

Countries: i paesi di destinazione per questa modalità. Lascialo 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: scrive le richieste API e i passaggi del checkout in storage/logs/vfd_dpd_debug.log.php (su OpenCart 4 system/storage/logs/vfd_dpd_debug.log.php). Il file non può essere letto dal web. Gli errori dell'API vengono sempre registrati, anche quando questa opzione è disattivata. Le credenziali non vengono mai registrate. Quando il file raggiunge 5 MB, viene spostato in vfd_dpd_debug.old.log.php e inizia un nuovo registro.

Log: mostra la dimensione e le ultime voci del registro di debug. Clicca su Clear log per svuotarlo.

Remove data on uninstall: se attivo, la disinstallazione dell'estensione elimina le sue impostazioni, il registro e le scelte dei checkout non completati. Il punto di ritiro salvato negli ordini viene sempre conservato.

Importa / Esporta

Export: clicca su Download JSON per salvare le impostazioni in un file JSON. La password dell'API non viene esportata.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni, ad esempio su un altro negozio. I valori vengono verificati come in un normale salvataggio. La password dell'API salvata viene mantenuta.

Come funziona al checkout

Quando OpenCart mostra i metodi di spedizione, chiede all'estensione il prezzo di DPD Pickup. Se è impostata una Geo zone (e Ignore shipping zones è disattivato) e l'indirizzo è al di fuori di essa, il metodo non viene offerto. Contano solo i prodotti con Requires Shipping impostato su Yes: gli altri prodotti non aggiungono peso e non sono inclusi nel subtotale. L'estensione verifica i paesi (con Ignore shipping zones), il peso del carrello e il subtotale minimo, prende il prezzo del paese (o il costo di riserva) e applica la spedizione gratuita se il subtotale è abbastanza alto. Il subtotale è il prezzo dei prodotti da spedire, dopo lo sconto del coupon e prima delle imposte.

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. Con DPD Slovacchia il metodo viene mostrato finché mancano la città o il CAP, e i punti compaiono quando l'indirizzo è completo. Il prezzo viene calcolato nella valuta predefinita e mostrato al cliente nella sua valuta con l'imposta della Tax class selezionata.

Un elenco di punti di ritiro viene memorizzato nella cache fino a 24 ore, un elenco vuoto fino a 1 ora, ma mai più a lungo della durata della cache di OpenCart (1 ora per impostazione predefinita). 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.

L'estensione non richiede prezzi DPD, non crea spedizioni DPD, non stampa etichette, non crea distinte, non prenota ritiri di corriere, non traccia i pacchi e non mostra una mappa. Sono supportati solo il servizio web DPD Baltic e la ricerca dei parcelshop 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. La scelta viene salvata appena il cliente la effettua. Con DPD Slovacchia, il cliente vede Enter your city and postcode to see the DPD pickup points nearby. finché l'indirizzo non è completo, poi i punti vicini. Se DPD non ha punti per l'indirizzo, il cliente vede No DPD pickup points are available for this address right now. Please check the address or choose another shipping method.

Un punto di ritiro è obbligatorio. Senza di esso il cliente non può proseguire e vede Please select a DPD pickup point. Quando il cliente clicca su Continue, il server verifica che il punto appartenga all'elenco DPD per l'indirizzo del cliente. Una scelta falsificata o non aggiornata viene rifiutata con The selected DPD pickup point is not available for this address. Please choose another one. Se in quel momento non è possibile caricare l'elenco DPD, viene accettato il punto già scelto dal cliente, e l'ordine mostra il suo ID invece del nome.

Su OpenCart 4 il cliente clicca su Choose nel blocco del metodo di spedizione della pagina di checkout e sceglie DPD Pickup nella finestra Shipping method options. L'elenco delle città e l'elenco dei punti di ritiro compaiono in quella finestra sotto il metodo e funzionano come descritto sopra. Il pulsante Continue della finestra non procede senza un punto di ritiro, con gli stessi messaggi.

Il punto scelto viene aggiunto al metodo di spedizione dell'ordine, per esempio DPD Pickup Point: name, street, postcode city con il titolo predefinito, oppure My title - DPD pickup point: name, street, postcode city con il tuo titolo (al massimo 128 caratteri). Così compare nell'ordine nell'area di amministrazione, nella cronologia ordini del cliente, nelle e-mail dell'ordine e nella fattura. Il nome salvato nell'ordine proviene da DPD, non dal browser.

Su OpenCart 4 il testo del metodo di spedizione può avere fino a 255 caratteri. OpenCart 4 mantiene un unico ordine per il checkout e lo aggiorna ogni volta che il cliente conferma di nuovo, e il punto di ritiro dell'ordine viene aggiornato insieme ad esso.

Nella pagina dell'ordine in amministrazione (Sales > Orders), il riquadro DPD pickup point sopra la cronologia mostra il nome del punto, il suo ID e il paese. Clicca su Edit, scegli una città e un altro punto e clicca su Save. Il punto viene verificato con l'elenco DPD per l'indirizzo dell'ordine, e il riquadro mostra Pickup point updated. oppure Pickup point not found for the order address. Il testo del metodo di spedizione dell'ordine viene aggiornato, e nella cronologia dell'ordine viene aggiunta una nota (non inviata al cliente) con il vecchio punto, il nuovo punto e l'utente amministratore. Per cambiare il punto serve il permesso di modifica degli ordini, non l'accesso alle impostazioni dell'estensione. Con DPD Slovacchia l'ordine deve avere città e CAP di spedizione, altrimenti il riquadro mostra Add the shipping city and postcode to change the pickup point. Un ordine effettuato senza punto mostra No pickup point was selected for this order., e il registro di debug contiene un errore per esso. Il riquadro e Edit funzionano anche dopo la disattivazione dell'estensione.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox DPD Pickup è il primo blocco in Extensions > Extensions > Shipping > VibeFox DPD Pickup > Edit, sopra le impostazioni. Inserisci la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino a cui la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto di essi ci sono la riga Product: opencart-shipping-dpd-pickup e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono incluse inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached oppure License expired on seguito da una data. Dopo un cambio dell'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, clicca su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, il metodo di spedizione DPD Pickup non viene mostrato ai clienti al checkout e non viene calcolata nessuna tariffa. Un utente amministratore collegato all'amministrazione nello stesso browser vede comunque il metodo nel negozio, contrassegnato con (unlicensed — visible to admins only), quindi puoi configurare e testare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'amministratore, quindi senza una chiave attiva il metodo è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non vengono influenzati.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard dell'amministrazione o la pagina Edit: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

DPD Pickup non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable sia attivo. Controlla Geo zone (o Ignore shipping zones e Countries), i limiti di peso e di subtotale e che il paese abbia un prezzo (o un costo di riserva). Controlla gli avvisi in cima alla pagina dell'estensione e clicca su Refresh pickup points. Verifica che i prodotti abbiano Requires Shipping impostato su Yes.

Un errore dopo Refresh pickup points: il risultato mostra l'errore DPD per paese. Per esempio, "Login failed" significa che 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 città e CAP. DPD elenca solo i punti entro 50 km da quell'indirizzo.

Per trovare la causa: attiva Debug log, ricarica il checkout e guarda il campo Log nella pagina dell'estensione. Gli errori dell'API vengono sempre registrati. Nomi utente e password dell'API non vengono mai scritti nel registro.

I punti di ritiro sembrano non aggiornati dopo una modifica: clicca su Save o su Refresh pickup points nella pagina dell'estensione. Entrambi svuotano gli elenchi in cache.

La pagina mostra "Warning: You do not have permission to modify VibeFox DPD Pickup!": il tuo gruppo di utenti amministratori può solo visualizzare le impostazioni. Concedi al gruppo il permesso di modifica per extension/shipping/vfd_dpd_pickup (OpenCart 3) o extension/vfd_dpd_pickup/shipping/vfd_dpd_pickup (OpenCart 4) in System > Users > User Groups.

Per gli sviluppatori: il raggio di ricerca di DPD Slovacchia può essere modificato da un'altra estensione con l'evento OpenCart vfd_dpd_pickup/sk_search_radius.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Shipping e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox DPD Pickup. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart ripristina sempre Enable/Disable, Sort order, Tax class e Geo zone. L'estensione rimuove sempre i propri eventi e gli elenchi dei punti di ritiro in cache. Se Remove data on uninstall è attivo, vengono eliminati anche le altre impostazioni, il registro di debug e le scelte dei checkout non completati. Se è disattivo, le impostazioni vengono conservate e riutilizzate quando reinstalli l'estensione. Il punto di ritiro salvato negli ordini non viene mai eliminato, e gli ordini esistenti mantengono il loro metodo di spedizione e il loro costo.

In OpenCart 4, per rimuovere anche i file dell'estensione, vai su Extensions > Installer dopo la disinstallazione e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox DPD Pickup nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

DPD è un marchio registrato del suo titolare. Questa estensione non è affiliata a DPD né da essa approvata.