Codeunit 179 Reversal-Post

Base Application, Microsoft.Finance.GeneralLedger.Reversal

src/Layers/W1/BaseApp/Finance/GeneralLedger/Reversal/ReversalPost.Codeunit.al189 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace Microsoft.Finance.GeneralLedger.Reversal;using Microsoft.Finance.Deferral;using Microsoft.Finance.GeneralLedger.Journal;using Microsoft.Finance.GeneralLedger.Ledger;/// <summary>/// Handles the posting phase of reversal operations by creating correcting ledger entries./// Integrates with the posting engine to create offsetting transactions and manages G/L register creation./// </summary>/// <remarks>/// Extensibility: Integration events for custom posting logic and G/L register printing customization./// Dependencies: Gen. Jnl.-Post Batch codeunit, G/L Register management, and Deferral posting integration./// </remarks>codeunit 179 "Reversal-Post"{    TableNo = "Reversal Entry";    trigger OnRun()    var        GLReg: Record "G/L Register";        GenJnlTemplate: Record "Gen. Journal Template";        PostedDeferralHeader: Record "Posted Deferral Header";        GenJnlPostReverse: Codeunit "Gen. Jnl.-Post Reverse";        Txt: Text[1024];        WarningText: Text[250];        Number: Integer;        Handled: Boolean;    begin        OnBeforeOnRun(Rec);        Rec.Reset();        Rec.SetRange("Entry Type", Rec."Entry Type"::"Fixed Asset");        if Rec.FindFirst() then            WarningText := Text007;        Rec.SetRange("Entry Type");        if PrintRegister then            Txt := Text004 + WarningText + '\' + Text005        else            Txt := Text004 + WarningText + '\' + Text002;        OnRunOnAfterCreateTxt(PrintRegister, Txt, WarningText);        if not Rec.FindFirst() then            Error(Text006);        if not HideDialog then            if not Confirm(Txt, false) then                exit;        Handled := false;        OnRunOnAfterConfirm(Rec, Handled, PrintRegister, HideDialog);        if Handled then            exit;        ReversalEntry := Rec;        if Rec."Reversal Type" = Rec."Reversal Type"::Transaction then            ReversalEntry.SetReverseFilter(Rec."Transaction No.", Rec."Reversal Type")        else            ReversalEntry.SetReverseFilter(Rec."G/L Register No.", Rec."Reversal Type");        OnRunOnBeforeCheckEntries(Rec);        ReversalEntry.CheckEntries();        Rec.Get(1);        if Rec."Reversal Type" = Rec."Reversal Type"::Register then            Number := Rec."G/L Register No."        else            Number := Rec."Transaction No.";        if not ReversalEntry.VerifyReversalEntries(Rec, Number, Rec."Reversal Type") then            Error(Text008);        GenJnlPostReverse.Reverse(ReversalEntry, Rec);        if PrintRegister then begin            GenJnlTemplate.Validate(Type);            if GenJnlTemplate."Posting Report ID" <> 0 then                if GLReg.FindLast() then begin                    GLReg.SetRecFilter();                    OnBeforeGLRegPostingReportPrint(GenJnlTemplate."Posting Report ID", false, false, GLReg, Handled);                    if not Handled then                        REPORT.Run(GenJnlTemplate."Posting Report ID", false, false, GLReg);                end;        end;        OnRunOnBeforeDeleteAll(Rec, Number);        Rec.DeleteAll();        PostedDeferralHeader.DeleteForDoc("Deferral Document Type"::"G/L".AsInteger(), ReversalEntry."Document No.", '', 0, '');        if not HideDialog then            Message(Text003);    end;    var        ReversalEntry: Record "Reversal Entry";        PrintRegister: Boolean;        HideDialog: Boolean;#pragma warning disable AA0074        Text002: Label 'Do you want to reverse the entries?';        Text003: Label 'The entries were successfully reversed.';        Text004: Label 'To reverse these entries, correcting entries will be posted.';        Text005: Label 'Do you want to reverse the entries and print the report?';        Text006: Label 'There is nothing to reverse.';        Text007: Label '\There are one or more FA Ledger Entries. You should consider using the fixed asset function Cancel Entries.';        Text008: Label 'Changes have been made to posted entries after the window was opened.\Close and reopen the window to continue.';#pragma warning restore AA0074    /// <summary>    /// Sets whether to print the G/L register after posting reversal entries.    /// </summary>    /// <param name="NewPrintRegister">True to print G/L register after posting, false otherwise</param>    procedure SetPrint(NewPrintRegister: Boolean)    begin        PrintRegister := NewPrintRegister;    end;    /// <summary>    /// Sets whether to hide confirmation dialogs during reversal posting.    /// </summary>    /// <param name="NewHideDialog">True to hide dialogs, false to show confirmation prompts</param>    procedure SetHideDialog(NewHideDialog: Boolean)    begin        HideDialog := NewHideDialog;    end;    /// <summary>    /// Integration event raised before printing the G/L register posting report, allowing customization of report settings.    /// </summary>    /// <param name="ReportID">Report ID that can be modified by subscribers</param>    /// <param name="ReqWindow">Whether to show the report request window</param>    /// <param name="SystemPrinter">Whether to use the system printer</param>    /// <param name="GLRegister">G/L register record being printed</param>    /// <param name="Handled">Set to true to skip standard report printing</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeGLRegPostingReportPrint(var ReportID: Integer; ReqWindow: Boolean; SystemPrinter: Boolean; var GLRegister: Record "G/L Register"; var Handled: Boolean)    begin    end;    /// <summary>    /// Integration event raised before starting the reversal posting process, allowing preprocessing of reversal entries.    /// </summary>    /// <param name="ReversalEntry">Reversal entry record being processed</param>    [IntegrationEvent(true, false)]    local procedure OnBeforeOnRun(var ReversalEntry: Record "Reversal Entry")    begin    end;    /// <summary>    /// Integration event raised before deleting reversal entries after successful posting.    /// </summary>    /// <param name="ReversalEntry">Reversal entry record being deleted</param>    /// <param name="Number">Transaction or register number being reversed</param>    [IntegrationEvent(false, false)]    local procedure OnRunOnBeforeDeleteAll(var ReversalEntry: Record "Reversal Entry"; Number: Integer)    begin    end;    /// <summary>    /// Integration event raised after user confirmation, allowing custom handling of the reversal process.    /// </summary>    /// <param name="ReversalEntry">Reversal entry record being processed</param>    /// <param name="Handled">Set to true to skip standard processing</param>    /// <param name="PrintRegister">Whether to print G/L register after posting</param>    /// <param name="HideDialog">Whether dialogs are hidden during processing</param>    [IntegrationEvent(false, false)]    local procedure OnRunOnAfterConfirm(var ReversalEntry: Record "Reversal Entry"; var Handled: Boolean; PrintRegister: Boolean; HideDialog: Boolean)    begin    end;    /// <summary>    /// Integration event raised after creating confirmation text, allowing customization of user messages.    /// </summary>    /// <param name="PrintRegister">Whether G/L register will be printed</param>    /// <param name="Txt">Confirmation message text that can be modified</param>    /// <param name="WarningText">Warning message text</param>    [IntegrationEvent(false, false)]    local procedure OnRunOnAfterCreateTxt(PrintRegister: Boolean; var Txt: Text[1024]; WarningText: Text[250])    begin    end;    /// <summary>    /// Integration event raised before validating reversal entries, allowing custom pre-validation logic.    /// </summary>    /// <param name="ReversalEntry">Reversal entry record being validated</param>    [IntegrationEvent(false, false)]    local procedure OnRunOnBeforeCheckEntries(var ReversalEntry: Record "Reversal Entry")    begin    end;}