Codeunit 415 Release Purchase Document
src/Layers/W1/BaseApp/Purchases/Document/ReleasePurchaseDocument.Codeunit.al454 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.Purchases.Document;using Microsoft.Finance.ReceivablesPayables;using Microsoft.Finance.VAT.Calculation;using Microsoft.Inventory.Item;using Microsoft.Inventory.Setup;using Microsoft.Purchases.Setup;using System.Automation;codeunit 415 "Release Purchase Document"{ TableNo = "Purchase Header"; Permissions = TableData "Purchase Header" = rm, TableData "Purchase Line" = r; trigger OnRun() begin PurchaseHeader.Copy(Rec); PurchaseHeader.SetHideValidationDialog(Rec.GetHideValidationDialog()); Code(); Rec := PurchaseHeader; end; var#pragma warning disable AA0074#pragma warning disable AA0470 Text001: Label 'There is nothing to release for the document of type %1 with the number %2.';#pragma warning restore AA0470#pragma warning restore AA0074 PurchSetup: Record "Purchases & Payables Setup"; InvtSetup: Record "Inventory Setup"; PurchaseHeader: Record "Purchase Header"; WhsePurchRelease: Codeunit "Whse.-Purch. Release";#pragma warning disable AA0074 Text002: Label 'This document can only be released when the approval process is complete.'; Text003: Label 'The approval process must be cancelled or completed to reopen this document.';#pragma warning disable AA0470 Text005: Label 'There are unpaid prepayment invoices that are related to the document of type %1 with the number %2.';#pragma warning restore AA0470#pragma warning restore AA0074 UnpostedPrepaymentAmountsErr: Label 'There are unposted prepayment amounts on the document of type %1 with the number %2.', Comment = '%1 - Document Type; %2 - Document No.'; PreviewMode: Boolean; SkipCheckReleaseRestrictions: Boolean; SkipWhseRequestOperations: Boolean; local procedure "Code"() LinesWereModified: Boolean var PurchLine: Record "Purchase Line"; PrepaymentMgt: Codeunit "Prepayment Mgt."; NotOnlyDropShipment: Boolean; PostingDate: Date; PrintPostedDocuments: Boolean; IsHandled: Boolean; begin if PurchaseHeader.Status = PurchaseHeader.Status::Released then exit; IsHandled := false; OnBeforeReleasePurchaseDoc(PurchaseHeader, PreviewMode, SkipCheckReleaseRestrictions, IsHandled, SkipWhseRequestOperations); if IsHandled then exit; if not (PreviewMode or SkipCheckReleaseRestrictions) then PurchaseHeader.CheckPurchaseReleaseRestrictions(); if PurchaseHeader."Document Type" = PurchaseHeader."Document Type"::Quote then if PurchaseHeader.CheckVendorCreated(true) then PurchaseHeader.Get(PurchaseHeader."Document Type"::Quote, PurchaseHeader."No.") else exit; PurchaseHeader.TestField("Buy-from Vendor No."); IsHandled := false; OnCodeOnAfterCheckPurchaseReleaseRestrictions(PurchaseHeader, IsHandled); if IsHandled then exit; CheckPurchLines(PurchLine); OnCodeOnAfterCheck(PurchaseHeader, PurchLine, LinesWereModified); PurchLine.SetRange("Drop Shipment", false); NotOnlyDropShipment := PurchLine.Find('-'); OnCodeOnCheckTracking(PurchaseHeader, PurchLine); PurchLine.Reset(); IsHandled := false; OnBeforeCalcInvDiscount(PurchaseHeader, PreviewMode, LinesWereModified, IsHandled); PurchSetup.Get(); if not IsHandled then if PurchSetup."Calc. Inv. Discount" then begin PostingDate := PurchaseHeader."Posting Date"; PrintPostedDocuments := PurchaseHeader."Print Posted Documents"; CODEUNIT.Run(CODEUNIT::"Purch.-Calc.Discount", PurchLine); LinesWereModified := true; PurchaseHeader.Get(PurchaseHeader."Document Type", PurchaseHeader."No."); PurchaseHeader."Print Posted Documents" := PrintPostedDocuments; if PostingDate <> PurchaseHeader."Posting Date" then PurchaseHeader.Validate("Posting Date", PostingDate); end; IsHandled := false; OnBeforeModifyPurchDoc(PurchaseHeader, PreviewMode, IsHandled); if IsHandled then exit; if PrepaymentMgt.TestPurchasePrepayment(PurchaseHeader) and (PurchaseHeader."Document Type" = PurchaseHeader."Document Type"::Order) then begin PurchaseHeader.Status := PurchaseHeader.Status::"Pending Prepayment"; PurchaseHeader.Modify(true); OnAfterReleasePurchaseDoc(PurchaseHeader, PreviewMode, LinesWereModified, SkipWhseRequestOperations); exit; end; PurchaseHeader.Status := PurchaseHeader.Status::Released; OnCodeOnBeforeCalcAndUpdateVATOnLines(PurchaseHeader); LinesWereModified := LinesWereModified or CalcAndUpdateVATOnLines(PurchaseHeader, PurchLine); OnCodeOnBeforeModifyHeader(PurchaseHeader, PurchLine, PreviewMode, LinesWereModified, NotOnlyDropShipment); PurchaseHeader.Modify(true); if NotOnlyDropShipment then if PurchaseHeader."Document Type" in [PurchaseHeader."Document Type"::Order, PurchaseHeader."Document Type"::"Return Order"] then if not SkipWhseRequestOperations then WhsePurchRelease.Release(PurchaseHeader); OnAfterReleasePurchaseDoc(PurchaseHeader, PreviewMode, LinesWereModified, SkipWhseRequestOperations); end; local procedure CheckPurchLines(var PurchLine: Record "Purchase Line") var IsHandled: Boolean; begin IsHandled := false; OnBeforeCheckPurchLines(PurchaseHeader, PurchLine, IsHandled); if IsHandled then exit; PurchLine.SetRange("Document Type", PurchaseHeader."Document Type"); PurchLine.SetRange("Document No.", PurchaseHeader."No."); PurchLine.SetFilter(Type, '>0'); PurchLine.SetFilter(Quantity, '<>0'); IsHandled := false; OnCodeOnAfterPurchLineSetFilters(PurchaseHeader, PurchLine, IsHandled); if not IsHandled then if not PurchLine.Find('-') then Error(Text001, PurchaseHeader."Document Type", PurchaseHeader."No."); CheckMandatoryFields(PurchLine); end; local procedure CheckMandatoryFields(var PurchaseLine: Record "Purchase Line") var Item: Record "Item"; IsHandled: Boolean; begin IsHandled := false; OnBeforeMandatoryFields(PurchaseHeader, IsHandled); if IsHandled then exit; InvtSetup.Get(); PurchaseLine.SetRange(Type, PurchaseLine.Type::Item); if PurchaseLine.FindSet() then repeat if PurchaseLine.IsInventoriableItem() then begin if InvtSetup."Location Mandatory" then begin IsHandled := false; OnCodeOnCheckPurchLineLocationCode(PurchaseLine, IsHandled); if not IsHandled then PurchaseLine.TestField("Location Code"); end; PurchaseLine.TestField("Unit of Measure Code"); if PurchaseLine."Document Type" in [PurchaseLine."Document Type"::Order] then PurchaseLine.TestPurchaseJobFields(); end; if Item.Get(PurchaseLine."No.") then if Item.IsVariantMandatory() then PurchaseLine.TestField("Variant Code"); until PurchaseLine.Next() = 0; PurchaseLine.SetFilter(Type, '>0'); end; procedure Reopen(var PurchHeader: Record "Purchase Header") var IsHandled: Boolean; begin IsHandled := false; OnBeforeReopenPurchaseDoc(PurchHeader, PreviewMode, IsHandled, SkipWhseRequestOperations); if IsHandled then exit; if PurchHeader.Status = PurchHeader.Status::Open then exit; if PurchHeader."Document Type" in [PurchHeader."Document Type"::Order, PurchHeader."Document Type"::"Return Order"] then if not SkipWhseRequestOperations then WhsePurchRelease.Reopen(PurchHeader); PurchHeader.Status := PurchHeader.Status::Open; OnReopenOnBeforePurchaseHeaderModify(PurchHeader); PurchHeader.Modify(true); OnAfterReopenPurchaseDoc(PurchHeader, PreviewMode, SkipWhseRequestOperations); end; procedure PerformManualRelease(var PurchHeader: Record "Purchase Header") var PrepaymentMgt: Codeunit "Prepayment Mgt."; begin OnPerformManualReleaseOnBeforeTestPurchasePrepayment(PurchHeader, PreviewMode); if PrepaymentMgt.TestPurchasePrepayment(PurchHeader) then Error(UnpostedPrepaymentAmountsErr, PurchHeader."Document Type", PurchHeader."No."); OnBeforeManualReleasePurchaseDoc(PurchHeader, PreviewMode); PerformManualCheckAndRelease(PurchHeader); OnAfterManualReleasePurchaseDoc(PurchHeader, PreviewMode); end; procedure PerformManualCheckAndRelease(var PurchHeader: Record "Purchase Header") var PrepaymentMgt: Codeunit "Prepayment Mgt."; IsHandled: Boolean; begin IsHandled := false; OnBeforePerformManualCheckAndRelease(PurchHeader, PreviewMode, IsHandled); if IsHandled then exit; if (PurchHeader."Document Type" = PurchHeader."Document Type"::Order) and PrepaymentMgt.TestPurchasePayment(PurchHeader) then begin if PurchHeader.TestStatusIsNotPendingPrepayment() then begin PurchHeader.Status := PurchHeader.Status::"Pending Prepayment"; PurchHeader.Modify(); Commit(); end; Error(Text005, PurchHeader."Document Type", PurchHeader."No."); end; CheckPurchaseHeaderPendingApproval(PurchHeader); IsHandled := false; OnBeforePerformManualRelease(PurchHeader, PreviewMode, IsHandled); if IsHandled then exit; CODEUNIT.Run(CODEUNIT::"Release Purchase Document", PurchHeader); OnAfterPerformManualCheckAndRelease(PurchHeader); end; local procedure CheckPurchaseHeaderPendingApproval(var PurchHeader: Record "Purchase Header") var ApprovalsMgmt: Codeunit "Approvals Mgmt."; IsHandled: Boolean; begin IsHandled := false; OnBeforeCheckPurchaseHeaderPendingApproval(PurchHeader, IsHandled); if IsHandled then exit; if ApprovalsMgmt.IsPurchaseHeaderPendingApproval(PurchHeader) then Error(Text002); end; procedure PerformManualReopen(var PurchHeader: Record "Purchase Header") begin CheckReopenStatus(PurchHeader); OnBeforeManualReopenPurchaseDoc(PurchHeader, PreviewMode); Reopen(PurchHeader); OnAfterManualReopenPurchaseDoc(PurchHeader, PreviewMode); end; local procedure CheckReopenStatus(PurchHeader: Record "Purchase Header") var IsHandled: Boolean; begin IsHandled := false; OnBeforeCheckReopenStatus(PurchHeader, IsHandled); if IsHandled then exit; if PurchHeader.Status = PurchHeader.Status::"Pending Approval" then Error(Text003); end; procedure ReleasePurchaseHeader(var PurchHdr: Record "Purchase Header"; Preview: Boolean) LinesWereModified: Boolean begin PreviewMode := Preview; PurchaseHeader.Copy(PurchHdr); LinesWereModified := Code(); PurchHdr := PurchaseHeader; end; procedure CalcAndUpdateVATOnLines(var PurchaseHeader: Record "Purchase Header"; var PurchLine: Record "Purchase Line") LinesWereModified: Boolean var TempVATAmountLine0: Record "VAT Amount Line" temporary; TempVATAmountLine1: Record "VAT Amount Line" temporary; begin PurchLine.SetPurchHeader(PurchaseHeader); PurchLine.CalcVATAmountLines(0, PurchaseHeader, PurchLine, TempVATAmountLine0); PurchLine.CalcVATAmountLines(1, PurchaseHeader, PurchLine, TempVATAmountLine1); LinesWereModified := PurchLine.UpdateVATOnLines(0, PurchaseHeader, PurchLine, TempVATAmountLine0) or PurchLine.UpdateVATOnLines(1, PurchaseHeader, PurchLine, TempVATAmountLine1); end; procedure SetSkipCheckReleaseRestrictions() begin SkipCheckReleaseRestrictions := true; end; internal procedure SetSkipWhseRequestOperations(NewSkipWhseRequestOperations: Boolean) begin SkipWhseRequestOperations := NewSkipWhseRequestOperations; end; [IntegrationEvent(false, false)] local procedure OnBeforeCalcInvDiscount(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var LinesWereModified: Boolean; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeCheckPurchaseHeaderPendingApproval(var PurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeCheckReopenStatus(var PurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeManualReleasePurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforePerformManualCheckAndRelease(var PurchHeader: Record "Purchase Header"; PreviewMode: Boolean; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeReleasePurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var SkipCheckReleaseRestrictions: Boolean; var IsHandled: Boolean; SkipWhseRequestOperations: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnAfterReleasePurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var LinesWereModified: Boolean; SkipWhseRequestOperations: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnAfterManualReleasePurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeManualReopenPurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeReopenPurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var IsHandled: Boolean; SkipWhseRequestOperations: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeModifyPurchDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforePerformManualRelease(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeCheckPurchLines(var PurchaseHeader: Record "Purchase Header"; var PurchLine: Record "Purchase Line"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnAfterReopenPurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean; SkipWhseRequestOperations: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnAfterManualReopenPurchaseDoc(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnAfterCheck(PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; var LinesWereModified: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnAfterPurchLineSetFilters(PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnBeforeModifyHeader(var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; PreviewMode: Boolean; var LinesWereModified: Boolean; var NotOnlyDropShipment: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnCheckTracking(PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"); begin end; [IntegrationEvent(false, false)] local procedure OnPerformManualReleaseOnBeforeTestPurchasePrepayment(var PurchaseHeader: Record "Purchase Header"; PreviewMode: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnAfterCheckPurchaseReleaseRestrictions(var PurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnBeforeCalcAndUpdateVATOnLines(var PurchaseHeader: Record "Purchase Header") begin end; [IntegrationEvent(false, false)] local procedure OnCodeOnCheckPurchLineLocationCode(var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeMandatoryFields(PurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnReopenOnBeforePurchaseHeaderModify(var PurchaseHeader: Record "Purchase Header") begin end; [IntegrationEvent(false, false)] local procedure OnAfterPerformManualCheckAndRelease(var PurchaseHeader: Record "Purchase Header") begin end;}