Skip to main content
covid-19 thumb.png
Learn more about federal and state actions related to the COVID-19 outbreak with our guide to coronavirus tax relief.
Avalara Help Center

Get Started with SaaS Pro - REST v2

  1. Last updated
  2. Save as PDF
This article applies to:

Follow the steps below to get started with Avalara for Communications REST v2.

Activate your Communications Customer Portal account

A Customer Portal account is created in both the Sandbox and Production environments.

Tip icon

 To prevent the possibility of accidentally committing test data to your Production account, Avalara requires that your Production account and your Sandbox account use different different API keys for credentials. To ensure that the API keys are different, you must use separate email addresses in Production and Sandbox when creating your API credentials.
  1. Request a Customer Portal account from your Customer Account Manager if you don't already have one.
  2. After your Customer Portal account is created, the AvaTax for Communications (AFC) Portal Account Activation email is sent.
    1. Click the Click here to activate link within the Activation email to activate your account
    2. Follow the on-screen instructions to set your password. Be mindful of the environment you are working in because your Sandbox and Production account passwords can be different.

Create a Client Profile

The AFC Tax Engine is customizable to fit your needs by creating and applying a customer profile to REST v2. You may also be able to manage profiles and customizations directly from the customer profile.

A warning icon

 Avalara recommends testing all customizations in your sandbox account before applying the customizations to your production account. Once you've added the customizations to your production account, make sure to test them before completing any bill runs.
  1. Determine if you need one or more of the following customization files:
    1. Bundle file to accurately calculate taxes on bundles transaction
    2. Exclusion file to indicate countries or states where no tax should be applied
    3. Override file to modify tax rates or tax logic
    4. Exemption file to indicate the jurisdictions, tax types, and tax levels where taxes should be exempted
    5. Nexus file to identify the jurisdictions that require you to calculate Sales and Use taxes
  2. Identify AFC Tax Engine Configuration Options:
Configuration setting Options Description
Return Non-Billable
  • False (default)
  • True
 Non-billable items are compliance-only taxes or fees that are used for filing and are not passed on to the user. This option allows you to specify whether non-billable items should be included in the tax table returned by the tax calculation API functions in AFC or not.
Safe Harbor TAM Override(s)
  • Cellular TAM Override
  • VoIP TAM Override
  • Paging TAM Override
 Safe Harbor TAM Override configuration settings allow traffic study values to be applied for a given session or account.

The results of percentages from a traffic study can be applied by administering traffic study TAM overrides. The TAM values for Cellular, VoIP and Paging are adjusted to reflect the percentages in the traffic study. While all all three types of TAM overrides can be set, it is possible to set only one or two of the options (Cellular, VoIP, or Paging).

Submit a support case to request a new client profile for your account. A client_profile_id is provided once the customizations are applied to your account.

  • Request the configuration option updates required and any overrides, exclusions, exemptions, or bundles needed. Attach any existing customization files to the email.
  • Include instructions as to whether the client profile should be applied to Sandbox for testing purposes, Production, or both environments
  • Include the client_profile_id to be updated if changes are needed to an existing client profile
  • The account could take up to 24 hours to refresh with the new changes

Run a sample transaction in Swagger

Tip icon

 If you're managing customizations in the customer portal, use the tax determination calculator to test your customizations before completing a bill run.

You now have the necessary items to run a test transaction in Swagger:

  • Customer Portal username
  • Customer Portal password
  • One or more client_profile_ids (if applicable)
  1. Navigate to the Communications Customer Portal.
    1. Log in to the Customer Portal with your Customer Portal username and password.
  2. Go to Apps > Developer Content to open the Swagger page.

    CustomerPortalDeveloperContent.png

  3. Verify the following:
    1. Version is v2.
    2. client_id is set to your expected Client ID. Select the appropriate client name from the Client drop down in the upper right corner of the page if the client_id is not set properly.
  4. Enter the client_profile_id in profile_id.
    1. Enter 0 or leave blank if not using a client profile
  5. Select the Authorize button.
  6. Enter your Customer Portal username in email address.
  7. Enter your Customer Portal password in password.
  8. Select Authorize.
  9. Select Close to close the dialog box.
  10. Select and expand an endpoint. For example, expand Healthcheck > /api/v2/Healthcheck.
  11. Enter into edit mode for the endpoint by clicking Try it out.
    1. Update the request body if the selected endpoint is a POST request
    2. Learn about customizing transactions in the Communications Rest v2 Developer Guide
  12. Click Execute when ready to submit the request

    ExecuteEndpoint.png

  13. The response is returned in the Responses section. Important items to notice:
    1. A Curl statement is generated
    2. Response body details the response to your from the server
    3. Response headers shows additional details about the response
    4. The response Code is the HTML response code returned from the server

      EndpointResponseGuide.png

Download the REST Demo Application

Refer to the AvaTax for Communications REST v2 Developer Guide for installation and configuration instructions.

Integrate with Communications REST v2

It's time to integrate your systems with Communications REST v2!

I'm in - now what?

You've made it through establishing client profiles, determining your api_key, running test transactions, and integrating Communications REST v2 with your systems. Let's dive more into the details:

 

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Article type
    Guide
    Content Type
    Guide
    Customer LifeCycle
    Get started
  2. Tags
    This page has no tags.