vitable-connect 0.5.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. checksums.yaml +4 -4
  2. data/.fern/metadata.json +16 -0
  3. data/.fernignore +7 -0
  4. data/.rubocop.yml +110 -0
  5. data/CONTRIBUTING.md +120 -0
  6. data/LICENSE +201 -0
  7. data/README.md +170 -123
  8. data/Rakefile +20 -0
  9. data/custom.gemspec.rb +16 -0
  10. data/lib/VitableConnect/auth/client.rb +52 -0
  11. data/lib/VitableConnect/auth/types/issue_access_token_request.rb +13 -0
  12. data/lib/VitableConnect/client.rb +67 -0
  13. data/lib/VitableConnect/employees/client.rb +161 -0
  14. data/lib/VitableConnect/employees/types/get_employees_request.rb +11 -0
  15. data/lib/VitableConnect/employees/types/list_enrollments_employees_request.rb +15 -0
  16. data/lib/VitableConnect/employees/types/patched_update_employee_request.rb +27 -0
  17. data/lib/VitableConnect/employers/client.rb +904 -0
  18. data/lib/VitableConnect/employers/types/census_sync_request.rb +13 -0
  19. data/lib/VitableConnect/employers/types/create_employer_request.rb +23 -0
  20. data/lib/VitableConnect/employers/types/ensure_payroll_integration_email_employers_request.rb +11 -0
  21. data/lib/VitableConnect/employers/types/get_benefit_plan_year_employers_request.rb +13 -0
  22. data/lib/VitableConnect/employers/types/get_employers_request.rb +11 -0
  23. data/lib/VitableConnect/employers/types/get_hris_employers_request.rb +11 -0
  24. data/lib/VitableConnect/employers/types/get_invoice_pdf_employers_request.rb +13 -0
  25. data/lib/VitableConnect/employers/types/get_payroll_access_setup_employers_request.rb +11 -0
  26. data/lib/VitableConnect/employers/types/list_benefit_plan_year_enrollments_employers_request.rb +21 -0
  27. data/lib/VitableConnect/employers/types/list_benefit_plan_years_employers_request.rb +11 -0
  28. data/lib/VitableConnect/employers/types/list_employees_employers_request.rb +19 -0
  29. data/lib/VitableConnect/employers/types/list_employers_request.rb +25 -0
  30. data/lib/VitableConnect/employers/types/list_invoices_employers_request.rb +15 -0
  31. data/lib/VitableConnect/employers/types/list_payroll_deduction_statements_employers_request.rb +15 -0
  32. data/lib/VitableConnect/employers/types/submit_payroll_access_setup_request.rb +57 -0
  33. data/lib/VitableConnect/employers/types/update_employer_request.rb +19 -0
  34. data/lib/VitableConnect/employers/types/update_employer_settings_request.rb +13 -0
  35. data/lib/VitableConnect/enrollments/client.rb +152 -0
  36. data/lib/VitableConnect/enrollments/types/get_enrollments_request.rb +11 -0
  37. data/lib/VitableConnect/enrollments/types/reissue_enrollment_request.rb +17 -0
  38. data/lib/VitableConnect/enrollments/types/terminate_enrollment_request.rb +17 -0
  39. data/lib/VitableConnect/environment.rb +9 -0
  40. data/lib/VitableConnect/errors/api_error.rb +8 -0
  41. data/lib/VitableConnect/errors/client_error.rb +17 -0
  42. data/lib/VitableConnect/errors/redirect_error.rb +8 -0
  43. data/lib/VitableConnect/errors/response_error.rb +42 -0
  44. data/lib/VitableConnect/errors/server_error.rb +11 -0
  45. data/lib/VitableConnect/errors/timeout_error.rb +8 -0
  46. data/lib/VitableConnect/groups/client.rb +199 -0
  47. data/lib/VitableConnect/groups/members/client.rb +21 -0
  48. data/lib/VitableConnect/groups/members/sync/client.rb +122 -0
  49. data/lib/VitableConnect/groups/members/sync/types/get_sync_request.rb +17 -0
  50. data/lib/VitableConnect/groups/members/sync/types/group_member_sync_request.rb +17 -0
  51. data/lib/VitableConnect/groups/types/create_group_request.rb +13 -0
  52. data/lib/VitableConnect/groups/types/get_groups_request.rb +11 -0
  53. data/lib/VitableConnect/groups/types/list_groups_request.rb +13 -0
  54. data/lib/VitableConnect/groups/types/patched_update_group_request.rb +15 -0
  55. data/lib/VitableConnect/internal/errors/constraint_error.rb +10 -0
  56. data/lib/VitableConnect/internal/errors/type_error.rb +10 -0
  57. data/lib/VitableConnect/internal/http/base_request.rb +51 -0
  58. data/lib/VitableConnect/internal/http/raw_client.rb +265 -0
  59. data/lib/VitableConnect/internal/iterators/cursor_item_iterator.rb +28 -0
  60. data/lib/VitableConnect/internal/iterators/cursor_page_iterator.rb +63 -0
  61. data/lib/VitableConnect/internal/iterators/item_iterator.rb +65 -0
  62. data/lib/VitableConnect/internal/iterators/offset_item_iterator.rb +30 -0
  63. data/lib/VitableConnect/internal/iterators/offset_page_iterator.rb +103 -0
  64. data/lib/VitableConnect/internal/json/request.rb +41 -0
  65. data/lib/VitableConnect/internal/json/serializable.rb +25 -0
  66. data/lib/VitableConnect/internal/multipart/multipart_encoder.rb +141 -0
  67. data/lib/VitableConnect/internal/multipart/multipart_form_data.rb +78 -0
  68. data/lib/VitableConnect/internal/multipart/multipart_form_data_part.rb +51 -0
  69. data/lib/VitableConnect/internal/multipart/multipart_request.rb +40 -0
  70. data/lib/VitableConnect/internal/types/array.rb +47 -0
  71. data/lib/VitableConnect/internal/types/boolean.rb +34 -0
  72. data/lib/VitableConnect/internal/types/enum.rb +56 -0
  73. data/lib/VitableConnect/internal/types/hash.rb +36 -0
  74. data/lib/VitableConnect/internal/types/model/field.rb +38 -0
  75. data/lib/VitableConnect/internal/types/model.rb +208 -0
  76. data/lib/VitableConnect/internal/types/type.rb +35 -0
  77. data/lib/VitableConnect/internal/types/union.rb +161 -0
  78. data/lib/VitableConnect/internal/types/unknown.rb +15 -0
  79. data/lib/VitableConnect/internal/types/utils.rb +116 -0
  80. data/lib/VitableConnect/members/client.rb +385 -0
  81. data/lib/VitableConnect/members/types/get_household_members_request.rb +11 -0
  82. data/lib/VitableConnect/members/types/get_members_request.rb +11 -0
  83. data/lib/VitableConnect/members/types/list_dependents_members_request.rb +11 -0
  84. data/lib/VitableConnect/members/types/list_employments_members_request.rb +11 -0
  85. data/lib/VitableConnect/members/types/list_enrollments_members_request.rb +11 -0
  86. data/lib/VitableConnect/members/types/list_id_cards_members_request.rb +11 -0
  87. data/lib/VitableConnect/members/types/list_members_request.rb +15 -0
  88. data/lib/VitableConnect/members/types/list_qualifying_life_events_members_request.rb +17 -0
  89. data/lib/VitableConnect/organizations/client.rb +92 -0
  90. data/lib/VitableConnect/organizations/types/create_organization_request.rb +13 -0
  91. data/lib/VitableConnect/plans/client.rb +69 -0
  92. data/lib/VitableConnect/plans/types/list_plans_request.rb +13 -0
  93. data/lib/VitableConnect/types/access_method.rb +12 -0
  94. data/lib/VitableConnect/types/access_token_response.rb +15 -0
  95. data/lib/VitableConnect/types/additional_access_method.rb +12 -0
  96. data/lib/VitableConnect/types/address.rb +22 -0
  97. data/lib/VitableConnect/types/address_request.rb +17 -0
  98. data/lib/VitableConnect/types/benefit_family.rb +16 -0
  99. data/lib/VitableConnect/types/benefit_family_param_item.rb +16 -0
  100. data/lib/VitableConnect/types/benefit_lifecycle_stage_item.rb +15 -0
  101. data/lib/VitableConnect/types/benefit_plan_network.rb +29 -0
  102. data/lib/VitableConnect/types/benefit_plan_year_detail.rb +52 -0
  103. data/lib/VitableConnect/types/benefit_plan_year_id.rb +23 -0
  104. data/lib/VitableConnect/types/benefit_plan_year_list.rb +47 -0
  105. data/lib/VitableConnect/types/benefit_status.rb +14 -0
  106. data/lib/VitableConnect/types/benefit_summary.rb +15 -0
  107. data/lib/VitableConnect/types/bound_entity.rb +11 -0
  108. data/lib/VitableConnect/types/bound_entity_response.rb +11 -0
  109. data/lib/VitableConnect/types/bound_entity_type.rb +12 -0
  110. data/lib/VitableConnect/types/card_type.rb +14 -0
  111. data/lib/VitableConnect/types/category.rb +14 -0
  112. data/lib/VitableConnect/types/census_sync_detail_response.rb +10 -0
  113. data/lib/VitableConnect/types/census_sync_employee_address_request.rb +17 -0
  114. data/lib/VitableConnect/types/census_sync_employee_request.rb +27 -0
  115. data/lib/VitableConnect/types/census_sync_response.rb +11 -0
  116. data/lib/VitableConnect/types/classification_correction_source.rb +12 -0
  117. data/lib/VitableConnect/types/compensation_type.rb +12 -0
  118. data/lib/VitableConnect/types/contribution_class_compensation.rb +13 -0
  119. data/lib/VitableConnect/types/contribution_class_employment.rb +15 -0
  120. data/lib/VitableConnect/types/contribution_class_location.rb +12 -0
  121. data/lib/VitableConnect/types/contribution_range.rb +11 -0
  122. data/lib/VitableConnect/types/contribution_strategy.rb +13 -0
  123. data/lib/VitableConnect/types/contribution_tier.rb +26 -0
  124. data/lib/VitableConnect/types/coverage_tier.rb +15 -0
  125. data/lib/VitableConnect/types/create_organization_request_type.rb +16 -0
  126. data/lib/VitableConnect/types/created_after.rb +23 -0
  127. data/lib/VitableConnect/types/created_before.rb +23 -0
  128. data/lib/VitableConnect/types/deduction_detail.rb +21 -0
  129. data/lib/VitableConnect/types/deduction_frequency.rb +14 -0
  130. data/lib/VitableConnect/types/digital_benefit_card.rb +36 -0
  131. data/lib/VitableConnect/types/election_status_item.rb +14 -0
  132. data/lib/VitableConnect/types/eligibility_policy.rb +17 -0
  133. data/lib/VitableConnect/types/eligibility_policy_rule.rb +15 -0
  134. data/lib/VitableConnect/types/eligibility_rule_compensation_type.rb +13 -0
  135. data/lib/VitableConnect/types/eligibility_rule_employee_class.rb +17 -0
  136. data/lib/VitableConnect/types/eligible_geographical_location.rb +11 -0
  137. data/lib/VitableConnect/types/eligible_geographical_location_type.rb +12 -0
  138. data/lib/VitableConnect/types/employee.rb +53 -0
  139. data/lib/VitableConnect/types/employee_address.rb +17 -0
  140. data/lib/VitableConnect/types/employee_address_input.rb +19 -0
  141. data/lib/VitableConnect/types/employee_class.rb +16 -0
  142. data/lib/VitableConnect/types/employee_id.rb +23 -0
  143. data/lib/VitableConnect/types/employee_list_response.rb +12 -0
  144. data/lib/VitableConnect/types/employee_response.rb +10 -0
  145. data/lib/VitableConnect/types/employee_search.rb +23 -0
  146. data/lib/VitableConnect/types/employee_status.rb +12 -0
  147. data/lib/VitableConnect/types/employer.rb +34 -0
  148. data/lib/VitableConnect/types/employer_address.rb +18 -0
  149. data/lib/VitableConnect/types/employer_address_input.rb +17 -0
  150. data/lib/VitableConnect/types/employer_benefit_lifecycle_stage.rb +11 -0
  151. data/lib/VitableConnect/types/employer_benefit_plan_year_response.rb +10 -0
  152. data/lib/VitableConnect/types/employer_benefit_plan_years_list_response.rb +9 -0
  153. data/lib/VitableConnect/types/employer_contact.rb +12 -0
  154. data/lib/VitableConnect/types/employer_hris.rb +9 -0
  155. data/lib/VitableConnect/types/employer_hris_response.rb +10 -0
  156. data/lib/VitableConnect/types/employer_hris_status.rb +13 -0
  157. data/lib/VitableConnect/types/employer_id.rb +23 -0
  158. data/lib/VitableConnect/types/employer_invoice_pdf.rb +9 -0
  159. data/lib/VitableConnect/types/employer_invoice_pdf_response.rb +10 -0
  160. data/lib/VitableConnect/types/employer_invoices_list_response.rb +12 -0
  161. data/lib/VitableConnect/types/employer_payroll_deduction_statement_list_response.rb +12 -0
  162. data/lib/VitableConnect/types/employer_response.rb +10 -0
  163. data/lib/VitableConnect/types/employer_search.rb +23 -0
  164. data/lib/VitableConnect/types/employer_settings.rb +9 -0
  165. data/lib/VitableConnect/types/employer_settings_response.rb +10 -0
  166. data/lib/VitableConnect/types/enrollment.rb +34 -0
  167. data/lib/VitableConnect/types/enrollment_detail.rb +39 -0
  168. data/lib/VitableConnect/types/enrollment_id.rb +23 -0
  169. data/lib/VitableConnect/types/enrollment_list_response.rb +12 -0
  170. data/lib/VitableConnect/types/enrollment_rate.rb +13 -0
  171. data/lib/VitableConnect/types/enrollment_rate_summary.rb +13 -0
  172. data/lib/VitableConnect/types/enrollment_response.rb +10 -0
  173. data/lib/VitableConnect/types/enrollment_status.rb +14 -0
  174. data/lib/VitableConnect/types/error_response.rb +17 -0
  175. data/lib/VitableConnect/types/event_id.rb +23 -0
  176. data/lib/VitableConnect/types/event_name.rb +21 -0
  177. data/lib/VitableConnect/types/gender.rb +15 -0
  178. data/lib/VitableConnect/types/grant_type.rb +11 -0
  179. data/lib/VitableConnect/types/group.rb +19 -0
  180. data/lib/VitableConnect/types/group_id.rb +23 -0
  181. data/lib/VitableConnect/types/group_list_response.rb +12 -0
  182. data/lib/VitableConnect/types/group_member_sync_detail_response.rb +10 -0
  183. data/lib/VitableConnect/types/group_member_sync_failure.rb +13 -0
  184. data/lib/VitableConnect/types/group_member_sync_member_request.rb +23 -0
  185. data/lib/VitableConnect/types/group_member_sync_request_detail.rb +17 -0
  186. data/lib/VitableConnect/types/group_member_sync_request_detail_response.rb +10 -0
  187. data/lib/VitableConnect/types/group_member_sync_response.rb +13 -0
  188. data/lib/VitableConnect/types/group_member_sync_results.rb +13 -0
  189. data/lib/VitableConnect/types/group_response.rb +10 -0
  190. data/lib/VitableConnect/types/household_member.rb +22 -0
  191. data/lib/VitableConnect/types/household_member_relationship.rb +14 -0
  192. data/lib/VitableConnect/types/household_member_type.rb +13 -0
  193. data/lib/VitableConnect/types/household_members_response.rb +10 -0
  194. data/lib/VitableConnect/types/hris_connection.rb +17 -0
  195. data/lib/VitableConnect/types/hris_status_item.rb +15 -0
  196. data/lib/VitableConnect/types/ichra_contribution_class.rb +29 -0
  197. data/lib/VitableConnect/types/idp_provider.rb +12 -0
  198. data/lib/VitableConnect/types/include_cancelled.rb +23 -0
  199. data/lib/VitableConnect/types/invoice.rb +15 -0
  200. data/lib/VitableConnect/types/invoice_id.rb +23 -0
  201. data/lib/VitableConnect/types/invoices_cursor_pagination.rb +9 -0
  202. data/lib/VitableConnect/types/limit.rb +23 -0
  203. data/lib/VitableConnect/types/list_webhook_event_deliveries_response.rb +9 -0
  204. data/lib/VitableConnect/types/marital_status.rb +12 -0
  205. data/lib/VitableConnect/types/member.rb +42 -0
  206. data/lib/VitableConnect/types/member_address.rb +17 -0
  207. data/lib/VitableConnect/types/member_dependents_response.rb +10 -0
  208. data/lib/VitableConnect/types/member_digital_benefit_cards_response.rb +10 -0
  209. data/lib/VitableConnect/types/member_employments_response.rb +10 -0
  210. data/lib/VitableConnect/types/member_enrollment.rb +58 -0
  211. data/lib/VitableConnect/types/member_enrollments_response.rb +10 -0
  212. data/lib/VitableConnect/types/member_id.rb +23 -0
  213. data/lib/VitableConnect/types/member_legal_dependent.rb +24 -0
  214. data/lib/VitableConnect/types/member_list_item.rb +20 -0
  215. data/lib/VitableConnect/types/member_list_response.rb +12 -0
  216. data/lib/VitableConnect/types/member_qualifying_life_event.rb +19 -0
  217. data/lib/VitableConnect/types/member_qualifying_life_event_list_response.rb +12 -0
  218. data/lib/VitableConnect/types/member_response.rb +10 -0
  219. data/lib/VitableConnect/types/member_search.rb +23 -0
  220. data/lib/VitableConnect/types/member_status.rb +12 -0
  221. data/lib/VitableConnect/types/missing_employee_resolution.rb +12 -0
  222. data/lib/VitableConnect/types/name_suffix.rb +17 -0
  223. data/lib/VitableConnect/types/offset.rb +23 -0
  224. data/lib/VitableConnect/types/operation.rb +12 -0
  225. data/lib/VitableConnect/types/organization.rb +19 -0
  226. data/lib/VitableConnect/types/organization_employer.rb +44 -0
  227. data/lib/VitableConnect/types/organization_employer_list_response.rb +12 -0
  228. data/lib/VitableConnect/types/organization_hris_provider.rb +11 -0
  229. data/lib/VitableConnect/types/organization_hris_providers_response.rb +10 -0
  230. data/lib/VitableConnect/types/organization_type.rb +16 -0
  231. data/lib/VitableConnect/types/organizations_list_response.rb +12 -0
  232. data/lib/VitableConnect/types/page.rb +23 -0
  233. data/lib/VitableConnect/types/pagination.rb +16 -0
  234. data/lib/VitableConnect/types/payroll_access_setup_status.rb +11 -0
  235. data/lib/VitableConnect/types/payroll_access_setup_status_response.rb +10 -0
  236. data/lib/VitableConnect/types/payroll_deduction_statement.rb +29 -0
  237. data/lib/VitableConnect/types/payroll_integration_email.rb +9 -0
  238. data/lib/VitableConnect/types/payroll_integration_email_response.rb +10 -0
  239. data/lib/VitableConnect/types/plan.rb +11 -0
  240. data/lib/VitableConnect/types/plan_list_response.rb +12 -0
  241. data/lib/VitableConnect/types/plan_year_enrollment.rb +35 -0
  242. data/lib/VitableConnect/types/plan_year_enrollment_election_status.rb +14 -0
  243. data/lib/VitableConnect/types/plan_year_enrollment_list_response.rb +12 -0
  244. data/lib/VitableConnect/types/plan_year_enrollment_policy_status.rb +14 -0
  245. data/lib/VitableConnect/types/preferred_language.rb +16 -0
  246. data/lib/VitableConnect/types/product_code.rb +25 -0
  247. data/lib/VitableConnect/types/qualifying_life_event_status.rb +13 -0
  248. data/lib/VitableConnect/types/qualifying_life_event_type.rb +31 -0
  249. data/lib/VitableConnect/types/reissue_enrollment.rb +9 -0
  250. data/lib/VitableConnect/types/reissue_enrollment_response.rb +10 -0
  251. data/lib/VitableConnect/types/relationship.rb +12 -0
  252. data/lib/VitableConnect/types/remaining_employee_action.rb +12 -0
  253. data/lib/VitableConnect/types/request_id.rb +23 -0
  254. data/lib/VitableConnect/types/resource_id.rb +23 -0
  255. data/lib/VitableConnect/types/resource_type.rb +16 -0
  256. data/lib/VitableConnect/types/search.rb +23 -0
  257. data/lib/VitableConnect/types/sex_at_birth.rb +14 -0
  258. data/lib/VitableConnect/types/state.rb +72 -0
  259. data/lib/VitableConnect/types/status.rb +13 -0
  260. data/lib/VitableConnect/types/tax_classification.rb +13 -0
  261. data/lib/VitableConnect/types/termination_rule.rb +12 -0
  262. data/lib/VitableConnect/types/update_employer_address_input.rb +17 -0
  263. data/lib/VitableConnect/types/waiting_period.rb +13 -0
  264. data/lib/VitableConnect/types/webhook_delivery.rb +25 -0
  265. data/lib/VitableConnect/types/webhook_event.rb +19 -0
  266. data/lib/VitableConnect/types/webhook_event_list_response.rb +12 -0
  267. data/lib/VitableConnect/types/webhook_event_response.rb +10 -0
  268. data/lib/{vitable_connect → VitableConnect}/version.rb +1 -1
  269. data/lib/VitableConnect/webhook_events/client.rb +156 -0
  270. data/lib/VitableConnect/webhook_events/types/get_webhook_events_request.rb +11 -0
  271. data/lib/VitableConnect/webhook_events/types/list_deliveries_webhook_events_request.rb +11 -0
  272. data/lib/VitableConnect/webhook_events/types/list_webhook_events_request.rb +23 -0
  273. data/lib/VitableConnect.rb +268 -0
  274. data/lib/vitable_connect.rb +4 -105
  275. data/reference.md +3722 -0
  276. metadata +286 -266
  277. data/.ignore +0 -2
  278. data/CHANGELOG.md +0 -133
  279. data/lib/vitable_connect/client.rb +0 -139
  280. data/lib/vitable_connect/errors.rb +0 -228
  281. data/lib/vitable_connect/file_part.rb +0 -58
  282. data/lib/vitable_connect/internal/page_number_page.rb +0 -113
  283. data/lib/vitable_connect/internal/transport/base_client.rb +0 -582
  284. data/lib/vitable_connect/internal/transport/pooled_net_requester.rb +0 -210
  285. data/lib/vitable_connect/internal/type/array_of.rb +0 -168
  286. data/lib/vitable_connect/internal/type/base_model.rb +0 -534
  287. data/lib/vitable_connect/internal/type/base_page.rb +0 -55
  288. data/lib/vitable_connect/internal/type/boolean.rb +0 -77
  289. data/lib/vitable_connect/internal/type/converter.rb +0 -327
  290. data/lib/vitable_connect/internal/type/enum.rb +0 -152
  291. data/lib/vitable_connect/internal/type/file_input.rb +0 -111
  292. data/lib/vitable_connect/internal/type/hash_of.rb +0 -188
  293. data/lib/vitable_connect/internal/type/request_parameters.rb +0 -42
  294. data/lib/vitable_connect/internal/type/union.rb +0 -245
  295. data/lib/vitable_connect/internal/type/unknown.rb +0 -81
  296. data/lib/vitable_connect/internal/util.rb +0 -966
  297. data/lib/vitable_connect/internal.rb +0 -20
  298. data/lib/vitable_connect/models/auth_issue_access_token_params.rb +0 -68
  299. data/lib/vitable_connect/models/auth_issue_access_token_response.rb +0 -70
  300. data/lib/vitable_connect/models/employee.rb +0 -310
  301. data/lib/vitable_connect/models/employee_class.rb +0 -25
  302. data/lib/vitable_connect/models/employee_list_enrollments_params.rb +0 -38
  303. data/lib/vitable_connect/models/employee_retrieve_params.rb +0 -22
  304. data/lib/vitable_connect/models/employee_retrieve_response.rb +0 -18
  305. data/lib/vitable_connect/models/employer.rb +0 -155
  306. data/lib/vitable_connect/models/employer_create_params.rb +0 -115
  307. data/lib/vitable_connect/models/employer_list_employees_params.rb +0 -38
  308. data/lib/vitable_connect/models/employer_list_params.rb +0 -30
  309. data/lib/vitable_connect/models/employer_response.rb +0 -19
  310. data/lib/vitable_connect/models/employer_retrieve_params.rb +0 -22
  311. data/lib/vitable_connect/models/employer_submit_census_sync_params.rb +0 -374
  312. data/lib/vitable_connect/models/employer_submit_census_sync_response.rb +0 -35
  313. data/lib/vitable_connect/models/employer_update_settings_params.rb +0 -52
  314. data/lib/vitable_connect/models/employer_update_settings_response.rb +0 -56
  315. data/lib/vitable_connect/models/enrollment.rb +0 -234
  316. data/lib/vitable_connect/models/enrollment_retrieve_params.rb +0 -22
  317. data/lib/vitable_connect/models/enrollment_retrieve_response.rb +0 -18
  318. data/lib/vitable_connect/models/enrollment_status.rb +0 -21
  319. data/lib/vitable_connect/models/group.rb +0 -57
  320. data/lib/vitable_connect/models/group_create_params.rb +0 -26
  321. data/lib/vitable_connect/models/group_list_params.rb +0 -30
  322. data/lib/vitable_connect/models/group_response.rb +0 -18
  323. data/lib/vitable_connect/models/group_retrieve_params.rb +0 -22
  324. data/lib/vitable_connect/models/group_update_params.rb +0 -36
  325. data/lib/vitable_connect/models/groups/members/sync_retrieve_params.rb +0 -33
  326. data/lib/vitable_connect/models/groups/members/sync_retrieve_response.rb +0 -128
  327. data/lib/vitable_connect/models/groups/members/sync_submit_params.rb +0 -121
  328. data/lib/vitable_connect/models/groups/members/sync_submit_response.rb +0 -45
  329. data/lib/vitable_connect/models/pagination.rb +0 -42
  330. data/lib/vitable_connect/models/plan_list_params.rb +0 -30
  331. data/lib/vitable_connect/models/plan_list_response.rb +0 -22
  332. data/lib/vitable_connect/models/type.rb +0 -17
  333. data/lib/vitable_connect/models/webhook_event.rb +0 -62
  334. data/lib/vitable_connect/models/webhook_event_list_deliveries_params.rb +0 -20
  335. data/lib/vitable_connect/models/webhook_event_list_deliveries_response.rb +0 -92
  336. data/lib/vitable_connect/models/webhook_event_list_params.rb +0 -132
  337. data/lib/vitable_connect/models/webhook_event_retrieve_params.rb +0 -20
  338. data/lib/vitable_connect/models/webhook_event_retrieve_response.rb +0 -18
  339. data/lib/vitable_connect/models.rb +0 -104
  340. data/lib/vitable_connect/request_options.rb +0 -78
  341. data/lib/vitable_connect/resources/auth.rb +0 -41
  342. data/lib/vitable_connect/resources/benefit_eligibility_policies.rb +0 -14
  343. data/lib/vitable_connect/resources/employees.rb +0 -65
  344. data/lib/vitable_connect/resources/employers.rb +0 -184
  345. data/lib/vitable_connect/resources/enrollments.rb +0 -35
  346. data/lib/vitable_connect/resources/groups/members/sync.rb +0 -74
  347. data/lib/vitable_connect/resources/groups/members.rb +0 -20
  348. data/lib/vitable_connect/resources/groups.rb +0 -114
  349. data/lib/vitable_connect/resources/plans.rb +0 -41
  350. data/lib/vitable_connect/resources/webhook_events.rb +0 -95
  351. data/manifest.yaml +0 -17
  352. data/rbi/vitable_connect/client.rbi +0 -93
  353. data/rbi/vitable_connect/errors.rbi +0 -205
  354. data/rbi/vitable_connect/file_part.rbi +0 -37
  355. data/rbi/vitable_connect/internal/page_number_page.rbi +0 -49
  356. data/rbi/vitable_connect/internal/transport/base_client.rbi +0 -307
  357. data/rbi/vitable_connect/internal/transport/pooled_net_requester.rbi +0 -84
  358. data/rbi/vitable_connect/internal/type/array_of.rbi +0 -108
  359. data/rbi/vitable_connect/internal/type/base_model.rbi +0 -314
  360. data/rbi/vitable_connect/internal/type/base_page.rbi +0 -43
  361. data/rbi/vitable_connect/internal/type/boolean.rbi +0 -58
  362. data/rbi/vitable_connect/internal/type/converter.rbi +0 -225
  363. data/rbi/vitable_connect/internal/type/enum.rbi +0 -82
  364. data/rbi/vitable_connect/internal/type/file_input.rbi +0 -59
  365. data/rbi/vitable_connect/internal/type/hash_of.rbi +0 -108
  366. data/rbi/vitable_connect/internal/type/request_parameters.rbi +0 -31
  367. data/rbi/vitable_connect/internal/type/union.rbi +0 -130
  368. data/rbi/vitable_connect/internal/type/unknown.rbi +0 -58
  369. data/rbi/vitable_connect/internal/util.rbi +0 -515
  370. data/rbi/vitable_connect/internal.rbi +0 -18
  371. data/rbi/vitable_connect/models/auth_issue_access_token_params.rbi +0 -147
  372. data/rbi/vitable_connect/models/auth_issue_access_token_response.rbi +0 -128
  373. data/rbi/vitable_connect/models/employee.rbi +0 -450
  374. data/rbi/vitable_connect/models/employee_class.rbi +0 -38
  375. data/rbi/vitable_connect/models/employee_list_enrollments_params.rbi +0 -68
  376. data/rbi/vitable_connect/models/employee_retrieve_params.rbi +0 -46
  377. data/rbi/vitable_connect/models/employee_retrieve_response.rbi +0 -32
  378. data/rbi/vitable_connect/models/employer.rbi +0 -197
  379. data/rbi/vitable_connect/models/employer_create_params.rbi +0 -169
  380. data/rbi/vitable_connect/models/employer_list_employees_params.rbi +0 -68
  381. data/rbi/vitable_connect/models/employer_list_params.rbi +0 -60
  382. data/rbi/vitable_connect/models/employer_response.rbi +0 -36
  383. data/rbi/vitable_connect/models/employer_retrieve_params.rbi +0 -46
  384. data/rbi/vitable_connect/models/employer_submit_census_sync_params.rbi +0 -819
  385. data/rbi/vitable_connect/models/employer_submit_census_sync_response.rbi +0 -76
  386. data/rbi/vitable_connect/models/employer_update_settings_params.rbi +0 -114
  387. data/rbi/vitable_connect/models/employer_update_settings_response.rbi +0 -147
  388. data/rbi/vitable_connect/models/enrollment.rbi +0 -401
  389. data/rbi/vitable_connect/models/enrollment_retrieve_params.rbi +0 -46
  390. data/rbi/vitable_connect/models/enrollment_retrieve_response.rbi +0 -34
  391. data/rbi/vitable_connect/models/enrollment_status.rbi +0 -32
  392. data/rbi/vitable_connect/models/group.rbi +0 -77
  393. data/rbi/vitable_connect/models/group_create_params.rbi +0 -46
  394. data/rbi/vitable_connect/models/group_list_params.rbi +0 -60
  395. data/rbi/vitable_connect/models/group_response.rbi +0 -32
  396. data/rbi/vitable_connect/models/group_retrieve_params.rbi +0 -43
  397. data/rbi/vitable_connect/models/group_update_params.rbi +0 -58
  398. data/rbi/vitable_connect/models/groups/members/sync_retrieve_params.rbi +0 -56
  399. data/rbi/vitable_connect/models/groups/members/sync_retrieve_response.rbi +0 -282
  400. data/rbi/vitable_connect/models/groups/members/sync_submit_params.rbi +0 -214
  401. data/rbi/vitable_connect/models/groups/members/sync_submit_response.rbi +0 -92
  402. data/rbi/vitable_connect/models/pagination.rbi +0 -62
  403. data/rbi/vitable_connect/models/plan_list_params.rbi +0 -60
  404. data/rbi/vitable_connect/models/plan_list_response.rbi +0 -29
  405. data/rbi/vitable_connect/models/type.rbi +0 -21
  406. data/rbi/vitable_connect/models/webhook_event.rbi +0 -81
  407. data/rbi/vitable_connect/models/webhook_event_list_deliveries_params.rbi +0 -38
  408. data/rbi/vitable_connect/models/webhook_event_list_deliveries_response.rbi +0 -147
  409. data/rbi/vitable_connect/models/webhook_event_list_params.rbi +0 -299
  410. data/rbi/vitable_connect/models/webhook_event_retrieve_params.rbi +0 -38
  411. data/rbi/vitable_connect/models/webhook_event_retrieve_response.rbi +0 -34
  412. data/rbi/vitable_connect/models.rbi +0 -70
  413. data/rbi/vitable_connect/request_options.rbi +0 -61
  414. data/rbi/vitable_connect/resources/auth.rbi +0 -36
  415. data/rbi/vitable_connect/resources/benefit_eligibility_policies.rbi +0 -12
  416. data/rbi/vitable_connect/resources/employees.rbi +0 -51
  417. data/rbi/vitable_connect/resources/employers.rbi +0 -150
  418. data/rbi/vitable_connect/resources/enrollments.rbi +0 -27
  419. data/rbi/vitable_connect/resources/groups/members/sync.rbi +0 -62
  420. data/rbi/vitable_connect/resources/groups/members.rbi +0 -17
  421. data/rbi/vitable_connect/resources/groups.rbi +0 -79
  422. data/rbi/vitable_connect/resources/plans.rbi +0 -34
  423. data/rbi/vitable_connect/resources/webhook_events.rbi +0 -83
  424. data/rbi/vitable_connect/version.rbi +0 -5
  425. data/sig/vitable_connect/client.rbs +0 -46
  426. data/sig/vitable_connect/errors.rbs +0 -117
  427. data/sig/vitable_connect/file_part.rbs +0 -21
  428. data/sig/vitable_connect/internal/page_number_page.rbs +0 -28
  429. data/sig/vitable_connect/internal/transport/base_client.rbs +0 -133
  430. data/sig/vitable_connect/internal/transport/pooled_net_requester.rbs +0 -48
  431. data/sig/vitable_connect/internal/type/array_of.rbs +0 -48
  432. data/sig/vitable_connect/internal/type/base_model.rbs +0 -104
  433. data/sig/vitable_connect/internal/type/base_page.rbs +0 -24
  434. data/sig/vitable_connect/internal/type/boolean.rbs +0 -26
  435. data/sig/vitable_connect/internal/type/converter.rbs +0 -79
  436. data/sig/vitable_connect/internal/type/enum.rbs +0 -32
  437. data/sig/vitable_connect/internal/type/file_input.rbs +0 -25
  438. data/sig/vitable_connect/internal/type/hash_of.rbs +0 -48
  439. data/sig/vitable_connect/internal/type/request_parameters.rbs +0 -20
  440. data/sig/vitable_connect/internal/type/union.rbs +0 -52
  441. data/sig/vitable_connect/internal/type/unknown.rbs +0 -26
  442. data/sig/vitable_connect/internal/util.rbs +0 -199
  443. data/sig/vitable_connect/internal.rbs +0 -10
  444. data/sig/vitable_connect/models/auth_issue_access_token_params.rbs +0 -56
  445. data/sig/vitable_connect/models/auth_issue_access_token_response.rbs +0 -50
  446. data/sig/vitable_connect/models/employee.rbs +0 -214
  447. data/sig/vitable_connect/models/employee_class.rbs +0 -24
  448. data/sig/vitable_connect/models/employee_list_enrollments_params.rbs +0 -36
  449. data/sig/vitable_connect/models/employee_retrieve_params.rbs +0 -24
  450. data/sig/vitable_connect/models/employee_retrieve_response.rbs +0 -13
  451. data/sig/vitable_connect/models/employer.rbs +0 -112
  452. data/sig/vitable_connect/models/employer_create_params.rbs +0 -93
  453. data/sig/vitable_connect/models/employer_list_employees_params.rbs +0 -36
  454. data/sig/vitable_connect/models/employer_list_params.rbs +0 -32
  455. data/sig/vitable_connect/models/employer_response.rbs +0 -13
  456. data/sig/vitable_connect/models/employer_retrieve_params.rbs +0 -24
  457. data/sig/vitable_connect/models/employer_submit_census_sync_params.rbs +0 -274
  458. data/sig/vitable_connect/models/employer_submit_census_sync_response.rbs +0 -30
  459. data/sig/vitable_connect/models/employer_update_settings_params.rbs +0 -44
  460. data/sig/vitable_connect/models/employer_update_settings_response.rbs +0 -48
  461. data/sig/vitable_connect/models/enrollment.rbs +0 -164
  462. data/sig/vitable_connect/models/enrollment_retrieve_params.rbs +0 -24
  463. data/sig/vitable_connect/models/enrollment_retrieve_response.rbs +0 -13
  464. data/sig/vitable_connect/models/enrollment_status.rbs +0 -16
  465. data/sig/vitable_connect/models/group.rbs +0 -45
  466. data/sig/vitable_connect/models/group_create_params.rbs +0 -28
  467. data/sig/vitable_connect/models/group_list_params.rbs +0 -32
  468. data/sig/vitable_connect/models/group_response.rbs +0 -13
  469. data/sig/vitable_connect/models/group_retrieve_params.rbs +0 -23
  470. data/sig/vitable_connect/models/group_update_params.rbs +0 -32
  471. data/sig/vitable_connect/models/groups/members/sync_retrieve_params.rbs +0 -32
  472. data/sig/vitable_connect/models/groups/members/sync_retrieve_response.rbs +0 -126
  473. data/sig/vitable_connect/models/groups/members/sync_submit_params.rbs +0 -124
  474. data/sig/vitable_connect/models/groups/members/sync_submit_response.rbs +0 -47
  475. data/sig/vitable_connect/models/pagination.rbs +0 -30
  476. data/sig/vitable_connect/models/plan_list_params.rbs +0 -32
  477. data/sig/vitable_connect/models/plan_list_response.rbs +0 -15
  478. data/sig/vitable_connect/models/type.rbs +0 -14
  479. data/sig/vitable_connect/models/webhook_event.rbs +0 -45
  480. data/sig/vitable_connect/models/webhook_event_list_deliveries_params.rbs +0 -23
  481. data/sig/vitable_connect/models/webhook_event_list_deliveries_response.rbs +0 -77
  482. data/sig/vitable_connect/models/webhook_event_list_params.rbs +0 -124
  483. data/sig/vitable_connect/models/webhook_event_retrieve_params.rbs +0 -23
  484. data/sig/vitable_connect/models/webhook_event_retrieve_response.rbs +0 -14
  485. data/sig/vitable_connect/models.rbs +0 -61
  486. data/sig/vitable_connect/request_options.rbs +0 -36
  487. data/sig/vitable_connect/resources/auth.rbs +0 -13
  488. data/sig/vitable_connect/resources/benefit_eligibility_policies.rbs +0 -7
  489. data/sig/vitable_connect/resources/employees.rbs +0 -19
  490. data/sig/vitable_connect/resources/employers.rbs +0 -48
  491. data/sig/vitable_connect/resources/enrollments.rbs +0 -12
  492. data/sig/vitable_connect/resources/groups/members/sync.rbs +0 -23
  493. data/sig/vitable_connect/resources/groups/members.rbs +0 -11
  494. data/sig/vitable_connect/resources/groups.rbs +0 -33
  495. data/sig/vitable_connect/resources/plans.rbs +0 -13
  496. data/sig/vitable_connect/resources/webhook_events.rbs +0 -28
  497. data/sig/vitable_connect/version.rbs +0 -3
