fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/types/employee_address.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  class EmployeeAddress
+  # @return [String] The UUID of the employee address
+    attr_reader :uuid
+  # @return [String] The UUID of the employee
+    attr_reader :employee_uuid
+  # @return [String] The date the employee started living at the address.
+    attr_reader :effective_date
+  # @return [Boolean] Determines if home taxes should be withheld and paid for employee.
+    attr_reader :courtesy_withholding
+  # @return [String] 
+    attr_reader :street1
+  # @return [String] 
+    attr_reader :street2
+  # @return [String] 
+    attr_reader :city
+  # @return [String] 
+    attr_reader :state
+  # @return [String] 
+    attr_reader :zip
+  # @return [String] 
+    attr_reader :country
+  # @return [Boolean] The status of the location. Inactive locations have been deleted, but may still
+#  have historical data associated with them.
+    attr_reader :active
+  # @return [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information
+#  on how to use this field.
+    attr_reader :version
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param uuid [String] The UUID of the employee address
+    # @param employee_uuid [String] The UUID of the employee
+    # @param effective_date [String] The date the employee started living at the address.
+    # @param courtesy_withholding [Boolean] Determines if home taxes should be withheld and paid for employee.
+    # @param street1 [String] 
+    # @param street2 [String] 
+    # @param city [String] 
+    # @param state [String] 
+    # @param zip [String] 
+    # @param country [String] 
+    # @param active [Boolean] The status of the location. Inactive locations have been deleted, but may still
+#  have historical data associated with them.
+    # @param version [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information
+#  on how to use this field.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Gusto::EmployeeAddress]
+    def initialize(uuid: OMIT, employee_uuid: OMIT, effective_date: OMIT, courtesy_withholding: OMIT, street1: OMIT, street2: OMIT, city: OMIT, state: OMIT, zip: OMIT, country: OMIT, active: OMIT, version: OMIT, additional_properties: nil)
+      @uuid = uuid if uuid != OMIT
+      @employee_uuid = employee_uuid if employee_uuid != OMIT
+      @effective_date = effective_date if effective_date != OMIT
+      @courtesy_withholding = courtesy_withholding if courtesy_withholding != OMIT
+      @street1 = street1 if street1 != OMIT
+      @street2 = street2 if street2 != OMIT
+      @city = city if city != OMIT
+      @state = state if state != OMIT
+      @zip = zip if zip != OMIT
+      @country = country if country != OMIT
+      @active = active if active != OMIT
+      @version = version if version != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "uuid": uuid, "employee_uuid": employee_uuid, "effective_date": effective_date, "courtesy_withholding": courtesy_withholding, "street_1": street1, "street_2": street2, "city": city, "state": state, "zip": zip, "country": country, "active": active, "version": version }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of EmployeeAddress
+    #
+    # @param json_object [String] 
+    # @return [Gusto::EmployeeAddress]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      uuid = parsed_json["uuid"]
+      employee_uuid = parsed_json["employee_uuid"]
+      effective_date = parsed_json["effective_date"]
+      courtesy_withholding = parsed_json["courtesy_withholding"]
+      street1 = parsed_json["street_1"]
+      street2 = parsed_json["street_2"]
+      city = parsed_json["city"]
+      state = parsed_json["state"]
+      zip = parsed_json["zip"]
+      country = parsed_json["country"]
+      active = parsed_json["active"]
+      version = parsed_json["version"]
+      new(
+        uuid: uuid,
+        employee_uuid: employee_uuid,
+        effective_date: effective_date,
+        courtesy_withholding: courtesy_withholding,
+        street1: street1,
+        street2: street2,
+        city: city,
+        state: state,
+        zip: zip,
+        country: country,
+        active: active,
+        version: version,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of EmployeeAddress to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.uuid&.is_a?(String) != false || raise("Passed value for field obj.uuid is not the expected type, validation failed.")
+      obj.employee_uuid&.is_a?(String) != false || raise("Passed value for field obj.employee_uuid is not the expected type, validation failed.")
+      obj.effective_date&.is_a?(String) != false || raise("Passed value for field obj.effective_date is not the expected type, validation failed.")
+      obj.courtesy_withholding&.is_a?(Boolean) != false || raise("Passed value for field obj.courtesy_withholding is not the expected type, validation failed.")
+      obj.street1&.is_a?(String) != false || raise("Passed value for field obj.street1 is not the expected type, validation failed.")
+      obj.street2&.is_a?(String) != false || raise("Passed value for field obj.street2 is not the expected type, validation failed.")
+      obj.city&.is_a?(String) != false || raise("Passed value for field obj.city is not the expected type, validation failed.")
+      obj.state&.is_a?(String) != false || raise("Passed value for field obj.state is not the expected type, validation failed.")
+      obj.zip&.is_a?(String) != false || raise("Passed value for field obj.zip is not the expected type, validation failed.")
+      obj.country&.is_a?(String) != false || raise("Passed value for field obj.country is not the expected type, validation failed.")
+      obj.active&.is_a?(Boolean) != false || raise("Passed value for field obj.active is not the expected type, validation failed.")
+      obj.version&.is_a?(String) != false || raise("Passed value for field obj.version is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/fern_gusto/types/employee_benefit.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+require_relative "employee_benefit_base_object_contribution"
+require_relative "employee_benefit_base_object_deduction_reduces_taxable_income"
+require "ostruct"
+require "json"
+
+module Gusto
+# The representation of an employee benefit.
+  class EmployeeBenefit
+  # @return [String] The UUID of the employee to which the benefit belongs.
+    attr_reader :employee_uuid
+  # @return [String] The UUID of the company benefit.
+    attr_reader :company_benefit_uuid
+  # @return [String] The UUID of the employee benefit.
+    attr_reader :uuid
+  # @return [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information
+#  on how to use this field.
+    attr_reader :version
+  # @return [Boolean] Whether the employee benefit is active.
+    attr_reader :active
+  # @return [String] The amount to be deducted, per pay period, from the employee's pay.
+    attr_reader :employee_deduction
+  # @return [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+    attr_reader :deduct_as_percentage
+  # @return [String] The maximum employee deduction amount per year. A null value signifies no limit.
+    attr_reader :employee_deduction_annual_maximum
+  # @return [Gusto::EmployeeBenefitBaseObjectContribution] An object representing the type and value of the company contribution.
+    attr_reader :contribution
+  # @return [Boolean] Whether the company contribution is elective (aka matching). For "tiered"
+#  contribution types, this is always true.
+    attr_reader :elective
+  # @return [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+    attr_reader :company_contribution_annual_maximum
+  # @return [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".
+    attr_reader :limit_option
+  # @return [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.
+    attr_reader :catch_up
+  # @return [String] Identifier for a 401(k) loan assigned by the 401(k) provider
+    attr_reader :retirement_loan_identifier
+  # @return [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+    attr_reader :coverage_amount
+  # @return [Gusto::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome] 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.
+    attr_reader :deduction_reduces_taxable_income
+  # @return [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.
+    attr_reader :coverage_salary_multiplier
+  # @return [String] The amount to be paid, per pay period, by the company. This field will not
+#  appear for tiered contribution types.
+    attr_reader :company_contribution
+  # @return [Boolean] Whether the company_contribution value should be treated as a percentage to be
+#  added to each payroll. This field will not appear for tiered contribution types.
+    attr_reader :contribute_as_percentage
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param employee_uuid [String] The UUID of the employee to which the benefit belongs.
+    # @param company_benefit_uuid [String] The UUID of the company benefit.
+    # @param uuid [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/idempotency) 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 [Gusto::EmployeeBenefitBaseObjectContribution] An object representing the type and value of the company contribution.
+    # @param elective [Boolean] Whether the company contribution is elective (aka matching). For "tiered"
+#  contribution types, this is always 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 retirement_loan_identifier [String] Identifier for a 401(k) loan assigned by the 401(k) provider
+    # @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::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome] 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. This field will not
+#  appear for tiered contribution types.
+    # @param contribute_as_percentage [Boolean] Whether the company_contribution value should be treated as a percentage to be
+#  added to each payroll. This field will not appear for tiered contribution types.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Gusto::EmployeeBenefit]
+    def initialize(employee_uuid: OMIT, company_benefit_uuid: OMIT, uuid: OMIT, version: OMIT, active: OMIT, employee_deduction: OMIT, deduct_as_percentage: OMIT, employee_deduction_annual_maximum: OMIT, contribution: OMIT, elective: OMIT, company_contribution_annual_maximum: OMIT, limit_option: OMIT, catch_up: OMIT, retirement_loan_identifier: OMIT, coverage_amount: OMIT, deduction_reduces_taxable_income: OMIT, coverage_salary_multiplier: OMIT, company_contribution: OMIT, contribute_as_percentage: OMIT, additional_properties: nil)
+      @employee_uuid = employee_uuid if employee_uuid != OMIT
+      @company_benefit_uuid = company_benefit_uuid if company_benefit_uuid != OMIT
+      @uuid = uuid if uuid != OMIT
+      @version = version if version != OMIT
+      @active = active if active != OMIT
+      @employee_deduction = employee_deduction if employee_deduction != OMIT
+      @deduct_as_percentage = deduct_as_percentage if deduct_as_percentage != OMIT
+      @employee_deduction_annual_maximum = employee_deduction_annual_maximum if employee_deduction_annual_maximum != OMIT
+      @contribution = contribution if contribution != OMIT
+      @elective = elective if elective != OMIT
+      @company_contribution_annual_maximum = company_contribution_annual_maximum if company_contribution_annual_maximum != OMIT
+      @limit_option = limit_option if limit_option != OMIT
+      @catch_up = catch_up if catch_up != OMIT
+      @retirement_loan_identifier = retirement_loan_identifier if retirement_loan_identifier != OMIT
+      @coverage_amount = coverage_amount if coverage_amount != OMIT
+      @deduction_reduces_taxable_income = deduction_reduces_taxable_income if deduction_reduces_taxable_income != OMIT
+      @coverage_salary_multiplier = coverage_salary_multiplier if coverage_salary_multiplier != OMIT
+      @company_contribution = company_contribution if company_contribution != OMIT
+      @contribute_as_percentage = contribute_as_percentage if contribute_as_percentage != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "employee_uuid": employee_uuid, "company_benefit_uuid": company_benefit_uuid, "uuid": uuid, "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, "retirement_loan_identifier": retirement_loan_identifier, "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 }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of EmployeeBenefit
+    #
+    # @param json_object [String] 
+    # @return [Gusto::EmployeeBenefit]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      employee_uuid = parsed_json["employee_uuid"]
+      company_benefit_uuid = parsed_json["company_benefit_uuid"]
+      uuid = parsed_json["uuid"]
+      version = parsed_json["version"]
+      active = parsed_json["active"]
+      employee_deduction = parsed_json["employee_deduction"]
+      deduct_as_percentage = parsed_json["deduct_as_percentage"]
+      employee_deduction_annual_maximum = parsed_json["employee_deduction_annual_maximum"]
+      unless parsed_json["contribution"].nil?
+        contribution = parsed_json["contribution"].to_json
+        contribution = Gusto::EmployeeBenefitBaseObjectContribution.from_json(json_object: contribution)
+      else
+        contribution = nil
+      end
+      elective = parsed_json["elective"]
+      company_contribution_annual_maximum = parsed_json["company_contribution_annual_maximum"]
+      limit_option = parsed_json["limit_option"]
+      catch_up = parsed_json["catch_up"]
+      retirement_loan_identifier = parsed_json["retirement_loan_identifier"]
+      coverage_amount = parsed_json["coverage_amount"]
+      deduction_reduces_taxable_income = parsed_json["deduction_reduces_taxable_income"]
+      coverage_salary_multiplier = parsed_json["coverage_salary_multiplier"]
+      company_contribution = parsed_json["company_contribution"]
+      contribute_as_percentage = parsed_json["contribute_as_percentage"]
+      new(
+        employee_uuid: employee_uuid,
+        company_benefit_uuid: company_benefit_uuid,
+        uuid: uuid,
+        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,
+        retirement_loan_identifier: retirement_loan_identifier,
+        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,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of EmployeeBenefit to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.employee_uuid&.is_a?(String) != false || raise("Passed value for field obj.employee_uuid is not the expected type, validation failed.")
+      obj.company_benefit_uuid&.is_a?(String) != false || raise("Passed value for field obj.company_benefit_uuid is not the expected type, validation failed.")
+      obj.uuid&.is_a?(String) != false || raise("Passed value for field obj.uuid is not the expected type, validation failed.")
+      obj.version&.is_a?(String) != false || raise("Passed value for field obj.version is not the expected type, validation failed.")
+      obj.active&.is_a?(Boolean) != false || raise("Passed value for field obj.active is not the expected type, validation failed.")
+      obj.employee_deduction&.is_a?(String) != false || raise("Passed value for field obj.employee_deduction is not the expected type, validation failed.")
+      obj.deduct_as_percentage&.is_a?(Boolean) != false || raise("Passed value for field obj.deduct_as_percentage is not the expected type, validation failed.")
+      obj.employee_deduction_annual_maximum&.is_a?(String) != false || raise("Passed value for field obj.employee_deduction_annual_maximum is not the expected type, validation failed.")
+      obj.contribution.nil? || Gusto::EmployeeBenefitBaseObjectContribution.validate_raw(obj: obj.contribution)
+      obj.elective&.is_a?(Boolean) != false || raise("Passed value for field obj.elective is not the expected type, validation failed.")
+      obj.company_contribution_annual_maximum&.is_a?(String) != false || raise("Passed value for field obj.company_contribution_annual_maximum is not the expected type, validation failed.")
+      obj.limit_option&.is_a?(String) != false || raise("Passed value for field obj.limit_option is not the expected type, validation failed.")
+      obj.catch_up&.is_a?(Boolean) != false || raise("Passed value for field obj.catch_up is not the expected type, validation failed.")
+      obj.retirement_loan_identifier&.is_a?(String) != false || raise("Passed value for field obj.retirement_loan_identifier is not the expected type, validation failed.")
+      obj.coverage_amount&.is_a?(String) != false || raise("Passed value for field obj.coverage_amount is not the expected type, validation failed.")
+      obj.deduction_reduces_taxable_income&.is_a?(Gusto::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome) != false || raise("Passed value for field obj.deduction_reduces_taxable_income is not the expected type, validation failed.")
+      obj.coverage_salary_multiplier&.is_a?(String) != false || raise("Passed value for field obj.coverage_salary_multiplier is not the expected type, validation failed.")
+      obj.company_contribution&.is_a?(String) != false || raise("Passed value for field obj.company_contribution is not the expected type, validation failed.")
+      obj.contribute_as_percentage&.is_a?(Boolean) != false || raise("Passed value for field obj.contribute_as_percentage is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/fern_gusto/types/employee_benefit_base_object.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+require_relative "employee_benefit_base_object_contribution"
+require_relative "employee_benefit_base_object_deduction_reduces_taxable_income"
+require "ostruct"
+require "json"
+
+module Gusto
+
+  class EmployeeBenefitBaseObject
+  # @return [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information
+#  on how to use this field.
+    attr_reader :version
+  # @return [Boolean] Whether the employee benefit is active.
+    attr_reader :active
+  # @return [String] The amount to be deducted, per pay period, from the employee's pay.
+    attr_reader :employee_deduction
+  # @return [Boolean] Whether the employee deduction amount should be treated as a percentage to be
+#  deducted from each payroll.
+    attr_reader :deduct_as_percentage
+  # @return [String] The maximum employee deduction amount per year. A null value signifies no limit.
+    attr_reader :employee_deduction_annual_maximum
+  # @return [Gusto::EmployeeBenefitBaseObjectContribution] An object representing the type and value of the company contribution.
+    attr_reader :contribution
+  # @return [Boolean] Whether the company contribution is elective (aka matching). For "tiered"
+#  contribution types, this is always true.
+    attr_reader :elective
+  # @return [String] The maximum company contribution amount per year. A null value signifies no
+#  limit.
+    attr_reader :company_contribution_annual_maximum
+  # @return [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".
+    attr_reader :limit_option
+  # @return [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.
+    attr_reader :catch_up
+  # @return [String] Identifier for a 401(k) loan assigned by the 401(k) provider
+    attr_reader :retirement_loan_identifier
+  # @return [String] The amount that the employee is insured for. Note: company contribution cannot
+#  be present if coverage amount is set.
+    attr_reader :coverage_amount
+  # @return [Gusto::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome] 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.
+    attr_reader :deduction_reduces_taxable_income
+  # @return [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.
+    attr_reader :coverage_salary_multiplier
+  # @return [String] The amount to be paid, per pay period, by the company. This field will not
+#  appear for tiered contribution types.
+    attr_reader :company_contribution
+  # @return [Boolean] Whether the company_contribution value should be treated as a percentage to be
+#  added to each payroll. This field will not appear for tiered contribution types.
+    attr_reader :contribute_as_percentage
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param version [String] The current version of the object. See the [versioning
+#  guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) 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 [Gusto::EmployeeBenefitBaseObjectContribution] An object representing the type and value of the company contribution.
+    # @param elective [Boolean] Whether the company contribution is elective (aka matching). For "tiered"
+#  contribution types, this is always 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 retirement_loan_identifier [String] Identifier for a 401(k) loan assigned by the 401(k) provider
+    # @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::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome] 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. This field will not
+#  appear for tiered contribution types.
+    # @param contribute_as_percentage [Boolean] Whether the company_contribution value should be treated as a percentage to be
+#  added to each payroll. This field will not appear for tiered contribution types.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Gusto::EmployeeBenefitBaseObject]
+    def initialize(version: OMIT, active: OMIT, employee_deduction: OMIT, deduct_as_percentage: OMIT, employee_deduction_annual_maximum: OMIT, contribution: OMIT, elective: OMIT, company_contribution_annual_maximum: OMIT, limit_option: OMIT, catch_up: OMIT, retirement_loan_identifier: OMIT, coverage_amount: OMIT, deduction_reduces_taxable_income: OMIT, coverage_salary_multiplier: OMIT, company_contribution: OMIT, contribute_as_percentage: OMIT, additional_properties: nil)
+      @version = version if version != OMIT
+      @active = active if active != OMIT
+      @employee_deduction = employee_deduction if employee_deduction != OMIT
+      @deduct_as_percentage = deduct_as_percentage if deduct_as_percentage != OMIT
+      @employee_deduction_annual_maximum = employee_deduction_annual_maximum if employee_deduction_annual_maximum != OMIT
+      @contribution = contribution if contribution != OMIT
+      @elective = elective if elective != OMIT
+      @company_contribution_annual_maximum = company_contribution_annual_maximum if company_contribution_annual_maximum != OMIT
+      @limit_option = limit_option if limit_option != OMIT
+      @catch_up = catch_up if catch_up != OMIT
+      @retirement_loan_identifier = retirement_loan_identifier if retirement_loan_identifier != OMIT
+      @coverage_amount = coverage_amount if coverage_amount != OMIT
+      @deduction_reduces_taxable_income = deduction_reduces_taxable_income if deduction_reduces_taxable_income != OMIT
+      @coverage_salary_multiplier = coverage_salary_multiplier if coverage_salary_multiplier != OMIT
+      @company_contribution = company_contribution if company_contribution != OMIT
+      @contribute_as_percentage = contribute_as_percentage if contribute_as_percentage != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "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, "retirement_loan_identifier": retirement_loan_identifier, "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 }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of EmployeeBenefitBaseObject
+    #
+    # @param json_object [String] 
+    # @return [Gusto::EmployeeBenefitBaseObject]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      version = parsed_json["version"]
+      active = parsed_json["active"]
+      employee_deduction = parsed_json["employee_deduction"]
+      deduct_as_percentage = parsed_json["deduct_as_percentage"]
+      employee_deduction_annual_maximum = parsed_json["employee_deduction_annual_maximum"]
+      unless parsed_json["contribution"].nil?
+        contribution = parsed_json["contribution"].to_json
+        contribution = Gusto::EmployeeBenefitBaseObjectContribution.from_json(json_object: contribution)
+      else
+        contribution = nil
+      end
+      elective = parsed_json["elective"]
+      company_contribution_annual_maximum = parsed_json["company_contribution_annual_maximum"]
+      limit_option = parsed_json["limit_option"]
+      catch_up = parsed_json["catch_up"]
+      retirement_loan_identifier = parsed_json["retirement_loan_identifier"]
+      coverage_amount = parsed_json["coverage_amount"]
+      deduction_reduces_taxable_income = parsed_json["deduction_reduces_taxable_income"]
+      coverage_salary_multiplier = parsed_json["coverage_salary_multiplier"]
+      company_contribution = parsed_json["company_contribution"]
+      contribute_as_percentage = parsed_json["contribute_as_percentage"]
+      new(
+        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,
+        retirement_loan_identifier: retirement_loan_identifier,
+        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,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of EmployeeBenefitBaseObject to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.version&.is_a?(String) != false || raise("Passed value for field obj.version is not the expected type, validation failed.")
+      obj.active&.is_a?(Boolean) != false || raise("Passed value for field obj.active is not the expected type, validation failed.")
+      obj.employee_deduction&.is_a?(String) != false || raise("Passed value for field obj.employee_deduction is not the expected type, validation failed.")
+      obj.deduct_as_percentage&.is_a?(Boolean) != false || raise("Passed value for field obj.deduct_as_percentage is not the expected type, validation failed.")
+      obj.employee_deduction_annual_maximum&.is_a?(String) != false || raise("Passed value for field obj.employee_deduction_annual_maximum is not the expected type, validation failed.")
+      obj.contribution.nil? || Gusto::EmployeeBenefitBaseObjectContribution.validate_raw(obj: obj.contribution)
+      obj.elective&.is_a?(Boolean) != false || raise("Passed value for field obj.elective is not the expected type, validation failed.")
+      obj.company_contribution_annual_maximum&.is_a?(String) != false || raise("Passed value for field obj.company_contribution_annual_maximum is not the expected type, validation failed.")
+      obj.limit_option&.is_a?(String) != false || raise("Passed value for field obj.limit_option is not the expected type, validation failed.")
+      obj.catch_up&.is_a?(Boolean) != false || raise("Passed value for field obj.catch_up is not the expected type, validation failed.")
+      obj.retirement_loan_identifier&.is_a?(String) != false || raise("Passed value for field obj.retirement_loan_identifier is not the expected type, validation failed.")
+      obj.coverage_amount&.is_a?(String) != false || raise("Passed value for field obj.coverage_amount is not the expected type, validation failed.")
+      obj.deduction_reduces_taxable_income&.is_a?(Gusto::EmployeeBenefitBaseObjectDeductionReducesTaxableIncome) != false || raise("Passed value for field obj.deduction_reduces_taxable_income is not the expected type, validation failed.")
+      obj.coverage_salary_multiplier&.is_a?(String) != false || raise("Passed value for field obj.coverage_salary_multiplier is not the expected type, validation failed.")
+      obj.company_contribution&.is_a?(String) != false || raise("Passed value for field obj.company_contribution is not the expected type, validation failed.")
+      obj.contribute_as_percentage&.is_a?(Boolean) != false || raise("Passed value for field obj.contribute_as_percentage is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/fern_gusto/types/employee_benefit_base_object_contribution.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+require_relative "employee_benefit_base_object_contribution_value"
+require "ostruct"
+require "json"
+
+module Gusto
+# An object representing the type and value of the company contribution.
+  class EmployeeBenefitBaseObjectContribution
+  # @return [String] The company contribution scheme.
+#  "amount": The company contributes a fixed amount per payroll. If elective is
+#  true, the contribution is matching, dollar-for-dollar.
+#  "percentage": The company contributes a percentage of the payroll amount per
+#  payroll period. If elective is true, the contribution is matching,
+#  dollar-for-dollar.
+#  "tiered": The company contribution varies according to the size of the employee
+#  deduction.
+    attr_reader :type
+  # @return [Gusto::EmployeeBenefitBaseObjectContributionValue] For the `amount` and `percentage` contribution types, the value of the
+#  corresponding amount or percentage.
+#  For the `tiered` contribution type, an array of tiers.
+    attr_reader :value
+  # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+  # @return [Object] 
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param type [String] The company contribution scheme.
+#  "amount": The company contributes a fixed amount per payroll. If elective is
+#  true, the contribution is matching, dollar-for-dollar.
+#  "percentage": The company contributes a percentage of the payroll amount per
+#  payroll period. If elective is true, the contribution is matching,
+#  dollar-for-dollar.
+#  "tiered": The company contribution varies according to the size of the employee
+#  deduction.
+    # @param value [Gusto::EmployeeBenefitBaseObjectContributionValue] For the `amount` and `percentage` contribution types, the value of the
+#  corresponding amount or percentage.
+#  For the `tiered` contribution type, an array of tiers.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Gusto::EmployeeBenefitBaseObjectContribution]
+    def initialize(type: OMIT, value: OMIT, additional_properties: nil)
+      @type = type if type != OMIT
+      @value = value if value != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of
+#  EmployeeBenefitBaseObjectContribution
+    #
+    # @param json_object [String] 
+    # @return [Gusto::EmployeeBenefitBaseObjectContribution]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Gusto::EmployeeBenefitBaseObjectContributionValue.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of EmployeeBenefitBaseObjectContribution to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_field_set&.to_json
+    end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+    #
+    # @param obj [Object] 
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.type&.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      obj.value.nil? || Gusto::EmployeeBenefitBaseObjectContributionValue.validate_raw(obj: obj.value)
+    end
+  end
+end