ccnl_engine.inputs¶

Months of apprenticeship service elapsed so far, >= 0. Used to look up the applicable apprenticeship_pct in the CCNL percentage track, or the under-classification level in under-classification tracks.

Name of the CCNL apprenticeship track to apply. Required only when more than one track covers the destination level; None lets the engine select the unique applicable track.

When months_elapsed is not a non-negative int or track is not a non-blank string.

Renewals of the fixed-term contract with the same employer, this contract being the last, signed from 14 July 2018 (INPS circ. 121/2019 par. 2.3: earlier renewals are not counted). A prorogation of the term is not a renewal. Each renewal raises the surcharge by 0.5 points. None means not known: a run that owes the increase has a missing_fact blocker.

The exclusion of c. 29 the contract falls in, :attr:NaspiExclusion.NONE when none. None means not known: a run whose sector charges the surcharge has a missing_fact blocker.

When renewals is not a non-negative int or naspi_exclusion names no exclusion.

No exclusion: the surcharge and its renewal increase apply.

Hired to replace absent workers (c. 29 lett. a).

Hired for the seasonal activities of DPR 1525/1963, or for those of the CCNLs of the provincia di Bolzano signed by 31 December 2019 (c. 29 lett. b and b-bis).

Employed by a public administration of art. 1 c. 2 D.Lgs. 165/2001 (c. 29 lett. d).

Special services of at most three days in tourism and public establishments, D.Lgs. 81/2015 art. 29 c. 2 lett. b (c. 29 lett. d-bis).

Teaching or research at a private university, a public research institute, a public company promoting research or a private research body: the 1.4% applies, the renewal increase does not (D.L. 87/2018 art. 1 c. 3).

Manual worker.

Clerical or technical employee.

Middle manager (L. 190/1985).

Executive.

First day of employment.

Last day of employment, or None for an open-ended relationship. Must not precede started_on.

When a date is not a date or ended_on is before started_on.

First day of the employment in the year.

Last day of the employment in the year: its end, or 31 December while the end is not stated.

Whether the employment is fixed-term.

Days of the spell for which no pay at all is due (aspettativa senza assegni), in order: they leave the days of the deductions (AdE circ. 15/E/2007 par. 1.5.1).

When a field is not of its type, or the days are not of one year in order.

Hours per week, > 0.

When value is not an int or is not positive.

Finite :class:~decimal.Decimal number of hours, >= 0.

When value is not a finite Decimal or is negative.

Completed months of recognised service on as_of, >= 0.

Date the months are counted at.

Where the seniority was read from; a string value of :class:SenioritySource is accepted and normalized.

When months is not a non-negative int, as_of is not a date or source names no source.

The personnel file or the libro unico del lavoro.

A previous payslip of the same employment.

The letter of hire, for a seniority recognised on hiring (anzianita convenzionale).

Date of the first contribution credited to any mandatory pension scheme (prima iscrizione), from the worker's contribution statement.

Whether the worker opted for the contributory system (L. 335/1995 art. 1 c. 23). Defaults to False.

When a field is not of its type.

Employer outside the public administrations.

Public administration employer (D.Lgs. 165/2001 art. 1 c. 2).

Code of the fund in the CCNL data, e.g. "ALIFOND".

Contribution the worker chose, as a fraction of the same base as the employer rate, e.g. Decimal("0.01"). It cannot be below the minimum of the CCNL when the bundle records one, except zero: a worker who confers the TFR alone, with no contribution of either side (D.Lgs. 252/2005 art. 8 c. 1).

Whether the TFR accrued is paid to the fund (D.Lgs. 252/2005 art. 8 c. 1-2). Required: the choice is the worker's, and it moves the TFR out of the company.

Whether the worker belongs to the members the CCNL favours for the age at enrolment (Cometa: enrolled after 5 February 2021 before turning 35), read only by a fund with a young_member_rate; None when not stated.

Monthly base the fund applies to the worker, read only by a fund on a conventional base (Previambiente: the base pay of the level at 1 January 1997, its contingenza and one scatto, e.g. 2077.84 for a quadro); None when not stated.

Whether the worker opted to convert the seniority increments into fund contributions, read only by a fund with a seniority_conversion (Previambiente art. 65 lett. A) bis): not unless stated.

