Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

AvaTax for Communications

AvaTax for Communications integration is exclusively built for communication service providers offering VoIP, IoT or Streaming services, and a few other telecom services. Integrate your AvaTax for Communications account with Chargebee and have communication taxes applied on your invoices automatically.

Note:

To avoid unnecessary API calls to the tax system for zero-value invoices, and to optimize your usage and reduce associated fees. Reach out to support@chargebee.com for assistance.

Note:

To know more about the availability of this feature, visit our plans and pricing page.

This integration has the following limitations:

  • The AvaTax for Communications integration is currently limited to clients in telecom space such as those offering over-the-top (OTT) media services via the internet(the streaming media services) and other telecom services.
  • Only T/S (Transaction/Service) pairs that require input type Amount are currently supported in the AvaTax for Communications integration. If you're looking for other T/S pairs, contact support to add your request to the feature roadmap.
  • This integration does not support inclusive pricing.
  • The hosted pages theme "Rhapsody" does not support Avalara integration.
  • When Avalara integration has been enabled (or disabled), the next billing amount is not recalculated for the existing subscriptions until the subscription is renewed or updated. This is to avoid the sudden surge of API calls that would be made to Avalara since Avalara charges are based on the number of API calls.
  • Enabling Invoice amount rounding in Chargebee will result in a total amount mismatch between Avalara and Chargebee.
  • While using third-party integrations for taxation in the EU region, note that the value for ‘isTaxed' field will be false in the invoices(unlike how it would be true with manual taxation) for reverse charge scenario, even when reverse charges are applied in the invoice as applicable.

Prerequisites

Chargebee

1. Organization Address

Avalara requires your business' address to calculate tax for an invoice. The Organization Address you provide in your Chargebee site will be used by Avalara for this purpose, and will also be stored as the Origin Address in Avalara. In order to use the Avalara integration, the Organization Address in Chargebee should have at least the Country, State, and Postal Code filled.

The Organization Address can be configured for your site under Settings > Configure Chargebee > Business Profile.

2. Address for Tax Determination

Chargebee will use your customer's shipping address to calculate tax. If the shipping address is unavailable, then the billing address would be used for the same.

Note:

If you're using Hosted Pages, ensure that:

  • The Shipping/Billing Address field has been enabled. This can be done under Settings > Configure Chargebee > Checkout & Portal > Fields.
  • The fields are made mandatory in the hosted pages.

3. Plan and Addon Details

Given that the taxes are subject to each type of charges that are added in an invoice, it is required of you to add some additional details about your Plans(active and archived) and Addons for Avalara to calculate tax accordingly. Right after you configure the Avalara integration in your Chargebee site, you will be prompted to fill in some additional details about your Plans(active and archived) and Addons such as Sale type, Transaction type and Service type.

4. Customer Type

The type of your customer or buyer is yet another crucial information that is required for tax calculation by Avalara. You can choose from the four types such as

  • Residential - When the purchase is made by a customer for home use
  • Business - When the purchase is made at a place of business
  • Senior Citizen - When the purchase is made by a customer who meets the jurisdiction requirements to be considered a senior citizen and qualifies for senior citizen tax breaks
  • Industrial - When the purchase is made by an industrial business

Taxes are unique to each of these customer types which is why it is important to specify the same for accurate calculation. Knowing which kind of buyers you majorly deal with for your business, you can set a default customer type for all customer records that are created in your Chargebee site while setting up the integration. However, you can override this default option from the individual customer records whenever necessary.

Avalara

1. Nexus Jurisdictions

When your business has 'nexus' in a tax jurisdiction, it has a physical presence and connection in that jurisdiction and is thereby obligated to collect and remit taxes to the State. Configure nexus jurisdictions in your Avalara AvaTax account to let Avalara know where to tax. Country, regional, and local jurisdictions can be added for this purpose. While configuring nexus jurisdictions, you will be prompted to add the 'begin' and 'end' dates. Avalara requires these dates to determine when to process transactions.

Read more about nexus jurisdictions.

Configuration

