2026-10-01 Release Notes
Attendance > Edit timesheet request
An edit timesheet request — an employee's request to create, edit or delete a shift on their timesheet, going through an approval flow. Approval routing branches on its tri-state approved status and its request_type.
Request
New Field workplace_id has been added
Id of the workplace (location) for the shift.
New Field clock_in_work_area_id has been added
Id of the clock-in work area within the workplace.
New Field clock_out_work_area_id has been added
Id of the clock-out work area within the workplace.
Request
New Field workplace_id has been added
Id of the workplace (location) for the shift.
New Field clock_in_work_area_id has been added
Id of the clock-in work area within the workplace.
New Field clock_out_work_area_id has been added
Id of the clock-out work area within the workplace.
All Responses
New Field workplace_id has been added
Id of the workplace (location) for the shift
New Field clock_in_work_area_id has been added
Id of the clock-in work area within the workplace
New Field clock_out_work_area_id has been added
Id of the clock-out work area within the workplace
Companies > Legal entity
A legal entity of the company — a registered business entity with its own country, currency and legal name. Employees are contracted under a legal entity and finance records are booked against one; a company typically has one legal entity per country it operates in.
All Responses
New Field siret has been added
Siret number (france-specific). system for identifying french establishments. 14-digit identifier for each french establishment.
Compensations > Concept
A compensation concept — the type of pay item a compensation row is classified under (a fixed salary, a bonus, a deduction, ...), carrying its accounting category and unit. The thing compensation rules key on to decide how a row is treated.
Request
New Field enabled has been added
When true, returns active concepts only; when false, only inactive
New Field default has been added
When true, returns only default concepts
All Responses
New Field enabled has been added
Whether the concept is enabled for the company
New Field created_at has been added
Timestamp when the concept was created
New Field updated_at has been added
Timestamp when the concept was last updated
New Endpoint
New Endpoint
Compensations > Cycle
A compensation cycle — a recurring payroll schedule (e.g. monthly) scoped to a country, currency and optional people group, that payroll runs are grouped under.
New Endpoint
Compensations > Employees compensation
An employee compensation row — one concept's amount for one employee within a payroll run, produced by an amount strategy and optionally overridden by a reviewer. The granular unit compensation rules read and compute.
New Endpoint
New Endpoint
New Endpoint
New Endpoint
Compensations > Payroll result
Payroll Result — read-only projection of employee compensation rows with result_type=payroll_result
New Endpoint
Compensations > Payroll run
A payroll run — the batch that compensates a set of employees for a period, moving through a lifecycle (open → completed) and lockable once finalised. Compensation rules and payroll conditions branch on its status, lock state and dates.
New Endpoint
Contracts > Contract version
A contract version — a versioned, effective-dated snapshot of an employee's contract terms (salary, working hours, job title, leveling, trial period, dates). The current terms are the version flagged is_reference. The core record contract and compensation rules read.
All Responses
Modified Field version_data type has been changed to Proc
Country-specific contract data (template fragments and fields).
New Field default_work_type has been added
Internal field used to derive part_time / full_time? from the seeded default work-type row. not intended for direct external use.
Contracts > Reference contract
Contracts reference contract
All Responses
Modified Field version_data type has been changed to Proc
Country-specific contract data (template fragments and fields).
New Field default_work_type has been added
Internal field used to derive part_time / full_time? from the seeded default work-type row. not intended for direct external use.
Expenses > Mileage
A mileage claim — the detail record behind an expensable of type "mileage", reimbursing distance driven on company business (route, distance, rate per unit).
All Responses
New Field rate_measurement_unit has been added
The distance unit the rate is denominated in (e.g. mi). the distance is converted into this unit before the rate is applied.
Finance > Financial document
Financial Document is a document that represents a financial transaction. Could be an invoice, a credit note or receipt.
New Endpoint
Integrations > Sync run
Integrations SyncRun represents a synchronization execution for a marketplace integration. This endpoint is designed to be used by integrators building an integration between Factorial and an external system through the Factorial Integration Framework.
New Endpoint
Integrations > Syncable sync run
Integrations SyncableSyncRun represents a synchronization execution of a SyncableItem within a sync run. A sync run represents each synchronization execution of a set of items. This endpoint is designed to be used by integrators building a integration between Factorial and an external systems.
New Endpoint
ItManagement > Asset category
Global asset category (Group or Subtype in the 2-level taxonomy)
New Endpoint
ItManagement > It asset
IT Asset (device, keys, etc)
Request
New Field asset_category_ids has been added
Asset category ids to filter assets by group
ItManagement > It asset model
IT Asset Model (make/model of device)
Request
New Field asset_category_id has been added
Id of the asset subtype from the it_management.asset_category catalog (e.g. the id of 'vehicles.car'). takes precedence over type_name when both are given.
Request
New Field asset_category_id has been added
Id of the asset subtype from the it_management.asset_category catalog (e.g. the id of 'vehicles.car'). takes precedence over type_name when both are given.
All Responses
New Field asset_category_id has been added
Fk to the leaf assetcategory (subtype). null if not yet categorised.
PayrollEmployees > German employee datum
German-specific payroll data fields for an employee, used for DATEV payroll integrations
New Endpoint
New Endpoint
New Endpoint
Procurement > Po field value
Field value stored for a purchase order (header or line-item level)
New Endpoint
New Endpoint
Procurement > Po line item
A line item within a purchase order
New Endpoint
New Endpoint
Procurement > Po template
Purchase order template that defines the structure and fields of a PO
New Endpoint
New Endpoint
Procurement > Po template field definition
Field definition within a PO template version section
New Endpoint
New Endpoint
Procurement > Po template version
Version history entry for a PO template
New Endpoint
New Endpoint
Procurement > Purchase order
purchase_order
All Responses
New Field po_template_version_id has been added
Identifier of the pinned po template version this purchase order uses. fetch that version (and its field definitions) to interpret the purchase order's header and line-item field keys. null for legacy purchase orders created without a template.
New Endpoint
ProjectManagement > Rate
Project Management Rates
New Endpoint
ProjectManagement > Subproject
Project Management Subprojects
Request
Modified Field name is now mandatory
The name of the subproject.
Modified Field status is now mandatory
The status of the subproject.
ProjectManagement > Time record
Project Management Time Records
Request
New Field imputed_minutes has been added
Imputed minutes for the time record (used when no attendance shift is provided)
New Field date has been added
Reference date for the time record (used when no attendance shift is provided)
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
Request
New Field project_task_ids has been added
Project task ids to retrieve
Request
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
All Responses
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to
New Endpoint
Webhooks
Payloads
New Field siret has been added
Siret number (france-specific). system for identifying french establishments. 14-digit identifier for each french establishment.
Payloads
Modified Field version_data type has been changed to Proc
Country-specific contract data (template fragments and fields).
New Field default_work_type has been added
Internal field used to derive part_time / full_time? from the seeded default work-type row. not intended for direct external use.
Payloads
Modified Field version_data type has been changed to Proc
Country-specific contract data (template fragments and fields).
New Field default_work_type has been added
Internal field used to derive part_time / full_time? from the seeded default work-type row. not intended for direct external use.
Payloads
Modified Field version_data type has been changed to Proc
Country-specific contract data (template fragments and fields).
New Field default_work_type has been added
Internal field used to derive part_time / full_time? from the seeded default work-type row. not intended for direct external use.
Payloads
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to
Payloads
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to
Payloads
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to
Payloads
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to
Payloads
New Field project_task_id has been added
Id of the project task assigned to the time record. refers to project_management/project_tasks endpoint.
New Field employee_id has been added
Id of the employee the time record belongs to
New Field project_id has been added
Id of the project the time record belongs to