Shipping Zone

L'oggetto ShippingZone definisce le regole geografiche, fiscali e logistiche applicate a un prodotto specifico in base alla posizione del cliente. Ogni elemento del carrello (CartItem) contiene il proprio array di zone per permettere al motore di webround.com di calcolare spedibilità, tasse e sovrapprezzi in tempo reale.

Definizione ShippingZone

Proprietà	Tipo	Descrizione
productId	string (UUID)	ID del prodotto associato a questa regola di zona.
zoneId	string (UUID)	Identificativo univoco della zona logistica/geografica.
label	string	Nome descrittivo della zona (es. "Zona Italia", "Francia").
countryCode	string	Codice ISO del paese (es. IT, FR).
taxRate	number	L'aliquota IVA applicata al prodotto quando spedito in questo paese.
surchargePricing	Object	Mappa delle valute contenente i costi extra (base e percentage) per la zona.

Esempio di oggetto

{
    "productId": "d6128604-7b88-4079-9b91-a3a21584376c",
    "zoneId": "0f27b303-4fa6-4469-948d-61a4f7103a66",
    "label": "Zona Italia",
    "countryCode": "IT",
    "surchargePricing": {},
    "taxRate": 22
}

Dettaglio Surcharge Pricing

L'oggetto surchargePricing è pensato per zone che prevedono spese doganali o dazi. Non rappresenta un costo di spedizione, quanto più, un sovraccarico sul prezzo determinato da eventuali spese aggiuntive oltre quelle del metodo di spedizione.

"surchargePricing": {
    "eur": {
        "base": 5.00,
        "percentage": 0
    }
}

Corrispondenza Automatica

Quando l'utente imposta un indirizzo di spedizione, il sistema scansiona l'array shippingZones di ogni articolo nel carrello. Cerca il countryCode corrispondente all'indirizzo per aggiornare istantaneamente i totali e verificare la disponbilità di spedizione verso quel paese.