finch-api 0.1.0.pre.alpha.48 → 0.1.0.pre.alpha.50

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 (120) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/README.md +1 -1
  4. data/lib/finch_api/models/base_webhook_event.rb +2 -5
  5. data/lib/finch_api/models/create_access_token_response.rb +2 -5
  6. data/lib/finch_api/models/hris/benefit_create_params.rb +3 -2
  7. data/lib/finch_api/models/hris/benefit_list_params.rb +6 -2
  8. data/lib/finch_api/models/hris/benefit_list_supported_benefits_params.rb +6 -2
  9. data/lib/finch_api/models/hris/benefit_register_params.rb +6 -2
  10. data/lib/finch_api/models/hris/benefit_retrieve_params.rb +6 -2
  11. data/lib/finch_api/models/hris/benefit_update_params.rb +6 -2
  12. data/lib/finch_api/models/hris/benefits/individual_enroll_many_params.rb +6 -2
  13. data/lib/finch_api/models/hris/benefits/individual_enrolled_ids_params.rb +7 -2
  14. data/lib/finch_api/models/hris/benefits/individual_retrieve_many_benefits_params.rb +3 -2
  15. data/lib/finch_api/models/hris/benefits/individual_unenroll_many_params.rb +7 -2
  16. data/lib/finch_api/models/hris/company_retrieve_params.rb +6 -2
  17. data/lib/finch_api/models/hris/directory_list_individuals_params.rb +6 -2
  18. data/lib/finch_api/models/hris/directory_list_params.rb +6 -2
  19. data/lib/finch_api/models/hris/document_list_params.rb +3 -2
  20. data/lib/finch_api/models/hris/document_retreive_params.rb +6 -2
  21. data/lib/finch_api/models/hris/employment_data.rb +36 -1
  22. data/lib/finch_api/models/hris/employment_retrieve_many_params.rb +6 -2
  23. data/lib/finch_api/models/hris/individual.rb +30 -1
  24. data/lib/finch_api/models/hris/individual_retrieve_many_params.rb +6 -2
  25. data/lib/finch_api/models/hris/pay_statement_item/rule_create_params.rb +6 -2
  26. data/lib/finch_api/models/hris/pay_statement_item/rule_delete_params.rb +6 -2
  27. data/lib/finch_api/models/hris/pay_statement_item/rule_list_params.rb +6 -2
  28. data/lib/finch_api/models/hris/pay_statement_item/rule_update_params.rb +6 -2
  29. data/lib/finch_api/models/hris/pay_statement_item_list_params.rb +3 -2
  30. data/lib/finch_api/models/hris/pay_statement_retrieve_many_params.rb +6 -2
  31. data/lib/finch_api/models/hris/payment_list_params.rb +3 -2
  32. data/lib/finch_api/models/introspection.rb +2 -5
  33. data/lib/finch_api/models/payroll/pay_group_list_params.rb +6 -2
  34. data/lib/finch_api/models/payroll/pay_group_retrieve_params.rb +6 -2
  35. data/lib/finch_api/models/sandbox/connection_create_response.rb +2 -4
  36. data/lib/finch_api/models/sandbox/connections/account_create_response.rb +2 -4
  37. data/lib/finch_api/models/sandbox/connections/account_update_response.rb +2 -4
  38. data/lib/finch_api/models/sandbox/directory_create_params.rb +65 -1
  39. data/lib/finch_api/models/sandbox/employment_update_params.rb +36 -1
  40. data/lib/finch_api/models/sandbox/employment_update_response.rb +36 -1
  41. data/lib/finch_api/models/sandbox/individual_update_params.rb +28 -1
  42. data/lib/finch_api/models/sandbox/individual_update_response.rb +30 -1
  43. data/lib/finch_api/resources/hris/benefits/individuals.rb +15 -4
  44. data/lib/finch_api/resources/hris/benefits.rb +21 -6
  45. data/lib/finch_api/resources/hris/company.rb +4 -1
  46. data/lib/finch_api/resources/hris/directory.rb +4 -1
  47. data/lib/finch_api/resources/hris/documents.rb +5 -2
  48. data/lib/finch_api/resources/hris/employments.rb +4 -1
  49. data/lib/finch_api/resources/hris/individuals.rb +4 -1
  50. data/lib/finch_api/resources/hris/pay_statement_item/rules.rb +13 -4
  51. data/lib/finch_api/resources/hris/pay_statement_item.rb +1 -1
  52. data/lib/finch_api/resources/hris/pay_statements.rb +4 -1
  53. data/lib/finch_api/resources/hris/payments.rb +1 -1
  54. data/lib/finch_api/resources/payroll/pay_groups.rb +8 -2
  55. data/lib/finch_api/resources/sandbox/employment.rb +9 -1
  56. data/lib/finch_api/resources/sandbox/individual.rb +3 -1
  57. data/lib/finch_api/version.rb +1 -1
  58. data/rbi/finch_api/models/base_webhook_event.rbi +2 -4
  59. data/rbi/finch_api/models/create_access_token_response.rbi +2 -4
  60. data/rbi/finch_api/models/hris/benefit_create_params.rbi +4 -2
  61. data/rbi/finch_api/models/hris/benefit_list_params.rbi +4 -2
  62. data/rbi/finch_api/models/hris/benefit_list_supported_benefits_params.rbi +4 -2
  63. data/rbi/finch_api/models/hris/benefit_register_params.rbi +4 -2
  64. data/rbi/finch_api/models/hris/benefit_retrieve_params.rbi +4 -2
  65. data/rbi/finch_api/models/hris/benefit_update_params.rbi +4 -2
  66. data/rbi/finch_api/models/hris/benefits/individual_enroll_many_params.rbi +4 -2
  67. data/rbi/finch_api/models/hris/benefits/individual_enrolled_ids_params.rbi +4 -2
  68. data/rbi/finch_api/models/hris/benefits/individual_retrieve_many_benefits_params.rbi +4 -2
  69. data/rbi/finch_api/models/hris/benefits/individual_unenroll_many_params.rbi +4 -2
  70. data/rbi/finch_api/models/hris/company_retrieve_params.rbi +4 -2
  71. data/rbi/finch_api/models/hris/directory_list_individuals_params.rbi +4 -2
  72. data/rbi/finch_api/models/hris/directory_list_params.rbi +4 -2
  73. data/rbi/finch_api/models/hris/document_list_params.rbi +4 -2
  74. data/rbi/finch_api/models/hris/document_retreive_params.rbi +4 -2
  75. data/rbi/finch_api/models/hris/employment_data.rbi +38 -0
  76. data/rbi/finch_api/models/hris/employment_retrieve_many_params.rbi +4 -2
  77. data/rbi/finch_api/models/hris/individual.rbi +78 -0
  78. data/rbi/finch_api/models/hris/individual_retrieve_many_params.rbi +4 -2
  79. data/rbi/finch_api/models/hris/pay_statement_item/rule_create_params.rbi +4 -2
  80. data/rbi/finch_api/models/hris/pay_statement_item/rule_delete_params.rbi +4 -2
  81. data/rbi/finch_api/models/hris/pay_statement_item/rule_list_params.rbi +4 -2
  82. data/rbi/finch_api/models/hris/pay_statement_item/rule_update_params.rbi +4 -2
  83. data/rbi/finch_api/models/hris/pay_statement_item_list_params.rbi +4 -2
  84. data/rbi/finch_api/models/hris/pay_statement_retrieve_many_params.rbi +4 -2
  85. data/rbi/finch_api/models/hris/payment_list_params.rbi +4 -2
  86. data/rbi/finch_api/models/introspection.rbi +2 -4
  87. data/rbi/finch_api/models/payroll/pay_group_list_params.rbi +4 -2
  88. data/rbi/finch_api/models/payroll/pay_group_retrieve_params.rbi +4 -2
  89. data/rbi/finch_api/models/sandbox/connection_create_response.rbi +2 -2
  90. data/rbi/finch_api/models/sandbox/connections/account_create_response.rbi +2 -2
  91. data/rbi/finch_api/models/sandbox/connections/account_update_response.rbi +2 -2
  92. data/rbi/finch_api/models/sandbox/directory_create_params.rbi +119 -3
  93. data/rbi/finch_api/models/sandbox/employment_update_params.rbi +38 -0
  94. data/rbi/finch_api/models/sandbox/employment_update_response.rbi +41 -3
  95. data/rbi/finch_api/models/sandbox/individual_update_params.rbi +78 -0
  96. data/rbi/finch_api/models/sandbox/individual_update_response.rbi +78 -0
  97. data/rbi/finch_api/resources/hris/benefits/individuals.rbi +8 -4
  98. data/rbi/finch_api/resources/hris/benefits.rbi +12 -6
  99. data/rbi/finch_api/resources/hris/company.rbi +2 -1
  100. data/rbi/finch_api/resources/hris/directory.rbi +2 -1
  101. data/rbi/finch_api/resources/hris/documents.rbi +4 -2
  102. data/rbi/finch_api/resources/hris/employments.rbi +2 -1
  103. data/rbi/finch_api/resources/hris/individuals.rbi +2 -1
  104. data/rbi/finch_api/resources/hris/pay_statement_item/rules.rbi +8 -4
  105. data/rbi/finch_api/resources/hris/pay_statement_item.rbi +2 -1
  106. data/rbi/finch_api/resources/hris/pay_statements.rbi +2 -1
  107. data/rbi/finch_api/resources/hris/payments.rbi +2 -1
  108. data/rbi/finch_api/resources/payroll/pay_groups.rbi +4 -2
  109. data/rbi/finch_api/resources/sandbox/employment.rbi +15 -0
  110. data/rbi/finch_api/resources/sandbox/individual.rbi +7 -0
  111. data/sig/finch_api/models/hris/employment_data.rbs +20 -0
  112. data/sig/finch_api/models/hris/individual.rbs +26 -0
  113. data/sig/finch_api/models/sandbox/directory_create_params.rbs +49 -3
  114. data/sig/finch_api/models/sandbox/employment_update_params.rbs +21 -1
  115. data/sig/finch_api/models/sandbox/employment_update_response.rbs +23 -3
  116. data/sig/finch_api/models/sandbox/individual_update_params.rbs +26 -0
  117. data/sig/finch_api/models/sandbox/individual_update_response.rbs +26 -0
  118. data/sig/finch_api/resources/sandbox/employment.rbs +4 -0
  119. data/sig/finch_api/resources/sandbox/individual.rbs +1 -0
  120. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6a516f81f01b9ea7b24c991040f7e588ce4f22f522774c44bda36f84fa4c0d95
4
- data.tar.gz: 698f1bb3796033699051458fe674ee2c37c8054f57044b18be53d5a3083997c2
3
+ metadata.gz: 0baa06f8bc674518d4abf5fb86c2232ac10c6c709b082d783c3e15e41e09c55d
4
+ data.tar.gz: 7f59c107245deea6024b07c5c1ce7d35a0f81c98ce96b3e328dfdc2220e08cac
5
5
  SHA512:
6
- metadata.gz: '09ef57663d79aebd52343bc5c40e7120ae29687dfbf6e1a471c120ddae9dec213b544cb4fc0e0b3b9a14920f6cc3d13a48eb159b1f6e762d2d5a6fbcbf2c2359'
7
- data.tar.gz: 8f1be6bedac4265bb4587fa9788d87c5a0278072772c196d5e55f7b7f1e8bbc03d980d69d4d7a7674fc14b6cb2dee1ab022b05c7eb8537eabc3531998144fe35
6
+ metadata.gz: b791e603219364089fe168d43dad39b8755a0c1e6196ebcbbc0f0edf8a5c7f72fb33a6730b0477a4269ca9c6d74f3db0f06eb28148b02d8a4604416cbcd4a923
7
+ data.tar.gz: b406e67732f8cda1d32056a5619b562d94d2dbebf02b3c5873d51bcc0beaf830487b60f8c50db5e1326072a685dacf0929600985fde9d87c219cf487098ee9ec
data/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.0-alpha.50 (2026-07-17)
4
+
5
+ Full Changelog: [v0.1.0-alpha.49...v0.1.0-alpha.50](https://github.com/Finch-API/finch-api-ruby/compare/v0.1.0-alpha.49...v0.1.0-alpha.50)
6
+
7
+ ### Features
8
+
9
+ * **api:** api update ([043c5b5](https://github.com/Finch-API/finch-api-ruby/commit/043c5b520c2561f0f20d377cfa75c443b07b4bb6))
10
+ * **stlc:** configurable CI runner and private-production-repo support in workflow templates ([ba8e0a7](https://github.com/Finch-API/finch-api-ruby/commit/ba8e0a7037b38eed4f688e413b0b001af0e31a26))
11
+
12
+ ## 0.1.0-alpha.49 (2026-07-15)
13
+
14
+ Full Changelog: [v0.1.0-alpha.48...v0.1.0-alpha.49](https://github.com/Finch-API/finch-api-ruby/compare/v0.1.0-alpha.48...v0.1.0-alpha.49)
15
+
16
+ ### Features
17
+
18
+ * **api:** api update ([41c1dd6](https://github.com/Finch-API/finch-api-ruby/commit/41c1dd679e77e2a293321fbdff1d145149c3af5f))
19
+
3
20
  ## 0.1.0-alpha.48 (2026-07-13)
4
21
 
5
22
  Full Changelog: [v0.1.0-alpha.47...v0.1.0-alpha.48](https://github.com/Finch-API/finch-api-ruby/compare/v0.1.0-alpha.47...v0.1.0-alpha.48)
data/README.md CHANGED
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
26
26
  <!-- x-release-please-start-version -->
27
27
 
28
28
  ```ruby
29
- gem "finch-api", "~> 0.1.0.pre.alpha.48"
29
+ gem "finch-api", "~> 0.1.0.pre.alpha.50"
30
30
  ```
31
31
 
32
32
  <!-- x-release-please-end -->
@@ -14,10 +14,7 @@ module FinchAPI
14
14
  required :account_id, String
15
15
 
16
16
  # @!attribute company_id
17
- # @deprecated
18
- #
19
- # [DEPRECATED] Unique Finch ID of the company for which data has been updated. Use
20
- # `connection_id` instead to identify the connection associated with this event.
17
+ # Unique Finch ID of the company for which data has been updated.
21
18
  #
22
19
  # @return [String]
23
20
  required :company_id, String
@@ -40,7 +37,7 @@ module FinchAPI
40
37
  #
41
38
  # @param account_id [String] [DEPRECATED] Unique Finch ID of the employer account used to make this connectio
42
39
  #
43
- # @param company_id [String] [DEPRECATED] Unique Finch ID of the company for which data has been updated. Use
40
+ # @param company_id [String] Unique Finch ID of the company for which data has been updated.
44
41
  #
45
42
  # @param connection_id [String] Unique Finch ID of the connection associated with the webhook event.
46
43
  #
@@ -65,10 +65,7 @@ module FinchAPI
65
65
  optional :account_id, String
66
66
 
67
67
  # @!attribute company_id
68
- # @deprecated
69
- #
70
- # [DEPRECATED] Use `connection_id` to identify the connection instead of this
71
- # company ID
68
+ # The Finch UUID of the company associated with the `access_token`.
72
69
  #
73
70
  # @return [String, nil]
74
71
  optional :company_id, String
@@ -109,7 +106,7 @@ module FinchAPI
109
106
  #
110
107
  # @param account_id [String] [DEPRECATED] Use `connection_id` to identify the connection instead of this acco
111
108
  #
112
- # @param company_id [String] [DEPRECATED] Use `connection_id` to identify the connection instead of this comp
109
+ # @param company_id [String] The Finch UUID of the company associated with the `access_token`.
113
110
  #
114
111
  # @param customer_id [String, nil] The ID of your customer you provided to Finch when a connect session was created
115
112
  #
@@ -9,7 +9,8 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -46,7 +47,7 @@ module FinchAPI
46
47
  # Some parameter documentations has been truncated, see
47
48
  # {FinchAPI::Models::HRIS::BenefitCreateParams} for more details.
48
49
  #
49
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
50
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
50
51
  #
51
52
  # @param company_contribution [FinchAPI::Models::HRIS::BenefitCreateParams::CompanyContribution, nil] The company match for this benefit.
52
53
  #
@@ -9,13 +9,17 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
16
17
 
17
18
  # @!method initialize(entity_ids: nil, request_options: {})
18
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
19
+ # Some parameter documentations has been truncated, see
20
+ # {FinchAPI::Models::HRIS::BenefitListParams} for more details.
21
+ #
22
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
19
23
  #
20
24
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
21
25
  end
@@ -9,13 +9,17 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
16
17
 
17
18
  # @!method initialize(entity_ids: nil, request_options: {})
18
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
19
+ # Some parameter documentations has been truncated, see
20
+ # {FinchAPI::Models::HRIS::BenefitListSupportedBenefitsParams} for more details.
21
+ #
22
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
19
23
  #
20
24
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
21
25
  end
@@ -9,7 +9,8 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -32,7 +33,10 @@ module FinchAPI
32
33
  optional :type, enum: -> { FinchAPI::HRIS::BenefitType }, nil?: true
33
34
 
34
35
  # @!method initialize(entity_ids: nil, description: nil, frequency: nil, type: nil, request_options: {})
35
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
36
+ # Some parameter documentations has been truncated, see
37
+ # {FinchAPI::Models::HRIS::BenefitRegisterParams} for more details.
38
+ #
39
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
36
40
  #
37
41
  # @param description [String]
38
42
  #
@@ -14,15 +14,19 @@ module FinchAPI
14
14
  required :benefit_id, String
15
15
 
16
16
  # @!attribute entity_ids
17
- # The entity IDs to specify which entities' data to access.
17
+ # The entity IDs to specify which entities' data to access. Provide exactly one
18
+ # entity ID per request; a maximum of one is accepted.
18
19
  #
19
20
  # @return [Array<String>, nil]
20
21
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
21
22
 
22
23
  # @!method initialize(benefit_id:, entity_ids: nil, request_options: {})
24
+ # Some parameter documentations has been truncated, see
25
+ # {FinchAPI::Models::HRIS::BenefitRetrieveParams} for more details.
26
+ #
23
27
  # @param benefit_id [String]
24
28
  #
25
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
29
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
26
30
  #
27
31
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
28
32
  end
@@ -14,7 +14,8 @@ module FinchAPI
14
14
  required :benefit_id, String
15
15
 
16
16
  # @!attribute entity_ids
17
- # The entity IDs to specify which entities' data to access.
17
+ # The entity IDs to specify which entities' data to access. Provide exactly one
18
+ # entity ID per request; a maximum of one is accepted.
18
19
  #
19
20
  # @return [Array<String>, nil]
20
21
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -26,9 +27,12 @@ module FinchAPI
26
27
  optional :description, String
27
28
 
28
29
  # @!method initialize(benefit_id:, entity_ids: nil, description: nil, request_options: {})
30
+ # Some parameter documentations has been truncated, see
31
+ # {FinchAPI::Models::HRIS::BenefitUpdateParams} for more details.
32
+ #
29
33
  # @param benefit_id [String]
30
34
  #
31
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
35
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
32
36
  #
33
37
  # @param description [String] Updated name or description.
34
38
  #
@@ -15,7 +15,8 @@ module FinchAPI
15
15
  required :benefit_id, String
16
16
 
17
17
  # @!attribute entity_ids
18
- # The entity IDs to specify which entities' data to access.
18
+ # The entity IDs to specify which entities' data to access. Provide exactly one
19
+ # entity ID per request; a maximum of one is accepted.
19
20
  #
20
21
  # @return [Array<String>, nil]
21
22
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -28,9 +29,12 @@ module FinchAPI
28
29
  -> { FinchAPI::Internal::Type::ArrayOf[FinchAPI::HRIS::Benefits::IndividualEnrollManyParams::Individual] }
29
30
 
30
31
  # @!method initialize(benefit_id:, entity_ids: nil, individuals: nil, request_options: {})
32
+ # Some parameter documentations has been truncated, see
33
+ # {FinchAPI::Models::HRIS::Benefits::IndividualEnrollManyParams} for more details.
34
+ #
31
35
  # @param benefit_id [String]
32
36
  #
33
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
37
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
34
38
  #
35
39
  # @param individuals [Array<FinchAPI::Models::HRIS::Benefits::IndividualEnrollManyParams::Individual>] Array of the individual_id to enroll and a configuration object.
36
40
  #
@@ -15,15 +15,20 @@ module FinchAPI
15
15
  required :benefit_id, String
16
16
 
17
17
  # @!attribute entity_ids
18
- # The entity IDs to specify which entities' data to access.
18
+ # The entity IDs to specify which entities' data to access. Provide exactly one
19
+ # entity ID per request; a maximum of one is accepted.
19
20
  #
20
21
  # @return [Array<String>, nil]
21
22
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
22
23
 
23
24
  # @!method initialize(benefit_id:, entity_ids: nil, request_options: {})
25
+ # Some parameter documentations has been truncated, see
26
+ # {FinchAPI::Models::HRIS::Benefits::IndividualEnrolledIDsParams} for more
27
+ # details.
28
+ #
24
29
  # @param benefit_id [String]
25
30
  #
26
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
31
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
27
32
  #
28
33
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
29
34
  end
@@ -15,7 +15,8 @@ module FinchAPI
15
15
  required :benefit_id, String
16
16
 
17
17
  # @!attribute entity_ids
18
- # The entity IDs to specify which entities' data to access.
18
+ # The entity IDs to specify which entities' data to access. Provide exactly one
19
+ # entity ID per request; a maximum of one is accepted.
19
20
  #
20
21
  # @return [Array<String>, nil]
21
22
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -34,7 +35,7 @@ module FinchAPI
34
35
  #
35
36
  # @param benefit_id [String]
36
37
  #
37
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
38
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
38
39
  #
39
40
  # @param individual_ids [String] comma-delimited list of stable Finch uuids for each individual. If empty, defaul
40
41
  #
@@ -15,7 +15,8 @@ module FinchAPI
15
15
  required :benefit_id, String
16
16
 
17
17
  # @!attribute entity_ids
18
- # The entity IDs to specify which entities' data to access.
18
+ # The entity IDs to specify which entities' data to access. Provide exactly one
19
+ # entity ID per request; a maximum of one is accepted.
19
20
  #
20
21
  # @return [Array<String>, nil]
21
22
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -27,9 +28,13 @@ module FinchAPI
27
28
  optional :individual_ids, FinchAPI::Internal::Type::ArrayOf[String]
28
29
 
29
30
  # @!method initialize(benefit_id:, entity_ids: nil, individual_ids: nil, request_options: {})
31
+ # Some parameter documentations has been truncated, see
32
+ # {FinchAPI::Models::HRIS::Benefits::IndividualUnenrollManyParams} for more
33
+ # details.
34
+ #
30
35
  # @param benefit_id [String]
31
36
  #
32
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
37
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
33
38
  #
34
39
  # @param individual_ids [Array<String>] Array of individual_ids to unenroll.
35
40
  #
@@ -9,13 +9,17 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
16
17
 
17
18
  # @!method initialize(entity_ids: nil, request_options: {})
18
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
19
+ # Some parameter documentations has been truncated, see
20
+ # {FinchAPI::Models::HRIS::CompanyRetrieveParams} for more details.
21
+ #
22
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
19
23
  #
20
24
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
21
25
  end
@@ -9,7 +9,8 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -27,7 +28,10 @@ module FinchAPI
27
28
  optional :offset, Integer
28
29
 
29
30
  # @!method initialize(entity_ids: nil, limit: nil, offset: nil, request_options: {})
30
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
31
+ # Some parameter documentations has been truncated, see
32
+ # {FinchAPI::Models::HRIS::DirectoryListIndividualsParams} for more details.
33
+ #
34
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
31
35
  #
32
36
  # @param limit [Integer] Number of employees to return (defaults to 100, maximum 10000)
33
37
  #
@@ -9,7 +9,8 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -27,7 +28,10 @@ module FinchAPI
27
28
  optional :offset, Integer
28
29
 
29
30
  # @!method initialize(entity_ids: nil, limit: nil, offset: nil, request_options: {})
30
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
31
+ # Some parameter documentations has been truncated, see
32
+ # {FinchAPI::Models::HRIS::DirectoryListParams} for more details.
33
+ #
34
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
31
35
  #
32
36
  # @param limit [Integer] Number of employees to return (defaults to 100, maximum 10000)
33
37
  #
@@ -9,7 +9,8 @@ module FinchAPI
9
9
  include FinchAPI::Internal::Type::RequestParameters
10
10
 
11
11
  # @!attribute entity_ids
12
- # The entity IDs to specify which entities' data to access.
12
+ # The entity IDs to specify which entities' data to access. Provide exactly one
13
+ # entity ID per request; a maximum of one is accepted.
13
14
  #
14
15
  # @return [Array<String>, nil]
15
16
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -44,7 +45,7 @@ module FinchAPI
44
45
  # Some parameter documentations has been truncated, see
45
46
  # {FinchAPI::Models::HRIS::DocumentListParams} for more details.
46
47
  #
47
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
48
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
48
49
  #
49
50
  # @param individual_ids [Array<String>] Comma-delimited list of stable Finch uuids for each individual. If empty, defaul
50
51
  #
@@ -14,15 +14,19 @@ module FinchAPI
14
14
  required :document_id, String
15
15
 
16
16
  # @!attribute entity_ids
17
- # The entity IDs to specify which entities' data to access.
17
+ # The entity IDs to specify which entities' data to access. Provide exactly one
18
+ # entity ID per request; a maximum of one is accepted.
18
19
  #
19
20
  # @return [Array<String>, nil]
20
21
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
21
22
 
22
23
  # @!method initialize(document_id:, entity_ids: nil, request_options: {})
24
+ # Some parameter documentations has been truncated, see
25
+ # {FinchAPI::Models::HRIS::DocumentRetreiveParams} for more details.
26
+ #
23
27
  # @param document_id [String]
24
28
  #
25
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
29
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
26
30
  #
27
31
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
28
32
  end
@@ -67,12 +67,26 @@ module FinchAPI
67
67
  enum: -> { FinchAPI::HRIS::EmploymentData::EmploymentDataResponseBody::FlsaStatus },
68
68
  nil?: true
69
69
 
70
+ # @!attribute highly_compensated_employee
71
+ # IRS flag indicating whether the employee is classified as a Highly Compensated
72
+ # Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.
73
+ #
74
+ # @return [Boolean, nil]
75
+ required :highly_compensated_employee, FinchAPI::Internal::Type::Boolean, nil?: true
76
+
70
77
  # @!attribute is_active
71
78
  # `true` if the individual an an active employee or contractor at the company.
72
79
  #
73
80
  # @return [Boolean, nil]
74
81
  required :is_active, FinchAPI::Internal::Type::Boolean, nil?: true
75
82
 
83
+ # @!attribute key_employee
84
+ # IRS flag indicating whether the employee is classified as a Key Employee for
85
+ # top-heavy testing purposes. US-only.
86
+ #
87
+ # @return [Boolean, nil]
88
+ required :key_employee, FinchAPI::Internal::Type::Boolean, nil?: true
89
+
76
90
  # @!attribute last_name
77
91
  # The legal last name of the individual.
78
92
  #
@@ -116,6 +130,19 @@ module FinchAPI
116
130
  # @return [String, nil]
117
131
  required :title, String, nil?: true
118
132
 
133
+ # @!attribute union_code
134
+ # The code identifying the union the employee is a member of, as configured in the
135
+ # payroll system.
136
+ #
137
+ # @return [String, nil]
138
+ required :union_code, String, nil?: true
139
+
140
+ # @!attribute union_local
141
+ # The local chapter or local number within the employee's union.
142
+ #
143
+ # @return [String, nil]
144
+ required :union_local, String, nil?: true
145
+
119
146
  # @!attribute custom_fields
120
147
  # Custom fields for the individual. These are fields which are defined by the
121
148
  # employer in the system. Custom fields are not currently supported for assisted
@@ -158,7 +185,7 @@ module FinchAPI
158
185
  # @return [String, nil]
159
186
  optional :work_id, String, nil?: true
160
187
 
161
- # @!method initialize(id:, class_code:, department:, employment:, employment_status:, end_date:, first_name:, flsa_status:, is_active:, last_name:, latest_rehire_date:, location:, manager:, middle_name:, start_date:, title:, custom_fields: nil, income: nil, income_history: nil, source_id: nil, work_id: nil)
188
+ # @!method initialize(id:, class_code:, department:, employment:, employment_status:, end_date:, first_name:, flsa_status:, highly_compensated_employee:, is_active:, key_employee:, last_name:, latest_rehire_date:, location:, manager:, middle_name:, start_date:, title:, union_code:, union_local:, custom_fields: nil, income: nil, income_history: nil, source_id: nil, work_id: nil)
162
189
  # Some parameter documentations has been truncated, see
163
190
  # {FinchAPI::Models::HRIS::EmploymentData::EmploymentDataResponseBody} for more
164
191
  # details.
@@ -179,8 +206,12 @@ module FinchAPI
179
206
  #
180
207
  # @param flsa_status [Symbol, FinchAPI::Models::HRIS::EmploymentData::EmploymentDataResponseBody::FlsaStatus, nil] The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `u
181
208
  #
209
+ # @param highly_compensated_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Highly Compensated E
210
+ #
182
211
  # @param is_active [Boolean, nil] `true` if the individual an an active employee or contractor at the company.
183
212
  #
213
+ # @param key_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Key Employee for top
214
+ #
184
215
  # @param last_name [String, nil] The legal last name of the individual.
185
216
  #
186
217
  # @param latest_rehire_date [String, nil]
@@ -195,6 +226,10 @@ module FinchAPI
195
226
  #
196
227
  # @param title [String, nil] The current title of the individual.
197
228
  #
229
+ # @param union_code [String, nil] The code identifying the union the employee is a member of, as configured in the
230
+ #
231
+ # @param union_local [String, nil] The local chapter or local number within the employee's union.
232
+ #
198
233
  # @param custom_fields [Array<FinchAPI::Models::HRIS::EmploymentData::EmploymentDataResponseBody::CustomField>, nil] Custom fields for the individual. These are fields which are defined by the empl
199
234
  #
200
235
  # @param income [FinchAPI::Models::Income, nil] The employee's income as reported by the provider. This may not always be annual
@@ -16,15 +16,19 @@ module FinchAPI
16
16
  -> { FinchAPI::Internal::Type::ArrayOf[FinchAPI::HRIS::EmploymentRetrieveManyParams::Request] }
17
17
 
18
18
  # @!attribute entity_ids
19
- # The entity IDs to specify which entities' data to access.
19
+ # The entity IDs to specify which entities' data to access. Provide exactly one
20
+ # entity ID per request; a maximum of one is accepted.
20
21
  #
21
22
  # @return [Array<String>, nil]
22
23
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
23
24
 
24
25
  # @!method initialize(requests:, entity_ids: nil, request_options: {})
26
+ # Some parameter documentations has been truncated, see
27
+ # {FinchAPI::Models::HRIS::EmploymentRetrieveManyParams} for more details.
28
+ #
25
29
  # @param requests [Array<FinchAPI::Models::HRIS::EmploymentRetrieveManyParams::Request>] The array of batch requests. Maximum 10000 items per request.
26
30
  #
27
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
31
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
28
32
  #
29
33
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
30
34
 
@@ -52,6 +52,15 @@ module FinchAPI
52
52
  # @return [String, nil]
53
53
  required :last_name, String, nil?: true
54
54
 
55
+ # @!attribute marital_status
56
+ # The employee's marital status, used for beneficiary designation and spousal
57
+ # consent workflows.
58
+ #
59
+ # @return [Symbol, FinchAPI::Models::HRIS::Individual::IndividualResponseBody::MaritalStatus, nil]
60
+ required :marital_status,
61
+ enum: -> { FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus },
62
+ nil?: true
63
+
55
64
  # @!attribute middle_name
56
65
  # The legal middle name of the individual.
57
66
  #
@@ -105,7 +114,7 @@ module FinchAPI
105
114
  # @return [String, nil]
106
115
  optional :ssn, String, nil?: true
107
116
 
108
- # @!method initialize(id:, dob:, ethnicity:, first_name:, gender:, last_name:, middle_name:, phone_numbers:, preferred_name:, residence:, emails: nil, encrypted_ssn: nil, ssn: nil)
117
+ # @!method initialize(id:, dob:, ethnicity:, first_name:, gender:, last_name:, marital_status:, middle_name:, phone_numbers:, preferred_name:, residence:, emails: nil, encrypted_ssn: nil, ssn: nil)
109
118
  # Some parameter documentations has been truncated, see
110
119
  # {FinchAPI::Models::HRIS::Individual::IndividualResponseBody} for more details.
111
120
  #
@@ -121,6 +130,8 @@ module FinchAPI
121
130
  #
122
131
  # @param last_name [String, nil] The legal last name of the individual.
123
132
  #
133
+ # @param marital_status [Symbol, FinchAPI::Models::HRIS::Individual::IndividualResponseBody::MaritalStatus, nil] The employee's marital status, used for beneficiary designation and spousal cons
134
+ #
124
135
  # @param middle_name [String, nil] The legal middle name of the individual.
125
136
  #
126
137
  # @param phone_numbers [Array<FinchAPI::Models::HRIS::Individual::IndividualResponseBody::PhoneNumber, nil>, nil]
@@ -169,6 +180,24 @@ module FinchAPI
169
180
  # @return [Array<Symbol>]
170
181
  end
171
182
 
183
+ # The employee's marital status, used for beneficiary designation and spousal
184
+ # consent workflows.
185
+ #
186
+ # @see FinchAPI::Models::HRIS::Individual::IndividualResponseBody#marital_status
187
+ module MaritalStatus
188
+ extend FinchAPI::Internal::Type::Enum
189
+
190
+ SINGLE = :single
191
+ MARRIED = :married
192
+ DIVORCED = :divorced
193
+ WIDOWED = :widowed
194
+ DOMESTIC_PARTNER = :domestic_partner
195
+ UNKNOWN = :unknown
196
+
197
+ # @!method self.values
198
+ # @return [Array<Symbol>]
199
+ end
200
+
172
201
  class PhoneNumber < FinchAPI::Internal::Type::BaseModel
173
202
  # @!attribute data
174
203
  #
@@ -16,7 +16,8 @@ module FinchAPI
16
16
  -> { FinchAPI::Internal::Type::ArrayOf[FinchAPI::HRIS::IndividualRetrieveManyParams::Request] }
17
17
 
18
18
  # @!attribute entity_ids
19
- # The entity IDs to specify which entities' data to access.
19
+ # The entity IDs to specify which entities' data to access. Provide exactly one
20
+ # entity ID per request; a maximum of one is accepted.
20
21
  #
21
22
  # @return [Array<String>, nil]
22
23
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -27,9 +28,12 @@ module FinchAPI
27
28
  optional :options, -> { FinchAPI::HRIS::IndividualRetrieveManyParams::Options }, nil?: true
28
29
 
29
30
  # @!method initialize(requests:, entity_ids: nil, options: nil, request_options: {})
31
+ # Some parameter documentations has been truncated, see
32
+ # {FinchAPI::Models::HRIS::IndividualRetrieveManyParams} for more details.
33
+ #
30
34
  # @param requests [Array<FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Request>] The array of batch requests. Maximum 10000 items per request.
31
35
  #
32
- # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
36
+ # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access. Provide exactly one en
33
37
  #
34
38
  # @param options [FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Options, nil]
35
39
  #
@@ -10,7 +10,8 @@ module FinchAPI
10
10
  include FinchAPI::Internal::Type::RequestParameters
11
11
 
12
12
  # @!attribute entity_ids
13
- # The entity IDs to create the rule for.
13
+ # The entity IDs to create the rule for. Provide exactly one entity ID per
14
+ # request; a maximum of one is accepted.
14
15
  #
15
16
  # @return [Array<String>, nil]
16
17
  optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
@@ -46,7 +47,10 @@ module FinchAPI
46
47
  optional :entity_type, enum: -> { FinchAPI::HRIS::PayStatementItem::RuleCreateParams::EntityType }
47
48
 
48
49
  # @!method initialize(entity_ids: nil, attributes: nil, conditions: nil, effective_end_date: nil, effective_start_date: nil, entity_type: nil, request_options: {})
49
- # @param entity_ids [Array<String>] The entity IDs to create the rule for.
50
+ # Some parameter documentations has been truncated, see
51
+ # {FinchAPI::Models::HRIS::PayStatementItem::RuleCreateParams} for more details.
52
+ #
53
+ # @param entity_ids [Array<String>] The entity IDs to create the rule for. Provide exactly one entity ID per request
50
54
  #
51
55
  # @param attributes [FinchAPI::Models::HRIS::PayStatementItem::RuleCreateParams::Attributes] Specifies the fields to be applied when the condition is met.
52
56
  #