Calcolatore paga per ore

Una tariffa oraria negativa viene respinta con un errore chiaro invalid_input, perché un salario negativo non descrive un calcolo di lordo valido.

Ingressi: ore lavorate, tariffa oraria, moltiplicatore extra e soglia opzionale

I conteggi ore negativi, i moltiplicatori negativi e le soglie negative sono respinti anch'essi, così un'inversione accidentale di segno fallisce in modo rumoroso invece di inventare negativi assurdi su una cedolina. Tutta la convalida avviene prima di qualunque matematica monetaria, così le richieste errate non producono mai righe di paga a metà. Lei invia il totale delle ore, non una scissione preventiva di regolari contro extra: il calcolatore esegue quella scissione dalla soglia che ha scelto o dal valore predefinito di quaranta. Invii un corpo JSON con tre campi obbligatori e un taglio opzionale. hours_worked è il tempo totale sull'orologio della finestra di paga, numero finito non negativo o stringa numerica; si accettano gli alias hours, hrs, total_hours e weekly_hours quando il Suo client nomina già il campo in altro modo. hourly_rate è il salario base all'ora come numero finito non negativo o stringa numerica; gli alias rate, wage, hourly e pay_rate si mappano sullo stesso valore così i costruttori di moduli conservano etichette familiari. overtime_multiplier è il premio espresso come multiplo della tariffa base —ad esempio 1.5 significa tempo e mezzo e 2 significa doppio tempo—, non una percentuale del salario; gli alias multiplier, ot_multiplier, ot_rate e premium si mappano sullo stesso campo. overtime_threshold è opzionale e vale quaranta ore per omissione, il tetto settimanale comune del tempo normale; gli alias threshold, ot_threshold, regular_limit e cutoff Le consentono di nominare una regola giornaliera di otto ore o un tetto settimanale locale senza cambiare il resto del contratto. Le tariffe orarie negative falliscono la convalida con invalid_input perché non descrivono una busta paga normale. Tariffe, totali di ore, moltiplicatori o soglie estremamente grandi sono limitati perché la matematica del Worker isolate resti delimitata. La mancanza di qualunque campo obbligatorio fallisce con invalid_input nominando la chiave assente.

Come si calcolano le ore extra, il pagamento extra e il lordo

Le formule centrali sono quelle che già si usano a mano su un foglio presenze, salvo che la scissione delle ore extra è fatta per Lei. Il lordo è la somma di quelle due righe. I prodotti intermedi usano l'aritmetica in virgola mobile ordinaria; poi ogni campo monetario è arrotondato half-up a due decimali perché i risultati sembrino valuta su una cedolina e non lunghe frazioni binarie. Esempio: una tariffa di venti, quarantotto ore lavorate, un moltiplicatore di 1.5 e la soglia predefinita di quaranta produce quaranta ore regolari, otto extra, ottocento di pagamento regolare, duecentoquaranta di extra, una tariffa extra effettiva di trenta e un lordo di millequaranta dopo l'arrotondamento. Se le ore restano alla soglia o sotto, le ore extra e il pagamento extra sono zero e il lordo è semplicemente tariffa per ore. La stessa matematica per ogni giurisdizione è un perimetro di prodotto intenzionale: tabelle di legge, regole del settimo giorno e trattenute fiscali sarebbero intenzioni di ricerca e contratti distinti. Le ore regolari equivalgono al minore tra hours_worked e overtime_threshold. Le ore extra equivalgono al maggiore tra hours_worked meno la soglia e zero. Il pagamento regolare è uguale a hourly_rate per le ore regolari. Il pagamento extra è uguale a hourly_rate per overtime_multiplier per le ore extra. La risposta restituisce anche ot_hourly_rate come hourly_rate per il moltiplicatore così le interfacce mostrano il salario extra effettivo accanto alla tariffa base. La risposta ecoa la tariffa oraria normalizzata, hours_worked, overtime_threshold e overtime_multiplier, poi restituisce ore regolari, ore extra, ot_hourly_rate, regular_pay, overtime_pay e gross_pay, più currency_decimals uguale a due e method uguale a hours_pay_gross per una ramificazione stabile del client. Ingressi identici producono sempre JSON identico perché il percorso è aritmetica pura senza rete, senza seme casuale e senza orologio a muro.

Uso dell'API, prezzi, flussi di lavoro e limiti pratici

Usi l'API prepagata quando un bot HR, una dashboard di freelancing, un portale del personale o un aiuto-foglio presenze necessita di un contratto KIT stabile a $0.002 per elemento riuscito; i fallimenti di convalida non consumano mai saldo dopo il rifiuto del motore. Abbini questo endpoint a strumenti fiscali o di detrazione solo se già conosce a parte le regole del netto: questa capacità non trattiene imposte, non applica benefit e non converte valute. Gli autori che spediscono SDK possono mappare regular_pay, overtime_pay e gross_pay direttamente in interfacce di cedolina e messaggi di stima. Quando cita il prezzo dell'API nel testo di prodotto, usi il segnaposto di catalogo $0.002 così le pagine pubblicate restano allineate al pavimento di prezzo in tempo reale.