Codeunit 249 VAT Registration Log Mgt.
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;}