Codeunit 249 VAT Registration Log Mgt.

Base Application, Microsoft.Finance.VAT.Registration

src/Layers/W1/BaseApp/Finance/VAT/Registration/VATRegistrationLogMgt.Codeunit.al697 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.CRM.Contact;using Microsoft.Foundation.Address;using Microsoft.Foundation.Company;using Microsoft.Purchases.Vendor;using Microsoft.Sales.Customer;using Microsoft.Utilities;using System;using System.Environment;using System.Reflection;using System.Xml;/// <summary>/// Manages VAT registration number validation logging and VIES service integration./// Provides comprehensive validation tracking and external service communication for EU VAT verification./// </summary>codeunit 249 "VAT Registration Log Mgt."{    Permissions = TableData "VAT Registration Log" = rimd;    trigger OnRun()    begin    end;    var        DataTypeManagement: Codeunit "Data Type Management";        ClientTypeManagement: Codeunit "Client Type Management";        ValidPathTxt: Label 'descendant::vat:valid', Locked = true;        NamePathTxt: Label 'descendant::vat:traderName', Locked = true;        AddressPathTxt: Label 'descendant::vat:traderAddress', Locked = true;        RequestIdPathTxt: Label 'descendant::vat:requestIdentifier', Locked = true;        PostcodePathTxt: Label 'descendant::vat:traderPostcode', Locked = true;        StreetPathTxt: Label 'descendant::vat:traderStreet', Locked = true;        CityPathTxt: Label 'descendant::vat:traderCity', Locked = true;        ValidVATNoMsg: Label 'The specified VAT registration number is valid.';        InvalidVatRegNoMsg: Label 'We didn''t find a match for this VAT registration number. Please verify that you specified the right number.';        NotVerifiedVATRegMsg: Label 'We couldn''t verify the VAT registration number. Please try again later.';        VATSrvDisclaimerUrlTok: Label 'https://go.microsoft.com/fwlink/?linkid=841741', Locked = true;        DescriptionLbl: Label 'EU VAT Reg. No. Validation Service Setup';        UnexpectedResponseErr: Label 'The VAT registration number could not be verified because the VIES VAT Registration No. service may be currently unavailable for the selected EU state, %1.', Comment = '%1 - Country / Region Code';        UnexpectedResponseQst: Label 'The VAT registration number could not be verified because the VIES VAT Registration No. service may be currently unavailable for the selected EU state, %1. Do you want to continue without validation?', Comment = '%1 - Country / Region Code';        EUVATRegNoValidationServiceTok: Label 'EUVATRegNoValidationServiceTelemetryCategoryTok', Locked = true;        ValidationFailureMsg: Label 'VIES service may be currently unavailable', Locked = true;        NameMatchPathTxt: Label 'descendant::vat:traderNameMatch', Locked = true;        StreetMatchPathTxt: Label 'descendant::vat:traderStreetMatch', Locked = true;        PostcodeMatchPathTxt: Label 'descendant::vat:traderPostcodeMatch', Locked = true;        CityMatchPathTxt: Label 'descendant::vat:traderCityMatch', Locked = true;        DetailsNotVerifiedMsg: Label 'The specified VAT registration number is valid.\The VAT VIES validation service did not provide additional details.';        DetailsIgnoredMsg: Label 'The specified VAT registration number is valid.\The current configuration of the VAT VIES validation service excludes additional details.';    /// <summary>    /// Creates VAT registration log entry for customer and initiates validation if service is enabled.    /// </summary>    /// <param name="Customer">Customer record containing VAT registration number for validation</param>    procedure LogCustomer(Customer: Record Customer)    var        VATRegistrationLog: Record "VAT Registration Log";        CountryCode: Code[10];    begin        CountryCode := GetCountryCode(Customer."Country/Region Code");        if not IsEUCountry(CountryCode) then            exit;        InsertVATRegistrationLog(          Customer."VAT Registration No.", CountryCode, VATRegistrationLog."Account Type"::Customer, Customer."No.");    end;    /// <summary>    /// Creates VAT registration log entry for vendor and initiates validation if service is enabled.    /// </summary>    /// <param name="Vendor">Vendor record containing VAT registration number for validation</param>    procedure LogVendor(Vendor: Record Vendor)    var        VATRegistrationLog: Record "VAT Registration Log";        CountryCode: Code[10];    begin        CountryCode := GetCountryCode(Vendor."Country/Region Code");        if not IsEUCountry(CountryCode) then            exit;        InsertVATRegistrationLog(          Vendor."VAT Registration No.", CountryCode, VATRegistrationLog."Account Type"::Vendor, Vendor."No.");    end;    /// <summary>    /// Creates VAT registration log entry for contact and initiates validation if service is enabled.    /// </summary>    /// <param name="Contact">Contact record containing VAT registration number for validation</param>    procedure LogContact(Contact: Record Contact)    var        VATRegistrationLog: Record "VAT Registration Log";        CountryCode: Code[10];    begin        CountryCode := GetCountryCode(Contact."Country/Region Code");        if not IsEUCountry(CountryCode) then            exit;        InsertVATRegistrationLog(          Contact."VAT Registration No.", CountryCode, VATRegistrationLog."Account Type"::Contact, Contact."No.");    end;    [Scope('OnPrem')]    procedure LogVerification(var VATRegistrationLog: Record "VAT Registration Log"; XMLDoc: DotNet XmlDocument; Namespace: Text)    var        XMLDOMMgt: Codeunit "XML DOM Management";        FoundXmlNode: DotNet XmlNode;        ResponsedName: Text;        ResponsedPostCode: Text;        ResponsedCity: Text;        ResponsedStreet: Text;        ResponsedAddress: Text;        MatchName: Boolean;        MatchStreet: Boolean;        MatchPostCode: Boolean;        MatchCity: Boolean;    begin        if not XMLDOMMgt.FindNodeWithNamespace(XMLDoc.DocumentElement, ValidPathTxt, 'vat', Namespace, FoundXmlNode) then begin            Session.LogMessage('0000C4T', ValidationFailureMsg, Verbosity::Error, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EUVATRegNoValidationServiceTok);            if not GuiAllowed() then                Error(UnexpectedResponseErr);            if Confirm(StrSubstNo(UnexpectedResponseQst, VATRegistrationLog."Country/Region Code")) then                exit            else                Error('');        end;        case LowerCase(FoundXmlNode.InnerText) of            'true':                begin                    VATRegistrationLog."Entry No." := 0;                    VATRegistrationLog.Status := VATRegistrationLog.Status::Valid;                    VATRegistrationLog."Verified Date" := CurrentDateTime;                    VATRegistrationLog."User ID" := CopyStr(UserId(), 1, MaxStrLen(VATRegistrationLog."User ID"));                    VATRegistrationLog."Request Identifier" := CopyStr(ExtractValue(RequestIdPathTxt, XMLDoc, Namespace), 1,                        MaxStrLen(VATRegistrationLog."Request Identifier"));                    ResponsedName := ExtractValue(NamePathTxt, XMLDoc, Namespace);                    ResponsedAddress := ExtractValue(AddressPathTxt, XMLDoc, Namespace);                    ResponsedStreet := ExtractValue(StreetPathTxt, XMLDoc, Namespace);                    ResponsedPostCode := ExtractValue(PostcodePathTxt, XMLDoc, Namespace);                    ResponsedCity := ExtractValue(CityPathTxt, XMLDoc, Namespace);                    VATRegistrationLog.SetResponseDetails(                      ResponsedName, ResponsedAddress, ResponsedStreet, ResponsedCity, ResponsedPostCode);                    MatchName := ExtractValue(NameMatchPathTxt, XMLDoc, Namespace) = '1';                    MatchStreet := ExtractValue(StreetMatchPathTxt, XMLDoc, Namespace) = '1';                    MatchPostCode := ExtractValue(PostcodeMatchPathTxt, XMLDoc, Namespace) = '1';                    MatchCity := ExtractValue(CityMatchPathTxt, XMLDoc, Namespace) = '1';                    VATRegistrationLog.SetResponseMatchDetails(MatchName, MatchStreet, MatchCity, MatchPostCode);                    OnBeforeInsertValidLogVerification(VATRegistrationLog);                    VATRegistrationLog.Insert(true);                    if VATRegistrationLog.LogDetails() then                        VATRegistrationLog.Modify();                end;            'false':                begin                    VATRegistrationLog."Entry No." := 0;                    VATRegistrationLog."Verified Date" := CurrentDateTime;                    VATRegistrationLog.Status := VATRegistrationLog.Status::Invalid;                    VATRegistrationLog."User ID" := CopyStr(UserId(), 1, MaxStrLen(VATRegistrationLog."User ID"));                    VATRegistrationLog."Verified Name" := '';                    VATRegistrationLog."Verified Address" := '';                    VATRegistrationLog."Request Identifier" := '';                    VATRegistrationLog."Verified Postcode" := '';                    VATRegistrationLog."Verified Street" := '';                    VATRegistrationLog."Verified City" := '';                    OnBeforeInsertInvalidLogVerification(VATRegistrationLog);                    VATRegistrationLog.Insert(true);                end;        end;    end;    local procedure LogUnloggedVATRegistrationNumbers()    var        Customer: Record Customer;        Vendor: Record Vendor;        Contact: Record Contact;        VATRegistrationLog: Record "VAT Registration Log";    begin        Customer.SetFilter("VAT Registration No.", '<>%1', '');        if Customer.FindSet() then            repeat                VATRegistrationLog.SetRange("VAT Registration No.", Customer."VAT Registration No.");                if VATRegistrationLog.IsEmpty() then                    LogCustomer(Customer);            until Customer.Next() = 0;        Vendor.SetFilter("VAT Registration No.", '<>%1', '');        if Vendor.FindSet() then            repeat                VATRegistrationLog.SetRange("VAT Registration No.", Vendor."VAT Registration No.");                if VATRegistrationLog.IsEmpty() then                    LogVendor(Vendor);            until Vendor.Next() = 0;        Contact.SetFilter("VAT Registration No.", '<>%1', '');        if Contact.FindSet() then            repeat                VATRegistrationLog.SetRange("VAT Registration No.", Contact."VAT Registration No.");                if VATRegistrationLog.IsEmpty() then                    LogContact(Contact);            until Contact.Next() = 0;        Commit();    end;    local procedure InsertVATRegistrationLog(VATRegNo: Text[20]; CountryCode: Code[10]; AccountType: Enum "VAT Registration Log Account Type"; AccountNo: Code[20])    var        VATRegistrationLog: Record "VAT Registration Log";    begin        VATRegistrationLog.Init();        VATRegistrationLog."VAT Registration No." := VATRegNo;        VATRegistrationLog."Country/Region Code" := CountryCode;        VATRegistrationLog."Account Type" := AccountType;        VATRegistrationLog."Account No." := AccountNo;        VATRegistrationLog."User ID" := CopyStr(UserId(), 1, MaxStrLen(VATRegistrationLog."User ID"));        VATRegistrationLog.Insert(true);        OnAfterInsertVATRegistrationLog(VATRegistrationLog);    end;    /// <summary>    /// Deletes all VAT registration log entries associated with the specified customer.    /// </summary>    /// <param name="Customer">Customer record for which to delete VAT registration logs</param>    procedure DeleteCustomerLog(Customer: Record Customer)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        VATRegistrationLog.SetRange("Account Type", VATRegistrationLog."Account Type"::Customer);        VATRegistrationLog.SetRange("Account No.", Customer."No.");        if not VATRegistrationLog.IsEmpty() then            VATRegistrationLog.DeleteAll();    end;    /// <summary>    /// Deletes all VAT registration log entries associated with the specified vendor.    /// </summary>    /// <param name="Vendor">Vendor record for which to delete VAT registration logs</param>    procedure DeleteVendorLog(Vendor: Record Vendor)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        VATRegistrationLog.SetRange("Account Type", VATRegistrationLog."Account Type"::Vendor);        VATRegistrationLog.SetRange("Account No.", Vendor."No.");        if not VATRegistrationLog.IsEmpty() then            VATRegistrationLog.DeleteAll();    end;    /// <summary>    /// Deletes all VAT registration log entries associated with the specified contact.    /// </summary>    /// <param name="Contact">Contact record for which to delete VAT registration logs</param>    procedure DeleteContactLog(Contact: Record Contact)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        VATRegistrationLog.SetRange("Account Type", VATRegistrationLog."Account Type"::Contact);        VATRegistrationLog.SetRange("Account No.", Contact."No.");        if not VATRegistrationLog.IsEmpty() then            VATRegistrationLog.DeleteAll();    end;    /// <summary>    /// Opens VAT registration log page for customer with validation and logging capabilities.    /// </summary>    /// <param name="Customer">Customer record for VAT registration management</param>    procedure AssistEditCustomerVATReg(Customer: Record Customer)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        CheckAndLogUnloggedVATRegistrationNumbers(VATRegistrationLog, VATRegistrationLog."Account Type"::Customer, Customer."No.");        CheckIfCountryCodeIsSet(Customer);        OnAssistEditCustomerVATRegOnBeforeRunPageVATRegistrationLog(VATRegistrationLog, Customer);        Page.RunModal(Page::"VAT Registration Log", VATRegistrationLog);    end;    /// <summary>    /// Validates that customer has country/region code set when VAT registration service is enabled.    /// </summary>    /// <param name="Customer">Customer record to validate for country/region code requirement</param>    procedure CheckIfCountryCodeIsSet(Customer: Record Customer)    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";        CountryRegion: Record "Country/Region";        EmptyCountryCodeErr: Label 'You must specify the country that issued the VAT registration number. Choose the country in the Country/Region Code field.';        EmptyEUCountryCodeErr: Label 'You must specify the EU Country/Region Code for the country that issued the VAT registration number. You can specify that on the Country/Regions page.';    begin        if VATRegNoSrvConfig.VATRegNoSrvIsEnabled() then begin            if Customer."Country/Region Code" = '' then                Error(EmptyCountryCodeErr);            if not CountryRegion.IsEUCountry(Customer."Country/Region Code") then                Error(EmptyEUCountryCodeErr);        end;    end;    /// <summary>    /// Opens VAT registration log page for vendor with validation and logging capabilities.    /// </summary>    /// <param name="Vendor">Vendor record for VAT registration management</param>    procedure AssistEditVendorVATReg(Vendor: Record Vendor)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        CheckAndLogUnloggedVATRegistrationNumbers(VATRegistrationLog, VATRegistrationLog."Account Type"::Vendor, Vendor."No.");        OnAssistEditVendorVATRegOnBeforeRunPageVATRegistrationLog(VATRegistrationLog, Vendor);        Page.RunModal(Page::"VAT Registration Log", VATRegistrationLog);    end;    /// <summary>    /// Opens VAT registration log page for contact with validation and logging capabilities.    /// </summary>    /// <param name="Contact">Contact record for VAT registration management</param>    procedure AssistEditContactVATReg(Contact: Record Contact)    var        VATRegistrationLog: Record "VAT Registration Log";    begin        CheckAndLogUnloggedVATRegistrationNumbers(VATRegistrationLog, VATRegistrationLog."Account Type"::Contact, Contact."No.");        OnAssistEditContactVATRegOnBeforeRunPageVATRegistrationLog(VATRegistrationLog, Contact);        Page.RunModal(Page::"VAT Registration Log", VATRegistrationLog);    end;    /// <summary>    /// Opens VAT registration log page for company information with validation and logging capabilities.    /// </summary>    procedure AssistEditCompanyInfoVATReg()    var        VATRegistrationLog: Record "VAT Registration Log";    begin        CheckAndLogUnloggedVATRegistrationNumbers(VATRegistrationLog, VATRegistrationLog."Account Type"::"Company Information", '');        Page.RunModal(Page::"VAT Registration Log", VATRegistrationLog);    end;    local procedure CheckAndLogUnloggedVATRegistrationNumbers(var VATRegistrationLog: Record "VAT Registration Log"; AccountType: Enum "VAT Registration Log Account Type"; AccountNo: Code[20])    begin        VATRegistrationLog.SetRange("Account Type", AccountType);        VATRegistrationLog.SetRange("Account No.", AccountNo);        if VATRegistrationLog.IsEmpty() then            LogUnloggedVATRegistrationNumbers();    end;    local procedure IsEUCountry(CountryCode: Code[10]): Boolean    var        CountryRegion: Record "Country/Region";        CompanyInformation: Record "Company Information";    begin        if (CountryCode = '') and CompanyInformation.Get() then            CountryCode := CompanyInformation."Country/Region Code";        if CountryCode <> '' then            if CountryRegion.Get(CountryCode) then                exit(CountryRegion."EU Country/Region Code" <> '');        exit(false);    end;    local procedure GetCountryCode(CountryCode: Code[10]): Code[10]    var        CompanyInformation: Record "Company Information";    begin        if CountryCode <> '' then            exit(CountryCode);        CompanyInformation.Get();        exit(CompanyInformation."Country/Region Code");    end;    local procedure ExtractValue(Xpath: Text; XMLDoc: DotNet XmlDocument; Namespace: Text): Text    var        XMLDOMMgt: Codeunit "XML DOM Management";        FoundXmlNode: DotNet XmlNode;    begin        if not XMLDOMMgt.FindNodeWithNamespace(XMLDoc.DocumentElement, Xpath, 'vat', Namespace, FoundXmlNode) then            exit('');        exit(FoundXmlNode.InnerText);    end;    /// <summary>    /// Validates VAT registration number against VIES service for EU countries.    /// </summary>    /// <param name="RecordRef">Record reference containing VAT registration number</param>    /// <param name="VATRegistrationLog">VAT registration log entry for validation results</param>    /// <param name="RecordVariant">Record variant for validation</param>    /// <param name="EntryNo">Entry number identifier</param>    /// <param name="CountryCode">Country/region code for validation</param>    /// <param name="AccountType">Account type for validation logging</param>    procedure CheckVIESForVATNo(var RecordRef: RecordRef; var VATRegistrationLog: Record "VAT Registration Log"; RecordVariant: Variant; EntryNo: Code[20]; CountryCode: Code[10]; AccountType: Option)    var        DummyCustomer: Record Customer;    begin        CheckVIESForVATNoField(            RecordRef, VATRegistrationLog, RecordVariant, EntryNo, CountryCode, AccountType, DummyCustomer.FieldName("VAT Registration No."));    end;    /// <summary>    /// Validates VAT registration number against VIES service for EU countries with custom field name.    /// </summary>    /// <param name="RecordRef">Record reference containing VAT registration number</param>    /// <param name="VATRegistrationLog">VAT registration log entry for validation results</param>    /// <param name="RecordVariant">Record variant for validation</param>    /// <param name="EntryNo">Entry number identifier</param>    /// <param name="CountryCode">Country/region code for validation</param>    /// <param name="AccountType">Account type for validation logging</param>    /// <param name="VATNoFieldName">Name of VAT registration number field to validate</param>    procedure CheckVIESForVATNoField(var RecordRef: RecordRef; var VATRegistrationLog: Record "VAT Registration Log"; RecordVariant: Variant; EntryNo: Code[20]; CountryCode: Code[10]; AccountType: Option; VATNoFieldName: Text)    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";        CountryRegion: Record "Country/Region";        VatRegNoFieldRef: FieldRef;        VATRegNo: Text[20];        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeCheckVIESForVATNoField(RecordRef, VATRegistrationLog, RecordVariant, EntryNo, CountryCode, AccountType, VATNoFieldName, IsHandled);        if IsHandled then            exit;        RecordRef.GetTable(RecordVariant);        if IsAPIClientType() then            exit;        if not GuiAllowed() then            exit;        if not CountryRegion.IsEUCountry(CountryCode) then            exit; // VAT Reg. check Srv. is only available for EU countries.        if VATRegNoSrvConfig.VATRegNoSrvIsEnabled() then begin            DataTypeManagement.GetRecordRef(RecordVariant, RecordRef);            if not DataTypeManagement.FindFieldByName(RecordRef, VatRegNoFieldRef, VATNoFieldName) then                exit;            VATRegNo := VatRegNoFieldRef.Value();            VATRegistrationLog.InitVATRegLog(VATRegistrationLog, CountryCode, AccountType, EntryNo, VATRegNo);            CODEUNIT.Run(CODEUNIT::"VAT Lookup Ext. Data Hndl", VATRegistrationLog);        end;    end;    /// <summary>    /// Updates business entity record with validated VAT registration information from VIES response.    /// </summary>    /// <param name="RecordRef">Record reference to update with validated data</param>    /// <param name="RecordVariant">Record variant for validation</param>    /// <param name="VATRegistrationLog">VAT registration log containing validation results</param>    procedure UpdateRecordFromVATRegLog(var RecordRef: RecordRef; RecordVariant: Variant; VATRegistrationLog: Record "VAT Registration Log")    var        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeUpdateRecordFromVATRegLog(RecordRef, RecordVariant, VATRegistrationLog, IsHandled);        if IsHandled then            exit;        if GuiAllowed() then begin            RecordRef.GetTable(RecordVariant);            case VATRegistrationLog.Status of                VATRegistrationLog.Status::Valid:                    case VATRegistrationLog."Details Status" of                        VATRegistrationLog."Details Status"::"Not Verified":                            Message(DetailsNotVerifiedMsg);                        VATRegistrationLog."Details Status"::Valid:                            Message(ValidVATNoMsg);                        VATRegistrationLog."Details Status"::"Partially Valid",                        VATRegistrationLog."Details Status"::"Not Valid":                            begin                                DataTypeManagement.GetRecordRef(RecordVariant, RecordRef);                                VATRegistrationLog.OpenDetailsForRecRef(RecordRef);                            end;                        VATRegistrationLog."Details Status"::Ignored:                            Message(DetailsIgnoredMsg);                    end;                VATRegistrationLog.Status::Invalid:                    Message(InvalidVatRegNoMsg);                else                    Message(NotVerifiedVATRegMsg);            end;        end;    end;    /// <summary>    /// Initializes VAT registration number service configuration with default settings.    /// </summary>    procedure InitServiceSetup()    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";        VATLookupExtDataHndl: Codeunit "VAT Lookup Ext. Data Hndl";    begin        if not VATRegNoSrvConfig.FindFirst() then begin            VATRegNoSrvConfig.Init();            VATRegNoSrvConfig."Service Endpoint" := VATLookupExtDataHndl.GetVATRegNrValidationWebServiceURL();            VATRegNoSrvConfig.Enabled := false;            VATRegNoSrvConfig.Insert();        end;    end;    /// <summary>    /// Opens configuration page for VAT registration number service setup.    /// </summary>    procedure SetupService()    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";    begin        if VATRegNoSrvConfig.FindFirst() then            exit;        InitServiceSetup();    end;    /// <summary>    /// Enables VAT registration number validation service if not already configured.    /// </summary>    procedure EnableService()    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";    begin        if not VATRegNoSrvConfig.FindFirst() then begin            InitServiceSetup();            VATRegNoSrvConfig.FindFirst();        end;        VATRegNoSrvConfig.Enabled := true;        VATRegNoSrvConfig.Modify();    end;    /// <summary>    /// Validates VAT registration number with VIES service and displays validation results.    /// </summary>    /// <param name="RecordRef">Record reference containing VAT registration number</param>    /// <param name="RecordVariant">Record variant for validation</param>    /// <param name="EntryNo">Entry number identifier</param>    /// <param name="AccountType">Account type for validation logging</param>    /// <param name="CountryCode">Country/region code for validation</param>    procedure ValidateVATRegNoWithVIES(var RecordRef: RecordRef; RecordVariant: Variant; EntryNo: Code[20]; AccountType: Option; CountryCode: Code[10])    var        VATRegistrationLog: Record "VAT Registration Log";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeValidateVATRegNoWithVIES(RecordRef, RecordVariant, EntryNo, CountryCode, AccountType, IsHandled);        if IsHandled then            exit;        CheckVIESForVATNo(RecordRef, VATRegistrationLog, RecordVariant, EntryNo, CountryCode, AccountType);        if VATRegistrationLog.Find() then // Only update if the log was created            UpdateRecordFromVATRegLog(RecordRef, RecordVariant, VATRegistrationLog);    end;    /// <summary>    /// Returns URL for VAT registration service disclaimer information.    /// </summary>    /// <returns>Disclaimer URL for VIES service terms and conditions</returns>    procedure GetServiceDisclaimerUR(): Text    begin        exit(VATSrvDisclaimerUrlTok);    end;    /// <summary>    /// Registers VIES VAT registration service connection for service management.    /// </summary>    /// <param name="ServiceConnection">Service connection record for registration</param>    [EventSubscriber(ObjectType::Table, Database::"Service Connection", 'OnRegisterServiceConnection', '', false, false)]    procedure HandleViesRegisterServiceConnection(var ServiceConnection: Record "Service Connection")    var        VATRegNoSrvConfig: Record "VAT Reg. No. Srv Config";        RecRef: RecordRef;    begin        SetupService();        VATRegNoSrvConfig.FindFirst();        RecRef.GetTable(VATRegNoSrvConfig);        if VATRegNoSrvConfig.Enabled then            ServiceConnection.Status := ServiceConnection.Status::Enabled        else            ServiceConnection.Status := ServiceConnection.Status::Disabled;        ServiceConnection.InsertServiceConnection(              ServiceConnection, RecRef.RecordId, DescriptionLbl, VATRegNoSrvConfig."Service Endpoint", PAGE::"VAT Registration Config");    end;    local procedure IsAPIClientType(): Boolean    begin        exit(ClientTypeManagement.GetCurrentClientType() in [ClientType::Api, ClientType::SOAP, ClientType::OData, ClientType::ODataV4])    end;    /// <summary>    /// Integration event raised after creating VAT registration log entry.    /// </summary>    /// <param name="VATRegistrationLog">VAT registration log entry that was created</param>    [IntegrationEvent(false, false)]    local procedure OnAfterInsertVATRegistrationLog(var VATRegistrationLog: Record "VAT Registration Log")    begin    end;    /// <summary>    /// Integration event raised before opening VAT registration log page for contact.    /// </summary>    /// <param name="VATRegistrationLog">VAT registration log entry for display</param>    /// <param name="Contact">Contact record being processed</param>    [IntegrationEvent(false, false)]    local procedure OnAssistEditContactVATRegOnBeforeRunPageVATRegistrationLog(var VATRegistrationLog: Record "VAT Registration Log"; Contact: Record Contact)    begin    end;    /// <summary>    /// Integration event raised before opening VAT registration log page for customer.    /// </summary>    /// <param name="VATRegistrationLog">VAT registration log entry for display</param>    /// <param name="Customer">Customer record being processed</param>    [IntegrationEvent(false, false)]    local procedure OnAssistEditCustomerVATRegOnBeforeRunPageVATRegistrationLog(var VATRegistrationLog: Record "VAT Registration Log"; Customer: Record Customer)    begin    end;    /// <summary>    /// Integration event raised before displaying VAT registration log page for vendor VAT assist edit operations.    /// </summary>    /// <param name="VATRegistrationLog">VAT registration log record being processed</param>    /// <param name="Vendor">Vendor record being processed</param>    [IntegrationEvent(false, false)]    local procedure OnAssistEditVendorVATRegOnBeforeRunPageVATRegistrationLog(var VATRegistrationLog: Record "VAT Registration Log"; Vendor: Record Vendor)    begin    end;    /// <summary>    /// Integration event raised before updating a record with validated data from VAT registration log.    /// </summary>    /// <param name="RecordRef">Record reference being updated</param>    /// <param name="RecordVariant">Record variant containing the source data</param>    /// <param name="VATRegistrationLog">VAT registration log with validation results</param>    /// <param name="IsHandled">Set to true to skip standard record update processing</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeUpdateRecordFromVATRegLog(var RecordRef: RecordRef; RecordVariant: Variant; VATRegistrationLog: Record "VAT Registration Log"; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Integration event raised before checking VIES validation for a VAT number field to allow custom field identification.    /// </summary>    /// <param name="RecordRef">Record reference containing the VAT number field</param>    /// <param name="VATRegistrationLog">VAT registration log for the validation</param>    /// <param name="RecordVariant">Record variant containing the source data</param>    /// <param name="EntryNo">Entry number for the validation</param>    /// <param name="CountryCode">Country code for the validation</param>    /// <param name="AccountType">Account type being validated</param>    /// <param name="VATNoFieldName">Name of the VAT number field to validate</param>    /// <param name="IsHandled">Set to true to skip standard field checking</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeCheckVIESForVATNoField(var RecordRef: RecordRef; var VATRegistrationLog: Record "VAT Registration Log"; RecordVariant: Variant; EntryNo: Code[20]; CountryCode: Code[10]; AccountType: Option; var VATNoFieldName: Text; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Integration event raised before inserting a valid VAT registration log verification entry.    /// </summary>    /// <param name="VatRegistrationLog">VAT registration log entry being processed</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeInsertValidLogVerification(var VatRegistrationLog: Record "VAT Registration Log")    begin    end;    /// <summary>    /// Integration event raised before inserting an invalid VAT registration log verification entry.    /// </summary>    /// <param name="VatRegistrationLog">VAT registration log entry being processed</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeInsertInvalidLogVerification(var VatRegistrationLog: Record "VAT Registration Log")    begin    end;    /// <summary>    /// Integration event raised before validating VAT registration number with VIES service to allow custom validation logic.    /// </summary>    /// <param name="RecordRef">Record reference containing the VAT number to validate</param>    /// <param name="RecordVariant">Record variant containing the source data</param>    /// <param name="EntryNo">Entry number for the validation</param>    /// <param name="CountryCode">Country code for the validation</param>    /// <param name="AccountType">Account type being validated</param>    /// <param name="IsHandled">Set to true to skip standard VIES validation</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeValidateVATRegNoWithVIES(var RecordRef: RecordRef; RecordVariant: Variant; EntryNo: Code[20]; CountryCode: Code[10]; AccountType: Option; var IsHandled: Boolean)    begin    end;}