ccnl_engine.events¶

Start date (or sole date) of the absence.

Number of absent hours. Must be > 0.

Rate at which the pay is deducted in EUR. Must be > 0.

Last day of the absence range. None for single-day absences where event_date is both start and end. When set must be >= event_date.

True when the absence suspends the employment, so its calendar days do not accrue tredicesima and quattordicesima ratei (for example aspettativa non retribuita, or the congedo for serious family reasons of art. 4 c. 2 L. 53/2000); False when its days accrue the ratei. The caller states it: the engine does not decide which absences suspend accrual under the CCNL. None means not known: the days count as accruing, and a rateo they could change has a missing_fact blocker.

True when no pay at all is due for every calendar day of the absence (aspettativa senza assegni): the days leave the days of the art. 13 TUIR deductions (AdE circ. 15/E/2007 par. 1.5.1: "vanno sottratti i giorni per i quali non spetta alcuna retribuzione"). False for a strike, an absence of hours or one whose days stay paid in part, which reduce nothing ("nessuna riduzione [...] in caso di giornate di sciopero"). None means not known: the days stay counted and a withholding run has a missing_fact blocker.

Date the arrears are attributed to.

Gross arrears amount in EUR. Must be >= 0.

Caller-supplied rate of the separate taxation: the rate on half the income of the two years before the year of receipt (art. 21 c. 1 TUIR; art. 23 c. 1 D.Lgs. 117/2026 from 2027). Must be in [0, 1].

The competence period the arrears refer to. An earlier tax year selects the separate taxation, the tax year of the run the ordinary one, a later year is rejected. None leaves the taxation undetermined: the run taxes the arrears separately as a simulation, with a missing_fact blocker.

Date the contribution is attributed to.

Employee-side contribution in EUR. Must be >= 0.

EmployerProfile-side contribution in EUR. Must be >= 0.

Date the bonus is attributed to.

Gross bonus amount in EUR. Must be >= 0.

"productivity_bonus" routes the amount through the PdR substitute-tax regime (L. 208/2015 art. 1 cc. 182-190). "contract_renewal" marks a salary increment paid under a CCNL renewal, for the renewal substitute-tax regime (L. 199/2025 art. 1 c. 7). "bonus" (the default) applies ordinary IRPEF.

Signing date of the CCNL renewal a "contract_renewal" increment is paid under. The renewal substitute tax applies only to renewals signed within the window of the regime (1 January 2024 to 31 December 2026); None means not known: ordinary IRPEF and a provisional result. Only allowed with kind="contract_renewal".

Date the benefit is attributed to.

Value of the fringe benefit in EUR. Must be >= 0.

Calendar date the holiday or rest day was worked.

Flat supplement for the day in EUR. Must be >= 0.

Calendar date the shift was worked.

Flat supplement for the night period in EUR. Must be >= 0.

Calendar date the overtime was worked.

Number of overtime hours, above 0 and at most the 744 hours of a month of 31 days.

Base hourly rate in EUR. Must be > 0.

Overtime multiplier applied to the hourly rate (e.g. 1.25 for 25% supplement). Must be > 0. None (the default) derives it from the CCNL band of kind as 1 + band; the run is rejected when the CCNL has no single percentage band for it. An explicit value prevails over the CCNL band.

When the hours were worked, selecting the CCNL band.

Daytime overtime on a working day (straordinario diurno).

Night overtime (straordinario notturno).

Overtime on a public holiday or rest day (straordinario festivo).

Overtime on the weekly rest day (Sunday, or the day the rest moves to) where the CCNL pays it apart from the public holidays; a CCNL without a rest-day band pays it as HOLIDAY.

Night overtime on a public holiday (straordinario festivo notturno).

Calendar year (e.g. 2026).

Month of competence, 1-12.

Calendar date the shift was worked.

Shift allowance in EUR. Must be >= 0.

First day of the sick-leave period.

Total employer-liable sick-leave gross in EUR, before carenza deduction.

Total working days of the sick-leave spell. Must be >= 1. Used to compute the daily rate for the carenza deduction. Defaults to 1.

Number of carenza days (waiting period) at the start of the sick-leave period. Must not exceed sick_days. Defaults to 0 (no carenza).

Stable identifier of the episode, the same in every run (e.g. the protocol number of the first certificate).

First day of illness.

Last day of illness on the certificates known so far. A later run may pass a later day when the illness is extended.

Identifier of the episode this one continues, when the certificate marks it as a relapse (ricaduta): the days of both count as one episode, so no new waiting period applies.

Whether the CCNL exempts the absence from the lower pay of repeated absences (for Federmeccanica: a hospital stay or day hospital, sickness during a certified pregnancy, or one of the diseases the CCNL lists; for Commercio, Art. 187: a hospital stay, day hospital or dialysis, an initial prognosis of at least 12 days, the listed diseases, or a pregnancy); None when not stated. Read only by a CCNL that reduces short absences or the carenza by event, when the reduction could apply.

Hospital stays within the episode, each its first and last day; () for none, None when not stated. Read only by a CCNL that pays long stays in full.

Whether the illness is one the CCNL treats as particularly serious (Logistica: INPS circ. 95/2016); None when not stated. Read only by a CCNL with such a treatment.

Whether the absence is a periodic check of a worker who had an invalidating illness (Concia art. 60 B), which a CCNL may leave out of the comporto; None when not stated.

Daily contributions of the worker from 1 January of the year before the episode, every employer counted (spettacolo: art. 66 D.L. 73/2021); None when not stated. Read only by an INPS regime with a requirement.

Days of work activity of a fixed-term worker in the 12 months before the episode, with every employer (D.L. 463/1983 art. 5 c. 1); None when not stated. Read only for a fixed-term contract, which pays sickness for no more days.

When the identifier is blank, a day is not a date, short_absence_exempt is not a bool, prior_worked_days is not an int in [0, 366], the episode ends before it starts or continues itself.

Date the standby is attributed to: the rates in force on it apply.

Unit of the standby.

Hours, days or weeks of the unit, above 0.

Calls followed by an intervention, each paid the CCNL fee.

Hours of standby, paid at the working-day rate per hour.

Day of 16 hours on a working day.

Day of 24 hours on a rest day.

Day of 24 hours on a public holiday.

Week of 6 days.

Week of 6 days with a public holiday.

Week of 6 days with a public holiday and a rest day.

Date of cessazione.

Total TFR payout in EUR. Must be >= 0.

Applicable tassazione separata rate. Must be in [0, 1].

Date the block of days is attributed to.

Days of trasferta, at least 1.

Whether the trasferta is outside the comune of the place of work: within it no part is exempt.

"one" when meals or lodging are reimbursed or provided free, "both" when both are, "none" otherwise: the cap is reduced by one third or by two thirds. Required: "none" gives the largest exemption.

Allowance paid for each day in EUR, above 0; None takes the CCNL amount for :attr:hours_away.

Hours away of each day, read with daily_amount None to select the CCNL span.

What enters the TFR base: "none", "whole", or "above_exempt" (the part above the exemption); None takes the CCNL rule, required without one.

Whether the trasferta is abroad, with the higher cap.

Whether the worker is bound by contract to work in places always different (art. 51 c. 6 TUIR, 50% exempt): not supported, the event is rejected.

When a field is invalid, neither daily_amount nor hours_away is given, or trasfertista is True.

Date the benefit is attributed to.

Value of the welfare benefit in EUR. Must be >= 0.