ForHosting KIT · Utilidades de desarrollo

Calcular saldo de vacaciones acumulado con límite

Esta calculadora convierte una tasa por período de pago en el saldo actual de vacaciones.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Introduzca la cantidad devengada en cada período y el número de períodos completados. Si la política limita el saldo que puede conservar una persona, añada ese máximo. El resultado muestra además el importe sin limitar y si el tope modificó el saldo final, para que usted pueda explicarlo, revisarlo y reutilizarlo con facilidad.

Convierta la política de acumulación en datos correctos

Comience con la tasa indicada en la política de permisos. Puede expresarse en horas por período semanal, quincenal, bimensual o mensual, o en días si la organización registra siempre el permiso en días. Introduzca esa cantidad como tasa y cuente únicamente los períodos realmente completados para la fecha que desea calcular. La herramienta multiplica ambos valores, por lo que deben usar la misma base. Una tasa quincenal debe combinarse con períodos quincenales, no con meses naturales. Se admiten fracciones cuando la política prorratea la acumulación, pero la fracción debe proceder de la regla oficial. No mezcle horas y días: el resultado conserva la unidad de la tasa. La herramienta no deduce calendarios, fechas de contratación ni ciclos de nómina. Así se mantienen visibles los supuestos y RR. HH. o nóminas pueden aportar el recuento exacto reconocido por la política.

Interprete el saldo limitado y el saldo sin límite

El saldo sin límite es la tasa multiplicada por los períodos transcurridos. Si usted no proporciona un máximo, ese producto también es el saldo acumulado y el indicador del límite es falso. Con un máximo, la calculadora compara ambos importes. Si el producto es mayor, el saldo final se reduce al máximo y el indicador pasa a verdadero. El valor original permanece en la respuesta para mostrar cuánto se habría acumulado sin la restricción. Si ambos valores son iguales, no hubo reducción y el indicador sigue siendo falso, aunque ya se haya alcanzado el tope. Un máximo de cero es válido, al igual que una tasa o un número de períodos igual a cero. Solo se elimina el ruido insignificante de coma flotante; no se impone ninguna regla de redondeo de nómina. Aplique el redondeo específico de su organización antes o después del cálculo.

Integre el resultado en procesos de nómina y permisos

Use el saldo acumulado como punto de control, no como libro completo de permisos. Un registro real puede incluir un saldo inicial, tiempo ya utilizado, ajustes manuales, traspasos, carencias y pausas de acumulación. Esta capacidad no inventa esos eventos: responde de forma uniforme cuánto se genera con una tasa fija durante cierto número de períodos, sujeto a un máximo opcional. Por eso resulta útil en hojas de cálculo, estimaciones de incorporación, conciliaciones de nómina, comparaciones de políticas y auditorías automáticas. Conserve los datos de entrada junto al resultado para que otra persona pueda reproducirlo y verificar la versión de la política. Cada solicitud automatizada cuesta $0.002. Las tasas negativas se rechazan; registre consumos y correcciones por separado. Si la tasa cambia durante el año, calcule cada tramo independientemente y combine los resultados según la política aplicable.

Compruebe la acumulación actual

Multiplique la tasa de la política por los períodos completados y compruebe si el máximo limita el resultado.

Concilie los cálculos de nómina

Compare el valor de nómina con un importe sin límite, un saldo final y un indicador de aplicación del tope.

Modele una política de permisos

Pruebe tasas y límites durante un número elegido de períodos sin crear una fórmula en una hoja de cálculo.

¿Cuánto cuesta el cálculo?

Cada solicitud a la API cuesta $0.002. Se contabiliza un elemento por solicitud.

¿Qué unidad utiliza el resultado?

Utiliza la misma unidad que la tasa: horas por período producen horas y días por período producen días.

¿Qué ocurre si se supera el máximo?

El saldo final se fija en el máximo, cap_applied pasa a verdadero y uncapped_balance conserva el producto original.

¿Puede ser negativa la tasa?

No. Una tasa negativa genera un error de entrada no válida. Registre el consumo o las deducciones en otra operación.

¿Se admiten períodos fraccionarios?

Sí, cuando la política prorratea la acumulación y la fracción respeta su propia regla.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

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

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

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}'
{
  "accrual_rate": 3.5,
  "pay_periods_elapsed": 12
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.pto_accrual_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →