VATLayer

VATLayer is a free REST-based European Union VAT number validation and VAT rate lookup API.
For more information VATLayer see the company website.
In the context of Nintex Workflow Cloud, VATLayer is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores..
The VATLayer connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. is used to create connections for VATLayer actions A tool for building the processes, logic, and direction within workflows..
The following actions are available:
Use the Get VAT rate for country action in a workflow to retrieve the VAT rate for the European Union (EU) country you select. Use the List all EU VAT rates action to retrieve a list of VAT rates for each EU country. Use the Validate VAT number action to validate a VAT number in the EU, and retrieve details about the company the VAT number is registered to. This is useful when your workflow manages sales and shipping across the EU and you need to present the correct price, including VAT, in different countries.
Create a VATLayer connection
You can create connections from the Automate or Designer page.

- The API Key you use to create a connection for VATLayer represents the account that has access to the VATLayer actions. Find your access key on your VATLayer account Dashboard page.

-
On the top navigation bar, click Automate, and then select Connections from the left navigation.
-
On the Connections page, click Add new.
-
In the Add a new connection section that opens, fill in the following.
In this field
Select or enter the following
Connector VATLayer -
Click Connect.
-
In the Configure a connection window, fill in the fields as follows.
In this field
Select or enter the following
Connection name A name for your new connection. API Key Find your access key on your VATLayer account Dashboard page. -
Click Connect.
-
Follow the prompts to enter credentials and grant access to Nintex Workflow Cloud.
- In the permissions dialog, you can do one of the following:
- Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.
Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.
Your new connection appears on the Connections page.

-
Access the Designer page
- On the top navigation bar, click Automate > Workflows, and then select the required workflow.
(Or)
- On the top navigation bar, click Automate > Create workflow.
- Click the VATLayer action you want to add the connection to, or drag a VATLayer action into the workflow and select it.
-
In the drop-down list for Connection, select Add new connection.
-
In the Connection window, fill in the fields as follows.
In this field
Select or enter the following
Connection name A name for your new connection. API Key Find your access key on your VATLayer account Dashboard page. -
Click Connect.
- In the permissions dialog, you can do one of the following:
- Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.
Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.
Your new connection appears in the Connection field of your action.
Permissions
Permissions enable you to manage access for other users to use, edit, and delete connections.
Use |
Edit |
Delete |
Assign |
|
---|---|---|---|---|
Owners |
![]() |
![]() |
![]() |
![]() |
Users |
![]() |
![]() |
![]() |
![]() |
Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign permissions from the Connections page:
- On the Connections page, click
for the required connection.
- From the menu, select Permissions.
- To assign permissions:
- In the Owners field, type the name of the user, and select from the list.
- In the Users field, type the name of the user, and select from the list.
The corresponding permissions window is displayed.
- Click Save permissions.
Create a VATLayer data source
Use the VATLayer data source to create a drop-down list of VAT rates for all EU countries.
Example: To allow users to select a specific EU VAT rate in a form, add a drop-down list of VAT rates to the form using a Data lookup control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. The Data lookup control uses a VATLayer - List all EU VAT rates to list the EU VAT rates in the drop-down.
Each data source is configured for a specific VATLayer connection. You can create as many data sources as you need.

To add a VATLayer drop-down list to your form:
- Create your VATLayer data source.
- Add a data lookup form control to your form and configure it to use your new data source.
See Data sources.

Assign data source permissions
Permissions enable you to manage access for other users to use, edit, and delete data sources.
Use |
Edit |
Delete |
Assign |
|
---|---|---|---|---|
Connection owners |
✔ | ✔ | ✔ | ✔ |
Data source editors |
✔ | ✔ | ✔ | ✘ |
Data source users | ✔ | ✘ | ✘ | ✘ |
Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign data source permissions from the Data sources page:
- On the Data sources page, click
for the required data source.
- From the menu, select Permissions.
- To assign permissions:
- In the Data source editors field, type the name of the user, and select from the list.
- In the Data source users field, type the name of the user, and select from the list.
The corresponding data source permissions window is displayed.
- Click Save Permissions.
Data source fields
When you create a VATLayer data source, you must select the connection to use to retrieve the data.