Vendors
The Vendor 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
Vendors
The Vendor object
A vendor is any person or company from whom a small business owner buys goods and services. (Banks and tax agencies usually are included on the vendor list.) A company’s vendor list contains information such as account balance and contact information about each vendor.
The schema is of type object
.
{
"id": "80000001-1234567890",
"objectType": "qbd_vendor",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"name": "Acme Supplies Inc.",
"isActive": true,
"class": {
"id": "80000001-1234567890",
"fullName": "Suppliers"
},
"companyName": "Acme Corporation",
"salutation": "Dr.",
"firstName": "John",
"middleName": "A.",
"lastName": "Doe",
"jobTitle": "Purchasing Manager",
"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"
},
"phone": "+1-555-123-4567",
"alternatePhone": "+1-555-987-6543",
"fax": "+1-555-555-1212",
"email": "vendor@example.com",
"ccEmail": "manager@example.com",
"contact": "Jane Smith",
"alternateContact": "Bob Johnson",
"customContactFields": [
{
"name": "Main Phone",
"value": "555-123-4567"
}
],
"additionalContacts": [
{
"id": "80000001-1234567890",
"objectType": "qbd_contact",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"name": "Jane Smith",
"salutation": "Dr.",
"firstName": "John",
"middleName": "A.",
"lastName": "Doe",
"jobTitle": "Purchasing Manager",
"customContactFields": [
{
"name": "Main Phone",
"value": "555-123-4567"
}
]
}
],
"nameOnCheck": "Acme Supplies Ltd.",
"accountNumber": "1010",
"note": "Preferred vendor for office supplies.",
"additionalNotes": [
{
"id": 1,
"date": "2021-01-01",
"note": "This is a fun note."
}
],
"vendorType": {
"id": "80000001-1234567890",
"fullName": "Wholesale Supplier"
},
"terms": {
"id": "80000001-1234567890",
"fullName": "Net 30"
},
"creditLimit": "5000.00",
"taxIdentificationNumber": "12-3456789",
"isEligibleFor1099": true,
"balance": "1000.00",
"billingRate": {
"id": "80000001-1234567890",
"fullName": "Standard Rate"
},
"externalId": "12345678-abcd-1234-abcd-1234567890ab",
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"salesTaxCountry": "us",
"isSalesTaxAgency": false,
"salesTaxReturn": {
"id": "80000001-1234567890",
"fullName": "Quarterly Sales Tax Return"
},
"taxRegistrationNumber": "GB123456789",
"reportingPeriod": "quarterly",
"isTrackingPurchaseTax": true,
"purchaseTaxAccount": {
"id": "80000001-1234567890",
"fullName": "GST Paid"
},
"isTrackingSalesTax": true,
"salesTaxAccount": {
"id": "80000001-1234567890",
"fullName": "GST Collected"
},
"isCompoundingTax": false,
"defaultExpenseAccounts": [
{
"id": "80000001-1234567890",
"fullName": "Expenses:Utilities"
}
],
"currency": {
"id": "80000001-1234567890",
"fullName": "USD"
},
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}