---
id: object/page/740
type: object
title: Page 740 "VAT Report"
summary: Page 740 "VAT Report" in Base Application (Microsoft.Finance.VAT.Reporting). 3 events. Present since at least BC23, still in BC30, changed in BC27.
tier: official
language: en
tags:
  - page
  - base application
versions:
  introduced: null
  last_changed: "27"
  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: 1a2db7d6ced1ef220f85cb857cce671b48e83ec2ed5761e111e775cf0bc70387
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/VAT/Reporting/VATReport.Page.al
    title: src/Layers/W1/BaseApp/Finance/VAT/Reporting/VATReport.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/finance-how-report-vat
    title: Submit VAT reports to tax authorities
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-report-vat
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/finance/closing-years-and-periods
    - topic/business-central/business-functionality/finance/working-with-value-added-tax-vat
  localizations:
    - localization/au
    - localization/de
    - localization/it
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 740
name: VAT Report
caption: VAT Return
namespace: Microsoft.Finance.VAT.Reporting
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "27"
source_major: "29"
obsolete: null
countries:
  - au
  - de
  - it
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/finance-how-report-vat.md
counts:
  fields: 0
  procedures: 6
  events: 3
  subscribers: 0
  controls: 17
  actions: 14
relations:
  out: 1
  referenced_by: 0
  pages: 1
  extended_by: 1
  event_subscribers: 1
  calls: 1
  called_by: 1
  implements: 0
---

# Page 740 "VAT Report"

> Page 740 "VAT Report" in Base Application (Microsoft.Finance.VAT.Reporting). 3 events. Present since at least BC23, still in BC30, changed in BC27.

Base Application · Microsoft.Finance.VAT.Reporting · captioned "VAT Return" · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/VAT/Reporting/VATReport.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | VAT Return |
| SourceTable | VAT Report Header |
| PageType | Document |

## 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 |
|---|---|---|---|
| General | No. | [No.](../table/740.md#fields) | Specifies the number of the involved entry or record, according to the specified number series. <small>from the table field</small> |
|  | Version | [VAT Report Version](../table/740.md#fields) | Specifies version of the report. <small>from the table field</small> |
|  | Status | [Status](../table/740.md#fields) | Specifies whether the report is in progress, is completed, or contains errors. <small>from the table field</small> |
|  | Amounts in Add. Rep. Currency | [Amounts in Add. Rep. Currency](../table/740.md#fields) | Specifies whether the amounts are in the additional reporting currency. <small>from the table field</small> |
|  | Additional Information | [Additional Information](../table/740.md#fields) | Specifies the additional information must be added to VAT report. <small>from the table field</small> |
|  | Created Date-Time | [Created Date-Time](../table/740.md#fields) | Specifies the date when the VAT report lines were created. <small>from the table field</small> |
| Control23 | Period Year | [Period Year](../table/740.md#fields) | Specifies the year of the reporting period. <small>from the table field</small> |
|  | Period Type | [Period Type](../table/740.md#fields) | Specifies the length of the reporting period. The field is empty if a custom period is defined. |
|  | Period No. | [Period No.](../table/740.md#fields) | Specifies the specific reporting period to use. The field is empty if a custom period is defined. |
|  | Start Date | [Start Date](../table/740.md#fields) | Specifies the first date of the reporting period. <small>from the table field</small> |
|  | End Date | [End Date](../table/740.md#fields) | Specifies the last date of the reporting period. <small>from the table field</small> |
|  | Country/Region Filter | [Country/Region Filter](../table/740.md#fields) | Specifies the country/region filter for the report. <small>from the table field</small> |
| Return Period | Due Date | `ReturnPeriodDueDate` | Specifies the due date for the VAT return period. |
|  | Status | `ReturnPeriodStatus` | Specifies the status of the VAT return period. |
| Content | Report Lines | part [Page 742 "VAT Report Statement Subform"](../page/742.md) | — |
|  | Messages | part [Page 701 "Error Messages Part"](../page/701.md) | — |
| FactBoxes | Documents | part [Page 1178 "Doc. Attachment List Factbox"](../page/1178.md) | — |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Functions | Suggest Lines | Create VAT Report entries based on information gathered from documents related to sales and purchases. |  |
|  | Release | Verify that the report includes all of the required information, and prepare it for submission. |  |
|  | Generate | Generate the content of VAT report. |  |
|  | Submit | Submits the VAT report to the tax authority's reporting service. |  |
|  | Receive Response | Receive a response from the the tax authority's reporting service after the VAT report submission. |  |
|  | Mark as Submitted | Indicate that you submitted the report to the tax authority manually. |  |
|  | Cancel Submission | Cancels previously submitted report. |  |
|  | Reopen | Open the report again to make changes. |  |
|  | Download Submission Message | Open the report again to make changes. |  |
|  | Download Response Message | Open the report again to make changes. |  |
|  | Calculate and Post VAT Settlement | Close open VAT entries and transfers purchase and sales VAT amounts to the VAT settlement account. For every VAT posting group, the batch job finds all the VAT entries in the VAT Entry table that are included in the filters in the definition window. |  |
| Processing | Print | Print the information in the window. A print request window opens where you can specify what to include on the print-out. |  |
|  | Report Setup | Specifies the setup that will be used for the VAT reports submission. | [Page 743 "VAT Report Setup"](../page/743.md) |
| Navigation | Open VAT Return Period Card | Open the VAT return period card for this VAT return. |  |

## Events published

- `OnAfterInitPageControllers(VATReportHeader: Record "VAT Report Header"; var SubmitControllerStatus: Boolean; var MarkAsSubmitControllerStatus: Boolean; var CalcAndPostVATStatus: Boolean)` (integration): Integration event raised after initializing page controllers to allow customization of controller status. Enables extension of page behavior based on VAT report header status and custom business rules.
- `OnBeforeDownloadSubmissionMessage(var IsHandled: Boolean; var VATReportHeader: Record "VAT Report Header")` (integration)
- `OnBeforeDownloadResponseMessage(var IsHandled: Boolean; var VATReportHeader: Record "VAT Report Header")` (integration)

## Trigger event subscribers

- OnBeforeValidateEvent(VAT Report Version): [Codeunit 737 "VAT Report Mgt."](../codeunit/737.md) OnBeforeValidateVATReportVersion

## Procedures

3 local procedures, no public ones.

## Triggers

OnAfterGetRecord, OnInsertRecord, OnOpenPage

## Relations

- source table [Table 740 "VAT Report Header"](../table/740.md)

## Pages and codeunits on this table

- [Page 744 "VAT Report List"](../page/744.md) (card page)

## Extended by

- [Page extension 4701 "VAT Report Extension"](../pageextension/4701.md)

## 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 740 "VAT Report Mediator"](../codeunit/740.md) (4 calls: `InitPageControllers → ShowExport`, `InitPageControllers → ShowGenerate`, `InitPageControllers → ShowReceiveResponse`, …)

## Called by

- [Codeunit 737 "VAT Report Mgt."](../codeunit/737.md) (1 call: `OpenVATReturnCard → (object)`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC27

## Countries that replace it

[AU](../../localizations/au.md), [DE](../../localizations/de.md), [IT](../../localizations/it.md)

## Documented on Microsoft Learn

- [Submit VAT reports to tax authorities](https://learn.microsoft.com/dynamics365/business-central/finance-how-report-vat)

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 Report")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.