Calcolatore di budget residuo
Con entrate di 5.000 e 2.700 spesi in casa, cibo, trasporti, bollette e abbonamenti, restano 2.300: un avanzo. Elenchi le sue entrate e le sue spese per categoria per vedere quanto rimane nel periodo. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Reddito
- 5000
- Numero di spese
- 5
- Spese totali
- 2700
- Rimanente
- 2300
- Stato
- surplus
Questo calcolatore di budget residuo sottrae un elenco di spese categorizzate dal reddito totale e indica se il periodo si chiude in avanzo o in disavanzo. Invii un income finito e non negativo e almeno una riga di spesa con etichetta category e un amount; il motore somma ogni amount, calcola remaining uguale a income meno quel totale e classifica il segno come surplus, deficit o balanced. Non c'è traiettoria di inflazione, tariffario fiscale né conversione di valuta: soltanto una sottrazione deterministica che Lei può fissare nei test e mostrare accanto al dettaglio per categoria.
Che cosa significa il budget residuo e come si firma l'avanzo o il disavanzo
Il budget residuo è ciò che resta dopo che ogni spesa elencata è stata tolta dal reddito dello stesso periodo: un mese, un ciclo di stipendio o una busta di progetto. Questo calcolatore non prevede l'inflazione, non converte valute e non applica tariffari fiscali. Legge un income finito e non negativo e un elenco di righe di spesa categorizzate, ciascuna con un'etichetta category e un amount nella stessa valuta, poi applica l'identità chiusa remaining uguale a income meno la somma di quegli importi.
Un residuo positivo è un surplus; un residuo negativo è un deficit la cui magnitudine è la carenza; un residuo zero è balanced. Le etichette category viaggiano nella risposta così una famiglia, un'aula o uno script possono mostrare quanta spesa è restata in abitazione rispetto ad alimentari e trasporti. share è l'amount della riga diviso per il totale delle spese, oppure zero quando quel totale è zero. Lo stesso income deve essere non negativo e finito.
Dove un calcolatore di budget residuo merita il proprio posto
Le famiglie usano un calcolatore di budget residuo quando arriva lo stipendio e l'affitto, la spesa, il tragitto, le utenze e gli abbonamenti hanno bisogno di un unico numero residuo prima di pianificare la spesa discrezionale. Gli studenti incontrano la stessa identità nelle unità di finanza personale che chiedono se una busta mensile è in avanzo o in disavanzo data una lista di spese etichettata.
I docenti possono generare chiavi di risposta per redditi modesti senza fidarsi di applicazioni opache che mescolano regole di tasso di risparmio o inflazione in una sottrazione semplice. Gli strumenti di tutoring usano l'importo di surplus o deficit accanto a una barra di avanzamento così chi impara vede il contante residuo, non un muro di righe grezze.
Casi d'uso
Residuo dello stipendio familiare
Sottragga affitto, alimentari, trasporti e bollette dal netto per vedere se il mese si chiude in avanzo o in disavanzo.
Controlli di busta in aula
Consegni agli studenti un elenco di spese etichettato e un reddito noto così possano verificare il budget residuo rispetto alla chiave di avanzo o disavanzo.
Prove deterministiche di budget
Alimenti calcolatori di CI e di prodotto con valori stabili di remaining, surplus e deficit a partire da income e spese categorizzate noti.
Domande frequenti
Come si calcola il budget residuo?
remaining = income − somma di ogni amount di spesa. Un residuo positivo è surplus; un residuo negativo è deficit (riportato come una carenza positiva); lo zero è balanced.
Che cosa accade se un amount di spesa è negativo?
In questo calcolatore i valori di spesa non possono essere negativi e la convalida fallita non è fatturata.
Quali campi deve inviare?
Ogni riga di spesa richiede un category non vuoto e un amount non negativo.
Che cosa significa status nella risposta?
status vale surplus quando remaining è positivo, deficit quando remaining è negativo, e balanced quando remaining è esattamente zero dopo l'arrotondamento a due decimali.
Il calcolatore mostra quanto va a ciascuna categoria?
Sì. Accanto a ogni categoria compare la sua quota della spesa totale. Nell'esempio la casa, con 1.800 su 2.700, vale due terzi di tutto ciò che è stato speso, e si vede subito dove pesa di più il budget.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/fin/budget \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}'const res = await fetch("https://api.kit.forhosting.com/fin/budget", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"income": 5000,
"expenses": [
{
"category": "Housing",
"amount": 1800
},
{
"category": "Food",
"amount": 450
},
{
"category": "Transport",
"amount": 220
},
{
"category": "Utilities",
"amount": 180
},
{
"category": "Subscriptions",
"amount": 50
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/budget",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"income": 5000,
"expenses": [
{
"category": "Housing",
"amount": 1800
},
{
"category": "Food",
"amount": 450
},
{
"category": "Transport",
"amount": 220
},
{
"category": "Utilities",
"amount": 180
},
{
"category": "Subscriptions",
"amount": 50
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/budget", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/budget", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"income": 5000,
"expenses": [
{
"category": "Housing",
"amount": 1800
},
{
"category": "Food",
"amount": 450
},
{
"category": "Transport",
"amount": 220
},
{
"category": "Utilities",
"amount": 180
},
{
"category": "Subscriptions",
"amount": 50
}
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.budget",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Gli importi di spesa negativi sono rifiutati con invalid_input perché, in questo modello, una riga di spesa non può essere inferiore a zero. La stessa aritmetica pura alimenta lo strumento gratuito del browser e il percorso API, così un foglio familiare e uno script di automazione non divergono mai sul residuo.
Che cosa significa il budget residuo e come si firma l'avanzo o il disavanzo
I valori di spesa negativi restano fuori dal modello: una riga di spesa non può essere inferiore a zero, quindi il motore fallisce con invalid_input nominando la riga incriminata invece di trasformare in silenzio un rimborso in un credito. Il percorso è aritmetica pura, senza Date, senza casualità e senza I/O di rete, così gli stessi ingressi producono sempre lo stesso JSON e lo stesso importo di surplus o deficit che Lei può fissare in un foglio o in un test unitario.
Contratto di ingresso, righe rifiutate e forma di una risposta riuscita
Ogni oggetto richiede category, una stringa non vuota dopo il trim, e amount, un numero finito non negativo. Se un amount di spesa è negativo, la richiesta è rifiutata con un messaggio che i valori di spesa non possono essere negativi: è il contratto rigido di questo calcolatore, e quei fallimenti non sono fatturati. I campi monetari sono arrotondati a due decimali; le quote share ne usano dodici. Le chiavi di uscita facoltative sono omesse anziché impostate a null. Invii con POST un corpo JSON con due campi obbligatori. income è il denaro totale disponibile nel periodo; gli alias total_income, salary e revenue sono accettati affinché fogli di calcolo e moduli tipizzati riutilizzino lo stesso contratto. expenses è un array non vuoto da uno a duecento oggetti; gli alias items, costs e spending indicano lo stesso elenco. Su ogni riga si onorano gli alias value e cost di amount. Le stringhe numeriche che si interpretano come decimali finiti sono accettate; stringhe vuote, NaN e Infinity falliscono con invalid_input nominando il campo. Falliscono anche un income assente, un elenco expenses assente o vuoto, un category assente o più di duecento righe. In caso di successo il corpo restituisce income, expense_count e le righe di spesa ripulite con share; segnala total_expenses, remaining, status (surplus, deficit o balanced), surplus (remaining quando positivo, altrimenti zero), deficit (la carenza assoluta quando remaining è negativo, altrimenti zero) e una stringa formula.
Dove un calcolatore di budget residuo merita il proprio posto
In questa pagina il lavoro viene eseguito interamente nel browser; tramite l'API ogni consultazione riuscita costa $0.002, la convalida fallita non è addebitata e nulla viene memorizzato dopo la restituzione della risposta. Abbini l'esecuzione interattiva gratuita all'API a pagamento identica quando passa da una dimostrazione su foglio a una pipeline automatizzata senza cambiare il risultato matematico né reimplementare la sottrazione.
Domande tecniche
Quanto costa il calcolatore di budget?
Lo strumento del browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; un ingresso non valido non è fatturato.