ItemLineItems
Create, update, delete, and query QuickBooks Item Line Items.
Table Specific Information
Item Line Items may be inserted, deleted, and updated via the ItemLineItems table. Item Line Items refer to the Line Items associated with item groups, inventory assemblies, or sales tax groups.
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 Desktop 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 Items are Id, TimeModified, Name, Type, 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 ItemLineItems WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011' AND Name LIKE '%12345%'
Insert
To add a Line Item, specify the ItemId or Assembly Id columns of the Item Group or Assembly you want to add the Line Item to when making the insertion. For example:
INSERT INTO ItemLineItems (ItemId, LineItemName, LineItemQuantity) VALUES ('430001-1071511103|130000-933272656', 'Hardware:Doorknobs Std', 1)
To insert a new Inventory Assembly, Item Group, or Sales Tax Group with Line Items, provide the Name and Type columns and at least one Line Item. For example:
INSERT INTO ItemLineItems#TEMP (Name, Type, LineItemName, LineItemQuantity) VALUES ('MyItemGroup', 'ItemGroup', 'Hardware:Doorknobs Std', 1)
INSERT INTO ItemLineItems#TEMP (Name, Type, LineItemName, LineItemQuantity) VALUES ('MyItemGroup', 'ItemGroup', 'Cabinets', 2)
INSERT INTO ItemLineItems (Name, Type, LineItemName, LineItemQuantity) SELECT Name, Type, LineItemName, LineItemQuantity FROM ItemLineItems#TEMP
Columns
| Name | Type | ReadOnly | References | ColumnSize | Description |
| ID [KEY] | String | True | 255 |
The unique identifier in the format ItemId|ItemLineNumber. | |
| ItemId | String | False |
Items.ID | 255 |
The unique identifier for the inventory assembly or group item. |
| Name | String | False | 100 |
The name of the inventory assembly or group. | |
| FullName | String | True | 1000 |
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 default value is ALL. | |
| Barcode | String | False |
Barcode for the item. | ||
| Account | String | False | 1000 |
Account name the inventory assembly or group is associated with. | |
| AccountId | String | False |
Accounts.ID | 255 |
Account Id the inventory assembly or group is associated with. |
| COGSAccount | String | False | 1000 |
Cost of Goods Sold account for the inventory assembly or group. | |
| COGSAccountId | String | False |
Accounts.ID | 255 |
Cost of Goods Sold account for the inventory assembly or group. |
| AssetAccount | String | False | 1000 |
Inventory asset account for the inventory assembly or group if it is an inventory item. | |
| AssetAccountId | String | False |
Accounts.ID | 255 |
Inventory asset account for the inventory assembly or group if it is an inventory item. |
| LineItemNumber | Integer | False |
The line item number. | ||
| LineItemId | String | False |
Items.ID | 255 |
The line item identifier. Either LineItemId or LineItemName need to have a value when inserting. |
| LineItemName | String | False |
The line item name. Either LineItemId or LineItemName need to have a value when inserting. | ||
| LineItemQuantity | Double | False |
The line item quantity. | ||
| LineItemUnitOfMeasure | String | False |
The line item UnitOfMeasure. | ||
| ParentName | String | False |
The parent name of the inventory assembly or group if the inventory assembly or group is a subitem. | ||
| ParentId | String | False |
Items.ID | 255 |
The parent Id of the inventory assembly or group if the inventory assembly or group is a subitem. |
| Description | String | False | 5000 |
A description of the inventory assembly or group. | |
| Price | Double | False |
The price for the inventory assembly or group. | ||
| AverageCost | Double | True |
The average cost of the inventory assembly or group. | ||
| IsActive | Boolean | False |
Whether the inventory assembly or group is active or not. | ||
| PurchaseCost | Double | False |
Purchase cost for the inventory assembly or group. | ||
| PurchaseDescription | String | False | 5000 |
Purchase description for the inventory assembly or group. | |
| PreferredVendor | String | False | 1000 |
Preferred vendor for the inventory assembly or group. | |
| PreferredVendorId | String | False |
Vendors.ID | 255 |
Preferred vendor for the inventory assembly or group. |
| TaxCode | String | False | 3 |
This is a reference to a sales tax code predefined within QuickBooks. | |
| TaxCodeId | String | False | 255 |
This is a 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. | ||
| CustomFields | String | False |
Custom fields returned from QuickBooks and formatted into XML. | ||
| TimeModified | Datetime | True |
When the inventory assembly or group was last modified. | ||
| TimeCreated | Datetime | True |
When the inventory assembly or group was created. |