ForHosting KIT · Ferramentas para dev

Calcule férias acumuladas com limite da política

Esta calculadora transforma uma taxa por período de pagamento no saldo atual de férias.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe quanto é adquirido em cada período e quantos períodos foram concluídos. Se a política limitar o saldo que uma pessoa pode manter, informe também esse teto. A resposta exibe o valor sem limite e indica se o teto alterou o saldo final, permitindo que você explique, revise e reutilize o cálculo com facilidade.

Converta a política de acúmulo em entradas corretas

Comece pela taxa definida na política de afastamentos. Ela pode estar em horas por período semanal, quinzenal, semimensal ou mensal, ou em dias quando a organização sempre controla férias em dias. Informe esse valor como taxa e conte somente os períodos efetivamente concluídos até a data desejada. A calculadora multiplica os dois valores, portanto ambos precisam seguir a mesma base. Uma taxa quinzenal deve ser combinada com períodos quinzenais, e não com meses do calendário. Frações são aceitas quando a política prevê proporcionalidade, mas devem seguir a regra oficial. Não misture horas e dias, pois o resultado mantém a unidade da taxa. A ferramenta não presume calendário, data de admissão ou ciclo da folha. Isso deixa as premissas transparentes e permite que RH ou folha forneçam a contagem exata reconhecida pela política.

Entenda os saldos com e sem teto

O saldo sem teto corresponde à taxa multiplicada pelos períodos decorridos. Sem um máximo informado, esse produto também será o saldo acumulado e o indicador do teto será falso. Com um máximo, a calculadora compara os valores. Se o produto for maior, o saldo acumulado será reduzido ao teto e o indicador será verdadeiro. O valor original permanece na resposta para mostrar quanto seria acumulado sem a restrição. Quando produto e teto forem iguais, nenhuma redução ocorreu; por isso, o indicador continua falso, embora o limite tenha sido alcançado. Um teto igual a zero é válido, assim como taxa ou quantidade de períodos igual a zero. O cálculo remove apenas ruído insignificante de ponto flutuante e não impõe regras de arredondamento da folha. Aplique a regra específica da organização antes de enviar os dados ou depois de receber o resultado.

Use o resultado em rotinas de folha e férias

Trate o saldo acumulado como um ponto de conferência, não como um livro completo de férias. Um controle real também pode exigir saldo inicial, férias já usadas, ajustes, transferência, carência e pausas no acúmulo. Esses eventos não são presumidos. A capacidade responde a uma pergunta objetiva: quanto foi acumulado com uma taxa fixa durante determinado número de períodos, sujeito a um teto opcional? Ela serve para planilhas, estimativas de admissão, conciliação da folha, comparação de políticas e auditorias automatizadas. Guarde as entradas com a saída para que outra pessoa possa reproduzir o número e confirmar a versão da política. Cada solicitação automatizada custa US$ 0,002. Taxas negativas são rejeitadas; registre uso e correções separadamente. Se a taxa mudar no ano, calcule cada trecho de forma independente e combine os resultados conforme a política.

Casos de uso

Confira o acúmulo atual

Multiplique a taxa da política pelos períodos concluídos e veja se o teto limita o resultado.

Concilie os cálculos da folha

Compare o valor da folha com o montante sem teto, o saldo final e o indicador de limite.

Simule uma política de férias

Teste taxas e tetos ao longo de períodos escolhidos sem montar uma fórmula em planilha.

Perguntas frequentes

Quanto custa o cálculo?

Cada solicitação à API custa US$ 0,002. É contabilizado um item por solicitação.

Qual unidade aparece no resultado?

A mesma unidade da taxa: horas por período geram horas; dias por período geram dias.

O que ocorre ao ultrapassar o teto?

O saldo final assume o máximo, cap_applied fica verdadeiro e uncapped_balance preserva o produto original.

A taxa pode ser negativa?

Não. Uma taxa negativa gera erro de entrada inválida. Registre uso ou descontos em outra operação.

Posso usar períodos fracionários?

Sim, quando a política prevê proporcionalidade e a fração segue a regra estabelecida.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

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

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

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

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.pto_accrual_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →