VibeFox PostNord for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x.

PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.

Chiave API PostNord (per il selettore del punto di servizio): crea un account gratuito su developer.postnord.com, aggiungi un'applicazione e copia la sua chiave API. Senza chiave i corrieri continuano a funzionare, ma i clienti non possono scegliere un punto di servizio.

Contratto PostNord: per spedire i pacchi ti serve il tuo solito contratto cliente PostNord, per esempio MyPack Collect o MyPack Home.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo 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 PostNord nell'elenco dei moduli e fai clic su Configure.

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

4. Incolla la API key di PostNord, scegli il tuo Agreement country, compila i Country prices (vedi Configurazione) e fai clic su Save.

All'installazione il modulo crea due corrieri. PostNord consegna in un punto di servizio, con il testo dei tempi di consegna Delivery to a PostNord service point. È attivo. PostNord Home delivery consegna all'indirizzo, con il testo PostNord home delivery. È disattivato finché non attivi Home delivery. Entrambi i corrieri sono assegnati alle zone di Svezia, Danimarca, Norvegia e Finlandia e a tutti i gruppi di clienti. Puoi modificare zone, gruppi di clienti, testo dei tempi di consegna, logo e limiti di dimensione in Shipping > Carriers. Non impostare lì i prezzi: il prezzo arriva sempre dal modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox PostNord > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina. Ogni salvataggio cancella anche gli elenchi dei punti di servizio memorizzati nella cache.

Sopra le impostazioni la pagina avvisa quando manca ancora la chiave API, quando manca ancora un prezzo, quando un corriere PostNord è stato eliminato o quando l'unità di peso del negozio non è riconosciuta dal modulo. In quel caso i pesi dei prodotti vengono considerati in kg. Usa kg, g, lb o oz in International > Localization (Local units).

Generale

Enable/Disable: attiva o disattiva il corriere con punto di servizio. È lo stesso interruttore dello stato del corriere in Shipping > Carriers.

Name: il nome del corriere con punto di servizio al checkout, per esempio "PostNord MyPack Collect". Predefinito: PostNord. Obbligatorio.

Home delivery: offre anche la consegna a domicilio PostNord. È il secondo corriere, senza punto di servizio. Disattivato per impostazione predefinita.

Home delivery name: il nome del corriere per la consegna a domicilio al checkout, per esempio "PostNord MyPack Home". Predefinito: PostNord Home delivery. Obbligatorio.

Tax status: None significa che i prezzi qui sotto sono definitivi. Taxable: seguito da una regola fiscale significa che PrestaShop aggiunge l'imposta sulla spedizione di quella regola ai prezzi. Vale per entrambi i corrieri.

API PostNord (selettore del punto di servizio)

API key: la chiave API della tua applicazione su developer.postnord.com. Viene inviata a PostNord solo dal tuo server, mai al browser, e non viene mai scritta nel log. Dopo il salvataggio il campo resta vuoto e mostra Saved - leave empty to keep it. Inserisci un valore nuovo solo se vuoi cambiarla.

Remove the saved API key: spunta la casella e fai clic su Save per eliminare la chiave salvata.

Test mode: usa l'ambiente di test PostNord (atapi2.postnord.com). Solo per le chiavi rilasciate per l'ambiente di test.

Agreement country: il paese del tuo contratto cliente PostNord: Svezia, Danimarca, Norvegia o Finlandia. Decide quali punti di servizio vengono offerti. Same as the delivery country (predefinito) usa il paese del cliente.

Prezzi

Il titolo della sezione mostra la valuta predefinita del tuo negozio. I prezzi sono in quella valuta, IVA esclusa, e sono gli stessi per entrambi i corrieri. PostNord non ha un'API pubblica dei prezzi, quindi imposti i tuoi prezzi, di solito quelli del tuo contratto PostNord. L'ordine è: soglia di spedizione gratuita, poi la tabella per paese e infine il costo di riserva.

Calculation type: Per order addebita il prezzo una volta sola. Per item (price x number of items) lo moltiplica per il numero di articoli nel carrello.

Country prices: un prezzo per paese di destinazione e peso del carrello. Fai clic su Add country per aggiungere una riga e sull'icona del cestino per rimuoverne una. Ogni riga ha un Price e colonne di peso: XS fino a 1 kg, S fino a 2 kg, M fino a 3 kg, L fino a 5 kg e XL oltre 5 kg. Una colonna di peso con 0 usa la colonna Price, e un Price di 0 significa spedizione gratuita. Il paese * All other countries copre tutti i paesi senza una riga propria. Decimali con virgola o punto (9,99 o 9.99). Una nuova riga parte come * All other countries con tutti i prezzi a 0. Scegli il paese e inserisci i prezzi prima di salvare, oppure rimuovi la riga. Una cella vuota viene salvata come 0. Una cella che non è un numero viene salvata come 0, con un messaggio.