Date of the request of a worker already in service (lett. A) bis c. 6): the increments matured by then stay in the pay, frozen, and only the later ones are converted; None for a new hire who opted at the hire (c. 1).

When a field is not of its type, fund_code is empty, employee_rate is outside [0, 1], or zero with no TFR conferred.

Year at whose 31 December the balance is struck.

Balance in EUR, non-negative, with at most two decimals.

When year is not an int from 1900 or amount is not a non-negative Decimal in cents.

Somministrazione di alimenti e bevande (L. 287/1991 art. 5).

Comparto del turismo, other than thermal establishments.

Stabilimenti termali.

Any activity not listed above.

No reduction.

A "zona svantaggiata": 68% less.

A "zona particolarmente svantaggiata (ex montana)": 75% less.

The dependents; a list is accepted and stored as a tuple.

True when the other parent is missing or has not recognized the children, or the children are the worker's alone, and the worker is not married or is legally separated: for the first child the spouse deduction of lett. a applies when more favourable (art. 12 c. 1 lett. c, last period).

Relationship to the worker.

Date of birth. Required for a child: the age band of lett. c is evaluated in every month. Ignored for a spouse or an ascendant.

True when a disability is certified under art. 3 L. 104/1992; a child keeps the deduction from the age of 30.

Dependent's own reddito complessivo of the year (EUR), checked against the limit of art. 12 c. 2; None is unknown.

Percentage of the deduction allocated to this worker (0-100): the share between the parents of lett. c, or the pro quota share of lett. d. None is unknown for a child or an ascendant; a spouse takes the whole deduction, so only None or 100 is accepted for one.

True when the ascendant lives with the worker (Art. 12 c. 1 lett. d post L. 207/2024); None is unknown. Not read for a spouse or a child.

True when the condition of Art. 12 c. 2-bis is met: the worker is an Italian, EU or EEA citizen, or the dependant is not resident abroad. Caller-declared, not engine-verified; None is unknown.

First day the conditions hold; None states that they held before the tax year. Keyword only, required.

Last day the conditions hold; None states that they have not ceased. Keyword only, required.

When a field is not of its type or is outside its range, a child has no birth date, a spouse is allocated less than the whole deduction, or the interval ends before it starts.

Employment income (reddito di lavoro dipendente) of the year before the tax year, in EUR, >= 0. None means not known: the PdR substitute rate is not applied and the L. 199/2025 regimes are unknown, so the result is provisional.

Regimes the worker renounced in writing; their amounts are taxed as ordinary income. String values are accepted and normalized.

The worker's written request to have the IRPEF the conguaglio cannot withhold for lack of pay withheld on the payslips of the next year, with interest (art. 23 c. 3 DPR 600/1973). None: what is not withheld is communicated to the worker. Read on the conguaglio only.

Foreign tax paid on employment income of the tax year, one entry per State, credited at the conguaglio (art. 165 TUIR, art. 23 c. 3 DPR 600/1973). A list is accepted and stored as a tuple.

When employment_income is not a finite, non-negative Decimal, a waiver names no regime, shortfall_deferral is not a request, or two foreign taxes name the same State.

The tax year the income belongs to. Facts of another tax year are not used.

Employment and pension income of the tax year from other employers or payers (e.g. a previous employer of the year), net of their exclusions, >= 0.

INPS base of the worker's other employments of :attr:tax_year, earlier or simultaneous, >= 0. It counts toward the IVS massimale and the additional 1% threshold of the runs whose competence year is :attr:tax_year, and is carried in their closing state (:class:~ccnl_engine.contribution.base.models.InpsBaseYtd).

Every other income of the tax year in the reddito complessivo (land and buildings, self-employment, rents under cedolare secca, art. 3 c. 7 D.Lgs. 23/2011), >= 0.

Income of the main dwelling and its appurtenances included in other_income, excluded from the reddito complessivo of art. 12 (c. 4-bis), >= 0 and not above other_income.

Exempt share of the income of the tax year under art. 44 c. 1 D.L. 78/2010 (researchers), art. 16 D.Lgs. 147/2015 or art. 5 D.Lgs. 209/2023 (impatriati), >= 0. It counts only in the reddito complessivo of the somma esente (L. 207/2024 art. 1 c. 9), not in that of the family deductions.

Date the amounts were stated.

