Shipping Cost by Zip Code — Spese di spedizione per CAP

Shipping Cost by Zip Code è un modulo PrestaShop che consente di applicare spese di spedizione precise in base al CAP (codice postale) del cliente. Puoi creare zone postali personalizzate (illimitate), associare CAP (valori singoli o intervalli numerici) e definire tariffe per corriere con fasce per peso o fasce per importo del carrello.

A differenza del calcolo nativo per zone/paesi, questa soluzione è ideale quando i costi variano molto tra centro città, aree rurali, isole, zone di montagna, territori d’oltremare, ecc. Il modulo non aggiunge corrieri: adegua le tariffe dei corrieri già esistenti durante il checkout, in base al CAP.

Punti di forza:

• Zone postali illimitate (CAP singoli e intervalli numerici)
• Tariffe per corriere + fasce illimitate (per peso o per totale carrello)
• Spedizione gratuita (per fascia, per zona o sopra una soglia)
• Import / export CSV per configurazione massiva
• Sistema di priorità in caso di sovrapposizione tra zone
• Multistore, multilingua, nessun override

---

Panoramica

Di default PrestaShop calcola i costi di spedizione in base a zone geografiche e paesi, ma spesso questo è troppo poco preciso. Un negozio può aver bisogno di tariffe diverse in funzione della distanza, dell’accessibilità o dei costi reali del trasporto, anche all’interno dello stesso paese.

Con Shipping Cost by Zip Code imposti regole a livello di CAP:

1. Crei una zona postale (es. “Centro città”, “Zona montagna”, “Isole/oltremare”).
2. Aggiungi i CAP (lista) oppure intervalli (es. 75001 → 75020).
3. Configuri la tariffazione per corriere con logica per peso o per importo.

Se nessuna zona corrisponde al CAP, il comportamento è configurabile: applicare le tariffe standard di PrestaShop oppure bloccare la spedizione (corrieri nascosti).

---

Funzionalità

Zone di consegna per CAP

• Creazione di zone postali illimitate
• Formati CAP:
  • CAP singoli (un CAP o una lista)
  • Intervalli numerici (es. 75001–75020)
• Più paesi possono essere gestiti nella stessa zona
• Attivazione/disattivazione delle zone
• Opzione “Spedizione disattivata”: nasconde i corrieri al checkout per una zona specifica
• Sistema di priorità per gestire zone sovrapposte

Tariffe avanzate per corriere

• Tariffe per corriere e per zona
• Modalità di calcolo:
  • Peso (kg)
  • Prezzo (totale carrello)
• Fasce illimitate (0–5, 5–10, ecc.)
• Importi fissi o tariffe in percentuale
• Spedizione gratuita:
  • per fascia
  • per zona / corriere
  • automaticamente sopra una soglia del carrello
• Opzione “Tutti i corrieri”: applica una regola a tutti i corrieri in un’unica configurazione

Produttività in back office

• Interfaccia integrata nel back office sotto Spedizione
• Lista zone con ricerca / filtri / ordinamento e gestione posizione (drag & drop)
• Editor “tutto-in-uno”: impostazioni generali + CAP + tariffe nella stessa pagina
• Import CSV con report errori
• Export CSV della configurazione completa
• File CSV di esempio incluso

Approccio tecnico

• Compatibile con PrestaShop 1.7.7, 8.x e 9.x
• Compatibile multistore
• Supporto multilingua (nomi zone traducibili)
• Nessun override del core PrestaShop
• Utilizzo di id_carrier_reference (robusto anche se i corrieri cambiano)
• Query ottimizzate + cache in memoria (matching CAP → zona)

---

Requisiti

• PrestaShop: minimo 1.7.7.0 (compatibile 1.7.7 → 9.x)

Limitazione importante: sono supportati solo CAP numerici. I paesi con codici postali alfanumerici (es. Regno Unito, Canada, Paesi Bassi) non sono supportati.

---

Installazione

Metodo 1 — via Back Office (consigliato)

1. Vai in Moduli > Gestione moduli
2. Clicca su Carica un modulo
3. Seleziona wepresta_shipping_cost_by_zip.zip
4. Attendi il completamento dell’installazione
5. Clicca su Configura

Metodo 2 — via FTP

1. Decomprimi l’archivio
2. Carica la cartella wepresta_shipping_cost_by_zip/ in /modules/
3. Nel back office: Moduli > Gestione moduli
4. Trova il modulo e clicca Installa
5. Clicca Configura

Cosa fa l’installazione

• Crea 4 tabelle: wep_zip_zone, wep_zip_zone_lang, wep_zip_range, wep_zip_delivery
• Registra gli hook necessari
• Aggiunge una scheda “Shipping by Zip Code” sotto Spedizione
• Inizializza una configurazione predefinita

Nota: il modulo non crea corrieri. Modifica i costi dei corrieri esistenti in base al CAP.

---

Configurazione

Accesso:

• Moduli > Gestione moduli > Configura
• oppure Spedizione > Shipping by Zip Code

Impostazioni globali

• Abilita modulo: attiva/disattiva il calcolo per CAP
• Comportamento predefinito (se nessuna zona corrisponde):
  • Usa tariffe standard: PrestaShop applica le tariffe native (consigliato per iniziare)
  • Blocca spedizione: i corrieri non vengono mostrati al checkout

---

Gestione delle zone

Accesso: Spedizione > Shipping by Zip Code

Creare una zona

1. Clicca Aggiungi nuova zona
2. Compila:
   • Nome zona (multilingua)
   • Attiva (Sì/No)
   • Spedizione disattivata (Sì/No)
