ForHosting KIT · Matematica

Saldare spese di gruppo

Inserisca il saldo netto di ogni persona e ottenga una breve lista di chi paga chi: se Alice deve ricevere 50, Bob deve 30 e Carol 20, due pagamenti ad Alice saldano l'intero gruppo. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto

Dopo un viaggio, una convivenza o una cena di squadra, tutti sanno grosso modo chi ha pagato cosa, ma trasformare quei saldi netti in bonifici bancari reali è scomodo. Questo strumento di saldo spese di gruppo prende il saldo netto di ciascuna persona (importo pagato meno importo dovuto) e restituisce un elenco compatto di chi deve pagare chi e quanto, così il gruppo risulta del tutto saldato senza debiti circolari. I saldi positivi indicano che qualcuno deve ricevere denaro; i negativi, che deve ancora. Le somme devono chiudere a zero; in caso contrario il calcolatore rifiuta l’ingresso invece di inventare un residuo silenzioso.

Cosa significano i saldi netti e perché devono sommare a zero

Un saldo netto è la sintesi più semplice delle spese condivise: per ciascuna persona, sottragga ciò che doveva coprire da ciò che ha effettivamente pagato. Se Alice ha pagato sessanta di un conto condiviso e la sua quota equa era quaranta, il suo netto è più venti: deve recuperare venti. Se Bob non ha pagato nulla di un totale di cui deve ancora trenta, il suo netto è meno trenta.

Quando tutte le persone di un gruppo chiuso sono elencate, i netti positivi e negativi si annullano: il denaro uscito dalle tasche del gruppo deve riapparire come un eccedenza di pagamento di qualcun altro. Per questo il calcolatore di saldo richiede che i saldi sommino a zero entro una tolleranza numerica minima. Se la somma non è zero, il foglio è incompleto — manca qualcuno, una quota è stata digitata male o sono state mescolate valute — e inventare trasferimenti nasconderebbe l’errore.

Servono almeno due persone; un solo nome non può saldarsi con se stesso. Ogni nome deve essere univoco affinché l’elenco dei trasferimenti non abbia ambiguità su chi paga chi. I saldi zero sono ammessi: le persone già in pari non compaiono semplicemente come mittenti o destinatari nel risultato.

Come si costruisce l’elenco minimo di trasferimenti

L’algoritmo è il classico flusso di cassa minimo avido delle app di saldo: divide il gruppo in debitori (saldo negativo, devono ancora) e creditori (saldo positivo, devono ricevere). Le copie di lavoro tracciano quanto ogni debitore deve ancora pagare e quanto ogni creditore deve ancora riscuotere. A ogni passo, il maggiore debitore rimanente paga il massimo possibile al maggiore creditore rimanente, producendo un trasferimento di quell’importo; poi entrambe le obbligazioni si riducono.

Quando l’importo rimanente di una persona arriva a zero esce dalla coda; il processo prosegue finché ogni netto diverso da zero è azzerato. Il numero di trasferimenti è al massimo uno in meno del numero di persone con saldo diverso da zero — molto meno che instradare ogni debito attraverso un unico tesoriere quando molti pagamenti bilaterali possono annullarsi localmente. I campi opzionali sono omessi invece di null.

Quando conviene saldare così

Gli organizzatori di viaggio incollano i netti da un foglio e inviano agli amici un breve elenco di pagamenti invece di raccogliere screenshot di tre app diverse. Coinquilini e gruppi di co-living che riconciliano le utenze mensili vogliono un piano riproducibile che funzioni anche quando il netto di un coinquilino è zero. Gli host di hackathon e meetup che anticipano sede o cibo hanno bisogno di un saldo equo senza costruire Splitwise da zero.

I team di prodotto che integrano la finanza di gruppo nei bot di chat chiamano lo stesso modulo puro dello strumento web gratuito, così demo e produzione non divergono su casi limite come gruppi già saldati o scambi a due. La validazione fallita — persone mancanti, nomi duplicati, saldi non finiti o somma diversa da zero — non consuma saldo.

Mantenga le richieste piccole, fissi l’elenco dei trasferimenti nei test e ottiene un piano affidabile di chi deve a chi per eventi, case e automazione senza montare un libro spese completo.

Saldo di viaggio e weekend

Converta il netto pagato-meno-dovuto di ogni viaggiatore in un breve elenco di bonifici bancari così nessuno resta con una ricevuta di debito dopo le vacanze.

Utenze mensili tra coinquilini

Dopo affitto, luce e spesa, saldi i netti residuali con il minor numero di pagamenti da stanza a stanza del mese.

Come si calcolano i trasferimenti di saldo dai saldi di gruppo?

Invii people come un array di {name, balance} dove balance è pagato meno dovuto. Positivo significa che devono ricevere denaro; negativo, che devono.

Perché i saldi devono sommare a zero?

In un gruppo chiuso, eccedenze e sotto-pagamenti si annullano.

Cosa significa un saldo positivo o negativo?

Saldo positivo: la persona ha pagato troppo e deve ricevere denaro. Saldo negativo: ha pagato poco e deve pagare. Zero significa già saldato e non compare nei trasferimenti.

È la stessa cosa che dividere un conto per pesi?

No. Un divisore di spese condivise trasforma importi di voci e pesi nella quota di ciascuna persona. Questo strumento di saldo parte da netti già esistenti e pianifica solo chi paga chi.

Quanti trasferimenti servono per saldare un gruppo?

Al massimo uno in meno del numero di persone con saldo diverso da zero. Con tre persone che devono dare o ricevere bastano due pagamenti, e chi è già in pari non compare nella lista.

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/math/who-owes-who-settle-up

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/math/who-owes-who-settle-up \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"people":[{"name":"Alice","balance":50},{"name":"Bob","balance":-30},{"name":"Carol","balance":-20}]}'
{
  "people": [
    {
      "name": "Alice",
      "balance": 50
    },
    {
      "name": "Bob",
      "balance": -30
    },
    {
      "name": "Carol",
      "balance": -20
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.who_owes_who_settle_up",
  "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.

Cosa significano i saldi netti e perché devono sommare a zero

L’endpoint fallisce quindi con invalid_input e un messaggio chiaro che i saldi devono sommare a zero, così Lei può correggere gli ingressi prima che qualcuno invii denaro.

Come si costruisce l’elenco minimo di trasferimenti

I campi di uscita includono person_count, balance_sum (sempre zero in caso di successo), transfer_count, total_transferred (somma degli importi), transfers come array di from, to e amount, e una breve stringa di riepilogo. Gli importi sono arrotondati per un JSON stabile. Abbini questo endpoint alla Sua interfaccia di libro mastro se serve ricevute o conversione multivaluta; la capacità pianifica solo trasferimenti numerici puri in un’unica unità di conto.

Quando un’API di saldo conviene

Poiché l’implementazione è parse pura di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002, senza token di modello né rete in uscita.

Automazione con bot di chat e foglio

Invii righe di saldi chiusi da un foglio o un bot all’API e ripubblichi il piano di trasferimenti nel canale del gruppo.

Quanto costa il calcolatore di saldo spese di gruppo?

Lo strumento nel browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l’ingresso non valido non viene addebitato.

Leggi la documentazione completa del KIT →