Planificador de turnos rotativos

Rangos inválidos, días de calendario imposibles y campos de ciclo fuera de rango fallan con invalid_input y nunca se facturan.

Qué significa un ciclo rotativo de servicio y descanso para un trabajador

El día cero del ciclo es el primer día de un bloque de servicio cuando cycle_offset vale cero. Para cualquier índice de día i contado desde start_date (base cero), day_in_cycle es el resto de i más cycle_offset dividido por cycle_length, donde cycle_length es on_days más off_days. Si ese resto es estrictamente menor que on_days el día está de servicio (on); en caso contrario está de descanso (off). El clásico 4 sí/4 no usa por tanto on_days cuatro y off_days cuatro, un ciclo de ocho días y una ratio de trabajo a largo plazo de un medio. Poner off_days a cero fuerza todos los días a servicio dentro de la ventana, a veces útil como cuadrante base de disponibilidad total.

Contrato de entrada, forma de la respuesta y reglas de validación

El campo formula reexpresa la regla modular en texto plano para auditorías. Envíe por POST un cuerpo JSON con cuatro campos obligatorios y dos opcionales. start_date y end_date deben ser cadenas de calendario gregoriano reales en forma estricta YYYY-MM-DD; el rango es inclusivo en ambos extremos y end_date no debe preceder a start_date. El tramo inclusivo puede ser como máximo de trescientos sesenta y seis días para que el tamaño de la respuesta quede acotado en el navegador y en los clientes de la API. on_days es un entero positivo de uno a noventa; off_days es un entero de cero a noventa. cycle_offset vale por defecto cero y, si se envía, debe estar entre cero y cycle_length menos uno, de modo que una fase de incorporación a mitad de ciclo no apunte más allá del final del ciclo. worker_name es una etiqueta opcional de como máximo ciento veinte caracteres que se devuelve en el éxito cuando está presente. Se aceptan alias por comodidad: from o begin para start_date, to o until para end_date, work_days para on_days, rest_days para off_days, offset o phase para cycle_offset, y name o employee para worker_name. En el éxito el cuerpo devuelve las fechas y parámetros de ciclo normalizados, pattern como cadena breve del tipo four-on slash four-off, total_days, days_on, days_off, work_ratio redondeada half-up a seis decimales, un array roster de objetos con date, day_in_cycle y status on u off, más los arrays paralelos on_dates y off_dates para filtrar con rapidez. Fechas imposibles como el treinta y uno de abril, un tramo negativo, un tramo por encima del máximo, un on_days cero o no entero, o un cycle_offset igual o mayor que cycle_length fallan con invalid_input nombrando el campo; esos fallos no consumen saldo prepago. El precio de las llamadas correctas es un fijo $0.002 con unidad item.

Dónde aporta valor la expansión del cuadrante rotativo

Los supervisores de planta que planifican un mes 4 sí/4 no necesitan una lista rápida de qué fechas del calendario trabaja un técnico antes de publicar el tablón. Los flujos de alta en RR. Las landings de contenido y SEO que compiten por planificador de turnos rotativos o cuadrante 4 sí/4 no se benefician de una calculadora gratuita en vivo cuyas salidas coinciden byte a byte con la automatización de pago en la lib compartida. Prefiera esta capacidad cuando la pregunta sea la pura expansión de ciclo para una persona; la equidad multi-equipo, las reglas sindicales, las mezclas de habilidades y los calendarios de ausencias exigen un producto de gestión de plantilla más completo. La validación fallida es gratuita, así que los clientes exploratorios pueden probar desfaces inválidos y fechas erróneas con seguridad. HH. pueden pasar la fecha de contratación como start_date con un cycle_offset distinto de cero para que el nuevo incorporado se una a la rotación existente a mitad de ciclo en lugar de reiniciar en el día cero. Los preprocesadores de nómina cuentan days_on dentro de un periodo de pago para contrastar las horas ordinarias esperadas antes de aplicar reglas de horas extra. Los simuladores de plantilla comparan work_ratio entre patrones candidatos—2 sí/2 no frente a 4 sí/4 no frente a 5 sí/2 no—sin escribir scripts a medida cada vez. Los equipos de integración incrustan la API en herramientas internas para que los planificadores no reescriban tablas modulares a mano. Mantenga las peticiones dentro del tope de trescientos sesenta y seis días; para planificación plurianual, llame al endpoint una vez por ventana anual y una los resultados en el cliente.