@factorialco/api-client 3.0.0-beta.2026100135 → 3.0.0-beta.2026100136

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

@@ -2368,6 +2368,238 @@ export type ContractsGermanContractType = {
      */
     name: string;
 };
+export type ContractsContractFlow = {
+    /**
+     * identifier of the contract version created by the change. Refers to the /contracts/contract_versions endpoint.
+     */
+    contract_version_id: string;
+    /**
+     * identifier of the contract opened by the change, under the target legal entity. Refers to the /contracts/contracts endpoint.
+     */
+    contracts_contract_id?: string;
+    /**
+     * employee identifier, refers to /employees/employees endpoint.
+     */
+    employee_id: string;
+    /**
+     * the day the new contract version takes effect. The employee moves to the target legal entity on this date.
+     */
+    effective_on: string;
+    /**
+     * ISO country code the new contract is governed by, taken from the target legal entity.
+     */
+    country?: string;
+    /**
+     * job title of the employee.
+     */
+    job_title?: string;
+    /**
+     * job catalog level identifier, refers to /job_catalog/levels endpoint.
+     */
+    job_catalog_level_id?: string;
+    /**
+     * the uuid node in the job catalog tree. For now it only supports level nodes. From this point in the job catalog tree you can get the full ancestor path to the root node including the role. Refer to job_catalog/tree_nodes endpoint.
+     */
+    job_catalog_tree_node_uuid?: string;
+    /**
+     * the day the new contract starts. Defaults to effective_on.
+     */
+    starts_on?: string;
+    /**
+     * the day the employee is terminated. It has nothing to do with trial period, these are concepts totally unrelated.
+     */
+    ends_on?: string;
+    /**
+     * boolean that indicates if the employee asociated to this contract belongs to a payroll policy.
+     */
+    has_payroll: boolean;
+    /**
+     * a flag that indicates if the contract version has ever had a trial period.
+     */
+    has_trial_period?: boolean;
+    /**
+     * when the trial period ends. If there is no date, it means that the employee has never been in trial. This date is not related with the end date of a contract.
+     */
+    trial_period_ends_on?: string;
+    /**
+     * the amount of money the employee earns in cents.
+     */
+    salary_amount?: number;
+    /**
+     * the frequency of the salary payment.
+     */
+    salary_frequency?: string;
+    /**
+     * the days of the week the employee works.
+     */
+    working_week_days?: string;
+    /**
+     * the amount of hours the employee works.
+     */
+    working_hours?: number;
+    /**
+     * the frequency of the working hours.
+     */
+    working_hours_frequency?: string;
+    /**
+     * the maximum amount of hours the employee can work in a year.
+     */
+    max_legal_yearly_hours?: number;
+    /**
+     * the maximum amount of hours the employee can work in a week.
+     */
+    maximum_weekly_hours?: number;
+    /**
+     * Defines whether a bank holiday should be considered as a workable or non-workable day.
+     */
+    bank_holiday_treatment: 'workable' | 'non_workable';
+    /**
+     * Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
+     */
+    working_time_percentage_in_cents?: number;
+    /**
+     * Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
+     */
+    annual_working_time_distribution?: 'limit_workdays' | 'limit_daily_hours';
+    /**
+     * the minimum amount of minutes the employee must rest between working periods.
+     */
+    min_rest_minutes_between_days?: number;
+    /**
+     * the maximum amount of minutes the employee can work in a day.
+     */
+    max_work_minutes_per_day?: number;
+    /**
+     * the maximum amount of days the employee can work in a row.
+     */
+    max_work_days_in_row?: number;
+    /**
+     * the minimum amount of hours the employee must rest in a row.
+     */
+    min_rest_hours_in_row?: number;
+    /**
+     * the date the contract version was created.
+     */
+    created_at: string;
+    /**
+     * the date of the last contract version update.
+     */
+    updated_at: string;
+    /**
+     * Country-specific contract data, resolved against the target legal entity's template rather than the employee's current one.
+     */
+    version_data?: {
+        country_data?: {
+            /**
+             * Country code (e.g. es, fr, de, pt).
+             */
+            country: string;
+            fields: Array<{
+                name: string;
+                field_name: string;
+                value_label?: string;
+                value_id: string;
+            }>;
+            /**
+             * Identifiers of the materialized_template_fragment records that produced this country data. After a legal entity change they are the target legal entity's fragments.
+             *
+             */
+            template_fragments: {
+                company_fragment_id?: string;
+                country_fragment_id?: string;
+                legal_entity_fragment_id?: string;
+            };
+        };
+    };
+    /**
+     * flag that indicates if the contract has teleworking.
+     */
+    es_has_teleworking_contract?: boolean;
+    /**
+     * the group of cotization of the employee.
+     */
+    contracts_es_tariff_group_id?: string;
+    /**
+     * the group of cotization of the employee.
+     */
+    es_cotization_group?: number;
+    /**
+     * observations of the contract.
+     */
+    es_contract_observations?: string;
+    /**
+     * the job description of the employee.
+     */
+    es_job_description?: string;
+    /**
+     * contract type identifier.
+     */
+    es_contract_type_id?: string;
+    /**
+     * working day type identifier.
+     */
+    es_working_day_type_id?: string;
+    /**
+     * education level identifier.
+     */
+    es_education_level_id?: string;
+    /**
+     * professional category identifier.
+     */
+    es_professional_category_id?: string;
+    /**
+     * employee type.
+     */
+    fr_employee_type?: string;
+    /**
+     * flag that indicates if the employee is allowed to work within the framework of a fixed number of days.
+     */
+    fr_forfait_jours: boolean;
+    /**
+     * the number of days the employee is allowed to work.
+     */
+    fr_jours_par_an?: number;
+    /**
+     * coefficient for france contracts.
+     */
+    fr_coefficient?: string;
+    /**
+     * contract type identifier.
+     */
+    fr_contract_type_id?: string;
+    /**
+     * level identifier.
+     */
+    fr_level_id?: string;
+    /**
+     * step identifier.
+     */
+    fr_step_id?: string;
+    /**
+     * mutual identifier.
+     */
+    fr_mutual_id?: string;
+    /**
+     * professional category identifier.
+     */
+    fr_professional_category_id?: string;
+    /**
+     * work type identifier.
+     */
+    fr_work_type_id?: string;
+    /**
+     * contract type identifier.
+     */
+    de_contract_type_id?: string;
+    /**
+     * Identifier for the German base salary type. References a payroll concept available via the /payroll/concepts endpoint.
+     */
+    de_base_salary_type_id?: string;
+    /**
+     * contract type identifier.
+     */
+    pt_contract_type_id?: string;
+};
 export type ContractsMaterializedTemplate = {
     /**
      * Synthetic identifier for this materialized template, composed as {company_id}-{template_type}-{legal_entity_id}-{country_code}. Used as a stable cursor reference for pagination.
@@ -4897,7 +5129,7 @@ export type IntegrationsSyncableItem = {
     /**
      * Type of the syncable item
      */
-    syncable_type: 'compensations/compensation' | 'expenses/expense' | 'employee_updates/leave' | 'employee_updates/new_hire' | 'employee_updates/termination' | 'employee_updates/worked_time' | 'finance/vendor';
+    syncable_type: 'compensations/compensation' | 'expenses/expense' | 'employee_updates/contract_change' | 'employee_updates/leave' | 'employee_updates/new_hire' | 'employee_updates/personal_change_id' | 'employee_updates/personal_change_name' | 'employee_updates/personal_change_irpf' | 'employee_updates/personal_change_bank' | 'employee_updates/personal_change_gender' | 'employee_updates/personal_change_health_insurance' | 'employee_updates/personal_change_address' | 'employee_updates/personal_change_residence' | 'employee_updates/personal_change_workplace' | 'employee_updates/personal_change_nationality' | 'employee_updates/personal_change_email' | 'employee_updates/personal_change_phone_number' | 'employee_updates/personal_change_permits_and_certificates' | 'employee_updates/personal_change_taxes_and_deductions' | 'employee_updates/personal_change_work_activity' | 'employee_updates/personal_change_birth_name' | 'employee_updates/personal_change_academic_title' | 'employee_updates/personal_change_country_of_birth' | 'employee_updates/personal_change_place_of_birth' | 'employee_updates/termination' | 'employee_updates/worked_time' | 'finance/vendor';
 };
 export type IntegrationsSyncableState = {
     /**
@@ -5550,6 +5782,18 @@ export type PayrollEmployeesGermanEmployeeDatum = {
      * Identifier of the employee
      */
     employee_id: string;
+    /**
+     * Birth name of the employee, if different from the current surname
+     */
+    birth_name?: string;
+    /**
+     * Country of birth of the employee, as a DATEV nationality key
+     */
+    country_of_birth?: string;
+    /**
+     * Place of birth (city) of the employee
+     */
+    place_of_birth?: string;
     /**
      * Expiration date of the employee's work permit
      */
@@ -13513,6 +13757,125 @@ export type GetApi20261001ResourcesContractsGermanContractTypesByIdResponses = {
     200: ContractsGermanContractType;
 };
 export type GetApi20261001ResourcesContractsGermanContractTypesByIdResponse = GetApi20261001ResourcesContractsGermanContractTypesByIdResponses[keyof GetApi20261001ResourcesContractsGermanContractTypesByIdResponses];
+export type PostApi20261001ResourcesContractsLegalEntityChangesData = {
+    body?: {
+        /**
+         * The legal entity the employee is moving to. A new contract and contract version are created under this legal entity.
+         */
+        target_legal_entity_id: string;
+        /**
+         * The terms of the contract version that opens the new contract. Same fields as the contract version create endpoint.
+         */
+        contract_details: {
+            /**
+             * the day the new contract version takes effect. The employee moves to the target legal entity on this date.
+             */
+            effective_on: string;
+            /**
+             * employee identifier, refers to /employees/employees endpoint.
+             */
+            employee_id: string;
+            /**
+             * the day the employee is terminated.
+             */
+            ends_on?: string;
+            /**
+             * a flag that indicates if the employee has a trial period.
+             */
+            has_trial_period?: boolean;
+            /**
+             * the uuid node in the job catalog tree. For now it only supports level nodes. Refer to job_catalog/tree_nodes endpoint.
+             */
+            job_catalog_tree_node_uuid?: string;
+            /**
+             * job title of the employee.
+             */
+            job_title?: string;
+            /**
+             * the amount of money the employee earns in cents. When adding a salary to a contract that previously had none, both salary_amount and salary_frequency must be provided together.
+             */
+            salary_amount?: number;
+            /**
+             * the frequency of the salary payment. When adding a salary to a contract that previously had none, both salary_amount and salary_frequency must be provided together.
+             */
+            salary_frequency?: string;
+            /**
+             * when the trial period ends.
+             */
+            trial_period_ends_on?: string;
+            /**
+             * the amount of hours the employee works.
+             */
+            working_hours?: number;
+            /**
+             * the frequency of the working hours.
+             */
+            working_hours_frequency?: string;
+            /**
+             * the days of the week the employee works.
+             */
+            working_week_days?: string;
+            /**
+             * the maximum amount of hours the employee can work in a year.
+             */
+            max_legal_yearly_hours?: number;
+            /**
+             * the maximum amount of hours the employee can work in a week.
+             */
+            maximum_weekly_hours?: number;
+            /**
+             * Defines whether a bank holiday should be considered as a workable or non-workable day.
+             */
+            bank_holiday_treatment?: 'workable' | 'non_workable';
+            /**
+             * Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
+             */
+            working_time_percentage_in_cents?: number;
+            /**
+             * Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
+             */
+            annual_working_time_distribution?: 'limit_workdays' | 'limit_daily_hours';
+            /**
+             * Identifier for the German base salary type. References a payroll concept available via the /payroll/concepts endpoint.
+             */
+            de_base_salary_type_id?: string;
+            /**
+             * List of country-specific field inputs (e.g. contract_type) for the new version. They are validated against the TARGET legal entity's template: discover valid field_name/value_id combinations via GET /resources/contracts/materialized_templates.
+             *
+             */
+            country_data_inputs?: Array<{
+                /**
+                 * The templated field to set (e.g. contract_type).
+                 */
+                field_name: string;
+                /**
+                 * The id of the option to assign to the field.
+                 */
+                value_id: string;
+                /**
+                 * Only used when the option was sourced from an installed payroll integration (e.g. A3innuva). Leave unset for regular field inputs.
+                 *
+                 */
+                integration_source?: string;
+                /**
+                 * Only used together with integration_source, to label an option that does not yet exist locally. Leave unset for regular field inputs.
+                 *
+                 */
+                label?: string;
+            }>;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/api/2026-10-01/resources/contracts/legal_entity_changes';
+};
+export type PostApi20261001ResourcesContractsLegalEntityChangesResponses = {
+    /**
+     * CREATED
+     */
+    201: ContractsContractFlow;
+};
+export type PostApi20261001ResourcesContractsLegalEntityChangesResponse = PostApi20261001ResourcesContractsLegalEntityChangesResponses[keyof PostApi20261001ResourcesContractsLegalEntityChangesResponses];
 export type GetApi20261001ResourcesContractsMaterializedTemplatesData = {
     body?: never;
     path?: never;
@@ -17806,7 +18169,7 @@ export type PostApi20261001ResourcesIntegrationsSyncableSyncRunsBulkUpsertData =
             /**
              * The Factorial resource type this item maps to. Same values returned by GET /syncable_items.
              */
-            syncable_type: 'compensations/compensation' | 'expenses/expense' | 'employee_updates/leave' | 'employee_updates/new_hire' | 'employee_updates/termination' | 'employee_updates/worked_time' | 'finance/vendor';
+            syncable_type: 'compensations/compensation' | 'expenses/expense' | 'employee_updates/contract_change' | 'employee_updates/leave' | 'employee_updates/new_hire' | 'employee_updates/personal_change_id' | 'employee_updates/personal_change_name' | 'employee_updates/personal_change_irpf' | 'employee_updates/personal_change_bank' | 'employee_updates/personal_change_gender' | 'employee_updates/personal_change_health_insurance' | 'employee_updates/personal_change_address' | 'employee_updates/personal_change_residence' | 'employee_updates/personal_change_workplace' | 'employee_updates/personal_change_nationality' | 'employee_updates/personal_change_email' | 'employee_updates/personal_change_phone_number' | 'employee_updates/personal_change_permits_and_certificates' | 'employee_updates/personal_change_taxes_and_deductions' | 'employee_updates/personal_change_work_activity' | 'employee_updates/personal_change_birth_name' | 'employee_updates/personal_change_academic_title' | 'employee_updates/personal_change_country_of_birth' | 'employee_updates/personal_change_place_of_birth' | 'employee_updates/termination' | 'employee_updates/worked_time' | 'finance/vendor';
             /**
              * Outcome of processing the item
              */
@@ -19045,6 +19408,18 @@ export type PostApi20261001ResourcesPayrollEmployeesGermanEmployeeDataData = {
          * Identifier of the employee
          */
         employee_id: string;
+        /**
+         * Birth name of the employee, if different from the current surname
+         */
+        birth_name?: string;
+        /**
+         * Country of birth of the employee, as a DATEV nationality key
+         */
+        country_of_birth?: string;
+        /**
+         * Place of birth (city) of the employee
+         */
+        place_of_birth?: string;
         /**
          * Expiration date of the employee's work permit
          */
@@ -19161,6 +19536,18 @@ export type PutApi20261001ResourcesPayrollEmployeesGermanEmployeeDataByIdData =
          * Identifier of the German employee data record
          */
         id: string;
+        /**
+         * Birth name of the employee, if different from the current surname
+         */
+        birth_name?: string;
+        /**
+         * Country of birth of the employee, as a DATEV nationality key
+         */
+        country_of_birth?: string;
+        /**
+         * Place of birth (city) of the employee
+         */
+        place_of_birth?: string;
         /**
          * Expiration date of the employee's work permit
          */