ForHosting KIT · Finanças e dinheiro

Calculadora de selos necessários

Com porte de 1,50 e selos de 0,73, você precisa de 3 selos: 2,19 no envelope e 0,69 pagos a mais. Informe o porte e o valor de um selo para obter a menor quantidade inteira que cobre a franquia. 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

Postagem: 1,5
Valor do selo: 0,73

Você obtém

Já afixado: 0
Postagem restante: 1,5
Selos necessários: 3
Total de selos: 3

Uma carta ou encomenda só sai do balcão quando o porte devido fica coberto por selos de uma denominação conhecida. Esta calculadora de selos necessários aceita o porte a pagar e o valor de face de um selo, e devolve o menor número inteiro de selos que iguala ou supera esse porte, o valor de face total que você realmente colará e o excesso acima do valor devido. Selos opcionais já afixados são subtraídos do restante a cobrir, para que você termine um envelope que já leva um selo Forever ou um comemorativo avulso. Os valores são tratados como unidades monetárias arredondadas a duas casas decimais; a contagem de selos permanece inteira.

O que «selos necessários» significa para uma carta ou encomenda

Os operadores postais publicam um porte devido para cada peça: uma função de peso, tamanho, destino e serviço, expressa em dinheiro. O cliente raramente entrega exatamente esse valor em moedas misturadas. Em vez disso, cola selos inteiros de um ou mais valores de face até a soma desses valores ser pelo menos o porte devido.

Quando todos os selos do envelope são da mesma denominação — um livrinho de selos Forever, um rolo de segunda classe ou uma reimpressão comemorativa — o problema se reduz a um único teto: quantas cópias dessa denominação são exigidas para cobrir o devido.

Se o porte é um dólar e cinquenta e cada selo vale setenta e três centavos, dois selos dão só um dólar e quarenta e seis, o que fica curto, então são necessários três selos e os dezenove centavos a mais são excesso que o operador fica. A mesma identidade vale em qualquer moeda: selos necessários é o teto do porte restante dividido pelo valor do selo, e o porte restante é o devido menos quaisquer selos já colados na peça. Porte restante zero significa zero selos adicionais.

Esta página é essa contagem, não uma tabela de tarifas. Ela não consulta tarifas da USPS, Royal Mail ou La Poste a partir de peso e zona — calculadoras irmãs como peso cobrável e custo de frete por zona respondem essas buscas. Ela responde a consulta distinta «quantos selos desta denominação eu preciso para cobrir este porte», que é o que quem está na mesa da cozinha com um livrinho de selos idênticos de fato pesquisa.

Onde uma contagem de selos necessários se paga

Domicílios e escritórios pequenos usam uma calculadora de selos necessários antes de ir à caixa de correio para que um cartão grosso ou um envelope almofadado não volte por porte insuficiente. Comércios eletrônicos que ainda despacham uma fração dos pedidos como cartas seladas — contratos, etiquetas de devolução, avisos legais — podem pegar o porte cotado e a denominação estocada no armazém e imprimir «cole N selos» no romaneio.

Equipes financeiras que conciliam a gaveta de selos com o porte mecanizado podem reexecutar cada valor devido pela mesma fórmula e ver se a equipe colou a mais. Validação falha não consome saldo.

Documente a denominação que você realmente tem — o valor de face vigente de um selo Forever, um selo de segunda onça ou um definitivo local — ao lado do porte devido, mantenha uma só moeda nos dois campos e você obtém uma contagem reproduzível para envelopes, encomendas e planilhas de auditoria sem montar um motor tarifário postal próprio.

Casos de uso

Cartas e cartões na mesa da cozinha

Consulte o porte de um cartão ou de um envelope grosso, informe o valor de face dos selos do livrinho e cole a contagem devolvida para que a peça não volte por porte insuficiente.

Romaneios de armazém para cartas seladas

Transforme o porte cotado e a denominação estocada na bancada de embalagem em uma contagem inteira impressa no romaneio, inclusive qualquer selo já presente em um envelope pré-franqueado.

Conciliação da gaveta de selos

Reexecute o porte de cada peça pela mesma fórmula de teto para explicar por que uma gaveta de selos idênticos baixou mais rápido do que o porte mecanizado sugeriria.

Perguntas frequentes

Quantos selos eu preciso para cobrir o porte?

Divida o porte restante pelo valor de face de um selo e arredonde para cima até o próximo selo inteiro. O porte restante é o devido menos quaisquer selos dessa denominação já presentes na peça. Esta calculadora devolve essa contagem, o valor de face total e o excesso.

E se dois selos não forem suficientes?

