An employee type is a user-defined or default type for an employee, usually related to payroll requirements. Examples include full time, part time, intern, and so forth.


List Employee Types

readByQuery

<readByQuery>
    <object>EMPLOYEETYPE</object>
    <fields>*</fields>
    <query></query>
    <pagesize>100</pagesize>
</readByQuery>
<readByQuery>
    <object>EMPLOYEETYPE</object>
    <fields>*</fields>
    <query>FORM1099TYPE = 'DIV'</query>
    <pagesize>100</pagesize>
</readByQuery>

Parameters

Name Required Type Description
object Required string Use EMPLOYEETYPE
fields Required string Comma separated list of fields on the object to list. Use * to return all fields.
query Required string SQL-like query based on fields on the object. Illegal XML characters must be properly encoded. The following SQL operators are supported: <, >, >=, <=, =, like, not like, in, not in. When doing NULL comparisons: IS NOT NULL, IS NULL. Multiple fields may be matched using the AND and OR operators. Joins are not supported. Single quotes in any operands must be escaped with a backslash - For example, the value Erik's Deli would become 'Erik\'s Deli'.
pagesize Optional integer Set a custom page size between 1 and 1000 items (Default: 100)

query

Name Required Type Description
FORM1099TYPE Optional string Form 1099 types. Use:
DIV for dividend Income (Form 1099-DIV)
INT for interest income (Form 1099-INT)
MISC for miscellaneous income (Form 1099-MISC)
R for distributions from pensions, annuities …(Form 1099-R)
S for proceeds from real estate transactions (Form 1099-S)
PATR for taxable distributions received (Form 1099-PATR)
G for certain government payments (Form 1099-G)
W-2G for certain gambling winnings (Form W-2G)
Name Required Type Description
FORM1099BOX Optional string Form 1099-DIV box values. Use:
1A for 1a - Total Ordinary dividends
1B for 1b - Qualified dividends
2A for 2a - Total capital gain distr
2B for 2b - Unrecap. sec. 1250 gain
2C for 2c - Section 1202 gain
2D for 2d - Collectibles (28%) gain
3 for 3 - Nontaxable distributions
4 for 4 - Federal income tax withheld
5 for 5 - Investment expenses
6 for 6 - Foreign tax paid
8 for 8 - Cash liquidation distr
9 for 9 - Noncash liquidation distr
10 for 10 - Exempt-interest dividends
11 for 11 - Specified private activity bond interest dividends
14 for 14 - State tax withheld
Name Required Type Description
FORM1099BOX Optional string Form 1099-INV box values. Use:
1 for 1 - Interest income
2 for 2 - Early withdrawal penalty
3 for 3 - Interest on U.S. Savings Bonds and Treasury obligations
4 for 4 - Federal income tax withheld
5 for 5 - Investment expenses
6 for 6 - Foreign tax paid
8 for 8 - Tax-exempt interest
9 for 9 - Specified private activity bond interest
10 for 10 - Market Discount
11 for 11 - Bond premium
15 for 15 - State tax withheld
Name Required Type Description
FORM1099BOX Optional string Form 1099-MISC box values. Use:
1 for 1 - Rents
2 for 2 - Royalties
3 for 3 - Other income
4 for 4 - Federal income tax withheld
5 for 5 - Fishing boat proceeds
6 for 6 - Medical and health care payments
7 for 7 - Nonemployee compensation
8 for 8 - Substitute payments in lieu of dividends or interest
10 for 10 - Crop insurance proceeds
13 for 13 - Excess golden parachute payments
14 for 14 - Gross proceeds paid to an attorney
15A for 15a - Section 409A deferrals
15B for 15b - Section 409A income
16 for 16 - State tax withheld
18 for 18 - State income
Name Required Type Description
FORM1099BOX Optional string Form 1099-R box values. Use:
1 for 1 - Gross distribution
2A for 2a - Taxable amount
3 for 3 - Capital gain (included in box 2a)
4 for 4 - Federal income tax withheld
5 for 5 - Employee contributions or insurance premiums
6 for 6 - Net unrealized appreciation in employer’s securities
8 for 8 - Other
9B for 9b - Total employee contributions
10 for 10 - Amount allocable to IRR within 5 years
12 for 12 - State tax withheld
14 for 14 - State distribution
15 for 15 - Local tax withheld
17 for17 - Local distribution
Name Required Type Description
FORM1099BOX Optional string Form 1099-S box values. Use:
2 for 2 - Gross proceeds
5 for 5 - Buyer’s part of real estate tax
Name Required Type Description
FORM1099BOX Optional string Form 1099-PATR box values. Use:
1 for 1 - Patronage dividends
2 for 2 - NonPatronage dividends
3 for 3 - Per-unit retain allocations
4 for 4 - Federal income tax withheld
5 for 5 - Redemptions of nonqualified notices and retain allocations
6 for 6 - Domestic production activities deduction
7 for 7 - Investment credit
8 for 8 - Work opportunity credit
9 for 9 - Patron’s AMT adjustments
10 for 10 - Other credits and deductions
Name Required Type Description
FORM1099BOX Optional string Form 1099-G box values. Use:
1 for 1- Unemployment compensation
2 for 2 - State or local income tax refunds, credits or offsets
4 for 4 - Federal income tax withheld
5 for 5 - ATAA payments
6 for 6 - Taxable grant
7 for 7 - Agricultural payments
9 for 9 - Market Gain
Name Required Type Description
FORM1099BOX Optional string Form W-2G box values. Use:
1 for 1 - Gross Winnings
4 for 4 - Federal income tax withheld
7 for 7 - Winnings from identical wagers
14 for 14 - State winnings
15 for 15 - State income tax withheld
16 for 16 - Local winnings
17 for 17 - Local income tax withheld

Get Employee Type

read

<read>
    <object>EMPLOYEETYPE</object>
    <keys>1</keys>
    <fields>*</fields>
</read>

Parameters

Name Required Type Description
object Required string Use EMPLOYEETYPE
keys Required string The object RECORDNO to get
fields Required string Comma separated list of fields on the object to get. Use * to return all fields.

Get Employee Type by Name

readByName

<readByName>
    <object>EMPLOYEETYPE</object>
    <keys>Full Time</keys>
    <fields>*</fields>
</readByName>

Parameters

Name Required Type Description
object Required string Use EMPLOYEETYPE
keys Required string The object NAME to get
fields Required string Comma separated list of fields on the object to get. Use * to return all fields.

Provide feedback