ADO.NET Provider for QuickBooks

Build 21.0.7930

ItemReceiptExpenseItems

Create, update, delete, and query QuickBooks Item Receipt Expense Line Items.

Table Specific Information

ItemReceipts may be inserted, queried, or updated via the ItemReceipts, ItemReceiptExpenseItems, or ItemReceiptLineItems tables. ItemReceipts may be deleted by using the ItemReceipts table.

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 typically be used with only the equals or = comparison. The available columns for ItemReceipts are Id, Date, ReferenceNumber, Payee, PayeeId, VendorName, VendorId, Account, AccountId, and TimeModified. TimeModified and Date may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. VendorName and ReferenceNumber may be used with the = or LIKE conditions to establish a starts-with, ends-with, or contains syntax. For example:

SELECT * FROM ItemReceipts WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011' AND VendorName LIKE '%Patton Hardware Supplies%' AND ReferenceNumber LIKE '12345%'

Insert

To add an ItemReceipt, specify the Vendor, Date, and at least one Expense or Line Item. All Expense Line Item columns can be used for inserting multiple Expense Line Items for a new ItemReceipt transaction. For example, the following will insert a new ItemReceipt with two Expense Line Items:

INSERT INTO ItemReceiptExpenseItems#TEMP (VendorName, Date, ExpenseAccount, ExpenseAmount) VALUES ('Patton Hardware Supplies', '1/1/2011', 'Utilities:Telephone', 52.25)
INSERT INTO ItemReceiptExpenseItems#TEMP (VendorName, Date, ExpenseAccount, ExpenseAmount) VALUES ('Patton Hardware Supplies', '1/1/2011', 'Professional Fees:Accounting', 235.87)
INSERT INTO ItemReceiptExpenseItems (VendorName, Date, ExpenseAccount, ExpenseAmount) SELECT VendorName, Date, ExpenseAccount, ExpenseAmount FROM ItemReceiptExpenseItems#TEMP

Columns

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

The unique identifier in the format ItemReceiptId|ExpenseLineId.

ItemReceiptId String False

ItemReceipts.ID

255

The item identifier for the item receipt. This is obtained from the ItemReceipts table.

VendorName String False

Vendors.Name

1000

The name of the vendor. Either VendorName or VendorId must be specified when inserting an item receipt.

VendorId String False

Vendors.ID

255

The unique Id of the vendor. Either VendorName or VendorId must be specified when inserting an item receipt.

Date Date False

The transaction date.

ReferenceNumber String False 21

The transaction reference number.

AccountsPayable String False

Accounts.FullName

1000

A reference to the name of the account the item receipt is payable to.

AccountsPayableId String False

Accounts.ID

255

A reference to the unique Id of the account the item receipt is payable to.

Memo String False 5000

A memo regarding the item receipt.

Amount Decinal True

Total amount of the item receipt.

TxnNumber Integer True

The transaction number. An identifying number for the transaction, different from the QuickBooks-generated Id.

ExchangeRate Double False

The market price for which this currency can be exchanged for the currency used by the QuickBooks company file as the home currency. Requires QBXML Version 8.0 or higher.

IsTaxIncluded Boolean False

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

ExpenseLineId String True 255

The line item identifier.

ExpenseLineNumber String True 255

The expense line number.

ExpenseAccount String False

Accounts.FullName

1000

The account name for this expense line. ExpenseAccount or ExpenseAccountId must have a value when inserting.

ExpenseAccountId String False

Accounts.ID

255

The account Id for this expense line. ExpenseAccount or ExpenseAccountId must have a value when inserting.

ExpenseAmount Decimal False

The total amount of this expense line.

ExpenseBillableStatus String False 13

The billing status of this expense line.

The allowed values are EMPTY, BILLABLE, NOTBILLABLE, HASBEENBILLED.

The default value is EMPTY.

ExpenseCustomer String False

Customers.FullName

1000

The customer associated with this expense line.

ExpenseCustomerId String False

Customers.ID

255

The customer associated with this expense line.

ExpenseClass String False

Class.FullName

1000

The class name of this expense.

ExpenseClassId String False

Class.ID

255

The class Id of this expense.

ExpenseTaxCode String False

SalesTaxCodes.Name

3

A reference to the name of the sales tax code associated with this expense item. Only available in QuickBooks UK and CA editions.

ExpenseTaxCodeId String False

SalesTaxCodes.ID

255

A reference to the Id of the sales tax code associated with this expense item. Only available in QuickBooks UK and CA editions.

ExpenseCustomFields String True

The custom fields for this expense item.

CustomFields String False

Custom fields returned from QuickBooks and formatted into XML.

EditSequence String True 16

An identifier used for versioning for this copy of the object.

TimeModified Datetime True

When the item receipt was last modified.

TimeCreated Datetime True

When the item receipt was created.

Pseudo-Columns

Pseudo Column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
LinkToTxnId String

The id of a transaction to link the new item receipt to. This should be a purchase order Id. Only available on an insert.

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