fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/employees/benefits/client.rb

@@ -0,0 +1,656 @@
+# frozen_string_literal: true
+require_relative "../../../requests"
+require_relative "../../types/employee_benefit"
+require "json"
+require_relative "types/benefits_create_request_contribution"
+require_relative "types/benefits_create_request_deduction_reduces_taxable_income"
+require_relative "types/benefits_update_request_contribution"
+require_relative "types/benefits_update_request_deduction_reduces_taxable_income"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../../requests"
+
+module Gusto
+  module Employees
+    class BenefitsClient
+    # @return [Gusto::RequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Employees::BenefitsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  Returns an array of all employee benefits for this employee
+#  Benefits containing PHI are only visible to applications with the
+#  `employee_benefits:read:phi` scope.
+#  scope: `employee_benefits:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+      # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::EmployeeBenefit>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.list(employee_id: "employee_id")
+      def list(employee_id:, page: nil, per: nil, request_options: nil)
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/employee_benefits"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json&.map do | item |
+          item = item.to_json
+          Gusto::EmployeeBenefit.from_json(json_object: item)
+        end
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param company_benefit_uuid [String] The UUID of the company benefit.
+      # @param active [Boolean] Whether the employee benefit is active.
+      # @param employee_deduction [String] The amount to be deducted, per pay period, from the employee's pay.
+      # @param deduct_as_percentage [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param employee_deduction_annual_maximum [String] The maximum employee deduction amount per year. A null value signifies no limit.
+      # @param contribution [Hash] An object representing the company contribution type and value.Request of type Gusto::Employees::Benefits::BenefitsCreateRequestContribution, as a Hash
+      #   * :type (Gusto::Employees::Benefits::BenefitsCreateRequestContributionType) 
+      #   * :value (Hash)
+      # @param elective [Boolean] Whether the company contribution is elective (aka "matching"). For `tiered`,
+#  `elective_amount`, and `elective_percentage` contribution types this is ignored
+#  and assumed to be `true`.
+      # @param company_contribution_annual_maximum [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+      # @param limit_option [String] Some benefits require additional information to determine their limit. For
+#  example, for an HSA benefit, the limit option should be either "Family" or
+#  "Individual". For a Dependent Care FSA benefit, the limit option should be
+#  either "Joint Filing or Single" or "Married and Filing Separately".
+      # @param catch_up [Boolean] Whether the employee should use a benefit’s "catch up" rate. Only Roth 401k and
+#  401k benefits use this value for employees over 50.
+      # @param coverage_amount [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+      # @param coverage_salary_multiplier [String] The coverage amount as a multiple of the employee’s salary. Only applicable for
+#  Group Term Life benefits. Note: cannot be set if coverage amount is also set.
+      # @param deduction_reduces_taxable_income [Gusto::Employees::Benefits::BenefitsCreateRequestDeductionReducesTaxableIncome] Whether the employee deduction reduces taxable income or not. Only valid for
+#  Group Term Life benefits. Note: when the value is not "unset", coverage amount
+#  and coverage salary multiplier are ignored.
+      # @param company_contribution [String] The amount to be paid, per pay period, by the company.
+      # @param contribute_as_percentage [Boolean] Whether the company contribution amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.create(
+#    employee_id: "employee_id",
+#    company_benefit_uuid: "f68abb42-431e-4392-bc3f-2795627e00f3",
+#    active: true,
+#    employee_deduction: "100.00",
+#    contribution: { type: AMOUNT, value: "100.00" }
+#  )
+      def create(employee_id:, company_benefit_uuid:, active: nil, employee_deduction: nil, deduct_as_percentage: nil, employee_deduction_annual_maximum: nil, contribution: nil, elective: nil, company_contribution_annual_maximum: nil, limit_option: nil, catch_up: nil, coverage_amount: nil, coverage_salary_multiplier: nil, deduction_reduces_taxable_income: nil, company_contribution: nil, contribute_as_percentage: nil, request_options: nil)
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), company_benefit_uuid: company_benefit_uuid, active: active, employee_deduction: employee_deduction, deduct_as_percentage: deduct_as_percentage, employee_deduction_annual_maximum: employee_deduction_annual_maximum, contribution: contribution, elective: elective, company_contribution_annual_maximum: company_contribution_annual_maximum, limit_option: limit_option, catch_up: catch_up, coverage_amount: coverage_amount, coverage_salary_multiplier: coverage_salary_multiplier, deduction_reduces_taxable_income: deduction_reduces_taxable_income, company_contribution: company_contribution, contribute_as_percentage: contribute_as_percentage }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/employee_benefits"
+end
+        Gusto::EmployeeBenefit.from_json(json_object: response.body)
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  Benefits containing PHI are only visible to applications with the
+#  `employee_benefits:read:phi` scope.
+#  scope: `employee_benefits:read`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.get(employee_benefit_id: "employee_benefit_id")
+      def get(employee_benefit_id:, request_options: nil)
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+        Gusto::EmployeeBenefit.from_json(json_object: response.body)
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param version [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/versioning#object-layer) for
+#  information on how to use this field.
+      # @param active [Boolean] Whether the employee benefit is active.
+      # @param employee_deduction [String] The amount to be deducted, per pay period, from the employee's pay.
+      # @param deduct_as_percentage [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param employee_deduction_annual_maximum [String] The maximum employee deduction amount per year. A null value signifies no limit.
+      # @param contribution [Hash] An object representing the type and value of the company contribution.Request of type Gusto::Employees::Benefits::BenefitsUpdateRequestContribution, as a Hash
+      #   * :type (Gusto::Employees::Benefits::BenefitsUpdateRequestContributionType) 
+      #   * :value (Hash)
+      # @param elective [Boolean] Whether the company contribution is elective (aka "matching"). For `tiered`,
+#  `elective_amount`, and `elective_percentage` contribution types this is ignored
+#  and assumed to be `true`.
+      # @param company_contribution_annual_maximum [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+      # @param limit_option [String] Some benefits require additional information to determine their limit. For
+#  example, for an HSA benefit, the limit option should be either "Family" or
+#  "Individual". For a Dependent Care FSA benefit, the limit option should be
+#  either "Joint Filing or Single" or "Married and Filing Separately".
+      # @param catch_up [Boolean] Whether the employee should use a benefit’s "catch up" rate. Only Roth 401k and
+#  401k benefits use this value for employees over 50.
+      # @param coverage_amount [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+      # @param deduction_reduces_taxable_income [Gusto::Employees::Benefits::BenefitsUpdateRequestDeductionReducesTaxableIncome] Whether the employee deduction reduces taxable income or not. Only valid for
+#  Group Term Life benefits. Note: when the value is not "unset", coverage amount
+#  and coverage salary multiplier are ignored.
+      # @param coverage_salary_multiplier [String] The coverage amount as a multiple of the employee’s salary. Only applicable for
+#  Group Term Life benefits. Note: cannot be set if coverage amount is also set.
+      # @param company_contribution [String] The amount to be paid, per pay period, by the company.
+      # @param contribute_as_percentage [Boolean] Whether the company contribution amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.update(
+#    employee_benefit_id: "employee_benefit_id",
+#    version: "09j3d29jqdpj92109j9j2d90dq",
+#    employee_deduction: "250.00"
+#  )
+      def update(employee_benefit_id:, version:, active: nil, employee_deduction: nil, deduct_as_percentage: nil, employee_deduction_annual_maximum: nil, contribution: nil, elective: nil, company_contribution_annual_maximum: nil, limit_option: nil, catch_up: nil, coverage_amount: nil, deduction_reduces_taxable_income: nil, coverage_salary_multiplier: nil, company_contribution: nil, contribute_as_percentage: nil, request_options: nil)
+        response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), version: version, active: active, employee_deduction: employee_deduction, deduct_as_percentage: deduct_as_percentage, employee_deduction_annual_maximum: employee_deduction_annual_maximum, contribution: contribution, elective: elective, company_contribution_annual_maximum: company_contribution_annual_maximum, limit_option: limit_option, catch_up: catch_up, coverage_amount: coverage_amount, deduction_reduces_taxable_income: deduction_reduces_taxable_income, coverage_salary_multiplier: coverage_salary_multiplier, company_contribution: company_contribution, contribute_as_percentage: contribute_as_percentage }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+        Gusto::EmployeeBenefit.from_json(json_object: response.body)
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Void]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.delete(employee_benefit_id: "employee_benefit_id")
+      def delete(employee_benefit_id:, request_options: nil)
+        response = @request_client.conn.delete do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+      end
+# Year-to-date benefit amounts from a different company represents the amount of
+#  money added to an employee's plan during a current year, made outside of the
+#  current contribution when they were employed at a different company.
+#  This endpoint only supports passing outside contributions for 401(k) benefits.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param benefit_type [Float] The benefit type supported by Gusto.
+      # @param tax_year [Float] The tax year for which this amount applies.
+      # @param ytd_employee_deduction_amount [String] The year-to-date employee deduction made outside the current company.
+      # @param ytd_company_contribution_amount [String] The year-to-date company contribution made outside the current company.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Void]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.add_ytd_benefit_amounts(
+#    employee_id: "employee_id",
+#    tax_year: 1.1,
+#    ytd_employee_deduction_amount: "ytd_employee_deduction_amount",
+#    ytd_company_contribution_amount: "ytd_company_contribution_amount"
+#  )
+      def add_ytd_benefit_amounts(employee_id:, benefit_type: nil, tax_year:, ytd_employee_deduction_amount:, ytd_company_contribution_amount:, request_options: nil)
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), benefit_type: benefit_type, tax_year: tax_year, ytd_employee_deduction_amount: ytd_employee_deduction_amount, ytd_company_contribution_amount: ytd_company_contribution_amount }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/ytd_benefit_amounts_from_different_company"
+end
+      end
+    end
+    class AsyncBenefitsClient
+    # @return [Gusto::AsyncRequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Employees::AsyncBenefitsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  Returns an array of all employee benefits for this employee
+#  Benefits containing PHI are only visible to applications with the
+#  `employee_benefits:read:phi` scope.
+#  scope: `employee_benefits:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+      # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::EmployeeBenefit>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.list(employee_id: "employee_id")
+      def list(employee_id:, page: nil, per: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/employee_benefits"
+end
+          parsed_json = JSON.parse(response.body)
+          parsed_json&.map do | item |
+            item = item.to_json
+            Gusto::EmployeeBenefit.from_json(json_object: item)
+          end
+        end
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param company_benefit_uuid [String] The UUID of the company benefit.
+      # @param active [Boolean] Whether the employee benefit is active.
+      # @param employee_deduction [String] The amount to be deducted, per pay period, from the employee's pay.
+      # @param deduct_as_percentage [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param employee_deduction_annual_maximum [String] The maximum employee deduction amount per year. A null value signifies no limit.
+      # @param contribution [Hash] An object representing the company contribution type and value.Request of type Gusto::Employees::Benefits::BenefitsCreateRequestContribution, as a Hash
+      #   * :type (Gusto::Employees::Benefits::BenefitsCreateRequestContributionType) 
+      #   * :value (Hash)
+      # @param elective [Boolean] Whether the company contribution is elective (aka "matching"). For `tiered`,
+#  `elective_amount`, and `elective_percentage` contribution types this is ignored
+#  and assumed to be `true`.
+      # @param company_contribution_annual_maximum [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+      # @param limit_option [String] Some benefits require additional information to determine their limit. For
+#  example, for an HSA benefit, the limit option should be either "Family" or
+#  "Individual". For a Dependent Care FSA benefit, the limit option should be
+#  either "Joint Filing or Single" or "Married and Filing Separately".
+      # @param catch_up [Boolean] Whether the employee should use a benefit’s "catch up" rate. Only Roth 401k and
+#  401k benefits use this value for employees over 50.
+      # @param coverage_amount [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+      # @param coverage_salary_multiplier [String] The coverage amount as a multiple of the employee’s salary. Only applicable for
+#  Group Term Life benefits. Note: cannot be set if coverage amount is also set.
+      # @param deduction_reduces_taxable_income [Gusto::Employees::Benefits::BenefitsCreateRequestDeductionReducesTaxableIncome] Whether the employee deduction reduces taxable income or not. Only valid for
+#  Group Term Life benefits. Note: when the value is not "unset", coverage amount
+#  and coverage salary multiplier are ignored.
+      # @param company_contribution [String] The amount to be paid, per pay period, by the company.
+      # @param contribute_as_percentage [Boolean] Whether the company contribution amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.create(
+#    employee_id: "employee_id",
+#    company_benefit_uuid: "f68abb42-431e-4392-bc3f-2795627e00f3",
+#    active: true,
+#    employee_deduction: "100.00",
+#    contribution: { type: AMOUNT, value: "100.00" }
+#  )
+      def create(employee_id:, company_benefit_uuid:, active: nil, employee_deduction: nil, deduct_as_percentage: nil, employee_deduction_annual_maximum: nil, contribution: nil, elective: nil, company_contribution_annual_maximum: nil, limit_option: nil, catch_up: nil, coverage_amount: nil, coverage_salary_multiplier: nil, deduction_reduces_taxable_income: nil, company_contribution: nil, contribute_as_percentage: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), company_benefit_uuid: company_benefit_uuid, active: active, employee_deduction: employee_deduction, deduct_as_percentage: deduct_as_percentage, employee_deduction_annual_maximum: employee_deduction_annual_maximum, contribution: contribution, elective: elective, company_contribution_annual_maximum: company_contribution_annual_maximum, limit_option: limit_option, catch_up: catch_up, coverage_amount: coverage_amount, coverage_salary_multiplier: coverage_salary_multiplier, deduction_reduces_taxable_income: deduction_reduces_taxable_income, company_contribution: company_contribution, contribute_as_percentage: contribute_as_percentage }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/employee_benefits"
+end
+          Gusto::EmployeeBenefit.from_json(json_object: response.body)
+        end
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  Benefits containing PHI are only visible to applications with the
+#  `employee_benefits:read:phi` scope.
+#  scope: `employee_benefits:read`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.get(employee_benefit_id: "employee_benefit_id")
+      def get(employee_benefit_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+          Gusto::EmployeeBenefit.from_json(json_object: response.body)
+        end
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param version [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/versioning#object-layer) for
+#  information on how to use this field.
+      # @param active [Boolean] Whether the employee benefit is active.
+      # @param employee_deduction [String] The amount to be deducted, per pay period, from the employee's pay.
+      # @param deduct_as_percentage [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param employee_deduction_annual_maximum [String] The maximum employee deduction amount per year. A null value signifies no limit.
+      # @param contribution [Hash] An object representing the type and value of the company contribution.Request of type Gusto::Employees::Benefits::BenefitsUpdateRequestContribution, as a Hash
+      #   * :type (Gusto::Employees::Benefits::BenefitsUpdateRequestContributionType) 
+      #   * :value (Hash)
+      # @param elective [Boolean] Whether the company contribution is elective (aka "matching"). For `tiered`,
+#  `elective_amount`, and `elective_percentage` contribution types this is ignored
+#  and assumed to be `true`.
+      # @param company_contribution_annual_maximum [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+      # @param limit_option [String] Some benefits require additional information to determine their limit. For
+#  example, for an HSA benefit, the limit option should be either "Family" or
+#  "Individual". For a Dependent Care FSA benefit, the limit option should be
+#  either "Joint Filing or Single" or "Married and Filing Separately".
+      # @param catch_up [Boolean] Whether the employee should use a benefit’s "catch up" rate. Only Roth 401k and
+#  401k benefits use this value for employees over 50.
+      # @param coverage_amount [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+      # @param deduction_reduces_taxable_income [Gusto::Employees::Benefits::BenefitsUpdateRequestDeductionReducesTaxableIncome] Whether the employee deduction reduces taxable income or not. Only valid for
+#  Group Term Life benefits. Note: when the value is not "unset", coverage amount
+#  and coverage salary multiplier are ignored.
+      # @param coverage_salary_multiplier [String] The coverage amount as a multiple of the employee’s salary. Only applicable for
+#  Group Term Life benefits. Note: cannot be set if coverage amount is also set.
+      # @param company_contribution [String] The amount to be paid, per pay period, by the company.
+      # @param contribute_as_percentage [Boolean] Whether the company contribution amount should be treated as a percentage to be
+#  deducted from each payroll.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::EmployeeBenefit]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.update(
+#    employee_benefit_id: "employee_benefit_id",
+#    version: "09j3d29jqdpj92109j9j2d90dq",
+#    employee_deduction: "250.00"
+#  )
+      def update(employee_benefit_id:, version:, active: nil, employee_deduction: nil, deduct_as_percentage: nil, employee_deduction_annual_maximum: nil, contribution: nil, elective: nil, company_contribution_annual_maximum: nil, limit_option: nil, catch_up: nil, coverage_amount: nil, deduction_reduces_taxable_income: nil, coverage_salary_multiplier: nil, company_contribution: nil, contribute_as_percentage: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), version: version, active: active, employee_deduction: employee_deduction, deduct_as_percentage: deduct_as_percentage, employee_deduction_annual_maximum: employee_deduction_annual_maximum, contribution: contribution, elective: elective, company_contribution_annual_maximum: company_contribution_annual_maximum, limit_option: limit_option, catch_up: catch_up, coverage_amount: coverage_amount, deduction_reduces_taxable_income: deduction_reduces_taxable_income, coverage_salary_multiplier: coverage_salary_multiplier, company_contribution: company_contribution, contribute_as_percentage: contribute_as_percentage }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+          Gusto::EmployeeBenefit.from_json(json_object: response.body)
+        end
+      end
+# Employee benefits represent an employee enrolled in a particular company
+#  benefit. It includes information specific to that employee’s enrollment.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_benefit_id [String] The UUID of the employee benefit.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Void]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.delete(employee_benefit_id: "employee_benefit_id")
+      def delete(employee_benefit_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.delete do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employee_benefits/#{employee_benefit_id}"
+end
+        end
+      end
+# Year-to-date benefit amounts from a different company represents the amount of
+#  money added to an employee's plan during a current year, made outside of the
+#  current contribution when they were employed at a different company.
+#  This endpoint only supports passing outside contributions for 401(k) benefits.
+#  scope: `employee_benefits:write`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param benefit_type [Float] The benefit type supported by Gusto.
+      # @param tax_year [Float] The tax year for which this amount applies.
+      # @param ytd_employee_deduction_amount [String] The year-to-date employee deduction made outside the current company.
+      # @param ytd_company_contribution_amount [String] The year-to-date company contribution made outside the current company.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Void]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.benefits.add_ytd_benefit_amounts(
+#    employee_id: "employee_id",
+#    tax_year: 1.1,
+#    ytd_employee_deduction_amount: "ytd_employee_deduction_amount",
+#    ytd_company_contribution_amount: "ytd_company_contribution_amount"
+#  )
+      def add_ytd_benefit_amounts(employee_id:, benefit_type: nil, tax_year:, ytd_employee_deduction_amount:, ytd_company_contribution_amount:, request_options: nil)
+        Async do
+          response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), benefit_type: benefit_type, tax_year: tax_year, ytd_employee_deduction_amount: ytd_employee_deduction_amount, ytd_company_contribution_amount: ytd_company_contribution_amount }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/ytd_benefit_amounts_from_different_company"
+end
+        end
+      end
+    end
+  end
+end