To have Avalara apply taxes on your Chargebee Invoices automatically involves 4 major steps.

Step 1: Connecting Avalara account with your Chargebee site

To integrate Avalara with your Chargebee site,

  1. Navigate to Apps > Go to Marketplace > Tax Management > Avalara.
  2. In the Avalara configuration page, if you have an Avalara account, click Get Started or if you don't have one already, click Sign up to create your Avalara account and continue.
  3. Choose the AvaTax Type to be AvaTax for Communications.
  4. Enter your Avalara credentials - Username, Password, Client ID and Client Profile ID, and click Connect.
  5. Under AvaTax for Communications Configuration,
  • Choose a default Customer Type for all your existing customers and new customers that you create in Chargebee. You can override this default option from the individual customer records.

  • Enable Facilities-based, if your business controls and sells over tangible facilities. In some jurisdictions, tax outcomes vary depending on whether the service is delivered over infrastructure controlled by the seller.

  • In Service Class, select

    • Local - if you offer services with over 50% of the gross business activities in local service revenue.
    • Long distance - if you offer services with over 50% of the gross business activities in long distance revenue.
  • In Business Class, specify whether you are

    • Competitive Local Exchange Company - selling services competing with an incumbent provider, or;
    • Incumbent Local Exchange Company - selling services over company-owned lines and equipments.
RetryTime
120 hours after the initial failure
240 hours after the previous retry
360 hours after the previous retry

When Avalara's server is down

If Avalara's server goes down, Chargebee will prevent sign ups, and will set off retry attempts for renewals and activations as follows:

RetryTime
130 minutes after the initial failure
260 minutes after the previous retry
3120 minutes after the previous retry

You can check Avalara's status here

Handling Refunds Made Through Chargebee

When a payment is refunded to the customer, Chargebee will create a Credit Note for the refunded amount. This Credit Note will then be pushed to Avalara and be displayed as a "Returned Amount".

Handling Deleted/Voided Invoices

When an invoice is voided/deleted in Chargebee, it's status will be marked accordingly in Avalara. However, going forward (from October 2019), when an invoice is voided/deleted in Chargebee, it will be voided and never deleted in Avalara.

Things to check before you start using the Avalara integration

Here's a checklist you could use to integrate Avalara with your Chargebee site:

  1. Ensure that your site's Organization address is filled out accurately in both Avalara and Chargebee.
  2. If you're using Hosted Pages, ensure that the shipping/billing address field has been enabled and the Zip Code, Country, and State fields are made mandatory.
  3. Configure Nexus jurisdictions in your Avalara AvaTax account.
  4. If you're an API user, ensure that the address is passed in the estimate API only if you want tax to be calculated. If the address is present, you will be charged for the tax estimate lookup.
  5. Test the integration in your sandbox site.
  6. Enable Avalara for your Chargebee live site.

Limitations

This integration has the following limitations:

  • The AvaTax for Communications integration is currently limited to clients in telecom space such as those offering over-the-top (OTT) media services via the internet(the streaming media services), and other telecom services that do not require minutes or lines for tax calculation.
  • Only T/S (Transaction/Service) pairs that require input type None, Location, or Charge are currently supported in the AvaTax for Communications integration. If you're looking for other T/S pairs, contact support to add your request to the feature roadmap.
  • This integration does not support inclusive pricing.
  • The hosted pages theme "Rhapsody" does not support Avalara integration
  • When Avalara integration has been enabled (or disabled), the next billing amount is not recalculated for the existing subscriptions until the subscription is renewed or updated. This is to avoid the sudden surge of API calls that would be made to Avalara since Avalara charges are based on the number of API calls.
  • Enabling Invoice amount rounding in Chargebee will result in a total amount mismatch between Avalara and Chargebee.

If you ever want to unlink the Avalara integration from your Chargebee account,

  1. Go to Settings > Configure Chargebee > Taxes and switch from Avalara to your preferred mode of tax calculation from all the regions where you have chosen Avalara by clicking Change.
  2. Next, go to Apps > Go to Marketplace > Tax Management > Avalara and click Unlink integration.

Was this article helpful?