How the amounts are known.

When a field is not of its type or in its range.

Final amounts from a certification (Certificazione Unica of another employer) or from the worker's tax return.

The worker's declaration to the employer of the income expected in the year.

The employer's own estimate: enough for the runs of the year, not for the conguaglio, which then stays provisional.

ISO 3166-1 alpha-2 code of the State, not "IT".

Foreign-source employment income as it entered the Italian taxable income of the tax year (the conventional pay when art. 51 c. 8-bis TUIR applies), in EUR, positive.

Foreign tax paid on it "a titolo definitivo", in EUR, >= 0, within the rate of a tax treaty. Pass it already reduced as art. 165 c. 10 TUIR requires when the income entered the taxable income only in part: on the conventional pay, by the ratio of that pay to the income that would be taxable under art. 51 without c. 8-bis (circ. AdE 9/E/2015 par. 5).

When country is not an ISO code of a foreign State, or an amount is not a finite Decimal in its range.

Date of the written request. It must fall between 1 January of the tax year and the end of February of the next one, the deadline of the conguaglio.

When signed_on is not a date.

Contract-renewal increments (L. 199/2025 art. 1 c. 7).

Night, holiday and shift supplements (L. 199/2025 art. 1 cc. 10-11).

The tax year this calendar applies to.

Ordered tuple of extra-month payment schedules. A list is accepted and stored as a tuple.

When year is not an int from 1970, an extra month is not an :class:ExtraMonthSchedule, a kind appears twice, or a fourteenth month comes without a thirteenth.

The calendar to run instead of the standard one.

Why the standard calendar does not apply.

Free-text justification kept for audit, e.g. the CCNL article or the agreement that sets the payment month. Must not be blank.

When calendar is not a :class:WorkCalendar, reason is not a :class:CalendarOverrideReason or note is blank.

Amounts with their assurance; readiness is reported only.

Amounts are payable only from production rulesets.

Competence runs closed over the employment; carried across tax years.

Payments, YTD accounts and carried obligations of the current tax year; the payments and accounts restart every tax year.

Whether the state accounts for every run of the employment before it. The engine sets it False on the closing state of a run that opened without that history, or of a conguaglio without the residence; a state the caller builds states it.

When a field is not of its type, or a payment of :attr:cash settles a run :attr:accrual has not closed.

Tax year of the totals.

The payments already made this tax year, in payment order (:meth:~ccnl_engine.calendar.payment.models.PaymentId.parse reads "2026-12-regular@2027-01-13"), whatever their competence year. Each must belong to tax_year; its run is closed, so it is rejected if computed again, and each takes a slot of the withholding schedule of the year but an adjustment.

Runs closed in earlier tax years that a run still to compute must follow: with December 2026 paid on 13 January 2027, the other 2026 runs paid in 2026. Payments of tax_year go in payments, not here.

