Calcule o imposto de importação por valor e categoria
Este estimador aplica ao valor declarado da remessa a porcentagem da categoria presente na tabela fornecida por você.
Executar grátis
Ele devolve a alíquota encontrada e o imposto estimado, permitindo conferir e reproduzir o cálculo. A ferramenta não classifica mercadorias, consulta tarifas oficiais, soma tributos nem determina isenções. Use dados válidos para a remessa e trate o resultado como planejamento, não como lançamento aduaneiro.
Prepare o valor declarado e a tabela de categorias
Comece pelo valor declarado que servirá de base no cenário planejado. Informe um número não negativo, sem símbolo de moeda ou separador de milhar. Depois, forneça uma tabela em que cada linha tenha um nome de categoria exclusivo e um rate_percent não negativo. A categoria da remessa deve corresponder exatamente a uma linha, inclusive em maiúsculas, minúsculas e espaços. Essa regra evita selecionar silenciosamente uma classificação parecida, mas juridicamente diferente. Informe alíquotas como porcentagens: rate_percent igual a 7.5 significa sete e meio por cento, não 0.075. Mantenha todos os valores na mesma moeda, pois não há consulta a câmbio. Antes do cálculo, confirme se valor, classificação e tabela são apropriados ao destino e à data. Regras de valoração, origem preferencial, cronogramas tarifários e isenções podem alterar a base ou a porcentagem aplicável.
Entenda o cálculo e o resultado
O estimador procura a categoria exata na tabela, obtém a respectiva porcentagem e multiplica o valor declarado pela alíquota dividida por cem. A relação é: imposto estimado igual a valor declarado vezes rate_percent dividido por cem. A resposta inclui declared_value, categoria, duty_rate_percent e estimated_duty para que outra pessoa audite os dados sem refazer a busca. O algoritmo não arredonda; assim, preserva a aritmética determinística sem impor convenções de casas decimais que variam entre autoridades. Seu processo financeiro pode arredondar depois conforme a regra aplicável. Alíquota zero ou valor zero gera imposto zero. Se a categoria não existir, a operação retorna erro de entrada, sem supor valor padrão. Categorias duplicadas também são recusadas por tornarem a tabela ambígua, mesmo quando as porcentagens coincidem.
Use a estimativa no custo total de importação
Considere o resultado uma parcela do custo total, não o valor final cobrado pela alfândega. A importação pode envolver IVA ou tributos sobre vendas, impostos seletivos, medidas antidumping, corretagem, manuseio e outras cobranças. Algumas autoridades usam um valor aduaneiro que inclui frete, seguro, royalties e ajustes, em vez de apenas a fatura. Preferências de origem e limites de isenção podem reduzir o encargo, mas exigem fatos não coletados aqui. Para planejamento, arquive a tabela fornecida junto da estimativa. Em operações de catálogo, calcule por item ou classificação e só agregue depois de verificar se o tratamento ocorre por linha ou remessa. Recalcule quando mudarem produto, valor, origem, destino, moeda ou tarifa vigente. O navegador atende verificações manuais, enquanto a API custa US$ 0,002 por solicitação em fluxos automatizados de compras, checkout ou relatórios.
Casos de uso
Planeje o custo de importação
Aplique uma alíquota verificada ao valor do fornecedor antes de comparar opções de compra.
Confira uma premissa do catálogo
Valide o imposto produzido pela tabela de categorias usada na precificação do comércio eletrônico.
Audite um cálculo manual
Exiba a porcentagem encontrada junto ao imposto para rastrear o resultado até a linha da tabela.
Perguntas frequentes
Qual fórmula o estimador usa?
Ele multiplica declared_value por duty_rate_percent e divide por cem.
A ferramenta encontra a categoria ou tarifa correta?
Não. Você deve fornecer a categoria da remessa e a tabela de alíquotas aplicável.
O que ocorre quando a categoria não está na tabela?
A solicitação retorna um erro de entrada que identifica a categoria ausente, sem substituir uma alíquota padrão.
O imposto inclui tributos, corretagem ou frete?
Não. O cálculo usa somente o valor declarado e a porcentagem fornecida por você.
Qual moeda devo usar?
Use a moeda exigida pelo cenário de valoração e mantenha nela o valor declarado e o imposto resultante.
Quanto custa uma solicitação de API?
A API custa US$ 0,002 por solicitação. A versão no navegador roda localmente para estimativas manuais.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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}]}'const res = await fetch("https://api.kit.forhosting.com/ecom/customs-duty-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/customs-duty-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/customs-duty-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/customs-duty-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.customs_duty_estimate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_items | 500 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |