merge_hris_client 2.0.4 → 3.2.2

data/lib/merge_hris_client/models/employee.rb

@@ -14,16 +14,23 @@ require 'date'
 require 'time'
 
 module MergeHRISClient
-  # # The Employee Object ### Description The `Employee` object is used to represent an Employee for a company.  ### Usage Example Fetch from the `LIST Employee` endpoint and filter by `ID` to show all employees.
+  # # The Employee Object ### Description The `Employee` object is used to represent any person who has been employed by a company.  ### Usage Example Fetch from the `LIST Employee` endpoint and filter by `ID` to show all employees.
   class Employee
     attr_accessor :id
 
     # The third-party API ID of the matching object.
     attr_accessor :remote_id
 
-    # The employee's number that appears in the remote UI. Note: This is distinct from the remote_id field, which is a unique identifier for the employee set by the remote API, and is not exposed to the user. This value can also change in many API providers.
+    # The datetime that this object was created by Merge.
+    attr_accessor :created_at
+
+    # The datetime that this object was modified by Merge.
+    attr_accessor :modified_at
+
+    # The employee's number that appears in the third-party integration's UI.
     attr_accessor :employee_number
 
+    # The ID of the employee's company.
     attr_accessor :company
 
     # The employee's first name.
@@ -32,9 +39,15 @@ module MergeHRISClient
     # The employee's last name.
     attr_accessor :last_name
 
+    # The employee's preferred first name.
+    attr_accessor :preferred_name
+
     # The employee's full name, to use for display purposes. If a preferred first name is available, the full name will include the preferred first name.
     attr_accessor :display_full_name
 
+    # The employee's username that appears in the remote UI.
+    attr_accessor :username
+
     attr_accessor :groups
 
     # The employee's work email.
@@ -49,26 +62,31 @@ module MergeHRISClient
     # Array of `Employment` IDs for this Employee.
     attr_accessor :employments
 
+    # The employee's home address.
     attr_accessor :home_location
 
+    # The employee's work address.
     attr_accessor :work_location
 
+    # The employee ID of the employee's manager.
     attr_accessor :manager
 
+    # The employee's team.
     attr_accessor :team
 
+    # The employee's pay group
     attr_accessor :pay_group
 
     # The employee's social security number.
     attr_accessor :ssn
 
-    # The employee's gender.
+    # The employee's gender.  * `MALE` - MALE * `FEMALE` - FEMALE * `NON-BINARY` - NON-BINARY * `OTHER` - OTHER * `PREFER_NOT_TO_DISCLOSE` - PREFER_NOT_TO_DISCLOSE
     attr_accessor :gender
 
-    # The employee's ethnicity.
+    # The employee's ethnicity.  * `AMERICAN_INDIAN_OR_ALASKA_NATIVE` - AMERICAN_INDIAN_OR_ALASKA_NATIVE * `ASIAN_OR_INDIAN_SUBCONTINENT` - ASIAN_OR_INDIAN_SUBCONTINENT * `BLACK_OR_AFRICAN_AMERICAN` - BLACK_OR_AFRICAN_AMERICAN * `HISPANIC_OR_LATINO` - HISPANIC_OR_LATINO * `NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER` - NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER * `TWO_OR_MORE_RACES` - TWO_OR_MORE_RACES * `WHITE` - WHITE * `PREFER_NOT_TO_DISCLOSE` - PREFER_NOT_TO_DISCLOSE
     attr_accessor :ethnicity
 
-    # The employee's marital status.
+    # The employee's filing status as related to marital status.  * `SINGLE` - SINGLE * `MARRIED_FILING_JOINTLY` - MARRIED_FILING_JOINTLY * `MARRIED_FILING_SEPARATELY` - MARRIED_FILING_SEPARATELY * `HEAD_OF_HOUSEHOLD` - HEAD_OF_HOUSEHOLD * `QUALIFYING_WIDOW_OR_WIDOWER_WITH_DEPENDENT_CHILD` - QUALIFYING_WIDOW_OR_WIDOWER_WITH_DEPENDENT_CHILD
     attr_accessor :marital_status
 
     # The employee's date of birth.
@@ -77,10 +95,13 @@ module MergeHRISClient
     # The date that the employee was hired, usually the day that an offer letter is signed. If an employee has multiple hire dates from previous employments, this represents the most recent hire date. Note: If you're looking for the employee's start date, refer to the start_date field.
     attr_accessor :hire_date
 
-    # The date that the employee started working. If an employee has multiple start dates from previous employments, this represents the most recent start date.
+    # The date that the employee started working. If an employee was rehired, the most recent start date will be returned.
     attr_accessor :start_date
 
-    # The employment status of the employee.
+    # When the third party's employee was created.
+    attr_accessor :remote_created_at
+
+    # The employment status of the employee.  * `ACTIVE` - ACTIVE * `PENDING` - PENDING * `INACTIVE` - INACTIVE
     attr_accessor :employment_status
 
     # The employee's termination date.
@@ -89,23 +110,29 @@ module MergeHRISClient
     # The URL of the employee's avatar image.
     attr_accessor :avatar
 
-    attr_accessor :remote_data
-
     # Custom fields configured for a given model.
     attr_accessor :custom_fields
 
     attr_accessor :remote_was_deleted
 
+    attr_accessor :field_mappings
+
+    attr_accessor :remote_data
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'id' => :'id',
         :'remote_id' => :'remote_id',
+        :'created_at' => :'created_at',
+        :'modified_at' => :'modified_at',
         :'employee_number' => :'employee_number',
         :'company' => :'company',
         :'first_name' => :'first_name',
         :'last_name' => :'last_name',
+        :'preferred_name' => :'preferred_name',
         :'display_full_name' => :'display_full_name',
+        :'username' => :'username',
         :'groups' => :'groups',
         :'work_email' => :'work_email',
         :'personal_email' => :'personal_email',
@@ -123,12 +150,14 @@ module MergeHRISClient
         :'date_of_birth' => :'date_of_birth',
         :'hire_date' => :'hire_date',
         :'start_date' => :'start_date',
+        :'remote_created_at' => :'remote_created_at',
         :'employment_status' => :'employment_status',
         :'termination_date' => :'termination_date',
         :'avatar' => :'avatar',
-        :'remote_data' => :'remote_data',
         :'custom_fields' => :'custom_fields',
-        :'remote_was_deleted' => :'remote_was_deleted'
+        :'remote_was_deleted' => :'remote_was_deleted',
+        :'field_mappings' => :'field_mappings',
+        :'remote_data' => :'remote_data'
       }
     end
 
@@ -142,11 +171,15 @@ module MergeHRISClient
       {
         :'id' => :'String',
         :'remote_id' => :'String',
+        :'created_at' => :'Time',
+        :'modified_at' => :'Time',
         :'employee_number' => :'String',
         :'company' => :'String',
         :'first_name' => :'String',
         :'last_name' => :'String',
+        :'preferred_name' => :'String',
         :'display_full_name' => :'String',
+        :'username' => :'String',
         :'groups' => :'Array<String>',
         :'work_email' => :'String',
         :'personal_email' => :'String',
@@ -164,12 +197,14 @@ module MergeHRISClient
         :'date_of_birth' => :'Time',
         :'hire_date' => :'Time',
         :'start_date' => :'Time',
+        :'remote_created_at' => :'Time',
         :'employment_status' => :'EmploymentStatusEnum',
         :'termination_date' => :'Time',
         :'avatar' => :'String',
-        :'remote_data' => :'Array<RemoteData>',
-        :'custom_fields' => :'Hash<String, AnyType>',
-        :'remote_was_deleted' => :'Boolean'
+        :'custom_fields' => :'Hash<String, Object>',
+        :'remote_was_deleted' => :'Boolean',
+        :'field_mappings' => :'Object',
+        :'remote_data' => :'Array<RemoteData>'
       }
     end
 
@@ -181,7 +216,9 @@ module MergeHRISClient
         :'company',
         :'first_name',
         :'last_name',
+        :'preferred_name',
         :'display_full_name',
+        :'username',
         :'work_email',
         :'personal_email',
         :'mobile_phone_number',
@@ -197,11 +234,13 @@ module MergeHRISClient
         :'date_of_birth',
         :'hire_date',
         :'start_date',
+        :'remote_created_at',
         :'employment_status',
         :'termination_date',
         :'avatar',
-        :'remote_data',
         :'custom_fields',
+        :'field_mappings',
+        :'remote_data'
       ])
     end
 
@@ -228,6 +267,14 @@ module MergeHRISClient
         self.remote_id = attributes[:'remote_id']
       end
 
+      if attributes.key?(:'created_at')
+        self.created_at = attributes[:'created_at']
+      end
+
+      if attributes.key?(:'modified_at')
+        self.modified_at = attributes[:'modified_at']
+      end
+
       if attributes.key?(:'employee_number')
         self.employee_number = attributes[:'employee_number']
       end
@@ -244,10 +291,18 @@ module MergeHRISClient
         self.last_name = attributes[:'last_name']
       end
 
+      if attributes.key?(:'preferred_name')
+        self.preferred_name = attributes[:'preferred_name']
+      end
+
       if attributes.key?(:'display_full_name')
         self.display_full_name = attributes[:'display_full_name']
       end
 
+      if attributes.key?(:'username')
+        self.username = attributes[:'username']
+      end
+
       if attributes.key?(:'groups')
         if (value = attributes[:'groups']).is_a?(Array)
           self.groups = value
@@ -320,6 +375,10 @@ module MergeHRISClient
         self.start_date = attributes[:'start_date']
       end
 
+      if attributes.key?(:'remote_created_at')
+        self.remote_created_at = attributes[:'remote_created_at']
+      end
+
       if attributes.key?(:'employment_status')
         self.employment_status = attributes[:'employment_status']
       end
@@ -332,12 +391,6 @@ module MergeHRISClient
         self.avatar = attributes[:'avatar']
       end
 
-      if attributes.key?(:'remote_data')
-        if (value = attributes[:'remote_data']).is_a?(Array)
-          self.remote_data = value
-        end
-      end
-
       if attributes.key?(:'custom_fields')
         if (value = attributes[:'custom_fields']).is_a?(Hash)
           self.custom_fields = value
@@ -347,6 +400,16 @@ module MergeHRISClient
       if attributes.key?(:'remote_was_deleted')
         self.remote_was_deleted = attributes[:'remote_was_deleted']
       end
+
+      if attributes.key?(:'field_mappings')
+        self.field_mappings = attributes[:'field_mappings']
+      end
+
+      if attributes.key?(:'remote_data')
+        if (value = attributes[:'remote_data']).is_a?(Array)
+          self.remote_data = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -429,11 +492,15 @@ module MergeHRISClient
       self.class == o.class &&
           id == o.id &&
           remote_id == o.remote_id &&
+          created_at == o.created_at &&
+          modified_at == o.modified_at &&
           employee_number == o.employee_number &&
           company == o.company &&
           first_name == o.first_name &&
           last_name == o.last_name &&
+          preferred_name == o.preferred_name &&
           display_full_name == o.display_full_name &&
+          username == o.username &&
           groups == o.groups &&
           work_email == o.work_email &&
           personal_email == o.personal_email &&
@@ -451,12 +518,14 @@ module MergeHRISClient
           date_of_birth == o.date_of_birth &&
           hire_date == o.hire_date &&
           start_date == o.start_date &&
+          remote_created_at == o.remote_created_at &&
           employment_status == o.employment_status &&
           termination_date == o.termination_date &&
           avatar == o.avatar &&
-          remote_data == o.remote_data &&
           custom_fields == o.custom_fields &&
-          remote_was_deleted == o.remote_was_deleted
+          remote_was_deleted == o.remote_was_deleted &&
+          field_mappings == o.field_mappings &&
+          remote_data == o.remote_data
     end
 
     # @see the `==` method
@@ -468,7 +537,7 @@ module MergeHRISClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, remote_id, employee_number, company, first_name, last_name, display_full_name, groups, work_email, personal_email, mobile_phone_number, employments, home_location, work_location, manager, team, pay_group, ssn, gender, ethnicity, marital_status, date_of_birth, hire_date, start_date, employment_status, termination_date, avatar, remote_data, custom_fields, remote_was_deleted].hash
+      [id, remote_id, created_at, modified_at, employee_number, company, first_name, last_name, preferred_name, display_full_name, username, groups, work_email, personal_email, mobile_phone_number, employments, home_location, work_location, manager, team, pay_group, ssn, gender, ethnicity, marital_status, date_of_birth, hire_date, start_date, remote_created_at, employment_status, termination_date, avatar, custom_fields, remote_was_deleted, field_mappings, remote_data].hash
     end
 
     # Builds the object from hash

data/lib/merge_hris_client/models/employee_payroll_run.rb

@@ -14,21 +14,29 @@ require 'date'
 require 'time'
 
 module MergeHRISClient
-  # # The EmployeePayrollRun Object ### Description The `EmployeePayrollRun` object is used to represent a payroll run for a specific employee.  ### Usage Example Fetch from the `LIST EmployeePayrollRun` endpoint and filter by `ID` to show all employee payroll runs.
+  # # The EmployeePayrollRun Object ### Description The `EmployeePayrollRun` object is used to represent an employee's pay statement for a specific payroll run.  ### Usage Example Fetch from the `LIST EmployeePayrollRun` endpoint and filter by `ID` to show all employee payroll runs.
   class EmployeePayrollRun
     attr_accessor :id
 
     # The third-party API ID of the matching object.
     attr_accessor :remote_id
 
+    # The datetime that this object was created by Merge.
+    attr_accessor :created_at
+
+    # The datetime that this object was modified by Merge.
+    attr_accessor :modified_at
+
+    # The employee whose payroll is being run.
     attr_accessor :employee
 
+    # The payroll being run.
     attr_accessor :payroll_run
 
-    # The gross pay from the run.
+    # The total earnings throughout a given period for an employee before any deductions are made.
     attr_accessor :gross_pay
 
-    # The net pay from the run.
+    # The take-home pay throughout a given period for an employee after deductions are made.
     attr_accessor :net_pay
 
     # The day and time the payroll run started.
@@ -46,16 +54,20 @@ module MergeHRISClient
 
     attr_accessor :taxes
 
-    attr_accessor :remote_data
-
-    # Indicates whether or not this object has been deleted by third party webhooks.
+    # Indicates whether or not this object has been deleted in the third party platform.
     attr_accessor :remote_was_deleted
 
+    attr_accessor :field_mappings
+
+    attr_accessor :remote_data
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'id' => :'id',
         :'remote_id' => :'remote_id',
+        :'created_at' => :'created_at',
+        :'modified_at' => :'modified_at',
         :'employee' => :'employee',
         :'payroll_run' => :'payroll_run',
         :'gross_pay' => :'gross_pay',
@@ -66,8 +78,9 @@ module MergeHRISClient
         :'earnings' => :'earnings',
         :'deductions' => :'deductions',
         :'taxes' => :'taxes',
-        :'remote_data' => :'remote_data',
-        :'remote_was_deleted' => :'remote_was_deleted'
+        :'remote_was_deleted' => :'remote_was_deleted',
+        :'field_mappings' => :'field_mappings',
+        :'remote_data' => :'remote_data'
       }
     end
 
@@ -81,6 +94,8 @@ module MergeHRISClient
       {
         :'id' => :'String',
         :'remote_id' => :'String',
+        :'created_at' => :'Time',
+        :'modified_at' => :'Time',
         :'employee' => :'String',
         :'payroll_run' => :'String',
         :'gross_pay' => :'Float',
@@ -91,8 +106,9 @@ module MergeHRISClient
         :'earnings' => :'Array<Earning>',
         :'deductions' => :'Array<Deduction>',
         :'taxes' => :'Array<Tax>',
-        :'remote_data' => :'Array<RemoteData>',
-        :'remote_was_deleted' => :'Boolean'
+        :'remote_was_deleted' => :'Boolean',
+        :'field_mappings' => :'Object',
+        :'remote_data' => :'Array<RemoteData>'
       }
     end
 
@@ -107,7 +123,8 @@ module MergeHRISClient
         :'start_date',
         :'end_date',
         :'check_date',
-        :'remote_data',
+        :'field_mappings',
+        :'remote_data'
       ])
     end
 
@@ -134,6 +151,14 @@ module MergeHRISClient
         self.remote_id = attributes[:'remote_id']
       end
 
+      if attributes.key?(:'created_at')
+        self.created_at = attributes[:'created_at']
+      end
+
+      if attributes.key?(:'modified_at')
+        self.modified_at = attributes[:'modified_at']
+      end
+
       if attributes.key?(:'employee')
         self.employee = attributes[:'employee']
       end
@@ -180,15 +205,19 @@ module MergeHRISClient
         end
       end
 
+      if attributes.key?(:'remote_was_deleted')
+        self.remote_was_deleted = attributes[:'remote_was_deleted']
+      end
+
+      if attributes.key?(:'field_mappings')
+        self.field_mappings = attributes[:'field_mappings']
+      end
+
       if attributes.key?(:'remote_data')
         if (value = attributes[:'remote_data']).is_a?(Array)
           self.remote_data = value
         end
       end
-
-      if attributes.key?(:'remote_was_deleted')
-        self.remote_was_deleted = attributes[:'remote_was_deleted']
-      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -211,6 +240,8 @@ module MergeHRISClient
       self.class == o.class &&
           id == o.id &&
           remote_id == o.remote_id &&
+          created_at == o.created_at &&
+          modified_at == o.modified_at &&
           employee == o.employee &&
           payroll_run == o.payroll_run &&
           gross_pay == o.gross_pay &&
@@ -221,8 +252,9 @@ module MergeHRISClient
           earnings == o.earnings &&
           deductions == o.deductions &&
           taxes == o.taxes &&
-          remote_data == o.remote_data &&
-          remote_was_deleted == o.remote_was_deleted
+          remote_was_deleted == o.remote_was_deleted &&
+          field_mappings == o.field_mappings &&
+          remote_data == o.remote_data
     end
 
     # @see the `==` method
@@ -234,7 +266,7 @@ module MergeHRISClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, remote_id, employee, payroll_run, gross_pay, net_pay, start_date, end_date, check_date, earnings, deductions, taxes, remote_data, remote_was_deleted].hash
+      [id, remote_id, created_at, modified_at, employee, payroll_run, gross_pay, net_pay, start_date, end_date, check_date, earnings, deductions, taxes, remote_was_deleted, field_mappings, remote_data].hash
     end
 
     # Builds the object from hash