@factorialco/api-client 3.0.0-beta.2026100127 → 3.0.0-beta.2026100128

package/dist/cjs/generated/types.gen.d.ts

@@ -1497,15 +1497,15 @@ export type CompensationsEmployeesCompensation = {
      */
     amount_is_overwritten: boolean;
     /**
-     * Row projection type (always `compensation` on this endpoint)
+     * Record projection type (always `compensation` on this endpoint)
      */
     result_type?: 'compensation' | 'payroll_result';
     /**
-     * Source type discriminator (nullable — dashboard-created rows have no source)
+     * Source type discriminator (nullable — dashboard-created records have no source)
      */
     source_type?: 'compensations_compensationpolicy' | 'timesettings_customtimerangecategory' | 'expenses_expensable' | 'expenses_expense' | 'expenses_mileage' | 'benefits_compensation' | 'salary_advance_request' | 'incentives_compensationplanrequest' | 'attendance_review';
     /**
-     * Source id (nullable — dashboard-created rows have no source)
+     * Source id (nullable — dashboard-created records have no source)
      */
     source_id?: string;
     /**
@@ -1629,6 +1629,44 @@ export type CompensationsPayrollRun = {
      */
     updated_at?: string;
 };
+export type CompensationsPayrollRunEmployeesCompensation = {
+    /**
+     * Payroll run employee compensation id
+     */
+    id: string;
+    /**
+     * Employee id (participant of the payroll run)
+     */
+    payroll_run_employee_id: string;
+    /**
+     * Payroll concept id
+     */
+    payroll_concept_id: string;
+    /**
+     * Parent payroll run id
+     */
+    payroll_run_id: string;
+    /**
+     * Record projection type — `compensation` (input) or `payroll_result` (computed)
+     */
+    result_type: string;
+    /**
+     * Amount strategy discriminator
+     */
+    amount_strategy_type: 'compensations_fixed_amount_strategy' | 'compensations_variable_amount_strategy' | 'compensations_per_worked_day_amount_strategy';
+    /**
+     * When the record was created
+     */
+    created_at: string;
+    /**
+     * When the record was last updated
+     */
+    updated_at: string;
+    /**
+     * Aggregated compensation value for this concept and employee within the payroll run, in minor units. For `payroll_result` records, this is the value the bookkeeper computed for that concept (e.g. net pay).
+     */
+    amount?: number;
+};
 export type ContractsCompensation = {
     /**
      * Unique identifier of the compensation
@@ -10991,6 +11029,10 @@ export type PostApi20261001ResourcesAttendanceShiftsData = {
          * Id of the location related
          */
         workplace_id?: string;
+        /**
+         * Id of the project worker the shift is imputed to. A time record for that project is created with the shift.
+         */
+        project_worker_id?: string;
     };
     path?: never;
     query?: never;
