Taxamo

The Taxamo Developer Hub

Welcome to the Taxamo developer hub. You'll find comprehensive guides and documentation to help you start working with Taxamo as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    API Reference

The Taxamo Dashboard is a feature-rich user interface for you to operate and configure your Taxamo account. You can use it to manage your global VAT/GST and sales tax compliance which includes, Threshold monitoring, tax reporting, refunds report along with providing data for audits and much more.

The Dashboard home page provides useful at-a-glance information about the activity on your global sales. A wide range of real-time data is provided to give you insight into the performance of your business.

Navigating the Dashboard

The Dashboard is primarily organised into separate sections. Each section represents a particular area: type of sales (physical/digital), transaction data, Tax reports, Refunds along with your account settings.

In many cases, you can use the Dashboard to perform specific actions, such as viewing sales amounts to a country or a particular transaction, without needing to use the API—making the Dashboard a useful tool for managing your global VAT/GST and sales tax compliance.

Test vs Live Mode

You can view test data by toggling the Dashboard’s Viewing test data option. Whether a transaction was created in test or live mode is dictated by which API keys were used to create it. When the mode is in green this reflects the type of data that you are viewing See the below screenshot.

Digital vs Physical goods sales

Physical Good sales have some fundamental differences compared to Digital sales that will impact how they are stored and displayed in Taxamo. A transaction may contain a combination of physical and digital goods which have to be invoiced separately, and as well, physical goods could be shipped from different warehouses in different countries, also requiring multiple invoices but the 2 types of sales need to be reported differently. To manage this Taxamo has separate dashboard sections for both digital and physical. By default, the data that you will view when you are on the Taxamo dashboard is digital sales-related data, to switch to Physical good data click on the dropdown as shown below.

Customer location map

The customer location map provides real-time information such as your sales amount and whether you have enabled or disabled a region for tax purposes.

High-level customer overview map

A one-screen view of all your global sales in countries with digital VAT/GST and sales tax rules. You can view your sale amounts in each country by simply hovering over a particular tax jurisdiction. The map design also illustrates where you have chosen to use Taxamo and where you have not enabled Taxamo. Unsupported countries (i.e. those without rules governing cross-border digital sales) are greyed out.

Identify all sales per country

The global dashboard provides a country-by-country list of all your sales. Under ‘All sales’ there is an approximate amount of all of your B2C and B2B - B2B - Business to Business transactions. These can sometimes be VAT exclusive if a reverse charge mechanism is available. sales in a specific region.

Taxation

Underneath the customer location map is the Taxation summary table with a breakdown of relevant VAT/GST-related information on a region-by-region basis.

Here we explain what each heading on the Taxation summary table means:

Region

The tax jurisdiction where you have had confirmed sales.

All sales

This is in the information that is provided when you hover over a particular region in the customer location map. It is the total amount of your sales in this region.

Next filing date

VAT/GST filing deadline dates differ from country to country. For example, in the European Union, it is 20 days after the end of each quarter while in Saudi Arabia VAT must be filed by the last day of the month following the end of the monthly tax period.
For your convenience, the most common filing date for each supported tax jurisdiction is displayed on the global dashboard.

Threshold monitor

Some tax jurisdictions have a sales threshold which, when exceeded, triggers VAT/GST obligations. Taxamo’s global dashboard will track your sales in countries with these thresholds to show you how close you are to triggering such VAT/GST obligations.
When exceeded, the dashboard will display the ‘EXCEEDED’ alert.
Other threshold monitor alerts include ‘LOW’ and ‘OK’.
Some tax jurisdictions do not include sales thresholds in their rules. In these cases, ‘N/A’ is used.
Threshold monitoring can also be turned off, in these cases ‘OFF’ is used.

Tax calculation

For countries in which Taxamo is acting as a Service Provider rather than as an Intermediary, you have the ability to enable tax calculation on a per-country basis, which will show in this column as either ENABLED or DISABLED.

Advantage or Intermediary Plus

In a growing number of countries you can choose Taxamo's Intermediary Plus service where Taxamo's become part of the supply chain and has the VAT/GST liability but not legal title of your product or service. On the global dashboard, this choice under the ‘Seller’ column is displayed as ‘TAXAMO’ or ‘MY COMPANY’. Note:

Please contact us If you would like to switch to Intermediary Plus as it may require review from our compliance team.

Currency owed dropdown

By default, transactions are displayed in local currency. By clicking on the ‘Currency Owed’ drop-down menu on the global dashboard you can view your global digital sales in the currency of your choice. An indicative rate from the European Central Bank (ECB) on the day of viewing is used for conversions.

Transactions

All of your transactions are viewable and stored in one location via the ‘Transactions’ dashboard on the left sidebar of your Taxamo account portal. The transactions dashboard is populated as your global transactions are routed through the Taxamo service.

In this section, you have the following options:

List

A live transaction report filter options such as order date, tax country, currency, and transaction status (confirmed or unconfirmed). You can also refine the transaction list further, either by an amount or via any pre-ordained flags (such as VAT/GST number syntax checks) added to transactions.

Amount of sale (ex-VAT/GST)

The sale amount, excluding VAT/GST.

Tax amount

The amount of VAT/GST, calculated in real-time by Taxamo, that is to be added to the sale.

Total amount

The transaction amount including the calculated VAT/GST.

Taxamo fee

Taxamo’s fee from the transaction.

Order date

The date that your customer made the order.

Supply date

The date that your service was supplied to the customer.

Tax country

The country identified by Taxamo as being the location of the consumer for tax purposes. As a result of this identification, the VAT/GST rate of this country is applied to this transaction.

Status

Confirmed or Unconfirmed. Only confirmed transactions are included in reporting. Transactions are generally stored in Taxamo in an ‘Unconfirmed’ status prior to the payment being processed. Once the payment has processed successfully the transaction is updated to ‘Confirmed’ status.

Invoice details

Invoice number linked to this specific transaction as well as invoice issue date and issue place.

Location evidence

The evidence detected in real-time by Taxamo to identify the location of the end consumer. In the European Union, for example, its VAT rules require the collection of two non-conflicting pieces of evidence (e.g. IP address, card BIN, billing address) to identify the location of the end consumer so as to apply the correct VAT rate.

Export

Here you can schedule the export of large amounts of transaction data. You simply select the Order date to and from, the Tax country and the currency. The output file will be in CSV format.

Under the heading "Recent exports" you will find previously exported files.

Add

This feature allows you to create a transaction and issues an invoice to a customer by adding the customer and sale data manually into the Taxamo dashboard. This is typically used for offline sales that you want to include in your tax reports.

Overview


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.