InvoiceLineItems

Create, update, delete, and query QuickBooks Invoice Line Items.

Table Specific Information

Invoices may be inserted, queried, or updated via the Invoices or InvoiceLineItems tables. Invoices may be deleted by using the Invoices table.

Select

All filterable columns support the following operators:

  • =

  • !=

  • >=

  • <=

  • >

  • <

  • IN

  • LIKE

  • CONTAINS

The driver processes other filters client-side within the driver.

Insert

To add an Invoice, specify a Customer and at least one Line Item. For example, the following will insert a new Invoice with two Line Items:\

INSERT INTO InvoiceLineItems#TEMP (CustomerRef,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) VALUES ('4','SalesItemLineDetail', '2', 0.01)INSERT INTO InvoiceLineItems#TEMP (CustomerRef,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) VALUES ('4','SalesItemLineDetail', '3', 0.02)INSERT INTO InvoiceLineItems (CustomerRef,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) SELECT CustomerRef,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount FROM InvoiceLineItems#TEMP

To add lines to an existing Invoice, You'll need to specify the InvoiceId in the WHERE clause for the INSERT command. For example:\

INSERT INTO InvoiceLineItems#TEMP (InvoiceId,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) VALUES ('1234','SalesItemLineDetail', '2', 0.01)INSERT INTO InvoiceLineItems#TEMP (InvoiceId,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) VALUES ('1234','SalesItemLineDetail', '3', 0.02)INSERT INTO InvoiceLineItems (InvoiceId,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount) SELECT InvoiceId,Line_DetailType, Line_SalesItemLineDetail_ItemRef,Line_Amount FROM InvoiceLineItems#TEMP

Update

To update an existing Line Item, you'll need to specify the LineId. You can only update Line Items which have a Detail Type of SalesItemLineDetail.\

UPDATE InvoiceLineItems SET Line_SalesItemLineDetail_Qty=20 WHERE LineId='5656'

Delete

To delete existing Line Items, you'll need to set the LineId and InvoiceId:\

DELETE From InvoiceLineItems WHERE LineId='5656' AND InvoiceId='1'

Columns

Name

Type

ReadOnly

References

Filterable

Sortable

Description

LineId [KEY]

String

False

false

false

The Id of the line item of the invoice.

InvoiceId [KEY]

String

False

true

true

The Id of the invoice.

SyncToken

String

True

false

false

Version number of the object. It is used to lock an object for use by one app at a time. As soon as an application modifies an object, its SyncToken is incremented. Attempts to modify an object specifying an older SyncToken fails. Only the latest version of the object is maintained by QuickBooks Online.

MetaData_CreateTime

Datetime

True

true

true

The time the record was created.

MetaData_LastUpdatedTime

Datetime

True

true

true

The time the record was last updated.

CustomFieldAggregate

String

False

false

false

Am XML aggregate of custom field information.

DocNumber

String

False

true

true

The reference number for the transaction.

TxnDate

Date

False

true

true

The date entered by the user when this transaction occurred.

PrivateNote

String

False

false

false

A private note for the transaction, which does not appear on the transaction records.

TxnStatus

String

False

false

false

The status of the transaction.

The allowed values are Accepted, Closed, Pending, Rejected.

LinkedTxnAggregate

String

False

false

false

An XML aggregate of transactions linked to the estimate.

Line_Id

String

False

false

false

The Id of the line item.

Line_LineNum

String

False

false

false

The line number of the line item.

Line_Description

String

False

false

false

The description of the line item.

Line_Amount

Decimal

False

false

false

The amount of the line item.

Line_DetailType

String

False

false

false

The detail type of the line item. Different detail types indicate different types of line items.

Line_SalesItemLineDetail_ItemRef

String

False

false

false

The Id of the item in the line item.

Line_SalesItemLineDetail_ItemRef_Name

String

True

Items.Name

false

false

The name of the item in the line item.

Line_SalesItemLineDetail_ClassRef

String

False

false

false

The Id of the class in the line item.

Line_SalesItemLineDetail_ClassRef_Name

String

True

Class.FullyQualifiedName

false

false

The name of the class in the line item.

Line_SalesItemLineDetail_UnitPrice

Decimal

False

false

false

The unit price of the item.

Line_SalesItemLineDetail_Qty

Double

False

false

false

The number of items for the line item.

Line_SalesItemLineDetail_TaxCodeRef

String

False

false

false

The tax code for the item.

Line_SalesItemLineDetail_DiscountAmt

Decimal

False

false

false

The discount rate applied to an individual line item. If both DiscountAmt and DiscountRate are supplied, DiscountRate takes precedence and DiscountAmt is recalculated by QuickBooks services based on amount of DiscountRate.

Line_SalesItemLineDetail_ServiceDate

Date

False

false

false

The service date for the item.

Line_GroupLineDetail_GroupItemRef

String

True

false

false

The Id of the group item object.

Line_GroupLineDetail_GroupItemRef_Name

String

True

false

false

The name of the group item object.

Line_GroupLineDetail_Quantity

Integer

True

false

false

The amount of the group item.

Line_DiscountLineDetail_ClassRef

String

False

false

false

The Id of the class in the line item.

Line_DiscountLineDetail_ClassRef_Name

String

True

Class.FullyQualifiedName

false

false

The name of the class in the line item.

Line_DiscountLineDetail_TaxCodeRef

String

False

false

false

The tax code for the item.

Line_DiscountLineDetail_TaxCodeRef_Name

String

True

false

false

The name for the tax sales code.

Line_DiscountLineDetail_PercentBased

Boolean

False

false

false

True if the discount is a percentage; null or false if discount based on amount.

Line_DiscountLineDetail_DiscountAccountRef

String

False

false

false

The discount code for the item.

Line_DiscountLineDetail_DiscountAccountRef_Name

String

True

false

false

The name for the discount account.

Line_DiscountLineDetail_DiscountPercent

Decimal

False

false

false

Percentage by which the amount due is reduced, from 0% to 100%. To enter a discount of 8.5% use 8.5, not 0.085.

TxnTaxDetail_TxnTaxCodeRef

String

False

false

false

The tax code for the transaction.

TxnTaxDetail_TotalTax

String

False

false

false

The total tax calculated for the transaction, excluding any tax lines manually inserted into the transaction line list.

TxnTaxDetail_TaxLineAggregate

String