AvaTax
VendorModel
Represents a vendor from whom you purchase products and/or services. This model inherits all properties from CustomerModel and adds vendor-specific functionality.
This model is used in the following APIs:
Indicates whether this entity is a vendor. This flag helps distinguish vendors from regular customers in the system. Note: This field is automatically set to true for vendor endpoints and cannot be overridden by user filters.
Additional vendor information including cost center, item codes, shipping locations, and tax settings. This property is only available for AvaTaxAP subscription.
The unique ID number of this customer.
The unique ID number of the AvaTax company that recorded this customer.
The unique code identifying this customer. Must be unique within your company.
This code should be used in the customerCode field of any call that creates or adjusts a transaction
in order to ensure that all exemptions that apply to this customer are correctly considered.
Note: This field is case sensitive.
A customer-configurable alternate ID number for this customer. You may set this value to match any other system that would like to reference this customer record.
A friendly name identifying this customer.
Indicates the "Attn:" component of the address for this customer, if this customer requires mailings to be shipped to the attention of a specific person or department name.
First line of the street address of this customer.
Second line of the street address of this customer.
City component of the street address of this customer.
Postal Code / Zip Code component of the address of this customer.
The main phone number for this customer.
The fax phone number for this customer, if any.
The main email address for this customer.
The name of the main contact person for this customer.
Date when this customer last executed a transaction.
The date when this record was created.
The date/time when this record was last modified.
Name or ISO 3166 code identifying the country.
This field supports many different country identifiers:
- Two character ISO 3166 codes
- Three character ISO 3166 codes
- Fully spelled out names of the country in ISO supported languages
- Common alternative spellings for many countries
For a full list of all supported codes and names, please see the Definitions API ListCountries.
ISO 3166 code identifying the region within the country.
Two and three character ISO 3166 region codes.
This is a required field if the country is US or CA. For other countries, this is an optional field.
For a full list of all supported codes, please see the Definitions API ListRegions.
True if this customer record is specifically used for bill-to purposes.
True if this customer record is specifically used for ship-to purposes.
For customers in the United States, this field is the federal taxpayer ID number. For businesses, this is a Federal Employer Identification Number. For individuals, this will be a Social Security Number.
A list of exemption certficates that apply to this customer. You can fetch this data by specifying
$include=certificates when calling a customer fetch API.
A list of custom fields defined on this customer.
For more information about custom fields, see the Avalara Help Center article about custom fields.
A list of exposure zones where you do business with this customer.
To keep track of certificates that are needed for each customer, set this value to a list of all exposure zones where you
sell products to this customer. You can find a list of exposure zones by calling ListExposureZones.
This field is often called "Ship-To States" or "Ship-To Zones", since it generally refers to locations where you ship products when this customer makes a purchase.
This field is useful for audit purposes since it helps you ensure you have the necessary certificates for each customer.
A list of bill-to customer records that are connected to this ship-to customer.
Customer records represent businesses or individuals who can provide exemption certificates. Some customers may have certificates that are linked to their shipping address or their billing address. To group these customer records together, you may link multiple bill-to and ship-to addresses together to represent a single entity that has multiple different addresses of different kinds.
A list of ship-to customer records that are connected to this bill-to customer.
Customer records represent businesses or individuals who can provide exemption certificates. Some customers may have certificates that are linked to their shipping address or their billing address. To group these customer records together, you may link multiple bill-to and ship-to addresses together to represent a single entity that has multiple different addresses of different kinds.
A list of attributes that apply to this customer.
You can fetch this data by specifying $include=attributes when calling a customer fetch API.
A list of active certificates with exemption reasons.
A list of field update histories for this customer.
A list of logs for this customer.
A list of states where this customer ships to.