Codeunit 200 Alt. Cust. VAT. Reg. Facade
src/Layers/W1/BaseApp/Finance/VAT/Registration/AltCustVATRegFacade.Codeunit.al257 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.VAT.Registration;using Microsoft.Sales.Customer;using Microsoft.Sales.Document;using System.Diagnostics;/// <summary>/// Facade for alternative customer VAT registration functionality in sales documents./// Provides simplified interface for VAT registration management across different shipping scenarios and country changes./// </summary>codeunit 200 "Alt. Cust. VAT. Reg. Facade"{ Access = Public; var AltCustVATRegOrchestrator: Codeunit "Alt. Cust. VAT Reg. Orchest."; /// <summary> /// Updates VAT setup when ship-to country/region changes in sales header. /// </summary> /// <param name="SalesHeader">Sales header being modified</param> /// <param name="xSalesHeader">Original sales header before changes</param> procedure UpdateSetupOnShipToCountryChangeInSalesHeader(var SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header") begin AltCustVATRegOrchestrator.GetAltCustVATRegDocImpl().UpdateSetupOnShipToCountryChangeInSalesHeader(SalesHeader, xSalesHeader); end; /// <summary> /// Updates VAT setup when VAT country/region changes in sales header. /// </summary> /// <param name="SalesHeader">Sales header being modified</param> /// <param name="xSalesHeader">Original sales header before changes</param> procedure UpdateSetupOnVATCountryChangeInSalesHeader(var SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header") begin AltCustVATRegOrchestrator.GetAltCustVATRegDocImpl().UpdateSetupOnVATCountryChangeInSalesHeader(SalesHeader, xSalesHeader); end; /// <summary> /// Updates VAT setup when bill-to customer changes in sales header. /// </summary> /// <param name="SalesHeader">Sales header being modified</param> /// <param name="xSalesHeader">Original sales header before changes</param> /// <param name="BillToCustomer">New bill-to customer record</param> procedure UpdateSetupOnBillToCustomerChangeInSalesHeader(var SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header"; BillToCustomer: Record Customer) begin AltCustVATRegOrchestrator.GetAltCustVATRegDocImpl().UpdateSetupOnBillToCustomerChangeInSalesHeader(SalesHeader, xSalesHeader, BillToCustomer); end; /// <summary> /// Copies alternative VAT registration settings from customer to sales header. /// </summary> /// <param name="SalesHeader">Sales header to update with customer VAT settings</param> /// <param name="xSalesHeader">Original sales header before changes</param> procedure CopyFromCustomer(var SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header") begin AltCustVATRegOrchestrator.GetAltCustVATRegDocImpl().CopyFromCustomer(SalesHeader, xSalesHeader); end; /// <summary> /// Initializes alternative VAT registration setup for sales header. /// </summary> /// <param name="SalesHeader">Sales header to initialize with VAT registration settings</param> /// <param name="xSalesHeader">Original sales header before changes</param> procedure Init(var SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header") begin AltCustVATRegOrchestrator.GetAltCustVATRegDocImpl().Init(SalesHeader, xSalesHeader); end; /// <summary> /// Retrieves alternative customer VAT registration record for specified customer and country. /// </summary> /// <param name="AltCustVATReg">Alternative customer VAT registration record to populate</param> /// <param name="CustNo">Customer number to search for</param> /// <param name="CountryCode">Country/region code for VAT registration</param> /// <returns>True if alternative VAT registration record found</returns> procedure GetAlternativeCustVATReg(var AltCustVATReg: Record "Alt. Cust. VAT Reg."; CustNo: Code[20]; CountryCode: Code[10]): Boolean begin AltCustVATReg.SetRange("Customer No.", CustNo); AltCustVATReg.SetRange("VAT Country/Region Code", CountryCode); exit(AltCustVATReg.FindFirst()); end; /// <summary> /// Determines whether customer VAT registration number should be updated from sales header. /// </summary> /// <param name="SalesHeader">Sales header containing VAT registration information</param> /// <param name="Customer">Customer record to potentially update</param> /// <returns>True if customer VAT registration should be updated</returns> procedure UpdateVATRegNoInCustFromSalesHeader(SalesHeader: Record "Sales Header"; Customer: Record Customer) ShouldUpdate: Boolean var IsHandled: Boolean; begin OnBeforeUpdateVATRegNoInCustFromSalesHeader(SalesHeader, Customer, ShouldUpdate, IsHandled); if IsHandled then exit(ShouldUpdate); exit((Customer."VAT Registration No." = '') and (not SalesHeader."Alt. VAT Registration No.")); end; /// <summary> /// Determines whether VAT data has changed during ship-to code validation. /// </summary> /// <param name="SalesHeader">Current sales header</param> /// <param name="xSalesHeader">Original sales header before changes</param> /// <returns>True if VAT-related data has changed</returns> procedure VATDataIsChangedOnShipToCodeValidation(SalesHeader: Record "Sales Header"; xSalesHeader: Record "Sales Header") Changed: Boolean var IsHandled: Boolean; begin OnBeforeVATDataIsChangedOnShipToCodeValidation(SalesHeader, xSalesHeader, Changed, IsHandled); if IsHandled then exit(Changed); if SalesHeader."Alt. Gen. Bus Posting Group" or SalesHeader."Alt. VAT Bus Posting Group" or xSalesHeader."Alt. Gen. Bus Posting Group" or xSalesHeader."Alt. VAT Bus Posting Group" then exit(false); exit(xSalesHeader."VAT Country/Region Code" <> SalesHeader."VAT Country/Region Code"); end; /// <summary> /// Handles country/region change events in ship-to address records. /// </summary> /// <param name="ShipToAddress">Ship-to address record with country/region change</param> procedure HandleCountryChangeInShipToAddress(ShipToAddress: Record "Ship-to Address") begin AltCustVATRegOrchestrator.GetShipToAlCustVATRegImpl().HandleCountryChangeInShipToAddress(ShipToAddress); end; /// <summary> /// Validates consistency of alternative customer VAT registration setup. /// </summary> /// <param name="AltCustVATReg">Alternative customer VAT registration record to validate</param> procedure CheckAltCustVATRegConsistent(AltCustVATReg: Record "Alt. Cust. VAT Reg.") begin AltCustVATRegOrchestrator.GetAltCustVATRegConsistencyImpl().CheckAltCustVATRegConsistent(AltCustVATReg); end; /// <summary> /// Validates consistency of customer VAT registration setup across all alternative registrations. /// </summary> /// <param name="Customer">Customer record to validate for VAT registration consistency</param> procedure CheckCustomerConsistency(Customer: Record Customer) begin AltCustVATRegOrchestrator.GetAltCustVATRegConsistencyImpl().CheckCustomerConsistency(Customer); end; /// <summary> /// Copies the alternative customer VAT registration data to the sales header. /// </summary> procedure CopyAltCustVATRegToSalesHeader(var SalesHeader: Record "Sales Header"; AltCustVATReg: Record "Alt. Cust. VAT Reg.") begin if AltCustVATReg."VAT Registration No." <> '' then begin SalesHeader.Validate("Alt. VAT Registration No.", true); SalesHeader.Validate("VAT Registration No.", AltCustVATReg."VAT Registration No."); end; if AltCustVATReg."Gen. Bus. Posting Group" <> '' then begin SalesHeader.Validate("Alt. Gen. Bus Posting Group", true); SalesHeader.Validate("Gen. Bus. Posting Group", AltCustVATReg."Gen. Bus. Posting Group"); end; if AltCustVATReg."VAT Bus. Posting Group" <> '' then begin SalesHeader.Validate("Alt. VAT Bus Posting Group", true); SalesHeader.Validate("VAT Bus. Posting Group", AltCustVATReg."VAT Bus. Posting Group"); end; OnAfterCopyAltCustVATRegToSalesHeader(SalesHeader, AltCustVATReg); end; /// <summary> /// Adds a record to the temporary change log entry if values of alternative customer VAT registration fields have changed. /// </summary> procedure AddTempChangeLogEntryForAltCustVATRegChanges(var TempChangeLogEntry: Record "Change Log Entry" temporary; SalesHeader: Record "Sales Header"; AltCustVATReg: Record "Alt. Cust. VAT Reg.") begin if (AltCustVATReg."VAT Registration No." <> '') and (SalesHeader."VAT Registration No." <> AltCustVATReg."VAT Registration No.") then AddFieldChangeBuffer(TempChangeLogEntry, SalesHeader.FieldNo("VAT Registration No."), SalesHeader."VAT Registration No.", AltCustVATReg."VAT Registration No."); if (AltCustVATReg."Gen. Bus. Posting Group" <> '') and (SalesHeader."Gen. Bus. Posting Group" <> AltCustVATReg."Gen. Bus. Posting Group") then AddFieldChangeBuffer(TempChangeLogEntry, SalesHeader.FieldNo("Gen. Bus. Posting Group"), SalesHeader."Gen. Bus. Posting Group", AltCustVATReg."Gen. Bus. Posting Group"); if (AltCustVATReg."VAT Bus. Posting Group" <> '') and (SalesHeader."VAT Bus. Posting Group" <> AltCustVATReg."VAT Bus. Posting Group") then AddFieldChangeBuffer(TempChangeLogEntry, SalesHeader.FieldNo("VAT Bus. Posting Group"), SalesHeader."VAT Bus. Posting Group", AltCustVATReg."VAT Bus. Posting Group"); OnAfterAddTempChangeLogEntryForAltCustVATRegChanges(TempChangeLogEntry, SalesHeader, AltCustVATReg); end; /// <summary> /// Copies the bill-to customer data to sales header. /// </summary> procedure CopyBillToCustomerToSalesHeader(var SalesHeader: Record "Sales Header"; BillToCustomer: Record Customer) begin if (SalesHeader."VAT Bus. Posting Group" <> '') and (SalesHeader."VAT Bus. Posting Group" <> BillToCustomer."VAT Bus. Posting Group") then SalesHeader.Validate("VAT Bus. Posting Group", BillToCustomer."VAT Bus. Posting Group") else SalesHeader."VAT Bus. Posting Group" := BillToCustomer."VAT Bus. Posting Group"; SalesHeader."VAT Country/Region Code" := BillToCustomer."Country/Region Code"; SalesHeader."VAT Registration No." := BillToCustomer."VAT Registration No."; SalesHeader."Registration Number" := BillToCustomer."Registration Number"; SalesHeader."Gen. Bus. Posting Group" := BillToCustomer."Gen. Bus. Posting Group"; OnAfterCopyBillToCustomerToSalesHeader(SalesHeader, BillToCustomer); end; local procedure AddFieldChangeBuffer(var TempChangeLogEntry: Record "Change Log Entry" temporary; DocFieldNo: Integer; OldValue: Text[2048]; NewValue: Text[2048]) begin TempChangeLogEntry."Entry No." += 1; TempChangeLogEntry."Table No." := Database::"Sales Header"; TempChangeLogEntry."Field No." := DocFieldNo; TempChangeLogEntry."Old Value" := OldValue; TempChangeLogEntry."New Value" := NewValue; TempChangeLogEntry.Insert(); end; /// <summary> /// Integration event raised before determining whether to update customer VAT registration number from sales header. /// </summary> /// <param name="SalesHeader">Sales header containing VAT registration information</param> /// <param name="Customer">Customer record to potentially update</param> /// <param name="ShouldUpdate">Set to true if customer VAT registration should be updated</param> /// <param name="IsHandled">Set to true to skip standard logic</param> [IntegrationEvent(false, false)] local procedure OnBeforeUpdateVATRegNoInCustFromSalesHeader(var SalesHeader: Record "Sales Header"; Customer: Record Customer; var ShouldUpdate: Boolean; var IsHandled: Boolean) begin end; /// <summary> /// Integration event raised before determining whether VAT data has changed during ship-to code validation. /// </summary> /// <param name="SalesHeader">Current sales header</param> /// <param name="xSalesHeader">Original sales header before changes</param> /// <param name="Changed">Set to true if VAT data has changed</param> /// <param name="IsHandled">Set to true to skip standard logic</param> [IntegrationEvent(false, false)] local procedure OnBeforeVATDataIsChangedOnShipToCodeValidation(var SalesHeader: Record "Sales Header"; var xSalesHeader: Record "Sales Header"; var Changed: Boolean; var IsHandled: Boolean) begin end; /// <summary> /// Integration event raised after copying alternative customer VAT registration data to sales header. /// </summary> [IntegrationEvent(false, false)] local procedure OnAfterCopyAltCustVATRegToSalesHeader(var SalesHeader: Record "Sales Header"; var AltCustVATReg: Record "Alt. Cust. VAT Reg.") begin end; /// <summary> /// Integration event raised after adding temporary change log entries for alternative customer VAT registration changes. /// </summary> [IntegrationEvent(false, false)] local procedure OnAfterAddTempChangeLogEntryForAltCustVATRegChanges(var TempChangeLogEntry: Record "Change Log Entry" temporary; SalesHeader: Record "Sales Header"; AltCustVATReg: Record "Alt. Cust. VAT Reg.") begin end; /// <summary> /// Integration event raised after copying bill-to customer data to sales header. /// </summary> [IntegrationEvent(false, false)] local procedure OnAfterCopyBillToCustomerToSalesHeader(var SalesHeader: Record "Sales Header"; Customer: Record Customer) begin end;}