gusto_embedded_client 0.3.0 → 0.3.1

data/lib/gusto_embedded/models/shared/payroll_digest_results_totals.rb

@@ -0,0 +1,40 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module GustoEmbedded
+  module Models
+    module Shared
+      # Pay totals. `null` when the payroll has not been calculated, or when the calculation is stale (the partner edited hours/earnings after the last calculation).
+      class PayrollDigestResultsTotals
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # Total amount debited from the company bank account (string-formatted decimal).
+        field :total_debit_amount, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('total_debit_amount') } }
+        # Total net pay across all employees on this payroll (string-formatted decimal).
+        field :net_pay, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('net_pay') } }
+        # Total employer cost including taxes and benefits (string-formatted decimal).
+        field :total_employer_cost, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('total_employer_cost') } }
+
+        sig { params(total_debit_amount: T.nilable(::String), net_pay: T.nilable(::String), total_employer_cost: T.nilable(::String)).void }
+        def initialize(total_debit_amount: nil, net_pay: nil, total_employer_cost: nil)
+          @total_debit_amount = total_debit_amount
+          @net_pay = net_pay
+          @total_employer_cost = total_employer_cost
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @total_debit_amount == other.total_debit_amount
+          return false unless @net_pay == other.net_pay
+          return false unless @total_employer_cost == other.total_employer_cost
+          true
+        end
+      end
+    end
+  end
+end

data/lib/gusto_embedded/models/shared/payroll_digest_results_totals.rbi

@@ -0,0 +1,17 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class GustoEmbedded::Models::Shared::PayrollDigestResultsTotals
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class GustoEmbedded::Models::Shared::PayrollDigestResultsTotals
+  def total_debit_amount(); end
+  def total_debit_amount=(str_); end
+  def net_pay(); end
+  def net_pay=(str_); end
+  def total_employer_cost(); end
+  def total_employer_cost=(str_); end
+end

data/lib/gusto_embedded/models/shared/payroll_digest_status.rb

@@ -0,0 +1,21 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module GustoEmbedded
+  module Models
+    module Shared
+      # PayrollDigestStatus - The lifecycle status of the batch request itself. Terminal values are `completed` (processing finished — inspect `results` and `exclusions` for per-company outcomes) and `failed` (request failed; can be retried). This is distinct from the per-company `status` returned inside `results[]` and `exclusions[]`.
+      class PayrollDigestStatus < T::Enum
+        enums do
+          PENDING = new('pending')
+          PROCESSING = new('processing')
+          COMPLETED = new('completed')
+          FAILED = new('failed')
+        end
+      end
+    end
+  end
+end

data/lib/gusto_embedded/models/shared/payroll_digest_status.rbi

@@ -0,0 +1,11 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class GustoEmbedded::Models::Shared::PayrollDigestStatus
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class GustoEmbedded::Models::Shared::PayrollDigestStatus
+end

data/lib/gusto_embedded/models/shared/payroll_employee_compensations_type_payment_method.rb

@@ -7,7 +7,7 @@
 module GustoEmbedded
   module Models
     module Shared
-      # PayrollEmployeeCompensationsTypePaymentMethod - The employee's compensation payment method. Is *only* `Historical` when retrieving external payrolls initially run outside of Gusto, then put into Gusto.
+
       class PayrollEmployeeCompensationsTypePaymentMethod < T::Enum
         enums do
           DIRECT_DEPOSIT = new('Direct Deposit')

data/lib/gusto_embedded/models/shared/payroll_show_payment_method.rb

@@ -7,7 +7,7 @@
 module GustoEmbedded
   module Models
     module Shared
-      # PayrollShowPaymentMethod - The employee's compensation payment method. Is *only* `Historical` when retrieving external payrolls initially run outside of Gusto, then put into Gusto.
+
       class PayrollShowPaymentMethod < T::Enum
         enums do
           DIRECT_DEPOSIT = new('Direct Deposit')

data/lib/gusto_embedded/models/shared/payroll_unprocessed_employee_compensations_type_payment_method.rb

@@ -7,7 +7,7 @@
 module GustoEmbedded
   module Models
     module Shared
