---
id: object/table/1701
type: object
title: Table 1701 "Deferral Header"
summary: Table 1701 "Deferral Header" in Base Application (Microsoft.Finance.Deferral). 16 fields, 1 public procedures, 3 events. Present since at least BC23, still in BC30, changed in BC24, BC28-29.
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: edd7ab3a0e435cbb7c049da6b5c0035d8e57afa2033d7a259e99678195353a79
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/Deferral/DeferralHeader.Table.al
    title: src/Layers/W1/BaseApp/Finance/Deferral/DeferralHeader.Table.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-defer-revenue-expenses
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/finance/work-with-the-chart-of-accounts-and-gene
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: table
object_id: 1701
name: Deferral Header
namespace: Microsoft.Finance.Deferral
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
  - "28"
  - "29"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 16
  procedures: 4
  events: 3
  subscribers: 0
relations:
  out: 1
  referenced_by: 6
  pages: 1
  extended_by: 0
  event_subscribers: 0
  calls: 1
  called_by: 0
  implements: 0
---

# Table 1701 "Deferral Header"

> Table 1701 "Deferral Header" in Base Application (Microsoft.Finance.Deferral). 16 fields, 1 public procedures, 3 events. Present since at least BC23, still in BC30, changed in BC24, BC28-29.

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

Learn documents this table through its pages: [Page 1702 "Deferral Schedule"](../page/1702.md) (1 Learn page).

## Properties

| Property | Value |
|---|---|
| Caption | Deferral Header |
| 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 | Deferral Doc. Type | Enum "Deferral Document Type" | — | enum [Enum 1702 "Deferral Document Type"](../enum/1702.md) |
| 2 | Gen. Jnl. Template Name | Code[10] | — |  |
| 3 | Gen. Jnl. Batch Name | Code[10] | — |  |
| 4 | Document Type | Integer | — |  |
| 5 | Document No. | Code[20] | — |  |
| 6 | Line No. | Integer | — |  |
| 7 | Deferral Code | Code[10] | — | NotBlank |
| 8 | Amount to Defer | Decimal | Specifies the amount to defer per period. |  |
| 9 | Amount to Defer (LCY) | Decimal | — |  |
| 10 | Calc. Method | Enum "Deferral Calculation Method" | Specifies how the Amount field for each period is calculated. Straight-Line: Calculated per the number of periods, distributed by period length. Equal Per Period: Calculated per the number of periods, distributed evenly on periods. Days Per Period: Calculated per the number of days in the period. Us... | enum [Enum 1700 "Deferral Calculation Method"](../enum/1700.md) |
| 11 | Start Date | Date | Specifies when to start calculating deferral amounts. |  |
| 12 | No. of Periods | Integer | Specifies how many accounting periods the total amounts will be deferred to. | NotBlank |
| 13 | Schedule Description | Text[100] | — |  |
| 14 | Initial Amount to Defer | Decimal | — |  |
| 15 | Currency Code | Code[10] | — | TableRelation Currency.Code |
| 20 | Schedule Line Total | Decimal | — | FlowField: sum("Deferral Line".Amount where("Deferral Doc. Type" = field("Deferral Doc. Type"), "Gen. Jnl. Template Name" = field("Gen. Jnl. Template Name"), "Gen. Jnl. Batch Name" = field("Gen. Jnl. Batch Name"), "Document Type" = field("Document Type"), "Document No." = field("Document No."), "Line No." = fi... |

## Keys

- Key1: Deferral Doc. Type, Gen. Jnl. Template Name, Gen. Jnl. Batch Name, Document Type, Document No., Line No. (clustered)

## Events published

- `OnBeforeCalculateSchedule(var DeferralHeader: Record "Deferral Header")` (integration): Integration event raised before calculating the deferral schedule. Enables custom validation or modification of deferral header parameters.
- `OnDeleteOnBeforeDeleteAll(DeferralHeader: Record "Deferral Header"; var DeferralLine: Record "Deferral Line")` (integration): Integration event raised before deleting all deferral lines when the header is deleted. Enables custom cleanup logic or cascade deletion handling.
- `OnValidateStartDateOnAfterCalcThrowScheduleOutOfBoundError(DeferralHeader: Record "Deferral Header"; var ThrowScheduleOutOfBoundError: Boolean)` (integration): Integration event raised after calculating whether to show schedule out of bounds error. Enables custom logic for determining accounting period validation errors.

## Procedures

- `CalculateSchedule(): Boolean`: Calculates and creates the deferral schedule lines based on the header settings. Validates that a deferral code is specified before creating the schedule.

## Triggers

OnDelete

## Relations

- Schedule Line Total: CalcFormula [Table 1702 "Deferral Line"](../table/1702.md)

## Referenced by

6 fields in 1 objects relate to this table (TableRelation or CalcFormula).

- [Table 1702 "Deferral Line"](../table/1702.md): Deferral Doc. Type, Document No., Document Type, Gen. Jnl. Batch Name, Gen. Jnl. Template Name, Line No.

## Pages and codeunits on this table

- [Page 1702 "Deferral Schedule"](../page/1702.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 1720 "Deferral Utilities"](../codeunit/1720.md) (2 calls: `CalculateSchedule → CreateDeferralSchedule`, `OnDelete → FilterDeferralLines`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC28-29

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