Invoices
The Invoice object
QuickBooks Desktop API
Core Resources
- Auth Sessions
- End Users
Utilities
Transactions
- All Transactions
- Bill Check Payments
- Bill Credit Card Payments
- Bills
- Checks
- Credit Card Charges
- Credit Card Credits
- Credit Memos
- Estimates
- Inventory Adjustments
- Invoices
- Item Receipts
- Journal Entries
- Purchase Orders
- Receive-Payments
- Sales Orders
- Sales Receipts
- Time Tracking Activities
- Transfers
- Vendor Credits
General
- Account Tax Lines
- Accounts
- Classes
- Company
- Customers / Jobs
- Date-Driven Terms
- Employees
- Inventory Sites
- Payment Methods
- Payroll Wage Items
- Preferences
- Price Levels
- Sales Representatives
- Sales-Tax Codes
- Standard Terms
- Vendors
Items
- Discount Items
- Inventory Assembly Items
- Inventory Items
- Item Groups
- Item Sites
- Non-Inventory Items
- Sales-Tax Items
- Service Items
- Subtotal Items
Invoices
The Invoice object
An invoice is a commercial document issued to customers that itemizes and records a transaction between buyer and seller. It lists the products or services provided, their quantities, prices, payment terms, and the total amount due. In QuickBooks, invoices are used to track accounts receivable and record sales transactions where payment was not made in full at the time of purchase.
The schema is of type object
.
{
"id": "123ABC-1234567890",
"objectType": "qbd_invoice",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"customer": {
"id": "80000001-1234567890",
"fullName": "Acme Corporation"
},
"class": {
"id": "80000001-1234567890",
"fullName": "Construction"
},
"receivablesAccount": {
"id": "80000001-1234567890",
"fullName": "Accounts-Receivable"
},
"documentTemplate": {
"id": "80000001-1234567890",
"fullName": "Invoice Template"
},
"transactionDate": "2021-10-01",
"refNumber": "INV-1234",
"billingAddress": {
"line1": "Conductor Labs Inc.",
"line2": "540 Market St.",
"line3": "Suite 100",
"line4": "",
"line5": "",
"city": "San Francisco",
"state": "CA",
"postalCode": "94110",
"country": "United States",
"note": "Conductor HQ"
},
"shippingAddress": {
"line1": "Conductor Labs Inc.",
"line2": "540 Market St.",
"line3": "Suite 100",
"line4": "",
"line5": "",
"city": "San Francisco",
"state": "CA",
"postalCode": "94110",
"country": "United States",
"note": "Conductor HQ"
},
"isPending": false,
"isFinanceCharge": true,
"purchaseOrderNumber": "PO-1234",
"terms": {
"id": "80000001-1234567890",
"fullName": "Net 30"
},
"dueDate": "2021-10-31",
"salesRepresentative": {
"id": "80000001-1234567890",
"fullName": "Jane Doe"
},
"shipmentOrigin": "San Francisco, CA",
"shippingDate": "2021-10-01",
"shippingMethod": {
"id": "80000001-1234567890",
"fullName": "FedEx Ground"
},
"subtotal": "1000.00",
"salesTaxItem": {
"id": "80000001-1234567890",
"fullName": "State Sales Tax"
},
"salesTaxPercentage": "0.07",
"salesTaxTotal": "10.00",
"appliedAmount": "100.00",
"balanceRemaining": "100.00",
"currency": {
"id": "80000001-1234567890",
"fullName": "USD"
},
"exchangeRate": 1.2345,
"balanceRemainingInHomeCurrency": "100.00",
"memo": "Customer requested rush delivery",
"isPaid": false,
"customerMessage": {
"id": "80000001-1234567890",
"fullName": "Thank you for your business!"
},
"isQueuedForPrint": true,
"isQueuedForEmail": true,
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"suggestedDiscountAmount": "10.00",
"suggestedDiscountDate": "2024-01-01",
"otherCustomField": "Special handling required",
"externalId": "12345678-abcd-1234-abcd-1234567890ab",
"linkedTransactions": [
{
"id": "123ABC-1234567890",
"objectType": "qbd_linked_transaction",
"transactionType": "invoice",
"transactionDate": "2021-10-01",
"refNumber": "LINK-1234",
"linkType": "amount",
"amount": "1000.00"
}
],
"lines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_invoice_line",
"item": {
"id": "80000001-1234567890",
"fullName": "Widget A"
},
"description": "High-quality widget with custom engraving",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"rate": "10.00",
"ratePercent": "10.5",
"class": {
"id": "80000001-1234567890",
"fullName": "Installation:Residential"
},
"amount": "1000.00",
"inventorySite": {
"id": "80000001-1234567890",
"fullName": "Main Warehouse"
},
"inventorySiteLocation": {
"id": "80000001-1234567890",
"fullName": "Aisle 3, Shelf B"
},
"serialNumber": "SN1234567890",
"lotNumber": "LOT2023-001",
"expirationDate": "2025-12-31",
"serviceDate": "2024-03-15",
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"otherCustomField1": "Special handling required",
"otherCustomField2": "Always ship with a spare",
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"lineGroups": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_invoice_line_group",
"itemGroup": {
"id": "80000001-1234567890",
"fullName": "Office Supplies Bundle"
},
"description": "Standard widget bulk package",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"shouldPrintItemsInGroup": true,
"totalAmount": "1000.00",
"lines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_invoice_line",
"item": {
"id": "80000001-1234567890",
"fullName": "Widget A"
},
"description": "High-quality widget with custom engraving",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"rate": "10.00",
"ratePercent": "10.5",
"class": {
"id": "80000001-1234567890",
"fullName": "Installation:Residential"
},
"amount": "1000.00",
"inventorySite": {
"id": "80000001-1234567890",
"fullName": "Main Warehouse"
},
"inventorySiteLocation": {
"id": "80000001-1234567890",
"fullName": "Aisle 3, Shelf B"
},
"serialNumber": "SN1234567890",
"lotNumber": "LOT2023-001",
"expirationDate": "2025-12-31",
"serviceDate": "2024-03-15",
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"otherCustomField1": "Special handling required",
"otherCustomField2": "Always ship with a spare",
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}