fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_request_external_payroll_items_item.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+require_relative "external_payrolls_update_request_external_payroll_items_item_earnings_item"
+require_relative "external_payrolls_update_request_external_payroll_items_item_benefits_item"
+require_relative "external_payrolls_update_request_external_payroll_items_item_taxes_item"
+require "ostruct"
+require "json"
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+# Submit wages, benefits, taxes for each employee
+      class ExternalPayrollsUpdateRequestExternalPayrollItemsItem
+      # @return [String] The UUID of the employee.
+        attr_reader :employee_uuid
+      # @return [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem>] 
+        attr_reader :earnings
+      # @return [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem>] 
+        attr_reader :benefits
+      # @return [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem>] An array of taxes for the employee. Depends on your company selections, taxes
+#  include federal income tax, social security, medicare, and more.
+        attr_reader :taxes
+      # @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.
+        # @param earnings [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem>] 
+        # @param benefits [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem>] 
+        # @param taxes [Array<Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem>] An array of taxes for the employee. Depends on your company selections, taxes
+#  include federal income tax, social security, medicare, and more.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItem]
+        def initialize(employee_uuid: OMIT, earnings: OMIT, benefits: OMIT, taxes: OMIT, additional_properties: nil)
+          @employee_uuid = employee_uuid if employee_uuid != OMIT
+          @earnings = earnings if earnings != OMIT
+          @benefits = benefits if benefits != OMIT
+          @taxes = taxes if taxes != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "employee_uuid": employee_uuid, "earnings": earnings, "benefits": benefits, "taxes": taxes }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItem]
+        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"]
+          earnings = parsed_json["earnings"]&.map do | item |
+  item = item.to_json
+  Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem.from_json(json_object: item)
+end
+          benefits = parsed_json["benefits"]&.map do | item |
+  item = item.to_json
+  Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem.from_json(json_object: item)
+end
+          taxes = parsed_json["taxes"]&.map do | item |
+  item = item.to_json
+  Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem.from_json(json_object: item)
+end
+          new(
+            employee_uuid: employee_uuid,
+            earnings: earnings,
+            benefits: benefits,
+            taxes: taxes,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of ExternalPayrollsUpdateRequestExternalPayrollItemsItem
+#  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.earnings&.is_a?(Array) != false || raise("Passed value for field obj.earnings is not the expected type, validation failed.")
+          obj.benefits&.is_a?(Array) != false || raise("Passed value for field obj.benefits is not the expected type, validation failed.")
+          obj.taxes&.is_a?(Array) != false || raise("Passed value for field obj.taxes is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_request_external_payroll_items_item_benefits_item.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+# An array of benefits for the employee. Depends on your company selections,
+#  benefits include 401k, health insurance and more.
+      class ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem
+      # @return [String] Company contribution amount towards the benefit
+        attr_reader :company_contribution_amount
+      # @return [String] Employee deduction amount towards the benefit
+        attr_reader :employee_deduction_amount
+      # @return [Integer] The ID of the benefit.
+        attr_reader :benefit_id
+      # @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 company_contribution_amount [String] Company contribution amount towards the benefit
+        # @param employee_deduction_amount [String] Employee deduction amount towards the benefit
+        # @param benefit_id [Integer] The ID of the benefit.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem]
+        def initialize(company_contribution_amount: OMIT, employee_deduction_amount: OMIT, benefit_id: OMIT, additional_properties: nil)
+          @company_contribution_amount = company_contribution_amount if company_contribution_amount != OMIT
+          @employee_deduction_amount = employee_deduction_amount if employee_deduction_amount != OMIT
+          @benefit_id = benefit_id if benefit_id != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "company_contribution_amount": company_contribution_amount, "employee_deduction_amount": employee_deduction_amount, "benefit_id": benefit_id }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          company_contribution_amount = parsed_json["company_contribution_amount"]
+          employee_deduction_amount = parsed_json["employee_deduction_amount"]
+          benefit_id = parsed_json["benefit_id"]
+          new(
+            company_contribution_amount: company_contribution_amount,
+            employee_deduction_amount: employee_deduction_amount,
+            benefit_id: benefit_id,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemBenefitsItem 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.company_contribution_amount&.is_a?(String) != false || raise("Passed value for field obj.company_contribution_amount is not the expected type, validation failed.")
+          obj.employee_deduction_amount&.is_a?(String) != false || raise("Passed value for field obj.employee_deduction_amount is not the expected type, validation failed.")
+          obj.benefit_id&.is_a?(Integer) != false || raise("Passed value for field obj.benefit_id is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_request_external_payroll_items_item_earnings_item.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+require_relative "external_payrolls_update_request_external_payroll_items_item_earnings_item_earning_type"
+require "ostruct"
+require "json"
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+# An array of earnings for the employee. Depends on your company selections,
+#  earnings includes wages, hours, bonuses, tips, commission and more.
+      class ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem
+      # @return [String] The hour of the compensation for the pay period.
+        attr_reader :hours
+      # @return [String] The amount of the earning.
+        attr_reader :amount
+      # @return [Integer] The ID of the earning.
+        attr_reader :earning_id
+      # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItemEarningType] The earning type for the compensation.
+        attr_reader :earning_type
+      # @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 hours [String] The hour of the compensation for the pay period.
+        # @param amount [String] The amount of the earning.
+        # @param earning_id [Integer] The ID of the earning.
+        # @param earning_type [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItemEarningType] The earning type for the compensation.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem]
+        def initialize(hours: OMIT, amount: OMIT, earning_id: OMIT, earning_type: OMIT, additional_properties: nil)
+          @hours = hours if hours != OMIT
+          @amount = amount if amount != OMIT
+          @earning_id = earning_id if earning_id != OMIT
+          @earning_type = earning_type if earning_type != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "hours": hours, "amount": amount, "earning_id": earning_id, "earning_type": earning_type }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          hours = parsed_json["hours"]
+          amount = parsed_json["amount"]
+          earning_id = parsed_json["earning_id"]
+          earning_type = parsed_json["earning_type"]
+          new(
+            hours: hours,
+            amount: amount,
+            earning_id: earning_id,
+            earning_type: earning_type,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItem 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.hours&.is_a?(String) != false || raise("Passed value for field obj.hours is not the expected type, validation failed.")
+          obj.amount&.is_a?(String) != false || raise("Passed value for field obj.amount is not the expected type, validation failed.")
+          obj.earning_id&.is_a?(Integer) != false || raise("Passed value for field obj.earning_id is not the expected type, validation failed.")
+          obj.earning_type&.is_a?(Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItemEarningType) != false || raise("Passed value for field obj.earning_type is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_request_external_payroll_items_item_earnings_item_earning_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+# The earning type for the compensation.
+      class ExternalPayrollsUpdateRequestExternalPayrollItemsItemEarningsItemEarningType
+
+        COMPANY_PAY_TYPE = "CompanyPayType"
+        COMPANY_EARNING_TYPE = "CompanyEarningType"
+
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_request_external_payroll_items_item_taxes_item.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+      class ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem
+      # @return [String] The amount of the tax.
+        attr_reader :amount
+      # @return [Integer] The ID of the tax.
+        attr_reader :tax_id
+      # @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 amount [String] The amount of the tax.
+        # @param tax_id [Integer] The ID of the tax.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem]
+        def initialize(amount: OMIT, tax_id: OMIT, additional_properties: nil)
+          @amount = amount if amount != OMIT
+          @tax_id = tax_id if tax_id != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "amount": amount, "tax_id": tax_id }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          amount = parsed_json["amount"]
+          tax_id = parsed_json["tax_id"]
+          new(
+            amount: amount,
+            tax_id: tax_id,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of
+#  ExternalPayrollsUpdateRequestExternalPayrollItemsItemTaxesItem 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.amount&.is_a?(String) != false || raise("Passed value for field obj.amount is not the expected type, validation failed.")
+          obj.tax_id&.is_a?(Integer) != false || raise("Passed value for field obj.tax_id is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/external_payrolls/types/external_payrolls_update_tax_liabilities_request_liability_selections_item.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  module Companies
+    module ExternalPayrolls
+
+      class ExternalPayrollsUpdateTaxLiabilitiesRequestLiabilitySelectionsItem
+      # @return [Integer] The ID of the tax.
+        attr_reader :tax_id
+      # @return [String] The UUID of the last unpaid external payroll uuid. It should be null when the
+#  full amount of tax liability has been paid.
+        attr_reader :last_unpaid_external_payroll_uuid
+      # @return [Float] A selection of unpaid liability amount.
+        attr_reader :unpaid_liability_amount
+      # @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 tax_id [Integer] The ID of the tax.
+        # @param last_unpaid_external_payroll_uuid [String] The UUID of the last unpaid external payroll uuid. It should be null when the
+#  full amount of tax liability has been paid.
+        # @param unpaid_liability_amount [Float] A selection of unpaid liability amount.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateTaxLiabilitiesRequestLiabilitySelectionsItem]
+        def initialize(tax_id: OMIT, last_unpaid_external_payroll_uuid: OMIT, unpaid_liability_amount: OMIT, additional_properties: nil)
+          @tax_id = tax_id if tax_id != OMIT
+          @last_unpaid_external_payroll_uuid = last_unpaid_external_payroll_uuid if last_unpaid_external_payroll_uuid != OMIT
+          @unpaid_liability_amount = unpaid_liability_amount if unpaid_liability_amount != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "tax_id": tax_id, "last_unpaid_external_payroll_uuid": last_unpaid_external_payroll_uuid, "unpaid_liability_amount": unpaid_liability_amount }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of
+#  ExternalPayrollsUpdateTaxLiabilitiesRequestLiabilitySelectionsItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Companies::ExternalPayrolls::ExternalPayrollsUpdateTaxLiabilitiesRequestLiabilitySelectionsItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          tax_id = parsed_json["tax_id"]
+          last_unpaid_external_payroll_uuid = parsed_json["last_unpaid_external_payroll_uuid"]
+          unpaid_liability_amount = parsed_json["unpaid_liability_amount"]
+          new(
+            tax_id: tax_id,
+            last_unpaid_external_payroll_uuid: last_unpaid_external_payroll_uuid,
+            unpaid_liability_amount: unpaid_liability_amount,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of
+#  ExternalPayrollsUpdateTaxLiabilitiesRequestLiabilitySelectionsItem 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.tax_id&.is_a?(Integer) != false || raise("Passed value for field obj.tax_id is not the expected type, validation failed.")
+          obj.last_unpaid_external_payroll_uuid&.is_a?(String) != false || raise("Passed value for field obj.last_unpaid_external_payroll_uuid is not the expected type, validation failed.")
+          obj.unpaid_liability_amount&.is_a?(Float) != false || raise("Passed value for field obj.unpaid_liability_amount is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/federal_tax_details/client.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+require_relative "../../../requests"
+require_relative "../../federal_tax_details/types/federal_tax_details"
+require_relative "types/federal_tax_details_update_request_tax_payer_type"
+require "async"
+require "async"
+require_relative "../../../requests"
+
+module Gusto
+  module Companies
+    class FederalTaxDetailsClient
+    # @return [Gusto::RequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Companies::FederalTaxDetailsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Fetches attributes relevant for a company's federal taxes.
+#  scope: `company_federal_taxes:read`
+      #
+      # @param company_id [String] The UUID of the company
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FederalTaxDetails::FederalTaxDetails]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.federal_tax_details.get(company_id: "company_id")
+      def get(company_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/companies/#{company_id}/federal_tax_details"
+end
+        Gusto::FederalTaxDetails::FederalTaxDetails.from_json(json_object: response.body)
+      end
+# Updates attributes relevant for a company's federal taxes.
+#  This information is required is to onboard a company for use with Gusto Embedded
+#  Payroll.
+#  scope: `company_federal_taxes:write`
+      #
+      # @param company_id [String] The UUID of the company
+      # @param legal_name [String] The legal name of the company
+      # @param ein [String] The EIN of of the company
+      # @param tax_payer_type [Gusto::Companies::FederalTaxDetails::FederalTaxDetailsUpdateRequestTaxPayerType] What type of tax entity the company is
+      # @param filing_form [String] The form used by the company for federal tax filing. One of:
+#  - 941 (Quarterly federal tax return)
+#  - 944 (Annual federal tax return)
+      # @param taxable_as_scorp [Boolean] Whether this company should be taxed as an S-Corporation
+      # @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 request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FederalTaxDetails::FederalTaxDetails]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.federal_tax_details.update(
+#    company_id: "company_id",
+#    legal_name: "Acme Corp.",
+#    tax_payer_type: LLP,
+#    filing_form: "944",
+#    taxable_as_scorp: false,
+#    version: "6cb95e00540706ca48d4577b3c839fbe"
+#  )
+      def update(company_id:, legal_name: nil, ein: nil, tax_payer_type: nil, filing_form: nil, taxable_as_scorp: nil, version:, 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 || {}), legal_name: legal_name, ein: ein, tax_payer_type: tax_payer_type, filing_form: filing_form, taxable_as_scorp: taxable_as_scorp, version: version }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/federal_tax_details"
+end
+        Gusto::FederalTaxDetails::FederalTaxDetails.from_json(json_object: response.body)
+      end
+    end
+    class AsyncFederalTaxDetailsClient
+    # @return [Gusto::AsyncRequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Companies::AsyncFederalTaxDetailsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Fetches attributes relevant for a company's federal taxes.
+#  scope: `company_federal_taxes:read`
+      #
+      # @param company_id [String] The UUID of the company
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FederalTaxDetails::FederalTaxDetails]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.federal_tax_details.get(company_id: "company_id")
+      def get(company_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/companies/#{company_id}/federal_tax_details"
+end
+          Gusto::FederalTaxDetails::FederalTaxDetails.from_json(json_object: response.body)
+        end
+      end
+# Updates attributes relevant for a company's federal taxes.
+#  This information is required is to onboard a company for use with Gusto Embedded
+#  Payroll.
+#  scope: `company_federal_taxes:write`
+      #
+      # @param company_id [String] The UUID of the company
+      # @param legal_name [String] The legal name of the company
+      # @param ein [String] The EIN of of the company
+      # @param tax_payer_type [Gusto::Companies::FederalTaxDetails::FederalTaxDetailsUpdateRequestTaxPayerType] What type of tax entity the company is
+      # @param filing_form [String] The form used by the company for federal tax filing. One of:
+#  - 941 (Quarterly federal tax return)
+#  - 944 (Annual federal tax return)
+      # @param taxable_as_scorp [Boolean] Whether this company should be taxed as an S-Corporation
+      # @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 request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FederalTaxDetails::FederalTaxDetails]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.federal_tax_details.update(
+#    company_id: "company_id",
+#    legal_name: "Acme Corp.",
+#    tax_payer_type: LLP,
+#    filing_form: "944",
+#    taxable_as_scorp: false,
+#    version: "6cb95e00540706ca48d4577b3c839fbe"
+#  )
+      def update(company_id:, legal_name: nil, ein: nil, tax_payer_type: nil, filing_form: nil, taxable_as_scorp: nil, version:, 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 || {}), legal_name: legal_name, ein: ein, tax_payer_type: tax_payer_type, filing_form: filing_form, taxable_as_scorp: taxable_as_scorp, version: version }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/federal_tax_details"
+end
+          Gusto::FederalTaxDetails::FederalTaxDetails.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/companies/federal_tax_details/types/federal_tax_details_update_request_tax_payer_type.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Gusto
+  module Companies
+    module FederalTaxDetails
+# What type of tax entity the company is
+      class FederalTaxDetailsUpdateRequestTaxPayerType
+
+        C_CORPORATION = "C-Corporation"
+        S_CORPORATION = "S-Corporation"
+        SOLE_PROPRIETOR = "Sole proprietor"
+        LLC = "LLC"
+        LLP = "LLP"
+        LIMITED_PARTNERSHIP = "Limited partnership"
+        CO_OWNERSHIP = "Co-ownership"
+        ASSOCIATION = "Association"
+        TRUSTEESHIP = "Trusteeship"
+        GENERAL_PARTNERSHIP = "General partnership"
+        JOINT_VENTURE = "Joint venture"
+        NON_PROFIT = "Non-Profit"
+
+      end
+    end
+  end
+end