ForHosting KIT · Finanças e dinheiro

Total pagamento na entrega

Saiba exatamente quanto o entregador deve cobrar na entrega: mercadorias de 120, frete de 15 e taxa de pagamento na entrega de 5 somam 140 a cobrar, com subtotal de 135 de pedido e frete. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Valor da mercadoria: 120
Frete: 15
Taxa de pagamento na entrega: 5

Você obtém

Mercadoria mais frete: 135
Total a cobrar: 140

O pagamento na entrega (COD) continua sendo um método de pagamento importante em muitos mercados de comércio eletrônico: o cliente paga quando o pacote chega, e o courier precisa saber o valor exato a cobrar. Essa cifra não é só o preço do produto — costuma incluir frete e uma taxa ou sobretaxa COD que o lojista ou a transportadora cobra por processar dinheiro ou cartão na porta. Esta calculadora de total pagamento na entrega aceita o valor das mercadorias, o frete e a taxa COD e devolve o total a cobrar pelo courier e um subtotal de mercadorias mais frete para que romaneios de armazém, lembretes por SMS e manifestos COD permaneçam consistentes. Use qualquer unidade monetária que você já controle; a ferramenta não converte câmbio — apenas soma valores não negativos e arredonda para duas casas decimais para totais monetários estáveis.

O que é um total COD e por que mercadorias, frete e taxa ficam separados

O total pagamento na entrega — também chamado de valor a cobrar pelo courier ou quantia a ser arrecadada — é o dinheiro que o agente de entrega deve receber do destinatário antes de entregar o pacote. Os lojistas costumam dividir esse total em três linhas contábeis. O valor das mercadorias é o subtotal de produtos: a soma dos preços dos itens após descontos no nível do produto, mas antes do frete e das sobretaxas do método de pagamento.

O frete é a cobrança de transporte ou entrega que o cliente aceitou pagar, e pode ser zero sob limiares de frete grátis. A taxa COD é um cargo extra por aceitar o pagamento na entrega: algumas transportadoras cobram taxa fixa de cobrança, outras um percentual da fatura, e alguns lojistas absorvem o custo mas ainda listam zero por transparência. Manter as três entradas separadas importa para contabilidade e comunicação com o cliente.

Equipes financeiras lançam mercadorias em receita, frete em receita de transporte ou contrapartida de despesa, e taxas COD em receita de processamento de pagamento ou recuperação de custo da transportadora. Agentes de suporte precisam do mesmo desdobramento quando um cliente pergunta por que o courier pediu mais do que o preço do produto na página. Operacionalmente, o total a cobrar é o que vai na carta de porte, no comprovante COD e no SMS que diz «deixe o valor X preparado».

Onde uma calculadora de total pagamento na entrega agrega valor

Equipes de operações de e-commerce usam uma calculadora de total pagamento na entrega ao imprimir manifestos COD para que cada volume saia do armazém com o mesmo valor a cobrar que o cliente viu no checkout. Marketplaces e vendedores multi-armazém precisam de um oráculo determinístico que some mercadorias, frete e taxa COD da mesma forma na vitrine, no OMS e nas APIs de última milha.

Bots de suporte de call center e WhatsApp podem recalcular o total a cobrar quando um comprador contesta o que o courier pediu, sem abrir uma planilha. Analistas de finanças e logística conciliam arquivos de remessa da transportadora com o histórico de pedidos reexecutando os três componentes pela mesma fórmula em vez de reconstruir totais colados. Validação com falha não consome saldo.

Documente como você deriva a taxa COD nos runbooks, armazene a moeda junto a cada pedido e obtenha valores de cobrança reproduzíveis para romaneios, auditorias de SLA e workers na borda sem montar um motor de pagamentos completo próprio.

Casos de uso

Checkout e lembretes SMS

Mostre o total a cobrar pelo courier após somar frete e sobretaxa COD para que o comprador prepare o valor correto antes da entrega.

Perguntas frequentes

Como o total pagamento na entrega é calculado?

Todos os valores usam as mesmas unidades monetárias que você fornece.

Esta ferramenta calcula a taxa COD a partir de um percentual?

Não. Envie a taxa que você já calculou pela transportadora ou política. A calculadora só soma valor das mercadorias, frete e essa taxa para que os resultados permaneçam determinísticos.

Qual moeda devo usar?

Qualquer moeda única que o pedido já use.

O frete ou a taxa de pagamento na entrega podem ser zero?