-      # PayrollUnprocessedEmployeeCompensationsTypePaymentMethod - The employee's compensation payment method. Is *only* `Historical` when retrieving external payrolls initially run outside of Gusto, then put into Gusto.
+
       class PayrollUnprocessedEmployeeCompensationsTypePaymentMethod < T::Enum
         enums do
           DIRECT_DEPOSIT = new('Direct Deposit')

data/lib/gusto_embedded/models/shared/payrolls.rb

@@ -0,0 +1,60 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module GustoEmbedded
+  module Models
+    module Shared
+
+      class Payrolls
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # The type of payroll (e.g. `regular`, `new_hire`, `termination`, `transition`, `bonus`, `correction`).
+        field :payroll_type, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('payroll_type') } }
+        # Partner-facing display title for this payroll (e.g. "Run biweekly payroll").
+        field :display_title, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('display_title') } }
+        # Whether the company has auto-payroll enabled for this pay schedule.
+        field :auto_payroll, Crystalline::Nilable.new(Crystalline::Boolean.new), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('auto_payroll') } }
+        # The lifecycle status of the payroll (e.g. `ready_to_start`, `in_progress`, `submitted`, `completed`, `failed`).
+        field :status, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('status') } }
+
+        field :pay_period, Crystalline::Nilable.new(Models::Shared::PayrollDigestResultsPayPeriod), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('pay_period') } }
+        # UUID of the payroll. `null` for upcoming pay periods that have not been started yet (the `payrolls` API has not yet created a payroll record). Once a payroll is created, subsequent digest requests will include the real `payroll_uuid`.
+        field :payroll_uuid, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('payroll_uuid') } }
+
+        field :pay_schedule, Crystalline::Nilable.new(Models::Shared::PaySchedule), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('pay_schedule') } }
+        # Pay totals. `null` when the payroll has not been calculated, or when the calculation is stale (the partner edited hours/earnings after the last calculation).
+        field :totals, Crystalline::Nilable.new(Models::Shared::PayrollDigestResultsTotals), { 'format_json': { 'letter_case': ::GustoEmbedded::Utils.field_name('totals') } }
+
+        sig { params(payroll_type: T.nilable(::String), display_title: T.nilable(::String), auto_payroll: T.nilable(T::Boolean), status: T.nilable(::String), pay_period: T.nilable(Models::Shared::PayrollDigestResultsPayPeriod), payroll_uuid: T.nilable(::String), pay_schedule: T.nilable(Models::Shared::PaySchedule), totals: T.nilable(Models::Shared::PayrollDigestResultsTotals)).void }
+        def initialize(payroll_type: nil, display_title: nil, auto_payroll: nil, status: nil, pay_period: nil, payroll_uuid: nil, pay_schedule: nil, totals: nil)
+          @payroll_type = payroll_type
+          @display_title = display_title
+          @auto_payroll = auto_payroll
+          @status = status
+          @pay_period = pay_period
+          @payroll_uuid = payroll_uuid
+          @pay_schedule = pay_schedule
+          @totals = totals
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @payroll_type == other.payroll_type
+          return false unless @display_title == other.display_title
+          return false unless @auto_payroll == other.auto_payroll
+          return false unless @status == other.status
+          return false unless @pay_period == other.pay_period
+          return false unless @payroll_uuid == other.payroll_uuid
+          return false unless @pay_schedule == other.pay_schedule
+          return false unless @totals == other.totals
+          true
+        end
+      end
+    end
+  end
+end

data/lib/gusto_embedded/models/shared/payrolls.rbi

@@ -0,0 +1,27 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class GustoEmbedded::Models::Shared::Payrolls
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class GustoEmbedded::Models::Shared::Payrolls
+  def payroll_type(); end
+  def payroll_type=(str_); end
+  def display_title(); end
+  def display_title=(str_); end
+  def auto_payroll(); end
+  def auto_payroll=(str_); end
+  def status(); end
+  def status=(str_); end
+  def pay_period(); end
+  def pay_period=(str_); end
+  def payroll_uuid(); end
+  def payroll_uuid=(str_); end
+  def pay_schedule(); end
+  def pay_schedule=(str_); end
+  def totals(); end
+  def totals=(str_); end
+end

