Gravity
Search
K

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
Invoices.Id
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
Items.Id
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
Class.Id
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
TaxCodes.Id
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
Class.Id
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
TaxCodes.Id
false
false
The tax code for the item.
Line_DiscountLineDetail_TaxCodeRef_Name
String
True
TaxCodes.Name
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
TaxCodes.Id
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
False
false
false
An XML aggregate of tax line items.
CustomerRef
String
False
Customers.Id
true
false
The Id of the customer.
CustomerRef_Name
String
True
Customers.DisplayName
false
false
The name of the customer.
CustomerMemo
String
False
false
false
The message to the customer, which appears in the invoice and the printed invoice.
BillAddr_Id
String
False
false
false
The Id of the entity for the billing address, mainly used for modifying the address. This field is assigned by the data service.
BillAddr_Line1
String
False
false
false
First line of the address.
BillAddr_Line2
String
False
false
false
Second line of the address.
BillAddr_Line3
String
False
false
false
Third line of the address.
BillAddr_Line4
String
False
false
false
Fourth line of the address.
BillAddr_Line5
String
False
false
false
Fifth line of the address.
BillAddr_City
String
False
false
false
City name.
BillAddr_Country
String
False
false
false
Country name.
BillAddr_CountrySubDivisionCode
String
False
false
false
Region within a country. For example, the state name for the USA or the province name for Canada.
BillAddr_PostalCode
String
False
false
false
Postal code. For example, the zip code for the USA and Canada.
BillAddr_Note
String
False
false
false
Note for the customer.
BillAddr_Lat
String
False
false
false
The latitude coordinate of the geocoded billing address.
BillAddr_Long
String
False
false
false
The longitude coordinate of the geocoded billing address.
ShipAddr_Id
String
False
false
false
The Id of the entity for the shipping address, mainly used for modifying the address. This field is assigned by the data service.
ShipAddr_Line1
String
False
false
false
First line of the address.
ShipAddr_Line2
String
False
false
false
Second line of the address.
ShipAddr_Line3
String
False
false
false
Third line of the address.
ShipAddr_Line4
String
False
false
false
Fourth line of the address.
ShipAddr_Line5
String
False
false
false
Fifth line of the address.
ShipAddr_City
String
False
false
false
City name.
ShipAddr_Country
String
False
false
false
Country name.
ShipAddr_CountrySubDivisionCode
String
False
false
false
Region within a country. For example, the state name for the USA and the province name for Canada.
ShipAddr_PostalCode
String
False
false
false
Postal code. For example, the zip code for the USA and Canada.
ShipAddr_Note
String
False
false
false
Note for the customer.
ShipAddr_Lat
String
False
false
false
The latitude coordinate of the geocoded shipping address.
ShipAddr_Long
String
False
false
false
The longitude coordinate of the geocoded shipping address.
ClassRef
String
False
Class.Id
true
false
The Id of the class associated with the transaction.
ClassRef_Name
String
True
Class.FullyQualifiedName
false
false
The name of the class associated with the transaction.
SalesTermRef
String
False
Terms.Id
false
false
The Id of the sales terms associated with the transaction.
SalesTermRef_Name
String
True
Terms.Name
false
false
The name of the sales terms associated with the transaction.
DueDate
Date
False
true
false
The date when the invoice is to be paid, not including any early payment discount incentives or late payment penalties. If the date is not supplied, the current date on the server is used.
ShipMethodRef
String
False
false
false
The Id of the shipping method associated with the transaction.
ShipMethodRef_Name
String
True
false
false
The name of the shipping method associated with the transaction.
ShipDate
Date
False
false
false
The date for delivery of goods or services.
TrackingNum
String
False
false
false
The tracking number for the shipping provider for the delivery of the goods associated with the transaction.
TotalAmt
Decimal
True
true
true
The total amount of the transaction. This includes the total of all the charges, allowances, and taxes.
PrintStatus
String
False
false
false
The print status of the invoice.
The allowed values are NotSet, NeedToPrint, PrintComplete.
The default value is NotSet.
EmailStatus
String
False
false
false
The email status of the invoice.
The allowed values are NotSet, NeedToSend, EmailSent.
The default value is NotSet.
BillEmail_Address
String
False
false
false
The email address where the invoice is sent. If the value of EmailStatus is NeedToSend, BillEmail is a required input.
Balance
Decimal
True
true
true
This field indicates whether the transaction is a finance charge.
DepartmentRef
String
False
false
false
The Id of the department, which stores the location of the transaction as defined using location tracking in QuickBooks Online.
DepartmentRef_Name
String
True
Departments.Name
false
false
The name of the department, which stores the location of the transaction as defined using location tracking in QuickBooks Online.
AllowOnlineCreditCardPayment