finch-api 0.1.0.pre.alpha.49 → 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 (32) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +9 -0
  3. data/README.md +1 -1
  4. data/lib/finch_api/models/hris/employment_data.rb +36 -1
  5. data/lib/finch_api/models/hris/individual.rb +30 -1
  6. data/lib/finch_api/models/sandbox/directory_create_params.rb +65 -1
  7. data/lib/finch_api/models/sandbox/employment_update_params.rb +36 -1
  8. data/lib/finch_api/models/sandbox/employment_update_response.rb +36 -1
  9. data/lib/finch_api/models/sandbox/individual_update_params.rb +28 -1
  10. data/lib/finch_api/models/sandbox/individual_update_response.rb +30 -1
  11. data/lib/finch_api/resources/sandbox/employment.rb +9 -1
  12. data/lib/finch_api/resources/sandbox/individual.rb +3 -1
  13. data/lib/finch_api/version.rb +1 -1
  14. data/rbi/finch_api/models/hris/employment_data.rbi +38 -0
  15. data/rbi/finch_api/models/hris/individual.rbi +78 -0
  16. data/rbi/finch_api/models/sandbox/directory_create_params.rbi +119 -3
  17. data/rbi/finch_api/models/sandbox/employment_update_params.rbi +38 -0
  18. data/rbi/finch_api/models/sandbox/employment_update_response.rbi +41 -3
  19. data/rbi/finch_api/models/sandbox/individual_update_params.rbi +78 -0
  20. data/rbi/finch_api/models/sandbox/individual_update_response.rbi +78 -0
  21. data/rbi/finch_api/resources/sandbox/employment.rbi +15 -0
  22. data/rbi/finch_api/resources/sandbox/individual.rbi +7 -0
  23. data/sig/finch_api/models/hris/employment_data.rbs +20 -0
  24. data/sig/finch_api/models/hris/individual.rbs +26 -0
  25. data/sig/finch_api/models/sandbox/directory_create_params.rbs +49 -3
  26. data/sig/finch_api/models/sandbox/employment_update_params.rbs +21 -1
  27. data/sig/finch_api/models/sandbox/employment_update_response.rbs +23 -3
  28. data/sig/finch_api/models/sandbox/individual_update_params.rbs +26 -0
  29. data/sig/finch_api/models/sandbox/individual_update_response.rbs +26 -0
  30. data/sig/finch_api/resources/sandbox/employment.rbs +4 -0
  31. data/sig/finch_api/resources/sandbox/individual.rbs +1 -0
  32. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0e808c0bba7f22123fbcea95871a5b0a7d0149de1e6c3e63b30cb30406088684
4
- data.tar.gz: bffa0baac1966f4b99a88e6fdfc8aefadc7b342109c70224821216721724a171
3
+ metadata.gz: 0baa06f8bc674518d4abf5fb86c2232ac10c6c709b082d783c3e15e41e09c55d
4
+ data.tar.gz: 7f59c107245deea6024b07c5c1ce7d35a0f81c98ce96b3e328dfdc2220e08cac
5
5
  SHA512:
6
- metadata.gz: c4900f43c809f22998d056aafce9a7b8563685df7bb302f2012eca4163ffaab3112285886f47765e754fd36237f63766e504c716e28d9924f3507f56e7337073
7
- data.tar.gz: ec75b28b2b7d2ddcfe2c2b96d8fa33f77dd9cecd1c22c26a43c3b470b495abcab7b8120840222e7d6bde62f1db974e0e0851592f2f5b8d4447180e25191096d7
6
+ metadata.gz: b791e603219364089fe168d43dad39b8755a0c1e6196ebcbbc0f0edf8a5c7f72fb33a6730b0477a4269ca9c6d74f3db0f06eb28148b02d8a4604416cbcd4a923
7
+ data.tar.gz: b406e67732f8cda1d32056a5619b562d94d2dbebf02b3c5873d51bcc0beaf830487b60f8c50db5e1326072a685dacf0929600985fde9d87c219cf487098ee9ec
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
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
+
3
12
  ## 0.1.0-alpha.49 (2026-07-15)
4
13
 
5
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)
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.49"
29
+ gem "finch-api", "~> 0.1.0.pre.alpha.50"
30
30
  ```
31
31
 
32
32
  <!-- x-release-please-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
@@ -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
  #
@@ -122,6 +122,13 @@ module FinchAPI
122
122
  # @return [Symbol, FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::Gender, nil]
123
123
  optional :gender, enum: -> { FinchAPI::Sandbox::DirectoryCreateParams::Body::Gender }, nil?: true
124
124
 
125
+ # @!attribute highly_compensated_employee
126
+ # IRS flag indicating whether the employee is classified as a Highly Compensated
127
+ # Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.
128
+ #
129
+ # @return [Boolean, nil]
130
+ optional :highly_compensated_employee, FinchAPI::Internal::Type::Boolean, nil?: true
131
+
125
132
  # @!attribute income
126
133
  # The employee's income as reported by the provider. This may not always be
127
134
  # annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc,
@@ -144,6 +151,13 @@ module FinchAPI
144
151
  # @return [Boolean, nil]
145
152
  optional :is_active, FinchAPI::Internal::Type::Boolean, nil?: true
146
153
 
154
+ # @!attribute key_employee
155
+ # IRS flag indicating whether the employee is classified as a Key Employee for
156
+ # top-heavy testing purposes. US-only.
157
+ #
158
+ # @return [Boolean, nil]
159
+ optional :key_employee, FinchAPI::Internal::Type::Boolean, nil?: true
160
+
147
161
  # @!attribute last_name
148
162
  # The legal last name of the individual.
149
163
  #
@@ -166,6 +180,15 @@ module FinchAPI
166
180
  # @return [FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::Manager, nil]
167
181
  optional :manager, -> { FinchAPI::Sandbox::DirectoryCreateParams::Body::Manager }, nil?: true
168
182
 
183
+ # @!attribute marital_status
184
+ # The employee's marital status, used for beneficiary designation and spousal
185
+ # consent workflows.
186
+ #
187
+ # @return [Symbol, FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::MaritalStatus, nil]
188
+ optional :marital_status,
189
+ enum: -> { FinchAPI::Sandbox::DirectoryCreateParams::Body::MaritalStatus },
190
+ nil?: true
191
+
169
192
  # @!attribute middle_name
170
193
  # The legal middle name of the individual.
171
194
  #
@@ -219,7 +242,20 @@ module FinchAPI
219
242
  # @return [String, nil]
220
243
  optional :title, String, nil?: true
221
244
 
222
- # @!method initialize(class_code: nil, custom_fields: nil, department: nil, dob: nil, emails: nil, employment: nil, employment_status: nil, encrypted_ssn: nil, end_date: nil, ethnicity: nil, first_name: nil, flsa_status: nil, gender: nil, income: nil, income_history: nil, is_active: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, source_id: nil, ssn: nil, start_date: nil, title: nil)
245
+ # @!attribute union_code
246
+ # The code identifying the union the employee is a member of, as configured in the
247
+ # payroll system.
248
+ #
249
+ # @return [String, nil]
250
+ optional :union_code, String, nil?: true
251
+
252
+ # @!attribute union_local
253
+ # The local chapter or local number within the employee's union.
254
+ #
255
+ # @return [String, nil]
256
+ optional :union_local, String, nil?: true
257
+
258
+ # @!method initialize(class_code: nil, custom_fields: nil, department: nil, dob: nil, emails: nil, employment: nil, employment_status: nil, encrypted_ssn: nil, end_date: nil, ethnicity: nil, first_name: nil, flsa_status: nil, gender: nil, highly_compensated_employee: nil, income: nil, income_history: nil, is_active: nil, key_employee: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, marital_status: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, source_id: nil, ssn: nil, start_date: nil, title: nil, union_code: nil, union_local: nil)
223
259
  # Some parameter documentations has been truncated, see
224
260
  # {FinchAPI::Models::Sandbox::DirectoryCreateParams::Body} for more details.
225
261
  #
@@ -249,12 +285,16 @@ module FinchAPI
249
285
  #
250
286
  # @param gender [Symbol, FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::Gender, nil] The gender of the individual.
251
287
  #
288
+ # @param highly_compensated_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Highly Compensated E
289
+ #
252
290
  # @param income [FinchAPI::Models::Income, nil] The employee's income as reported by the provider. This may not always be annual
253
291
  #
254
292
  # @param income_history [Array<FinchAPI::Models::Income, nil>, nil] The array of income history.
255
293
  #
256
294
  # @param is_active [Boolean, nil] `true` if the individual an an active employee or contractor at the company.
257
295
  #
296
+ # @param key_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Key Employee for top
297
+ #
258
298
  # @param last_name [String, nil] The legal last name of the individual.
259
299
  #
260
300
  # @param latest_rehire_date [String, nil]
@@ -263,6 +303,8 @@ module FinchAPI
263
303
  #
264
304
  # @param manager [FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::Manager, nil] The manager object representing the manager of the individual within the org.
265
305
  #
306
+ # @param marital_status [Symbol, FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::MaritalStatus, nil] The employee's marital status, used for beneficiary designation and spousal cons
307
+ #
266
308
  # @param middle_name [String, nil] The legal middle name of the individual.
267
309
  #
268
310
  # @param phone_numbers [Array<FinchAPI::Models::Sandbox::DirectoryCreateParams::Body::PhoneNumber, nil>, nil]
@@ -278,6 +320,10 @@ module FinchAPI
278
320
  # @param start_date [String, nil]
279
321
  #
280
322
  # @param title [String, nil] The current title of the individual.
323
+ #
324
+ # @param union_code [String, nil] The code identifying the union the employee is a member of, as configured in the
325
+ #
326
+ # @param union_local [String, nil] The local chapter or local number within the employee's union.
281
327
 
282
328
  class CustomField < FinchAPI::Internal::Type::BaseModel
283
329
  # @!attribute name
@@ -508,6 +554,24 @@ module FinchAPI
508
554
  # @param id [String] A stable Finch `id` (UUID v4) for an individual in the company.
509
555
  end
510
556
 
557
+ # The employee's marital status, used for beneficiary designation and spousal
558
+ # consent workflows.
559
+ #
560
+ # @see FinchAPI::Models::Sandbox::DirectoryCreateParams::Body#marital_status
561
+ module MaritalStatus
562
+ extend FinchAPI::Internal::Type::Enum
563
+
564
+ SINGLE = :single
565
+ MARRIED = :married
566
+ DIVORCED = :divorced
567
+ WIDOWED = :widowed
568
+ DOMESTIC_PARTNER = :domestic_partner
569
+ UNKNOWN = :unknown
570
+
571
+ # @!method self.values
572
+ # @return [Array<Symbol>]
573
+ end
574
+
511
575
  class PhoneNumber < FinchAPI::Internal::Type::BaseModel
512
576
  # @!attribute data
513
577
  #
@@ -69,6 +69,13 @@ module FinchAPI
69
69
  # @return [Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::FlsaStatus, nil]
70
70
  optional :flsa_status, enum: -> { FinchAPI::Sandbox::EmploymentUpdateParams::FlsaStatus }, nil?: true
71
71
 
72
+ # @!attribute highly_compensated_employee
73
+ # IRS flag indicating whether the employee is classified as a Highly Compensated
74
+ # Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.
75
+ #
76
+ # @return [Boolean, nil]
77
+ optional :highly_compensated_employee, FinchAPI::Internal::Type::Boolean, nil?: true
78
+
72
79
  # @!attribute income
73
80
  # The employee's income as reported by the provider. This may not always be
74
81
  # annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc,
@@ -91,6 +98,13 @@ module FinchAPI
91
98
  # @return [Boolean, nil]
92
99
  optional :is_active, FinchAPI::Internal::Type::Boolean, nil?: true
93
100
 
101
+ # @!attribute key_employee
102
+ # IRS flag indicating whether the employee is classified as a Key Employee for
103
+ # top-heavy testing purposes. US-only.
104
+ #
105
+ # @return [Boolean, nil]
106
+ optional :key_employee, FinchAPI::Internal::Type::Boolean, nil?: true
107
+
94
108
  # @!attribute last_name
95
109
  # The legal last name of the individual.
96
110
  #
@@ -136,7 +150,20 @@ module FinchAPI
136
150
  # @return [String, nil]
137
151
  optional :title, String, nil?: true
138
152
 
139
- # @!method initialize(individual_id:, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, income: nil, income_history: nil, is_active: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil, request_options: {})
153
+ # @!attribute union_code
154
+ # The code identifying the union the employee is a member of, as configured in the
155
+ # payroll system.
156
+ #
157
+ # @return [String, nil]
158
+ optional :union_code, String, nil?: true
159
+
160
+ # @!attribute union_local
161
+ # The local chapter or local number within the employee's union.
162
+ #
163
+ # @return [String, nil]
164
+ optional :union_local, String, nil?: true
165
+
166
+ # @!method initialize(individual_id:, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, highly_compensated_employee: nil, income: nil, income_history: nil, is_active: nil, key_employee: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil, union_code: nil, union_local: nil, request_options: {})
140
167
  # Some parameter documentations has been truncated, see
141
168
  # {FinchAPI::Models::Sandbox::EmploymentUpdateParams} for more details.
142
169
  #
@@ -158,12 +185,16 @@ module FinchAPI
158
185
  #
159
186
  # @param flsa_status [Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::FlsaStatus, nil] The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `u
160
187
  #
188
+ # @param highly_compensated_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Highly Compensated E
189
+ #
161
190
  # @param income [FinchAPI::Models::Income, nil] The employee's income as reported by the provider. This may not always be annual
162
191
  #
163
192
  # @param income_history [Array<FinchAPI::Models::Income, nil>, nil] The array of income history.
164
193
  #
165
194
  # @param is_active [Boolean, nil] `true` if the individual an an active employee or contractor at the company.
166
195
  #
196
+ # @param key_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Key Employee for top
197
+ #
167
198
  # @param last_name [String, nil] The legal last name of the individual.
168
199
  #
169
200
  # @param latest_rehire_date [String, nil]
@@ -180,6 +211,10 @@ module FinchAPI
180
211
  #
181
212
  # @param title [String, nil] The current title of the individual.
182
213
  #
214
+ # @param union_code [String, nil] The code identifying the union the employee is a member of, as configured in the
215
+ #
216
+ # @param union_local [String, nil] The local chapter or local number within the employee's union.
217
+ #
183
218
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
184
219
 
185
220
  class CustomField < FinchAPI::Internal::Type::BaseModel
@@ -67,6 +67,13 @@ module FinchAPI
67
67
  enum: -> { FinchAPI::Models::Sandbox::EmploymentUpdateResponse::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
+ optional :highly_compensated_employee, FinchAPI::Internal::Type::Boolean, nil?: true
76
+
70
77
  # @!attribute income
71
78
  # The employee's income as reported by the provider. This may not always be
72
79
  # annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc,
@@ -89,6 +96,13 @@ module FinchAPI
89
96
  # @return [Boolean, nil]
90
97
  optional :is_active, FinchAPI::Internal::Type::Boolean, nil?: true
91
98
 
99
+ # @!attribute key_employee
100
+ # IRS flag indicating whether the employee is classified as a Key Employee for
101
+ # top-heavy testing purposes. US-only.
102
+ #
103
+ # @return [Boolean, nil]
104
+ optional :key_employee, FinchAPI::Internal::Type::Boolean, nil?: true
105
+
92
106
  # @!attribute last_name
93
107
  # The legal last name of the individual.
94
108
  #
@@ -134,7 +148,20 @@ module FinchAPI
134
148
  # @return [String, nil]
135
149
  optional :title, String, nil?: true
136
150
 
137
- # @!method initialize(id: nil, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, income: nil, income_history: nil, is_active: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil)
151
+ # @!attribute union_code
152
+ # The code identifying the union the employee is a member of, as configured in the
153
+ # payroll system.
154
+ #
155
+ # @return [String, nil]
156
+ optional :union_code, String, nil?: true
157
+
158
+ # @!attribute union_local
159
+ # The local chapter or local number within the employee's union.
160
+ #
161
+ # @return [String, nil]
162
+ optional :union_local, String, nil?: true
163
+
164
+ # @!method initialize(id: nil, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, highly_compensated_employee: nil, income: nil, income_history: nil, is_active: nil, key_employee: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil, union_code: nil, union_local: nil)
138
165
  # Some parameter documentations has been truncated, see
139
166
  # {FinchAPI::Models::Sandbox::EmploymentUpdateResponse} for more details.
140
167
  #
@@ -156,12 +183,16 @@ module FinchAPI
156
183
  #
157
184
  # @param flsa_status [Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateResponse::FlsaStatus, nil] The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `u
158
185
  #
186
+ # @param highly_compensated_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Highly Compensated E
187
+ #
159
188
  # @param income [FinchAPI::Models::Income, nil] The employee's income as reported by the provider. This may not always be annual
160
189
  #
161
190
  # @param income_history [Array<FinchAPI::Models::Income, nil>, nil] The array of income history.
162
191
  #
163
192
  # @param is_active [Boolean, nil] `true` if the individual an an active employee or contractor at the company.
164
193
  #
194
+ # @param key_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Key Employee for top
195
+ #
165
196
  # @param last_name [String, nil] The legal last name of the individual.
166
197
  #
167
198
  # @param latest_rehire_date [String, nil]
@@ -177,6 +208,10 @@ module FinchAPI
177
208
  # @param start_date [String, nil]
178
209
  #
179
210
  # @param title [String, nil] The current title of the individual.
211
+ #
212
+ # @param union_code [String, nil] The code identifying the union the employee is a member of, as configured in the
213
+ #
214
+ # @param union_local [String, nil] The local chapter or local number within the employee's union.
180
215
 
181
216
  class CustomField < FinchAPI::Internal::Type::BaseModel
182
217
  # @!attribute name
@@ -57,6 +57,15 @@ module FinchAPI
57
57
  # @return [String, nil]
58
58
  optional :last_name, String, nil?: true
59
59
 
60
+ # @!attribute marital_status
61
+ # The employee's marital status, used for beneficiary designation and spousal
62
+ # consent workflows.
63
+ #
64
+ # @return [Symbol, FinchAPI::Models::Sandbox::IndividualUpdateParams::MaritalStatus, nil]
65
+ optional :marital_status,
66
+ enum: -> { FinchAPI::Sandbox::IndividualUpdateParams::MaritalStatus },
67
+ nil?: true
68
+
60
69
  # @!attribute middle_name
61
70
  # The legal middle name of the individual.
62
71
  #
@@ -93,7 +102,7 @@ module FinchAPI
93
102
  # @return [String, nil]
94
103
  optional :ssn, String, nil?: true
95
104
 
96
- # @!method initialize(individual_id:, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil, request_options: {})
105
+ # @!method initialize(individual_id:, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, marital_status: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil, request_options: {})
97
106
  # Some parameter documentations has been truncated, see
98
107
  # {FinchAPI::Models::Sandbox::IndividualUpdateParams} for more details.
99
108
  #
@@ -113,6 +122,8 @@ module FinchAPI
113
122
  #
114
123
  # @param last_name [String, nil] The legal last name of the individual.
115
124
  #
125
+ # @param marital_status [Symbol, FinchAPI::Models::Sandbox::IndividualUpdateParams::MaritalStatus, nil] The employee's marital status, used for beneficiary designation and spousal cons
126
+ #
116
127
  # @param middle_name [String, nil] The legal middle name of the individual.
117
128
  #
118
129
  # @param phone_numbers [Array<FinchAPI::Models::Sandbox::IndividualUpdateParams::PhoneNumber, nil>, nil]
@@ -182,6 +193,22 @@ module FinchAPI
182
193
  # @return [Array<Symbol>]
183
194
  end
184
195
 
196
+ # The employee's marital status, used for beneficiary designation and spousal
197
+ # consent workflows.
198
+ module MaritalStatus
199
+ extend FinchAPI::Internal::Type::Enum
200
+
201
+ SINGLE = :single
202
+ MARRIED = :married
203
+ DIVORCED = :divorced
204
+ WIDOWED = :widowed
205
+ DOMESTIC_PARTNER = :domestic_partner
206
+ UNKNOWN = :unknown
207
+
208
+ # @!method self.values
209
+ # @return [Array<Symbol>]
210
+ end
211
+
185
212
  class PhoneNumber < FinchAPI::Internal::Type::BaseModel
186
213
  # @!attribute data
187
214
  #
@@ -57,6 +57,15 @@ module FinchAPI
57
57
  # @return [String, nil]
58
58
  optional :last_name, String, nil?: true
59
59
 
60
+ # @!attribute marital_status
61
+ # The employee's marital status, used for beneficiary designation and spousal
62
+ # consent workflows.
63
+ #
64
+ # @return [Symbol, FinchAPI::Models::Sandbox::IndividualUpdateResponse::MaritalStatus, nil]
65
+ optional :marital_status,
66
+ enum: -> { FinchAPI::Models::Sandbox::IndividualUpdateResponse::MaritalStatus },
67
+ nil?: true
68
+
60
69
  # @!attribute middle_name
61
70
  # The legal middle name of the individual.
62
71
  #
@@ -90,7 +99,7 @@ module FinchAPI
90
99
  # @return [String, nil]
91
100
  optional :ssn, String, nil?: true
92
101
 
93
- # @!method initialize(id: nil, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil)
102
+ # @!method initialize(id: nil, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, marital_status: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil)
94
103
  # Some parameter documentations has been truncated, see
95
104
  # {FinchAPI::Models::Sandbox::IndividualUpdateResponse} for more details.
96
105
  #
@@ -110,6 +119,8 @@ module FinchAPI
110
119
  #
111
120
  # @param last_name [String, nil] The legal last name of the individual.
112
121
  #
122
+ # @param marital_status [Symbol, FinchAPI::Models::Sandbox::IndividualUpdateResponse::MaritalStatus, nil] The employee's marital status, used for beneficiary designation and spousal cons
123
+ #
113
124
  # @param middle_name [String, nil] The legal middle name of the individual.
114
125
  #
115
126
  # @param phone_numbers [Array<FinchAPI::Models::Sandbox::IndividualUpdateResponse::PhoneNumber, nil>, nil]
@@ -181,6 +192,24 @@ module FinchAPI
181
192
  # @return [Array<Symbol>]
182
193
  end
183
194
 
195
+ # The employee's marital status, used for beneficiary designation and spousal
196
+ # consent workflows.
197
+ #
198
+ # @see FinchAPI::Models::Sandbox::IndividualUpdateResponse#marital_status
199
+ module MaritalStatus
200
+ extend FinchAPI::Internal::Type::Enum
201
+
202
+ SINGLE = :single
203
+ MARRIED = :married
204
+ DIVORCED = :divorced
205
+ WIDOWED = :widowed
206
+ DOMESTIC_PARTNER = :domestic_partner
207
+ UNKNOWN = :unknown
208
+
209
+ # @!method self.values
210
+ # @return [Array<Symbol>]
211
+ end
212
+
184
213
  class PhoneNumber < FinchAPI::Internal::Type::BaseModel
185
214
  # @!attribute data
186
215
  #
@@ -9,7 +9,7 @@ module FinchAPI
9
9
  #
10
10
  # Update sandbox employment
11
11
  #
12
- # @overload update(individual_id, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, income: nil, income_history: nil, is_active: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil, request_options: {})
12
+ # @overload update(individual_id, class_code: nil, custom_fields: nil, department: nil, employment: nil, employment_status: nil, end_date: nil, first_name: nil, flsa_status: nil, highly_compensated_employee: nil, income: nil, income_history: nil, is_active: nil, key_employee: nil, last_name: nil, latest_rehire_date: nil, location: nil, manager: nil, middle_name: nil, source_id: nil, start_date: nil, title: nil, union_code: nil, union_local: nil, request_options: {})
13
13
  #
14
14
  # @param individual_id [String]
15
15
  #
@@ -29,12 +29,16 @@ module FinchAPI
29
29
  #
30
30
  # @param flsa_status [Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::FlsaStatus, nil] The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `u
31
31
  #
32
+ # @param highly_compensated_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Highly Compensated E
33
+ #
32
34
  # @param income [FinchAPI::Models::Income, nil] The employee's income as reported by the provider. This may not always be annual
33
35
  #
34
36
  # @param income_history [Array<FinchAPI::Models::Income, nil>, nil] The array of income history.
35
37
  #
36
38
  # @param is_active [Boolean, nil] `true` if the individual an an active employee or contractor at the company.
37
39
  #
40
+ # @param key_employee [Boolean, nil] IRS flag indicating whether the employee is classified as a Key Employee for top
41
+ #
38
42
  # @param last_name [String, nil] The legal last name of the individual.
39
43
  #
40
44
  # @param latest_rehire_date [String, nil]
@@ -51,6 +55,10 @@ module FinchAPI
51
55
  #
52
56
  # @param title [String, nil] The current title of the individual.
53
57
  #
58
+ # @param union_code [String, nil] The code identifying the union the employee is a member of, as configured in the
59
+ #
60
+ # @param union_local [String, nil] The local chapter or local number within the employee's union.
61
+ #
54
62
  # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
55
63
  #
56
64
  # @return [FinchAPI::Models::Sandbox::EmploymentUpdateResponse]
@@ -9,7 +9,7 @@ module FinchAPI
9
9
  #
10
10
  # Update sandbox individual
11
11
  #
12
- # @overload update(individual_id, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil, request_options: {})
12
+ # @overload update(individual_id, dob: nil, emails: nil, encrypted_ssn: nil, ethnicity: nil, first_name: nil, gender: nil, last_name: nil, marital_status: nil, middle_name: nil, phone_numbers: nil, preferred_name: nil, residence: nil, ssn: nil, request_options: {})
13
13
  #
14
14
  # @param individual_id [String]
15
15
  #
@@ -27,6 +27,8 @@ module FinchAPI
27
27
  #
28
28
  # @param last_name [String, nil] The legal last name of the individual.
29
29
  #
30
+ # @param marital_status [Symbol, FinchAPI::Models::Sandbox::IndividualUpdateParams::MaritalStatus, nil] The employee's marital status, used for beneficiary designation and spousal cons
31
+ #
30
32
  # @param middle_name [String, nil] The legal middle name of the individual.
31
33
  #
32
34
  # @param phone_numbers [Array<FinchAPI::Models::Sandbox::IndividualUpdateParams::PhoneNumber, nil>, nil]
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module FinchAPI
4
- VERSION = "0.1.0.pre.alpha.49"
4
+ VERSION = "0.1.0.pre.alpha.50"
5
5
  end