AvaTax for Beverage Alcohol attribute guidelines
To calculate taxes other than sales and use tax, Avalara may require additional information about the products or services that you sell. You send this information with your transactions as attributes. Different jurisdictions require different attributes to calculate taxes accurately, so it's best practice to send all of the attributes that apply to your products or services. Alternatively, you can use the ListParametersUsage API endpoint to find the specific attributes that are required for each region.
See the AvaTax API documentation for additional information on how to include attributes with your transactions. Note that these attributes are referred to as 'parameters' in the API documentation. Use the ListParameters API endpoint to retrieve this full list of attributes, or the ListParametersByItem API endpoint to find attributes that you have mapped to an item code.
Attribute definitions and options
| Name | Data type | What it means | Attribute type | Possible values |
|---|---|---|---|---|
| Alcohol Content | Numeric Ratio | Alcohol percentage by volume | Product | Percentage, as a number. For example, use 10 for 10%. |
| Alcohol Route Type | Enumeration | Used to indicate the sales channel for a beverage alcohol transaction. | Transaction |
Select one of the following:
|
| Bill To DOB | String | This parameter is relevant to businesses conducting direct shipments of alcohol to consumers and used to capture the date of birth (DOB) associated with the "Bill To" recipient. Date of birth (DOB) must be formatted as YYYY-MM-DD. | Transaction | A date in the format YYYY-MM-DD |
| Brand | String | Brand name associated with the product being sold. | Product | A text string |
| Container Size | Numeric Measured | Intended for use where tax rate is dependent on size of container. | Product | Volume of the contained, as a number |
| Fulfillment Location | String | Address from which the alcohol is being shipped (fulfilled) from. | Transaction | A text string |
| Is Alcohol Sample | Boolean | Used when a beverage alcohol product is a sample product. | Product |
Select one of the following:
|
| Is Direct Alcohol Import | Boolean | Used when a beverage alcohol product is a direct import product. | Transaction |
Select one of the following:
|
| Is Foreign Alcohol | Boolean | Used when a beverage alcohol product is a foreign beverage alcohol product. | Product |
Select one of the following:
|
| Net Volume | Numeric Measured | The volume of only the item, substance, or product in question, exclusive of packaging, container, or other ancillary materials. | Product | Volume, as a number |
| Pack Size | Numeric Measured | Allows customer to specify, where relevant, the number of taxable items in a package, such as cigarettes in a pack or bottles in a case. | Product | A number |
| Purchaser Name | String | Used to capture the full name (first & last) associated with the "Bill To" recipient. | Transaction | A text string |
| Recipient Name | String | Used to capture the full name (first & last) associated with the "Ship To" recipient. | Transaction | A text string |
| Sales Location | Enumeration | Denotes where the sale occurred | Transaction |
Select one of the following:
|
| Seller Classification | Enumeration | A classification (using NAICS) of the seller involved in the item transaction. | Product |
Select one of the following:
|
| Ship Date | String | The date on which the alcohol is shipped. | Transaction | A date in the format YYYY-MM-DD |
| Ship To DOB | String | This parameter is relevant to businesses conducting direct shipments of alcohol to consumers and used to capture the date of birth (DOB) associated with the "Ship To" recipient. Date of birth (DOB) must be formatted as YYYY-MM-DD. | Transaction | A date in the format YYYY-MM-DD |
| Tracking Number | String | Tracking number associated with a direct alcohol shipment. When multiple tracking numbers apply to a shipment, they must be separated by a semicolon (;). | Transaction | A text string |