---
id: object/table/737
type: object
title: Table 737 "VAT Return Period"
summary: Table 737 "VAT Return Period" in Base Application (Microsoft.Finance.VAT.Reporting). 10 fields, 6 public procedures. Present since at least BC23, still in BC30, changed in BC24, BC27, BC29.
tier: official
language: en
tags:
  - table
  - base application
versions:
  introduced: null
  last_changed: "29"
  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: 14aefdfef3948d7e19c724cf5508af7f90abde577630627b9c09fd266a481f1c
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/VAT/Reporting/VATReturnPeriod.Table.al
    title: src/Layers/W1/BaseApp/Finance/VAT/Reporting/VATReturnPeriod.Table.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/finance-manage-vat
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/Norway/norwegian-vat-reporting
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/finance/working-with-value-added-tax-vat
    - topic/business-central/business-functionality/local-functionality/norway/vat
  localizations:
    - localization/de
    - localization/it
  videos: []
  posts: []
  guidelines: []
object_type: table
object_id: 737
name: VAT Return Period
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:
  - "24"
  - "27"
  - "29"
source_major: "29"
obsolete: null
countries:
  - de
  - it
ms_search_form_ids: []
counts:
  fields: 10
  procedures: 9
  events: 0
  subscribers: 0
relations:
  out: 3
  referenced_by: 0
  pages: 3
  extended_by: 0
  event_subscribers: 0
  calls: 2
  called_by: 0
  implements: 0
---

# Table 737 "VAT Return Period"

> Table 737 "VAT Return Period" in Base Application (Microsoft.Finance.VAT.Reporting). 10 fields, 6 public procedures. Present since at least BC23, still in BC30, changed in BC24, BC27, BC29.

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

Learn documents this table through its pages: [Page 737 "VAT Return Period List"](../page/737.md) (2 Learn pages), [Page 738 "VAT Return Period Card"](../page/738.md) (1).

## Properties

| Property | Value |
|---|---|
| Caption | VAT Return Period |
| DataClassification | CustomerContent |

## Fields

Explanation: the field's ToolTip in the code; without one, the ToolTip of a page control bound to the field (marked via the page); without that, its Caption (marked caption) when that differs from the name.

| No. | Name | Type | Explanation | Notes |
|---|---|---|---|---|
| 1 | No. | Code[20] | — |  |
| 2 | No. Series | Code[20] | — |  |
| 3 | Period Key | Code[10] | — |  |
| 4 | Start Date | Date | Specifies the start date of the VAT return period. |  |
| 5 | End Date | Date | Specifies the end date of the VAT return period. |  |
| 6 | Due Date | Date | Specifies the due date for the VAT return period. |  |
| 7 | Status | Option | Specifies the status of the VAT return period. | OptionCaption: Open,Closed |
| 8 | Received Date | Date | Specifies the VAT return period received date. |  |
| 20 | VAT Return No. | Code[20] | Specifies the number of the associated VAT return. | TableRelation [Table 740 "VAT Report Header"](../table/740.md) (if ("VAT Return No." = filter(<> '')) "VAT Report Header"."No." where("VAT Report Config. Code" = const("VAT Return"), "No." = field("VAT Return No."))); not editable |
| 21 | VAT Return Status | Enum "VAT Return Status" | — | FlowField: lookup("VAT Report Header".Status where("VAT Report Config. Code" = const("VAT Return"), "No." = field("VAT Return No."))); enum [Enum 701 "VAT Return Status"](../enum/701.md); not editable |

## Keys

- Key1: No. (clustered)

## Procedures

- `CopyToVATReturn(var VATReportHeader: Record "VAT Report Header")`: Copies VAT return period information to a VAT report header. Sets period dates, year, and number for VAT return creation.
- `FindVATPeriodByDate(VATReportingDate: Date): Boolean` (internal): Finds VAT period containing the specified reporting date. Filters by start and end date range.
- `FindVATReturnPeriod(var VATReturnPeriod: Record "VAT Return Period"; StartDate: Date; EndDate: Date): Boolean`: Finds VAT return period matching the specified start and end dates. Used to locate existing periods for validation and processing.
- `DiffersFromVATReturnPeriod(var VATReturnPeriod: Record "VAT Return Period"): Boolean`: Compares current period with another VAT return period for differences. Checks due date, status, received date, and period key for changes.
- `DrillDownVATReturn()`: Opens VAT return card for the current period. Creates new VAT return if none exists for open periods.
- `CheckOpenOrOverdue(): Text`: Calculates and returns status text for open or overdue VAT periods. Provides due date warnings and overdue notifications based on setup.

Plus 3 local procedures.

## Triggers

OnDelete, OnInsert

## Relations

- lookup page [Page 737 "VAT Return Period List"](../page/737.md)
- VAT Return Status: CalcFormula [Table 740 "VAT Report Header"](../table/740.md)
- VAT Return No.: TableRelation [Table 740 "VAT Report Header"](../table/740.md)

## Pages and codeunits on this table

- [Page 736 "VAT Return Period FactBox"](../page/736.md) (source table)
- [Page 737 "VAT Return Period List"](../page/737.md) (source table)
- [Page 738 "VAT Return Period Card"](../page/738.md) (source table)

## 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 737 "VAT Report Mgt."](../codeunit/737.md) (1 call: `DrillDownVATReturn → OpenVATReturnCardFromVATPeriod`)
- [Page 456 "No. Series"](../page/456.md) (1 call: `OnInsert → (object)`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC27, BC29

## Countries that replace it

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

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: "table", object_name: "VAT Return Period")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.