@rippling/rippling-sdk 0.2.0-alpha.95 → 0.2.0-alpha.97

package/src/resources/draft-transitions.ts

@@ -0,0 +1,583 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as BusinessPartnersAPI from './business-partners';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Proposed changes to existing workers that can be reviewed in Rippling
+ */
+export class DraftTransitions extends APIResource {
+  /**
+   * Retrieve a specific draft transition
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<DraftTransitionRetrieveResponse> {
+    return this._client.get(path`/draft-transitions/${id}/`, options);
+  }
+
+  /**
+   * Create a new draft transition
+   */
+  create(
+    body: DraftTransitionCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<DraftTransitionCreateResponse> {
+    return this._client.post('/draft-transitions/', { body, ...options });
+  }
+}
+
+/**
+ * Meta information for the response.
+ */
+export interface DraftTransitionRetrieveResponse extends BusinessPartnersAPI.Meta {
+  /**
+   * Effective timestamp applied to the entire draft transition request.
+   */
+  effective_at: string;
+
+  /**
+   * Draft transition items to accept for asynchronous processing.
+   */
+  items: Array<DraftTransitionRetrieveResponse.Item>;
+
+  /**
+   * IANA timezone used to interpret and display the request's effective timestamp.
+   */
+  timezone: string;
+}
+
+export namespace DraftTransitionRetrieveResponse {
+  export interface Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    changes: Item.Changes;
+
+    /**
+     * Target role identifier for this draft transition item.
+     */
+    role_id: string;
+
+    /**
+     * Controls whether this item should append to a compatible existing draft or
+     * create a new draft.
+     */
+    draft_grouping_preference?: 'APPEND_TO_MATCHING_DRAFT' | 'CREATE_NEW_DRAFT';
+  }
+
+  export namespace Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    export interface Changes {
+      /**
+       * Country-specific field changes supported by current draft transition flows.
+       */
+      country_specific_info?: unknown;
+
+      /**
+       * Employment information changes for the target role.
+       */
+      employment_info?: Changes.EmploymentInfo;
+
+      /**
+       * Work location changes for the target role.
+       */
+      work_location_info?: Changes.WorkLocationInfo;
+    }
+
+    export namespace Changes {
+      /**
+       * Employment information changes for the target role.
+       */
+      export interface EmploymentInfo {
+        /**
+         * New annual salary equivalent.
+         */
+        annual_salary_equivalent?: number;
+
+        /**
+         * New compensation currency.
+         */
+        currency?: string;
+
+        /**
+         * New department identifier for the target role.
+         */
+        department_id?: string;
+
+        /**
+         * New company employment type identifier for the target role.
+         */
+        employment_type_id?: string;
+
+        /**
+         * New offer letter equity share count.
+         */
+        equity_num_shares?: number;
+
+        /**
+         * New offer letter equity value.
+         */
+        equity_value?: number;
+
+        /**
+         * New equity vesting package identifier.
+         */
+        equity_vesting_package_id?: string;
+
+        /**
+         * New job family identifier for the target role.
+         */
+        job_family_id?: string;
+
+        /**
+         * New level identifier for the target role.
+         */
+        level_id?: string;
+
+        /**
+         * New manager role identifier for the target role.
+         */
+        manager_id?: string;
+
+        /**
+         * New annual on-target commission amount.
+         */
+        on_target_commission?: number;
+
+        /**
+         * New relocation reimbursement amount.
+         */
+        relocation_reimbursement?: number;
+
+        /**
+         * New compensation amount per salary unit.
+         */
+        salary_per_unit?: number;
+
+        /**
+         * New salary unit.
+         */
+        salary_unit?: string;
+
+        /**
+         * New start date for the target role.
+         */
+        start_date?: string;
+
+        /**
+         * New target annual bonus amount.
+         */
+        target_annual_bonus?: number;
+
+        /**
+         * New target annual bonus payment frequency.
+         */
+        target_annual_bonus_payment_frequency_unit?: 'MONTH' | 'QUARTER' | 'YEAR' | 'SEMI_ANNUAL';
+
+        /**
+         * New target annual bonus percentage.
+         */
+        target_annual_bonus_percent?: number;
+
+        /**
+         * New team identifiers for the target role.
+         */
+        teams_ids?: Array<string>;
+
+        /**
+         * New job title for the target role.
+         */
+        title?: string;
+      }
+
+      /**
+       * Work location changes for the target role.
+       */
+      export interface WorkLocationInfo {
+        /**
+         * New work country code for the target role.
+         */
+        country_code?: string;
+
+        /**
+         * New work location identifier for the target role.
+         */
+        location_id?: string;
+      }
+    }
+  }
+}
+
+export interface DraftTransitionCreateResponse {
+  /**
+   * Effective timestamp applied to the entire draft transition request.
+   */
+  effective_at: string;
+
+  /**
+   * Draft transition items to accept for asynchronous processing.
+   */
+  items: Array<DraftTransitionCreateResponse.Item>;
+
+  /**
+   * IANA timezone used to interpret and display the request's effective timestamp.
+   */
+  timezone: string;
+}
+
+export namespace DraftTransitionCreateResponse {
+  export interface Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    changes: Item.Changes;
+
+    /**
+     * Target role identifier for this draft transition item.
+     */
+    role_id: string;
+
+    /**
+     * Controls whether this item should append to a compatible existing draft or
+     * create a new draft.
+     */
+    draft_grouping_preference?: 'APPEND_TO_MATCHING_DRAFT' | 'CREATE_NEW_DRAFT';
+  }
+
+  export namespace Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    export interface Changes {
+      /**
+       * Country-specific field changes supported by current draft transition flows.
+       */
+      country_specific_info?: unknown;
+
+      /**
+       * Employment information changes for the target role.
+       */
+      employment_info?: Changes.EmploymentInfo;
+
+      /**
+       * Work location changes for the target role.
+       */
+      work_location_info?: Changes.WorkLocationInfo;
+    }
+
+    export namespace Changes {
+      /**
+       * Employment information changes for the target role.
+       */
+      export interface EmploymentInfo {
+        /**
+         * New annual salary equivalent.
+         */
+        annual_salary_equivalent?: number;
+
+        /**
+         * New compensation currency.
+         */
+        currency?: string;
+
+        /**
+         * New department identifier for the target role.
+         */
+        department_id?: string;
+
+        /**
+         * New company employment type identifier for the target role.
+         */
+        employment_type_id?: string;
+
+        /**
+         * New offer letter equity share count.
+         */
+        equity_num_shares?: number;
+
+        /**
+         * New offer letter equity value.
+         */
+        equity_value?: number;
+
+        /**
+         * New equity vesting package identifier.
+         */
+        equity_vesting_package_id?: string;
+
+        /**
+         * New job family identifier for the target role.
+         */
+        job_family_id?: string;
+
+        /**
+         * New level identifier for the target role.
+         */
+        level_id?: string;
+
+        /**
+         * New manager role identifier for the target role.
+         */
+        manager_id?: string;
+
+        /**
+         * New annual on-target commission amount.
+         */
+        on_target_commission?: number;
+
+        /**
+         * New relocation reimbursement amount.
+         */
+        relocation_reimbursement?: number;
+
+        /**
+         * New compensation amount per salary unit.
+         */
+        salary_per_unit?: number;
+
+        /**
+         * New salary unit.
+         */
+        salary_unit?: string;
+
+        /**
+         * New start date for the target role.
+         */
+        start_date?: string;
+
+        /**
+         * New target annual bonus amount.
+         */
+        target_annual_bonus?: number;
+
+        /**
+         * New target annual bonus payment frequency.
+         */
+        target_annual_bonus_payment_frequency_unit?: 'MONTH' | 'QUARTER' | 'YEAR' | 'SEMI_ANNUAL';
+
+        /**
+         * New target annual bonus percentage.
+         */
+        target_annual_bonus_percent?: number;
+
+        /**
+         * New team identifiers for the target role.
+         */
+        teams_ids?: Array<string>;
+
+        /**
+         * New job title for the target role.
+         */
+        title?: string;
+      }
+
+      /**
+       * Work location changes for the target role.
+       */
+      export interface WorkLocationInfo {
+        /**
+         * New work country code for the target role.
+         */
+        country_code?: string;
+
+        /**
+         * New work location identifier for the target role.
+         */
+        location_id?: string;
+      }
+    }
+  }
+}
+
+export interface DraftTransitionCreateParams {
+  /**
+   * Effective timestamp applied to the entire draft transition request.
+   */
+  effective_at: string;
+
+  /**
+   * Draft transition items to accept for asynchronous processing.
+   */
+  items: Array<DraftTransitionCreateParams.Item>;
+
+  /**
+   * IANA timezone used to interpret and display the request's effective timestamp.
+   */
+  timezone: string;
+}
+
+export namespace DraftTransitionCreateParams {
+  export interface Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    changes: Item.Changes;
+
+    /**
+     * Target role identifier for this draft transition item.
+     */
+    role_id: string;
+
+    /**
+     * Controls whether this item should append to a compatible existing draft or
+     * create a new draft.
+     */
+    draft_grouping_preference?: 'APPEND_TO_MATCHING_DRAFT' | 'CREATE_NEW_DRAFT';
+  }
+
+  export namespace Item {
+    /**
+     * Requested role/profile changes for this item.
+     */
+    export interface Changes {
+      /**
+       * Country-specific field changes supported by current draft transition flows.
+       */
+      country_specific_info?: unknown;
+
+      /**
+       * Employment information changes for the target role.
+       */
+      employment_info?: Changes.EmploymentInfo;
+
+      /**
+       * Work location changes for the target role.
+       */
+      work_location_info?: Changes.WorkLocationInfo;
+    }
+
+    export namespace Changes {
+      /**
+       * Employment information changes for the target role.
+       */
+      export interface EmploymentInfo {
+        /**
+         * New annual salary equivalent.
+         */
+        annual_salary_equivalent?: number;
+
+        /**
+         * New compensation currency.
+         */
+        currency?: string;
+
+        /**
+         * New department identifier for the target role.
+         */
+        department_id?: string;
+
+        /**
+         * New company employment type identifier for the target role.
+         */
+        employment_type_id?: string;
+
+        /**
+         * New offer letter equity share count.
+         */
+        equity_num_shares?: number;
+
+        /**
+         * New offer letter equity value.
+         */
+        equity_value?: number;
+
+        /**
+         * New equity vesting package identifier.
+         */
+        equity_vesting_package_id?: string;
+
+        /**
+         * New job family identifier for the target role.
+         */
+        job_family_id?: string;
+
+        /**
+         * New level identifier for the target role.
+         */
+        level_id?: string;
+
+        /**
+         * New manager role identifier for the target role.
+         */
+        manager_id?: string;
+
+        /**
+         * New annual on-target commission amount.
+         */
+        on_target_commission?: number;
+
+        /**
+         * New relocation reimbursement amount.
+         */
+        relocation_reimbursement?: number;
+
+        /**
+         * New compensation amount per salary unit.
+         */
+        salary_per_unit?: number;
+
+        /**
+         * New salary unit.
+         */
+        salary_unit?: string;
+
+        /**
+         * New start date for the target role.
+         */
+        start_date?: string;
+
+        /**
+         * New target annual bonus amount.
+         */
+        target_annual_bonus?: number;
+
+        /**
+         * New target annual bonus payment frequency.
+         */
+        target_annual_bonus_payment_frequency_unit?: 'MONTH' | 'QUARTER' | 'YEAR' | 'SEMI_ANNUAL';
+
+        /**
+         * New target annual bonus percentage.
+         */
+        target_annual_bonus_percent?: number;
+
+        /**
+         * New team identifiers for the target role.
+         */
+        teams_ids?: Array<string>;
+
+        /**
+         * New job title for the target role.
+         */
+        title?: string;
+      }
+
+      /**
+       * Work location changes for the target role.
+       */
+      export interface WorkLocationInfo {
+        /**
+         * New work country code for the target role.
+         */
+        country_code?: string;
+
+        /**
+         * New work location identifier for the target role.
+         */
+        location_id?: string;
+      }
+    }
+  }
+}
+
+export declare namespace DraftTransitions {
+  export {
+    type DraftTransitionRetrieveResponse as DraftTransitionRetrieveResponse,
+    type DraftTransitionCreateResponse as DraftTransitionCreateResponse,
+    type DraftTransitionCreateParams as DraftTransitionCreateParams,
+  };
+}

package/src/resources/earnings-inputs.ts

@@ -83,6 +83,18 @@ export interface EarningsInputListResponse {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */
@@ -159,6 +171,18 @@ export interface EarningsInputCreateResponse {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */
@@ -233,6 +257,18 @@ export interface EarningsInputCreateParams {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */