VAT Batchjob

The VAT exceptions batch job can be started from the bulk actions menu where you'll find it under the products batch jobs. Where to start the VAT exceptions batch in Afosto

When do you need to use this batch job?

This batch job is used for making exceptions to the standard VAT for products. If you add prices to Afosto using the price batch job or manually all the added prices will have the standard VAT for each country. If you would like to change from the standard (for example 21% in The Netherlands) to an other VAT percentage for certain products you need to use this batch job.

What do you need to complete this batch job?

For this VAT exceptions batch job you'll need a file with the following parameters:

  • SKU (Article number of the product) (required)
  • Country code (2 letter ISO code) (required)
  • Administrative Area (optional)
  • VAT reference (required)


These are the article numbers from your product for which you would like to make a VAT exception.

Country code

The country code is a 2 letter ISO code. All ISO codes can be found here

Administrative Area

This is a separate field that can be used to determine an area within a country, used for countries outside of the EU.

VAT reference

This is a reference number from 0-5 where the reference number is referring to one of the VAT applied in a specific country.

These are the possible options:

0no VAT
1reduced 1
2standard VAT
3reduced 2
4reduced 3
5reduced 4

Here you will find a list of the different VAT reference and the corresponding VAT percentage:


If you would like to see which VAT's are available in a certain country that aren't listed in the table above. You can look up the different values in this document by searching for the ISO code of a country.

Google Sheets Template

Ah Google Sheets template for the price batchjob can be found here: Link to spreadsheet

VAT Batchjob Configuration

We will outline step by step on how to do a VAT batch, the things you can consider per step and tips and tricks below.

1. Starting a batchjob

To start the batchjob click on start batch, on the update VAT exceptions tile. This will open up the batchjob flow.

2. Input reference

The reference of the batchjob is prefilled with the name of the batchjob, date and time. You can change this if you like. Price batchjob reference

VAT Batchjob Data

In the second step you can choose how you would like to provide the data of your batchjob. For this we have 3 options:

  1. Existing data set
  2. Spreadsheet
  3. CSV integration

Batchjob step 2 data

Existing Data Set

Every time you create a spreadsheet in Afosto you will need to provide a reference, by doing this you are creating a so-called Data Set that you can use later on in another batch job. By doing this you don't have to provide us with the same data every time you're creating a batchjob.

By selecting an existing data set you can select one of the previously created data sets from your Afosto account.

After selecting an existing data set you will get an overview of the data in that dataset.


If you select the spreadsheet option you are able to fill in or copy-paste it into a spreadsheet form. This will also create a data set which you can then access through the existing data set function.

After filling out this spread sheet and clicking on next step you will get an overview of the newly created data set.

CSV integration

When selecting CSV integration you can choose to either select a previously created CSV integration or create a new CSV integration by clicking on + new csv integration CSV integration Afosto Batchjobs

New CSV integration

By creating a new CSV integration you are able to select it later for different batch jobs throughout the platform.


Fill in the name of the new CSV integration. It is wise to fill in a name that you can later recognize by making a description of the data in the CSV. For example: Product Prices - [brand x] - [date]

Setup CSV integration

Here you can choose between pasting an URL or uploading a CSV file. The URL option needs to be publicly available.

Choose seperator

With this setting you can choose the separator of the CSV file you've chosen in the previous step. The available options are: Tab, Comma, Semicolon, Space choose seperator csv integration

After adding a new or selecting an existing CSV integration you will get an overview of the data inside the CSV file.

Column Selection

In the column selection step you will be able to assign the columns of the data set from the previous step to the corresponding fields required for the selected batchjob. Column selection price batch job


After assigning the columns to the fields of the batch job and clicking on next the batch will be validated by the system. Once validated you can run the batch job and the prices will be updated according to the data provided! Dataset validation price batch job Afosto