Guida Utente

Tutto quello che serve per configurare e usare CapZone Italia

Indice
  1. 1. Introduzione
  2. 2. Installazione
  3. 3. Step 1: Scegli il corriere
  4. 4. Step 2: Configura zone e tariffe
  5. 5. Step 2b: Ricerca e aggiunta CAP
  6. 6. Step 3: Attiva nel checkout
  7. 7. Dashboard
  8. 8. Gestione Zone
  9. 9. Ordini e Statistiche
  10. 10. Piano e Abbonamento
  11. 11. Risoluzione problemi

1. Introduzione

CapZone Italia e l'app Shopify che ti permette di gestire sovrapprezzi di spedizione automatici per le destinazioni disagiate italiane: isole maggiori (Sicilia e Sardegna), zone remote della penisola e localita speciali come Livigno, Campione d'Italia e la laguna di Venezia.

L'app funziona tramite una Shopify Function che si attiva direttamente al checkout: quando il cliente inserisce il suo indirizzo, il CAP viene confrontato con la tua configurazione e il sovrapprezzo viene aggiunto automaticamente alle tariffe di spedizione.

ℹ️
A chi serve?Se vendi in tutta Italia e il tuo corriere applica supplementi per isole o zone disagiate, CapZone ti permette di recuperare automaticamente questi costi senza intervento manuale su ogni ordine.

Vantaggi principali:

  • Funziona su tutti i piani Shopify (Basic, Shopify, Advanced, Plus)
  • Database di oltre 4.700 CAP italiani precaricato
  • Supporto corrieri BRT, GLS, SDA, DHL + configurazione generica
  • Esecuzione in meno di 5ms — nessun rallentamento al checkout
  • Non modifica il tema del negozio — opera esclusivamente al checkout

2. Installazione

Installa CapZone Italia dallo Shopify App Store. Dopo l'installazione, l'app ti guidera attraverso 3 semplici passaggi per configurare le zone tariffarie.

ℹ️
L'installazione richiede i permessi per leggere e scrivere le personalizzazioni di spedizione del tuo negozio. CapZone non accede ai dati dei clienti.

Una volta installata, verrai reindirizzato automaticamente al wizard di onboarding. Il processo completo richiede meno di 5 minuti.

3. Step 1: Scegli il corriere

1Seleziona il tuo corriere

Il primo passaggio ti chiede di selezionare il corriere che usi per le spedizioni. In base alla scelta, l'app carichera automaticamente i CAP delle zone disagiate specifici di quel corriere.

Step 1 — selezione corriere: BRT, GLS, SDA, Generico
Seleziona il corriere per caricare automaticamente le zone disagiate

Corrieri disponibili:

  • BRT (Bartolini) — CAP disagiati BRT precaricati
  • GLS — CAP disagiati GLS precaricati
  • SDA — CAP disagiati SDA precaricati
  • Generico — Nessun CAP precaricato, configuri tu manualmente
⚠️
Non trovi il tuo corriere?Seleziona "Generico" e aggiungi manualmente i CAP delle zone disagiate nel passaggio successivo. Puoi cercare i CAP per nome del comune o per codice.

4. Step 2: Configura zone e tariffe

2Imposta prezzi per zona

In questo passaggio configuri le 3 zone tariffarie e il sovrapprezzo per ciascuna. Ogni zona mostra i CAP gia assegnati, raggruppati per regione e provincia.

Step 2 — editor zone con 3 card tariffarie e CAP raggruppati
Le 3 zone tariffarie con i CAP raggruppati per regione

Le 3 zone:

  • Isole Maggiori — Sicilia e Sardegna (tutti i CAP delle due regioni)
  • Zone Disagiate — Localita remote della penisola (CAP specifici per corriere)
  • Zone Speciali — Livigno (23030), Campione d'Italia (22060), Venezia laguna (30100-30176)

Per ogni zona, inserisci il sovrapprezzo in euro. Questo importo viene aggiunto alla tariffa di spedizione base al checkout.

Corretto
Imposta prezzi coerenti con i supplementi del tuo corriere (es. Isole Maggiori: 5-15 EUR)
Sbagliato
Non lasciare i prezzi a 0 EUR — la zona non avrebbe effetto al checkout
⚠️
Prezzi e valutaI sovrapprezzi devono essere inseriti in euro (EUR). Se il tuo negozio usa una valuta diversa, Shopify converte automaticamente l'importo al checkout.

5. Step 2b: Ricerca e aggiunta CAP