A contagem é um teto, não um piso. Se postage é 1.50 e cada selo vale 0.73, dois selos cobrem só 1.46, então o resultado são três selos e 0.69 de excesso. Os operadores postais ficam com o restante.

Esta ferramenta consulta tarifas postais oficiais por peso?

Não. Você informa o porte devido da sua transportadora, tabela ou balança dos correios. Esta ferramenta só responde quantos selos de uma denominação cobrem esse valor. Ela não converte moedas nem mistura denominações.

Posso descontar os selos que já estão no envelope?

Sim. Informe quantos selos do mesmo valor já estão colados e o valor deles é subtraído do porte antes da contagem. Se já cobrirem tudo, o resultado é zero selos adicionais.

Quanto eu pago a mais usando selos inteiros?

O resultado mostra o excesso acima do porte. Com porte de 1,50 e selos de 0,73, três selos somam 2,19, então você paga 0,69 a mais, valor que fica com o operador postal.

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/stamps-needed

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/stamps-needed \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"postage":1.5,"stamp_value":0.73}'

const res = await fetch("https://api.kit.forhosting.com/ecom/stamps-needed", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "postage": 1.5,
    "stamp_value": 0.73
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/stamps-needed",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "postage": 1.5,
    "stamp_value": 0.73
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/stamps-needed", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"postage":1.5,"stamp_value":0.73}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"postage":1.5,"stamp_value":0.73}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/stamps-needed", 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

{
  "postage": 1.5,
  "stamp_value": 0.73
}

Exemplo de resposta

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

Uma chamada bem-sucedida é cobrada pelo US$ 0,002 publicado; entrada inválida não é tarifada.

Contrato de entrada, aritmética em centavos inteiros e corpo da resposta

Cadeias de dígitos que se interpretam como números finitos são permitidas, para que um total de checkout colado não exija uma segunda conversão. A aritmética corre em centavos inteiros para que três vezes setenta e três centavos seja exatamente dois dólares e dezenove, nunca um resto binário flutuante. Envie um corpo JSON com dois valores não negativos obrigatórios em uma só moeda: postage (o porte devido da carta ou encomenda) e stamp_value (o valor de face de um selo da denominação que você usará). Opcionalmente envie already_affixed como número inteiro desses selos já presentes na peça; quando omitido, o padrão é zero. Aceitam-se os aliases postage_due, postage_amount, amount_due, required_postage e postage_due_amount para o primeiro campo; denomination, stamp_denomination, face_value, stamp e value para o segundo; affixed, stamps_on_hand, existing_stamps e stamps_affixed para a contagem. Campos ausentes, cadeias vazias, texto não numérico, NaN, Infinity, negativos e valores acima dos máximos publicados falham com invalid_input nomeando o campo, e essas falhas não são cobradas. stamp_value deve ser pelo menos um centavo após o arredondamento a duas casas. Em caso de sucesso, o corpo ecoa as entradas arredondadas, informa postage_remaining como o devido ainda não coberto após os selos já afixados, stamps_needed como os selos inteiros adicionais exigidos, stamps_total como already_affixed mais stamps_needed, value_needed e value_total como essas contagens vezes a denominação, overpay como value_total menos postage, e covers_exactly quando esse excesso é zero. O campo formula reitera stamps_needed = ceil(max(0, postage − already_affixed × stamp_value) / stamp_value) para exibição ao lado do resultado. Exemplo: postage de um dólar e cinquenta e stamp_value de setenta e três centavos, sem nada já afixado, produz três selos, dois dólares e dezenove no total e sessenta e nove centavos de excesso. O preço de um item bem-sucedido é um US$ 0,002 fixo.

Onde uma contagem de selos necessários se paga

Vendedores de marketplaces que compram selos no estilo Forever em volume precisam de um teto determinístico que não dependa de uma API de transportadora estar no ar na hora do empacotamento. Como a implementação é parse puro de tier A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.

Perguntas técnicas

Posso subtrair selos que já estão no envelope?

Sim. Envie already_affixed como inteiro não negativo. Esses selos são avaliados em stamp_value e subtraídos de postage antes do teto. Se já cobrem o devido, stamps_needed vale zero.

Quanto custa a calculadora de selos necessários para o porte?

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

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que «selos necessários» significa para uma carta ou encomenda

Onde uma contagem de selos necessários se paga

Casos de uso

Cartas e cartões na mesa da cozinha

Romaneios de armazém para cartas seladas

Conciliação da gaveta de selos

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

Contrato de entrada, aritmética em centavos inteiros e corpo da resposta

Onde uma contagem de selos necessários se paga

Perguntas técnicas

obrigado