Bills
The Bill 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
Bills
The Bill object
A bill represents an obligation to pay a vendor for goods or services received. It records the amount owed, due date, and payment terms, and increases accounts payable. Bills can be partially paid over time and may be linked to purchase orders or item receipts.
The schema is of type object.
{
"id": "123ABC-1234567890",
"objectType": "qbd_bill",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"vendor": {
"id": "80000001-1234567890",
"fullName": "Acme Supplies Ltd."
},
"vendorAddress": {
"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"
},
"payablesAccount": {
"id": "80000001-1234567890",
"fullName": "Accounts-Payable"
},
"transactionDate": "2021-10-01",
"dueDate": "2021-10-31",
"amountDue": "1000.00",
"currency": {
"id": "80000001-1234567890",
"fullName": "USD"
},
"exchangeRate": 1.2345,
"amountDueInHomeCurrency": "1234.56",
"refNumber": "BILL-1234",
"isPending": false,
"terms": {
"id": "80000001-1234567890",
"fullName": "Net 30"
},
"memo": "Office supplies for September",
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"isPaid": false,
"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"
}
],
"expenseLines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_expense_line",
"account": {
"id": "80000001-1234567890",
"fullName": "Expenses:Office Supplies"
},
"amount": "1000.00",
"memo": "New office chair",
"payee": {
"id": "80000001-1234567890",
"fullName": "Acme Corporation"
},
"class": {
"id": "80000001-1234567890",
"fullName": "Office Supplies"
},
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"billingStatus": "billable",
"salesRepresentative": {
"id": "80000001-1234567890",
"fullName": "Jane Doe"
},
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"itemLines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_item_line",
"item": {
"id": "80000001-1234567890",
"fullName": "Widget A"
},
"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",
"description": "High-quality widget with custom engraving",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"cost": "1000.00",
"amount": "1000.00",
"customer": {
"id": "80000001-1234567890",
"fullName": "Acme Corporation"
},
"class": {
"id": "80000001-1234567890",
"fullName": "Installation:Residential"
},
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"billingStatus": "billable",
"salesRepresentative": {
"id": "80000001-1234567890",
"fullName": "Jane Doe"
},
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"itemGroupLines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_item_group_line",
"itemGroup": {
"id": "80000001-1234567890",
"fullName": "Office Supplies Bundle"
},
"description": "Standard widget bulk package",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"totalAmount": "1000.00",
"itemLines": [
{
"id": "456DEF-1234567890",
"objectType": "qbd_item_line",
"item": {
"id": "80000001-1234567890",
"fullName": "Widget A"
},
"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",
"description": "High-quality widget with custom engraving",
"quantity": 5,
"unitOfMeasure": "Each",
"overrideUnitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Volume Units"
},
"cost": "1000.00",
"amount": "1000.00",
"customer": {
"id": "80000001-1234567890",
"fullName": "Acme Corporation"
},
"class": {
"id": "80000001-1234567890",
"fullName": "Installation:Residential"
},
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"billingStatus": "billable",
"salesRepresentative": {
"id": "80000001-1234567890",
"fullName": "Jane Doe"
},
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
],
"openAmount": "500.00",
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}