EmployeeEarnings
Facilitates the management of QuickBooks Employee Earnings, supporting creation, updates, deletion, and queries for payroll tracking.
Table Specific Information
The Ids for the EmployeeEarnings table operate a bit differently than Line Items. Unlike Line Items, QuickBooks does not return a unique Id for EmployeeEarnings. Instead, each EmployeeEarnings entry is returned in a specific order, and Employee Earnings entries can be updated in that order back to QuickBooks. To give the Employee Earnings unique Ids, we have appended the index number of each EmployeeEarnings entry to the Id. It will be up to the programmer to ensure that any modifications to Employee entries through the QuickBooks UI (or another application between a SELECT and an UPDATE call) are handled.
Select
By default, SupportEnhancedSQL is set to true, and the following will be honored if present. Other filters will be executed client side. If SupportEnhancedSQL is set to false, only the following filters will be honored.
QuickBooks allows only a small subset of columns to be used in the WHERE clause of a SELECT query. These columns can typically be used with only the equals or = comparison. The available columns for Employees are Id, Name, and IsActive. TimeModified may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. Name may be used with the = or LIKE conditions to establish a starts-with, ends-with, or contains syntax. For example:
SELECT * FROM EmployeeEarnings WHERE Name LIKE '%George%' AND TimeModified > '1/1/2011' AND TimeModified < '2/1/2011'
Insert
To add an EmployeeEarnings entry, specify the EmployeeId field in the INSERT statement. If you instead specify the Employee Name, the driver will attempt to add a new Employee. For example:
INSERT INTO EmployeeEarnings (Name, EarningsWageName, EarningsRate) VALUES ('370000-933272659', 'Regular Pay', 21.32)
Columns
Name | Type | ReadOnly | References | ColumnSize | Description |
ID [KEY] | String | True | 255 |
The unique identifier for the employee earnings record, formatted as EmployeeId|EmployeeEarningsId. | |
Name | String | True | 255 |
The name of the employee associated with the earnings record. | |
PayPeriod | String | False | 255 |
Specifies the frequency of employee payments, such as weekly, biweekly, or monthly. The allowed values are Daily, Weekly, Biweekly, Semimonthly, Monthly, Quarterly, Yearly. | |
EmployeeId | String | False |
Employees.ID | 255 |
The unique identifier for the employee. This field is required when inserting a new earnings entry. |
EarningsId | String | True | 255 |
The unique identifier for the specific employee earnings entry. | |
EarningsWageName | String | False | 31 |
The name of the wage or earning type, such as 'Regular Hours' or 'Overtime.' This field is required when inserting a new entry. | |
EarningsWageId | String | False | 255 |
A reference identifier for the specific wage or earning type, used for payroll processing. | |
EarningsRate | Double | False |
The rate of pay for the employee's earnings, typically in the format of hourly or salary rates. | ||
EarningsRatePercent | String | False |
The percentage rate for specific earnings, such as commission or bonus calculations, if applicable. | ||
TimeModified | Datetime | True |
The timestamp indicating when this employee earnings record was last modified. | ||
TimeCreated | Datetime | True |
The timestamp indicating when this employee earnings record was created. |