VibeFox Australia Post for WooCommerce — Guida
Requisiti
WordPress: 5.8 o successivo.
WooCommerce: 5.0 o successivo, installato e attivo. Il plugin non si attiva senza di esso.
PHP: 8.0 o successivo.
Chiave PAC API di Australia Post (solo per le tariffe in tempo reale): le tariffe in tempo reale usano l'API Postage Assessment Calculator (PAC) di Australia Post. La chiave è gratuita: registrati sull'Australia Post Developer Centre (developers.auspost.com.au) per ottenere una chiave PAC API. Ti serve anche il codice postale australiano a 4 cifre da cui spedisci. Se usi solo prezzi fissi per paese, non ti serve una chiave API.
Chiave di licenza VibeFox: 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_australia_post in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Australia Post, 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 cima alla pagina e fai clic su Activate.
5. Scegli la Rate source. Per le tariffe in tempo reale, inserisci la chiave PAC API, il codice postale di spedizione e, se la valuta del negozio non è AUD, il tasso di conversione in AUD (vedi Configurazione).
6. Aggiungi VibeFox Australia Post a una zona di spedizione in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones e scegli i paesi.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Australia Post. 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 mostrato al cliente per questa zona. Lascialo vuoto per usare il Method title generale.
Ogni volta che salvi le impostazioni, vengono cancellate le tariffe di Australia Post in cache. Se sono scelte le tariffe in tempo reale ma manca la chiave API, il codice postale di spedizione o il tasso AUD, dopo il salvataggio compare un avviso.
General
Enable/Disable: attiva o disattiva il metodo in tutte le zone contemporaneamente.
Method title: il nome del metodo di spedizione mostrato al cliente al checkout. Una zona può sostituirlo con un titolo proprio. Predefinito: Australia Post.
Tax status: Taxable aggiunge l'imposta di WooCommerce al costo della spedizione, None non la aggiunge.
Rate source: come viene calcolato il prezzo.
I dettagli degli errori vanno nel log, mai al cliente.
API di Australia Post (tariffe in tempo reale) (non necessaria per i prezzi fissi)
PAC API key: la tua chiave PAC API gratuita di Australia Post. Viene inviata ad Australia Post nell'intestazione AUTH-KEY.
Ship-from postcode: il codice postale australiano a 4 cifre da cui vengono spediti i pacchi, per esempio 2000.
Domestic service: usato per le consegne all'interno dell'Australia (fino a 22 kg, 105 cm per lato): Parcel Post (predefinito) oppure Express Post.
International service: usato per le consegne al di fuori dell'Australia (fino a 20 kg): International Standard (predefinito), International Express oppure International Courier.
Remove GST: divide per 1,1 i prezzi nazionali dell'API. I prezzi nazionali di Australia Post includono il 10% di GST. Attivalo quando WooCommerce aggiunge l'imposta alla spedizione da sé (Tax status = Taxable), così la GST non viene addebitata due volte. Le spedizioni internazionali sono esenti da GST e non vengono mai modificate.
AUD → (your currency) rate: i prezzi di Australia Post sono in AUD. Se la valuta del tuo negozio non è AUD, inserisci quante unità della tua valuta valgono un AUD, per esempio 0.61. Senza questo valore le tariffe in tempo reale non vengono usate. Se la valuta del negozio è AUD, lascia il campo vuoto. Sono accettati sia il punto sia la virgola come separatore decimale.
Pacco per le tariffe in tempo reale
Il carrello viene inviato come un unico pacco. Pesi e dimensioni dei prodotti vengono convertiti dalle unità del tuo negozio in kg e cm. I valori seguenti si usano per i prodotti senza peso o dimensioni.
Default product weight (kg): usato per ogni prodotto senza peso, nella richiesta ad Australia Post e nel controllo di Min cart weight / Max cart weight. Predefinito: 1.
Default parcel length (cm): usato quando nessun prodotto del carrello ha dimensioni. Predefinito: 22.
Default parcel width (cm): usato quando nessun prodotto del carrello ha dimensioni. Predefinito: 16.
Default parcel height (cm): usato quando nessun prodotto del carrello ha dimensioni. Predefinito: 8.
Prezzi fissi (usati con i prezzi fissi e come alternativa alle tariffe in tempo reale)
Country prices: una tabella di codici paese a 2 lettere (AU, NZ, US e così via) e di prezzi nella valuta del tuo negozio. Fai clic su + Add row per aggiungere un paese e sul pulsante di rimozione per eliminarne uno. Usa * per tutti gli altri paesi. Un paese senza prezzo (e senza riga *) non ha una tariffa fissa, quindi il metodo viene nascosto per quel paese. La tabella è vuota finché non inserisci dei prezzi.
Fixed price per: Order addebita il prezzo una sola volta. Item (price × quantity) lo moltiplica per il numero di articoli nel carrello. Vale solo per i prezzi fissi. Le tariffe in tempo reale vengono sempre calcolate per l'intero pacco.
Condizioni
Min cart weight (kg): nasconde il metodo al di sotto di questo peso del carrello. 0 significa nessun limite.
Max cart weight (kg): nasconde il metodo al di sopra di questo peso del carrello. Predefinito: 22. 0 significa nessun limite. Pacchi di Australia Post: 22 kg in Australia, 20 kg all'estero.
Minimum order amount: mostra il metodo solo quando il subtotale del carrello raggiunge questo importo. Lascia vuoto per mostrarlo sempre.
Excluded shipping classes: nasconde il metodo se un articolo del carrello appartiene a una di queste classi di spedizione di WooCommerce.
Free shipping: attiva la spedizione gratuita dall'importo indicato sotto.
Free shipping from: il subtotale del carrello da cui la spedizione è gratuita. In questo caso non viene inviata alcuna richiesta all'API.
Disponibilità senza zone di spedizione
Ignore shipping zones: offre il metodo per i paesi indicati sotto, qualunque zona corrisponda.
Countries: i paesi di destinazione per questa modalità. Lascia vuoto per usare tutti i paesi verso cui il negozio spedisce. Usato solo con Ignore shipping zones.
Avanzate
Debug log: registra i calcoli delle tariffe in WooCommerce > Status > Logs, origine «vfd-australia-post». Gli errori dell'API vengono sempre registrati. La chiave API e i codici postali dei clienti non vengono registrati.
Remove data on uninstall: se attivo, eliminando il plugin vengono cancellati le sue impostazioni, i metodi delle zone e le tariffe in cache. Disattivare il plugin non cancella mai nulla.
Come funziona al checkout
Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin controlla prima il peso del carrello, il Minimum order amount e le Excluded shipping classes. Se si applica la spedizione gratuita, la tariffa è 0 e non viene inviata alcuna richiesta ad Australia Post.
In modalità prezzi fissi il prezzo viene preso dalla tabella. Nelle modalità tariffe in tempo reale il plugin invia ad Australia Post il peso del pacco e, per le consegne nazionali, i codici postali di spedizione e di consegna e le dimensioni del pacco; per le consegne internazionali, il paese di destinazione. Una tariffa in tempo reale nazionale viene richiesta solo dopo che il cliente ha inserito un codice postale a 4 cifre. Non viene inviata alcuna richiesta se il pacco supera i limiti di Australia Post (22 kg o 105 cm in Australia, 20 kg all'estero). Il prezzo in AUD viene convertito con il tuo tasso e la GST viene rimossa dai prezzi nazionali se Remove GST è attivo.
Ogni risposta riuscita viene memorizzata nella cache per 1 ora, così lo stesso carrello non genera una nuova richiesta. Una richiesta fallita viene memorizzata nella cache per 10 minuti, perché il checkout non debba attendere Australia Post a ogni aggiornamento. Gli errori dell'API non vengono mai mostrati al cliente: il metodo viene nascosto oppure, in modalità di riserva, si usa il prezzo fisso.
Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con l'archiviazione ad alte prestazioni degli ordini di WooCommerce (HPOS).
Il plugin calcola solo tariffe. Non crea etichette di spedizione, spedizioni eParcel o MyPost Business né distinte, non traccia i pacchi e non consente ai clienti di scegliere armadietti automatici o uffici postali. Il carrello viene sempre calcolato come un unico pacco. Lettere, satchel e tariffe contrattuali (eParcel) non sono incluse.
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 Australia Post. 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 posto per il dominio. Liberalo dal tuo account vibefox.net.
Senza una chiave attiva, Australia Post non viene mostrato ai clienti al checkout. I gestori del negozio con accesso effettuato lo vedono ancora, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e provare 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 assistenza richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.
Risoluzione dei problemi
Australia Post 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 i limiti di peso del carrello, il Minimum order amount e le Excluded shipping classes. In modalità prezzi fissi, controlla che il paese o * abbia un prezzo.
Le tariffe in tempo reale non compaiono: attiva il Debug log, ricarica il checkout e apri WooCommerce > Status > Logs (origine «vfd-australia-post»). Vedrai il motivo: manca la chiave API o il codice postale di spedizione, non è ancora stato inserito un codice postale di consegna a 4 cifre, il pacco supera i limiti, manca il tasso di conversione in AUD oppure compare il messaggio di errore di Australia Post. Con Live rates, fixed price if the API gives no rate, i clienti vedono comunque il prezzo fisso mentre risolvi il problema.
Il mio negozio non è in AUD: inserisci il tasso di conversione (quante unità della tua valuta valgono un AUD) in AUD → (your currency) rate. I prezzi fissi sono sempre nella valuta del negozio.
La GST viene addebitata due volte sulla spedizione: i prezzi nazionali di Australia Post includono il 10% di GST. Se Tax status è Taxable, attiva Remove GST.
Il prezzo è troppo alto o troppo basso: controlla i pesi e le dimensioni dei prodotti e i valori predefiniti in Parcel for live rates. Con Item (price × quantity) i prezzi fissi vengono moltiplicati per il numero di articoli.
Le tariffe sembrano obsolete dopo una modifica: salva la pagina delle impostazioni. Questo cancella le tariffe di Australia Post in cache.
Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera un posto 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 tutti i dati. Per rimuoverlo, disattivalo ed eliminalo dalla pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin vengono sempre rimossi. Impostazioni, metodi di zona e tariffe in cache vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti conservano le relative righe di spedizione.
Australia Post è un marchio registrato del suo rispettivo titolare. Questo plugin non è affiliato né approvato da Australia Post.