Skip to main content
Avalara Help Center

AvaTax for Beverage Alcohol attribute guidelines

This article applies to:AvaTax for Beverage Alcohol

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:

  • 3T
  • DTC
  • DTT
  • Pickup
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:

  • True
  • False
Is Direct Alcohol Import Boolean Used when a beverage alcohol product is a direct import product. Transaction

Select one of the following:

  • True
  • False
Is Foreign Alcohol Boolean Used when a beverage alcohol product is a foreign beverage alcohol product. Product

Select one of the following:

  • True
  • False
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:

  • Onsite
  • Offsite
Seller Classification Enumeration A classification (using NAICS) of the seller involved in the item transaction. Product

Select one of the following:

  • InStateDirectShipper
  • OutOfStateDirectShipper
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

 

  • Was this article helpful?