VibeFox Packeta for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x.

PHP: 8.0 o successivo. Il modulo rifiuta l'installazione su versioni di PHP più vecchie.

Chiave API Packeta: la trovi nell'area clienti di Packeta (client.packeta.com), in Client support. Ha 16 lettere e cifre. Il widget ne ha bisogno per aprirsi al checkout, quindi il corriere viene mostrato ai clienti solo dopo l'inserimento della chiave API.

Paesi: Repubblica Ceca, Slovacchia, Ungheria o Romania devono essere paesi attivi del tuo negozio, in una zona a cui è collegato il corriere.

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

Installazione

1. Nel back office vai su Modules > Module Manager e fai clic su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento, fai clic su Configure, oppure trova più tardi VibeFox Packeta nell'elenco dei moduli e fai clic su Configure.

3. Inserisci la chiave di licenza VibeFox in License key nel blocco della licenza in cima alla pagina di configurazione e fai clic su Activate (vedi Chiave di licenza).

4. Inserisci la tua API key Packeta e i tuoi prezzi: almeno una riga di Country prices (per esempio * Default) oppure un Fallback cost. Fai clic su Save. La pagina mostra se Packeta ha accettato la chiave.

All'installazione il modulo crea il corriere Packeta pickup point con il testo dei tempi di consegna Packeta pickup point or Z-BOX. È collegato alle zone di Repubblica Ceca, Slovacchia, Ungheria e Romania e a tutti i gruppi di clienti. Puoi modificare zone, gruppi di clienti, tempi di consegna e logo in Shipping > Carriers. Non impostare lì i prezzi: il prezzo proviene sempre dal modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox Packeta > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina.

Il corriere viene offerto solo per i paesi della rete di punti di ritiro propria di Packeta: CZ, SK, HU e RO. Sopra le impostazioni, la pagina mostra il risultato della verifica della chiave API e gli avvisi sui problemi: chiave API mancante, prezzo mancante, paesi selezionati al di fuori della rete Packeta, corriere mancante oppure un'unità di peso del negozio che il modulo non riconosce.

Tutti i prezzi e i limiti accettano la virgola o il punto come separatore decimale (4,99 o 4.99). Un numero non valido o negativo viene rifiutato con un messaggio e viene mantenuto il valore precedente.

Generali

Enable/Disable: attiva o disattiva Packeta al checkout.

Name: il nome del corriere mostrato al cliente. È anche il nome del corriere in Shipping > Carriers. Predefinito: Packeta pickup point. Obbligatorio, massimo 64 caratteri.

API key: la tua chiave API Packeta da client.packeta.com > Client support. Puoi anche incollare la password API di 32 caratteri: vengono salvati solo i primi 16 caratteri, cioè la chiave API. La chiave API è pubblica: viene inviata al browser del cliente per aprire il widget. Quando salvi una nuova chiave, viene verificata con il feed dei corrieri di Packeta e la pagina mostra Packeta API key verified oppure che Packeta l'ha rifiutata. Se la verifica non può essere eseguita, la chiave viene salvata e verificata di nuovo al salvataggio successivo.

Widget language: la lingua del widget dei punti di ritiro. Store / visitor language (predefinito) segue la lingua della pagina. Puoi anche fissarla su ceco, slovacco, ungherese, rumeno, inglese, tedesco, polacco o ucraino.

Pickup point types: quali punti Packeta offre il widget.

Tax status: le regole fiscali applicate al prezzo della spedizione. None (no tax on shipping) oppure Taxable con uno dei tuoi gruppi di regole fiscali. La scelta viene salvata nel corriere.

Prezzi

Packeta non dispone di un'API pubblica per le tariffe. I prezzi provengono da questa tabella e vengono inseriti nella valuta predefinita del negozio, IVA esclusa. I clienti che pagano in un'altra valuta vedono il prezzo convertito.

Calculation type: Per order applica il prezzo una sola volta. Per item (price x quantity) lo moltiplica per il numero di articoli fisici nel carrello.

Country prices: un prezzo per paese di destinazione e per peso del pacco. Fai clic su Add country per aggiungere una riga e sulla croce per rimuoverne una. Ogni riga ha un Price e colonne di peso: XS fino a 1 kg, S da 1 a 2 kg, M da 2 a 3 kg, L da 3 a 5 kg e XL oltre 5 kg. Una colonna di peso lasciata a 0 usa la colonna Price. La riga * Default si applica ai paesi che non hanno una riga propria. Una nuova riga inizia come * Default con tutti i prezzi a 0, cioè spedizione gratuita. Scegli il paese e inserisci i prezzi prima di salvare, oppure rimuovi la riga. Se lo stesso paese (o * Default) compare in due righe, al salvataggio viene mantenuta solo la prima. Se un valore della tabella non è un numero valido, la tabella non viene salvata e la pagina elenca i valori errati.

