The VAT Group Management Extension

You can join one or more businesses in your country to consolidate VAT reporting under a single registration number. This type of arrangement is known as a VAT group. You can engage with the group as a member or the group representative.

Forming a VAT Group

VAT group members and the group representative can use the VAT Group Management Setup assisted setup guide to define their engagement with the group, and create a connection between their Business Central tenants. The group members will use the connection to submit their VAT returns to the group representative. The representative will submit VAT to tax authorities on behalf of the group using a single VAT return.

VAT Group Constellations

Communication happens from group members to the representative. The group representative exposes an API that allows the members to submit their VAT returns to the VAT group representative. Business Central on-premises or online, and in any combination. The setup of the communication depends on the constellation. The following sections describe how to set up various group constellations.

The following list shows the recommended order of the steps to set up a VAT group:

Create the setup in Azure Active Directory. For more information, see Requirements for Authentication.
Share the technical information that VAT group members and the representative need to connect their Business Central tenants. Usually, the VAT group representative has this information, such as the name of the VAT group representative's environment to which the VAT group members will submit VAT.
Create users in the VAT group representative's Business Central that VAT group members can use to authenticate and connect.
Run the Set up VAT Group Management assisted setup guide to connect the VAT group members.

The guide requires some information from the VAT group representative. For more information, see the VAT Group Member Setup section. Make a note of the Group Member ID for each VAT group member. The representative needs these IDs to add the companies to the VAT group. 5. Set up the VAT Group Management extension in the VAT group representative's Business Central by using the Set up VAT Group Management assisted setup guide.

[!NOTE] To connect to the VAT group representative, group members need a user with access to the VAT group representative's Business Central. The VAT group representative must create at least one user for this, however, for security reasons we recommended that you create a user for each VAT group member. Make sure to distribute the credentials for these users to VAT group members in a secure way.

Understanding the VAT Group Management Setup

The VAT group representative exposes an API that VAT group members can use to connect to their Business Central.

VAT group members connect to the representative by calling a web service on the VAT group representative tenant. The caller must be authenticated using OAuth. When the VAT Group Management extension is set up, you will be asked to authenticate to the VAT group representative to get and save an access token. This access token is used when submitting VAT returns to the VAT group representative.

Authentication is handled by Azure Active Directory, so your setup must be made in the VAT group representative's Azure Active Directory to allow connections. An Azure Active Directory app registration must be configured with access to the VAT group representative's Business Central on-premises.

[!NOTE] For a limited time, authentication using a web service access key is also supported. For more information, see Deprecated Features in 2021 release wave 1.

Requirements for Authentication

When the VAT group representative is using Business Central online, the VAT group member can authenticate using the designated user credentials and the endpoint information. For more information, see VAT Group Member Setup.

VAT group members who have Business Central online to authenticate the group member. For more information, see Quickstart: Register an application with the Microsoft identity platform.

When you create the app registration in Azure Active Directory, you must specify the following.

In the Authentication section, add Web as a platform, and use the following Redirect URL: https://businesscentral.dynamics.com/OAuthLanding.htm.
In the Authentication section, in the option to select Supported account types, select Accounts in any organizational directory (Any Azure AD directory - Multitenant).
In the Certificates & secrets section, create a new client secret and note the value. The VAT group members will need the secret when they set up the connection to the group representative.
In the API permissions section, add permissions to Business Central. Enable delegated access to Financials.ReadWrite.All and user_impersonation.
In the Overview section, note the Application (client) ID. The VAT group members will need the ID when they set up the connection to the group representative.

VAT Group Member Setup

Set up the VAT group member by starting the Set up VAT Group Management assisted setup guide.

[!NOTE] Before you get started, contact the VAT group representative for the following information about their Business Central tenant:

The API URL

The name of their company

Client ID

Client secret

Sign in credentials for the dedicated user

To define the company's VAT group role, choose Member, and then choose Next.
Copy the value of the Group Member ID field, and then share it with the VAT group representative so they can add your company as an approved member of the group.
Add the API URL from the VAT group representative. Typically, the URL is formatted as follows: https://api.businesscentral.dynamics.com/v2.0/[TENANT-ID]/[ENVIRONMENTNAME]. For example, https://api.businesscentral.dynamics.com/v2.0/907869c3-b252-4aca-b9cb-17a15d25477b/UKRepresentative.
Add the Business Central company name of the VAT group representative, such as CRONUS UK Ltd.
Choose Authentication Type, choose OAuth2, and then choose Next.
In the Client ID field, enter the ID provided by the VAT group representative.
In the Client Secret provided by the VAT Group representative field, enter the secret provided by the VAT group representative.
In the OAuth 2.0 Authority Endpoint field, enter https://login.microsoftonline.com/common/oauth2.
In the OAuth 2.0 Resource URL field, enter https://api.businesscentral.dynamics.com/.
In the OAuth 2.0 Redirect URL field, enter https://businesscentral.dynamics.com/OAuthLanding.htm.
When you have specified the various fields, choose Next, and then enter the user credentials that were provided by the VAT group representative.
Choose the VAT report configuration that you use to report VAT to authorities in your country.

For example, in the United Kingdom, the VAT report configuration would be set up to report VAT to HMRC. The VAT Group Management extension copies this setup, but replaces the submission codeunit with one that supports submission to the VAT group representative rather than the tax authorities. The codeunit is provided by Microsoft. When done, choose Next.

Use the VAT Group Management Features

VAT group members use the standard processes to prepare VAT returns. The only difference is to choose the VATGROUP report version, which submits the VAT return to the VAT group representative rather than the authorities. For more information, see About the VAT Return report.

The following sections describe the tasks that VAT group representatives must perform.

VAT Group Submissions

The VAT Group Submissions page lists the VAT returns that members have submitted. The page serves as a draft location for the submissions until the VAT group representative includes them in a VAT return for the group. You can open the submissions to review the VAT for the individual boxes reported by the VAT group member.

Creating a Group VAT Return

To report VAT on behalf of the group, on the VAT Returns page, create a VAT return for your company only. Afterward, include the most recent VAT submissions from VAT group members by choosing the Include Group VAT action.

When the VAT Group representative's VAT Return has been submitted to the authorities on behalf of the entire group, you will normally run the Calculate and Post VAT Settlement action. This action closes open VAT Entries and transfers amounts to the VAT Settlement account. Currently, this action does not take the group submissions into account. This means that only the VAT Entries of the VAT Group representative company will be posted. The VAT Group member submission amounts must be posted to the VAT settlement amount manually, so that the VAT Group representative's VAT Settlement account will reflect the liability of what was reported to authorities. This behavior will change in an upcoming update of Business Central, so the entire group VAT (the Total Amount on Report Lines on the VAT Return) will be settled.

[!NOTE] VAT group members can correct submitted VAT returns as long as the group representative has not released the VAT return for the group. To make a correction, the VAT group member must create a new VAT return for the VAT return period and submit it to the VAT group representative. On the VAT group representative's side, the latest VAT return will be included on the VAT Returns page.

[!IMPORTANT] The VAT group functionality is only supported in those markets where Business Central uses a VAT framework that consists of VAT returns and VAT return periods. You cannot use VAT groups in other markets that have other implementations of local VAT reporting, such as Austria, Germany, Italy, Spain, and Switzerland.

ms.topic: include ms.date: 12/20/2021 ms.author: edupont

Business Central on Microsoft Learn