Spedizione
Prodotti
| Categoria accise | Formato | Bottiglie |
|---|
Risultato
Predefinito
Righe = fino a N bottiglie. Celle a righe = servizio non disponibile per quello scaglione.
Accise per paese (€ a bottiglia di riferimento)
Fee RF = rappresentante fiscale, per ogni 0,75 L. Paesi non in elenco: nessuna accisa.
Come funziona
CarrelloWine Suite, Shopify, sito cantina
→
POST /v1/preventivopaese + bottiglie per categoria e formato
→
IWS Tariffelistino della chiave, tabella accise
→
Rispostaspedizione + accise = totale
Chiavi API
Una per cantina o app. La chiave decide il listino.POST
Header
Content-Type: application/json
X-Api-Key: sk_… chiave del cliente, solo da server (mai nel browser)
Prova
Chiamata reale con il listino sceltoRichiesta
Risposta
Premi Invia.
Regole di calcolo
- Formati in bottiglie da 0,75: Magnum 2, 3 L 6, 6 L 12.
- Scaglione = primo con almeno quelle bottiglie (6, 9, 12, 18…).
- Veloce o pallet non disponibili: si usa lo Standard e c'è un avviso.
- Extra-UE: + bolle doganali del listino. Prezzi senza IVA.
- Accise = litri ÷ bottiglia di riferimento × tariffa del paese, + fee RF ogni 0,75 L.
Errori
| Codice | Quando |
|---|---|
| 400 | Dati non validi o destinazione non servita. Il motivo è in errore. |
| 401 | Chiave mancante o errata. |
| 200 | Controlla comunque avvisi: es. servizio veloce sostituito. |
{ "errore": "Nessuna tariffa per BR nel listino \"Base (Piemonte 2026)\"" }