ForHosting KIT · Strumenti per sviluppatori

Calcoli il dazio doganale per valore e categoria

Questo strumento applica al valore dichiarato della spedizione la percentuale della categoria presente nella tabella fornita da Lei.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Restituisce l'aliquota trovata e il dazio stimato, rendendo il calcolo verificabile e ripetibile. Non classifica le merci, non consulta tariffe ufficiali, non aggiunge imposte e non stabilisce esenzioni. Utilizzi dati pertinenti alla spedizione e consideri il risultato una stima, non un accertamento doganale.

Prepari il valore dichiarato e la tabella

Parta dal valore dichiarato da usare come base nel Suo scenario. Lo inserisca come numero non negativo, senza simboli di valuta o separatori delle migliaia. Fornisca poi una tabella in cui ogni riga presenti un nome di categoria univoco e un rate_percent non negativo. La categoria della spedizione deve corrispondere esattamente a una riga, comprese maiuscole e spazi. La corrispondenza esatta impedisce di scegliere tacitamente una classificazione simile ma giuridicamente diversa. Le aliquote vanno espresse in percentuale: rate_percent pari a 7.5 indica sette e mezzo per cento, non 0.075. Mantenga tutti gli importi nella stessa valuta, perché non viene consultato alcun cambio. Prima del calcolo verifichi che valore, classificazione e tabella siano adatti alla destinazione e alla data. Valutazione doganale, origine preferenziale ed esenzioni possono modificare base o percentuale applicabile.

Comprenda il calcolo e il risultato

Lo strumento cerca la categoria esatta nella tabella, ne preleva la percentuale e moltiplica il valore dichiarato per l'aliquota divisa per cento. La relazione è: dazio stimato uguale valore dichiarato per rate_percent diviso cento. Il risultato comprende declared_value, categoria, duty_rate_percent ed estimated_duty, così un revisore può verificare i dati senza ricostruire la ricerca. Non viene imposto alcun arrotondamento: si conserva l'aritmetica deterministica senza fingere che tutte le autorità adottino la stessa convenzione decimale. Il Suo processo potrà arrotondare secondo la norma applicabile. Aliquota zero o valore zero producono dazio zero. Se manca la categoria richiesta, viene restituito un errore di input invece di presumere un'aliquota standard. Anche le categorie duplicate vengono rifiutate perché rendono ambigua la tabella, persino quando le percentuali coincidono.

Inserisca la stima nel costo finale

Usi il risultato come componente del costo finale, non come importo definitivo dovuto in dogana. Gli oneri reali possono includere IVA all'importazione, accise, misure antidumping, intermediazione, gestione e altri addebiti. Alcune autorità calcolano su un valore doganale comprensivo di trasporto, assicurazione, royalties o rettifiche, anziché sulla sola fattura. Origine preferenziale e soglie minime possono ridurre l'onere, ma richiedono dati non raccolti qui. Per la pianificazione conservi la tabella insieme alla stima. Nei cataloghi calcoli per articolo o classificazione e sommi solo dopo aver verificato il trattamento per riga o spedizione. Ripeta il calcolo se cambiano classificazione, valore, origine, destinazione, valuta o tariffa. Il browser è utile per controlli manuali; l'API costa $0.002 per richiesta quando Lei automatizza acquisti, checkout o rendicontazione.

Pianifichi il costo finale

Applichi un'aliquota verificata al valore del fornitore prima di confrontare le opzioni di approvvigionamento.

Controlli un'ipotesi di catalogo

Verifichi il dazio prodotto dalla tabella usata nel flusso prezzi dell'e-commerce.

Revisioni un calcolo manuale

Mostri la percentuale trovata accanto al dazio per risalire alla riga della tabella.

Quale formula viene usata?

Moltiplica declared_value per duty_rate_percent e divide per cento.

Individua la categoria o tariffa corretta?

No. Lei deve fornire sia la categoria della spedizione sia la tabella applicabile.

Cosa accade se la categoria manca?

La richiesta restituisce un errore che identifica la categoria assente, senza usare aliquote predefinite.

Sono inclusi imposte, intermediazione o trasporto?

No. Il calcolo usa solo il valore dichiarato e la percentuale fornita da Lei.

Quale valuta devo usare?

Usi la valuta prevista dal Suo scenario e la mantenga per il valore dichiarato e il dazio.

Quanto costa una richiesta API?

L'API costa $0.002 per richiesta. La versione browser funziona localmente per le stime manuali.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/ecom/customs-duty-estimate

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/ecom/customs-duty-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}'
{
  "declared_value": 1250,
  "category": "footwear",
  "duty_rates": [
    {
      "category": "books",
      "rate_percent": 0
    },
    {
      "category": "footwear",
      "rate_percent": 12.5
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.customs_duty_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_items500
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →