Vendors
Manages QuickBooks Vendors, supporting creation, updates, deletion, and queries for supplier relationship management.
Table Specific Information
This table has a Custom Fields column. See the Custom Fields page for more information.
Select
The following filters support server-side execution. Other filters are executed client-side.
QuickBooks allows only a small subset of columns to be used in the WHERE clause of a SELECT query. These columns can only be used with the equals or = comparison. The available columns for the Vendors table are Id, TimeModified, Balance, and Name. TimeModified may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. Balance may be used with the >=, <=, or = conditions but cannot be used to specify a range. Name may be used with the = or LIKE conditions to establish a starts-with, ends-with, or contains syntax. For example:
SELECT * FROM Vendors WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011' AND Name LIKE '%12345%'
Insert
To add a Vendor, specify the Name column.Columns
| Name | Type | ReadOnly | References | ColumnSize | Description |
| ID [KEY] | String | True | 255 |
The unique identifier of the vendor record in QuickBooks. | |
| Name | String | False | 100 |
The vendor's name. This field is required when adding a new vendor record. | |
| Salutation | String | False | 15 |
A salutation for the vendor, such as Mr., Mrs., Ms., or Dr. | |
| FirstName | String | False | 25 |
The first name of the vendor or primary contact. | |
| MiddleInitial | String | False | 25 |
The middle initial of the vendor or primary contact. | |
| LastName | String | False | 25 |
The last name of the vendor or primary contact. | |
| Company | String | False | 50 |
The name of the vendor's company or organization. | |
| Contact | String | False | 1023 |
The name of the primary contact person for the vendor. | |
| AccountNumber | String | False | 99 |
The account number assigned to the vendor. | |
| Type | String | False | 1000 |
The type or category of the vendor, predefined in QuickBooks. | |
| TypeId | String | False | 255 |
The unique identifier for the vendor type or category, predefined in QuickBooks. | |
| CreditLimit | Double | False |
The credit limit assigned to the vendor. | ||
| TaxIdentity | String | False | 20 |
The tax identification number for the vendor, used for IRS reporting. | |
| SalesTaxCountry | String | False | 100 |
The country responsible for collecting applicable sales taxes. Available in international versions of QuickBooks with QBXML Version 8.0 or higher. | |
| AlternateContact | String | False | 41 |
The name of an alternate contact for the vendor. | |
| Phone | String | False | 21 |
The primary telephone number of the vendor. | |
| Fax | String | False | 21 |
The fax number of the vendor. | |
| AlternatePhone | String | False | 21 |
An alternate telephone number for the vendor. | |
| String | False | 1023 |
The vendor's email address. | ||
| Cc | String | False | 1023 |
An additional email address for the vendor. | |
| Notes | String | False | 5000 |
Notes or additional information about the vendor. | |
| Address | String | True |
The complete address of the vendor as returned by QuickBooks. | ||
| Line1 | String | False | 500 |
The first line of the vendor's address. | |
| Line2 | String | False | 500 |
The second line of the vendor's address. | |
| Line3 | String | False | 500 |
The third line of the vendor's address. | |
| Line4 | String | False | 500 |
The fourth line of the vendor's address. | |
| Line5 | String | False | 41 |
The fifth line of the vendor's address. | |
| City | String | False | 255 |
The city for the vendor's address. | |
| State | String | False | 255 |
The state for the vendor's address. | |
| PostalCode | String | False | 30 |
The postal or ZIP code for the vendor's address. | |
| Country | String | False | 255 |
The country for the vendor's address. | |
| Note | String | False | 41 |
A note associated with the vendor's address. | |
| ShippingAddress | String | True |
The complete shipping address for the vendor. Requires QBXML Version 11.0 or higher. | ||
| ShippingLine1 | String | False | 500 |
The first line of the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingLine2 | String | False | 500 |
The second line of the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingLine3 | String | False | 500 |
The third line of the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingLine4 | String | False | 500 |
The fourth line of the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingLine5 | String | False | 41 |
The fifth line of the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingCity | String | False | 255 |
The city for the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingState | String | False | 255 |
The state for the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingPostalCode | String | False | 30 |
The postal or ZIP code for the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingCountry | String | False | 255 |
The country for the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| ShippingNote | String | False | 41 |
A note associated with the vendor's shipping address. Requires QBXML Version 11.0 or higher. | |
| Balance | Double | True |
The open balance for this vendor. | ||
| Terms | String | False | 100 |
The payment terms associated with this vendor, such as '2% 10 Net 60'. This field can be set during inserts but not updates. | |
| TermsId | String | False | 255 |
The unique identifier for the payment terms associated with this vendor. | |
| EligibleFor1099 | Boolean | False |
Indicates whether the vendor is eligible for 1099 reporting. | ||
| NameOnCheck | String | False | 110 |
The name that appears on checks for this vendor. | |
| CurrencyName | String | False | 64 |
The name of the currency used for this vendor. Requires QBXML Version 8.0 or higher. | |
| CurrencyId | String | False |
Currency.ID | 255 |
The unique identifier for the currency used for this vendor. Requires QBXML Version 8.0 or higher. |
| IsActive | Boolean | False |
Indicates whether the vendor is active. | ||
| CustomFields | String | False |
Custom fields returned from QuickBooks, formatted as XML for additional metadata. | ||
| EditSequence | String | True | 16 |
An identifier used for versioning of this vendor record. | |
| TimeModified | Datetime | True |
The date and time when this vendor record was last modified, formatted as YYYY-MM-DD HH:MM:SS. | ||
| TimeCreated | Datetime | True |
The date and time when this vendor record was created, formatted as YYYY-MM-DD HH:MM:SS. | ||
| PrefillAccountId1 | String | False |
The unique identifier for the first prefill account associated with this vendor. | ||
| PrefillAccountName1 | String | False |
The name of the first prefill account associated with this vendor. | ||
| PrefillAccountId2 | String | False |
The unique identifier for the second prefill account associated with this vendor. | ||
| PrefillAccountName2 | String | False |
The name of the second prefill account associated with this vendor. | ||
| PrefillAccountId3 | String | False |
The unique identifier for the third prefill account associated with this vendor. | ||
| PrefillAccountName3 | String | False |
The name of the third prefill account associated with this vendor. |