Sim. Informe zero no frete quando o pedido não pagar transporte e zero na taxa quando o pagamento na entrega não custar nada ao cliente ou você assumir esse custo. Valores negativos não são aceitos.

Por que o entregador cobra mais que o preço do produto?

Porque o valor a cobrar normalmente soma o frete e a taxa de pagamento na entrega às mercadorias. Com mercadorias de 120, frete de 15 e taxa de 5, o entregador cobra 140, e não 120.

Ferramentas relacionadas

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

POSThttps://api.kit.forhosting.com/ecom/cod-total

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/cod-total \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"goods_value":120,"shipping":15,"cod_fee":5}'

const res = await fetch("https://api.kit.forhosting.com/ecom/cod-total", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/cod-total",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/cod-total", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"goods_value":120,"shipping":15,"cod_fee":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"goods_value":120,"shipping":15,"cod_fee":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/cod-total", 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

{
  "goods_value": 120,
  "shipping": 15,
  "cod_fee": 5
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.cod_total",
  "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

por chamadaUS$ 0,002

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.

Notas técnicas

O que é um total COD e por que mercadorias, frete e taxa ficam separados

Esta calculadora implementa a soma padrão total_collect igual a goods_value mais shipping mais cod_fee, e também devolve goods_plus_shipping para que rótulos mostrem «pedido e entrega» separado da sobretaxa de pagamento. Ela não inventa uma taxa COD a partir de uma tabela de percentuais: você envia a taxa que já calculou pelo contrato ou tabela da transportadora, o que mantém o endpoint determinístico e livre de regras de política ocultas.

Contrato de entrada, campos de resposta e validação

Valores extremamente grandes acima de um trilhão em magnitude absoluta são rejeitados como fora da faixa. Uma string formula curta reafirma a regra para exibição ao lado do resultado. Envie um corpo JSON com três números finitos não negativos obrigatórios: goods_value (subtotal de mercadorias do pedido), shipping (frete ou taxa de entrega; use zero para frete grátis) e cod_fee (taxa ou sobretaxa de pagamento na entrega; use zero quando o COD é grátis). Cada campo pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias, valores não finitos e negativos falham com invalid_input nomeando o campo, e essas falhas não são faturadas. Em caso de sucesso o corpo ecoa as três entradas arredondadas para duas casas decimais, informa goods_plus_shipping como goods_value mais shipping, e total_collect como goods_plus_shipping mais cod_fee — o valor que o courier deve cobrar. Exemplo: mercadorias cento e vinte, frete quinze, taxa COD cinco produz goods_plus_shipping cento e trinta e cinco e total_collect cento e quarenta. Combine a resposta com seu próprio código de moeda e formatação local; este endpoint nunca converte moedas nem aplica alíquotas — IVA, GST e direitos aduaneiros devem ser incorporados às entradas se fizerem parte do dinheiro que o entregador arrecada. Aliases como order_value, freight e collection_fee são aceitos por conveniência. Mantenha as requisições pequenas, fixe os totais com duas casas decimais nos testes e reutilize o mesmo módulo no navegador e na API para que prévias gratuitas coincidam byte a byte com a automação pré-paga em cada comprovante COD.

Onde uma calculadora de total pagamento na entrega agrega valor

Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída.

Casos de integração

Romaneios e manifestos COD

Imprima mercadorias, frete, taxa COD e total_collect em cada comprovante para que entregadores e clientes vejam a mesma cifra a cobrar.

Conciliação de remessas

Reexecute os componentes do pedido com total_collect = goods + shipping + COD fee ao cruzar liquidações da transportadora com os pedidos.

Perguntas técnicas

O frete ou a taxa COD podem ser zero?

Sim. Use shipping 0 para entrega grátis e cod_fee 0 quando não cobrar sobretaxa de cobrança. Negativos são rejeitados como invalid_input.

Quanto custa a calculadora de total pagamento na entrega?

A ferramenta no navegador é gratuita. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é faturada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que é um total COD e por que mercadorias, frete e taxa ficam separados

Onde uma calculadora de total pagamento na entrega agrega valor

Casos de uso

Checkout e lembretes SMS

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

O que é um total COD e por que mercadorias, frete e taxa ficam separados

Contrato de entrada, campos de resposta e validação

Onde uma calculadora de total pagamento na entrega agrega valor

Casos de integração

Romaneios e manifestos COD

Conciliação de remessas

Perguntas técnicas

obrigado