data/lib/gusto_embedded/models/shared/update_garnishment_request_garnishment_type.rb

@@ -7,7 +7,7 @@
 module GustoEmbedded
   module Models
     module Shared
-      # UpdateGarnishmentRequestGarnishmentType - The specific type of garnishment for court ordered garnishments.
+
       class UpdateGarnishmentRequestGarnishmentType < T::Enum
         enums do
           CHILD_SUPPORT = new('child_support')

data/lib/gusto_embedded/models/shared.rb

@@ -227,6 +227,7 @@ module GustoEmbedded
       autoload :EmployeeOnboardingStatus1, 'gusto_embedded/models/shared/employee_onboarding_status1.rb'
       autoload :EmployeePaymentMethod1, 'gusto_embedded/models/shared/employee_payment_method1.rb'
       autoload :EmployeeStatus, 'gusto_embedded/models/shared/employee_status.rb'
+      autoload :EmployeesAnnualFicaWageReportAcceptance, 'gusto_embedded/models/shared/employees_annual_fica_wage_report_acceptance.rb'
       autoload :EmploymentHistoryList, 'gusto_embedded/models/shared/employment_history_list.rb'
       autoload :EmploymentHistoryListEmploymentStatus, 'gusto_embedded/models/shared/employment_history_list_employment_status.rb'
       autoload :EntityErrorObject, 'gusto_embedded/models/shared/entity_error_object.rb'
@@ -366,6 +367,19 @@ module GustoEmbedded
       autoload :PayrollCreditBlockerUnblockOptionWaitForReverseWire, 'gusto_embedded/models/shared/payroll_credit_blocker_unblock_option_wait_for_reverse_wire.rb'
       autoload :PayrollCreditBlockerUnblockOptionWaitForReverseWireMetadata, 'gusto_embedded/models/shared/payroll_credit_blocker_unblock_option_wait_for_reverse_wire_metadata.rb'
       autoload :PayrollCreditBlockerUnblockOptionWaitForReverseWireUnblockType, 'gusto_embedded/models/shared/payroll_credit_blocker_unblock_option_wait_for_reverse_wire_unblock_type.rb'
+      autoload :PayrollDigest, 'gusto_embedded/models/shared/payroll_digest.rb'
+      autoload :PayrollDigestResults, 'gusto_embedded/models/shared/payroll_digest_results.rb'
+      autoload :PayrollDigestResultsCategory, 'gusto_embedded/models/shared/payroll_digest_results_category.rb'
+      autoload :PayrollDigestResultsEntityType, 'gusto_embedded/models/shared/payroll_digest_results_entity_type.rb'
+      autoload :PayrollDigestResultsExclusions, 'gusto_embedded/models/shared/payroll_digest_results_exclusions.rb'
+      autoload :PayrollDigestResultsExclusionsEntityType, 'gusto_embedded/models/shared/payroll_digest_results_exclusions_entity_type.rb'
+      autoload :PayrollDigestResultsExclusionsStatus, 'gusto_embedded/models/shared/payroll_digest_results_exclusions_status.rb'
+      autoload :PayrollDigestResultsPayPeriod, 'gusto_embedded/models/shared/payroll_digest_results_pay_period.rb'
+      autoload :PayrollDigestResultsResults, 'gusto_embedded/models/shared/payroll_digest_results_results.rb'
+      autoload :PayrollDigestResultsResultsStatus, 'gusto_embedded/models/shared/payroll_digest_results_results_status.rb'
+      autoload :PayrollDigestResultsStatus, 'gusto_embedded/models/shared/payroll_digest_results_status.rb'
+      autoload :PayrollDigestResultsTotals, 'gusto_embedded/models/shared/payroll_digest_results_totals.rb'
+      autoload :PayrollDigestStatus, 'gusto_embedded/models/shared/payroll_digest_status.rb'
       autoload :PayrollEmployeeCompensationsType, 'gusto_embedded/models/shared/payroll_employee_compensations_type.rb'
       autoload :PayrollEmployeeCompensationsTypeFixedCompensations, 'gusto_embedded/models/shared/payroll_employee_compensations_type_fixed_compensations.rb'
       autoload :PayrollEmployeeCompensationsTypeHourlyCompensations, 'gusto_embedded/models/shared/payroll_employee_compensations_type_hourly_compensations.rb'
