ForHosting KIT · Strumenti per sviluppatori

Calcolo delle ferie maturate con limite aziendale

Questo calcolatore trasforma il tasso di maturazione per periodo di paga nel saldo ferie corrente.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca la quantità maturata in ogni periodo e il numero di periodi completati. Se la politica limita il saldo conservabile, aggiunga il massimo. La risposta mostra anche l'importo senza limite e indica se il tetto ha modificato il saldo finale, così Lei può spiegare, verificare e riutilizzare facilmente il calcolo.

Converta la politica di maturazione nei dati corretti

Parta dal tasso previsto dalla politica sui congedi. Può essere espresso in ore per periodo settimanale, bisettimanale, quindicinale o mensile, oppure in giorni se l'organizzazione registra sempre le ferie in giorni. Inserisca tale valore come tasso e conteggi soltanto i periodi realmente completati alla data di riferimento. Il calcolatore moltiplica i due valori, che devono quindi usare la stessa base. Un tasso bisettimanale va abbinato a periodi bisettimanali, non a mesi di calendario. Sono ammesse frazioni se la politica prevede il proporzionamento, ma la frazione deve derivare dalla regola ufficiale. Non mescoli ore e giorni: il risultato conserva l'unità del tasso. Lo strumento non presume calendario, data di assunzione o ciclo paghe. Le ipotesi restano trasparenti e l'ufficio personale o paghe può fornire il conteggio esatto riconosciuto dalla politica.

Comprenda il saldo con e senza limite

Il saldo senza limite è il tasso moltiplicato per i periodi trascorsi. Se non viene indicato un massimo, quel prodotto coincide con il saldo maturato e l'indicatore del limite è falso. Quando è presente un massimo, il calcolatore confronta i valori. Se il prodotto è maggiore, il saldo finale viene ridotto al massimo e l'indicatore diventa vero. Il valore originario resta nella risposta per mostrare quanto sarebbe maturato senza la restrizione. Se prodotto e massimo coincidono, non è avvenuta alcuna riduzione; l'indicatore rimane quindi falso anche se il limite è stato raggiunto. Sono validi un massimo, un tasso o un numero di periodi pari a zero. Viene eliminato soltanto il rumore numerico insignificante, senza imporre regole di arrotondamento delle paghe. Applichi la regola aziendale prima o dopo il calcolo.

Inserisca il risultato nei processi paghe e ferie

Usi il saldo maturato come punto di controllo, non come registro completo. Un registro effettivo può richiedere anche saldo iniziale, ferie utilizzate, rettifiche, riporti, attese e sospensioni della maturazione. Questa capacità non presume tali eventi: risponde alla domanda specifica di quanto produca un tasso fisso in un dato numero di periodi, soggetto a un massimo facoltativo. È utile per fogli di calcolo, stime di inserimento, riconciliazioni paghe, confronti tra politiche e audit automatici. Conservi gli input insieme all'output, affinché un revisore possa riprodurre il valore e verificare la versione della politica. Ogni richiesta automatizzata costa $0.002. I tassi negativi vengono rifiutati; registri separatamente utilizzi e correzioni. Se il tasso cambia durante l'anno, calcoli ogni tratto e combini i risultati secondo la politica.

Casi d'uso

Verificare la maturazione corrente

Moltiplichi il tasso per i periodi completati e controlli se il massimo limita il risultato.

Riconciliare i calcoli delle paghe

Confronti il dato paghe con importo senza limite, saldo finale e indicatore del tetto.

Simulare una politica ferie

Provi tassi e massimali su periodi scelti senza predisporre una formula in un foglio elettronico.

Domande frequenti

Quanto costa il calcolo?

Ogni richiesta API costa $0.002. Viene conteggiato un elemento per richiesta.

Quale unità usa il risultato?

La stessa del tasso: ore per periodo producono ore e giorni per periodo producono giorni.

Che cosa accade oltre il massimo?

Il saldo finale viene fissato al massimo, cap_applied diventa vero e uncapped_balance conserva il prodotto.

Il tasso può essere negativo?

No. Un tasso negativo genera un errore di input. Registri utilizzi e detrazioni con un'operazione separata.

Sono ammessi periodi frazionari?

Sì, se la politica prevede il proporzionamento e la frazione ne rispetta la regola.

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

POSThttps://api.kit.forhosting.com/biz/pto-accrual-calc

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/biz/pto-accrual-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accrual_rate":3.5,"pay_periods_elapsed":12}'

const res = await fetch("https://api.kit.forhosting.com/biz/pto-accrual-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "accrual_rate": 3.5,
    "pay_periods_elapsed": 12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/pto-accrual-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "accrual_rate": 3.5,
    "pay_periods_elapsed": 12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/pto-accrual-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"accrual_rate":3.5,"pay_periods_elapsed":12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"accrual_rate":3.5,"pay_periods_elapsed":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/pto-accrual-calc", 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

{
  "accrual_rate": 3.5,
  "pay_periods_elapsed": 12
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.pto_accrual_calc",
  "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

per richiesta$0.002

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.

Leggi la documentazione completa del KIT →