vitable-connect 0.4.0 → 0.6.0

data/rbi/vitable_connect/models/employer.rbi

@@ -51,14 +51,22 @@ module VitableConnect
       sig { returns(String) }
       attr_accessor :id
 
+      # Primary company-admin contact (email + phone; company admins have no person
+      # name).
+      sig { returns(T.nilable(VitableConnect::Employer::Contact)) }
+      attr_reader :contact
+
+      sig do
+        params(
+          contact: T.nilable(VitableConnect::Employer::Contact::OrHash)
+        ).void
+      end
+      attr_writer :contact
+
       # Employer Identification Number (masked in responses)
       sig { returns(T.nilable(String)) }
       attr_accessor :ein
 
-      # ID of the benefit eligibility policy (epol\_\*), if assigned
-      sig { returns(T.nilable(String)) }
-      attr_accessor :eligibility_policy_id
-
       # ID of the parent organization (org\_\*)
       sig { returns(T.nilable(String)) }
       attr_accessor :organization_id
@@ -69,9 +77,9 @@ module VitableConnect
           id: String,
           active: T::Boolean,
           address: VitableConnect::Employer::Address::OrHash,
+          contact: T.nilable(VitableConnect::Employer::Contact::OrHash),
           created_at: Time,
           ein: T.nilable(String),
-          eligibility_policy_id: T.nilable(String),
           legal_name: String,
           name: String,
           organization_id: T.nilable(String),
@@ -88,12 +96,13 @@ module VitableConnect
         active:,
         # Nested address within EmployerSerializer.
         address:,
+        # Primary company-admin contact (email + phone; company admins have no person
+        # name).
+        contact:,
         # Timestamp when the employer was created
         created_at:,
         # Employer Identification Number (masked in responses)
         ein:,
-        # ID of the benefit eligibility policy (epol\_\*), if assigned
-        eligibility_policy_id:,
         # Legal business name for compliance and tax purposes
         legal_name:,
         # Display name of the employer
@@ -117,9 +126,9 @@ module VitableConnect
             id: String,
             active: T::Boolean,
             address: VitableConnect::Employer::Address,
+            contact: T.nilable(VitableConnect::Employer::Contact),
             created_at: Time,
             ein: T.nilable(String),
-            eligibility_policy_id: T.nilable(String),
             legal_name: String,
             name: String,
             organization_id: T.nilable(String),
@@ -200,6 +209,47 @@ module VitableConnect
         def to_hash
         end
       end