Required. INPS base toward the IVS massimale per competence year: this employment's (own) and the worker's other employments of the same year (other_employers, from their CU or the worker's declaration; INPS circ. 237/2016 par. 3.1; None when not known, which blocks the runs whose contributions could depend on it), with the additional 1% IVS each withheld on it (additional_ivs, other_employers_additional_ivs). Every competence year of payments and competence_runs needs its base; import the year before too when its December is paid in tax_year.

Sickness episodes of the employment up to the last processed day, in start order: they set the waiting period, INPS days and CCNL tier of later episodes.

First day from which sickness_episodes list every sick day of the employment: the first day of the employment when they list all of them. None states the episodes of tax_year only (from 1 January). A CCNL that counts the sickness of earlier years (Federmeccanica: the comporto over three years) has a missing_fact blocker when the days before it could change a sick day it pays.

Contractual gross earnings paid.

IRPEF taxable income.

Employee INPS contributions withheld.

Pension fund contributions already deducted from the taxable income (D.Lgs. 252/2005 art. 8 c. 4).

IRPEF withheld.

Regional and municipal surtax withheld.

Part of surtax_withheld withheld as the municipal acconto of tax_year (D.Lgs. 360/1998 art. 1 c. 5); the conguaglio deducts it from the municipal surtax.

Regional surtax of tax_year a conguaglio at the end of an earlier employment of the year already withheld.

Municipal saldo of tax_year withheld the same way.

Fringe benefit value granted (Art. 51 c. 3 TUIR).

Part of fringe_value already taxed.

Premio di Risultato taxed at the substitute rate.

Trattamento integrativo paid.

Trattamento integrativo already recovered.

Annual trattamento integrativo last computed by the previous provider, None when not known.

Lower snake case reason of that amount, e.g. "full_amount", None when not known.

Somma esente (L. 207/2024) paid.

Somma esente already recovered.

Annual somma esente last computed, or None.

Reason of that amount, or None.

Ulteriore detrazione (L. 207/2024 art. 1 c. 6) already applied by the withholding.

Ulteriore detrazione already taken back.

Annual ulteriore detrazione last computed, or None.

Reason of that amount, or None.

IRPEF due on earlier runs and not yet withheld for lack of pay.

Surtax due on earlier runs and not yet withheld.

Credit recoveries (trattamento integrativo, somma esente, installments) due on earlier runs and not yet withheld for lack of pay.

Night, holiday and shift supplements already taxed at the substitute rate (L. 199/2025 art. 1 cc. 10-11).

Required. Installment recoveries still running, from this tax year or an earlier one; () states that there is none.

Surtax determined by the conguaglio of an earlier tax year and not yet withheld: the regional surtax and municipal saldo of tax_year - 1 and the municipal acconto of tax_year, by the installments still to post. Required: the engine withholds no surtax the previous provider determined unless it is stated here; () states that there is none.

IRPEF the conguaglio of tax_year - 1 deferred on the worker's written request (art. 23 c. 3 DPR 600/1973) and not yet withheld, None without one.

Days in tax_year of the employments whose income the totals hold, when they hold an earlier employment with this employer (a rehire): the art. 13 TUIR deduction counts their union. () states none: the next run adds the days of its own employment.

The competence year.

INPS base of the runs of this employment of :attr:year.

INPS base of the worker's other employments of :attr:year, earlier or simultaneous, as certified (CU) or declared by the worker. It counts toward the massimale and the band of the additional 1% IVS and is never contributed by this employer. None means not known: a run whose contributions could depend on it has a missing_fact blocker; 0 states that there is none.

Additional 1% IVS (D.L. 384/1992 art. 3-ter) this employment withheld on the pay of :attr:year, net of what its conguagli gave back. Negative only when a conguaglio refunded more than this employment withheld, giving back what other employers withheld (INPS circ. 156/2025 par. 5).

Additional 1% IVS the other employments withheld on :attr:other_employers, as certified; the conguaglio deducts it from the 1% due on the year. None when not stated: with a base of other employers the conguaglio then cannot be settled (:attr:other_employers_withheld_unknown).

Competence month of the latest run of this employment, None before the first run of :attr:year.

INPS base of the runs of this employment of :attr:month: the runs of one month share its threshold of the additional 1% IVS.

When a field is not of its type, an amount other than :attr:additional_ivs is negative, an amount is not finite, or :attr:month_base is not zero without a month.

The competence run the payment settles.

Day the run is paid, not before the first day of the run month.

When a field is not of its type or the payment precedes the run month.

Year of the run month (the competence year). The tax year of the run follows from its payment date and can be later.

Run month, 1-12.

Kind of the run.

Number of the run among the runs of its kind and month, from 1. Above 1 only for an adjustment run.

Tax year whose conguaglio found the credit not due. The installments posted in that year enter the recovered total of its :class:~ccnl_engine.balance.cash.account.models.CreditAccount; those posted in a later year are carried: they are deducted on the payslip but belong to no account of the later year.

The installment plan, with the installments still to post.

Identifier for the credit being recovered, e.g. "trattamento_integrativo" or "somma_esente".

Total amount to recover (positive).

Uniform per-period deduction (positive, rounded).

Number of periods over which the recovery runs.

Number of installments already deducted.

What the amount is.

Tax year whose conguaglio determined it; it is withheld in tax_year + 1.

Region code (ISO 3166-2:IT) or Belfiore code of the municipality it is due to: the one of the tax year of the conguaglio, not of the year it is withheld in.

The installments still to post; plan.kind is the component value.

Tax year whose conguaglio found the shortfall; it is withheld in tax_year + 1.

Date of the written request.

First day of the pay period of the conguaglio: the interest runs from its month.

IRPEF still to withhold, positive.