@@ -12149,7 +12191,7 @@ export type PutApi20261001ResourcesCompensationsEmployeesCompensationsByIdData =
         id: string;
         amount?: number;
         /**
-         * Manual override of the strategy-computed amount; not allowed on fixed-strategy rows (422 `overwrite_not_applicable`)
+         * Manual override of the strategy-computed amount; not allowed on fixed-strategy records (422 `overwrite_not_applicable`)
          */
         amount_overwritten?: number;
         /**
@@ -12311,6 +12353,65 @@ export type GetApi20261001ResourcesCompensationsPayrollRunsByIdResponses = {
     200: CompensationsPayrollRun;
 };
 export type GetApi20261001ResourcesCompensationsPayrollRunsByIdResponse = GetApi20261001ResourcesCompensationsPayrollRunsByIdResponses[keyof GetApi20261001ResourcesCompensationsPayrollRunsByIdResponses];
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Payroll run employee compensation ids
+         */
+        'ids[]'?: Array<string>;
+        /**
+         * Filter by payroll run ids, refers to compensations/payroll_runs endpoint.
+         */
+        'payroll_run_ids[]'?: Array<string>;
+        /**
+         * Filter by employee ids (participants of the payroll run)
+         */
+        'payroll_run_employee_ids[]'?: Array<string>;
+        /**
+         * Filter by payroll concept ids, refers to compensations/concepts endpoint.
+         */
+        'payroll_concept_ids[]'?: Array<string>;
+        /**
+         * Filter by record projection type — `compensation` (input) or `payroll_result` (computed)
+         */
+        result_type?: 'compensation' | 'payroll_result';
+        /**
+         * Filter by legal entity ids, refers to companies/legal_entities endpoint.
+         */
+        'legal_entity_ids[]'?: Array<string>;
+    };
+    url: '/api/2026-10-01/resources/compensations/payroll_run_employees_compensations';
+};
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsResponses = {
+    /**
+     * OK
+     */
+    200: {
+        data?: Array<CompensationsPayrollRunEmployeesCompensation>;
+        meta?: PagedIndexMeta;
+    };
+};
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsResponse = GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsResponses[keyof GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsResponses];
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Payroll run employee compensation ids
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/2026-10-01/resources/compensations/payroll_run_employees_compensations/{id}';
+};
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsByIdResponses = {
+    /**
+     * OK
+     */
+    200: CompensationsPayrollRunEmployeesCompensation;
+};
+export type GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsByIdResponse = GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsByIdResponses[keyof GetApi20261001ResourcesCompensationsPayrollRunEmployeesCompensationsByIdResponses];
 export type GetApi20261001ResourcesContractsCompensationsData = {
     body?: never;
     path?: never;
@@ -14179,7 +14280,7 @@ export type PostApi20261001ResourcesDocumentsDocumentsRestoreFromTrashBinRespons
 export type PostApi20261001ResourcesDocumentsDownloadUrlsBulkCreateData = {
     body?: {
         /**
-         * list of document identifiers.
+         * list of document identifiers (between 1 and 100).
          */
         ids?: Array<string>;
     };
@@ -14448,11 +14549,15 @@ export type PutApi20261001ResourcesEmployeesEmployeesByIdData = {
          */
         country?: string;
         /**
-         * bank account number of the employee.
+         * bank account number of the employee, in the format given by bank_number_format.
          */
         bank_number?: string;
         /**
-         * code to identify banks and financial institutions globally.
+         * format of bank_number. Required when bank_number is set.
+         */
+        bank_number_format?: 'iban' | 'sort_code_and_account_number' | 'routing_number_and_account_number' | 'clabe' | 'other' | 'bank_name_and_account_number';
+        /**
+         * SWIFT/BIC for iban, the sort code for sort_code_and_account_number, the routing number for routing_number_and_account_number, the bank name for bank_name_and_account_number. Required for those three formats.
          */
         swift_bic?: string;
         /**
@@ -24137,7 +24242,7 @@ export type GetApi20261001ResourcesTimeoffAllowanceStatsData = {
          */
         'ids[]'?: Array<string>;
         /**
-         * Get the allowance stats for specific employees
+         * IDs of the employees to read allowance stats for, at most 25 per request. Leave it empty to read every employee you have access to. Naming an employee you cannot access returns an empty page rather than the stats for the others.
          */
         'employee_ids[]'?: Array<string>;
         /**
@@ -24149,7 +24254,7 @@ export type GetApi20261001ResourcesTimeoffAllowanceStatsData = {
          */
         reference_date?: string;
         /**
-         * When provided, computes the stats as if the employee were moved to this target time off policy effective the day AFTER reference_date, so pass the day before the change date - for a change effective on 2026-08-03, send reference_date=2026-08-02. This truncates the source policy's current cycle at that boundary so available_days reflects the prorated balance that would actually transfer or be discarded on the change, rather than the full entitlement. Purely a read - nothing is persisted. Requires the policy timeline feature; without it the result is identical to an un-simulated read.
+         * When provided, computes the stats as if the employee were moved to this target time off policy effective the day AFTER reference_date, so pass the day before the change date - for a change effective on 2026-08-03, send reference_date=2026-08-02. This truncates the source policy's current cycle at that boundary so available_days reflects the prorated balance that would actually transfer or be discarded on the change, rather than the full entitlement. Purely a read - nothing is persisted. Requires the policy timeline feature; without it the result is identical to an un-simulated read. Can only be used together with employee_ids, because a simulation needs every employee in the read to belong to the target policy's company - which a company-wide read cannot guarantee.
          */
         simulate_policy_change_to_id?: string;
     };
@@ -24974,6 +25079,10 @@ export type PostApi20261001ResourcesTimeoffPoliciesData = {
          * Company ID.
          */
         company_id?: string;
+        /**
+         * ID of an existing policy to copy. When set, the new policy is created with a copy of that policy's allowances and no employees assigned. Omit it to create a policy from scratch.
+         */
+        based_on_policy_id?: string;
     };
     path?: never;
     query?: never;
@@ -26571,7 +26680,7 @@ export type PostApi20261001ResourcesTrainingsTrainingMembershipsBulkCreateData =
         /**
          * ids for the accesses to be assigned in a training
          */
-        employee_ids: Array<string>;
+        employee_ids?: Array<string>;
         /**
          * Training id to be assigned
          */