{"title":"Codeunit 1720 Deferral Utilities, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities/points/","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","url":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/1720-deferral-utilities/source/","path":"src/Layers/W1/BaseApp/Finance/Deferral/DeferralUtilities.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"table:1702":{"name":"Deferral Line","url":"https://jonas-paprotka.de/ref/table/1702-deferral-line/"},"codeunit:11":{"name":"Gen. Jnl.-Check Line","url":"https://jonas-paprotka.de/ref/codeunit/11-gen-jnl-check-line/"},"table:91":{"name":"User Setup","url":"https://jonas-paprotka.de/ref/table/91-user-setup/"},"table:98":{"name":"General Ledger Setup","url":"https://jonas-paprotka.de/ref/table/98-general-ledger-setup/"},"table:1701":{"name":"Deferral Header","url":"https://jonas-paprotka.de/ref/table/1701-deferral-header/"},"table:92":{"name":"Customer Posting Group","url":"https://jonas-paprotka.de/ref/table/92-customer-posting-group/"},"table:93":{"name":"Vendor Posting Group","url":"https://jonas-paprotka.de/ref/table/93-vendor-posting-group/"},"table:1704":{"name":"Posted Deferral Header","url":"https://jonas-paprotka.de/ref/table/1704-posted-deferral-header/"},"table:1705":{"name":"Posted Deferral Line","url":"https://jonas-paprotka.de/ref/table/1705-posted-deferral-line/"},"codeunit:12":{"name":"Gen. Jnl.-Post Line","url":"https://jonas-paprotka.de/ref/codeunit/12-gen-jnl-post-line/"},"page:1702":{"name":"Deferral Schedule","url":"https://jonas-paprotka.de/ref/page/1702-deferral-schedule/"},"page:1704":{"name":"Deferral Schedule View","url":"https://jonas-paprotka.de/ref/page/1704-deferral-schedule-view/"},"page:1706":{"name":"Deferral Schedule Archive","url":"https://jonas-paprotka.de/ref/page/1706-deferral-schedule-archive/"},"table:330":{"name":"Currency Exchange Rate","url":"https://jonas-paprotka.de/ref/table/330-currency-exchange-rate/"},"table:4":{"name":"Currency","url":"https://jonas-paprotka.de/ref/table/4-currency/"},"codeunit:360":{"name":"Accounting Period Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/360-accounting-period-mgt/"}},"procs":[{"name":"CreateRecurringDescription","line":45,"kind":"procedure","params":2,"steps":[[59,"call","IsAccountingPeriodExist",2]]},{"name":"CreateDeferralSchedule","line":87,"kind":"procedure","params":15,"steps":[[100,"event","OnBeforeCreateDeferralSchedule",1],[106,"call","InitCurrency",1],[110,"call","SetStartDate",2],[119,"call","SaveUserDefinedDeferralLineAmounts",9],[123,"call","SetDeferralRecords",16],[130,"call","CalculateStraightline",3],[132,"call","CalculateEqualPerPeriod",3],[134,"call","CalculateDaysPerPeriod",3],[136,"call","CalculateUserDefined",3],[138,"event","OnCreateDeferralScheduleOnCalcMethodElse",0],[142,"call","RedistributeDeferralLines",4],[144,"call","RoundDeferralAmountFromSource",1],[146,"event","OnAfterCreateDeferralSchedule",0]]},{"name":"RoundDeferralAmountFromSource","line":149,"kind":"procedure","access":"local","params":1,"steps":[[162,"call","RoundDeferralAmount",6]]},{"name":"SaveUserDefinedDeferralLineAmounts","line":169,"kind":"procedure","access":"local","params":9,"steps":[[180,"call","FilterDeferralLines",7],[186,"call","SaveDeferralLineAmounts",2]]},{"name":"RedistributeDeferralLines","line":199,"kind":"procedure","access":"local","params":4,"steps":[[207,"call","FilterDeferralLines",7],[212,"validate",1702,"Amount"],[213,"write",1702,"Modify",1],[220,"validate",1702,"Amount"],[221,"write",1702,"Modify",1]]},{"name":"CalcDeferralNoOfPeriods","line":232,"kind":"procedure","params":3,"steps":[[239,"event","OnBeforeCalcDeferralNoOfPeriods",1],[250,"call","IsAccountingPeriodExist",2]]},{"name":"CalculateStraightline","line":265,"kind":"procedure","access":"local","params":3,"steps":[[285,"event","OnBeforeCalculateStraightline",0],[287,"call","IsAccountingPeriodExist",2],[294,"event","OnCalculateStraightlineOnBeforeCalcPeriodicDeferralAmount",1],[297,"call","CalculateEqualPerPeriod",3],[305,"event","OnCalculateStraightlineOnAfterCalcPeriodicDeferralAmount",0],[308,"call","InitializeDeferralHeaderAndSetPostDate",4],[315,"call","GetPeriodStartingDate",1],[318,"call","GetNextPeriodStartingDate",1],[319,"event","OnCalculateStraightlineOnAfterCalcSecondPeriodDate",0],[337,"call","UpdateDeferralLineDescription",4],[339,"call","CheckPostingDate",2],[344,"event","OnCalculateStraightlineOnBeforeDeferralLineInsert",0],[345,"write",1702,"Insert"],[348,"event","OnAfterCalculateStraightline",0]]},{"name":"CheckPostingDate","line":351,"kind":"procedure","access":"local","params":2,"steps":[[357,"event","OnBeforeCheckPostingDate",1],[362,"ext","codeunit",11,"SetGenJnlBatch",1],[363,"ext","codeunit",11,"DeferralPostingDateNotAllowed",1]]},{"name":"CalculateEqualPerPeriod","line":367,"kind":"procedure","access":"local","params":3,"steps":[[374,"event","OnBeforeCalculateEqualPerPeriod",0],[377,"call","InitializeDeferralHeaderAndSetPostDate",4],[379,"validate",1702,"Posting Date"],[380,"call","UpdateDeferralLineDescription",4],[393,"event","OnCalculateEqualPerPeriodOnBeforeDeferralLineInsert",0],[394,"write",1702,"Insert"],[397,"event","OnAfterCalculateEqualPerPeriod",0]]},{"name":"CalculateDaysPerPeriod","line":400,"kind":"procedure","access":"local","params":3,"steps":[[418,"event","OnBeforeCalculateDaysPerPeriod",0],[420,"call","IsAccountingPeriodExist",2],[432,"call","IsAccountingPeriodExist",2],[451,"call","GetNextPeriodStartingDate",1],[455,"call","GetNextPeriodStartingDate",1],[460,"event","OnCalculateDaysPerPeriodOnAfterCalcEndDate",0],[466,"call","InitializeDeferralHeaderAndSetPostDate",4],[473,"call","GetNextPeriodStartingDate",1],[480,"call","GetCurPeriodStartingDate",1],[483,"call","GetNextPeriodStartingDate",1],[496,"call","UpdateDeferralLineDescription",4],[498,"call","CheckPostingDate",2],[502,"event","OnCalculateDaysPerPeriodOnBeforeDeferralLineInsert",0],[503,"write",1702,"Insert"],[506,"event","OnAfterCalculateDaysPerPeriod",0]]},{"name":"CalculateUserDefined","line":509,"kind":"procedure","access":"local","params":3,"steps":[[514,"event","OnBeforeCalculateUserDefined",0],[517,"call","InitializeDeferralHeaderAndSetPostDate",4],[520,"call","UpdateDeferralLineDescription",4],[522,"call","CheckPostingDate",2],[525,"event","OnCalculateUserDefinedOnBeforeDeferralLineInsert",0],[526,"write",1702,"Insert"],[529,"event","OnAfterCalculateUserDefined",0]]},{"name":"UpdateDeferralLineDescription","line":532,"kind":"procedure","access":"local","params":4,"steps":[[537,"event","OnBeforeUpdateDeferralLineDescription",1],[541,"call","CreateRecurringDescription",2]]},{"name":"IsDateNotAllowed","line":570,"kind":"procedure","params":1,"steps":[[578,"event","OnBeforeIsDateNotAllowed",1],[584,"ext","table",91,"CheckAllowedDeferralPostingDates",1],[590,"ext","table",98,"CheckAllowedDeferralPostingDates",1]]},{"name":"SetStartDate","line":599,"kind":"procedure","access":"local","params":2,"steps":[[636,"event","OnAfterSetStartDate",0]]},{"name":"SetDeferralRecords","line":659,"kind":"procedure","params":16,"steps":[[669,"write",1701,"Insert"],[680,"event","OnSetDeferralRecordsOnBeforeDeferralHeaderModify",0],[681,"write",1701,"Modify"],[683,"call","RemoveDeferralLines",6]]},{"name":"RemoveOrSetDeferralSchedule","line":702,"kind":"procedure","params":12,"steps":[[712,"event","OnBeforeRemoveOrSetDeferralSchedule",1],[719,"write",1701,"Delete"],[720,"call","RemoveDeferralLines",6],[725,"call","ValidateDeferralTemplate",1],[727,"call","GetDeferralStartDate",6],[742,"call","CreateDeferralSchedule",15],[745,"call","GetDeferralDescription",3]]},{"name":"CreateScheduleFromGL","line":756,"kind":"procedure","params":2,"steps":[[794,"ext","table",92,"GetReceivablesAccount",0],[799,"ext","table",93,"GetPayablesAccount",0],[825,"event","OnBeforePostedDeferralHeaderInsert",0],[826,"write",1704,"Insert",1],[827,"call","FilterDeferralLines",7],[843,"event","OnBeforePostedDeferralLineInsert",0],[844,"write",1705,"Insert",1],[848,"event","OnAfterCreateScheduleFromGL",0],[850,"ext","codeunit",12,"RemoveDeferralSchedule",1]]},{"name":"DeferralCodeOnValidate","line":868,"kind":"procedure","params":11,"steps":[[876,"event","OnBeforeDeferralCodeOnValidate",1],[884,"call","DeferralCodeOnDelete",6],[888,"call","ValidateDeferralTemplate",1],[890,"call","CreateDeferralSchedule",15],[893,"call","GetDeferralDescription",3]]},{"name":"DeferralCodeOnDelete","line":907,"kind":"procedure","params":6,"steps":[[914,"write",1701,"Delete"],[915,"call","RemoveDeferralLines",6]]},{"name":"OpenLineScheduleEdit","line":935,"kind":"procedure","params":11,"steps":[[943,"event","OnBeforeOpenLineScheduleEdit",0],[950,"event","OnOpenLineScheduleEditOnBeforeDeferralScheduleSetParameters",1],[952,"ext","page",1702,"SetParameter",6],[954,"ext","page",1702,"GetParameter",0],[957,"call","CreateDeferralSchedule",15],[960,"call","GetDeferralDescription",3],[963,"ext","page",1702,"SetParameter",6],[965,"ext","page",1702,"GetParameter",0]]},{"name":"OpenLineScheduleView","line":982,"kind":"procedure","params":7,"steps":[[991,"run","page",1704]]},{"name":"OpenLineScheduleArchive","line":1004,"kind":"procedure","params":7,"steps":[[1011,"run","page",1706]]},{"name":"RemoveDeferralLines","line":1014,"kind":"procedure","access":"local","params":6,"steps":[[1018,"call","FilterDeferralLines",7],[1019,"write",1702,"DeleteAll"]]},{"name":"ValidateDeferralTemplate","line":1022,"kind":"procedure","access":"local","params":1,"steps":[[1027,"event","OnBeforeValidateDeferralTemplate",1]]},{"name":"RoundDeferralAmount","line":1046,"kind":"procedure","params":6,"steps":[[1057,"event","OnBeforeRoundDeferralAmount",1],[1068,"ext","table",330,"ExchangeAmtFCYToLCY",4],[1069,"write",1701,"Modify"],[1073,"call","FilterDeferralLines",7],[1083,"write",1702,"Modify"],[1086,"ext","table",330,"ExchangeAmtFCYToLCY",4],[1088,"write",1702,"Modify"]]},{"name":"InitCurrency","line":1094,"kind":"procedure","access":"local","params":1,"steps":[[1099,"ext","table",4,"InitRoundingPrecision",0]]},{"name":"InitializeDeferralHeaderAndSetPostDate","line":1115,"kind":"procedure","params":4,"steps":[[1127,"event","OnInitializeDeferralHeaderAndSetPostDateAfterInitDeferralLine",0],[1137,"call","IsAccountingPeriodExist",2],[1144,"event","OnAfterInitializeDeferralHeaderAndSetPostDate",0]]},{"name":"IsAccountingPeriodExist","line":1147,"kind":"procedure","access":"local","params":2,"steps":[[1155,"ext","codeunit",360,"InitDefaultAccountingPeriod",2]]},{"name":"GetDeferralStartDate","line":1170,"kind":"procedure","params":6,"steps":[[1179,"call","SetStartDate",2]]},{"name":"AdjustTotalAmountForDeferrals","line":1213,"kind":"procedure","params":9,"steps":[[1226,"event","OnAfterAdjustTotalAmountForDeferrals",0]]},{"name":"AdjustTotalAmountForDeferralsNoBase","line":1254,"kind":"procedure","params":7,"steps":[[1265,"event","OnAfterAdjustTotalAmountForDeferrals",0]]},{"name":"CheckDeferralConditionForGenJournal","line":1273,"kind":"procedure","params":1,"steps":[[1288,"event","OnBeforeCheckDeferralConditionForGenJournal",1]]},{"name":"GetPeriodStartingDate","line":1361,"kind":"procedure","access":"local","params":1,"steps":[[1367,"event","OnBeforeGetPeriodStartingDate",0]]},{"name":"GetDeferralDescription","line":1407,"kind":"procedure","access":"local","params":3,"steps":[[1412,"event","OnBeforeGetDeferralDescription",1]]},{"name":"CreateCopyOfDeferralSchedule","line":1427,"kind":"procedure","params":2,"steps":[[1440,"write",1701,"Insert"],[1442,"call","FilterDeferralLines",7],[1448,"call","FilterDeferralLines",7],[1455,"write",1702,"Insert"]]}]}