One input file in, five outputs back
Send one file per period as CSV (UTF-8, comma separated, header row) or JSON array, by SFTP or REST API. Each line is one event for one employee. Field names below are the defaults; we can map yours.
Monthly input
| Field | Type | Notes |
|---|---|---|
| partner_employee_id | string | Your ID for the employee. Key for every record. |
| period | YYYY-MM | Payroll month. |
| record_type | enum | hire, change, leave, variable, termination |
| effective_date | YYYY-MM-DD | Date the event applies from. |
| first_name, last_name | string | Hires only. |
| tax_code | string(16) | Italian codice fiscale. |
| birth_date | YYYY-MM-DD | Hires only. |
| string | Payslip delivery and contact. | |
| iban | string | Net pay account. |
| address, city, postal_code, province | string | Residence; drives regional and municipal surtaxes. |
| contract_type | enum | permanent, fixed_term |
| ccnl_code | string | Collective agreement; we suggest one at quote stage. |
| level | string | Grade under the CCNL. |
| weekly_hours | number | Full time or part time hours. |
| annual_gross | number (EUR) | Agreed annual gross salary. |
| monthly_installments | 13 | 14 | Set by the CCNL. |
| overtime_hours | number | Per rate type: ot_day, ot_night, ot_holiday. |
| bonus_amount | number (EUR) | One-off bonus for the period. |
| allowance_code, allowance_amount | string, number | Recurring or one-off allowances. |
| expense_amount | number (EUR) | Reimbursements, with receipt reference. |
| meal_voucher_days | integer | Days eligible for meal vouchers. |
| absence_type | enum | vacation, permit, sick, maternity, paternity, unpaid, other |
| absence_from, absence_to | YYYY-MM-DD | Absence period; sick leave needs the certificate number. |
| termination_reason | enum | resignation, dismissal, end_of_term, mutual |
| notes | string | Free text for our ops team; not used in calculations. |
Example (JSON, one record)
{
"partner_employee_id": "EMP-0042",
"period": "2026-11",
"record_type": "variable",
"effective_date": "2026-11-01",
"overtime_hours": { "ot_day": 6 },
"bonus_amount": 500.00,
"absence_type": "vacation",
"absence_from": "2026-11-10",
"absence_to": "2026-11-12"
}Outputs
| Output | Format | Content |
|---|---|---|
| Payroll register | CSV / JSON | One row per employee: gross items, employee contributions, taxable income, IRPEF, regional and municipal surtaxes, deductions, net pay, employer contributions, INAIL, TFR accrual, total employment cost. |
| GL journal | CSV / JSON | Double-entry lines: date, account code (mapped to your chart), cost center, partner_employee_id, debit, credit, currency, description. |
| Payslips | PDF (one per employee) + ZIP | White-label with your logo; file name {period}_{partner_employee_id}.pdf. |
| F24 summary | CSV / JSON + PDF receipt | Tax codes, reference period, amounts by tribute (IRPEF withholding, surtaxes, INPS), payment date and receipt reference. |
| Funding invoice | PDF + JSON | Employment cost on actuals plus partner fees, per client and per employee. |
Validation runs on upload: missing keys, unknown employee IDs and out-of-range values come back as an error file with line numbers, within [1 business hour].