Calculateur de timbres postaux
Pour un affranchissement de 1,50 avec des timbres à 0,73, il vous faut 3 timbres : 2,19 sur l’enveloppe et 0,69 payés en trop. Saisissez l’affranchissement et la valeur d’un timbre pour obtenir le plus petit nombre entier qui le couvre. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Affranchissement
- 1,5
- Valeur du timbre
- 0,73
- Déjà apposé
- 0
- Affranchissement restant
- 1,5
- Timbres nécessaires
- 3
- Total des timbres
- 3
Une lettre ou un colis ne quitte le guichet que lorsque l'affranchissement dû est couvert par des timbres d'une valeur faciale connue. Ce calculateur de timbres postaux nécessaires accepte l'affranchissement à payer et la valeur faciale d'un timbre, puis renvoie le plus petit nombre entier de timbres qui égale ou dépasse cet affranchissement, la valeur faciale totale que vous collerez réellement et le trop-perçu au-dessus du montant dû. Les timbres déjà apposés, optionnels, se soustraient du reste à couvrir afin que vous puissiez terminer une enveloppe qui porte déjà un timbre Forever ou un commémoratif isolé. Les montants sont traités comme des unités monétaires arrondies à deux décimales ; le nombre de timbres reste entier.
Ce que « timbres nécessaires » signifie pour une lettre ou un colis
Les opérateurs postaux publient un affranchissement dû pour chaque envoi : une fonction du poids, du format, de la destination et du service, exprimée en argent. Le client remet rarement ce montant exact en monnaie mêlée. Il appose plutôt des timbres entiers d'une ou plusieurs valeurs faciales jusqu'à ce que la somme de ces valeurs soit au moins égale à l'affranchissement dû.
Lorsque tous les timbres de l'enveloppe sont de la même valeur faciale — un carnet de timbres Forever, une bobine de deuxième classe ou une réimpression commémorative — le problème se réduit à un seul plafond : combien d'exemplaires de cette valeur sont requis pour couvrir le dû. Si l'affranchissement est un dollar cinquante et que chaque timbre vaut soixante-treize cents, deux timbres ne donnent qu'un dollar quarante-six, ce qui est insuffisant, donc trois timbres sont requis et les dix-neuf cents de trop sont un trop-perçu que l'opérateur conserve.
La même identité vaut dans toute monnaie : le nombre de timbres nécessaires est le plafond de l'affranchissement restant divisé par la valeur du timbre, et l'affranchissement restant est le dû moins les timbres déjà collés sur la pièce. Un reste nul signifie zéro timbre supplémentaire. Cette page est ce décompte, pas une grille tarifaire.
Elle ne consulte pas les tarifs de USPS, Royal Mail ou La Poste à partir du poids et de la zone — des calculateurs frères tels que le poids taxable et le coût d'expédition par zone répondent à ces recherches. Elle répond à la requête distincte « combien de timbres de cette valeur faciale me faut-il pour couvrir cet affranchissement », celle qu'une personne devant sa table de cuisine avec un carnet de timbres identiques saisit réellement.
Où un décompte de timbres nécessaires rend service
Les foyers et les petits bureaux utilisent un calculateur de timbres postaux nécessaires avant d'aller à la boîte afin qu'une carte de vœux épaisse ou une enveloppe matelassée ne revienne pas pour affranchissement insuffisant. Les commerces en ligne qui expédient encore une fraction des commandes en lettres timbrées — contrats, étiquettes de retour, avis juridiques — peuvent prendre l'affranchissement coté et la dénomination stockée à l'entrepôt et imprimer « apposez N timbres » sur le bon de préparation.
Les équipes financières qui rapprochent le tiroir à timbres de l'affranchissement mécanisé peuvent rejouer chaque montant dû avec la même formule et voir si le personnel a trop apposé. Une validation en échec ne consomme pas le solde.
Documentez la dénomination que vous détenez réellement — la valeur faciale actuelle d'un timbre Forever, un timbre de seconde once ou un définitif local — à côté de l'affranchissement dû, gardez une seule monnaie sur les deux champs, et vous obtenez un décompte reproductible pour enveloppes, colis et feuilles d'audit sans dresser un moteur tarifaire postal à vous.
Cas d’usage
Lettres et cartes de vœux sur la table de cuisine
Consultez l'affranchissement d'une carte de vœux ou d'une enveloppe épaisse, saisissez la valeur faciale des timbres du carnet et apposez le décompte renvoyé afin que la pièce ne revienne pas pour affranchissement insuffisant.
Bons d'entrepôt pour lettres timbrées
Transformez l'affranchissement coté et la dénomination stockée au banc d'emballage en un décompte entier imprimé sur le bon, y compris tout timbre déjà présent sur une enveloppe préaffranchie.
Rapprochement du tiroir à timbres
Rejouez l'affranchissement de chaque envoi avec la même formule de plafond pour expliquer pourquoi un tiroir de timbres identiques a baissé plus vite que ne le suggérerait l'affranchissement mécanisé.
Questions fréquentes
Combien de timbres me faut-il pour couvrir l'affranchissement ?
Divisez l'affranchissement restant par la valeur faciale d'un timbre et arrondissez à l'unité supérieure jusqu'au timbre entier suivant. L'affranchissement restant est le dû moins les timbres de cette dénomination déjà présents sur la pièce. Ce calculateur renvoie ce décompte, la valeur faciale totale et le trop-perçu.
Que se passe-t-il si deux timbres ne suffisent pas ?
Le décompte est un plafond, pas un plancher. Si postage vaut 1.50 et chaque timbre 0.73, deux timbres ne couvrent que 1.46, donc le résultat est trois timbres et 0.69 de trop-perçu. Les opérateurs postaux conservent le reste.
Cet outil consulte-t-il les tarifs postaux officiels selon le poids ?
Non. Vous fournissez l'affranchissement dû par votre transporteur, votre grille ou la balance du bureau de poste. Cet outil répond seulement combien de timbres d'une dénomination couvrent ce dû. Il ne convertit pas les devises et ne mélange pas les dénominations.
Puis-je déduire les timbres déjà collés sur l’enveloppe ?
Oui. Indiquez combien de timbres de même valeur sont déjà collés : leur montant est retiré de l’affranchissement avant le calcul. S’ils le couvrent déjà, le résultat est de zéro timbre supplémentaire.
Combien vais-je payer en trop avec des timbres entiers ?
Le résultat indique le trop-payé au-dessus de l’affranchissement. Pour 1,50 avec des timbres à 0,73, trois timbres font 2,19 : vous payez 0,69 en trop, un montant que conserve l’opérateur postal.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
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)Exemple de requête
{
"postage": 1.5,
"stamp_value": 0.73
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.stamps_needed",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Un appel réussi est facturé au $0.002 publié ; une entrée invalide n'est pas débitée.
Contrat d'entrée, arithmétique en cents entiers et corps de réponse
Les chaînes de chiffres qui s'interprètent comme des nombres finis sont autorisées afin qu'un total de paiement collé n'exige pas une seconde conversion. L'arithmétique s'exécute en cents entiers afin que trois fois soixante-treize cents fasse exactement deux dollars dix-neuf, jamais un reste binaire flottant. Envoyez un corps JSON avec deux montants non négatifs obligatoires dans une seule monnaie : postage (l'affranchissement dû de la lettre ou du colis) et stamp_value (la valeur faciale d'un timbre de la dénomination que vous utiliserez). Envoyez éventuellement already_affixed comme nombre entier de ces timbres déjà présents sur la pièce ; s'il est omis, il vaut zéro. Les alias postage_due, postage_amount, amount_due, required_postage et postage_due_amount sont acceptés pour le premier champ ; denomination, stamp_denomination, face_value, stamp et value pour le second ; affixed, stamps_on_hand, existing_stamps et stamps_affixed pour le décompte. Les champs manquants, chaînes vides, texte non numérique, NaN, Infinity, négatifs et valeurs au-dessus des maxima publiés échouent avec invalid_input en nommant le champ, et ces échecs ne sont pas facturés. stamp_value doit valoir au moins un cent après arrondi à deux décimales. En cas de succès, le corps répète les entrées arrondies, indique postage_remaining comme le dû encore non couvert après les timbres déjà apposés, stamps_needed comme les timbres entiers supplémentaires exigés, stamps_total comme already_affixed plus stamps_needed, value_needed et value_total comme ces décomptes multipliés par la dénomination, overpay comme value_total moins postage, et covers_exactly lorsque ce trop-perçu est zéro. Le champ formula répète stamps_needed = ceil(max(0, postage − already_affixed × stamp_value) / stamp_value) pour l'afficher à côté du résultat. Exemple : postage d'un dollar cinquante et stamp_value de soixante-treize cents, sans rien déjà apposé, donne trois timbres, deux dollars dix-neuf au total et soixante-neuf cents de trop-perçu. Le tarif d'un élément réussi est un $0.002 forfaitaire.
Où un décompte de timbres nécessaires rend service
Les vendeurs de places de marché qui achètent des timbres de type Forever en volume ont besoin d'un plafond déterministe qui ne dépende pas d'une API de transporteur disponible à l'emballage. Comme l'implémentation est parse pur de tier A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Questions techniques
Puis-je soustraire les timbres déjà sur l'enveloppe ?
Oui. Envoyez already_affixed comme entier non négatif. Ces timbres sont valorisés à stamp_value et soustraits de postage avant le plafond. S'ils couvrent déjà le dû, stamps_needed vaut zéro.
Que coûte le calculateur de timbres postaux nécessaires ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.