Fallback cost: viene usato quando la tabella dei paesi non ha una riga per la destinazione e non esiste una riga * Default. Lascialo vuoto per non offrire il corriere in quel caso.

Free shipping from: il subtotale del carrello (dopo gli sconti, IVA esclusa) a partire dal quale la spedizione Packeta è gratuita. Viene verificato prima della tabella dei prezzi: da questo importo la spedizione è gratuita in ogni paese Packeta in cui il corriere è offerto, anche in un paese senza riga o costo di ripiego. Lascialo vuoto per non offrire mai la spedizione gratuita.

Disponibilità

Minimum weight (kg): nasconde il corriere quando il carrello pesa meno. Il peso del carrello viene convertito dall'unità di peso del tuo negozio. Vuoto o 0 significa nessun limite.

Maximum weight (kg): nasconde il corriere quando il carrello pesa di più. Predefinito: 15. I punti di ritiro e i Z-BOX Packeta di solito accettano pacchi fino a 15 kg; verifica il tuo contratto con Packeta. Vuoto o 0 significa nessun limite. Un peso minimo superiore al massimo viene rifiutato al salvataggio, e vengono mantenuti entrambi i valori precedenti.

Minimum cart subtotal: offri il corriere solo quando il subtotale del carrello (dopo gli sconti, IVA esclusa) raggiunge questo importo.

Ignore shipping zones: se attivo, il corriere viene collegato a tutte le zone e offerto per i paesi selezionati qui sotto. Le zone create in seguito vengono collegate subito. Quando lo disattivi, il corriere riprende le zone che aveva prima. Quando è disattivo, il corriere viene offerto solo nelle zone impostate per il corriere in Shipping > Carriers.

Countries (ignore zones mode): i paesi di destinazione per questa modalità. Lascialo vuoto per usare tutti i paesi Packeta. I paesi al di fuori della rete di punti di ritiro Packeta vengono saltati. Tieni premuto Ctrl e fai clic per selezionarne più di uno. Questo campo viene usato solo quando Ignore shipping zones è attivo.

Avanzate

Debug log: scrive i calcoli delle tariffe e le scelte dei punti di ritiro in modules/vfd_packeta/logs/. Il file non può essere aperto dal web. Non vengono registrati dati personali dei clienti né la chiave API. Gli errori e le verifiche non riuscite della chiave API vengono sempre registrati. Disattiva il log quando hai finito.

Log (last lines): mostra le ultime voci del log di debug. Fai clic su Clear log per svuotarlo.

Remove data on uninstall: se attivo, la disinstallazione del modulo elimina le impostazioni e il log. Il punto di ritiro salvato negli ordini viene sempre conservato.

Come funziona al checkout

Nel passaggio della spedizione PrestaShop chiede al modulo il prezzo Packeta. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel subtotale. Il modulo verifica le condizioni: paese di consegna nella rete Packeta, chiave API, elenco dei paesi in modalità ignore zones, peso del carrello e subtotale minimo del carrello. Se si applica la spedizione gratuita, il prezzo è 0. Altrimenti il prezzo proviene dalla tabella dei paesi e poi dal costo di ripiego. Se non c'è un prezzo, il corriere viene nascosto.

Quando il cliente seleziona il corriere Packeta, sotto di esso compare il pulsante Choose pickup point. Apre nel browser del cliente il widget ufficiale di Packeta con il paese di destinazione, il peso del carrello, i tipi di punto scelti e la lingua del widget. Dopo che il cliente ha scelto un punto, il suo nome e il suo indirizzo vengono mostrati sotto il corriere e il pulsante diventa Change pickup point. Il punto viene salvato con il carrello e resta quando la pagina viene ricaricata. Un punto scelto per un altro paese viene eliminato quando cambia l'indirizzo di consegna.

