ODBC Driver for QuickBooks

Build 24.0.9175

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.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 24.0.9175