Troubleshooting Connectivity Problems
- May 15, 2017 | Charlie Morrisette
Getting started with any new piece of software can take a bit of time. AvaTax is in use today by tens of thousands of customers processing billions of transactions per year – but they all had to start first by connecting to the software. For today’s article, let’s look at the common challenges you can face when first getting started.
Can I contact the AvaTax API servers?
First, let’s get the correct URL for AvaTax and verify that we can contact it. AvaTax has four different servers available to choose from:
|Production - REST||https://rest.avatax.com||For live customer data using the latest REST API
|Production - SOAP||https://avatax.avalara.net||For a live customer using our mainstream SOAP interface|
|Sandbox - REST||https://sandbox-rest.avatax.com||For testing and development purposes; uses our latest REST API|
|Sandbox - SOAP||https://development.avalara.net||For testing and development purposes; uses our mainstream SOAP API|
If you’re just getting started and you’re not sure which to choose, pick Sandbox – REST. You can get a free trial account right now and make use of the REST interface immediately.
Now that you’ve selected the URL for your AvaTax API server, can you view that page in your web browser? Here’s what you should see:
If you can’t visit these sites, try these steps:
- Visit the URL in your web browser on your desktop computer
- Visit the URL from your mobile phone
- Visit the URL in a web browser on a server in your data center
If any of these three steps fail, you may have a problem with your Internet service provider, your Ethernet connection, or your firewall. Here’s how to proceed:
- If you can see the site from your mobile phone, but you can’t see it from your office, chances are you have a firewall problem. You’ll need to contact your IT vendor or your firewall software provider for help; please provide them with the URL of AvaTax and they should be able to unblock the URL.
- If you can sometimes see the site and other times get an error message, it’s likely there is a problem in your network or Internet connection.
- Check to make sure your Ethernet switches and servers are all set to the same auto negotiation settings.
- Check your network router for dropped or bad packets. Bad packets or Ethernet frame errors may indicate old wires that need to be replaced.
- If your Internet connection splits between two separate service providers, check to see if both are up and functioning normally. Try disabling one at a time to check for problems or unreliable connections.
- Note that there’s no need to test your connection using ping or traceroute. Due to the volume of connections Avalara receives, we don’t respond to ping requests.
Troubleshooting Code Problems
If you can visit the AvaTax API website in your web browser, but your code still doesn’t connect, let’s try checking a few common problems.
- Does your company mandate a Proxy server for communication? If so, you may need to write custom code to support the proxy server.
- Check to see if you are using a Sandbox account with a Production URL, or vice versa.
- Check for an AvaTax SDK available for your favorite programming language - it might save you some time!
- Check whether your application is being blocked by a software firewall. Some Linux and Windows servers block all attempts to contact remote servers unless specifically permitted.
Troubleshooting SSL Certificates
If you are running into certificate issues, you may find the steps below to help resolve the issue:
- The https://development.avalara.net (Sandbox) and https://avatax.avalara.net (Production) endpoints support only TLS 1.0, 1.1, and 1.2. If you are attempting to access these from a system which does not support TLS, you will need to use https://development-ssl.avalara.net and https://avatax-ssl.avalara.net for Sandbox and Production access as these endpoints are configured to support only SSLv3.
- The endpoints above (standard and SSLv3) utilize a full SHA256 certificate chain, and it is possible that you do not have those certificates installed as a trusted root and intermediate. To get the full certificate chain, you will need to download the ZIP file containing the individual certificates located here and assembled them into a single file in the order of: certificate, intermediate, root. The resulting file can be imported.
- If you are attempting to access these endpoints from a system that does not support SHA256 certificates, you will need to use https://development-sha1.avalara.net and https://avatax-sha1.avalara.net for Sandbox and Production access as these endpoints are configured with SHA1 certificates. Note that these endpoints use an Avalara-signed certificate as SHA1 is deprecated and no longer issued. To get the full certificate chain, you will need to download the ZIP file containing the individual certificates located here and assembled them into a single file in the order of: certificate, intermediate, root. The resulting file can be imported.
The good news is that once you’re connected to AvaTax, you have all the privileges of using the world’s best tax calculation service, and the rock solid reliability you’ve come to expect from Avalara.