---
id: object/page/4705
type: object
title: Page 4705 "VAT Group Setup Guide"
summary: Page 4705 "VAT Group Setup Guide" in VATGroupManagement (Microsoft.Finance.VAT.Group). Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - vatgroupmanagement
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 357ca5fd2d6429e192f96e5a82365707cb10b1cb0e6f797183993ec64ceecccc
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/VATGroupManagement/app/src/Pages/VATGroupSetupGuide.Page.al
    title: src/Apps/W1/VATGroupManagement/app/src/Pages/VATGroupSetupGuide.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ui-extensions-vat-group
    title: The VAT Group Management extension for the United Kingdom
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/ui-extensions-vat-group
  objects: []
  features: []
  topics:
    - topic/business-central/development-and-administration/customize-business-central/customize-with-extensions
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 4705
name: VAT Group Setup Guide
caption: VAT Group Management
namespace: Microsoft.Finance.VAT.Group
app: VATGroupManagement
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/ui-extensions-vat-group.md
counts:
  fields: 0
  procedures: 20
  events: 0
  subscribers: 0
  controls: 27
  actions: 4
relations:
  out: 0
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 8
  called_by: 0
  implements: 0
---

# Page 4705 "VAT Group Setup Guide"

> Page 4705 "VAT Group Setup Guide" in VATGroupManagement (Microsoft.Finance.VAT.Group). Introduced in BC29, still in BC30.

VATGroupManagement · Microsoft.Finance.VAT.Group · captioned "VAT Group Management" · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/VATGroupManagement/app/src/Pages/VATGroupSetupGuide.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | VAT Group Management |
| PageType | NavigatePage |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| ProgressBanner | SetupBanner | `MediaResourcesStandard."Media Reference"` | Setup Banner |
| DoneBanner | CompleteBanner | `MediaResourcesDone."Media Reference"` | Complete Banner |
| Welcome | This guide will help you define member and representative companies in the VAT group. Group members submit VAT returns to the group representative, who then submits the aggregated return for all member companies to the tax authorities. | label | — |
| SelectType | VAT Group Role | `VATGroupRole` | Specifies whether you are a member of the group, or the group's representative. |
| My company is the group representative | To add members, choose the number in the Approved Members field. | label | — |
| RepresentativeSetup | Approved Members | `VATReportSetup."Approved Members"` | Specifies the number of approved members that are allowed to submit their VAT returns. Clicking on this number will open the Approved Members page. |
|  | Group Settlement Account | `GroupSettlementAccount` | Specifies the settlement account for the VAT group member amounts. |
|  | VAT Settlement Account | `VATSettlementAccount` | Specifies the normal VAT settlement account. |
|  | VAT Due Box No. | `VATDueBoxNo` | Specifies the box that represents the total due VAT amount from a VAT Group Submission. |
|  | Group Settlement General Journal Template | `GroupSettleGenJnlTempl` | Specifies the general journal template used for the document to post the Group VAT to the settlement account. |
| My company is a member of the VAT group | Enter connection settings for the group representative company's Business Central. Connection settings can differ, depending on how Business Central is deployed. The representative can provide this information. | label | — |
| MemberSetup | Group Member Id | `MemberIdentifier` | Specifies the group member identifier. |
|  | Group Representative Product Version | `GroupRepresentativeBCVersion` | Specifies the product version that the group representative uses. |
|  | API URL | `APIURL` | Specifies the API URL of the representative company's Business Central or Dynamics NAV. |
|  | Group Representative Company | `GroupRepresentativeCompany` | Specifies the name of the company in the representative's Business Central or Dynamics NAV that will receive your VAT returns. |
| OnPremAuth | Authentication Type | `VATGroupAuthenticationType` | Specifies the authentication types that you can use when connecting to a VAT group representative using Business Central. |
| SaasAuth | Authentication Type | `VATGroupAuthenticationTypeSaas` | Specifies the authentication types that you can use when connecting to a VAT group representative using Business Central. |
| SaasOnSaaS | Group Representative Uses Business Central Online | `GroupRepresentativeOnSaaS` | Specifies whether the group representative is using Business Central online. |
| WebServiceAccessKeyAuthControl | User Name | `Username` | Specifies the user name in the representative company's Business Central that you will use when you connect |
|  | Web Service Access Key | `WebServiceAccessKey` | Specifies the web service access key of a user in the representative company's Business Central that you will use when you connect. |
| OAuth2control | Client ID | `ClientId` | Specifies the client ID from the App Registration in Azure Active Directory. |
|  | Client Secret | `ClientSecret` | Specifies the client secret from the App Registration in Azure Active Directory. |
|  | OAuth 2.0 Authority Endpoint | `OAuthAuthorityUrl` | Specifies the OAuth 2.0 authority endpoint of the App Registration in Azure Active Directory. |
|  | OAuth 2.0 Resource URL | `ResourceURL` | Specifies the OAuth 2.0 resource URL of the API you will get access to in Azure Active Directory. For instance https://api.businesscentral.dynamics.com/ |
|  | OAuth 2.0 Redirect URL | `RedirectURL` | Specifies the OAuth 2.0 redirect URL of the App Registration in Azure Active Directory. |
| MemberVATReportSetup | VAT Report Configurations | part [Page 4709 "VAT Reports Configuration Part"](../page/4709.md) | — |
| Automatically refresh VAT report statuses | Enable Automatic Refresh | `IsJobQueueEnabled` | Specifies if you want to automatically update the status of the VAT reports with a background task. |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Processing | Test Connection | Initiates a test connection to the group master company in order to check if the authentication is correctly set up. |  |
|  | Back | Go to previous page |  |
|  | Next | Go to next page |  |
|  | Finish | Finish the wizard |  |

## Procedures

20 local procedures, no public ones.

## Triggers

OnOpenPage, OnQueryClosePage

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 4700 "VAT Group Communication"](../codeunit/4700.md) (3 calls: `OnOpenPage → FeatureName`, `TestConfigurationConnection → GetVATGroupSubmissionStatusEndpoint`, `TestConfigurationConnection → Send`)
- [Codeunit 1990 "Guided Experience"](../codeunit/1990.md) (1 call: `ValidateAndFinishSetup → CompleteAssistedSetup`)
- [Codeunit 4030 "Client Type Management"](../codeunit/4030.md) (1 call: `LoadTopBanners → GetCurrentClientType`)
- [Codeunit 453 "Job Queue - Enqueue"](../codeunit/453.md) (1 call: `EnableJobQueueStatusUpdate → (object)`)
- [Codeunit 457 "Environment Information"](../codeunit/457.md) (1 call: `OnOpenPage → IsSaaSInfrastructure`)
- [Codeunit 4701 "VAT Group Helper Functions"](../codeunit/4701.md) (1 call: `OnOpenPage → GetVATGroupDefaultBCVersion`)
- [Codeunit 501 "OAuth2"](../codeunit/501.md) (1 call: `ShowSetupMemberOAuth2Step → GetDefaultRedirectURL`)
- [Codeunit 8703 "Feature Telemetry"](../codeunit/8703.md) (1 call: `OnOpenPage → LogUptake`)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [The VAT Group Management extension for the United Kingdom](https://learn.microsoft.com/dynamics365/business-central/ui-extensions-vat-group)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "VAT Group Setup Guide")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.