data/reference.md ADDED
@@ -0,0 +1,3722 @@
1
+ # Reference
2
+ ## Auth
3
+ <details><summary><code>client.auth.<a href="/lib/VitableConnect/auth/client.rb">issue_access_token</a>(request) -> VitableConnect::Types::AccessTokenResponse</code></summary>
4
+ <dl>
5
+ <dd>
6
+
7
+ #### 📝 Description
8
+
9
+ <dl>
10
+ <dd>
11
+
12
+ <dl>
13
+ <dd>
14
+
15
+ Issues a short-lived access token from the authenticated API key. Access tokens can optionally be bound to a specific employer or employee for scoped access. Tokens expire after 15 minutes.
16
+ </dd>
17
+ </dl>
18
+ </dd>
19
+ </dl>
20
+
21
+ #### 🔌 Usage
22
+
23
+ <dl>
24
+ <dd>
25
+
26
+ <dl>
27
+ <dd>
28
+
29
+ ```ruby
30
+ client.auth.issue_access_token(grant_type: "client_credentials")
31
+ ```
32
+ </dd>
33
+ </dl>
34
+ </dd>
35
+ </dl>
36
+
37
+ #### ⚙️ Parameters
38
+
39
+ <dl>
40
+ <dd>
41
+
42
+ <dl>
43
+ <dd>
44
+
45
+ **grant_type:** `VitableConnect::Types::GrantType`
46
+
47
+ Token issuance flow. Currently only 'client_credentials' supported.
48
+
49
+ * `client_credentials` - client_credentials
50
+
51
+ </dd>
52
+ </dl>
53
+
54
+ <dl>
55
+ <dd>
56
+
57
+ **bound_entity:** `VitableConnect::Types::BoundEntity` — Optional entity to bind the token to for scoped access
58
+
59
+ </dd>
60
+ </dl>
61
+
62
+ <dl>
63
+ <dd>
64
+
65
+ **request_options:** `VitableConnect::Auth::RequestOptions`
66
+
67
+ </dd>
68
+ </dl>
69
+ </dd>
70
+ </dl>
71
+
72
+
73
+ </dd>
74
+ </dl>
75
+ </details>
76
+
77
+ ## Employees
78
+ <details><summary><code>client.employees.<a href="/lib/VitableConnect/employees/client.rb">get</a>(employee_id:) -> VitableConnect::Types::EmployeeResponse</code></summary>
79
+ <dl>
80
+ <dd>
81
+
82
+ #### 📝 Description
83
+
84
+ <dl>
85
+ <dd>
86
+
87
+ <dl>
88
+ <dd>
89
+
90
+ Retrieves detailed information for a specific employee by ID. Returns employee 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.
91
+ </dd>
92
+ </dl>
93
+ </dd>
94
+ </dl>
95
+
96
+ #### 🔌 Usage
97
+
98
+ <dl>
99
+ <dd>
100
+
101
+ <dl>
102
+ <dd>
103
+
104
+ ```ruby
105
+ client.employees.get(employee_id: "empl_abc123def456")
106
+ ```
107
+ </dd>
108
+ </dl>
109
+ </dd>
110
+ </dl>
111
+
112
+ #### ⚙️ Parameters
113
+
114
+ <dl>
115
+ <dd>
116
+
117
+ <dl>
118
+ <dd>
119
+
120
+ **employee_id:** `String` — Unique employee identifier (empl_*)
121
+
122
+ </dd>
123
+ </dl>
124
+
125
+ <dl>
126
+ <dd>
127
+
128
+ **request_options:** `VitableConnect::Employees::RequestOptions`
129
+
130
+ </dd>
131
+ </dl>
132
+ </dd>
133
+ </dl>
134
+
135
+
136
+ </dd>
137
+ </dl>
138
+ </details>
139
+
140
+ <details><summary><code>client.employees.<a href="/lib/VitableConnect/employees/client.rb">update</a>(employee_id:, request) -> VitableConnect::Types::EmployeeResponse</code></summary>
141
+ <dl>
142
+ <dd>
143
+
144
+ #### 📝 Description
145
+
146
+ <dl>
147
+ <dd>
148
+
149
+ <dl>
150
+ <dd>
151
+
152
+ 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.
153
+ </dd>
154
+ </dl>
155
+ </dd>
156
+ </dl>
157
+
158
+ #### 🔌 Usage
159
+
160
+ <dl>
161
+ <dd>
162
+
163
+ <dl>
164
+ <dd>
165
+
166
+ ```ruby
167
+ client.employees.update(
168
+ employee_id: "empl_abc123def456",
169
+ employee_class: "Full Time",
170
+ start_date: "2023-01-15",
171
+ compensation_type: "Salary",
172
+ effective_date: "2023-03-01"
173
+ )
174
+ ```
175
+ </dd>
176
+ </dl>
177
+ </dd>
178
+ </dl>
179
+
180
+ #### ⚙️ Parameters
181
+
182
+ <dl>
183
+ <dd>
184
+
185
+ <dl>
186
+ <dd>
187
+
188
+ **employee_id:** `String` — Unique employee identifier (empl_*)
189
+
190
+ </dd>
191
+ </dl>
192
+
193
+ <dl>
194
+ <dd>
195
+
196
+ **email:** `String` — Email address
197
+
198
+ </dd>
199
+ </dl>
200
+
201
+ <dl>
202
+ <dd>
203
+
204
+ **phone:** `String` — Phone number
205
+
206
+ </dd>
207
+ </dl>
208
+
209
+ <dl>
210
+ <dd>
211
+
212
+ **gender:** `VitableConnect::Types::Gender`
213
+
214
+ Gender identity
215
+
216
+ * `Male` - Male
217
+ * `Female` - Female
218
+ * `Transgender` - Transgender
219
+ * `Non-binary` - Non-binary
220
+ * `Prefer not to respond` - Prefer not to respond
221
+
222
+ </dd>
223
+ </dl>
224
+
225
+ <dl>
226
+ <dd>
227
+
228
+ **address:** `VitableConnect::Types::EmployeeAddressInput` — Employee's residential address
229
+
230
+ </dd>
231
+ </dl>
232
+
233
+ <dl>
234
+ <dd>
235
+
236
+ **employee_class:** `VitableConnect::Types::EmployeeClass`
237
+
238
+ Employment classification
239
+
240
+ * `Full Time` - Full Time
241
+ * `Part Time` - Part Time
242
+ * `Temporary` - Temporary
243
+ * `Intern` - Intern
244
+ * `Seasonal` - Seasonal
245
+ * `Individual Contractor` - Individual Contractor
246
+
247
+ </dd>
248
+ </dl>
249
+
250
+ <dl>
251
+ <dd>
252
+
253
+ **start_date:** `String` — Employment start date
254
+
255
+ </dd>
256
+ </dl>
257
+
258
+ <dl>
259
+ <dd>
260
+
261
+ **compensation_type:** `VitableConnect::Types::CompensationType`
262
+
263
+ Employee compensation type
264
+
265
+ * `Salary` - Salary
266
+ * `Hourly` - Hourly
267
+
268
+ </dd>
269
+ </dl>
270
+
271
+ <dl>
272
+ <dd>
273
+
274
+ **effective_date:** `String` — Past or present date applied to each tracked employment field included in this request
275
+
276
+ </dd>
277
+ </dl>
278
+
279
+ <dl>
280
+ <dd>
281
+
282
+ **request_options:** `VitableConnect::Employees::RequestOptions`
283
+
284
+ </dd>
285
+ </dl>
286
+ </dd>
287
+ </dl>
288
+
289
+
290
+ </dd>
291
+ </dl>
292
+ </details>
293
+
294
+ <details><summary><code>client.employees.<a href="/lib/VitableConnect/employees/client.rb">list_enrollments</a>(employee_id:) -> VitableConnect::Types::EnrollmentListResponse</code></summary>
295
+ <dl>
296
+ <dd>
297
+
298
+ #### 📝 Description
299
+
300
+ <dl>
301
+ <dd>
302
+
303
+ <dl>
304
+ <dd>
305
+
306
+ Retrieves a paginated list of benefit enrollments for an employee.
307
+ </dd>
308
+ </dl>
309
+ </dd>
310
+ </dl>
311
+
312
+ #### 🔌 Usage
313
+
314
+ <dl>
315
+ <dd>
316
+
317
+ <dl>
318
+ <dd>
319
+
320
+ ```ruby
321
+ client.employees.list_enrollments(
322
+ employee_id: "empl_abc123def456",
323
+ limit: 20,
324
+ page: 1
325
+ )
326
+ ```
327
+ </dd>
328
+ </dl>
329
+ </dd>
330
+ </dl>
331
+
332
+ #### ⚙️ Parameters
333
+
334
+ <dl>
335
+ <dd>
336
+
337
+ <dl>
338
+ <dd>
339
+
340
+ **employee_id:** `String` — Unique employee identifier (empl_*)
341
+
342
+ </dd>
343
+ </dl>
344
+
345
+ <dl>
346
+ <dd>
347
+
348
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
349
+
350
+ </dd>
351
+ </dl>
352
+
353
+ <dl>
354
+ <dd>
355
+
356
+ **page:** `Integer` — Page number (default: 1)
357
+
358
+ </dd>
359
+ </dl>
360
+
361
+ <dl>
362
+ <dd>
363
+
364
+ **request_options:** `VitableConnect::Employees::RequestOptions`
365
+
366
+ </dd>
367
+ </dl>
368
+ </dd>
369
+ </dl>
370
+
371
+
372
+ </dd>
373
+ </dl>
374
+ </details>
375
+
376
+ ## Employers
377
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list</a>() -> VitableConnect::Types::OrganizationEmployerListResponse</code></summary>
378
+ <dl>
379
+ <dd>
380
+
381
+ #### 📝 Description
382
+
383
+ <dl>
384
+ <dd>
385
+
386
+ <dl>
387
+ <dd>
388
+
389
+ 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 search by display name, legal name, or exact EIN, employer id or contact email, benefit-family/lifecycle/HRIS filters, and page/limit pagination.
390
+ </dd>
391
+ </dl>
392
+ </dd>
393
+ </dl>
394
+
395
+ #### 🔌 Usage
396
+
397
+ <dl>
398
+ <dd>
399
+
400
+ <dl>
401
+ <dd>
402
+
403
+ ```ruby
404
+ client.employers.list(
405
+ limit: 20,
406
+ page: 1
407
+ )
408
+ ```
409
+ </dd>
410
+ </dl>
411
+ </dd>
412
+ </dl>
413
+
414
+ #### ⚙️ Parameters
415
+
416
+ <dl>
417
+ <dd>
418
+
419
+ <dl>
420
+ <dd>
421
+
422
+ **benefit_family:** `VitableConnect::Types::BenefitFamilyParamItem` — Filter to employers with at least one active benefit in these families.
423
+
424
+ </dd>
425
+ </dl>
426
+
427
+ <dl>
428
+ <dd>
429
+
430
+ **benefit_lifecycle_stage:** `VitableConnect::Types::BenefitLifecycleStageItem` — Filter to employers in one of these computed benefit-lifecycle stages.
431
+
432
+ </dd>
433
+ </dl>
434
+
435
+ <dl>
436
+ <dd>
437
+
438
+ **hris_provider:** `String` — Filter to employers whose HRIS connection is with one of these payroll providers (e.g. `ADP RUN`). Matched case-insensitively; free text, so read the available values from the HRIS-providers endpoint rather than assuming a fixed set.
439
+
440
+ </dd>
441
+ </dl>
442
+
443
+ <dl>
444
+ <dd>
445
+
446
+ **hris_status:** `VitableConnect::Types::HrisStatusItem` — Filter to employers whose HRIS connection is in one of these statuses.
447
+
448
+ </dd>
449
+ </dl>
450
+
451
+ <dl>
452
+ <dd>
453
+
454
+ **include_cancelled:** `Internal::Types::Boolean` — Include cancelled employers (hidden by default unless their stage is explicitly requested).
455
+
456
+ </dd>
457
+ </dl>
458
+
459
+ <dl>
460
+ <dd>
461
+
462
+ **limit:** `Integer` — Items per page.
463
+
464
+ </dd>
465
+ </dl>
466
+
467
+ <dl>
468
+ <dd>
469
+
470
+ **page:** `Integer` — Page number.
471
+
472
+ </dd>
473
+ </dl>
474
+
475
+ <dl>
476
+ <dd>
477
+
478
+ **search:** `String` — Employer filter. Matches the display name or the legal name case-insensitively as a substring, or one of these exactly: the EIN (with or without its dash), the employer id, or the contact email of one of the employer's non-disabled admins.
479
+
480
+ </dd>
481
+ </dl>
482
+
483
+ <dl>
484
+ <dd>
485
+
486
+ **request_options:** `VitableConnect::Employers::RequestOptions`
487
+
488
+ </dd>
489
+ </dl>
490
+ </dd>
491
+ </dl>
492
+
493
+
494
+ </dd>
495
+ </dl>
496
+ </details>
497
+
498
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">create</a>(request) -> VitableConnect::Types::EmployerResponse</code></summary>
499
+ <dl>
500
+ <dd>
501
+
502
+ #### 📝 Description
503
+
504
+ <dl>
505
+ <dd>
506
+
507
+ <dl>
508
+ <dd>
509
+
510
+ Creates a new employer for the authenticated organization. Requires employer name, legal name, EIN, email, and address information. Returns the created employer with its assigned ID.
511
+ </dd>
512
+ </dl>
513
+ </dd>
514
+ </dl>
515
+
516
+ #### 🔌 Usage
517
+
518
+ <dl>
519
+ <dd>
520
+
521
+ <dl>
522
+ <dd>
523
+
524
+ ```ruby
525
+ client.employers.create(
526
+ name: "NewCo Industries",
527
+ legal_name: "NewCo Industries LLC",
528
+ ein: "12-3456789",
529
+ email: "hr@newco.com",
530
+ address: {
531
+ address_line1: "789 Business Blvd",
532
+ address_line2: "Floor 5",
533
+ city: "Seattle",
534
+ state: "WA",
535
+ zipcode: "98101"
536
+ },
537
+ phone_number: "2065550100",
538
+ reference_id: "partner-emp-001"
539
+ )
540
+ ```
541
+ </dd>
542
+ </dl>
543
+ </dd>
544
+ </dl>
545
+
546
+ #### ⚙️ Parameters
547
+
548
+ <dl>
549
+ <dd>
550
+
551
+ <dl>
552
+ <dd>
553
+
554
+ **name:** `String` — Employer display name
555
+
556
+ </dd>
557
+ </dl>
558
+
559
+ <dl>
560
+ <dd>
561
+
562
+ **legal_name:** `String` — Legal business name
563
+
564
+ </dd>
565
+ </dl>
566
+
567
+ <dl>
568
+ <dd>
569
+
570
+ **ein:** `String` — Employer Identification Number (format: XX-XXXXXXX)
571
+
572
+ </dd>
573
+ </dl>
574
+
575
+ <dl>
576
+ <dd>
577
+
578
+ **email:** `String` — Email address for billing and communications
579
+
580
+ </dd>
581
+ </dl>
582
+
583
+ <dl>
584
+ <dd>
585
+
586
+ **address:** `VitableConnect::Types::EmployerAddressInput` — Employer address
587
+
588
+ </dd>
589
+ </dl>
590
+
591
+ <dl>
592
+ <dd>
593
+
594
+ **phone_number:** `String` — Employer phone number (10-digit US format, e.g. 5551234567)
595
+
596
+ </dd>
597
+ </dl>
598
+
599
+ <dl>
600
+ <dd>
601
+
602
+ **reference_id:** `String` — External reference ID for this employer
603
+
604
+ </dd>
605
+ </dl>
606
+
607
+ <dl>
608
+ <dd>
609
+
610
+ **request_options:** `VitableConnect::Employers::RequestOptions`
611
+
612
+ </dd>
613
+ </dl>
614
+ </dd>
615
+ </dl>
616
+
617
+
618
+ </dd>
619
+ </dl>
620
+ </details>
621
+
622
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">get</a>(employer_id:) -> VitableConnect::Types::EmployerResponse</code></summary>
623
+ <dl>
624
+ <dd>
625
+
626
+ #### 📝 Description
627
+
628
+ <dl>
629
+ <dd>
630
+
631
+ <dl>
632
+ <dd>
633
+
634
+ Retrieves detailed information for a specific employer by ID. The employer must belong to the authenticated organization.
635
+ </dd>
636
+ </dl>
637
+ </dd>
638
+ </dl>
639
+
640
+ #### 🔌 Usage
641
+
642
+ <dl>
643
+ <dd>
644
+
645
+ <dl>
646
+ <dd>
647
+
648
+ ```ruby
649
+ client.employers.get(employer_id: "empr_abc123def456")
650
+ ```
651
+ </dd>
652
+ </dl>
653
+ </dd>
654
+ </dl>
655
+
656
+ #### ⚙️ Parameters
657
+
658
+ <dl>
659
+ <dd>
660
+
661
+ <dl>
662
+ <dd>
663
+
664
+ **employer_id:** `String` — Unique employer identifier (empr_*)
665
+
666
+ </dd>
667
+ </dl>
668
+
669
+ <dl>
670
+ <dd>
671
+
672
+ **request_options:** `VitableConnect::Employers::RequestOptions`
673
+
674
+ </dd>
675
+ </dl>
676
+ </dd>
677
+ </dl>
678
+
679
+
680
+ </dd>
681
+ </dl>
682
+ </details>
683
+
684
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">update</a>(employer_id:, request) -> VitableConnect::Types::EmployerResponse</code></summary>
685
+ <dl>
686
+ <dd>
687
+
688
+ #### 📝 Description
689
+
690
+ <dl>
691
+ <dd>
692
+
693
+ <dl>
694
+ <dd>
695
+
696
+ Updates an existing employer. All fields are optional — only provided fields are updated. PO Box addresses are rejected.
697
+ </dd>
698
+ </dl>
699
+ </dd>
700
+ </dl>
701
+
702
+ #### 🔌 Usage
703
+
704
+ <dl>
705
+ <dd>
706
+
707
+ <dl>
708
+ <dd>
709
+
710
+ ```ruby
711
+ client.employers.update(employer_id: "empr_abc123def456")
712
+ ```
713
+ </dd>
714
+ </dl>
715
+ </dd>
716
+ </dl>
717
+
718
+ #### ⚙️ Parameters
719
+
720
+ <dl>
721
+ <dd>
722
+
723
+ <dl>
724
+ <dd>
725
+
726
+ **employer_id:** `String` — Unique employer identifier (empr_*)
727
+
728
+ </dd>
729
+ </dl>
730
+
731
+ <dl>
732
+ <dd>
733
+
734
+ **name:** `String` — Employer display name
735
+
736
+ </dd>
737
+ </dl>
738
+
739
+ <dl>
740
+ <dd>
741
+
742
+ **legal_name:** `String` — Legal business name
743
+
744
+ </dd>
745
+ </dl>
746
+
747
+ <dl>
748
+ <dd>
749
+
750
+ **address:** `VitableConnect::Types::UpdateEmployerAddressInput` — Employer address
751
+
752
+ </dd>
753
+ </dl>
754
+
755
+ <dl>
756
+ <dd>
757
+
758
+ **active:** `Internal::Types::Boolean` — Whether the employer is active
759
+
760
+ </dd>
761
+ </dl>
762
+
763
+ <dl>
764
+ <dd>
765
+
766
+ **request_options:** `VitableConnect::Employers::RequestOptions`
767
+
768
+ </dd>
769
+ </dl>
770
+ </dd>
771
+ </dl>
772
+
773
+
774
+ </dd>
775
+ </dl>
776
+ </details>
777
+
778
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_benefit_plan_years</a>(employer_id:) -> VitableConnect::Types::EmployerBenefitPlanYearsListResponse</code></summary>
779
+ <dl>
780
+ <dd>
781
+
782
+ #### 📝 Description
783
+
784
+ <dl>
785
+ <dd>
786
+
787
+ <dl>
788
+ <dd>
789
+
790
+ 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.
791
+ </dd>
792
+ </dl>
793
+ </dd>
794
+ </dl>
795
+
796
+ #### 🔌 Usage
797
+
798
+ <dl>
799
+ <dd>
800
+
801
+ <dl>
802
+ <dd>
803
+
804
+ ```ruby
805
+ client.employers.list_benefit_plan_years(employer_id: "empr_abc123def456")
806
+ ```
807
+ </dd>
808
+ </dl>
809
+ </dd>
810
+ </dl>
811
+
812
+ #### ⚙️ Parameters
813
+
814
+ <dl>
815
+ <dd>
816
+
817
+ <dl>
818
+ <dd>
819
+
820
+ **employer_id:** `String` — Unique employer identifier (empr_*)
821
+
822
+ </dd>
823
+ </dl>
824
+
825
+ <dl>
826
+ <dd>
827
+
828
+ **request_options:** `VitableConnect::Employers::RequestOptions`
829
+
830
+ </dd>
831
+ </dl>
832
+ </dd>
833
+ </dl>
834
+
835
+
836
+ </dd>
837
+ </dl>
838
+ </details>
839
+
840
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">get_benefit_plan_year</a>(employer_id:, benefit_plan_year_id:) -> VitableConnect::Types::EmployerBenefitPlanYearResponse</code></summary>
841
+ <dl>
842
+ <dd>
843
+
844
+ #### 📝 Description
845
+
846
+ <dl>
847
+ <dd>
848
+
849
+ <dl>
850
+ <dd>
851
+
852
+ 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.
853
+ </dd>
854
+ </dl>
855
+ </dd>
856
+ </dl>
857
+
858
+ #### 🔌 Usage
859
+
860
+ <dl>
861
+ <dd>
862
+
863
+ <dl>
864
+ <dd>
865
+
866
+ ```ruby
867
+ client.employers.get_benefit_plan_year(
868
+ employer_id: "empr_abc123def456",
869
+ benefit_plan_year_id: "plyr_abc123def456"
870
+ )
871
+ ```
872
+ </dd>
873
+ </dl>
874
+ </dd>
875
+ </dl>
876
+
877
+ #### ⚙️ Parameters
878
+
879
+ <dl>
880
+ <dd>
881
+
882
+ <dl>
883
+ <dd>
884
+
885
+ **employer_id:** `String` — Unique employer identifier (empr_*)
886
+
887
+ </dd>
888
+ </dl>
889
+
890
+ <dl>
891
+ <dd>
892
+
893
+ **benefit_plan_year_id:** `String` — Unique benefit-plan-year identifier (plyr_*).
894
+
895
+ </dd>
896
+ </dl>
897
+
898
+ <dl>
899
+ <dd>
900
+
901
+ **request_options:** `VitableConnect::Employers::RequestOptions`
902
+
903
+ </dd>
904
+ </dl>
905
+ </dd>
906
+ </dl>
907
+
908
+
909
+ </dd>
910
+ </dl>
911
+ </details>
912
+
913
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_benefit_plan_year_enrollments</a>(employer_id:, benefit_plan_year_id:) -> VitableConnect::Types::PlanYearEnrollmentListResponse</code></summary>
914
+ <dl>
915
+ <dd>
916
+
917
+ #### 📝 Description
918
+
919
+ <dl>
920
+ <dd>
921
+
922
+ <dl>
923
+ <dd>
924
+
925
+ 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.
926
+ </dd>
927
+ </dl>
928
+ </dd>
929
+ </dl>
930
+
931
+ #### 🔌 Usage
932
+
933
+ <dl>
934
+ <dd>
935
+
936
+ <dl>
937
+ <dd>
938
+
939
+ ```ruby
940
+ client.employers.list_benefit_plan_year_enrollments(
941
+ employer_id: "empr_abc123def456",
942
+ benefit_plan_year_id: "plyr_abc123def456",
943
+ limit: 20,
944
+ page: 1
945
+ )
946
+ ```
947
+ </dd>
948
+ </dl>
949
+ </dd>
950
+ </dl>
951
+
952
+ #### ⚙️ Parameters
953
+
954
+ <dl>
955
+ <dd>
956
+
957
+ <dl>
958
+ <dd>
959
+
960
+ **employer_id:** `String` — Unique employer identifier (empr_*).
961
+
962
+ </dd>
963
+ </dl>
964
+
965
+ <dl>
966
+ <dd>
967
+
968
+ **benefit_plan_year_id:** `String` — Unique benefit-plan-year identifier (plyr_*).
969
+
970
+ </dd>
971
+ </dl>
972
+
973
+ <dl>
974
+ <dd>
975
+
976
+ **election_status:** `VitableConnect::Types::ElectionStatusItem` — Filter by election status. Repeat the parameter to match several.
977
+
978
+ </dd>
979
+ </dl>
980
+
981
+ <dl>
982
+ <dd>
983
+
984
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
985
+
986
+ </dd>
987
+ </dl>
988
+
989
+ <dl>
990
+ <dd>
991
+
992
+ **page:** `Integer` — Page number (default: 1)
993
+
994
+ </dd>
995
+ </dl>
996
+
997
+ <dl>
998
+ <dd>
999
+
1000
+ **search:** `String` — Case-insensitive search. Matches member name partially, and the `member_id` exactly — either your own reference id or the prefixed `grpmbr_<...>` id.
1001
+
1002
+ </dd>
1003
+ </dl>
1004
+
1005
+ <dl>
1006
+ <dd>
1007
+
1008
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1009
+
1010
+ </dd>
1011
+ </dl>
1012
+ </dd>
1013
+ </dl>
1014
+
1015
+
1016
+ </dd>
1017
+ </dl>
1018
+ </details>
1019
+
1020
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">submit_census_sync</a>(employer_id:, request) -> VitableConnect::Types::CensusSyncDetailResponse</code></summary>
1021
+ <dl>
1022
+ <dd>
1023
+
1024
+ #### 📝 Description
1025
+
1026
+ <dl>
1027
+ <dd>
1028
+
1029
+ <dl>
1030
+ <dd>
1031
+
1032
+ 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.
1033
+ </dd>
1034
+ </dl>
1035
+ </dd>
1036
+ </dl>
1037
+
1038
+ #### 🔌 Usage
1039
+
1040
+ <dl>
1041
+ <dd>
1042
+
1043
+ <dl>
1044
+ <dd>
1045
+
1046
+ ```ruby
1047
+ client.employers.submit_census_sync(
1048
+ employer_id: "empr_abc123def456",
1049
+ employees: [{
1050
+ reference_id: "EMP-001",
1051
+ first_name: "Jane",
1052
+ last_name: "Doe",
1053
+ date_of_birth: "1990-05-15",
1054
+ email: "jane.doe@acme.com",
1055
+ phone: "4155550100",
1056
+ address: {
1057
+ address_line1: "123 Main Street",
1058
+ address_line2: "Apt 4B",
1059
+ city: "San Francisco",
1060
+ state: "CA",
1061
+ zipcode: "94102"
1062
+ },
1063
+ start_date: "2024-01-15",
1064
+ employee_class: "Full Time",
1065
+ compensation_type: "Salary"
1066
+ }, {
1067
+ first_name: "John",
1068
+ last_name: "Smith",
1069
+ date_of_birth: "1985-11-20",
1070
+ email: "john.smith@acme.com",
1071
+ phone: "4155550101",
1072
+ start_date: "2024-03-01",
1073
+ employee_class: "Part Time",
1074
+ compensation_type: "Hourly"
1075
+ }]
1076
+ )
1077
+ ```
1078
+ </dd>
1079
+ </dl>
1080
+ </dd>
1081
+ </dl>
1082
+
1083
+ #### ⚙️ Parameters
1084
+
1085
+ <dl>
1086
+ <dd>
1087
+
1088
+ <dl>
1089
+ <dd>
1090
+
1091
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1092
+
1093
+ </dd>
1094
+ </dl>
1095
+
1096
+ <dl>
1097
+ <dd>
1098
+
1099
+ **employees:** `Internal::Types::Array[VitableConnect::Types::CensusSyncEmployeeRequest]`
1100
+
1101
+ </dd>
1102
+ </dl>
1103
+
1104
+ <dl>
1105
+ <dd>
1106
+
1107
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1108
+
1109
+ </dd>
1110
+ </dl>
1111
+ </dd>
1112
+ </dl>
1113
+
1114
+
1115
+ </dd>
1116
+ </dl>
1117
+ </details>
1118
+
1119
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_employees</a>(employer_id:) -> VitableConnect::Types::EmployeeListResponse</code></summary>
1120
+ <dl>
1121
+ <dd>
1122
+
1123
+ #### 📝 Description
1124
+
1125
+ <dl>
1126
+ <dd>
1127
+
1128
+ <dl>
1129
+ <dd>
1130
+
1131
+ 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.
1132
+ </dd>
1133
+ </dl>
1134
+ </dd>
1135
+ </dl>
1136
+
1137
+ #### 🔌 Usage
1138
+
1139
+ <dl>
1140
+ <dd>
1141
+
1142
+ <dl>
1143
+ <dd>
1144
+
1145
+ ```ruby
1146
+ client.employers.list_employees(
1147
+ employer_id: "empr_abc123def456",
1148
+ limit: 20,
1149
+ page: 1,
1150
+ search: "jane"
1151
+ )
1152
+ ```
1153
+ </dd>
1154
+ </dl>
1155
+ </dd>
1156
+ </dl>
1157
+
1158
+ #### ⚙️ Parameters
1159
+
1160
+ <dl>
1161
+ <dd>
1162
+
1163
+ <dl>
1164
+ <dd>
1165
+
1166
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1167
+
1168
+ </dd>
1169
+ </dl>
1170
+
1171
+ <dl>
1172
+ <dd>
1173
+
1174
+ **employment_status:** `VitableConnect::Types::EmployeeStatus` — Filter by employment status (active or terminated)
1175
+
1176
+ </dd>
1177
+ </dl>
1178
+
1179
+ <dl>
1180
+ <dd>
1181
+
1182
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
1183
+
1184
+ </dd>
1185
+ </dl>
1186
+
1187
+ <dl>
1188
+ <dd>
1189
+
1190
+ **page:** `Integer` — Page number (default: 1)
1191
+
1192
+ </dd>
1193
+ </dl>
1194
+
1195
+ <dl>
1196
+ <dd>
1197
+
1198
+ **search:** `String` — Case-insensitive search across employee first name, last name, and email
1199
+
1200
+ </dd>
1201
+ </dl>
1202
+
1203
+ <dl>
1204
+ <dd>
1205
+
1206
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1207
+
1208
+ </dd>
1209
+ </dl>
1210
+ </dd>
1211
+ </dl>
1212
+
1213
+
1214
+ </dd>
1215
+ </dl>
1216
+ </details>
1217
+
1218
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">get_hris</a>(employer_id:) -> VitableConnect::Types::EmployerHrisResponse</code></summary>
1219
+ <dl>
1220
+ <dd>
1221
+
1222
+ #### 📝 Description
1223
+
1224
+ <dl>
1225
+ <dd>
1226
+
1227
+ <dl>
1228
+ <dd>
1229
+
1230
+ 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.
1231
+ </dd>
1232
+ </dl>
1233
+ </dd>
1234
+ </dl>
1235
+
1236
+ #### 🔌 Usage
1237
+
1238
+ <dl>
1239
+ <dd>
1240
+
1241
+ <dl>
1242
+ <dd>
1243
+
1244
+ ```ruby
1245
+ client.employers.get_hris(employer_id: "empr_abc123def456")
1246
+ ```
1247
+ </dd>
1248
+ </dl>
1249
+ </dd>
1250
+ </dl>
1251
+
1252
+ #### ⚙️ Parameters
1253
+
1254
+ <dl>
1255
+ <dd>
1256
+
1257
+ <dl>
1258
+ <dd>
1259
+
1260
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1261
+
1262
+ </dd>
1263
+ </dl>
1264
+
1265
+ <dl>
1266
+ <dd>
1267
+
1268
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1269
+
1270
+ </dd>
1271
+ </dl>
1272
+ </dd>
1273
+ </dl>
1274
+
1275
+
1276
+ </dd>
1277
+ </dl>
1278
+ </details>
1279
+
1280
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_invoices</a>(employer_id:) -> VitableConnect::Types::EmployerInvoicesListResponse</code></summary>
1281
+ <dl>
1282
+ <dd>
1283
+
1284
+ #### 📝 Description
1285
+
1286
+ <dl>
1287
+ <dd>
1288
+
1289
+ <dl>
1290
+ <dd>
1291
+
1292
+ 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.
1293
+ </dd>
1294
+ </dl>
1295
+ </dd>
1296
+ </dl>
1297
+
1298
+ #### 🔌 Usage
1299
+
1300
+ <dl>
1301
+ <dd>
1302
+
1303
+ <dl>
1304
+ <dd>
1305
+
1306
+ ```ruby
1307
+ client.employers.list_invoices(
1308
+ employer_id: "empr_abc123def456",
1309
+ limit: 20
1310
+ )
1311
+ ```
1312
+ </dd>
1313
+ </dl>
1314
+ </dd>
1315
+ </dl>
1316
+
1317
+ #### ⚙️ Parameters
1318
+
1319
+ <dl>
1320
+ <dd>
1321
+
1322
+ <dl>
1323
+ <dd>
1324
+
1325
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1326
+
1327
+ </dd>
1328
+ </dl>
1329
+
1330
+ <dl>
1331
+ <dd>
1332
+
1333
+ **limit:** `Integer` — Maximum number of invoices per page
1334
+
1335
+ </dd>
1336
+ </dl>
1337
+
1338
+ <dl>
1339
+ <dd>
1340
+
1341
+ **offset:** `String` — Opaque cursor from a previous page's next_offset
1342
+
1343
+ </dd>
1344
+ </dl>
1345
+
1346
+ <dl>
1347
+ <dd>
1348
+
1349
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1350
+
1351
+ </dd>
1352
+ </dl>
1353
+ </dd>
1354
+ </dl>
1355
+
1356
+
1357
+ </dd>
1358
+ </dl>
1359
+ </details>
1360
+
1361
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">get_invoice_pdf</a>(employer_id:, invoice_id:) -> VitableConnect::Types::EmployerInvoicePdfResponse</code></summary>
1362
+ <dl>
1363
+ <dd>
1364
+
1365
+ #### 📝 Description
1366
+
1367
+ <dl>
1368
+ <dd>
1369
+
1370
+ <dl>
1371
+ <dd>
1372
+
1373
+ 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.
1374
+ </dd>
1375
+ </dl>
1376
+ </dd>
1377
+ </dl>
1378
+
1379
+ #### 🔌 Usage
1380
+
1381
+ <dl>
1382
+ <dd>
1383
+
1384
+ <dl>
1385
+ <dd>
1386
+
1387
+ ```ruby
1388
+ client.employers.get_invoice_pdf(
1389
+ employer_id: "empr_abc123def456",
1390
+ invoice_id: "INV-00042"
1391
+ )
1392
+ ```
1393
+ </dd>
1394
+ </dl>
1395
+ </dd>
1396
+ </dl>
1397
+
1398
+ #### ⚙️ Parameters
1399
+
1400
+ <dl>
1401
+ <dd>
1402
+
1403
+ <dl>
1404
+ <dd>
1405
+
1406
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1407
+
1408
+ </dd>
1409
+ </dl>
1410
+
1411
+ <dl>
1412
+ <dd>
1413
+
1414
+ **invoice_id:** `String` — External Chargebee invoice id (not a prefixed UUID).
1415
+
1416
+ </dd>
1417
+ </dl>
1418
+
1419
+ <dl>
1420
+ <dd>
1421
+
1422
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1423
+
1424
+ </dd>
1425
+ </dl>
1426
+ </dd>
1427
+ </dl>
1428
+
1429
+
1430
+ </dd>
1431
+ </dl>
1432
+ </details>
1433
+
1434
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">get_payroll_access_setup</a>(employer_id:) -> VitableConnect::Types::PayrollAccessSetupStatusResponse</code></summary>
1435
+ <dl>
1436
+ <dd>
1437
+
1438
+ #### 📝 Description
1439
+
1440
+ <dl>
1441
+ <dd>
1442
+
1443
+ <dl>
1444
+ <dd>
1445
+
1446
+ Return whether the employer has submitted payroll access setup.
1447
+ </dd>
1448
+ </dl>
1449
+ </dd>
1450
+ </dl>
1451
+
1452
+ #### 🔌 Usage
1453
+
1454
+ <dl>
1455
+ <dd>
1456
+
1457
+ <dl>
1458
+ <dd>
1459
+
1460
+ ```ruby
1461
+ client.employers.get_payroll_access_setup(employer_id: "empr_abc123def456")
1462
+ ```
1463
+ </dd>
1464
+ </dl>
1465
+ </dd>
1466
+ </dl>
1467
+
1468
+ #### ⚙️ Parameters
1469
+
1470
+ <dl>
1471
+ <dd>
1472
+
1473
+ <dl>
1474
+ <dd>
1475
+
1476
+ **employer_id:** `String`
1477
+
1478
+ </dd>
1479
+ </dl>
1480
+
1481
+ <dl>
1482
+ <dd>
1483
+
1484
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1485
+
1486
+ </dd>
1487
+ </dl>
1488
+ </dd>
1489
+ </dl>
1490
+
1491
+
1492
+ </dd>
1493
+ </dl>
1494
+ </details>
1495
+
1496
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">submit_payroll_access_setup</a>(employer_id:, request) -> VitableConnect::Types::PayrollAccessSetupStatusResponse</code></summary>
1497
+ <dl>
1498
+ <dd>
1499
+
1500
+ #### 📝 Description
1501
+
1502
+ <dl>
1503
+ <dd>
1504
+
1505
+ <dl>
1506
+ <dd>
1507
+
1508
+ Submit the employer's payroll access setup answers.
1509
+ </dd>
1510
+ </dl>
1511
+ </dd>
1512
+ </dl>
1513
+
1514
+ #### 🔌 Usage
1515
+
1516
+ <dl>
1517
+ <dd>
1518
+
1519
+ <dl>
1520
+ <dd>
1521
+
1522
+ ```ruby
1523
+ client.employers.submit_payroll_access_setup(
1524
+ employer_id: "empr_abc123def456",
1525
+ employees_in_payroll_acknowledged: true,
1526
+ payroll_data_impacts_eligibility_acknowledged: true,
1527
+ classifications_accurate: true,
1528
+ all_benefit_eligible_employees_present: true,
1529
+ is_controlled_group: true,
1530
+ access_method: "SELF_SETUP",
1531
+ has_additional_payroll_system: true
1532
+ )
1533
+ ```
1534
+ </dd>
1535
+ </dl>
1536
+ </dd>
1537
+ </dl>
1538
+
1539
+ #### ⚙️ Parameters
1540
+
1541
+ <dl>
1542
+ <dd>
1543
+
1544
+ <dl>
1545
+ <dd>
1546
+
1547
+ **employer_id:** `String`
1548
+
1549
+ </dd>
1550
+ </dl>
1551
+
1552
+ <dl>
1553
+ <dd>
1554
+
1555
+ **employees_in_payroll_acknowledged:** `Internal::Types::Boolean` — Attestation that all benefit-eligible employees appear in the payroll system.
1556
+
1557
+ </dd>
1558
+ </dl>
1559
+
1560
+ <dl>
1561
+ <dd>
1562
+
1563
+ **payroll_data_impacts_eligibility_acknowledged:** `Internal::Types::Boolean` — Attestation that changes to payroll data affect benefit eligibility.
1564
+
1565
+ </dd>
1566
+ </dl>
1567
+
1568
+ <dl>
1569
+ <dd>
1570
+
1571
+ **classifications_accurate:** `Internal::Types::Boolean` — Attestation that employee classifications in payroll are accurate. Set `false` to report corrections in the fields below.
1572
+
1573
+ </dd>
1574
+ </dl>
1575
+
1576
+ <dl>
1577
+ <dd>
1578
+
1579
+ **classification_correction_source:** `VitableConnect::Types::ClassificationCorrectionSource` — Where corrected classifications come from, when `classifications_accurate` is `false`.
1580
+
1581
+ </dd>
1582
+ </dl>
1583
+
1584
+ <dl>
1585
+ <dd>
1586
+
1587
+ **misclassified_employee_names:** `Internal::Types::Array[String]` — Names of employees whose payroll classification needs correcting.
1588
+
1589
+ </dd>
1590
+ </dl>
1591
+
1592
+ <dl>
1593
+ <dd>
1594
+
1595
+ **remaining_employee_action:** `VitableConnect::Types::RemainingEmployeeAction` — How to handle employees still missing from the payroll system.
1596
+
1597
+ </dd>
1598
+ </dl>
1599
+
1600
+ <dl>
1601
+ <dd>
1602
+
1603
+ **all_benefit_eligible_employees_present:** `Internal::Types::Boolean` — Attestation that every benefit-eligible employee is present in payroll.
1604
+
1605
+ </dd>
1606
+ </dl>
1607
+
1608
+ <dl>
1609
+ <dd>
1610
+
1611
+ **missing_employee_resolution:** `VitableConnect::Types::MissingEmployeeResolution` — How any missing employees will be added, when some are absent.
1612
+
1613
+ </dd>
1614
+ </dl>
1615
+
1616
+ <dl>
1617
+ <dd>
1618
+
1619
+ **is_controlled_group:** `Internal::Types::Boolean` — Whether this employer belongs to a controlled group of related entities.
1620
+
1621
+ </dd>
1622
+ </dl>
1623
+
1624
+ <dl>
1625
+ <dd>
1626
+
1627
+ **same_payroll_covers_other_eins:** `Internal::Types::Boolean` — Whether this payroll system also covers other EINs in the controlled group.
1628
+
1629
+ </dd>
1630
+ </dl>
1631
+
1632
+ <dl>
1633
+ <dd>
1634
+
1635
+ **access_method:** `VitableConnect::Types::AccessMethod`
1636
+
1637
+ </dd>
1638
+ </dl>
1639
+
1640
+ <dl>
1641
+ <dd>
1642
+
1643
+ **login_url:** `String` — Sign-in URL for the payroll system.
1644
+
1645
+ </dd>
1646
+ </dl>
1647
+
1648
+ <dl>
1649
+ <dd>
1650
+
1651
+ **username:** `String` — Username Vitable should use to access the payroll system.
1652
+
1653
+ </dd>
1654
+ </dl>
1655
+
1656
+ <dl>
1657
+ <dd>
1658
+
1659
+ **phone:** `String` — Phone number used for payroll-system verification codes.
1660
+
1661
+ </dd>
1662
+ </dl>
1663
+
1664
+ <dl>
1665
+ <dd>
1666
+
1667
+ **password:** `String` — Password Vitable should use to access the payroll system.
1668
+
1669
+ </dd>
1670
+ </dl>
1671
+
1672
+ <dl>
1673
+ <dd>
1674
+
1675
+ **integration_confirmed:** `Internal::Types::Boolean` — Whether the payroll integration has been confirmed as working.
1676
+
1677
+ </dd>
1678
+ </dl>
1679
+
1680
+ <dl>
1681
+ <dd>
1682
+
1683
+ **has_additional_payroll_system:** `Internal::Types::Boolean` — Whether a second payroll system is in use. When `true`, supply the `additional_*` fields below.
1684
+
1685
+ </dd>
1686
+ </dl>
1687
+
1688
+ <dl>
1689
+ <dd>
1690
+
1691
+ **additional_access_method:** `VitableConnect::Types::AdditionalAccessMethod` — How Vitable will access the second payroll system.
1692
+
1693
+ </dd>
1694
+ </dl>
1695
+
1696
+ <dl>
1697
+ <dd>
1698
+
1699
+ **additional_login_url:** `String` — Sign-in URL for the second payroll system.
1700
+
1701
+ </dd>
1702
+ </dl>
1703
+
1704
+ <dl>
1705
+ <dd>
1706
+
1707
+ **additional_username:** `String` — Username Vitable should use for the second payroll system.
1708
+
1709
+ </dd>
1710
+ </dl>
1711
+
1712
+ <dl>
1713
+ <dd>
1714
+
1715
+ **additional_phone:** `String` — Phone number used for second payroll-system verification codes.
1716
+
1717
+ </dd>
1718
+ </dl>
1719
+
1720
+ <dl>
1721
+ <dd>
1722
+
1723
+ **additional_password:** `String` — Password Vitable should use for the second payroll system.
1724
+
1725
+ </dd>
1726
+ </dl>
1727
+
1728
+ <dl>
1729
+ <dd>
1730
+
1731
+ **additional_integration_confirmed:** `Internal::Types::Boolean` — Whether the second payroll integration has been confirmed as working.
1732
+
1733
+ </dd>
1734
+ </dl>
1735
+
1736
+ <dl>
1737
+ <dd>
1738
+
1739
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1740
+
1741
+ </dd>
1742
+ </dl>
1743
+ </dd>
1744
+ </dl>
1745
+
1746
+
1747
+ </dd>
1748
+ </dl>
1749
+ </details>
1750
+
1751
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_payroll_deduction_statements</a>(employer_id:) -> VitableConnect::Types::EmployerPayrollDeductionStatementListResponse</code></summary>
1752
+ <dl>
1753
+ <dd>
1754
+
1755
+ #### 📝 Description
1756
+
1757
+ <dl>
1758
+ <dd>
1759
+
1760
+ <dl>
1761
+ <dd>
1762
+
1763
+ 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.
1764
+ </dd>
1765
+ </dl>
1766
+ </dd>
1767
+ </dl>
1768
+
1769
+ #### 🔌 Usage
1770
+
1771
+ <dl>
1772
+ <dd>
1773
+
1774
+ <dl>
1775
+ <dd>
1776
+
1777
+ ```ruby
1778
+ client.employers.list_payroll_deduction_statements(
1779
+ employer_id: "empr_abc123def456",
1780
+ limit: 20,
1781
+ page: 1
1782
+ )
1783
+ ```
1784
+ </dd>
1785
+ </dl>
1786
+ </dd>
1787
+ </dl>
1788
+
1789
+ #### ⚙️ Parameters
1790
+
1791
+ <dl>
1792
+ <dd>
1793
+
1794
+ <dl>
1795
+ <dd>
1796
+
1797
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1798
+
1799
+ </dd>
1800
+ </dl>
1801
+
1802
+ <dl>
1803
+ <dd>
1804
+
1805
+ **limit:** `Integer` — Maximum number of statements per page
1806
+
1807
+ </dd>
1808
+ </dl>
1809
+
1810
+ <dl>
1811
+ <dd>
1812
+
1813
+ **page:** `Integer` — Page number to retrieve (starts at 1)
1814
+
1815
+ </dd>
1816
+ </dl>
1817
+
1818
+ <dl>
1819
+ <dd>
1820
+
1821
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1822
+
1823
+ </dd>
1824
+ </dl>
1825
+ </dd>
1826
+ </dl>
1827
+
1828
+
1829
+ </dd>
1830
+ </dl>
1831
+ </details>
1832
+
1833
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">ensure_payroll_integration_email</a>(employer_id:) -> VitableConnect::Types::PayrollIntegrationEmailResponse</code></summary>
1834
+ <dl>
1835
+ <dd>
1836
+
1837
+ #### 📝 Description
1838
+
1839
+ <dl>
1840
+ <dd>
1841
+
1842
+ <dl>
1843
+ <dd>
1844
+
1845
+ Provision and return the employer's payroll integration email.
1846
+ </dd>
1847
+ </dl>
1848
+ </dd>
1849
+ </dl>
1850
+
1851
+ #### 🔌 Usage
1852
+
1853
+ <dl>
1854
+ <dd>
1855
+
1856
+ <dl>
1857
+ <dd>
1858
+
1859
+ ```ruby
1860
+ client.employers.ensure_payroll_integration_email(employer_id: "empr_abc123def456")
1861
+ ```
1862
+ </dd>
1863
+ </dl>
1864
+ </dd>
1865
+ </dl>
1866
+
1867
+ #### ⚙️ Parameters
1868
+
1869
+ <dl>
1870
+ <dd>
1871
+
1872
+ <dl>
1873
+ <dd>
1874
+
1875
+ **employer_id:** `String`
1876
+
1877
+ </dd>
1878
+ </dl>
1879
+
1880
+ <dl>
1881
+ <dd>
1882
+
1883
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1884
+
1885
+ </dd>
1886
+ </dl>
1887
+ </dd>
1888
+ </dl>
1889
+
1890
+
1891
+ </dd>
1892
+ </dl>
1893
+ </details>
1894
+
1895
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">update_settings</a>(employer_id:, request) -> VitableConnect::Types::EmployerSettingsResponse</code></summary>
1896
+ <dl>
1897
+ <dd>
1898
+
1899
+ #### 📝 Description
1900
+
1901
+ <dl>
1902
+ <dd>
1903
+
1904
+ <dl>
1905
+ <dd>
1906
+
1907
+ Updates configuration settings for a specific employer. The employer must belong to the authenticated organization.
1908
+ </dd>
1909
+ </dl>
1910
+ </dd>
1911
+ </dl>
1912
+
1913
+ #### 🔌 Usage
1914
+
1915
+ <dl>
1916
+ <dd>
1917
+
1918
+ <dl>
1919
+ <dd>
1920
+
1921
+ ```ruby
1922
+ client.employers.update_settings(
1923
+ employer_id: "empr_abc123def456",
1924
+ pay_frequency: "bi_weekly"
1925
+ )
1926
+ ```
1927
+ </dd>
1928
+ </dl>
1929
+ </dd>
1930
+ </dl>
1931
+
1932
+ #### ⚙️ Parameters
1933
+
1934
+ <dl>
1935
+ <dd>
1936
+
1937
+ <dl>
1938
+ <dd>
1939
+
1940
+ **employer_id:** `String` — Unique employer identifier (empr_*)
1941
+
1942
+ </dd>
1943
+ </dl>
1944
+
1945
+ <dl>
1946
+ <dd>
1947
+
1948
+ **pay_frequency:** `VitableConnect::Types::DeductionFrequency`
1949
+
1950
+ </dd>
1951
+ </dl>
1952
+
1953
+ <dl>
1954
+ <dd>
1955
+
1956
+ **request_options:** `VitableConnect::Employers::RequestOptions`
1957
+
1958
+ </dd>
1959
+ </dl>
1960
+ </dd>
1961
+ </dl>
1962
+
1963
+
1964
+ </dd>
1965
+ </dl>
1966
+ </details>
1967
+
1968
+ <details><summary><code>client.employers.<a href="/lib/VitableConnect/employers/client.rb">list_hris_providers</a>() -> VitableConnect::Types::OrganizationHrisProvidersResponse</code></summary>
1969
+ <dl>
1970
+ <dd>
1971
+
1972
+ #### 📝 Description
1973
+
1974
+ <dl>
1975
+ <dd>
1976
+
1977
+ <dl>
1978
+ <dd>
1979
+
1980
+ 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 — filter on `provider`, show `provider_label`. The stored providers are free text, so they cannot be enumerated in advance.
1981
+ </dd>
1982
+ </dl>
1983
+ </dd>
1984
+ </dl>
1985
+
1986
+ #### 🔌 Usage
1987
+
1988
+ <dl>
1989
+ <dd>
1990
+
1991
+ <dl>
1992
+ <dd>
1993
+
1994
+ ```ruby
1995
+ client.employers.list_hris_providers
1996
+ ```
1997
+ </dd>
1998
+ </dl>
1999
+ </dd>
2000
+ </dl>
2001
+
2002
+ #### ⚙️ Parameters
2003
+
2004
+ <dl>
2005
+ <dd>
2006
+
2007
+ <dl>
2008
+ <dd>
2009
+
2010
+ **request_options:** `VitableConnect::Employers::RequestOptions`
2011
+
2012
+ </dd>
2013
+ </dl>
2014
+ </dd>
2015
+ </dl>
2016
+
2017
+
2018
+ </dd>
2019
+ </dl>
2020
+ </details>
2021
+
2022
+ ## Enrollments
2023
+ <details><summary><code>client.enrollments.<a href="/lib/VitableConnect/enrollments/client.rb">get</a>(enrollment_id:) -> VitableConnect::Types::EnrollmentResponse</code></summary>
2024
+ <dl>
2025
+ <dd>
2026
+
2027
+ #### 📝 Description
2028
+
2029
+ <dl>
2030
+ <dd>
2031
+
2032
+ <dl>
2033
+ <dd>
2034
+
2035
+ Retrieves a single enrollment: the employee and employer it belongs to, the benefit product, its status, the coverage period, the employee payroll deduction and employer contribution, and the enrolled plan's Summary of Benefits and Coverage document when one is on file. An enrollment the caller cannot reach is indistinguishable from one that does not exist.
2036
+ </dd>
2037
+ </dl>
2038
+ </dd>
2039
+ </dl>
2040
+
2041
+ #### 🔌 Usage
2042
+
2043
+ <dl>
2044
+ <dd>
2045
+
2046
+ <dl>
2047
+ <dd>
2048
+
2049
+ ```ruby
2050
+ client.enrollments.get(enrollment_id: "enrl_AAAAAAAAAAAAAAAAAAAAAQ")
2051
+ ```
2052
+ </dd>
2053
+ </dl>
2054
+ </dd>
2055
+ </dl>
2056
+
2057
+ #### ⚙️ Parameters
2058
+
2059
+ <dl>
2060
+ <dd>
2061
+
2062
+ <dl>
2063
+ <dd>
2064
+
2065
+ **enrollment_id:** `String` — Unique enrollment identifier (enrl_*)
2066
+
2067
+ </dd>
2068
+ </dl>
2069
+
2070
+ <dl>
2071
+ <dd>
2072
+
2073
+ **request_options:** `VitableConnect::Enrollments::RequestOptions`
2074
+
2075
+ </dd>
2076
+ </dl>
2077
+ </dd>
2078
+ </dl>
2079
+
2080
+
2081
+ </dd>
2082
+ </dl>
2083
+ </details>
2084
+
2085
+ <details><summary><code>client.enrollments.<a href="/lib/VitableConnect/enrollments/client.rb">reissue</a>(enrollment_id:, request) -> VitableConnect::Types::ReissueEnrollmentResponse</code></summary>
2086
+ <dl>
2087
+ <dd>
2088
+
2089
+ #### 📝 Description
2090
+
2091
+ <dl>
2092
+ <dd>
2093
+
2094
+ <dl>
2095
+ <dd>
2096
+
2097
+ Closes the targeted enrollment and creates a new unanswered enrollment for the same member and plan year. VPC never requires a qualifying life event; other products require an accepted, member-owned event outside open enrollment. User-backed callers must provide a reason; it is optional for organization API-key callers. Tenant mismatches return a non-disclosing 404 before the request body is validated.
2098
+ </dd>
2099
+ </dl>
2100
+ </dd>
2101
+ </dl>
2102
+
2103
+ #### 🔌 Usage
2104
+
2105
+ <dl>
2106
+ <dd>
2107
+
2108
+ <dl>
2109
+ <dd>
2110
+
2111
+ ```ruby
2112
+ client.enrollments.reissue(
2113
+ enrollment_id: "enrl_AAAAAAAAAAAAAAAAAAAAAQ",
2114
+ reason: "Member needs a new election after a qualifying event.",
2115
+ ticket_number: "BPT-1234",
2116
+ qualifying_life_event_id: "qle_AAAAAAAAAAAAAAAAAAAAAQ"
2117
+ )
2118
+ ```
2119
+ </dd>
2120
+ </dl>
2121
+ </dd>
2122
+ </dl>
2123
+
2124
+ #### ⚙️ Parameters
2125
+
2126
+ <dl>
2127
+ <dd>
2128
+
2129
+ <dl>
2130
+ <dd>
2131
+
2132
+ **enrollment_id:** `String` — Unique enrollment identifier (enrl_*)
2133
+
2134
+ </dd>
2135
+ </dl>
2136
+
2137
+ <dl>
2138
+ <dd>
2139
+
2140
+ **reason:** `String` — Audit reason for the reissue; required for user-backed callers and optional for long-lived organization API-key callers
2141
+
2142
+ </dd>
2143
+ </dl>
2144
+
2145
+ <dl>
2146
+ <dd>
2147
+
2148
+ **ticket_number:** `String` — Optional support or operational ticket number
2149
+
2150
+ </dd>
2151
+ </dl>
2152
+
2153
+ <dl>
2154
+ <dd>
2155
+
2156
+ **qualifying_life_event_id:** `String` — Accepted member qualifying life event identifier (qle_*)
2157
+
2158
+ </dd>
2159
+ </dl>
2160
+
2161
+ <dl>
2162
+ <dd>
2163
+
2164
+ **request_options:** `VitableConnect::Enrollments::RequestOptions`
2165
+
2166
+ </dd>
2167
+ </dl>
2168
+ </dd>
2169
+ </dl>
2170
+
2171
+
2172
+ </dd>
2173
+ </dl>
2174
+ </details>
2175
+
2176
+ <details><summary><code>client.enrollments.<a href="/lib/VitableConnect/enrollments/client.rb">terminate</a>(enrollment_id:, request) -> </code></summary>
2177
+ <dl>
2178
+ <dd>
2179
+
2180
+ #### 📝 Description
2181
+
2182
+ <dl>
2183
+ <dd>
2184
+
2185
+ <dl>
2186
+ <dd>
2187
+
2188
+ Terminates enrolled coverage immediately. An accepted qualifying life event owned by the enrollment member is required unless the plan is VPC or ICHRA. User-backed callers must provide a reason; it is optional for organization API-key callers. API keys may act across the caller organization's book. Tenant mismatches return the same non-disclosing 404 before the request body is validated.
2189
+ </dd>
2190
+ </dl>
2191
+ </dd>
2192
+ </dl>
2193
+
2194
+ #### 🔌 Usage
2195
+
2196
+ <dl>
2197
+ <dd>
2198
+
2199
+ <dl>
2200
+ <dd>
2201
+
2202
+ ```ruby
2203
+ client.enrollments.terminate(
2204
+ enrollment_id: "enrl_AAAAAAAAAAAAAAAAAAAAAQ",
2205
+ reason: "Member requested coverage termination after a qualifying event.",
2206
+ ticket_number: "BPT-1234",
2207
+ qualifying_life_event_id: "qle_AAAAAAAAAAAAAAAAAAAAAQ"
2208
+ )
2209
+ ```
2210
+ </dd>
2211
+ </dl>
2212
+ </dd>
2213
+ </dl>
2214
+
2215
+ #### ⚙️ Parameters
2216
+
2217
+ <dl>
2218
+ <dd>
2219
+
2220
+ <dl>
2221
+ <dd>
2222
+
2223
+ **enrollment_id:** `String` — Unique enrollment identifier (enrl_*)
2224
+
2225
+ </dd>
2226
+ </dl>
2227
+
2228
+ <dl>
2229
+ <dd>
2230
+
2231
+ **reason:** `String` — Audit reason for the termination; required for user-backed callers and optional for long-lived organization API-key callers
2232
+
2233
+ </dd>
2234
+ </dl>
2235
+
2236
+ <dl>
2237
+ <dd>
2238
+
2239
+ **ticket_number:** `String` — Optional support or operational ticket number
2240
+
2241
+ </dd>
2242
+ </dl>
2243
+
2244
+ <dl>
2245
+ <dd>
2246
+
2247
+ **qualifying_life_event_id:** `String` — Accepted member qualifying life event identifier (qle_*)
2248
+
2249
+ </dd>
2250
+ </dl>
2251
+
2252
+ <dl>
2253
+ <dd>
2254
+
2255
+ **request_options:** `VitableConnect::Enrollments::RequestOptions`
2256
+
2257
+ </dd>
2258
+ </dl>
2259
+ </dd>
2260
+ </dl>
2261
+
2262
+
2263
+ </dd>
2264
+ </dl>
2265
+ </details>
2266
+
2267
+ ## Groups
2268
+ <details><summary><code>client.groups.<a href="/lib/VitableConnect/groups/client.rb">list</a>() -> VitableConnect::Types::GroupListResponse</code></summary>
2269
+ <dl>
2270
+ <dd>
2271
+
2272
+ #### 📝 Description
2273
+
2274
+ <dl>
2275
+ <dd>
2276
+
2277
+ <dl>
2278
+ <dd>
2279
+
2280
+ Returns a paginated list of groups belonging to the authenticated organization.
2281
+ </dd>
2282
+ </dl>
2283
+ </dd>
2284
+ </dl>
2285
+
2286
+ #### 🔌 Usage
2287
+
2288
+ <dl>
2289
+ <dd>
2290
+
2291
+ <dl>
2292
+ <dd>
2293
+
2294
+ ```ruby
2295
+ client.groups.list(
2296
+ limit: 20,
2297
+ page: 1
2298
+ )
2299
+ ```
2300
+ </dd>
2301
+ </dl>
2302
+ </dd>
2303
+ </dl>
2304
+
2305
+ #### ⚙️ Parameters
2306
+
2307
+ <dl>
2308
+ <dd>
2309
+
2310
+ <dl>
2311
+ <dd>
2312
+
2313
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
2314
+
2315
+ </dd>
2316
+ </dl>
2317
+
2318
+ <dl>
2319
+ <dd>
2320
+
2321
+ **page:** `Integer` — Page number (default: 1)
2322
+
2323
+ </dd>
2324
+ </dl>
2325
+
2326
+ <dl>
2327
+ <dd>
2328
+
2329
+ **request_options:** `VitableConnect::Groups::RequestOptions`
2330
+
2331
+ </dd>
2332
+ </dl>
2333
+ </dd>
2334
+ </dl>
2335
+
2336
+
2337
+ </dd>
2338
+ </dl>
2339
+ </details>
2340
+
2341
+ <details><summary><code>client.groups.<a href="/lib/VitableConnect/groups/client.rb">create</a>(request) -> VitableConnect::Types::GroupResponse</code></summary>
2342
+ <dl>
2343
+ <dd>
2344
+
2345
+ #### 📝 Description
2346
+
2347
+ <dl>
2348
+ <dd>
2349
+
2350
+ <dl>
2351
+ <dd>
2352
+
2353
+ Creates a new group scoped to the authenticated organization.
2354
+ </dd>
2355
+ </dl>
2356
+ </dd>
2357
+ </dl>
2358
+
2359
+ #### 🔌 Usage
2360
+
2361
+ <dl>
2362
+ <dd>
2363
+
2364
+ <dl>
2365
+ <dd>
2366
+
2367
+ ```ruby
2368
+ client.groups.create(
2369
+ name: "Tier 1",
2370
+ external_reference_id: "mol_seg_001"
2371
+ )
2372
+ ```
2373
+ </dd>
2374
+ </dl>
2375
+ </dd>
2376
+ </dl>
2377
+
2378
+ #### ⚙️ Parameters
2379
+
2380
+ <dl>
2381
+ <dd>
2382
+
2383
+ <dl>
2384
+ <dd>
2385
+
2386
+ **name:** `String` — Display name for the group.
2387
+
2388
+ </dd>
2389
+ </dl>
2390
+
2391
+ <dl>
2392
+ <dd>
2393
+
2394
+ **external_reference_id:** `String` — Your own identifier for this group. Use it to correlate the group with a record in your system; it must be unique within your organization.
2395
+
2396
+ </dd>
2397
+ </dl>
2398
+
2399
+ <dl>
2400
+ <dd>
2401
+
2402
+ **request_options:** `VitableConnect::Groups::RequestOptions`
2403
+
2404
+ </dd>
2405
+ </dl>
2406
+ </dd>
2407
+ </dl>
2408
+
2409
+
2410
+ </dd>
2411
+ </dl>
2412
+ </details>
2413
+
2414
+ <details><summary><code>client.groups.<a href="/lib/VitableConnect/groups/client.rb">get</a>(group_id:) -> VitableConnect::Types::GroupResponse</code></summary>
2415
+ <dl>
2416
+ <dd>
2417
+
2418
+ #### 📝 Description
2419
+
2420
+ <dl>
2421
+ <dd>
2422
+
2423
+ <dl>
2424
+ <dd>
2425
+
2426
+ Retrieves a single group by its prefixed ID. Returns 404 if the group does not belong to the authenticated organization.
2427
+ </dd>
2428
+ </dl>
2429
+ </dd>
2430
+ </dl>
2431
+
2432
+ #### 🔌 Usage
2433
+
2434
+ <dl>
2435
+ <dd>
2436
+
2437
+ <dl>
2438
+ <dd>
2439
+
2440
+ ```ruby
2441
+ client.groups.get(group_id: "grp_abc123def456")
2442
+ ```
2443
+ </dd>
2444
+ </dl>
2445
+ </dd>
2446
+ </dl>
2447
+
2448
+ #### ⚙️ Parameters
2449
+
2450
+ <dl>
2451
+ <dd>
2452
+
2453
+ <dl>
2454
+ <dd>
2455
+
2456
+ **group_id:** `String` — Unique group identifier (grp_*)
2457
+
2458
+ </dd>
2459
+ </dl>
2460
+
2461
+ <dl>
2462
+ <dd>
2463
+
2464
+ **request_options:** `VitableConnect::Groups::RequestOptions`
2465
+
2466
+ </dd>
2467
+ </dl>
2468
+ </dd>
2469
+ </dl>
2470
+
2471
+
2472
+ </dd>
2473
+ </dl>
2474
+ </details>
2475
+
2476
+ <details><summary><code>client.groups.<a href="/lib/VitableConnect/groups/client.rb">update</a>(group_id:, request) -> VitableConnect::Types::GroupResponse</code></summary>
2477
+ <dl>
2478
+ <dd>
2479
+
2480
+ #### 📝 Description
2481
+
2482
+ <dl>
2483
+ <dd>
2484
+
2485
+ <dl>
2486
+ <dd>
2487
+
2488
+ Partially updates a group's name or external reference ID. Returns 404 if the group does not belong to the authenticated organization.
2489
+ </dd>
2490
+ </dl>
2491
+ </dd>
2492
+ </dl>
2493
+
2494
+ #### 🔌 Usage
2495
+
2496
+ <dl>
2497
+ <dd>
2498
+
2499
+ <dl>
2500
+ <dd>
2501
+
2502
+ ```ruby
2503
+ client.groups.update(
2504
+ group_id: "grp_abc123def456",
2505
+ name: "Tier 1 (renamed)",
2506
+ external_reference_id: "mol_seg_001_v2"
2507
+ )
2508
+ ```
2509
+ </dd>
2510
+ </dl>
2511
+ </dd>
2512
+ </dl>
2513
+
2514
+ #### ⚙️ Parameters
2515
+
2516
+ <dl>
2517
+ <dd>
2518
+
2519
+ <dl>
2520
+ <dd>
2521
+
2522
+ **group_id:** `String` — Unique group identifier (grp_*)
2523
+
2524
+ </dd>
2525
+ </dl>
2526
+
2527
+ <dl>
2528
+ <dd>
2529
+
2530
+ **name:** `String` — New display name for the group. Omit to leave unchanged.
2531
+
2532
+ </dd>
2533
+ </dl>
2534
+
2535
+ <dl>
2536
+ <dd>
2537
+
2538
+ **external_reference_id:** `String` — New external reference ID for the group. Omit to leave unchanged.
2539
+
2540
+ </dd>
2541
+ </dl>
2542
+
2543
+ <dl>
2544
+ <dd>
2545
+
2546
+ **request_options:** `VitableConnect::Groups::RequestOptions`
2547
+
2548
+ </dd>
2549
+ </dl>
2550
+ </dd>
2551
+ </dl>
2552
+
2553
+
2554
+ </dd>
2555
+ </dl>
2556
+ </details>
2557
+
2558
+ ## Members
2559
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">get</a>(member_id:) -> VitableConnect::Types::MemberResponse</code></summary>
2560
+ <dl>
2561
+ <dd>
2562
+
2563
+ #### 📝 Description
2564
+
2565
+ <dl>
2566
+ <dd>
2567
+
2568
+ <dl>
2569
+ <dd>
2570
+
2571
+ Retrieves a member's profile by ID — identity, demographics, address, contact details, tobacco status, and profile status. Access is scoped to the authenticated principal; a member not visible to the caller returns a 404.
2572
+ </dd>
2573
+ </dl>
2574
+ </dd>
2575
+ </dl>
2576
+
2577
+ #### 🔌 Usage
2578
+
2579
+ <dl>
2580
+ <dd>
2581
+
2582
+ <dl>
2583
+ <dd>
2584
+
2585
+ ```ruby
2586
+ client.members.get(member_id: "mbr_abc123def456")
2587
+ ```
2588
+ </dd>
2589
+ </dl>
2590
+ </dd>
2591
+ </dl>
2592
+
2593
+ #### ⚙️ Parameters
2594
+
2595
+ <dl>
2596
+ <dd>
2597
+
2598
+ <dl>
2599
+ <dd>
2600
+
2601
+ **member_id:** `String` — Unique member identifier (mbr_*)
2602
+
2603
+ </dd>
2604
+ </dl>
2605
+
2606
+ <dl>
2607
+ <dd>
2608
+
2609
+ **request_options:** `VitableConnect::Members::RequestOptions`
2610
+
2611
+ </dd>
2612
+ </dl>
2613
+ </dd>
2614
+ </dl>
2615
+
2616
+
2617
+ </dd>
2618
+ </dl>
2619
+ </details>
2620
+
2621
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list_dependents</a>(member_id:) -> VitableConnect::Types::MemberDependentsResponse</code></summary>
2622
+ <dl>
2623
+ <dd>
2624
+
2625
+ #### 📝 Description
2626
+
2627
+ <dl>
2628
+ <dd>
2629
+
2630
+ <dl>
2631
+ <dd>
2632
+
2633
+ Lists a member's active legal dependents — name, relationship, date of birth, age, and sex at birth. Access is scoped to the authenticated principal; a member not visible to the caller returns a 404.
2634
+ </dd>
2635
+ </dl>
2636
+ </dd>
2637
+ </dl>
2638
+
2639
+ #### 🔌 Usage
2640
+
2641
+ <dl>
2642
+ <dd>
2643
+
2644
+ <dl>
2645
+ <dd>
2646
+
2647
+ ```ruby
2648
+ client.members.list_dependents(member_id: "mbr_abc123def456")
2649
+ ```
2650
+ </dd>
2651
+ </dl>
2652
+ </dd>
2653
+ </dl>
2654
+
2655
+ #### ⚙️ Parameters
2656
+
2657
+ <dl>
2658
+ <dd>
2659
+
2660
+ <dl>
2661
+ <dd>
2662
+
2663
+ **member_id:** `String`
2664
+
2665
+ </dd>
2666
+ </dl>
2667
+
2668
+ <dl>
2669
+ <dd>
2670
+
2671
+ **request_options:** `VitableConnect::Members::RequestOptions`
2672
+
2673
+ </dd>
2674
+ </dl>
2675
+ </dd>
2676
+ </dl>
2677
+
2678
+
2679
+ </dd>
2680
+ </dl>
2681
+ </details>
2682
+
2683
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list_employments</a>(member_id:) -> VitableConnect::Types::MemberEmploymentsResponse</code></summary>
2684
+ <dl>
2685
+ <dd>
2686
+
2687
+ #### 📝 Description
2688
+
2689
+ <dl>
2690
+ <dd>
2691
+
2692
+ <dl>
2693
+ <dd>
2694
+
2695
+ Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404.
2696
+ </dd>
2697
+ </dl>
2698
+ </dd>
2699
+ </dl>
2700
+
2701
+ #### 🔌 Usage
2702
+
2703
+ <dl>
2704
+ <dd>
2705
+
2706
+ <dl>
2707
+ <dd>
2708
+
2709
+ ```ruby
2710
+ client.members.list_employments(member_id: "mbr_abc123def456")
2711
+ ```
2712
+ </dd>
2713
+ </dl>
2714
+ </dd>
2715
+ </dl>
2716
+
2717
+ #### ⚙️ Parameters
2718
+
2719
+ <dl>
2720
+ <dd>
2721
+
2722
+ <dl>
2723
+ <dd>
2724
+
2725
+ **member_id:** `String`
2726
+
2727
+ </dd>
2728
+ </dl>
2729
+
2730
+ <dl>
2731
+ <dd>
2732
+
2733
+ **request_options:** `VitableConnect::Members::RequestOptions`
2734
+
2735
+ </dd>
2736
+ </dl>
2737
+ </dd>
2738
+ </dl>
2739
+
2740
+
2741
+ </dd>
2742
+ </dl>
2743
+ </details>
2744
+
2745
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list_enrollments</a>(member_id:) -> VitableConnect::Types::MemberEnrollmentsResponse</code></summary>
2746
+ <dl>
2747
+ <dd>
2748
+
2749
+ #### 📝 Description
2750
+
2751
+ <dl>
2752
+ <dd>
2753
+
2754
+ <dl>
2755
+ <dd>
2756
+
2757
+ Lists a member's benefit enrollments across every employer — benefit type and product, employer, carrier, plan, tier, employee deduction, employer contribution and total premium, the individual enrollment coverage boundary (`coverage_end`), the separate pre-effective cancellation boundary (`cancelled_date`), and the distinct benefit plan-year boundary (`plan_year_coverage_end`) used to determine whether the plan year itself has ended, the date the enrollment record was created (`issued_date`, the value Ops labels Issued on, reported for every row whatever the member answered), the window the member could answer in -- which never opens before the enrollment was issued, so a row issued mid-open-enrollment starts its window on its issue date -- whether a qualifying life event would currently be required for reissue under the product/open-enrollment rule, enrollment/open-enrollment window, and two statuses: `election_status` (what the member answered) and `policy_status` (what became of their coverage, null unless they enrolled). Every row includes a stable enrollment ID and the exact employer and benefit plan-year IDs used to fetch that row's plan-year detail. The full list is returned across all states so the client derives active plans (effective and upcoming) and the enrollment history from those per-row statuses. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all enrollments. A member not visible to the caller returns a 404.
2758
+ </dd>
2759
+ </dl>
2760
+ </dd>
2761
+ </dl>
2762
+
2763
+ #### 🔌 Usage
2764
+
2765
+ <dl>
2766
+ <dd>
2767
+
2768
+ <dl>
2769
+ <dd>
2770
+
2771
+ ```ruby
2772
+ client.members.list_enrollments(member_id: "mbr_abc123def456")
2773
+ ```
2774
+ </dd>
2775
+ </dl>
2776
+ </dd>
2777
+ </dl>
2778
+
2779
+ #### ⚙️ Parameters
2780
+
2781
+ <dl>
2782
+ <dd>
2783
+
2784
+ <dl>
2785
+ <dd>
2786
+
2787
+ **member_id:** `String`
2788
+
2789
+ </dd>
2790
+ </dl>
2791
+
2792
+ <dl>
2793
+ <dd>
2794
+
2795
+ **request_options:** `VitableConnect::Members::RequestOptions`
2796
+
2797
+ </dd>
2798
+ </dl>
2799
+ </dd>
2800
+ </dl>
2801
+
2802
+
2803
+ </dd>
2804
+ </dl>
2805
+ </details>
2806
+
2807
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">get_household</a>(member_id:) -> VitableConnect::Types::HouseholdMembersResponse</code></summary>
2808
+ <dl>
2809
+ <dd>
2810
+
2811
+ #### 📝 Description
2812
+
2813
+ <dl>
2814
+ <dd>
2815
+
2816
+ <dl>
2817
+ <dd>
2818
+
2819
+ Lists a member's household as a per-participant table — the account holder plus each active household member, with name, relationship, member type, date of birth, and household-admin flag. Access is scoped to the authenticated principal; a member not visible to the caller (or with no household) returns a 404.
2820
+ </dd>
2821
+ </dl>
2822
+ </dd>
2823
+ </dl>
2824
+
2825
+ #### 🔌 Usage
2826
+
2827
+ <dl>
2828
+ <dd>
2829
+
2830
+ <dl>
2831
+ <dd>
2832
+
2833
+ ```ruby
2834
+ client.members.get_household(member_id: "mbr_abc123def456")
2835
+ ```
2836
+ </dd>
2837
+ </dl>
2838
+ </dd>
2839
+ </dl>
2840
+
2841
+ #### ⚙️ Parameters
2842
+
2843
+ <dl>
2844
+ <dd>
2845
+
2846
+ <dl>
2847
+ <dd>
2848
+
2849
+ **member_id:** `String`
2850
+
2851
+ </dd>
2852
+ </dl>
2853
+
2854
+ <dl>
2855
+ <dd>
2856
+
2857
+ **request_options:** `VitableConnect::Members::RequestOptions`
2858
+
2859
+ </dd>
2860
+ </dl>
2861
+ </dd>
2862
+ </dl>
2863
+
2864
+
2865
+ </dd>
2866
+ </dl>
2867
+ </details>
2868
+
2869
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list_id_cards</a>(member_id:) -> VitableConnect::Types::MemberDigitalBenefitCardsResponse</code></summary>
2870
+ <dl>
2871
+ <dd>
2872
+
2873
+ #### 📝 Description
2874
+
2875
+ <dl>
2876
+ <dd>
2877
+
2878
+ <dl>
2879
+ <dd>
2880
+
2881
+ Lists a member's benefit ID cards — card type (medical, dental, vision, or rx), employer, plan, provider network, claims payer, carrier contact details, and the disclaimers printed on the card. Medical, dental and vision cards come from the member's active digital benefit cards; the rx card from the member's Ventegra pharmacy benefit (omitted when the member has no free-medication coverage), which carries no plan, network, or carrier details. Access is scoped to the authenticated principal, and an organization caller sees only cards from employers in its book; a member not visible to the caller returns a 404.
2882
+ </dd>
2883
+ </dl>
2884
+ </dd>
2885
+ </dl>
2886
+
2887
+ #### 🔌 Usage
2888
+
2889
+ <dl>
2890
+ <dd>
2891
+
2892
+ <dl>
2893
+ <dd>
2894
+
2895
+ ```ruby
2896
+ client.members.list_id_cards(member_id: "mbr_abc123def456")
2897
+ ```
2898
+ </dd>
2899
+ </dl>
2900
+ </dd>
2901
+ </dl>
2902
+
2903
+ #### ⚙️ Parameters
2904
+
2905
+ <dl>
2906
+ <dd>
2907
+
2908
+ <dl>
2909
+ <dd>
2910
+
2911
+ **member_id:** `String`
2912
+
2913
+ </dd>
2914
+ </dl>
2915
+
2916
+ <dl>
2917
+ <dd>
2918
+
2919
+ **request_options:** `VitableConnect::Members::RequestOptions`
2920
+
2921
+ </dd>
2922
+ </dl>
2923
+ </dd>
2924
+ </dl>
2925
+
2926
+
2927
+ </dd>
2928
+ </dl>
2929
+ </details>
2930
+
2931
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list_qualifying_life_events</a>(member_id:) -> VitableConnect::Types::MemberQualifyingLifeEventListResponse</code></summary>
2932
+ <dl>
2933
+ <dd>
2934
+
2935
+ #### 📝 Description
2936
+
2937
+ <dl>
2938
+ <dd>
2939
+
2940
+ <dl>
2941
+ <dd>
2942
+
2943
+ Lists a member's qualifying life events, including events already used for another enrollment. Returns all statuses by default; pass the status query param to filter to one (e.g. approved). Events are ordered newest submission first with stable paging. Custom text is present only when submitted and is otherwise null. A member not visible to the caller returns a 404. API keys and unbound access tokens have organization-wide access. Employer-bound tokens require employment at the bound employer, and employee-bound tokens require the exact employee-member relationship. Organization or scope mismatches return a 404 before pagination is validated.
2944
+ </dd>
2945
+ </dl>
2946
+ </dd>
2947
+ </dl>
2948
+
2949
+ #### 🔌 Usage
2950
+
2951
+ <dl>
2952
+ <dd>
2953
+
2954
+ <dl>
2955
+ <dd>
2956
+
2957
+ ```ruby
2958
+ client.members.list_qualifying_life_events(
2959
+ member_id: "mbr_abc123def456",
2960
+ limit: 20,
2961
+ page: 1
2962
+ )
2963
+ ```
2964
+ </dd>
2965
+ </dl>
2966
+ </dd>
2967
+ </dl>
2968
+
2969
+ #### ⚙️ Parameters
2970
+
2971
+ <dl>
2972
+ <dd>
2973
+
2974
+ <dl>
2975
+ <dd>
2976
+
2977
+ **member_id:** `String` — Unique member identifier (mbr_*)
2978
+
2979
+ </dd>
2980
+ </dl>
2981
+
2982
+ <dl>
2983
+ <dd>
2984
+
2985
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
2986
+
2987
+ </dd>
2988
+ </dl>
2989
+
2990
+ <dl>
2991
+ <dd>
2992
+
2993
+ **page:** `Integer` — Page number (default: 1)
2994
+
2995
+ </dd>
2996
+ </dl>
2997
+
2998
+ <dl>
2999
+ <dd>
3000
+
3001
+ **status:** `VitableConnect::Types::Status` — Optional. Filter to a single QLE status; omit to return all statuses.
3002
+
3003
+ </dd>
3004
+ </dl>
3005
+
3006
+ <dl>
3007
+ <dd>
3008
+
3009
+ **request_options:** `VitableConnect::Members::RequestOptions`
3010
+
3011
+ </dd>
3012
+ </dl>
3013
+ </dd>
3014
+ </dl>
3015
+
3016
+
3017
+ </dd>
3018
+ </dl>
3019
+ </details>
3020
+
3021
+ <details><summary><code>client.members.<a href="/lib/VitableConnect/members/client.rb">list</a>() -> VitableConnect::Types::MemberListResponse</code></summary>
3022
+ <dl>
3023
+ <dd>
3024
+
3025
+ #### 📝 Description
3026
+
3027
+ <dl>
3028
+ <dd>
3029
+
3030
+ <dl>
3031
+ <dd>
3032
+
3033
+ Retrieves a paginated list of the members in the authenticated organization's book — identity, contact details, and address. The book covers members reached through an employer in the organization's book as well as members of a group it owns. Supports free-text search (name, email, phone number, or exact member id).
3034
+ </dd>
3035
+ </dl>
3036
+ </dd>
3037
+ </dl>
3038
+
3039
+ #### 🔌 Usage
3040
+
3041
+ <dl>
3042
+ <dd>
3043
+
3044
+ <dl>
3045
+ <dd>
3046
+
3047
+ ```ruby
3048
+ client.members.list(
3049
+ limit: 20,
3050
+ page: 1
3051
+ )
3052
+ ```
3053
+ </dd>
3054
+ </dl>
3055
+ </dd>
3056
+ </dl>
3057
+
3058
+ #### ⚙️ Parameters
3059
+
3060
+ <dl>
3061
+ <dd>
3062
+
3063
+ <dl>
3064
+ <dd>
3065
+
3066
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
3067
+
3068
+ </dd>
3069
+ </dl>
3070
+
3071
+ <dl>
3072
+ <dd>
3073
+
3074
+ **page:** `Integer` — Page number (default: 1)
3075
+
3076
+ </dd>
3077
+ </dl>
3078
+
3079
+ <dl>
3080
+ <dd>
3081
+
3082
+ **search:** `String` — Case-insensitive search across member name, email, and phone number; exact match on member id (prefixed or raw uuid)
3083
+
3084
+ </dd>
3085
+ </dl>
3086
+
3087
+ <dl>
3088
+ <dd>
3089
+
3090
+ **request_options:** `VitableConnect::Members::RequestOptions`
3091
+
3092
+ </dd>
3093
+ </dl>
3094
+ </dd>
3095
+ </dl>
3096
+
3097
+
3098
+ </dd>
3099
+ </dl>
3100
+ </details>
3101
+
3102
+ ## Organizations
3103
+ <details><summary><code>client.organizations.<a href="/lib/VitableConnect/organizations/client.rb">list</a>() -> VitableConnect::Types::OrganizationsListResponse</code></summary>
3104
+ <dl>
3105
+ <dd>
3106
+
3107
+ #### 📝 Description
3108
+
3109
+ <dl>
3110
+ <dd>
3111
+
3112
+ <dl>
3113
+ <dd>
3114
+
3115
+ Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.
3116
+ </dd>
3117
+ </dl>
3118
+ </dd>
3119
+ </dl>
3120
+
3121
+ #### 🔌 Usage
3122
+
3123
+ <dl>
3124
+ <dd>
3125
+
3126
+ <dl>
3127
+ <dd>
3128
+
3129
+ ```ruby
3130
+ client.organizations.list
3131
+ ```
3132
+ </dd>
3133
+ </dl>
3134
+ </dd>
3135
+ </dl>
3136
+
3137
+ #### ⚙️ Parameters
3138
+
3139
+ <dl>
3140
+ <dd>
3141
+
3142
+ <dl>
3143
+ <dd>
3144
+
3145
+ **request_options:** `VitableConnect::Organizations::RequestOptions`
3146
+
3147
+ </dd>
3148
+ </dl>
3149
+ </dd>
3150
+ </dl>
3151
+
3152
+
3153
+ </dd>
3154
+ </dl>
3155
+ </details>
3156
+
3157
+ <details><summary><code>client.organizations.<a href="/lib/VitableConnect/organizations/client.rb">create</a>(request) -> VitableConnect::Types::Organization</code></summary>
3158
+ <dl>
3159
+ <dd>
3160
+
3161
+ #### 📝 Description
3162
+
3163
+ <dl>
3164
+ <dd>
3165
+
3166
+ <dl>
3167
+ <dd>
3168
+
3169
+ Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). 409 `organization_already_exists` when the user already has an organization (v0: one organization per user).
3170
+ </dd>
3171
+ </dl>
3172
+ </dd>
3173
+ </dl>
3174
+
3175
+ #### 🔌 Usage
3176
+
3177
+ <dl>
3178
+ <dd>
3179
+
3180
+ <dl>
3181
+ <dd>
3182
+
3183
+ ```ruby
3184
+ client.organizations.create(
3185
+ name: "Acme Brokerage",
3186
+ type: "BROKERAGE"
3187
+ )
3188
+ ```
3189
+ </dd>
3190
+ </dl>
3191
+ </dd>
3192
+ </dl>
3193
+
3194
+ #### ⚙️ Parameters
3195
+
3196
+ <dl>
3197
+ <dd>
3198
+
3199
+ <dl>
3200
+ <dd>
3201
+
3202
+ **name:** `String` — Legal or trading name of the organization.
3203
+
3204
+ </dd>
3205
+ </dl>
3206
+
3207
+ <dl>
3208
+ <dd>
3209
+
3210
+ **type:** `VitableConnect::Types::CreateOrganizationRequestType` — Category of organization being onboarded.
3211
+
3212
+ </dd>
3213
+ </dl>
3214
+
3215
+ <dl>
3216
+ <dd>
3217
+
3218
+ **request_options:** `VitableConnect::Organizations::RequestOptions`
3219
+
3220
+ </dd>
3221
+ </dl>
3222
+ </dd>
3223
+ </dl>
3224
+
3225
+
3226
+ </dd>
3227
+ </dl>
3228
+ </details>
3229
+
3230
+ ## Plans
3231
+ <details><summary><code>client.plans.<a href="/lib/VitableConnect/plans/client.rb">list</a>() -> VitableConnect::Types::PlanListResponse</code></summary>
3232
+ <dl>
3233
+ <dd>
3234
+
3235
+ #### 📝 Description
3236
+
3237
+ <dl>
3238
+ <dd>
3239
+
3240
+ <dl>
3241
+ <dd>
3242
+
3243
+ Returns a paginated list of benefit plans linked to the authenticated organization.
3244
+ </dd>
3245
+ </dl>
3246
+ </dd>
3247
+ </dl>
3248
+
3249
+ #### 🔌 Usage
3250
+
3251
+ <dl>
3252
+ <dd>
3253
+
3254
+ <dl>
3255
+ <dd>
3256
+
3257
+ ```ruby
3258
+ client.plans.list(
3259
+ limit: 20,
3260
+ page: 1
3261
+ )
3262
+ ```
3263
+ </dd>
3264
+ </dl>
3265
+ </dd>
3266
+ </dl>
3267
+
3268
+ #### ⚙️ Parameters
3269
+
3270
+ <dl>
3271
+ <dd>
3272
+
3273
+ <dl>
3274
+ <dd>
3275
+
3276
+ **limit:** `Integer` — Items per page (default: 20, max: 100)
3277
+
3278
+ </dd>
3279
+ </dl>
3280
+
3281
+ <dl>
3282
+ <dd>
3283
+
3284
+ **page:** `Integer` — Page number (default: 1)
3285
+
3286
+ </dd>
3287
+ </dl>
3288
+
3289
+ <dl>
3290
+ <dd>
3291
+
3292
+ **request_options:** `VitableConnect::Plans::RequestOptions`
3293
+
3294
+ </dd>
3295
+ </dl>
3296
+ </dd>
3297
+ </dl>
3298
+
3299
+
3300
+ </dd>
3301
+ </dl>
3302
+ </details>
3303
+
3304
+ ## Webhook Events
3305
+ <details><summary><code>client.webhook_events.<a href="/lib/VitableConnect/webhook_events/client.rb">list</a>() -> VitableConnect::Types::WebhookEventListResponse</code></summary>
3306
+ <dl>
3307
+ <dd>
3308
+
3309
+ #### 📝 Description
3310
+
3311
+ <dl>
3312
+ <dd>
3313
+
3314
+ <dl>
3315
+ <dd>
3316
+
3317
+ Retrieves a paginated list of webhook events for the authenticated organization. Supports filtering by event name, resource type, resource ID, and date range.
3318
+ </dd>
3319
+ </dl>
3320
+ </dd>
3321
+ </dl>
3322
+
3323
+ #### 🔌 Usage
3324
+
3325
+ <dl>
3326
+ <dd>
3327
+
3328
+ <dl>
3329
+ <dd>
3330
+
3331
+ ```ruby
3332
+ client.webhook_events.list(
3333
+ limit: 20,
3334
+ page: 1
3335
+ )
3336
+ ```
3337
+ </dd>
3338
+ </dl>
3339
+ </dd>
3340
+ </dl>
3341
+
3342
+ #### ⚙️ Parameters
3343
+
3344
+ <dl>
3345
+ <dd>
3346
+
3347
+ <dl>
3348
+ <dd>
3349
+
3350
+ **created_after:** `String`
3351
+
3352
+ </dd>
3353
+ </dl>
3354
+
3355
+ <dl>
3356
+ <dd>
3357
+
3358
+ **created_before:** `String`
3359
+
3360
+ </dd>
3361
+ </dl>
3362
+
3363
+ <dl>
3364
+ <dd>
3365
+
3366
+ **event_name:** `VitableConnect::Types::EventName`
3367
+
3368
+ * `enrollment.accepted` - Enrollment Accepted
3369
+ * `enrollment.terminated` - Enrollment Terminated
3370
+ * `enrollment.termination_rescheduled` - Enrollment Termination Rescheduled
3371
+ * `enrollment.elected` - Enrollment Elected
3372
+ * `enrollment.granted` - Enrollment Granted
3373
+ * `enrollment.waived` - Enrollment Waived
3374
+ * `enrollment.started` - Enrollment Started
3375
+ * `employee.eligibility_granted` - Employee Eligibility Granted
3376
+ * `employee.eligibility_terminated` - Employee Eligibility Terminated
3377
+ * `employee.deactivated` - Employee Deactivated
3378
+ * `employee.deduction_created` - Employee Deduction Created
3379
+
3380
+ </dd>
3381
+ </dl>
3382
+
3383
+ <dl>
3384
+ <dd>
3385
+
3386
+ **limit:** `Integer`
3387
+
3388
+ </dd>
3389
+ </dl>
3390
+
3391
+ <dl>
3392
+ <dd>
3393
+
3394
+ **page:** `Integer`
3395
+
3396
+ </dd>
3397
+ </dl>
3398
+
3399
+ <dl>
3400
+ <dd>
3401
+
3402
+ **resource_id:** `String`
3403
+
3404
+ </dd>
3405
+ </dl>
3406
+
3407
+ <dl>
3408
+ <dd>
3409
+
3410
+ **resource_type:** `VitableConnect::Types::ResourceType`
3411
+
3412
+ * `enrollment` - Enrollment
3413
+ * `employee` - Employee
3414
+ * `employer` - Employer
3415
+ * `dependent` - Dependent
3416
+ * `plan_year` - Plan Year
3417
+ * `payroll_deduction` - Payroll Deduction
3418
+
3419
+ </dd>
3420
+ </dl>
3421
+
3422
+ <dl>
3423
+ <dd>
3424
+
3425
+ **request_options:** `VitableConnect::WebhookEvents::RequestOptions`
3426
+
3427
+ </dd>
3428
+ </dl>
3429
+ </dd>
3430
+ </dl>
3431
+
3432
+
3433
+ </dd>
3434
+ </dl>
3435
+ </details>
3436
+
3437
+ <details><summary><code>client.webhook_events.<a href="/lib/VitableConnect/webhook_events/client.rb">get</a>(event_id:) -> VitableConnect::Types::WebhookEventResponse</code></summary>
3438
+ <dl>
3439
+ <dd>
3440
+
3441
+ #### 📝 Description
3442
+
3443
+ <dl>
3444
+ <dd>
3445
+
3446
+ <dl>
3447
+ <dd>
3448
+
3449
+ Retrieves a single webhook event by its prefixed ID. Returns 404 if the event does not exist or belongs to a different organization.
3450
+ </dd>
3451
+ </dl>
3452
+ </dd>
3453
+ </dl>
3454
+
3455
+ #### 🔌 Usage
3456
+
3457
+ <dl>
3458
+ <dd>
3459
+
3460
+ <dl>
3461
+ <dd>
3462
+
3463
+ ```ruby
3464
+ client.webhook_events.get(event_id: "event_id")
3465
+ ```
3466
+ </dd>
3467
+ </dl>
3468
+ </dd>
3469
+ </dl>
3470
+
3471
+ #### ⚙️ Parameters
3472
+
3473
+ <dl>
3474
+ <dd>
3475
+
3476
+ <dl>
3477
+ <dd>
3478
+
3479
+ **event_id:** `String`
3480
+
3481
+ </dd>
3482
+ </dl>
3483
+
3484
+ <dl>
3485
+ <dd>
3486
+
3487
+ **request_options:** `VitableConnect::WebhookEvents::RequestOptions`
3488
+
3489
+ </dd>
3490
+ </dl>
3491
+ </dd>
3492
+ </dl>
3493
+
3494
+
3495
+ </dd>
3496
+ </dl>
3497
+ </details>
3498
+
3499
+ <details><summary><code>client.webhook_events.<a href="/lib/VitableConnect/webhook_events/client.rb">list_deliveries</a>(event_id:) -> VitableConnect::Types::ListWebhookEventDeliveriesResponse</code></summary>
3500
+ <dl>
3501
+ <dd>
3502
+
3503
+ #### 📝 Description
3504
+
3505
+ <dl>
3506
+ <dd>
3507
+
3508
+ <dl>
3509
+ <dd>
3510
+
3511
+ Retrieves all delivery attempts for a webhook event. Returns up to 100 deliveries. Each delivery includes a computed status field (Pending, In Progress, Delivered, or Failed).
3512
+ </dd>
3513
+ </dl>
3514
+ </dd>
3515
+ </dl>
3516
+
3517
+ #### 🔌 Usage
3518
+
3519
+ <dl>
3520
+ <dd>
3521
+
3522
+ <dl>
3523
+ <dd>
3524
+
3525
+ ```ruby
3526
+ client.webhook_events.list_deliveries(event_id: "event_id")
3527
+ ```
3528
+ </dd>
3529
+ </dl>
3530
+ </dd>
3531
+ </dl>
3532
+
3533
+ #### ⚙️ Parameters
3534
+
3535
+ <dl>
3536
+ <dd>
3537
+
3538
+ <dl>
3539
+ <dd>
3540
+
3541
+ **event_id:** `String`
3542
+
3543
+ </dd>
3544
+ </dl>
3545
+
3546
+ <dl>
3547
+ <dd>
3548
+
3549
+ **request_options:** `VitableConnect::WebhookEvents::RequestOptions`
3550
+
3551
+ </dd>
3552
+ </dl>
3553
+ </dd>
3554
+ </dl>
3555
+
3556
+
3557
+ </dd>
3558
+ </dl>
3559
+ </details>
3560
+
3561
+ ## Groups Members Sync
3562
+ <details><summary><code>client.groups.members.sync.<a href="/lib/VitableConnect/groups/members/sync/client.rb">submit</a>(group_id:, request) -> VitableConnect::Types::GroupMemberSyncDetailResponse</code></summary>
3563
+ <dl>
3564
+ <dd>
3565
+
3566
+ #### 📝 Description
3567
+
3568
+ <dl>
3569
+ <dd>
3570
+
3571
+ <dl>
3572
+ <dd>
3573
+
3574
+ Submits a member sync payload for the specified group. Members in the payload will be queued for processing asynchronously. Returns HTTP 202 with the batch ID and acceptance timestamp.
3575
+ </dd>
3576
+ </dl>
3577
+ </dd>
3578
+ </dl>
3579
+
3580
+ #### 🔌 Usage
3581
+
3582
+ <dl>
3583
+ <dd>
3584
+
3585
+ <dl>
3586
+ <dd>
3587
+
3588
+ ```ruby
3589
+ client.groups.members.sync.submit(
3590
+ group_id: "grp_abc123def456",
3591
+ members: [{
3592
+ reference_id: "EMP-001",
3593
+ first_name: "Jane",
3594
+ last_name: "Doe",
3595
+ date_of_birth: "1990-05-15",
3596
+ phone: "4155550100",
3597
+ plan_id: "pln_abc123def456",
3598
+ address: {
3599
+ address_line1: "123 Main Street",
3600
+ address_line2: "Apt 4B",
3601
+ city: "San Francisco",
3602
+ state: "CA",
3603
+ zipcode: "94102"
3604
+ },
3605
+ email: "jane.doe@acme.com"
3606
+ }]
3607
+ )
3608
+ ```
3609
+ </dd>
3610
+ </dl>
3611
+ </dd>
3612
+ </dl>
3613
+
3614
+ #### ⚙️ Parameters
3615
+
3616
+ <dl>
3617
+ <dd>
3618
+
3619
+ <dl>
3620
+ <dd>
3621
+
3622
+ **group_id:** `String`
3623
+
3624
+ </dd>
3625
+ </dl>
3626
+
3627
+ <dl>
3628
+ <dd>
3629
+
3630
+ **members:** `Internal::Types::Array[VitableConnect::Types::GroupMemberSyncMemberRequest]`
3631
+
3632
+ </dd>
3633
+ </dl>
3634
+
3635
+ <dl>
3636
+ <dd>
3637
+
3638
+ **request_options:** `VitableConnect::Groups::Members::Sync::RequestOptions`
3639
+
3640
+ </dd>
3641
+ </dl>
3642
+ </dd>
3643
+ </dl>
3644
+
3645
+
3646
+ </dd>
3647
+ </dl>
3648
+ </details>
3649
+
3650
+ <details><summary><code>client.groups.members.sync.<a href="/lib/VitableConnect/groups/members/sync/client.rb">get</a>(group_id:, request_id:) -> VitableConnect::Types::GroupMemberSyncRequestDetailResponse</code></summary>
3651
+ <dl>
3652
+ <dd>
3653
+
3654
+ #### 📝 Description
3655
+
3656
+ <dl>
3657
+ <dd>
3658
+
3659
+ <dl>
3660
+ <dd>
3661
+
3662
+ Retrieves a previously-submitted group member sync request by its `grpmsr_` ID. Returns the acceptance timestamp, completion timestamp (if processing has finished), and the per-member `results` once available. While processing is in flight, `completed_at` and `results` are `null`.
3663
+ </dd>
3664
+ </dl>
3665
+ </dd>
3666
+ </dl>
3667
+
3668
+ #### 🔌 Usage
3669
+
3670
+ <dl>
3671
+ <dd>
3672
+
3673
+ <dl>
3674
+ <dd>
3675
+
3676
+ ```ruby
3677
+ client.groups.members.sync.get(
3678
+ group_id: "grp_abc123def456",
3679
+ request_id: "request_id"
3680
+ )
3681
+ ```
3682
+ </dd>
3683
+ </dl>
3684
+ </dd>
3685
+ </dl>
3686
+
3687
+ #### ⚙️ Parameters
3688
+
3689
+ <dl>
3690
+ <dd>
3691
+
3692
+ <dl>
3693
+ <dd>
3694
+
3695
+ **group_id:** `String`
3696
+
3697
+ </dd>
3698
+ </dl>
3699
+
3700
+ <dl>
3701
+ <dd>
3702
+
3703
+ **request_id:** `String`
3704
+
3705
+ </dd>
3706
+ </dl>
3707
+
3708
+ <dl>
3709
+ <dd>
3710
+
3711
+ **request_options:** `VitableConnect::Groups::Members::Sync::RequestOptions`
3712
+
3713
+ </dd>
3714
+ </dl>
3715
+ </dd>
3716
+ </dl>
3717
+
3718
+
3719
+ </dd>
3720
+ </dl>
3721
+ </details>
3722
+