Pianificatore turni rotativi

Un pianificatore di turni rotativi trasforma un semplice schema di ciclo—ad esempio quattro giornate consecutive di lavoro seguite da quattro di riposo—in un roster giorno per giorno per un lavoratore su qualsiasi finestra di calendario inclusiva. Intervalli non validi, giorni di calendario impossibili e campi di ciclo fuori intervallo falliscono con invalid_input e non vengono mai addebitati.

Cosa significa un ciclo rotativo di servizio e riposo per un lavoratore

Gli schemi di turno rotativo come quattro di servizio e quattro di riposo, due e due, o sette e sette sono comuni nelle operazioni continue in cui la copertura deve scorrere in modo uniforme sui giorni del calendario senza fissare sempre gli stessi giorni della settimana. Il modello qui è deliberatamente semplice e trasparente: ogni ciclo è un blocco di giorni lavorativi consecutivi seguito da un blocco di giorni di riposo consecutivi; la coppia si ripete dall’inizio della finestra richiesta. Il 2-2 usa due e due. Ciò che fornisce è un’espansione riproducibile per un solo lavoratore che Lei può esportare in fogli di calcolo, import di timbrature o anteprime paghe senza reimplementare l’aritmetica modulare in ogni client. Il giorno zero del ciclo è il primo giorno di un blocco di servizio quando cycle_offset vale zero. Per qualsiasi indice di giorno i contato da start_date (base zero), day_in_cycle è il resto di i più cycle_offset diviso per cycle_length, dove cycle_length è on_days più off_days. Se quel resto è strettamente minore di on_days il giorno è on; altrimenti è off. Il classico 4-4 usa quindi on_days quattro e off_days quattro, un ciclo di otto giorni e un rapporto di lavoro di lungo periodo di un mezzo. Uno schema 5-2 usa cinque e due e produce un rapporto vicino a cinque settimi, utile quando si desidera più densità di lavoro di una rotazione a metà carico. Impostare off_days a zero forza tutti i giorni on nella finestra, talvolta utile come roster di base di piena disponibilità. Questo strumento non assegna più equipaggi nominati, non salta le festività, non codifica etichette di turno notturno versus diurno oltre allo stato binario on/off e non ribilancia le ore rispetto ai massimi di legge—quei livelli appartengono al Suo sistema HR.

Contratto di ingresso, forma della risposta e regole di validazione

Il campo formula riafferma la regola modulare in testo semplice per le tracce di audit. Invii con POST un corpo JSON con quattro campi obbligatori e due opzionali. start_date e end_date devono essere stringhe di calendario gregoriano reali in forma stretta YYYY-MM-DD; l’intervallo è inclusivo a entrambe le estremità e end_date non deve precedere start_date. L’estensione inclusiva può essere al massimo di trecentosessantasei giorni affinché la dimensione della risposta resti limitata per browser e client API. on_days è un intero positivo da uno a novanta; off_days è un intero da zero a novanta. cycle_offset predefinito è zero e, se fornito, deve stare tra zero e cycle_length meno uno, così una fase di assunzione a metà ciclo non punta oltre la fine del ciclo. worker_name è un’etichetta opzionale di al massimo centoventi caratteri restituita in caso di successo se presente. Sono accettati alias per comodità: from o begin per start_date, to o until per end_date, work_days per on_days, rest_days per off_days, offset o phase per cycle_offset, e name o employee per worker_name. In caso di successo il corpo restituisce le date e i parametri di ciclo normalizzati, pattern come stringa breve del tipo four-on slash four-off, total_days, days_on, days_off, work_ratio arrotondato half-up a sei decimali, un array roster di oggetti con date, day_in_cycle e status on o off, più gli array paralleli on_dates e off_dates per filtrare rapidamente. Date impossibili come il trentuno aprile, un’estensione negativa, un’estensione oltre il massimo, un on_days zero o non intero, o un cycle_offset uguale o maggiore di cycle_length falliscono con invalid_input nominando il campo; tali fallimenti non consumano il saldo prepagato. Il prezzo delle chiamate riuscite è un fisso $0.002 con unità item.

Dove l’espansione del roster rotativo rende

I supervisori di sito che pianificano un mese 4-4 hanno bisogno di un elenco rapido di quali date del calendario un tecnico lavora prima di pubblicare la bacheca. Le landing di contenuto e SEO che puntano a pianificatore di turni rotativi o roster 4-4 beneficiano di un calcolatore gratuito dal vivo le cui uscite coincidono byte per byte con il percorso di automazione a pagamento sulla lib condivisa. Preferisca questa capacità quando la domanda è la pura espansione di ciclo per una persona; equità multi-equipaggio, regole sindacali, mix di competenze e calendari di assenza richiedono un prodotto di workforce management più completo. La validazione fallita è gratuita, così i client esplorativi possono provare offset non validi e date errate in sicurezza. I flussi di onboarding HR possono passare la data di assunzione come start_date con un cycle_offset non zero così il nuovo assunto entra nella rotazione esistente a metà ciclo invece di ripartire dal giorno zero. I preprocessori paghe contano days_on all’interno di un periodo di paga per verificare le ore ordinarie attese prima di applicare le regole di straordinario. I simulatori di organico confrontano work_ratio tra schemi candidati—2-2 versus 4-4 versus 5-2—senza scrivere script su misura ogni volta. I team di integrazione incorporano l’API in strumenti interni così i pianificatori non riscrivono a mano le tabelle modulari. Mantenga le richieste entro il tetto di trecentosessantasei giorni; per la pianificazione pluriennale chiami l’endpoint una volta per finestra annuale e unisca i risultati lato client.