@@ -503,8 +517,10 @@ module GustoEmbedded
       autoload :Approver, 'gusto_embedded/models/shared/approver.rb'
       autoload :AuthorizationStatus, 'gusto_embedded/models/shared/authorization_status.rb'
       autoload :Balances, 'gusto_embedded/models/shared/balances.rb'
+      autoload :BatchAction, 'gusto_embedded/models/shared/batch_action.rb'
       autoload :Benefits, 'gusto_embedded/models/shared/benefits.rb'
       autoload :BlockerType, 'gusto_embedded/models/shared/blocker_type.rb'
+      autoload :Blockers, 'gusto_embedded/models/shared/blockers.rb'
       autoload :CatchUp, 'gusto_embedded/models/shared/catch_up.rb'
       autoload :CatchUpType, 'gusto_embedded/models/shared/catch_up_type.rb'
       autoload :Category, 'gusto_embedded/models/shared/category.rb'
@@ -584,6 +600,7 @@ module GustoEmbedded
       autoload :Options, 'gusto_embedded/models/shared/options.rb'
       autoload :OwnerType, 'gusto_embedded/models/shared/owner_type.rb'
       autoload :Pages, 'gusto_embedded/models/shared/pages.rb'
+      autoload :PaySchedule, 'gusto_embedded/models/shared/pay_schedule.rb'
       autoload :PayScheduleType, 'gusto_embedded/models/shared/pay_schedule_type.rb'
       autoload :PaymentDirection, 'gusto_embedded/models/shared/payment_direction.rb'
       autoload :PaymentEventType, 'gusto_embedded/models/shared/payment_event_type.rb'
@@ -595,6 +612,7 @@ module GustoEmbedded
       autoload :PaymentUnit, 'gusto_embedded/models/shared/payment_unit.rb'
       autoload :PayrollBenefits, 'gusto_embedded/models/shared/payroll_benefits.rb'
       autoload :PayrollType, 'gusto_embedded/models/shared/payroll_type.rb'
+      autoload :Payrolls, 'gusto_embedded/models/shared/payrolls.rb'
       autoload :PlaidStatus, 'gusto_embedded/models/shared/plaid_status.rb'
       autoload :PolicyType, 'gusto_embedded/models/shared/policy_type.rb'
       autoload :PossibleLiabilities, 'gusto_embedded/models/shared/possible_liabilities.rb'

data/lib/gusto_embedded/payroll_digests.rb

@@ -0,0 +1,342 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/multipart'
+require 'faraday/retry'
+require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
+require_relative 'utils/retries'
+
+module GustoEmbedded
+  extend T::Sig
+  class PayrollDigests
+    extend T::Sig
+    
+
+
+    sig { params(sdk_config: SDKConfiguration).void }
+    def initialize(sdk_config)
+      @sdk_configuration = sdk_config
+      
+    end
+
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
+    def get_url(base_url:, url_variables: nil)
+      sd_base_url, sd_options = @sdk_configuration.get_server_details
+
+      if base_url.nil?
+        base_url = sd_base_url
+      end
+
+      if url_variables.nil?
+        url_variables = sd_options
+      end
+
+      return Utils.template_url base_url, url_variables
+    end
+
+
+
+
+    sig { params(security: Models::Operations::PostV1PayrollDigestsSecurity, request_body: Models::Operations::PostV1PayrollDigestsRequestBody, x_gusto_api_version: T.nilable(Models::Operations::PostV1PayrollDigestsHeaderXGustoAPIVersion), timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Operations::PostV1PayrollDigestsResponse) }
+    def post_v1_payroll_digests(security:, request_body:, x_gusto_api_version: nil, timeout_ms: nil, http_headers: nil)
+      # post_v1_payroll_digests - Create a payroll digest batch
+      # Triggers an asynchronous computation of payroll digest data (statuses, blockers, pay periods, totals) across up to 25 companies that the partner is mapped to.
+      #
+      # The batch is processed asynchronously. Use the returned batch UUID to poll `GET /v1/payroll_digests/{payroll_digest_uuid}` for status and results.
+      #
+      # Idempotency is scoped per `(partner, idempotency_key)`. A duplicate POST with the same `idempotency_key` returns a 409 Conflict referencing the existing batch UUID — no duplicate computation occurs.
+      #
+      # 📘 System Access Authentication
+      #
+      # This endpoint uses the [Bearer Auth scheme with the system-level access token in the HTTP Authorization header](https://docs.gusto.com/embedded-payroll/docs/system-access)
+      #
+      # scope: `payroll_digests:write`
+      request = Models::Operations::PostV1PayrollDigestsRequest.new(
+        request_body: request_body,
+        x_gusto_api_version: x_gusto_api_version
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/v1/payroll_digests"
+      headers = Utils.get_headers(request)
+      headers = T.cast(headers, T::Hash[String, String])
+      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :request_body, :json)
+      headers['content-type'] = req_content_type
+      raise StandardError, 'request body is required' if data.nil? && form.nil?
+
+      if form && !form.empty?
+        body = Utils.encode_form(form)
+      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
+        body = URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
+      else
+        body = data
+      end
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+      
+
+      connection = @sdk_configuration.client
+
+      hook_ctx = SDKHooks::HookContext.new(
+        config: @sdk_configuration,
+        base_url: base_url,
+        oauth2_scopes: nil,
+        operation_id: 'post-v1-payroll_digests',
+        security_source: -> { security }
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      http_response = T.let(nil, T.nilable(Faraday::Response))
+      
+      
+      begin
+        http_response = T.must(connection).post(url) do |req|
+          req.body = body
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          Utils.configure_request_security(req, security)
+          http_headers&.each do |key, value|
+            req.headers[key.to_s] = value
+          end
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+      rescue StandardError => e
+        error = e
+      ensure
+        if http_response.nil? || Utils.error_status?(http_response.status)
+          http_response = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        else
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        end
+        
+        if http_response.nil?
+          raise error if !error.nil?
+          raise 'no response'
+        end
+      end
+      
+      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      if Utils.match_status_code(http_response.status, ['201'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Shared::PayrollDigest)
+          response = Models::Operations::PostV1PayrollDigestsResponse.new(
+            status_code: http_response.status,
+            content_type: content_type,
+            raw_response: http_response,
+            payroll_digest: T.unsafe(obj)
+          )
+
+          return response
+        else
+          raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['409'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::PayrollDigestConflictError)
+          raise obj
+        else
+          raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['422'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::UnprocessableEntityError)
+          raise obj
+        else
+          raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['4XX'])
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      elsif Utils.match_status_code(http_response.status, ['5XX'])
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      else
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown status code received'
+
+      end
+    end
+
+
+    sig { params(security: Models::Operations::GetV1PayrollDigestsPayrollDigestUuidSecurity, payroll_digest_uuid: ::String, x_gusto_api_version: T.nilable(Models::Operations::GetV1PayrollDigestsPayrollDigestUuidHeaderXGustoAPIVersion), timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Operations::GetV1PayrollDigestsPayrollDigestUuidResponse) }
+    def get_v1_payroll_digests_payroll_digest_uuid(security:, payroll_digest_uuid:, x_gusto_api_version: nil, timeout_ms: nil, http_headers: nil)
+      # get_v1_payroll_digests_payroll_digest_uuid - Get a payroll digest batch
+      # Returns the status and results of a payroll digest batch.
+      #
+      # Poll this endpoint until the batch `status` reaches a terminal value (`completed` or `failed`). Once terminal, the response includes the full `results` array (one entry per attempted company, each with its own per-company `status` — `success`, `partial_success`, or `failed`) and the `exclusions` array (one entry per company that could not be looked up or processed).
+      #
+      # Note that the top-level batch `status` (`pending` / `processing` / `completed` / `failed`) is distinct from the per-company `status` returned inside `results[]` and `exclusions[]`. A `completed` batch does not imply every company succeeded — inspect the arrays for per-company outcomes.
+      #
+      # Results are stored in Redis with a short TTL after completion. If the partner polls after results have expired, this endpoint returns 410 Gone — partners should re-submit a new batch to fetch fresh data.
+      #
+      # 📘 System Access Authentication
+      #
+      # This endpoint uses the [Bearer Auth scheme with the system-level access token in the HTTP Authorization header](https://docs.gusto.com/embedded-payroll/docs/system-access)
+      #
+      # scope: `payroll_digests:read`
+      request = Models::Operations::GetV1PayrollDigestsPayrollDigestUuidRequest.new(
+        payroll_digest_uuid: payroll_digest_uuid,
+        x_gusto_api_version: x_gusto_api_version
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        Models::Operations::GetV1PayrollDigestsPayrollDigestUuidRequest,
+        base_url,
+        '/v1/payroll_digests/{payroll_digest_uuid}',
+        request
+      )
+      headers = Utils.get_headers(request)
+      headers = T.cast(headers, T::Hash[String, String])
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+      
+
+      connection = @sdk_configuration.client
+
+      hook_ctx = SDKHooks::HookContext.new(
+        config: @sdk_configuration,
+        base_url: base_url,
+        oauth2_scopes: nil,
+        operation_id: 'get-v1-payroll_digests-payroll_digest_uuid',
+        security_source: -> { security }
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      http_response = T.let(nil, T.nilable(Faraday::Response))
+      
+      
+      begin
+        http_response = T.must(connection).get(url) do |req|
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          Utils.configure_request_security(req, security)
+          http_headers&.each do |key, value|
+            req.headers[key.to_s] = value
+          end
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+      rescue StandardError => e
+        error = e
+      ensure
+        if http_response.nil? || Utils.error_status?(http_response.status)
+          http_response = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        else
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        end
+        
+        if http_response.nil?
+          raise error if !error.nil?
+          raise 'no response'
+        end
+      end
+      
+      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      if Utils.match_status_code(http_response.status, ['200'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Shared::PayrollDigestResults)
+          response = Models::Operations::GetV1PayrollDigestsPayrollDigestUuidResponse.new(
+            status_code: http_response.status,
+            content_type: content_type,
+            raw_response: http_response,
+            payroll_digest_results: T.unsafe(obj)
+          )
+
+          return response
+        else
+          raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['404', '410'])
+        if Utils.match_content_type(content_type, 'application/json')
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::NotFoundErrorObject)
+          raise obj
+        else
+          raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['4XX'])
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      elsif Utils.match_status_code(http_response.status, ['5XX'])
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      else
+        raise ::GustoEmbedded::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown status code received'
+
+      end
+    end
+end
+end

