Budget courses
Avec un budget de 100 et du lait, du pain, des œufs et des pommes pour 10,53 au total, il vous reste 89,47. Après chaque article, le solde restant s'affiche : vous voyez lequel ferait déborder le panier avant la caisse. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Budget
- 100
- Nombre d'éléments
- 4
- Total dépensé
- 10,53
- Restant
- 89,47
- Montant dépassé
- 0
Un suivi de budget courses répond à une question pratique avant la caisse : après cette liste de prix d'articles, combien d'argent vous reste-t-il et avez-vous déjà dépassé la limite ? Acheteurs, planificateurs du foyer et petits outils retail ont besoin d'une réponse déterministe qui ne scrape pas les catalogues ni n'invente de taxes. Ce calculateur de budget courses accepte un budget total et une ou plusieurs lignes de panier avec prix, somme les dépenses, les soustrait du budget et renvoie le solde restant, si le budget est dépassé, de combien, et un solde courant après chaque ligne pour voir quel ajout a fait basculer le panier.
Comment le solde restant et le dépassement sont calculés
Partez d'un budget courses non négatif dans l'unité monétaire déjà utilisée pour les prix en rayon—le calculateur ne convertit pas les devises ni n'applique de taux de change. Pour chaque ligne du panier, prenez un prix fini non négatif ; les noms optionnels étiquettent la ligne à l'affichage. Le total dépensé est la somme de tous les prix de la liste.
Le solde restant égale le budget moins ce total. Quand le restant est nul ou positif, vous restez dans le budget ; quand il est strictement négatif, le budget est dépassé et le montant de dépassement est la valeur absolue du restant. Un budget zéro est autorisé : toute dépense positive est signalée comme dépassement, conforme aux règles d'enveloppe où l'allocation est déjà épuisée.
Les échantillons gratuits au prix zéro sont acceptés et ne changent pas le total. Budgets et prix négatifs sont rejetés car ils ne décrivent ni une allocation d'achat ni un prix de rayon dans ce produit.
Cas d’usage
Enveloppe courses de la semaine
Saisissez votre budget alimentaire hebdomadaire et les prix de rayon pendant vos achats ; surveillez le solde restant et arrêtez-vous quand le panier dépasserait la limite.
Panier partagé du foyer
Les colocataires publient un budget commun et une liste commune pour que chacun voie le même total dépensé, le restant et l'indicateur de dépassement.
Questions fréquentes
Comment fonctionne le calculateur de budget courses ?
Envoyez un budget non négatif et une liste non vide de prix.
Les prix des articles peuvent-ils être zéro ?
Oui. Les échantillons gratuits ou lignes promo au prix 0 sont autorisés.
Faut-il un nom sur chaque ligne du panier ?
Non. Les noms sont optionnels. Les nombres nus sont traités comme prix et les lignes sans nom reçoivent des libellés stables comme Item 1 pour l'affichage.
Que se passe-t-il si je dépasse mon budget ?
Le solde restant devient négatif, le calculateur signale le dépassement et indique de combien le budget est dépassé, c'est-à-dire ce solde négatif sans le signe moins.
Comment savoir quel article m'a fait dépasser le budget ?
Regardez le solde affiché après chaque ligne. Les prix sont déduits dans l'ordre, donc la première ligne où le solde passe sous zéro correspond à l'article qui a fait déborder le panier.
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/life/shopping-budget \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}'const res = await fetch("https://api.kit.forhosting.com/life/shopping-budget", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"budget": 100,
"items": [
{
"name": "Milk 1 L",
"price": 1.49
},
{
"name": "Bread",
"price": 2.25
},
{
"name": "Eggs (12)",
"price": 3.8
},
{
"name": "Apples 1 kg",
"price": 2.99
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/shopping-budget",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"budget": 100,
"items": [
{
"name": "Milk 1 L",
"price": 1.49
},
{
"name": "Bread",
"price": 2.25
},
{
"name": "Eggs (12)",
"price": 3.8
},
{
"name": "Apples 1 kg",
"price": 2.99
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/shopping-budget", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/shopping-budget", 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
{
"budget": 100,
"items": [
{
"name": "Milk 1 L",
"price": 1.49
},
{
"name": "Bread",
"price": 2.25
},
{
"name": "Eggs (12)",
"price": 3.8
},
{
"name": "Apples 1 kg",
"price": 2.99
}
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.shopping_budget",
"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
Une validation échouée—budget manquant, listes vides, prix négatifs—est rejetée en invalid_input et n'est pas facturée.
Comment le solde restant et le dépassement sont calculés
L'endpoint indique aussi le pourcentage de budget utilisé lorsque le budget est strictement positif, de sorte qu'un panier de trente sur une enveloppe de cent affiche trente pour cent utilisés sans forcer les clients à recalculer des ratios. L'arrondi fixe à douze décimales sur les champs monétaires stabilise les goldens navigateur et API entre runtimes sans bruit de flottants sur des sommes simples.
Contrat d'entrée, forme de la réponse et erreurs
Chaque ligne peut être un nombre nu traité comme prix, ou un objet avec price requis et name optionnel. Les listes de plus de cinq cents lignes sont rejetées pour borner le travail pure-parse. Envoyez en POST un corps JSON avec deux champs obligatoires : budget, un nombre fini supérieur ou égal à zéro, et items, un tableau non vide de lignes de panier. Price accepte aussi des alias courants comme cost ou amount ; le champ liste accepte cart, prices, lines et list. Budget accepte limit, max, total_budget et allowance pour réutiliser le vocabulaire d'autres outils monétaires. En cas de succès le corps renvoie le budget, le nombre d'articles, chaque ligne avec nom stable, prix arrondi et restant courant après cette ligne, plus total_spent, remaining, over_budget, over_amount, within_budget, percent_used, une chaîne de formule, un message lisible et des étapes ordonnées pour les fiches. Exemple : budget cent avec lait à one point four nine, pain à two point two five, œufs à three point eight et pommes à two point nine nine donne un total dépensé ten point five three et un restant eighty-nine point four seven avec over_budget false. Si le même budget est associé à des lignes dont la somme dépasse cent, over_budget est true et over_amount indique de combien vous avez dépassé—c'est toujours une réponse de succès, pas une erreur, car le dépassement est la question à laquelle le suivi répond. Budget manquant, items vides, nombres non finis ou prix négatifs échouent avec invalid_input en nommant le champ et ne sont pas facturés.
Où un suivi de budget courses crée de la valeur
Les applications domestiques et listes d'épicerie partagées utilisent un suivi de budget pour que les colocataires voient le solde en cochant les articles sans ouvrir un tableur. Gardez les requêtes petites, figez les totaux arrondis dans les tests, et vous obtenez des soldes reproductibles pour checklists mobiles, plugins LMS et edge workers sans déployer votre propre comptabilité. Les bornes de démonstration retail et sandboxes de formation POS ont besoin d'un oracle déterministe de fonds restants qui n'appelle jamais d'API de prix en direct. Les cours de finance personnelle assignent des exercices panier contre budget ; une API avec restant courant ordonné après chaque ligne permet de noter quelle addition a d'abord dépassé la limite. Les scripts d'automatisation de menus hebdomadaires peuvent poster des totaux d'ingrédients et interrompre le réassort lorsque over_budget passe à true. Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Cas d'intégration
Automatisation du menu hebdomadaire
Les scripts envoient les prix d'ingrédients prévus contre une enveloppe fixe et interrompent le réassort lorsque over_budget devient true.
Questions techniques
Que se passe-t-il si je dépasse le budget ?
L'appel réussit quand même. remaining est négatif, over_budget est true et over_amount indique de combien vous avez dépassé. Le dépassement n'est pas traité comme invalid_input.
Combien coûte le suivi de budget courses ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.