Tax Zone

L'oggetto TaxZone definisce le regole di tassazione applicabili a un prodotto in base al paese di destinazione. È l'entità fondamentale che permette a webround.com di calcolare correttamente l'IVA (o altre imposte sulle vendite) per ogni singolo articolo nel carrello.

Definizione TaxZone

Proprietà	Tipo	Descrizione
id	string (UUID)	Identificativo univoco della regola fiscale.
countryCode	string	Codice ISO del paese (es. IT, FR) a cui si applica l'aliquota.
rate	number	La percentuale dell'aliquota fiscale (es. 22 per l'IVA italiana).
isDefault	boolean	Se true, indica che questa è l'aliquota predefinita per il prodotto quando non è ancora stata definita una destinazione.

---

Utilizzo nel Motore Fiscale

Le Tax Zones rappresentano l'elenco di tutti i luoghi configurati per la corretta applicazione dell'aliquota fiscale. Il sistema le utilizza per garantire la conformità normativa durante il checkout:

1. Mappatura Fiscale: Ogni prodotto può avere aliquote diverse a seconda del paese (es. 22% in Italia, 20% in Francia).
2. Calcolo Dinamico: Non appena l'utente specifica il paese di spedizione, il sistema filtra l'array taxZones per trovare il countryCode corrispondente e aggiorna il totale lordo dell'articolo.
3. Integrazione Gateway: Questi dati sono essenziali per comunicare correttamente gli importi delle tasse a provider di pagamento come Stripe, garantendo che le fatture generate siano valide.

Esempio di oggetto

{
    "id": "84f26098-4823-4f3c-82d0-44733e4d9d5d",
    "countryCode": "IT",
    "rate": 22,
    "isDefault": true
}

Esenzione IVA

Se il profilo dell'utente ha la proprietà vatExempt: true (come nel caso di acquisti Business intra-UE), il motore di calcolo ignorerà il valore di rate fornito dalla Tax Zone per azzerare l'imposta.