Nella parte superiore dell'editor zone c'e una barra di ricerca che ti permette di trovare qualsiasi CAP italiano per codice o per nome del comune.

Come funziona:

  • Digita un CAP (es. "09100") o un nome di comune (es. "Cagliari")
  • Se il CAP e gia in una zona, la ricerca mostra solo quella zona e espande automaticamente la regione corrispondente
  • Se il CAP non e in nessuna zona, appare un messaggio con pulsanti per aggiungerlo alla zona desiderata
✅
Aggiunta CAPQuando aggiungi un CAP a una zona, la ricerca si cancella automaticamente e la vista si posiziona sulla zona e regione corretta con un'animazione verde di conferma.

6. Step 3: Attiva nel checkout

3Pubblica la configurazione

L'ultimo passaggio mostra un riepilogo della tua configurazione: quante zone hai configurato, quanti CAP sono coperti e le tariffe impostate.

Clicca il pulsante "Attiva CapZone" per:

  • Salvare la configurazione come metafield sul tuo negozio
  • Creare la personalizzazione di spedizione (Delivery Customization)
  • Attivare la Shopify Function nel tuo checkout
✅
Tutto pronto!Dopo l'attivazione, i sovrapprezzi vengono applicati automaticamente a tutti gli ordini con CAP corrispondenti. Non devi fare nient'altro.
⚠️
Verifica le tariffeDopo l'attivazione, fai un ordine di prova con un CAP disagiato (es. 09100 Cagliari) per verificare che il sovrapprezzo venga applicato correttamente al checkout.

7. Dashboard

Dopo il setup iniziale, la dashboard e la tua schermata principale. Da qui puoi monitorare lo stato dell'app e accedere a tutte le sezioni.

Dashboard CapZone con stato, statistiche e zone tariffarie
La dashboard mostra lo stato dell'app, le statistiche e le zone configurate

Sezioni della dashboard:

  • Stato — Indica se CapZone e attivo nel checkout
  • Statistiche — Ordini totali, ordini con sovrapprezzo e importo recuperato
  • Zone tariffarie — Tabella riepilogativa con zona, numero CAP e sovrapprezzo configurato
  • Ultimi ordini — Gli ordini recenti con sovrapprezzo applicato

8. Gestione Zone

Dalla voce "Zone & CAP" nel menu laterale puoi modificare le zone tariffarie in qualsiasi momento dopo il setup iniziale.

L'editor e lo stesso usato durante l'onboarding: puoi cambiare i sovrapprezzi, aggiungere o rimuovere CAP, e usare la barra di ricerca.

ℹ️
Modifiche immediateOgni modifica salvata si riflette immediatamente al checkout. Non serve riattivare o ripubblicare nulla.

9. Ordini e Statistiche

La sezione "Ordini" nel menu laterale mostra tutti gli ordini in cui e stato applicato un sovrapprezzo. Per ogni ordine puoi vedere:

  • Numero e data dell'ordine
  • CAP di destinazione
  • Zona tariffaria applicata (Isole Maggiori, Zone Disagiate o Speciali)
  • Importo del sovrapprezzo
ℹ️
Gli ordini vengono annotati automaticamente tramite webhook. L'annotazione include la zona tariffaria e il sovrapprezzo nelle note dell'ordine su Shopify.

10. Piano e Abbonamento

CapZone Italia offre un unico piano con tutte le funzionalita incluse:

  • 14 giorni di prova gratuita
  • 9 EUR/mese oppure 90 EUR/anno (risparmi 18 EUR)
  • Zone e CAP illimitati
  • Supporto via email

Puoi gestire il tuo abbonamento dalla sezione "Piano" nel menu laterale. La fatturazione passa direttamente da Shopify — non devi inserire dati di pagamento separati.

ℹ️
La cancellazione e immediata e senza vincoli. Puoi disinstallare l'app in qualsiasi momento da Impostazioni → App e canali di vendita nel tuo pannello Shopify.

11. Risoluzione problemi

Ecco i problemi piu comuni e come risolverli:

❌
ProblemaIl cliente ordina da un CAP disagiato ma la tariffa di spedizione non cambia.

Soluzioni:

  • Verifica che il CAP sia effettivamente assegnato a una zona (usa la barra di ricerca)
  • Controlla che la zona abbia un sovrapprezzo maggiore di 0 EUR
  • Assicurati che CapZone sia attivo (controlla lo stato nella dashboard)
  • Prova a svuotare la cache del browser e ripetere il checkout

Non hai trovato la soluzione al tuo problema?

Contatta il supporto