# Spedizione Refrigerata e Secca PrestaShop: installazione e configurazione

> Presentazione Il modulo è pensato per i negozi che vendono prodotti secchi e refrigerati. Il cliente mantiene un solo carrello, paga una volta e riceve un solo ordine con un…

- Pagina: <https://www.datafirefly.com/it/documentation/dfcoldchain/>
- Lingua: it
- Aggiornato il: 2026-10-12
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfcoldchain/index.md), [en](https://www.datafirefly.com/en/documentation/dfcoldchain/index.md), [es](https://www.datafirefly.com/es/documentation/dfcoldchain/index.md), [de](https://www.datafirefly.com/de/documentation/dfcoldchain/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcoldchain/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcoldchain/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcoldchain/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Presentazione

Il modulo è pensato per i negozi che vendono prodotti secchi e refrigerati. Il cliente mantiene un solo carrello, paga una volta e riceve un solo ordine con un unico importo di spedizione. L'importo dipende dalla zona (paese e CAP) e dal contenuto del carrello: solo secco, solo refrigerato o entrambi. Il refrigerato viene rifiutato nelle zone che la catena del freddo non raggiunge. Dopo l'ordine, il modulo lo divide in colli, uno per tipo, ciascuno con il suo corriere e il suo tracciamento.

Il back-office del modulo è tradotto in inglese, spagnolo, francese e portoghese. Con un back-office in italiano appare in inglese: i nomi dei campi qui sotto sono quindi indicati in inglese.

## Installazione

1. In **Moduli > Gestione moduli**, fate clic su **Carica un modulo** e inviate `dfcoldchain-1.0.2.zip`.
2. Il modulo crea il suo corriere, chiamato **Envío estándar**. Rinominatelo in **Spedizione > Corrieri** se serve: il modulo segue il corriere anche dopo la modifica.
3. Verificate che il corriere abbia una **regola fiscale**. All'installazione il modulo copia quella del corriere predefinito.
4. Aprite la configurazione del modulo e iniziate dalla scheda **Diagnostics**.

All'installazione vengono create quattro zone di esempio per Spagna e Portogallo (una città, le isole e le città autonome, Madeira e Azzorre, il continente). Adattatele o eliminatele prima della messa online.

## Zone e tariffe

Le zone si leggono dall'alto in basso, prima il numero di priorità più basso. Si applica la prima zona attiva il cui paese e CAP corrispondono all'indirizzo. Una destinazione senza zona corrispondente non riceve questo corriere e il refrigerato vi viene rifiutato.

### Campi di una zona

- **Zone name** e **Active**.
- **Priority**: mettete le zone precise (una città, delle isole) prima di quelle ampie (un intero paese).
- **Countries (ISO)**: uno o più codici separati da virgole, ad esempio `IT,SM`.
- **Postcodes**: vuoto per tutto il paese, altrimenti un codice per riga o separati da virgole.
- **Free from**: soglia di spedizione gratuita, 0 per nessuna.
- **Dry only**, **Chilled only**, **Dry and chilled**: tariffe IVA inclusa nella valuta predefinita.
- **Chilled products can be delivered**: se disattivato, ogni carrello con refrigerato viene bloccato in questa zona.
- **Split the order into one shipment per class**: se disattivato, l'ordine parte in una sola spedizione (consegna locale, ad esempio).

### Sintassi dei CAP

- valore esatto: `20121`
- intervallo: `20121-20162` (i due estremi devono avere la stessa lunghezza), oppure `20121..20162`
- prefisso: `07*`
- codice con trattino: `1000-001` viene letto come codice esatto. Un intervallo sulle prime 4 cifre si scrive `4000-4999`.

### Importo mostrato

Le tariffe si inseriscono IVA inclusa. Il modulo calcola l'imponibile con l'aliquota del corriere per l'indirizzo del cliente, quindi l'importo mostrato è sempre quello inserito, qualunque sia il paese. Gli importi vengono convertiti nella valuta del carrello.

## Prodotti refrigerati

Nella scheda **Chilled products**, selezionate le categorie interessate (Ctrl o Cmd per più di una) e attivate **Include subcategories** se serve. Un prodotto è refrigerato se appartiene a una di queste categorie, anche se non è la sua categoria predefinita. Tutto il resto è secco.

In **Product exceptions** potete cercare un prodotto per nome, riferimento o ID e forzarlo come refrigerato o secco. Le modifiche vengono salvate subito.

## Colli dopo l'ordine

Quando un ordine viene effettuato con il corriere del modulo in una zona che divide le spedizioni, il modulo crea un collo per ogni tipo presente: prima il refrigerato, poi il secco. Nella scheda **Shipments** impostate per ogni tipo:

- il **nome del corriere mostrato al cliente** (di default SEUR Frío per il refrigerato e Transporte estándar per il secco);
- l'**URL di tracciamento**, dove `@` viene sostituito dal numero di tracciamento.

In una zona senza divisione, l'ordine ha una sola spedizione con il nome e l'URL di tracciamento del corriere dell'ordine.

## Checkout

- **Hide the other carriers** quando quello del modulo è disponibile: il cliente vede un solo importo.
- **Carriers always kept**: ad esempio il ritiro in negozio. Restano visibili e non vengono bloccati dalla restrizione del refrigerato.
- **Free shipping threshold computed after vouchers**: di default la soglia si calcola sul totale prodotti IVA inclusa, prima degli sconti.
- **Notice on chilled product pages**.
- **Postcode checker in the cart** quando contiene refrigerato.
- **Button to remove chilled products** quando l'indirizzo non è servito.

### Come funziona il blocco

Quando il carrello contiene refrigerato e l'indirizzo di consegna è fuori zona, il modulo rimuove le opzioni di spedizione dalla lista che PrestaShop costruisce per tutti i checkout. Senza opzione di spedizione l'ordine non può essere pagato. Il cliente vede un messaggio con i prodotti interessati, mostrato con l'hook `displayBeforeCarrier` del checkout nativo e inserito via JavaScript nei checkout in una pagina che ricaricano i corrieri in AJAX.

Per un cliente ospite, il carrello viene stimato con il paese del negozio, o con il CAP inserito nel verificatore del carrello, finché l'indirizzo non viene inserito al checkout.

### Testi per il cliente

L'avviso della scheda prodotto e il messaggio di blocco si modificano per lingua nella scheda **Checkout**.

## Simulatore

La scheda **Simulator** mostra con le zone salvate la zona applicata, l'importo e i colli previsti per un paese, un CAP, un totale prodotti e un contenuto (secco, refrigerato o entrambi). Salvate prima se avete modificato le zone.

## Diagnostica

La scheda **Diagnostics** verifica che il corriere esista e abbia una regola fiscale, che le soglie native di spedizione gratuita siano disattivate (**Spedizione > Preferenze**), che non si aggiungano costi di gestione, che i prodotti refrigerati siano definiti e che nessun prodotto sia limitato a corrieri. Elenca anche i moduli che agiscono sugli stessi punti. Il pulsante **Create the carrier again** ripara un'installazione il cui corriere è stato eliminato.

## Ordini

- **Scheda ordine**: un pannello Shipments mostra ogni collo con prodotti, corriere, numero e URL di tracciamento, e stato (To prepare, Shipped, Delivered).
- **Email al cliente**: spuntate la casella prima di salvare un collo spedito per inviarne il contenuto e il link di tracciamento. Modello `dfcoldchain_shipped` nella cartella `mails/` del modulo, in inglese, spagnolo, francese e portoghese. Per i clienti italiani viene usato il modello inglese.
- **Distinta di preparazione**: una pagina stampabile per collo, con fascia CHILLED per il freddo.
- **Rebuild shipments**: da usare dopo aver modificato le righe dell'ordine, finché nessun collo è spedito.
- **Avviso**: se un ordine contiene refrigerato per una zona fuori dalla catena del freddo, un messaggio rosso lo segnala.
- **Lato cliente**: quando l'ordine ha più colli o un numero di tracciamento, compaiono nel dettaglio ordine del suo account.

## Limiti noti

- Il modulo non genera etichette: createle presso i vostri corrieri o nei loro moduli.
- Un prodotto limitato a certi corrieri può far dividere a PrestaShop il carrello in più ordini. Rimuovete queste restrizioni.
- Una soglia nativa di spedizione gratuita (**Spedizione > Preferenze**) prevale sulle zone del modulo.
- In multinegozio zone e impostazioni sono comuni a tutti i negozi.
- Un pack nativo viene classificato in base al prodotto pack stesso, non ai suoi componenti.
- Ogni checkout in una pagina ha il suo markup: provate un ordine completo come ospite e come cliente registrato su una copia del negozio prima della messa online.