DepositLineItems

Handles individual line items within QuickBooks Deposits, supporting creation, updates, deletion, and queries. Requires QBXML Version 7.0 or higher.

Table Specific Information

Deposits may be inserted, queried, or updated via the Deposits or DepositLineItems tables. Deposits may be deleted by using the Deposits 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 Deposits are Id, Date, TimeModified, DepositToAccount, and DepositToAccountId. TimeModified and Date may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. For example:

SELECT * FROM DepositLineItems WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011'

Insert

To add a Deposit, specify the DepositToAccount field and at least one Line Item. All Line Items must have an ItemAccount specified.

All Line Item columns can be used for inserting multiple Line Items for a new Deposit transaction. For example, the following will insert a new Deposit with two Line Items:

INSERT INTO DepositLineItems#TEMP (DepositToAccount, ItemAccount, ItemAmount) VALUES ('Checking', 'Undeposited Funds', 12.25)
INSERT INTO DepositLineItems#TEMP (DepositToAccount, ItemAccount, ItemAmount) VALUES ('Checking', 'Savings', 155.35)
INSERT INTO DepositLineItems (DepositToAccount, ItemAccount, ItemAmount) SELECT DepositToAccount, ItemAccount, ItemAmount FROM DepositLineItems#TEMP

Following is an example to Insert with Transaction Id(ItemPaymentId)

INSERT INTO DepositLineItems (DepositToAccount, Date, ItemPaymentId) VALUES ('Petty Cash', '2022-06-21', '28D31-1702630754')

Columns


Name	Type	ReadOnly	References	ColumnSize	Description
ID [KEY]	String	True		255	The unique identifier for the deposit line item, formatted as DepositId\|ItemLineId.
DepositId	String	False	Deposits.ID	255	The unique identifier for the deposit. Set this value to add line items to an existing deposit, or leave blank to create a new deposit.
TxnNumber	Integer	True			A unique transaction number assigned to this deposit, distinct from the Quickbooks generated ID.
Date	Date	False			The date of the deposit transaction. If used in the WHERE clause of a SELECT query, this overrides the pseudo columns StartDate and EndDate.
CashBackAccount	String	False		1000	The account reference for the bank or credit card company receiving the cash back.
CashBackAccountId	String	False	Accounts.ID	255	The unique ID of the account for the bank or credit card company receiving the cash back.
CashBackAmount	Decimal	False			The amount of cash back received in this deposit transaction.
CashBackId	String	True		255	The unique ID of the cash back transaction.
CashBackMemo	String	False		5000	Additional details or notes regarding the cash back transaction.
DepositToAccount	String	False		1000	The account where the deposit funds are to be credited.
DepositToAccountId	String	False	Accounts.ID	255	The unique ID of the account where the deposit funds are to be credited.
Memo	String	False		5000	A note or comment to appear on internal reports related to this deposit.
TotalDeposit	Double	True			The total sum of the deposit transaction, including all line items and cash back.
CustomFields	String	False			Custom fields for the deposit, formatted as XML and returned by QuickBooks.
ItemLineId	String	True		255	The unique identifier for the specific line item within the deposit.
ItemAccount	String	False		1000	The account associated with this deposit line item.
ItemAccountId	String	False	Accounts.ID	255	The unique ID of the account associated with this deposit line item.
ItemAmount	Decimal	False			The total monetary amount for this specific deposit line item. This value should always be positive.
ItemCheckNumber	String	False		11	The check number associated with this deposit line item, if applicable.
ItemClass	String	False		1000	The classification of this deposit line item.
ItemClassId	String	False	Class.ID	255	The unique ID for the classification of this deposit line item.
ItemEntityName	String	False		209	The name of the entity associated with this deposit line item, such as a vendor or customer.
ItemEntityId	String	False		255	The unique ID of the entity associated with this deposit line item.
ItemMemo	String	False		5000	A memo or note specific to this deposit line item.
ItemPaymentMethod	String	False		31	The payment method used for this deposit line item, such as cash, check, or credit card.
ItemPaymentMethodId	String	False	PaymentMethods.ID	255	The unique ID of the payment method used for this deposit line item.
ItemPaymentId	String	False		255	The transaction ID for the payment associated with this deposit line item. For example, a TxnID from a related ReceivePayment transaction.
ItemPaymentLineId	String	False		255	The unique line ID of the payment transaction associated with this deposit line item.
ItemRefId	String	True		255	The unique reference ID of the transaction linked to this deposit line item.
ItemTxnType	String	True		100	The type of transaction linked to this deposit line item, such as ReceivePayment or Invoice.
CurrencyName	String	False		64	The name of the currency used for this deposit. Requires QBXML Version 8.0 or higher.
CurrencyId	String	False	Currency.ID	255	The unique ID of the currency used for this deposit. Requires QBXML Version 8.0 or higher.
ExchangeRate	Double	False			The exchange rate at which the currency can be converted to the company's home currency.
TimeModified	Datetime	True			The date and time when the deposit was last modified.
TimeCreated	Datetime	True			The date and time when the deposit was created.
Payee	String	False		1000	The name of the payee associated with this deposit line item.
PayeeId	String	False	Vendors.ID	255	The unique ID of the payee associated with this deposit line item.

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.