Il tuo server non richiede nulla a Packeta durante il checkout. Lo script del widget viene caricato da widget.packeta.com. Se viene bloccato (da un blocco pubblicità o privacy, da una content security policy o da un'interruzione di Packeta), il cliente vede il messaggio: «The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.»

Se modifichi il corriere in Shipping > Carriers dopo che ha ricevuto ordini, PrestaShop lo salva come nuova versione del corriere. Il modulo segue automaticamente la nuova versione.

I prezzi Packeta non vengono richiesti in tempo reale: provengono dalla tua tabella. Il modulo non crea spedizioni Packeta, non stampa etichette e non traccia i pacchi, e di base non offre la consegna a domicilio né i punti di ritiro di altri corrieri partner. Consegna a Packeta l'ID del punto di ritiro dell'ordine nel modo che usi di solito, per esempio tramite importazione in client.packeta.com.

Punti di ritiro

Il punto di ritiro è obbligatorio. Se il cliente fa clic su Continue nel passaggio della spedizione senza sceglierne uno, il passaggio non viene completato e il cliente vede il messaggio: «Please choose a Packeta pickup point.» Se il punto scelto si trova in un paese diverso da quello dell'indirizzo di consegna, il cliente vede il messaggio: «The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.» Il modulo non verifica l'ID del punto con Packeta; controlla solo che sia stato scelto un punto e che il suo paese corrisponda.

Il punto viene associato all'ordine quando l'ordine viene creato:

Pagina dell'ordine nel back office: un blocco Packeta pickup point con nome, indirizzo, Pickup point ID e paese. Se un ordine Packeta non ha un punto, il blocco dice: «No pickup point was selected for this order.»

Pagine di conferma e di dettaglio dell'ordine: Packeta pickup point: con nome e indirizzo.

E-mail dell'ordine: il nome e l'indirizzo del punto vengono aggiunti al corriere nell'e-mail di conferma dell'ordine. L'e-mail di nuovo ordine per il commerciante include anche il Pickup point ID.

Il punto viene memorizzato nella tabella del modulo vfd_pckt_point (carrello, ordine, ID del punto, nome e indirizzo, paese).

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Packeta è il primo blocco della pagina Modules > Module Manager > VibeFox Packeta > Configure, sopra le impostazioni. Inserisci la chiave in License key e fai clic su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale 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: presta-shipping-packeta e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con l'autorizzazione Configure per il modulo possono modificare la chiave. I testi del blocco seguono la lingua del back office (sono inclusi 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 o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: il dominio del negozio principale, anche in una configurazione multistore. 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 corriere Packeta non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. Lo storefront di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il corriere viene nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non puoi provarlo al checkout. Un promemoria compare in Modules > Module Manager, nella scheda Alerts. Gli ordini esistenti non sono interessati.

Quando una licenza scade, il modulo continua a funzionare, ma gli aggiornamenti e l'assistenza richiedono un rinnovo. Lo stato viene verificato di nuovo automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. Disinstallare o reimpostare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Packeta non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che la API key sia inserita e che il paese di consegna sia CZ, SK, HU o RO. Verifica che sia impostato un prezzo per il paese (riga del paese, riga * Default o Fallback cost), i limiti di peso e di subtotale e che il corriere copra la zona del paese del cliente e il gruppo del cliente in Shipping > Carriers (oppure che Ignore shipping zones sia attivo). I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto. La pagina delle impostazioni elenca in alto i problemi di configurazione. Attiva Debug log per vedere il motivo in Log (last lines).

Packeta ha rifiutato la chiave API: copia di nuovo la chiave API da client.packeta.com > Client support e salva. Fino ad allora il widget non può aprirsi al checkout.

Il widget non si apre: lo script di Packeta è bloccato da un blocco pubblicità o privacy, da una content security policy o da un'interruzione di Packeta. Consenti widget.packeta.com nella tua content security policy. Gli sviluppatori possono cambiare l'URL dello script con l'hook actionVfdPcktWidgetUrl.

La spedizione è gratuita per errore: controlla in Country prices le righe con un Price di 0, soprattutto una riga * Default aggiunta con Add country e lasciata vuota, e controlla Free shipping from.

I limiti di peso o le colonne di peso sembrano sbagliati: se la pagina avvisa sull'unità di peso del negozio, imposta kg, g, lb o oz in International > Localization (Local units). Le altre unità vengono lette come chilogrammi.

Altri paesi o corrieri: di base il corriere funziona per CZ, SK, HU e RO. Gli sviluppatori possono aggiungere paesi con l'hook actionVfdPcktCountries e passare gli ID dei corrieri al widget con l'hook actionVfdPcktWidgetOptions.

La pagina segnala che il corriere Packeta manca: il corriere è stato eliminato in Shipping > Carriers. Reimposta il modulo in Modules > Module Manager per ricrearlo.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox Packeta e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi. Il corriere Packeta viene sempre rimosso (gli ordini mantengono il proprio corriere), insieme al risultato salvato della verifica della chiave API. Se Remove data on uninstall è attivo, vengono eliminati le impostazioni, il log e i punti di ritiro dei carrelli che non sono mai diventati ordini. Se è disattivo, le impostazioni vengono conservate per una reinstallazione, che ricrea il corriere. Gli ordini esistenti conservano sempre il punto di ritiro salvato.

Packeta è un marchio del suo rispettivo proprietario. Questo modulo non è affiliato a Packeta né approvato da Packeta.