ForHosting KIT · Ferramentas para dev

Calculadora de selos postais

Esta calculadora de selos postais encontra uma combinação prática cujo valor total atinge ou supera a postagem necessária.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe o custo e um valor de selo para obter uma contagem rápida, ou acrescente outras denominações se você tiver selos variados. O resultado apresenta o número de selos, o valor coberto, qualquer excedente inevitável e a distribuição por denominação. Os cálculos usam unidades monetárias inteiras escaladas, e não comparações aproximadas de ponto flutuante, garantindo resultados determinísticos para expedições, salas de correspondência e fluxos automatizados.

Informe a postagem e os selos disponíveis

Comece com o custo total de postagem fornecido pela transportadora, pelo serviço postal ou pelo sistema de remessas. Em seguida, informe o valor do selo principal que pretende usar. Se todos os selos disponíveis tiverem o mesmo valor, esses dois dados bastam: a calculadora determina a menor quantidade cujo total cobre a postagem exigida. Quando houver vários valores, adicione-os como denominações extras. A ferramenta considera cada denominação reutilizável e, portanto, pressupõe estoque ilimitado de cada valor. Os valores monetários podem ter até três casas decimais, atendendo moedas e produtos postais com precisão além dos centavos. Use a mesma moeda na postagem exigida e em todos os selos; a calculadora processa números, não faz câmbio. Denominações repetidas são consolidadas. Uma postagem igual a zero retorna zero selos, mas todo valor de selo deve ser positivo, pois um selo de valor zero ou negativo não contribui para uma combinação válida.

Como a melhor combinação é escolhida

O primeiro objetivo é minimizar o pagamento excedente. A calculadora procura o menor total alcançável que seja igual ou superior à postagem exigida. Assim, uma combinação exata sempre vence uma opção com sobra, mesmo que a solução exata use mais selos. Depois de encontrar o menor total pagável, o segundo objetivo é obter esse valor com o mínimo de selos. Essa prioridade corresponde à decisão comum ao preparar uma correspondência: evitar desperdício de postagem antes de reduzir a quantidade de selos a manusear e colar. Internamente, todos os valores são convertidos em inteiros escalados antes da avaliação. Por exemplo, quantias com duas casas decimais são tratadas como centésimos inteiros. Isso impede que imprecisões binárias de ponto flutuante transformem uma igualdade monetária em uma pequena falta aparente. A busca é determinística, possui limite declarado, não acessa a rede e produz a mesma distribuição tanto no navegador quanto pela API.

Interprete o resultado e use-o com segurança

O resultado separa quatro informações úteis. A quantidade de selos é o total de peças físicas na combinação escolhida. A postagem exigida repete o alvo normalizado para facilitar comparações futuras. O total de postagem soma os valores de face recomendados, e o excedente mostra a diferença em relação ao alvo. A distribuição lista somente as denominações utilizadas e suas quantidades. Antes de enviar, confirme se o valor informado ainda corresponde à cotação atual da transportadora e se cada selo vale para o serviço, destino, modalidade e data da postagem. A calculadora executa apenas a aritmética; ela não consulta preços postais atuais, identifica restrições regionais, reserva postagem nem imprime etiquetas. Também pressupõe disponibilidade ilimitada de cada denominação. Se o estoque for restrito, use apenas valores disponíveis em quantidade suficiente e confira os selos físicos ao montar a correspondência. Chamadas automatizadas podem aproveitar a mesma resposta determinística em instruções de expedição ou rotinas da sala de correspondência por US$ 0,002 por solicitação.

Preparar um envelope

Encontre a menor quantidade de selos iguais que cobre uma carta e confira a sobra antes de colá-los.

Usar denominações variadas

Combine diferentes valores de uma coleção priorizando o menor excedente possível de postagem.

Automatizar instruções de postagem

Transforme uma cotação da transportadora em uma distribuição repetível para expedição ou correspondência interna.

Quanto custa a calculadora?

Ela funciona gratuitamente no navegador. Cada solicitação pela API custa US$ 0,002.

O que acontece quando um valor não forma a quantia exata?

A calculadora escolhe o menor total alcançável acima do necessário e depois minimiza a quantidade de selos.

Posso combinar selos de valores diferentes?

Sim. Informe uma denominação principal e inclua os demais valores disponíveis em additional_denominations.

Por que todas as denominações precisam ser positivas?

Um valor zero ou negativo não acrescenta postagem válida e inviabiliza a otimização, portanto a entrada é rejeitada.

A calculadora consulta tarifas postais atuais?

Não. Informe um custo obtido da transportadora ou do serviço postal; esta capacidade calcula apenas combinações.

Ela considera uma quantidade limitada de selos em estoque?

Não. Cada denominação informada é considerada disponível sem limite de quantidade.

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.

POSThttps://api.kit.forhosting.com/date/postage-stamp-count

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/date/postage-stamp-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_postage":2.73,"denomination":0.68}'
{
  "total_postage": 2.73,
  "denomination": 0.68
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.postage_stamp_count",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_amount100000
max_denominations20
max_decimal_places3
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →