vitable-connect 0.4.0 → 0.6.0

data/lib/vitable_connect/models.rb

@@ -44,12 +44,6 @@ module VitableConnect
 
   AuthIssueAccessTokenParams = VitableConnect::Models::AuthIssueAccessTokenParams
 
-  BenefitEligibilityPolicy = VitableConnect::Models::BenefitEligibilityPolicy
-
-  BenefitEligibilityPolicyResponse = VitableConnect::Models::BenefitEligibilityPolicyResponse
-
-  BenefitEligibilityPolicyRetrieveParams = VitableConnect::Models::BenefitEligibilityPolicyRetrieveParams
-
   Employee = VitableConnect::Models::Employee
 
   EmployeeClass = VitableConnect::Models::EmployeeClass
@@ -58,31 +52,62 @@ module VitableConnect
 
   EmployeeRetrieveParams = VitableConnect::Models::EmployeeRetrieveParams
 
-  Employer = VitableConnect::Models::Employer
+  EmployeeUpdateParams = VitableConnect::Models::EmployeeUpdateParams
 
-  EmployerCreateBenefitEligibilityPolicyParams =
-    VitableConnect::Models::EmployerCreateBenefitEligibilityPolicyParams
+  Employer = VitableConnect::Models::Employer
 
   EmployerCreateParams = VitableConnect::Models::EmployerCreateParams
 
+  EmployerEnsurePayrollIntegrationEmailParams =
+    VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailParams
+
+  EmployerListBenefitPlanYearEnrollmentsParams =
+    VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsParams
+
+  EmployerListBenefitPlanYearsParams = VitableConnect::Models::EmployerListBenefitPlanYearsParams
+
   EmployerListEmployeesParams = VitableConnect::Models::EmployerListEmployeesParams
 
+  EmployerListHRISProvidersParams = VitableConnect::Models::EmployerListHRISProvidersParams
+
+  EmployerListInvoicesParams = VitableConnect::Models::EmployerListInvoicesParams
+
   EmployerListParams = VitableConnect::Models::EmployerListParams
 
+  EmployerListPayrollDeductionStatementsParams =
+    VitableConnect::Models::EmployerListPayrollDeductionStatementsParams
+
   EmployerResponse = VitableConnect::Models::EmployerResponse
 
+  EmployerRetrieveBenefitPlanYearParams = VitableConnect::Models::EmployerRetrieveBenefitPlanYearParams
+
+  EmployerRetrieveHRISParams = VitableConnect::Models::EmployerRetrieveHRISParams
+
+  EmployerRetrieveInvoicePdfParams = VitableConnect::Models::EmployerRetrieveInvoicePdfParams
+
   EmployerRetrieveParams = VitableConnect::Models::EmployerRetrieveParams
 
+  EmployerRetrievePayrollAccessSetupParams =
+    VitableConnect::Models::EmployerRetrievePayrollAccessSetupParams
+
   EmployerSubmitCensusSyncParams = VitableConnect::Models::EmployerSubmitCensusSyncParams
 
+  EmployerSubmitPayrollAccessSetupParams = VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams
+
+  EmployerUpdateParams = VitableConnect::Models::EmployerUpdateParams
+
   EmployerUpdateSettingsParams = VitableConnect::Models::EmployerUpdateSettingsParams
 
   Enrollment = VitableConnect::Models::Enrollment
 
+  EnrollmentReissueParams = VitableConnect::Models::EnrollmentReissueParams
+
   EnrollmentRetrieveParams = VitableConnect::Models::EnrollmentRetrieveParams
 
   EnrollmentStatus = VitableConnect::Models::EnrollmentStatus
 
+  EnrollmentTerminateParams = VitableConnect::Models::EnrollmentTerminateParams
+
   Group = VitableConnect::Models::Group
 
   GroupCreateParams = VitableConnect::Models::GroupCreateParams
@@ -97,12 +122,30 @@ module VitableConnect
 
   GroupUpdateParams = VitableConnect::Models::GroupUpdateParams
 
+  MemberListDependentsParams = VitableConnect::Models::MemberListDependentsParams
+
+  MemberListEmploymentsParams = VitableConnect::Models::MemberListEmploymentsParams
+
+  MemberListEnrollmentsParams = VitableConnect::Models::MemberListEnrollmentsParams
+
+  MemberListIDCardsParams = VitableConnect::Models::MemberListIDCardsParams
+
+  MemberListParams = VitableConnect::Models::MemberListParams
+
+  MemberListQualifyingLifeEventsParams = VitableConnect::Models::MemberListQualifyingLifeEventsParams
+
+  MemberRetrieveHouseholdParams = VitableConnect::Models::MemberRetrieveHouseholdParams
+
+  MemberRetrieveParams = VitableConnect::Models::MemberRetrieveParams
+
+  OrganizationCreateParams = VitableConnect::Models::OrganizationCreateParams
+
+  OrganizationListParams = VitableConnect::Models::OrganizationListParams
+
   Pagination = VitableConnect::Models::Pagination
 
   PlanListParams = VitableConnect::Models::PlanListParams
 
-  Type = VitableConnect::Models::Type
-
   WebhookEvent = VitableConnect::Models::WebhookEvent
 
   WebhookEventListDeliveriesParams = VitableConnect::Models::WebhookEventListDeliveriesParams

data/lib/vitable_connect/resources/employees.rb

@@ -4,9 +4,10 @@ module VitableConnect
   module Resources
     class Employees
       # Retrieves detailed information for a specific employee by ID. Returns employee
-      # details including personal information, employment status, and payroll
-      # deductions from the most recent statement period. Deductions reflect a snapshot
-      # of the current period and are replaced when a new statement is generated.
+      # details including personal information, employment status, classification and
+      # compensation-type effective dates, compensation type, and payroll deductions
+      # from the most recent statement period. Deductions reflect a snapshot of the
+      # current period and are replaced when a new statement is generated.
       #
       # @overload retrieve(employee_id, request_options: {})
       #
@@ -26,6 +27,51 @@ module VitableConnect
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::EmployeeUpdateParams} for more details.
+      #
+      # Updates employee personal, contact, address, and employment fields. This
+      # endpoint currently supports email, phone, gender, address, employee_class,
+      # start_date, and compensation_type. effective_date is required and applies to
+      # employee_class and compensation_type when those fields are included in the
+      # request.
+      #
+      # @overload update(employee_id, effective_date:, address: nil, compensation_type: nil, email: nil, employee_class: nil, gender: nil, phone: nil, start_date: nil, request_options: {})
+      #
+      # @param employee_id [String] Unique employee identifier (empl\_\*)
+      #
+      # @param effective_date [Date] Past or present date applied to each tracked employment field included in this r
+      #
+      # @param address [VitableConnect::Models::EmployeeUpdateParams::Address, nil] Employee's residential address
+      #
+      # @param compensation_type [Symbol, VitableConnect::Models::EmployeeUpdateParams::CompensationType, nil] - `Salary` - Salary
+      #
+      # @param email [String, nil] Email address
+      #
+      # @param employee_class [Symbol, VitableConnect::Models::EmployeeClass, nil] - `Full Time` - Full Time
+      #
+      # @param gender [Symbol, VitableConnect::Models::EmployeeUpdateParams::Gender, nil] - `Male` - Male
+      #
+      # @param phone [String, nil] Phone number
+      #
+      # @param start_date [Date, nil] Employment start date
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployeeUpdateResponse]
+      #
+      # @see VitableConnect::Models::EmployeeUpdateParams
+      def update(employee_id, params)
+        parsed, options = VitableConnect::EmployeeUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/employees/%1$s", employee_id],
+          body: parsed,
+          model: VitableConnect::Models::EmployeeUpdateResponse,
+          options: options
+        )
+      end
+
       # Retrieves a paginated list of benefit enrollments for an employee.
       #
       # @overload list_enrollments(employee_id, limit: nil, page: nil, request_options: {})

data/lib/vitable_connect/resources/employers.rb

@@ -60,19 +60,69 @@ module VitableConnect
         )
       end
 
-      # Retrieves a paginated list of all employers belonging to the authenticated
-      # organization. Results are sorted by creation date (newest first) and paginated
-      # using page and limit parameters.
+      # Updates an existing employer. All fields are optional — only provided fields are
+      # updated. PO Box addresses are rejected.
       #
-      # @overload list(limit: nil, page: nil, request_options: {})
+      # @overload update(employer_id, active: nil, address: nil, legal_name: nil, name: nil, request_options: {})
       #
-      # @param limit [Integer] Items per page (default: 20, max: 100)
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
       #
-      # @param page [Integer] Page number (default: 1)
+      # @param active [Boolean, nil] Whether the employer is active
+      #
+      # @param address [VitableConnect::Models::EmployerUpdateParams::Address, nil] Employer address
+      #
+      # @param legal_name [String, nil] Legal business name
+      #
+      # @param name [String, nil] Employer display name
       #
       # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::Employer>]
+      # @return [VitableConnect::Models::EmployerResponse]
+      #
+      # @see VitableConnect::Models::EmployerUpdateParams
+      def update(employer_id, params = {})
+        parsed, options = VitableConnect::EmployerUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["v1/employers/%1$s", employer_id],
+          body: parsed,
+          model: VitableConnect::EmployerResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::EmployerListParams} for more details.
+      #
+      # Returns the caller's employer book — every employer with its computed columns
+      # (enrollment-rate summary, benefit-family tags, HRIS connection,
+      # benefit-lifecycle stage) merged with the employer's flat CRM fields (legal name,
+      # EIN, contact, address, timestamps). The book is derived from the authenticated
+      # principal: one organization's employers, or every organization's for a caller
+      # whose reach is not a single organization. Supports name search,
+      # benefit-family/lifecycle/HRIS filters, and page/limit pagination.
+      #
+      # @overload list(benefit_family: nil, benefit_lifecycle_stage: nil, hris_provider: nil, hris_status: nil, include_cancelled: nil, limit: nil, page: nil, search: nil, request_options: {})
+      #
+      # @param benefit_family [Array<Symbol, VitableConnect::Models::EmployerListParams::BenefitFamily>] Filter to employers with at least one active benefit in these families.
+      #
+      # @param benefit_lifecycle_stage [Array<Symbol, VitableConnect::Models::EmployerListParams::BenefitLifecycleStage>] Filter to employers in one of these computed benefit-lifecycle stages.
+      #
+      # @param hris_provider [Array<String>] Filter to employers whose HRIS connection is with one of these payroll providers
+      #
+      # @param hris_status [Array<Symbol, VitableConnect::Models::EmployerListParams::HRISStatus>] Filter to employers whose HRIS connection is in one of these statuses.
+      #
+      # @param include_cancelled [Boolean] Include cancelled employers (hidden by default unless their stage is explicitly
+      #
+      # @param limit [Integer] Items per page.
+      #
+      # @param page [Integer] Page number.
+      #
+      # @param search [String, nil] Case-insensitive employer-name substring filter.
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::EmployerListResponse>]
       #
       # @see VitableConnect::Models::EmployerListParams
       def list(params = {})
@@ -83,54 +133,121 @@ module VitableConnect
           path: "v1/employers",
           query: query,
           page: VitableConnect::Internal::PageNumberPage,
-          model: VitableConnect::Employer,
+          model: VitableConnect::Models::EmployerListResponse,
           options: options
         )
       end
 
+      # Provision and return the employer's payroll integration email.
+      #
+      # @overload ensure_payroll_integration_email(employer_id, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse]
+      #
+      # @see VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailParams
+      def ensure_payroll_integration_email(employer_id, params = {})
+        @client.request(
+          method: :put,
+          path: ["v1/employers/%1$s/payroll-integration-email", employer_id],
+          model: VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Some parameter documentations has been truncated, see
-      # {VitableConnect::Models::EmployerCreateBenefitEligibilityPolicyParams} for more
+      # {VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsParams} for more
       # details.
       #
-      # Creates a benefit eligibility policy for the specified employer.
+      # Returns a paginated list of every member with an enrollment in one of an
+      # employer's plan years, any election status: what they elected, where their
+      # coverage stands, dependent count, carrier, plan, tier, and the plan's total
+      # monthly cost. The caller must be authorized for the employer `empr_<...>`; an
+      # unknown or unauthorized employer, or an unknown plan year `plyr_<...>`,
+      # returns 404.
       #
-      # @overload create_benefit_eligibility_policy(employer_id, classification:, waiting_period:, request_options: {})
+      # @overload list_benefit_plan_year_enrollments(benefit_plan_year_id, employer_id:, election_status: nil, limit: nil, page: nil, search: nil, request_options: {})
       #
-      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      # @param benefit_plan_year_id [String] Path param: Unique benefit-plan-year identifier (plyr\_\*).
+      #
+      # @param employer_id [String] Path param: Unique employer identifier (empr\_\*)
+      #
+      # @param election_status [Array<Symbol, VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus>] Query param: Filter by election status. Repeat the parameter to match several.
       #
-      # @param classification [String] Which employee classifications are eligible. One of: full_time, part_time, all
+      # @param limit [Integer] Query param: Items per page (default: 20, max: 100)
       #
-      # @param waiting_period [String] Waiting period before eligibility. One of: first_of_following_month, 30_days, 60
+      # @param page [Integer] Query param: Page number (default: 1)
+      #
+      # @param search [String] Query param: Case-insensitive search. Matches member name partially, and the `me
       #
       # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [VitableConnect::Models::BenefitEligibilityPolicyResponse]
+      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse>]
       #
-      # @see VitableConnect::Models::EmployerCreateBenefitEligibilityPolicyParams
-      def create_benefit_eligibility_policy(employer_id, params)
-        parsed, options = VitableConnect::EmployerCreateBenefitEligibilityPolicyParams.dump_request(params)
+      # @see VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsParams
+      def list_benefit_plan_year_enrollments(benefit_plan_year_id, params)
+        parsed, options = VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams.dump_request(params)
+        query = VitableConnect::Internal::Util.encode_query_params(parsed)
+        employer_id =
+          parsed.delete(:employer_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
         @client.request(
-          method: :post,
-          path: ["v1/employers/%1$s/benefit-eligibility-policies", employer_id],
-          body: parsed,
-          model: VitableConnect::BenefitEligibilityPolicyResponse,
+          method: :get,
+          path: ["v1/employers/%1$s/benefit-plan-years/%2$s/enrollments", employer_id, benefit_plan_year_id],
+          query: query,
+          page: VitableConnect::Internal::PageNumberPage,
+          model: VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse,
           options: options
         )
       end
 
-      # Retrieves a paginated list of all employees for a specific employer. Results are
-      # paginated using page and limit parameters. Each employee includes payroll
-      # deductions from the most recent statement period. When a new deduction statement
-      # is generated, previous period deductions are replaced.
+      # Returns the employer's benefit plan years (all years, or one when `year` is
+      # given), each with its benefits, offered states, benefit families, and the
+      # year-level enrollment roll-up. The caller must be authorized for the employer;
+      # an unknown or unauthorized employer returns 404.
+      #
+      # @overload list_benefit_plan_years(employer_id, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerListBenefitPlanYearsResponse]
+      #
+      # @see VitableConnect::Models::EmployerListBenefitPlanYearsParams
+      def list_benefit_plan_years(employer_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/benefit-plan-years", employer_id],
+          model: VitableConnect::Models::EmployerListBenefitPlanYearsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Retrieves a paginated list of employees for a specific employer. The caller must
+      # be authorized for the employer; an unknown or unauthorized employer returns 404.
+      # Results are paginated using page and limit parameters and can be narrowed with a
+      # case-insensitive `search` (first name, last name, or email) and an
+      # `employment_status` filter (active or terminated). Each employee includes
+      # payroll deductions from the most recent statement period. When a new deduction
+      # statement is generated, previous period deductions are replaced.
       #
-      # @overload list_employees(employer_id, limit: nil, page: nil, request_options: {})
+      # @overload list_employees(employer_id, employment_status: nil, limit: nil, page: nil, search: nil, request_options: {})
       #
       # @param employer_id [String] Unique employer identifier (empr\_\*)
       #
+      # @param employment_status [Symbol, VitableConnect::Models::EmployerListEmployeesParams::EmploymentStatus] Filter by employment status (active or terminated)
+      #
       # @param limit [Integer] Items per page (default: 20, max: 100)
       #
       # @param page [Integer] Page number (default: 1)
       #
+      # @param search [String] Case-insensitive search across employee first name, last name, and email
+      #
       # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::Employee>]
@@ -149,6 +266,191 @@ module VitableConnect
         )
       end
 
+      # Returns the distinct HRIS/payroll providers across the same book
+      # `GET /v1/employers` returns, sorted for display. Use these as the values for the
+      # employers list's `hris_provider` filter — the providers are free text, so they
+      # cannot be enumerated in advance.
+      #
+      # @overload list_hris_providers(request_options: {})
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerListHRISProvidersResponse]
+      #
+      # @see VitableConnect::Models::EmployerListHRISProvidersParams
+      def list_hris_providers(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/employers/hris-providers",
+          model: VitableConnect::Models::EmployerListHRISProvidersResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns a cursor-paginated page of the employer's billing invoices, newest
+      # first. Pass the `next_offset` from a previous page as `offset` to fetch the next
+      # page. The caller must be authorized for the employer; an unknown or unauthorized
+      # employer returns 404.
+      #
+      # @overload list_invoices(employer_id, limit: nil, offset: nil, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param limit [Integer] Maximum number of invoices per page
+      #
+      # @param offset [String, nil] Opaque cursor from a previous page's next_offset
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerListInvoicesResponse]
+      #
+      # @see VitableConnect::Models::EmployerListInvoicesParams
+      def list_invoices(employer_id, params = {})
+        parsed, options = VitableConnect::EmployerListInvoicesParams.dump_request(params)
+        query = VitableConnect::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/invoices", employer_id],
+          query: query,
+          model: VitableConnect::Models::EmployerListInvoicesResponse,
+          options: options
+        )
+      end
+
+      # Returns a paginated list of the employer's payroll-deduction statements, newest
+      # period first, each with its period, generation date, distinct employee count,
+      # total deduction, change-file link, and deduction frequency. Statements
+      # superseded by a later correction are excluded. The caller must be authorized for
+      # the employer; an unknown or unauthorized employer returns 404.
+      #
+      # @overload list_payroll_deduction_statements(employer_id, limit: nil, page: nil, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param limit [Integer] Maximum number of statements per page
+      #
+      # @param page [Integer] Page number to retrieve (starts at 1)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::EmployerListPayrollDeductionStatementsResponse>]
+      #
+      # @see VitableConnect::Models::EmployerListPayrollDeductionStatementsParams
+      def list_payroll_deduction_statements(employer_id, params = {})
+        parsed, options = VitableConnect::EmployerListPayrollDeductionStatementsParams.dump_request(params)
+        query = VitableConnect::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/payroll-deduction-statements", employer_id],
+          query: query,
+          page: VitableConnect::Internal::PageNumberPage,
+          model: VitableConnect::Models::EmployerListPayrollDeductionStatementsResponse,
+          options: options
+        )
+      end
+
+      # Returns one benefit plan year in full — its benefit details plus the per-benefit
+      # enrollment rate and SPD link — addressed by its `benefit_plan_year_id`. The
+      # caller must be authorized for the employer; an unknown or unauthorized plan year
+      # returns 404.
+      #
+      # @overload retrieve_benefit_plan_year(benefit_plan_year_id, employer_id:, request_options: {})
+      #
+      # @param benefit_plan_year_id [String] Unique benefit-plan-year identifier (plyr\_\*).
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerRetrieveBenefitPlanYearResponse]
+      #
+      # @see VitableConnect::Models::EmployerRetrieveBenefitPlanYearParams
+      def retrieve_benefit_plan_year(benefit_plan_year_id, params)
+        parsed, options = VitableConnect::EmployerRetrieveBenefitPlanYearParams.dump_request(params)
+        employer_id =
+          parsed.delete(:employer_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/benefit-plan-years/%2$s", employer_id, benefit_plan_year_id],
+          model: VitableConnect::Models::EmployerRetrieveBenefitPlanYearResponse,
+          options: options
+        )
+      end
+
+      # Returns the employer's HRIS connection — provider, status, last sync, and synced
+      # row count — or null when the employer has no integration. The caller must be
+      # authorized for the employer; an unknown or unauthorized employer returns 404.
+      #
+      # @overload retrieve_hris(employer_id, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerRetrieveHRISResponse]
+      #
+      # @see VitableConnect::Models::EmployerRetrieveHRISParams
+      def retrieve_hris(employer_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/hris", employer_id],
+          model: VitableConnect::Models::EmployerRetrieveHRISResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns the time-limited PDF download link for a single invoice belonging to the
+      # employer's billing customer. `invoice_id` is the external Chargebee id (not a
+      # prefixed UUID). The caller must be authorized for the employer; an unknown or
+      # unauthorized employer or invoice returns 404.
+      #
+      # @overload retrieve_invoice_pdf(invoice_id, employer_id:, request_options: {})
+      #
+      # @param invoice_id [String] External Chargebee invoice id (not a prefixed UUID).
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerRetrieveInvoicePdfResponse]
+      #
+      # @see VitableConnect::Models::EmployerRetrieveInvoicePdfParams
+      def retrieve_invoice_pdf(invoice_id, params)
+        parsed, options = VitableConnect::EmployerRetrieveInvoicePdfParams.dump_request(params)
+        employer_id =
+          parsed.delete(:employer_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/invoices/%2$s/pdf", employer_id, invoice_id],
+          model: VitableConnect::Models::EmployerRetrieveInvoicePdfResponse,
+          options: options
+        )
+      end
+
+      # Return whether the employer has submitted payroll access setup.
+      #
+      # @overload retrieve_payroll_access_setup(employer_id, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerRetrievePayrollAccessSetupResponse]
+      #
+      # @see VitableConnect::Models::EmployerRetrievePayrollAccessSetupParams
+      def retrieve_payroll_access_setup(employer_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/employers/%1$s/payroll-access-setup", employer_id],
+          model: VitableConnect::Models::EmployerRetrievePayrollAccessSetupResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Submits a census sync payload for the specified employer. The employees in the
       # payload will be queued for processing. Returns an accepted response with the
       # timestamp of acceptance.
@@ -175,6 +477,78 @@ module VitableConnect
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams} for more
+      # details.
+      #
+      # Submit the employer's payroll access setup answers.
+      #
+      # @overload submit_payroll_access_setup(employer_id, access_method:, all_benefit_eligible_employees_present:, classifications_accurate:, employees_in_payroll_acknowledged:, has_additional_payroll_system:, is_controlled_group:, payroll_data_impacts_eligibility_acknowledged:, additional_access_method: nil, additional_integration_confirmed: nil, additional_login_url: nil, additional_password: nil, additional_phone: nil, additional_username: nil, classification_correction_source: nil, integration_confirmed: nil, login_url: nil, misclassified_employee_names: nil, missing_employee_resolution: nil, password: nil, phone: nil, remaining_employee_action: nil, same_payroll_covers_other_eins: nil, username: nil, request_options: {})
+      #
+      # @param employer_id [String] Unique employer identifier (empr\_\*)
+      #
+      # @param access_method [Symbol, VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams::AccessMethod] - `SELF_SETUP` - SELF_SETUP
+      #
+      # @param all_benefit_eligible_employees_present [Boolean]
+      #
+      # @param classifications_accurate [Boolean]
+      #
+      # @param employees_in_payroll_acknowledged [Boolean]
+      #
+      # @param has_additional_payroll_system [Boolean]
+      #
+      # @param is_controlled_group [Boolean]
+      #
+      # @param payroll_data_impacts_eligibility_acknowledged [Boolean]
+      #
+      # @param additional_access_method [Symbol, VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams::AdditionalAccessMethod, nil] - `SELF_SETUP` - SELF_SETUP
+      #
+      # @param additional_integration_confirmed [Boolean, nil]
+      #
+      # @param additional_login_url [String, nil]
+      #
+      # @param additional_password [String, nil]
+      #
+      # @param additional_phone [String, nil]
+      #
+      # @param additional_username [String, nil]
+      #
+      # @param classification_correction_source [Symbol, VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams::ClassificationCorrectionSource, nil] - `ENTER_NAMES` - ENTER_NAMES
+      #
+      # @param integration_confirmed [Boolean, nil]
+      #
+      # @param login_url [String, nil]
+      #
+      # @param misclassified_employee_names [Array<String>]
+      #
+      # @param missing_employee_resolution [Symbol, VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams::MissingEmployeeResolution, nil] - `EMAIL_CENSUS` - EMAIL_CENSUS
+      #
+      # @param password [String, nil]
+      #
+      # @param phone [String, nil]
+      #
+      # @param remaining_employee_action [Symbol, VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams::RemainingEmployeeAction, nil] - `VITABLE_UPDATE` - VITABLE_UPDATE
+      #
+      # @param same_payroll_covers_other_eins [Boolean, nil]
+      #
+      # @param username [String, nil]
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EmployerSubmitPayrollAccessSetupResponse]
+      #
+      # @see VitableConnect::Models::EmployerSubmitPayrollAccessSetupParams
+      def submit_payroll_access_setup(employer_id, params)
+        parsed, options = VitableConnect::EmployerSubmitPayrollAccessSetupParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["v1/employers/%1$s/payroll-access-setup", employer_id],
+          body: parsed,
+          model: VitableConnect::Models::EmployerSubmitPayrollAccessSetupResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {VitableConnect::Models::EmployerUpdateSettingsParams} for more details.
       #
@@ -185,7 +559,7 @@ module VitableConnect
       #
       # @param employer_id [String] Unique employer identifier (empr\_\*)
       #
-      # @param pay_frequency [Symbol, VitableConnect::Models::EmployerUpdateSettingsParams::PayFrequency] - `weekly` - weekly
+      # @param pay_frequency [Symbol, VitableConnect::Models::EmployerUpdateSettingsParams::PayFrequency] - `weekly` - Weekly
       #
       # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
       #