Fallback cost: usato quando la tabella per paese non ha una riga per la destinazione né una riga *. Lascia vuoto il campo per nascondere i corrieri per quei paesi.

Free shipping from: il subtotale del carrello (prodotti che richiedono spedizione, dopo gli sconti, IVA esclusa) a partire dal quale PostNord è gratuito. Viene verificato prima della tabella per paese, quindi vale anche per un paese senza riga di prezzo. Lascia vuoto il campo per non offrire mai la spedizione gratuita.

Disponibilità

Min weight (kg): nasconde i corrieri quando il carrello pesa meno. I pesi dei prodotti vengono convertiti dall'unità di peso del tuo negozio. 0 significa nessun limite.

Max weight (kg): nasconde i corrieri quando il carrello pesa di più. Predefinito: 30. 0 significa nessun limite. Verifica il limite di peso del tuo servizio PostNord: gli armadietti accettano meno dei punti di servizio. Un Min weight (kg) maggiore di Max weight (kg) viene rifiutato con un errore e non si salva nulla.

Minimum subtotal: mostra i corrieri solo se il subtotale del carrello (prodotti che richiedono spedizione, dopo gli sconti, IVA esclusa) raggiunge almeno questo importo. Lascia vuoto il campo per mostrarli sempre.

Ignore shipping zones: quando è attivo, PostNord viene offerto per i paesi qui sotto anche se le zone dei suoi corrieri non li includono. I corrieri sono collegati a tutte le zone attive, e una zona creata in seguito viene collegata subito. Quando lo disattivi di nuovo, i corrieri riottengono le zone che avevano prima. Quando è disattivato, i corrieri vengono offerti solo nelle proprie zone.

Countries (Ignore shipping zones): i paesi di destinazione per questa modalità. Lascia vuoto il campo per consentire tutti i paesi. Questo campo viene usato solo quando Ignore shipping zones è attivo.

Importi e pesi accettano virgola o punto. Un valore che non è un numero pari o superiore a 0 non viene salvato, e compare un messaggio.

Avanzate

Debug log: scrive i calcoli delle tariffe e le chiamate API in logs/vfd_ptnd_debug.log.php, nella cartella del modulo. Il file non può essere aperto dal web. Gli errori dell'API vengono sempre registrati. La chiave API non viene mai registrata. Disattiva il log quando hai finito.

Log: mostra la dimensione e le voci più recenti del log di debug. Fai clic su Clear log per svuotarlo.

Remove data on uninstall: quando è attivo, disinstallare il modulo elimina le impostazioni e i corrieri PostNord. Quando è disattivato, la disinstallazione si limita a disattivare i corrieri. I punti di servizio salvati negli ordini vengono sempre conservati.

Come funziona al checkout

Nel passaggio della spedizione PrestaShop chiede al modulo il prezzo di ciascun corriere PostNord. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel subtotale. Il modulo verifica il peso del carrello e il subtotale minimo. Se si applica la spedizione gratuita, il prezzo è 0. Altrimenti il prezzo viene dalla tabella per paese e poi dal costo di riserva. Se non c'è un prezzo, il corriere viene nascosto. Il prezzo viene calcolato nella valuta predefinita del tuo negozio e poi mostrato nella valuta del carrello del cliente.

Per il corriere con punto di servizio e un indirizzo di consegna in Svezia, Danimarca, Norvegia o Finlandia, il tuo server chiede alla PostNord Business Location API i 10 punti di servizio più vicini al codice postale di consegna. Invia il paese e il codice postale di consegna e il paese del contratto. Il timeout dell'API è di 10 secondi. Gli elenchi vengono memorizzati nella cache per 6 ore per codice postale, e le risposte "nessun punto" per 1 ora. Gli errori dell'API vengono memorizzati nella cache per 5 minuti, così un guasto di PostNord non rallenta ogni aggiornamento del passaggio di consegna. Il passaggio di consegna non attende mai PostNord: se l'elenco non è ancora in cache, viene caricato dopo che il cliente ha selezionato il corriere.

Per le altre destinazioni i corrieri possono comunque essere offerti con i tuoi prezzi, senza selettore. Il corriere per la consegna a domicilio non mostra mai un selettore.

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