+
+      class Contact < VitableConnect::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              VitableConnect::Employer::Contact,
+              VitableConnect::Internal::AnyHash
+            )
+          end
+
+        # Primary contact email
+        sig { returns(T.nilable(String)) }
+        attr_accessor :email
+
+        # Primary contact phone, or null
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone
+
+        # Primary company-admin contact (email + phone; company admins have no person
+        # name).
+        sig do
+          params(email: T.nilable(String), phone: T.nilable(String)).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Primary contact email
+          email:,
+          # Primary contact phone, or null
+          phone:
+        )
+        end
+
+        sig do
+          override.returns(
+            { email: T.nilable(String), phone: T.nilable(String) }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/vitable_connect/models/employer_ensure_payroll_integration_email_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module VitableConnect
+  module Models
+    class EmployerEnsurePayrollIntegrationEmailParams < VitableConnect::Internal::Type::BaseModel
+      extend VitableConnect::Internal::Type::RequestParameters::Converter
+      include VitableConnect::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            VitableConnect::EmployerEnsurePayrollIntegrationEmailParams,
+            VitableConnect::Internal::AnyHash
+          )
+        end
+
+      # Unique employer identifier (empr\_\*)
+      sig { returns(String) }
+      attr_accessor :employer_id
+
+      sig do
+        params(
+          employer_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique employer identifier (empr\_\*)
+        employer_id:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            employer_id: String,
+            request_options: VitableConnect::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/vitable_connect/models/employer_ensure_payroll_integration_email_response.rbi

@@ -0,0 +1,72 @@
+# typed: strong
+
+module VitableConnect
+  module Models
+    class EmployerEnsurePayrollIntegrationEmailResponse < VitableConnect::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse,
+            VitableConnect::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(
+          VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse::Data
+        )
+      end
+      attr_reader :data
+
+      sig do
+        params(
+          data:
+            VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse::Data::OrHash
+        ).void
+      end
+      attr_writer :data
+
+      # Response containing a single payroll integration email resource.
+      sig do
+        params(
+          data:
+            VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse::Data::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(data:)
+      end
+
+      sig do
+        override.returns(
+          {
+            data:
+              VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse::Data
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < VitableConnect::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              VitableConnect::Models::EmployerEnsurePayrollIntegrationEmailResponse::Data,
+              VitableConnect::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :integration_email
+
+        sig { params(integration_email: String).returns(T.attached_class) }
+        def self.new(integration_email:)
+        end
+
+        sig { override.returns({ integration_email: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/vitable_connect/models/employer_list_benefit_plan_year_enrollments_params.rbi

@@ -0,0 +1,165 @@
+# typed: strong
+
+module VitableConnect
+  module Models
+    class EmployerListBenefitPlanYearEnrollmentsParams < VitableConnect::Internal::Type::BaseModel
+      extend VitableConnect::Internal::Type::RequestParameters::Converter
+      include VitableConnect::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams,
+            VitableConnect::Internal::AnyHash
+          )
+        end
+
+      # Unique employer identifier (empr\_\*)
+      sig { returns(String) }
+      attr_accessor :employer_id
+
+      # Unique benefit-plan-year identifier (plyr\_\*).
+      sig { returns(String) }
+      attr_accessor :benefit_plan_year_id
+
+      # Filter by election status. Repeat the parameter to match several.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::OrSymbol
+            ]
+          )
+        )
+      end
+      attr_reader :election_status
+
+      sig do
+        params(
+          election_status:
+            T::Array[
+              VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::OrSymbol
+            ]
+        ).void
+      end
+      attr_writer :election_status
+
+      # Items per page (default: 20, max: 100)
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # Page number (default: 1)
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page
+
+      sig { params(page: Integer).void }
+      attr_writer :page
+
+      # Case-insensitive search. Matches member name partially, and the `member_id`
+      # exactly — either your own reference id or the prefixed `grpmbr_<...>` id.
+      sig { returns(T.nilable(String)) }
+      attr_reader :search
+
+      sig { params(search: String).void }
+      attr_writer :search
+
+      sig do
+        params(
+          employer_id: String,
+          benefit_plan_year_id: String,
+          election_status:
+            T::Array[
+              VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::OrSymbol
+            ],
+          limit: Integer,
+          page: Integer,
+          search: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique employer identifier (empr\_\*)
+        employer_id:,
+        # Unique benefit-plan-year identifier (plyr\_\*).
+        benefit_plan_year_id:,
+        # Filter by election status. Repeat the parameter to match several.
+        election_status: nil,
+        # Items per page (default: 20, max: 100)
+        limit: nil,
+        # Page number (default: 1)
+        page: nil,
+        # Case-insensitive search. Matches member name partially, and the `member_id`
+        # exactly — either your own reference id or the prefixed `grpmbr_<...>` id.
+        search: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            employer_id: String,
+            benefit_plan_year_id: String,
+            election_status:
+              T::Array[
+                VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::OrSymbol
+              ],
+            limit: Integer,
+            page: Integer,
+            search: String,
+            request_options: VitableConnect::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module ElectionStatus
+        extend VitableConnect::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENROLLED =
+          T.let(
+            :Enrolled,
+            VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::TaggedSymbol
+          )
+        EXPIRED =
+          T.let(
+            :Expired,
+            VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::TaggedSymbol
+          )
+        PENDING =
+          T.let(
+            :Pending,
+            VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::TaggedSymbol
+          )
+        WAIVED =
+          T.let(
+            :Waived,
+            VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              VitableConnect::EmployerListBenefitPlanYearEnrollmentsParams::ElectionStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/vitable_connect/models/employer_list_benefit_plan_year_enrollments_response.rbi

@@ -0,0 +1,278 @@
+# typed: strong
+
+module VitableConnect
+  module Models
+    class EmployerListBenefitPlanYearEnrollmentsResponse < VitableConnect::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse,
+            VitableConnect::Internal::AnyHash
+          )
+        end
+
+      # The carrier for this enrollment: the individual-market carrier for an ICHRA
+      # plan, otherwise the benefit's own. Null when the benefit has no carrier.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :carrier
+
+      # Dependents covered under this enrollment today. Counts the same dependents
+      # `premium_in_cents` is priced for, so a dependent whose termination is dated in
+      # the future still counts.
+      sig { returns(Integer) }
+      attr_accessor :dependent_count
+
+      # - `Enrolled` - Enrolled
+      # - `Waived` - Waived
+      # - `Pending` - Pending
+      # - `Expired` - Expired
+      sig do
+        returns(
+          VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+        )
+      end
+      attr_accessor :election_status
+
+      # What the employee is deducted monthly, in cents: `premium_in_cents` less
+      # `employer_contribution_in_cents`, floored at zero. Null when unanswered/waived.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :employee_deduction_in_cents
+
+      # Your own reference id for this employee, as you supplied it. Null when you have
+      # not set one.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :employee_external_reference_id
+
+      # Our id for this person's employment with this employer (`empl_<...>`). A person
+      # who leaves and is rehired has two.
+      sig { returns(String) }
+      attr_accessor :employee_id
+
+      # The employer's monthly share of `premium_in_cents`, in cents. Null when
+      # unanswered/waived.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :employer_contribution_in_cents
+
+      # The member's first name.
+      sig { returns(String) }
+      attr_accessor :member_first_name
+
+      # Our id for the person (`mbr_<...>`). Stable across every employer they work for.
+      sig { returns(String) }
+      attr_accessor :member_id
+
+      # The member's last name.
+      sig { returns(String) }
+      attr_accessor :member_last_name
+
+      # Chosen plan name, or null when unanswered/waived.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :plan
+
+      # - `Coverage Upcoming` - Coverage Upcoming
+      # - `Coverage Effective` - Coverage Effective
+      # - `Coverage Ended` - Coverage Ended
+      sig do
+        returns(
+          T.nilable(
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :policy_status
+
+      # Monthly premium in cents for the chosen plan, dependents included. The plan's
+      # own cost, not the employer's share of it. Null when unanswered/waived.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :premium_in_cents
+
+      # Chosen coverage tier, or null when unanswered/waived.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :tier
+
+      sig do
+        params(
+          carrier: T.nilable(String),
+          dependent_count: Integer,
+          election_status:
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::OrSymbol,
+          employee_deduction_in_cents: T.nilable(Integer),
+          employee_external_reference_id: T.nilable(String),
+          employee_id: String,
+          employer_contribution_in_cents: T.nilable(Integer),
+          member_first_name: String,
+          member_id: String,
+          member_last_name: String,
+          plan: T.nilable(String),
+          policy_status:
+            T.nilable(
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::OrSymbol
+            ),
+          premium_in_cents: T.nilable(Integer),
+          tier: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The carrier for this enrollment: the individual-market carrier for an ICHRA
+        # plan, otherwise the benefit's own. Null when the benefit has no carrier.
+        carrier:,
+        # Dependents covered under this enrollment today. Counts the same dependents
+        # `premium_in_cents` is priced for, so a dependent whose termination is dated in
+        # the future still counts.
+        dependent_count:,
+        # - `Enrolled` - Enrolled
+        # - `Waived` - Waived
+        # - `Pending` - Pending
+        # - `Expired` - Expired
+        election_status:,
+        # What the employee is deducted monthly, in cents: `premium_in_cents` less
+        # `employer_contribution_in_cents`, floored at zero. Null when unanswered/waived.
+        employee_deduction_in_cents:,
+        # Your own reference id for this employee, as you supplied it. Null when you have
+        # not set one.
+        employee_external_reference_id:,
+        # Our id for this person's employment with this employer (`empl_<...>`). A person
+        # who leaves and is rehired has two.
+        employee_id:,
+        # The employer's monthly share of `premium_in_cents`, in cents. Null when
+        # unanswered/waived.
+        employer_contribution_in_cents:,
+        # The member's first name.
+        member_first_name:,
+        # Our id for the person (`mbr_<...>`). Stable across every employer they work for.
+        member_id:,
+        # The member's last name.
+        member_last_name:,
+        # Chosen plan name, or null when unanswered/waived.
+        plan:,
+        # - `Coverage Upcoming` - Coverage Upcoming
+        # - `Coverage Effective` - Coverage Effective
+        # - `Coverage Ended` - Coverage Ended
+        policy_status:,
+        # Monthly premium in cents for the chosen plan, dependents included. The plan's
+        # own cost, not the employer's share of it. Null when unanswered/waived.
+        premium_in_cents:,
+        # Chosen coverage tier, or null when unanswered/waived.
+        tier:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            carrier: T.nilable(String),
+            dependent_count: Integer,
+            election_status:
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol,
+            employee_deduction_in_cents: T.nilable(Integer),
+            employee_external_reference_id: T.nilable(String),
+            employee_id: String,
+            employer_contribution_in_cents: T.nilable(Integer),
+            member_first_name: String,
+            member_id: String,
+            member_last_name: String,
+            plan: T.nilable(String),
+            policy_status:
+              T.nilable(
+                VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+              ),
+            premium_in_cents: T.nilable(Integer),
+            tier: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # - `Enrolled` - Enrolled
+      # - `Waived` - Waived
+      # - `Pending` - Pending
+      # - `Expired` - Expired
+      module ElectionStatus
+        extend VitableConnect::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENROLLED =
+          T.let(
+            :Enrolled,
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+          )
+        WAIVED =
+          T.let(
+            :Waived,
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+          )
+        PENDING =
+          T.let(
+            :Pending,
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+          )
+        EXPIRED =
+          T.let(
+            :Expired,
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::ElectionStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # - `Coverage Upcoming` - Coverage Upcoming
+      # - `Coverage Effective` - Coverage Effective
+      # - `Coverage Ended` - Coverage Ended
+      module PolicyStatus
+        extend VitableConnect::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        COVERAGE_UPCOMING =
+          T.let(
+            :"Coverage Upcoming",
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+          )
+        COVERAGE_EFFECTIVE =
+          T.let(
+            :"Coverage Effective",
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+          )
+        COVERAGE_ENDED =
+          T.let(
+            :"Coverage Ended",
+            VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              VitableConnect::Models::EmployerListBenefitPlanYearEnrollmentsResponse::PolicyStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end