data/lib/gusto_embedded/reports.rb

@@ -764,12 +764,12 @@ module GustoEmbedded
             response: http_response
           )
           response_data = http_response.env.response_body
-          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Operations::PostV1CompaniesCompanyIdReportsEmployeesAnnualFicaWageResponseBody)
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Shared::EmployeesAnnualFicaWageReportAcceptance)
           response = Models::Operations::PostV1CompaniesCompanyIdReportsEmployeesAnnualFicaWageResponse.new(
             status_code: http_response.status,
             content_type: content_type,
             raw_response: http_response,
-            object: T.unsafe(obj)
+            employees_annual_fica_wage_report_acceptance: T.unsafe(obj)
           )
 
           return response

data/lib/gusto_embedded/sdkconfiguration.rb

@@ -91,9 +91,9 @@ module GustoEmbedded
       end
       @language = 'ruby'
       @openapi_doc_version = '2025-06-15'
-      @sdk_version = '0.3.0'
-      @gen_version = '2.885.0'
-      @user_agent = 'speakeasy-sdk/ruby 0.3.0 2.885.0 2025-06-15 gusto_embedded_client'
+      @sdk_version = '0.3.1'
+      @gen_version = '2.889.1'
+      @user_agent = 'speakeasy-sdk/ruby 0.3.1 2.889.1 2025-06-15 gusto_embedded_client'
     end
 
     sig { returns([String, T::Hash[Symbol, String]]) }