ForHosting KIT · Strumenti per sviluppatori

Calcolatore del resto in contanti

Il calcolatore del resto in contanti determina con precisione quanto denaro deve ricevere un cliente dopo un acquisto.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca il totale finale e il contante consegnato, usando la stessa valuta per entrambi. Lo strumento sottrae i valori con due decimali esatti, evitando le consuete imprecisioni in virgola mobile. È utile in negozi, mercati, eventi scolastici, uffici cassa e ovunque serva un risultato rapido e verificabile.

Inserisca i due importi della transazione

Inizi dal totale finale dell’acquisto, dopo l’applicazione di imposte, sconti, buoni, depositi e altri adeguamenti. Inserisca quindi il contante effettivamente consegnato dal cliente. I due valori devono usare la stessa valuta e contenere al massimo due decimali. Per esempio, se un acquisto costa 13.47 e il cliente consegna 20.00, inserisca tali valori come totale dell’acquisto e importo ricevuto. Non inserisca un’autorizzazione su carta, il saldo di una carta regalo o il valore di un pagamento misto, a meno che la quota in contanti debba coprire da sola l’intero totale visualizzato. Il calcolatore accetta zero, utile per un’operazione interamente scontata, ma non valori negativi. L’API riconosce anche alias chiari, sebbene amount_tendered e purchase_total rendano più leggibili le registrazioni future. Controlli lo scontrino prima del calcolo: una sottrazione precisa non può correggere un totale privo di imposte o contenente un articolo errato. Due input espliciti consentono al cassiere, al cliente o a un revisore di riprodurre facilmente il risultato.

Comprenda come viene calcolato il resto

La regola è semplice: il resto equivale all’importo ricevuto meno il totale dell’acquisto. Il denaro richiede tuttavia una gestione decimale accurata. Il calcolatore converte ogni valore in un numero intero di centesimi prima della sottrazione e riconverte poi il risultato per visualizzarlo. Di conseguenza, 20.00 meno 13.47 produce 6.53 senza rumore binario in virgola mobile. La risposta comprende l’importo ricevuto normalizzato, il totale normalizzato, il valore numerico change_due, la stringa change_due_formatted sempre a due decimali e la formula utilizzata. Un risultato di 0.00 indica che il cliente ha pagato l’importo esatto e non deve ricevere contanti. Se la somma consegnata è inferiore al totale, esiste un ammanco e non un resto; il calcolatore rifiuta l’input e comunica quanto manca. Questa distinzione impedisce di scambiare un numero negativo per denaro da restituire. Lo strumento non sceglie banconote e monete, poiché i tagli dipendono dalla valuta, dal luogo e dal contenuto della cassa. Il suo compito è fornire l’importo aritmetico universale dovuto al cliente.

Utilizzi il risultato in sicurezza alla cassa

Legga ad alta voce il resto formattato, mantenga visibile il denaro ricevuto e conti la somma restituita davanti al cliente prima di riporre il pagamento originale. Un metodo comune parte dal totale dell’acquisto e aggiunge monete e banconote fino a raggiungere l’importo consegnato; il resto calcolato offre un obiettivo indipendente. Per un acquisto di 13.47 pagato con 20.00, l’obiettivo è 6.53, qualunque sia la combinazione di tagli disponibile. Se integra l’API in un sistema di punto vendita, conservi i due input insieme alla risposta affinché una riconciliazione successiva mostri esattamente il calcolo eseguito. Ogni richiesta costa $0.002; il calcolatore nel browser consente una verifica manuale immediata. Il calcolo è deterministico, non consulta la rete e non deduce simboli valutari o tassi di cambio. Rispetti sempre le regole locali di arrotondamento dei contanti quando la moneta più piccola in circolazione vale più di un centesimo. In tali paesi, applichi prima al totale l’arrotondamento previsto dalla legge e utilizzi poi questo risultato come obiettivo per il resto.

Verificare il resto alla cassa

Confermi la somma da restituire quando un cliente paga in contanti il totale finale dello scontrino.

Gestire una cassa temporanea

Offra ai volontari di una raccolta, un mercato o un evento scolastico un metodo coerente per calcolare il resto.

Automatizzare il calcolo nel punto vendita

Invii all’API il contante ricevuto e il totale, quindi registri il risultato deterministico per la riconciliazione.

Quale formula utilizza il calcolatore?

Utilizza change_due = amount_tendered - purchase_total dopo aver convertito entrambi gli importi in centesimi interi.

Che cosa accade se il cliente non consegna contanti sufficienti?

La richiesta restituisce un errore di input indicando l’ammanco, perché un pagamento insufficiente non è resto.

Posso utilizzare qualsiasi valuta?

Sì, purché entrambi gli input usino la stessa valuta e questa sia espressa con due decimali. Il risultato non contiene simboli valutari.

Lo strumento indica quali banconote e monete restituire?

No. Calcola il resto totale; la scelta dei tagli dipende dalla valuta e dal contenuto della cassa.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Può anche usare il calcolatore nel browser per una verifica manuale.

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.

POSThttps://api.kit.forhosting.com/life/change-due

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/life/change-due \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_tendered":20,"purchase_total":13.47}'
{
  "amount_tendered": 20,
  "purchase_total": 13.47
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.change_due",
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →