ADO.NET Provider for QuickBooks

Build 21.0.7930

Items

Create, update, delete, and query QuickBooks Items.

Table Specific Information

This table has a Custom Fields column. See the Custom Fields page for more information.

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 only be used with the equals or = comparison. The available columns for Items are Id, TimeModified, FullName, Type, and IsActive. TimeModified may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. FullName may be used with the = or LIKE conditions to establish a starts-with, ends-with, or contains syntax. For example:

SELECT * FROM Items WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011' AND FullName LIKE '%12345%'

Insert

When inserting the Item, specify the Type and Name fields. Depending on the Type, other columns may also be required in the insertion. See the list below to see which columns are required for special cases:

  • FixedAsset: Requires Name, Type, AcquiredAs, PurchaseDesc, and PurchaseDate.
  • SalesTaxGroup: Requires Name, Type, and at least one SalesTax Line Item. SalesTaxGroups must be inserted via the ItemLineItems table.

Columns

Name Type ReadOnly References ColumnSize Description
ID [KEY] String True 255

The unique identifier.

Name String False 31

The name of the item.

FullName String True 159

Full item name in the format parentname:name if the item is a subitem.

Type String False 100

The type of item. This is required to have a value when inserting.

The allowed values are Unknown, Service, Inventory, NonInventory, Payment, Discount, SalesTax, SubTotal, OtherCharge, InventoryAssembly, Group, SalesTaxGroup, FixedAsset.

The default value is ALL.

Account String False

Accounts.FullName

1000

Account name the item is associated with.

AccountId String False

Accounts.ID

255

Account Id the item is associated with.

COGSAccount String False

Accounts.FullName

1000

Cost of Goods Sold account for the item.

COGSAccountId String False

Accounts.ID

255

Cost of Goods Sold account for the item.

AssetAccount String False

Accounts.FullName

1000

Inventory asset account for the item if it is an inventory item.

AssetAccountId String False

Accounts.ID

255

Inventory asset account for the item if it is an inventory item.

Class String False

Class.FullName

1000

A reference to the class of the item.

ClassId String False

Class.ID

255

A reference to the class of the item.

DateSold Datetime False

Indicates the date an asset was sold. This is required for fixed asset items. It is not used for any other types of items.

PurchaseDate Date False

Indicates date asset was purchased. This field is required for the fixed-asset item type. It is not used by any other item type.

ItemCount Integer False

The number of line items associated with the inventory assembly.

ParentName String False

Items.FullName

The parent name of the item if the item is a subitem.

ParentId String False

Items.ID

255

The parent Id of the item if the item is a subitem.

Description String False 5000

A description of the item.

Price Double False

The price for the item.

PricePercent Double False

A price percent for this item (you might use a price percent if, for example, you are a service shop that calculates labor costs as a percentage of parts costs). If you set PricePercent, Price will be set to zero. Not used for payment, sales tax, or subtotal items.

AverageCost Double True

The average cost of the item.

IsActive Boolean False

Whether the item is active or not.

PurchaseCost Double False

Purchase cost for the item.

PurchaseDescription String False 5000

Purchase description for the item.

ExpenseAccount String False

Accounts.FullName

1000

Expense account for the item.

ExpenseAccountId String False

Accounts.ID

255

Expense account for the item.

PreferredVendor String False

Vendors.Name

1000

Preferred vendor for the item.

PreferredVendorId String False

Vendors.ID

255

Preferred vendor for the item.

QuantityOnHand Double True

Quantity in stock for this inventory item.

QuantityOnOrder Double True

The number of these items that have been ordered from vendors, but not received.

QuantityOnSalesOrder Double True

The number of these items that have been ordered by customers, but not delivered.

InventoryDate Date False

The date when the item was converted into an inventory item.

ReorderPoint Double False

Quantity at which the user will be reminded to reorder this inventory item.

Barcode String False 50

Barcode for the item.

TaxCode String False

SalesTaxCodes.Name

3

Reference to a sales tax code predefined within QuickBooks.

TaxCodeId String False

SalesTaxCodes.ID

255

Reference to a sales tax code predefined within QuickBooks.

IsTaxIncluded Boolean False

Determines if tax is included in the transaction amount. Available in only international editions of QuickBooks.

PurchaseTaxCode String False

SalesTaxCodes.Name

3

Reference to a purchase tax code predefined within QuickBooks. Only available in international versions of QuickBooks.

PurchaseTaxCodeId String False

SalesTaxCodes.ID

255

This is a reference to a purchase tax code predefined within QuickBooks. Available in only international versions of QuickBooks.

PartNumber String False 31

The manufacturer's part number for the item. This property requires QBXML Version 7.0 or higher and is only applicable to inventory and noninventory item types.

PaymentMethodName String False

PaymentMethods.Name

100

The method of payment: check, credit card, etc.

PaymentMethodId String False

PaymentMethods.ID

255

The method of payment: check, credit card, etc.

TaxRate Double False

The percentage rate of tax.

TaxVendorName String False

SalesTaxItems.Name

1000

The VENDOR or tax agency to whom taxes are due.

TaxVendorId String False

SalesTaxItems.ID

255

The VENDOR or tax agency to whom taxes are due.

SpecialItemType String False 50

The type of the item when the value of item type is Unknown. Calling Add on such an item will result in an error, however Get or GetByName can get any item without causing an error.

The allowed values are FinanceCharge, ReimbursableExpenseGroup, ReimbursableExpenseSubtotal.

VendorOrPayeeName String False 50

Name of the vendor from whom this asset was purchased.

IsPrintItemsInGroup Boolean False

If true, a list of this group's individual items their amounts will appear on printed forms.

SalesExpense String False

Any expenses that were incurred during the sale of a fixed asset. This is applicable only if the asset has been sold.

AssetAcquiredAs String False 3

Indicates whether this item was new or used when the business acquired it. If AssetAcquiredAs is left blank, it will not be sent in the request.

The allowed values are New, Old.

AssetDescription String False 5000

Description of the asset.

AssetLocation String False 50

Where the asset is located or has been placed into service.

AssetPONumber String False 30

The purchase order number associated with this asset.

AssetSerialNumber String False 5000

The serial number of the asset.

AssetWarrantyExpires Date False

The date when the warranty for this asset expires.

AssetNotes String False 5000

Additional information about the asset.

AssetNumber String False 10

The number used by the QuickBooks Fixed Asset Manager to identify this asset.

AssetCostBasis Decimal False

The total cost of the fixed asset. This can include the cost of improvements or repairs. This amount is used to figure depreciation.

AssetDepreciation Double False

The amount the fixed asset has lost in value since it was purchased, as of the end of the year.

AssetBookValue Double False

A reasonable estimate of the sales value of the fixed asset, as of the end of the year.

UnitOfMeasure String False

UnitOfMeasure.Name

31

Name of the units that the item is measured in. Requires QBXML Version 7.0 or higher.

UnitOfMeasureId String False

UnitOfMeasure.ID

255

Id of the units that the item is measured in. Requires QBXML Version 7.0 or higher.

Sublevel Integer True

The number of ancestors this item has.

LineAggregate String True 5000

An aggregate of the line item data.

CustomFields String False

Custom fields returned from QuickBooks and formatted into XML.

EditSequence String True 16

An identifier for this copy of the object.

TimeModified Datetime True

When the item was last modified.

TimeCreated Datetime True

When the item was created.

Copyright (c) 2021 CData Software, Inc. - All rights reserved.
Build 21.0.7930