{"title":"Codeunit 1720 Deferral Utilities, changes","url":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities/changes/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":1720,"name":"Deferral Utilities","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities/","json":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities.json"},"aspect":"changes","total":36,"rows":[{"version":28,"kind":"event","change":"added","name":"OnCalculateStraightlineOnAfterCalcPeriodicDeferralAmount","member":{"name":"OnCalculateStraightlineOnAfterCalcPeriodicDeferralAmount","sig":"(var Record Deferral Header, var Integer)","named":"(var DeferralHeader: Record \"Deferral Header\"; var NoOfLoops: Integer)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":28,"kind":"event","change":"added","name":"OnAfterInitializeDeferralHeaderAndSetPostDate","member":{"name":"OnAfterInitializeDeferralHeaderAndSetPostDate","sig":"(var Record Deferral Line, Record Deferral Header, Integer, var Date)","named":"(var DeferralLine: Record \"Deferral Line\"; DeferralHeader: Record \"Deferral Header\"; PeriodicCount: Integer; var PostDate: Date)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":28,"kind":"event","change":"added","name":"OnBeforeGetPeriodStartingDate","member":{"name":"OnBeforeGetPeriodStartingDate","sig":"(Date, var Date, var Boolean)","named":"(PostingDate: Date; var Result: Date; var PeriodStartingDateHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":27,"kind":"event","change":"added","name":"OnCreateDeferralScheduleOnCalcMethodElse","member":{"name":"OnCreateDeferralScheduleOnCalcMethodElse","sig":"(Enum Deferral Calculation Method, Record Deferral Header, var Record Deferral Line, Record Deferral Template)","named":"(CalcMethod: Enum \"Deferral Calculation Method\"; DeferralHeader: Record \"Deferral Header\"; var DeferralLine: Record \"Deferral Line\"; DeferralTemplate: Record \"Deferral Template\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":26,"kind":"event","change":"added","name":"OnBeforeRoundDeferralAmount","member":{"name":"OnBeforeRoundDeferralAmount","sig":"(var Record Deferral Header, Code[10], Decimal, Date, var Boolean)","named":"(var DeferralHeader: Record \"Deferral Header\"; CurrencyCode: Code[10]; CurrencyFactor: Decimal; PostingDate: Date; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":25,"kind":"procedure","change":"added","name":"CreateCopyOfDeferralSchedule","member":{"name":"CreateCopyOfDeferralSchedule","sig":"(Record Deferral Header, Integer)","named":"(DeferralHeader: Record \"Deferral Header\"; NewSourceLineNo: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"AdjustTotalAmountForDeferrals","member":{"name":"AdjustTotalAmountForDeferrals","sig":"(Code[10], var Decimal, var Decimal, var Decimal, var Decimal, var Decimal, var Decimal, Decimal, Decimal)","named":"(DeferralCode: Code[10]; var AmtToDefer: Decimal; var AmtToDeferACY: Decimal; var TotalAmount: Decimal; var TotalAmountACY: Decimal; var TotalVATBase: Decimal; var TotalVATBaseACY: Decimal; DiscountAmount: Decimal; DiscountAmountACY: Decimal)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"AdjustTotalAmountForDeferralsNoBase","member":{"name":"AdjustTotalAmountForDeferralsNoBase","sig":"(Code[10], var Decimal, var Decimal, var Decimal, var Decimal, Decimal, Decimal)","named":"(DeferralCode: Code[10]; var AmtToDefer: Decimal; var AmtToDeferACY: Decimal; var TotalAmount: Decimal; var TotalAmountACY: Decimal; DiscountAmount: Decimal; DiscountAmountACY: Decimal)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"CheckDeferralConditionForGenJournal","member":{"name":"CheckDeferralConditionForGenJournal","sig":"(var Record Gen. Journal Line)","named":"(var GenJournalLine: Record \"Gen. Journal Line\")","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"ShowGenJournalTemplate","member":{"name":"ShowGenJournalTemplate","sig":"(ErrorInfo)","named":"(ErrorInfo: ErrorInfo)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"procedure","change":"added","name":"ShowSourceCodeSetup","member":{"name":"ShowSourceCodeSetup","sig":"(ErrorInfo)","named":"(ErrorInfo: ErrorInfo)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":24,"kind":"event","change":"gone","name":"OnAfterAdjustTotalAmountForDeferrals","member":{"name":"OnAfterAdjustTotalAmountForDeferrals","sig":"(Code[10], var Decimal, var Decimal, var Decimal, var Decimal)","named":"(DeferralCode: Code[10]; var AmtToDefer: Decimal; var AmtToDeferACY: Decimal; var TotalAmount: Decimal; var TotalAmountACY: Decimal)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":24,"kind":"event","change":"gone","name":"OnBeforeCreateDeferralSchedule","member":{"name":"OnBeforeCreateDeferralSchedule","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Enum Deferral Calculation Method, var Date, var Integer, Boolean, Text[100], var Boolean, Code[10], var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; AmountToDefer: Decimal; CalcMethod: Enum \"Deferral Calculation Method\"; var StartDate: Date; var NoOfPeriods: Integer; ApplyDeferralPercentage: Boolean; DeferralDescription: Text[100]; var AdjustStartDate: Boolean; CurrencyCode: Code[10]; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":24,"kind":"event","change":"added","name":"OnBeforeCreateDeferralSchedule","member":{"name":"OnBeforeCreateDeferralSchedule","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Enum Deferral Calculation Method, var Date, var Integer, Boolean, Text[100], var Boolean, Code[10], var Boolean, var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; AmountToDefer: Decimal; CalcMethod: Enum \"Deferral Calculation Method\"; var StartDate: Date; var NoOfPeriods: Integer; ApplyDeferralPercentage: Boolean; DeferralDescription: Text[100]; var AdjustStartDate: Boolean; CurrencyCode: Code[10]; var IsHandled: Boolean; var RedistributeDeferralSchedule: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":24,"kind":"event","change":"added","name":"OnBeforeOpenLineScheduleEdit","member":{"name":"OnBeforeOpenLineScheduleEdit","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Date, Text[100], Code[10])","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; Amount: Decimal; PostingDate: Date; Description: Text[100]; CurrencyCode: Code[10])","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":24,"kind":"event","change":"added","name":"OnAfterAdjustTotalAmountForDeferrals","member":{"name":"OnAfterAdjustTotalAmountForDeferrals","sig":"(Code[10], var Decimal, var Decimal, var Decimal, var Decimal, Decimal, Decimal)","named":"(DeferralCode: Code[10]; var AmtToDefer: Decimal; var AmtToDeferACY: Decimal; var TotalAmount: Decimal; var TotalAmountACY: Decimal; DiscountAmount: Decimal; DiscountAmountACY: Decimal)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":24,"kind":"event","change":"added","name":"OnBeforeCheckDeferralConditionForGenJournal","member":{"name":"OnBeforeCheckDeferralConditionForGenJournal","sig":"(var Record Gen. Journal Line, var Boolean)","named":"(var GenJournalLine: Record \"Gen. Journal Line\"; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnBeforeRemoveOrSetDeferralSchedule","member":{"name":"OnBeforeRemoveOrSetDeferralSchedule","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Date, Text[100], Code[10], Boolean, var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; Amount: Decimal; PostingDate: Date; Description: Text[100]; CurrencyCode: Code[10]; AdjustStartDate: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":22,"kind":"event","change":"gone","name":"OnBeforeCreateDeferralSchedule","member":{"name":"OnBeforeCreateDeferralSchedule","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Enum Deferral Calculation Method, Date, Integer, Boolean, Text[100], Boolean, Code[10], var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; AmountToDefer: Decimal; CalcMethod: Enum \"Deferral Calculation Method\"; StartDate: Date; NoOfPeriods: Integer; ApplyDeferralPercentage: Boolean; DeferralDescription: Text[100]; AdjustStartDate: Boolean; CurrencyCode: Code[10]; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":22,"kind":"event","change":"added","name":"OnBeforeCreateDeferralSchedule","member":{"name":"OnBeforeCreateDeferralSchedule","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Enum Deferral Calculation Method, var Date, var Integer, Boolean, Text[100], var Boolean, Code[10], var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; AmountToDefer: Decimal; CalcMethod: Enum \"Deferral Calculation Method\"; var StartDate: Date; var NoOfPeriods: Integer; ApplyDeferralPercentage: Boolean; DeferralDescription: Text[100]; var AdjustStartDate: Boolean; CurrencyCode: Code[10]; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":22,"kind":"event","change":"added","name":"OnInitializeDeferralHeaderAndSetPostDateAfterInitDeferralLine","member":{"name":"OnInitializeDeferralHeaderAndSetPostDateAfterInitDeferralLine","sig":"(var Record Deferral Line)","named":"(var DeferralLine: Record \"Deferral Line\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":22,"kind":"event","change":"added","name":"OnOpenLineScheduleEditOnBeforeDeferralScheduleSetParameters","member":{"name":"OnOpenLineScheduleEditOnBeforeDeferralScheduleSetParameters","sig":"(var Page Deferral Schedule, Integer, Code[10], Code[10], Integer, Code[20], Record Deferral Header, var Boolean)","named":"(var DeferralSchedule: Page \"Deferral Schedule\"; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; DeferralHeader: Record \"Deferral Header\"; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":20,"kind":"procedure","change":"gone","name":"GetSalesDeferralDocType","member":{"name":"GetSalesDeferralDocType","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replace by enum \"Deferral Document Type value.\"","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetPurchDeferralDocType","member":{"name":"GetPurchDeferralDocType","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replace by enum \"Deferral Document Type value.\"","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetGLDeferralDocType","member":{"name":"GetGLDeferralDocType","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replace by enum \"Deferral Document Type value.\"","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"added","name":"IsDateNotAllowed","member":{"name":"IsDateNotAllowed","sig":"(Date)","named":"(PostingDate: Date)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeDeferralCodeOnValidate","member":{"name":"OnBeforeDeferralCodeOnValidate","sig":"(Code[10], Integer, Code[10], Code[10], Integer, Code[20], Integer, Decimal, Date, Text[100], Code[10], var Boolean)","named":"(DeferralCode: Code[10]; DeferralDocType: Integer; GenJnlTemplateName: Code[10]; GenJnlBatchName: Code[10]; DocumentType: Integer; DocumentNo: Code[20]; LineNo: Integer; Amount: Decimal; PostingDate: Date; Description: Text[100]; CurrencyCode: Code[10]; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeIsDateNotAllowed","member":{"name":"OnBeforeIsDateNotAllowed","sig":"(Date, var Boolean, var Boolean)","named":"(PostingDate: Date; var Result: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeValidateDeferralTemplate","member":{"name":"OnBeforeValidateDeferralTemplate","sig":"(Record Deferral Template, var Boolean)","named":"(DeferralTemplate: Record \"Deferral Template\"; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnCalculateStraightlineOnAfterCalcSecondPeriodDate","member":{"name":"OnCalculateStraightlineOnAfterCalcSecondPeriodDate","sig":"(Record Deferral Header, Date, var Date, var Date)","named":"(DeferralHeader: Record \"Deferral Header\"; PostDate: Date; var FirstPeriodDate: Date; var SecondPeriodDate: Date)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnCalculateStraightlineOnBeforeCalcPeriodicDeferralAmount","member":{"name":"OnCalculateStraightlineOnBeforeCalcPeriodicDeferralAmount","sig":"(var Record Deferral Header, var Decimal, Decimal, var Boolean)","named":"(var DeferralHeader: Record \"Deferral Header\"; var PeriodicDeferralAmount: Decimal; AmountRoundingPrecision: Decimal; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnCalculateDaysPerPeriodOnAfterCalcEndDate","member":{"name":"OnCalculateDaysPerPeriodOnAfterCalcEndDate","sig":"(var Record Deferral Header, var Record Deferral Line, Record Deferral Template, var Date)","named":"(var DeferralHeader: Record \"Deferral Header\"; var DeferralLine: Record \"Deferral Line\"; DeferralTemplate: Record \"Deferral Template\"; var EndDate: Date)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnCalculateDaysPerPeriodOnBeforeDeferralLineInsert","member":{"name":"OnCalculateDaysPerPeriodOnBeforeDeferralLineInsert","sig":"(Record Deferral Header, var Record Deferral Line)","named":"(DeferralHeader: Record \"Deferral Header\"; var DeferralLine: Record \"Deferral Line\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnCalculateUserDefinedOnBeforeDeferralLineInsert","member":{"name":"OnCalculateUserDefinedOnBeforeDeferralLineInsert","sig":"(Record Deferral Header, var Record Deferral Line)","named":"(DeferralHeader: Record \"Deferral Header\"; var DeferralLine: Record \"Deferral Line\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnBeforeUpdateDeferralLineDescription","member":{"name":"OnBeforeUpdateDeferralLineDescription","sig":"(var Record Deferral Line, Record Deferral Header, Record Deferral Template, Date, var Boolean)","named":"(var DeferralLine: Record \"Deferral Line\"; DeferralHeader: Record \"Deferral Header\"; DeferralTemplate: Record \"Deferral Template\"; PostDate: Date; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"InitializeDeferralHeaderAndSetPostDate","member":{"name":"InitializeDeferralHeaderAndSetPostDate","sig":"(var Record Deferral Line, Record Deferral Header, Integer, var Date)","named":"(var DeferralLine: Record \"Deferral Line\"; DeferralHeader: Record \"Deferral Header\"; PeriodicCount: Integer; var PostDate: Date)","returns":"","kind":"procedure","access":"public","obsolete":null}}]}