Calculadora de taxa de manuseio de pedidos
A calculadora de taxa de manuseio combina um valor fixo com uma porcentagem do subtotal do pedido e apresenta a cobrança completa e o total do checkout.
Executar grátis
Ela é útil quando embalagem, administração, processamento especial ou operação logística não podem ser cobertos por um único método. Informe o subtotal e um ou ambos os componentes para obter uma composição transparente, com valores monetários arredondados para duas casas decimais antes de serem usados em loja, orçamento, fatura ou fluxo de pagamento.
Informe o subtotal e os dois componentes
Comece pelo subtotal anterior à taxa de manuseio. Esse deve ser o valor de produtos ou serviços que sua política considera elegível para a cobrança percentual; não inclua a própria taxa, pois isso criaria uma incidência composta. Depois, informe a parcela fixa, que pode representar embalagem, documentação, separação no estoque ou outro custo igual para todos os pedidos qualificados. Por fim, escreva a taxa como porcentagem, não como fração decimal: use 4.5 para quatro e meio por cento, e não 0.045. Qualquer componente pode ser zero, permitindo políticas somente fixas ou somente percentuais. Todos os valores devem ser não negativos, e a porcentagem é limitada a 100. A separação dos componentes facilita explicar a cobrança ao cliente, conferir a configuração da plataforma e evitar que a parcela fixa entre por engano na base percentual.
Entenda o cálculo e o arredondamento
Primeiro, a calculadora multiplica o subtotal pela taxa percentual dividida por 100. O resultado percentual é arredondado para duas casas decimais, seguindo a precisão de centavos comum no checkout. Em seguida, soma a parcela fixa e arredonda novamente a taxa combinada. O total do pedido é o subtotal original acrescido dessa cobrança. A resposta inclui subtotal normalizado, taxa fixa, percentual, valor percentual calculado, cobrança de manuseio e total final. Esse detalhamento permite exibir uma única taxa sem perder informações úteis para testes e conciliação. O cálculo não acrescenta impostos, frete, descontos, gorjetas, tarifas de processamento de pagamento ou conversão cambial. Esses itens devem ser aplicados separadamente, de acordo com a ordem definida pelo seu sistema e com as regras legais do seu mercado.
Aplique o resultado com segurança no checkout
Use a ferramenta como uma etapa determinística depois de definir o subtotal elegível e antes de mostrar o resumo final. Uma loja pode acioná-la quando o carrinho mudar, uma equipe operacional pode testar uma nova tabela e o back office pode comparar cobranças previstas com pedidos concluídos. Como a função não usa rede, estado salvo, aleatoriedade nem data atual, entradas iguais sempre produzem saídas iguais. Guarde os valores informados junto do detalhamento se precisar justificar uma cobrança antiga. Antes de lançar a política, confirme como sua plataforma ordena descontos, frete, impostos e taxas, pois esta calculadora trabalha somente com o subtotal fornecido. Mostre a cobrança antes da confirmação do pagamento e use uma descrição clara para o consumidor. A API custa US$ 0,002 por solicitação; no navegador, o mesmo cálculo puro pode ser executado sem enviar os valores a terceiros.
Casos de uso
Configurar o checkout da loja
Calcule a cobrança combinada exata para reproduzir uma política com valor fixo e percentual.
Testar uma tabela proposta
Compare taxas em subtotais representativos antes de publicar uma nova política operacional.
Conciliar pedidos concluídos
Refaça o cálculo com os dados registrados e compare o resultado com a cobrança do pedido.
Perguntas frequentes
Qual subtotal devo informar?
Use o valor que sua política adota como base percentual, antes desta taxa. A inclusão de descontos, frete ou impostos depende do checkout.
Posso calcular somente uma taxa fixa?
Sim. Defina percentage_fee como zero ou omita o campo; a cobrança será igual à parcela fixa.
Como são tratadas frações de centavo?
O valor percentual é arredondado para duas casas antes da soma com a parte fixa. A cobrança e o total também são arredondados.
A conta inclui impostos ou frete?
Não. Ela calcula apenas o manuseio sobre o subtotal informado; os demais ajustes devem ser feitos separadamente.
Quanto custa a API?
A API custa US$ 0,002 por solicitação. A versão no navegador executa localmente o mesmo cálculo determinístico.
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/handling-fee \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"subtotal":125.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/handling-fee", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"subtotal": 125.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/handling-fee",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"subtotal": 125.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/handling-fee", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"subtotal":125.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"subtotal":125.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/handling-fee", 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
{
"subtotal": 125.5
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.handling_fee",
"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.
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. |