VibeFox PostNord 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.

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 il metodo continua 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 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_postnord in /wp-content/plugins/ tramite FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox PostNord, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Incolla la API key PostNord, scegli il tuo Agreement country e compila i Country prices (vedi Configurazione).

6. Aggiungi VibeFox PostNord alle zone di spedizione di Svezia, Danimarca, Norvegia o Finlandia in WooCommerce > Settings > Shipping > Shipping zones. Nelle impostazioni del metodo imposta il suo Title e il Delivery type. Oppure attiva Ignore shipping zones.

Configurazione

Tutte le impostazioni, tranne il titolo e il tipo di consegna, si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox PostNord. Si applicano a tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha due campi:

Title (zone): il nome di questa opzione al checkout, per esempio "PostNord MyPack Collect". Lascialo vuoto per usare il Name globale.

Delivery type (zone): Same as global setting (predefinito), Service point / parcel locker o Home delivery. Aggiungi due metodi PostNord a una zona per offrirli entrambi.

Sopra le impostazioni la pagina avvisa se non c'è ancora una chiave API o un prezzo. Ogni volta che salvi le impostazioni, gli elenchi dei punti di servizio in cache vengono svuotati.

Generale

Enable/Disable: se è deselezionato, il metodo è nascosto ovunque, anche nelle zone di spedizione.

Name: il nome del metodo di spedizione mostrato al checkout. Un metodo di zona può sostituirlo con il proprio Title. Predefinito: PostNord.

Delivery type: il valore predefinito per tutti i metodi PostNord; ogni metodo di zona può sceglierne uno proprio.

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

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 registrata nel log.

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

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

Prezzi

I prezzi sono nella valuta del negozio. PostNord non ha un'API pubblica dei prezzi, quindi imposti i tuoi prezzi, di solito quelli del tuo contratto PostNord. L'ordine è: prima la tabella per paese, poi il costo di riserva; la spedizione gratuita si applica solo dove uno dei due dà un prezzo.

Calculation type: Per order addebita il prezzo una sola volta. Per item (price × 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 sulla croce 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. 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 inizia come * All other countries con tutti i prezzi a 0, il che significa spedizione gratuita. Scegli il paese e inserisci i prezzi prima di salvare, oppure rimuovi la riga. Una cella che non è un numero viene salvata come 0, con un messaggio.

Fallback cost: usato quando la tabella dei paesi non ha una riga per la destinazione né una riga *. Lascialo vuoto per nascondere il metodo per questi paesi.

Free shipping from: il subtotale del carrello (dopo gli sconti, al netto delle imposte) da cui PostNord è gratuito. Si applica solo dove è impostato un prezzo: una riga di paese, la riga * o il costo di riserva. Lascialo vuoto per non offrire mai la spedizione gratuita.

Disponibilità

Min weight (kg): nasconde il metodo 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 il metodo 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.

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

Disabled shipping classes: nasconde il metodo quando il carrello contiene un prodotto di una di queste classi di spedizione di WooCommerce.

Ignore shipping zones: se attivo, PostNord viene offerto per i paesi indicati sotto con le impostazioni globali, anche se non è aggiunto a una zona di spedizione. Se disattivo, solo nelle zone di spedizione in cui lo hai aggiunto.

Countries (Ignore shipping zones): i paesi di destinazione per questa modalità. Lascialo vuoto per usare tutti i paesi di spedizione. Questo campo è usato solo quando Ignore shipping zones è attivo.

Importi e pesi accettano virgola o punto. Un numero non valido non viene salvato, con un messaggio.

Avanzate

Debug log: scrive i calcoli delle tariffe e le chiamate API in WooCommerce > Status > Logs (origine "vfd-postnord"). Gli errori dell'API vengono sempre registrati. La chiave API non viene mai registrata. Disattiva il log quando hai finito.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le impostazioni PostNord e i metodi di zona. La disattivazione non elimina mai le impostazioni. I punti di servizio salvati negli ordini vengono sempre conservati.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin verifica le condizioni: peso del carrello, subtotale minimo e classi di spedizione disabilitate. Il prezzo arriva dalla tabella per paese, poi dal costo di riserva. Se non c'è un prezzo, il metodo viene nascosto. Se si applica la spedizione gratuita, il cliente vede il metodo senza costo.

Per un metodo 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 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 sono memorizzati nella cache per 6 ore per codice postale, e le risposte "nessun punto" per 1 ora. Gli errori dell'API sono memorizzati nella cache per 5 minuti, così un'interruzione di PostNord non rallenta ogni aggiornamento del checkout.

Per le altre destinazioni il metodo può comunque essere offerto con i tuoi prezzi, senza selettore.

Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin 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 un plugin per le etichette; l'ID del punto di servizio salvato è ciò di cui hanno bisogno questi strumenti.

Punti di ritiro

Quando il cliente seleziona un metodo 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 "Enter your postcode to choose a PostNord service point.". La scelta resta valida durante gli aggiornamenti del checkout.

Quando l'elenco è caricato, un punto è obbligatorio. Senza di esso, il checkout si ferma con "Please select a PostNord service point.". Il punto scelto viene verificato sul server rispetto all'elenco, sia nel checkout classico sia in quello a blocchi.

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

Schermata di gestione dell'ordine: PostNord service point con nome, indirizzo e Service point ID, sotto l'indirizzo di spedizione. Se non è stato scelto alcun punto, compare "not selected — PostNord delivers to the service point nearest to the shipping address".

Pagina di ringraziamento e vista dell'ordine in Il mio account: PostNord service point: con nome e indirizzo.

E-mail d'ordine: nome, indirizzo e ID del punto nelle e-mail HTML e in testo semplice.

Nel database il punto è salvato nei metadati dell'ordine _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name e _vfd_ptnd_servicepoint_address.

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 PostNord. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino a cui 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 dominio. Rimuovere la chiave da un sito non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, PostNord non viene mostrato ai clienti al checkout. I gestori del negozio che hanno effettuato l'accesso lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin 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 ricontrollato automaticamente in background.

Risoluzione dei problemi

PostNord 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). Verifica che sia impostato un prezzo per il paese (riga del paese, riga * o Fallback cost), i limiti di peso, Minimum subtotal e Disabled shipping classes.

Il selettore indica 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 e controlla WooCommerce > Status > Logs, origine "vfd-postnord". L'ordine può comunque essere effettuato; PostNord consegna allora al punto di servizio più vicino.

Punti di servizio inattesi: controlla l'Agreement country. Determina quali punti di servizio vengono offerti.

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

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 conserva tutte le impostazioni e cancella solo gli elenchi dei punti di servizio in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi, insieme agli elenchi dei punti di servizio in cache. Le impostazioni e i metodi di zona vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una reinstallazione successiva. Gli ordini esistenti conservano le proprie righe di spedizione e il punto di servizio salvato.

PostNord è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da PostNord.