3. Clicca Salva

Aggiungere CAP

Nell’editor della zona, sezione CAP:

1. Seleziona il paese
2. Aggiungi:
   • Lista di CAP (separati da virgole):
     • 75001, 75002, 75003
   • oppure un intervallo:
     • da 75001 a 75020
3. Clicca + Aggiungi

Sono supportati solo CAP numerici.

Configurare corrieri e tariffe

Nella sezione Corrieri & tariffe:

1. Seleziona un corriere (o Tutti i corrieri)
2. Scegli il tipo:
   • Peso (kg) o Prezzo (totale carrello)
3. Definisci la fascia:
   • min / max
4. Imposta il costo
5. Opzioni:
   • Percentuale (se attiva, il costo è una % del carrello)
   • Spedizione gratuita
   • Gratuita da (soglia carrello)
6. Clicca + Aggiungi regola tariffaria

---

Import / export CSV

Formato CSV

• Separatore: punto e virgola ;
• Codifica: UTF-8

Colonne principali:

• zone_name (obbligatorio)
• country_iso (obbligatorio)
• postal_code_from (obbligatorio)
• postal_code_to (opzionale: vuoto = CAP singolo)
• carrier_reference (obbligatorio)
• calculation_type: weight / price (obbligatorio)
• range_from, range_to, price (obbligatori)
• is_percentage, is_free, free_from_amount (opzionali)

Importare

1. Spedizione > Shipping by Zip Code
2. Importa CSV
3. Seleziona il file
4. Importa e consulta il report (OK / aggiornati / errori)

Comportamenti utili:

• Una zona esistente con lo stesso nome viene riutilizzata (niente duplicati)
• Gli intervalli esistenti non vengono duplicati
• Una regola tariffaria identica viene aggiornata

Esportare

• Clicca Esporta CSV
• Il file scaricato usa lo stesso formato dell’import

---

Sistema di priorità

Ogni zona ha una posizione (ordinabile). Se un CAP corrisponde a più zone, viene usata la zona con la posizione più bassa.

Ordine di matching:

1. Corrispondenza esatta (CAP singolo)
2. Corrispondenza per intervallo
3. In caso di più corrispondenze, decide la posizione della zona

---

Multistore

Il modulo è compatibile multistore:

• Zone e tariffe vengono mostrate in base al contesto (tutti i negozi / gruppo / negozio)
• Una zona è associata al contesto negozio attivo quando viene creata
• Per applicare la stessa configurazione a più negozi: esporta/importa via CSV

---

Comportamento lato cliente

Al checkout il modulo è trasparente:

1. Il cliente inserisce l’indirizzo (con CAP)
2. PrestaShop mostra i corrieri
3. Il modulo adegua i costi in base alla zona corrispondente

Il cliente vedrà:

• costi adattati al proprio CAP
• potenzialmente meno corrieri se una zona è “non consegnabile”
• spedizione gratuita se configurata

---

Casi d’uso comuni

Territori d’oltremare / isole / zone remote

Crea una zona dedicata (es. 97100 → 97490) con costi più elevati rispetto alla terraferma.

Spedizione gratuita locale

Crea una zona “locale” (CAP vicini) con spedizione gratuita, mantenendo tariffe standard altrove.

Bloccare la spedizione in aree non servite

Crea una zona “non consegnabile” e attiva Spedizione disattivata per nascondere i corrieri.

Costi in percentuale

Utile per carrelli di valore elevato: es. 3% del totale, poi gratuita oltre una soglia.

---

FAQ

Il modulo crea corrieri?

No. Usa i corrieri esistenti e modifica il calcolo dei costi in base al CAP.

Cosa succede se nessuna zona corrisponde?

In base alle impostazioni globali:

• PrestaShop applica le tariffe standard
• oppure la spedizione viene bloccata (corrieri nascosti)

Supporta CAP alfanumerici (UK, CA)?

No, solo CAP numerici.

Posso usarlo con un One Page Checkout?

Sì. Il costo viene calcolato lato server tramite getOrderShippingCost(), compatibile con checkout standard e OPC.

---

Risoluzione problemi

Il modulo non appare nel menu Spedizione

• Verifica che sia installato e attivo
• Svuota cache: Parametri avanzati > Prestazioni > Svuota cache
• Verifica permessi dipendenti

I costi non cambiano al checkout

• Modulo attivo?
• Zona corrispondente al CAP e attiva?
• Regole configurate per quella zona + corriere?
• Fasce che coprono peso/importo del carrello?
• Cache svuotata?

Un corriere scompare al checkout

• Zona impostata su Spedizione disattivata
• Comportamento predefinito = Blocca spedizione e nessuna zona corrisponde
• Nessuna regola tariffaria per quel corriere nella zona trovata

Changelog

Versione 1.0.0

• Zone postali illimitate
• CAP singoli + intervalli numerici
• Tariffe per peso o per importo
• Percentuale sul totale carrello
• Spedizione gratuita (per fascia / soglia)
• Blocco spedizione per zona
• Priorità tra zone
• Import / export CSV
• Multistore + multilingua
• Compatibilità PrestaShop 1.7.7 → 9.x

---

Supporto

• Supporto tramite la pagina del modulo (PrestaShop Addons) o l’area cliente WePresta
• Tempo di risposta indicativo: 24–48 ore lavorative

Prima di contattare il supporto, prepara:

• versione PrestaShop
• versione PHP
• descrizione chiara del problema
• screenshot
• log PrestaShop se disponibili

---

Licenza

Academic Free License (AFL 3.0).
Copyright © WePresta. Tutti i diritti riservati.