Calculadora de margem de frete: lucro ou prejuízo
Receita de frete não significa lucro de frete. A loja pode cobrar uma taxa na finalização da compra e depois pagar outro valor à transportadora, além de consumir materiais de embalagem.
Executar grátis
Esta calculadora compara esses valores na mesma base. Informe o frete cobrado do cliente, o custo real da transportadora e a embalagem de uma remessa. O resultado mostra custo total, lucro ou prejuízo e a margem percentual quando existe receita de frete.
Informe valores comparáveis de uma remessa
Use o frete realmente cobrado do cliente, não o preço do produto nem o total do pedido. Depois, informe o custo da transportadora para a mesma remessa e os materiais consumidos, como caixa, envelope, fita, etiqueta, proteção ou gelo reutilizável. Mantenha os três valores na mesma moeda e base tributária. Se você ofereceu frete grátis, informe zero; a ferramenta mostrará a despesa como prejuízo. Sempre que possível, use a cobrança final da transportadora, pois uma etiqueta estimada pode mudar por correção de endereço, peso dimensional ou entrega residencial. Não misture uma compra mensal de embalagens com um pacote: primeiro calcule um custo unitário razoável. Zero é aceito quando um custo não se aplica, mas todos os valores devem ser números finitos e não negativos, sem símbolo monetário nem separador de milhar.
Interprete lucro, prejuízo e margem
A calculadora soma transportadora e embalagem para obter o custo real de frete. Em seguida, subtrai esse total do valor cobrado. Um resultado positivo indica lucro, um negativo indica prejuízo e zero indica equilíbrio; a classificação aparece separadamente. Quando o frete cobrado é maior que zero, a margem divide o lucro ou prejuízo pela receita de frete e multiplica por cem. Por exemplo, cobrar 12.99, pagar 8.40 à transportadora e 1.35 em embalagem gera custo de 9.75, lucro de 3.24 e margem aproximada de 24.94 por cento. No frete grátis, a porcentagem é omitida porque não existe divisão válida por zero, mas o prejuízo absoluto continua disponível. As saídas são arredondadas para duas casas. Trata-se de margem sobre receita, não de acréscimo sobre custo.
Use o resultado na política de frete
Avalie o valor absoluto junto com a margem. Uma margem positiva pode cobrir trabalho de embalagem ou ajustes eventuais, mas uma cobrança excessiva pode reduzir conversões ou contrariar regras do marketplace. Um prejuízo pode ser intencional quando o frete subsidiado favorece a margem do produto, a aquisição ou um pedido mínimo. Nesse caso, trate-o como custo promocional e confirme que o restante do pedido consegue absorvê-lo. Repita o cálculo por serviço, região, tamanho e canal para revelar padrões escondidos pelas médias. A ferramenta inclui somente cobrança do cliente, transportadora e materiais. Não adiciona mão de obra, separação, seguro, impostos, pagamentos, devoluções, reenvios, estoque, software ou lucro do produto. Para auditoria, guarde a saída com o pedido, a fatura e a fonte do custo da embalagem. Entradas iguais sempre geram resultados iguais; cada cálculo pela API custa US$ 0,002.
Casos de uso
Auditar pedidos concluídos
Compare o frete do checkout com a fatura final e os materiais usados.
Testar uma tarifa fixa
Descubra em quais perfis uma única tarifa gera lucro ou prejuízo.
Avaliar frete grátis
Meça o custo que a margem do produto precisa absorver quando o cliente não paga frete.
Perguntas frequentes
Qual fórmula é usada?
O custo real soma transportadora e embalagem. Lucro ou prejuízo é a cobrança menos esse custo; a margem divide o resultado pela cobrança e multiplica por cem.
O que acontece no frete grátis?
Informe zero. O custo será mostrado como prejuízo e a porcentagem será omitida porque a receita é zero.
Devo incluir mão de obra?
O campo de embalagem foi pensado para materiais. Inclua trabalho apenas se você tiver um valor confiável por remessa.
A ferramenta consulta transportadoras?
Não. Você informa o custo real ou cotado relevante para a remessa.
Margem é igual a acréscimo?
Não. A margem usa a receita como denominador; o acréscimo normalmente usa o custo.
Quanto custa a API?
Cada solicitação custa US$ 0,002. A calculadora web usa a mesma aritmética determinística.
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/shipping-margin \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"shipping_fee":12.99,"carrier_cost":8.4,"packaging_cost":1.35}'const res = await fetch("https://api.kit.forhosting.com/ecom/shipping-margin", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"shipping_fee": 12.99,
"carrier_cost": 8.4,
"packaging_cost": 1.35
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/shipping-margin",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"shipping_fee": 12.99,
"carrier_cost": 8.4,
"packaging_cost": 1.35
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/shipping-margin", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"shipping_fee":12.99,"carrier_cost":8.4,"packaging_cost":1.35}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"shipping_fee":12.99,"carrier_cost":8.4,"packaging_cost":1.35}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/shipping-margin", 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
{
"shipping_fee": 12.99,
"carrier_cost": 8.4,
"packaging_cost": 1.35
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.shipping_margin",
"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. |