When you send items/products to Mews via Connector API, it's important to apply the correct TAX/VAT % so that you can report correct amount of the tax to the authorities.

Taxes in Mews are hard-coded, therefore you'll need to extract the correct Tax Rate Codes for the legal environment of the relevant Mews Account.

How to get Tax Rate Codes of the relevant Mews Account?

Step 1. Identify correct Tax Environment Code of Mews Account

To identify correct Tax Environment of Mews Account you need to make an API call for configuration/get.

There you can find object of Tax Environment Code, which will help you to identify the relevant Tax Rate Codes for this environment in a following API call (Step 2).

Step 2. Identify TaxationCodes for the relevant Tax Environment

After you've identified Tax Environment Code, you can find TaxationCodes related to this tax environment.

For that you need to make one more API call to get information about Tax Environments.

  • Create a call for taxenvironments/getAll.
  • In the response under Tax Environments you will be able to search (Ctrl+F) TaxEnvironmentCode (which equals Code).
  • There you can check TaxationCodes for the identified Tax Environment.

Step 3. Identify correct Tax Rate Codes

In the same response under the Tax Rates you can find TaxationCode, which you extracted in the previous step and see what the Tax Rate Codes (aka Code) are assigned to this TaxationCode.

How to check validity of the Tax Rate Code?

Some of the legal environments may change their TAX/VAT % during the year.

For example in 2020 some of the legal environments lowered tax rates because of the Covid-19 measures.

In this case Mews creates new Tax Rate Codes, so they can be applied to the newly created items or rates.

In order to check the latest Valid Tax Rate Code, you need to check their StartUTC and EndUTC of the ValidityIntervalsUTC.

Let us know if you have any additional questions.

Did this answer your question?