Spedizioni extra UE (dogana)

Quando la destinazione è fuori dal territorio doganale dell’Unione Europea, la creazione della spedizione richiede la dichiarazione doganale nel blocco customsDetail.

Quando è obbligatorio

Tutti i paesi extra UE (ad esempio Svizzera, Regno Unito, Stati Uniti).
I territori speciali che fanno parte di un paese UE ma non del territorio doganale: Canarie, Ceuta, Melilla, Livigno, Campione d’Italia, Helgoland, Büsingen, Åland, Monte Athos.

Monaco, San Marino e Andorra non lo richiedono. Per le altre destinazioni il blocco è facoltativo.

Il blocco `customsDetail`


{
  "customsDetail": {
    "customsValue": { "amount": 120.00, "currency": "EUR" },
    "incoterm": "DAP",
    "dutiesPayment": "RECIPIENT",
    "contentType": "MERCHANDISE",
    "exportReason": "SALE",
    "invoiceNumber": "FT-2026-001",
    "invoiceDate": "2026-09-01",
    "exporter": { "eori": "IT01234567890", "vatNumber": "IT01234567890" },
    "importer": { "eori": null, "vatNumber": "CHE-123.456.789", "taxId": null },
    "commodities": [
      {
        "description": "Cotton T-shirt",
        "harmonizedCode": "610910",
        "quantity": 2,
        "quantityUnits": "PCS",
        "unitValue": { "amount": 25.00, "currency": "EUR" },
        "totalValue": { "amount": 50.00, "currency": "EUR" },
        "weight": { "value": 0.4, "units": "KG" },
        "countryOfManufacture": "CN",
        "sku": "TS-001"
      },
      {
        "description": "Leather belt",
        "harmonizedCode": "420330",
        "quantity": 1,
        "unitValue": { "amount": 70.00, "currency": "EUR" },
        "weight": { "value": 0.3, "units": "KG" },
        "countryOfManufacture": "IT"
      }
    ]
  }
}

Campi della dichiarazione

Campo	Obbligatorio	Valori
`customsValue`	Sì	Valore totale della merce
`commodities[]`	Sì	Almeno un articolo
`incoterm`	No	`EXW`, `FCA`, `CPT`, `CIP`, `DAP` (predefinito), `DPU`, `DDP`, `FOB`, `CFR`, `CIF`
`dutiesPayment`	No	Chi paga dazi e imposte: `SENDER`, `RECIPIENT` (predefinito), `THIRD_PARTY`
`contentType`	No	`MERCHANDISE` (predefinito), `GIFT`, `SAMPLE`, `DOCUMENTS`, `RETURN`, `REPAIR`, `PERSONAL_EFFECTS`
`exportReason`	No	`SALE` (predefinito), `GIFT`, `SAMPLE`, `RETURN`, `REPAIR`, `PERSONAL`
`invoiceNumber`, `invoiceDate`	No	Numero e data della fattura commerciale
`exporter`, `importer`	No	Codici `eori`, `vatNumber`, `taxId` di mittente e destinatario

Campi di ogni articolo

Campo	Obbligatorio	Note
`description`	Sì	Descrizione doganale, preferibilmente in inglese
`quantity`	Sì	Intero, almeno 1
`unitValue`	Sì	Valore unitario
`weight`	Sì	Peso dell’articolo
`countryOfManufacture`	Sì	Paese di origine, due lettere
`harmonizedCode`	No	Codice HS/TARIC, da 6 a 10 cifre
`quantityUnits`	No	`PCS` (predefinito), `PR`, `DOZ`, `KG`, `L`, `M`, `M2`, `M3`, `SET`
`totalValue`	No	Valore totale della riga
`sku`, `midCode`	No	Codice articolo e codice del produttore

customsValue.amount deve corrispondere alla somma dei valori degli articoli, con una tolleranza dell’1% o di 1 unità di valuta. In caso contrario la richiesta è respinta con 422.

Ricerca dei codici doganali – `GET /taric`


curl "https://demo.spedisci.online/api/2026-09/taric?q=t-shirt&limit=10" \
    -H "Authorization: Bearer <access_token>"

q richiede almeno 3 caratteri; limit vale 25 se omesso, al massimo 100.


{
  "data": [
    { "code": "610910", "description": "T-shirt e canottiere, di cotone", "descriptionEn": "T-shirts, singlets and other vests, of cotton" }
  ]
}

Cosa riceve il corriere

La dichiarazione è conservata sulla spedizione (la ritrovi in customsDetail nella risposta) e trasmessa al corriere:

Corriere	Dati trasmessi
FedEx	Un articolo per riga con descrizione, codice HS, origine, quantità, valori, peso e SKU; valore doganale totale; pagamento dei dazi; fattura commerciale con incoterm e motivo dell’esportazione; codici EORI e partita IVA
DHL Express	Dichiarazione di esportazione con un articolo per riga; fattura; incoterm; valore dichiarato; EORI e partita IVA di mittente e destinatario
Poste Delivery Business	Articoli con codice doganale, origine, quantità, valore e peso; tipo di contenuto; valore totale
Spring GDS	Prodotti con descrizione, codice HS, quantità, valore, origine e SKU; valore dichiarato
UPS	Fattura commerciale con numero, data, motivo dell’esportazione, incoterm, valuta e un prodotto per riga

Con FedEx, dutiesPayment uguale a THIRD_PARTY viene trattato come RECIPIENT.

Spedizioni create dal pannello o dagli ordini

Per le spedizioni extra UE create dal pannello o dagli ordini dei negozi online, la dichiarazione viene compilata in automatico:

dalle righe dell’ordine, completate con i dati del catalogo prodotti: descrizione doganale, codice HS, paese di origine e valore dichiarato;
in mancanza di un ordine, da contenuto, valore merce e codice Taric indicati nella spedizione.

Per dichiarazioni precise, completa nel catalogo la descrizione doganale, il codice HS e il paese di origine di ogni prodotto.