Il modulo non richiede prezzi PostNord in tempo reale e non crea etichette di spedizione, non prenota spedizioni (EDI), non fornisce numeri di tracciamento e non invia e-mail di tracciamento. Non c'è una vista mappa. Per le spedizioni usa PostNord Portal, Skicka Direkt Business o uno strumento per le etichette: questi strumenti hanno bisogno dell'ID del punto di servizio salvato.

Punti di ritiro

Quando il cliente seleziona il corriere con punto di servizio, sotto compare un elenco PostNord service point con i punti più vicini, raggruppati per città con la distanza. Prima che venga inserito un codice postale, il cliente vede il messaggio "Inserisci il tuo codice postale per scegliere un punto di servizio PostNord." La scelta viene salvata con il carrello e resta valida anche dopo gli aggiornamenti del passaggio di consegna.

Quando l'elenco è caricato, un punto è obbligatorio. Senza una scelta, Continue si blocca con il messaggio "Seleziona un punto di servizio PostNord." Il punto scelto viene verificato sul server con l'elenco PostNord per l'indirizzo di consegna. Un punto scelto per un altro codice postale non viene usato.

Il selettore non blocca mai una vendita. Se l'elenco non può essere caricato (chiave API non ancora inserita, API PostNord non disponibile o nessun punto vicino al codice postale), il cliente vede una nota e può comunque completare l'ordine. PostNord consegna allora al punto di servizio più vicino all'indirizzo.

Pagina dell'ordine nel back office: un blocco PostNord service point con il nome, l'indirizzo e il Service point ID. Se non è stato scelto alcun punto, riporta "non selezionato - PostNord consegna al punto di servizio più vicino all'indirizzo di spedizione".

Conferma d'ordine e dettagli dell'ordine del cliente: PostNord service point: con il nome e l'indirizzo.

E-mail d'ordine: la conferma d'ordine al cliente e l'avviso di nuovo ordine allo shop mostrano il nome, l'indirizzo e l'ID del punto accanto al nome del corriere. L'avviso allo shop mostra anche "not selected" quando non c'è un punto.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox PostNord è il primo blocco nella pagina Modules > Module Manager > VibeFox PostNord > 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 ci sono la riga Product: presta-shipping-postnord e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con il permesso Configure per il modulo possono cambiare 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 che l'indirizzo del negozio cambia, o dopo che liberi 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, i corrieri PostNord non vengono mostrati ai clienti al checkout e non viene calcolato alcun prezzo di spedizione. Il front office di PrestaShop non sa che hai effettuato l'accesso al back office, quindi i corrieri sono nascosti 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 aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. Disinstallare il modulo rimuove sempre la chiave di licenza e lo stato della licenza. Il Reset di questo modulo non cancella i dati, quindi la chiave e lo stato vengono conservati.

Risoluzione dei problemi

PostNord non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable (o Home delivery) sia attivo. In Shipping > Carriers verifica che il corriere copra la zona del paese del cliente e il gruppo del cliente, oppure attiva Ignore shipping zones. Verifica che sia impostato un prezzo per il paese (riga del paese, riga * o Fallback cost), i limiti di peso e il Minimum subtotal. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto.

Il selettore dice che i punti di servizio non possono essere caricati: controlla la API key e l'impostazione Test mode. Una chiave di produzione non funziona con l'ambiente di test, e viceversa. Attiva il Debug log, ricarica il checkout e controlla il campo Log nella pagina del modulo. L'ordine può comunque essere effettuato; PostNord consegna allora al punto di servizio più vicino.

Punti di servizio inattesi: controlla Agreement country. Decide quali punti di servizio vengono offerti.

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

I punti di servizio sembrano obsoleti dopo una modifica: fai clic su Save nella pagina del modulo. Questo svuota gli elenchi in cache.

La pagina dice che un corriere PostNord non è stato trovato: 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 PostNord e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi. Disattivare il modulo cancella solo gli elenchi dei punti di servizio in cache. Alla disinstallazione gli elenchi in cache vengono sempre rimossi. Se Remove data on uninstall è attivo, i corrieri vengono eliminati (gli ordini conservano la loro cronologia) e le impostazioni e il log vengono rimossi. Se è disattivato, i corrieri vengono solo disattivati e tutte le impostazioni vengono conservate. Reinstallare il modulo restituisce ai corrieri salvati lo stato che avevano. I punti di servizio salvati negli ordini vengono sempre conservati.

PostNord è un marchio di proprietà dei rispettivi titolari. Questo modulo non è affiliato né approvato da PostNord.