Codeunit 404 IC Feedback
src/Layers/W1/BaseApp/Finance/Intercompany/Outbox/ICFeedback.Codeunit.al165 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.Intercompany.Outbox;using Microsoft.Finance.GeneralLedger.Journal;using Microsoft.Intercompany;using Microsoft.Intercompany.Journal;using Microsoft.Intercompany.Setup;using Microsoft.Purchases.Document;using Microsoft.Sales.Document;/// <summary>/// Manages user feedback and messaging for intercompany transaction processing./// Provides standardized notifications about transaction creation, outbox placement, and automatic sending status./// </summary>/// <remarks>/// Handles user communication for both manual and automatic intercompany transaction workflows./// Supports purchase and sales document feedback with partner-specific messaging./// Integrates with IC Setup for auto-send configuration and outbox transaction management./// </remarks>codeunit 404 "IC Feedback"{ var CreatedTransactionWaitingInOutboxMsg: Label 'An entry for document %1 has been created as an intercompany transaction. The entry awaits a manual check in the Intercompany Outbox before being sent.', Comment = '%1 = Document No.'; CreatedMultipleTransactionsWaitingInOutboxMsg: Label 'Multiple entries have been created as intercompany transactions. Multiple entries have been created as intercompany transactions. The entries await a manual check in the Intercompany Outbox before being sent.'; CreatedAndSentTransactionMsg: Label 'An entry for document %1 has been created as an intercompany transaction. The entry was automatically sent to IC partner %2.', Comment = '%1 = Document No., %2 = IC Partner No.'; CreatedAndSentMultipleTransactionsMsg: Label 'Multiple entries have been created as intercompany transactions. The entries were automatically sent to their corresponding IC partners.'; /// <summary> /// Shows intercompany transaction feedback message for purchase documents using the document number. /// </summary> /// <param name="PurchaseHeader">Purchase document header for transaction feedback</param> /// <param name="ICTransactionDocumentType">Type of IC transaction document created</param> procedure ShowIntercompanyMessage(PurchaseHeader: Record "Purchase Header"; ICTransactionDocumentType: Enum "IC Transaction Document Type") begin ShowIntercompanyMessage(PurchaseHeader, ICTransactionDocumentType, PurchaseHeader."No."); end; /// <summary> /// Shows intercompany transaction feedback message for purchase documents with custom document number. /// </summary> /// <param name="PurchaseHeader">Purchase document header for transaction feedback</param> /// <param name="ICTransactionDocumentType">Type of IC transaction document created</param> /// <param name="DocumentNo">Custom document number for the feedback message</param> procedure ShowIntercompanyMessage(PurchaseHeader: Record "Purchase Header"; ICTransactionDocumentType: Enum "IC Transaction Document Type"; DocumentNo: Code[20]) var ICSetup: Record "IC Setup"; ICOutboxTransaction: Record "IC Outbox Transaction"; ICPartnerCode: Code[20]; begin if GuiAllowed() then begin if PurchaseHeader."Pay-to IC Partner Code" <> '' then ICPartnerCode := PurchaseHeader."Pay-to IC Partner Code" else ICPartnerCode := PurchaseHeader."Buy-from IC Partner Code"; if ICPartnerCode = '' then exit; if (not ICSetup.FindFirst()) or (not ICSetup."Transaction Notifications") then exit; if ICSetup."Auto. Send Transactions" then begin if ExistsInICHandledOutbox(ICPartnerCode, ICOutboxTransaction."IC Source Type"::"Purchase Document", ICTransactionDocumentType, DocumentNo, PurchaseHeader."Posting Date", PurchaseHeader."Document Date") then Message(CreatedAndSentTransactionMsg, DocumentNo, ICPartnerCode); end else if ExistsInICOutbox(ICPartnerCode, ICOutboxTransaction."IC Source Type"::"Purchase Document", ICTransactionDocumentType, DocumentNo, PurchaseHeader."Posting Date", PurchaseHeader."Document Date") then Message(CreatedTransactionWaitingInOutboxMsg, DocumentNo); end; end; /// <summary> /// Shows intercompany transaction feedback message for sales documents using the document number. /// </summary> /// <param name="SalesHeader">Sales document header for transaction feedback</param> /// <param name="ICTransactionDocumentType">Type of IC transaction document created</param> procedure ShowIntercompanyMessage(SalesHeader: Record "Sales Header"; ICTransactionDocumentType: Enum "IC Transaction Document Type") begin ShowIntercompanyMessage(SalesHeader, ICTransactionDocumentType, SalesHeader."No."); end; /// <summary> /// Shows intercompany transaction feedback message for sales documents with custom document number. /// </summary> /// <param name="SalesHeader">Sales document header for transaction feedback</param> /// <param name="ICTransactionDocumentType">Type of IC transaction document created</param> /// <param name="DocumentNo">Custom document number for the feedback message</param> procedure ShowIntercompanyMessage(SalesHeader: Record "Sales Header"; ICTransactionDocumentType: Enum "IC Transaction Document Type"; DocumentNo: Code[20]) var ICSetup: Record "IC Setup"; ICOutboxTransaction: Record "IC Outbox Transaction"; ICPartnerCode: Code[20]; begin if GuiAllowed() then begin if SalesHeader."Sell-to IC Partner Code" <> '' then ICPartnerCode := SalesHeader."Sell-to IC Partner Code" else ICPartnerCode := SalesHeader."Bill-to IC Partner Code"; if ICPartnerCode = '' then exit; if (not ICSetup.FindFirst()) or (not ICSetup."Transaction Notifications") then exit; if ICSetup."Auto. Send Transactions" then begin if ExistsInICHandledOutbox(ICPartnerCode, ICOutboxTransaction."IC Source Type"::"Sales Document", ICTransactionDocumentType, DocumentNo, SalesHeader."Posting Date", SalesHeader."Document Date") then Message(CreatedAndSentTransactionMsg, DocumentNo, ICPartnerCode); end else if ExistsInICOutbox(ICPartnerCode, ICOutboxTransaction."IC Source Type"::"Sales Document", ICTransactionDocumentType, DocumentNo, SalesHeader."Posting Date", SalesHeader."Document Date") then Message(CreatedTransactionWaitingInOutboxMsg, DocumentNo); end; end; internal procedure ShowIntercompanyMessage(GenJournalLine: Record "Gen. Journal Line"; DocumentNo: Code[20]; ICProccessedLines: Integer) var ICSetup: Record "IC Setup"; ICOutboxTransaction: Record "IC Outbox Transaction"; begin if (not ICSetup.FindFirst()) or (not ICSetup."Transaction Notifications") then exit; if ICSetup."Auto. Send Transactions" then begin if ExistsInICHandledOutbox(GenJournalLine."IC Partner Code", ICOutboxTransaction."IC Source Type"::Journal, "IC Transaction Document Type"::" ", GenJournalLine."Document No.", GenJournalLine."Posting Date", GenJournalLine."Document Date") then if ICProccessedLines = 1 then Message(CreatedAndSentTransactionMsg, DocumentNo, GenJournalLine."IC Partner Code") else Message(CreatedAndSentMultipleTransactionsMsg); end else if ExistsInICOutbox(GenJournalLine."IC Partner Code", ICOutboxTransaction."IC Source Type"::Journal, "IC Transaction Document Type"::" ", GenJournalLine."Document No.", GenJournalLine."Posting Date", GenJournalLine."Document Date") then if ICProccessedLines = 1 then Message(CreatedTransactionWaitingInOutboxMsg, DocumentNo) else Message(CreatedMultipleTransactionsWaitingInOutboxMsg); end; local procedure ExistsInICOutbox(ICPartnerCode: Code[20]; SourceType: Enum "IC Transaction Source Type"; ICTransactionDocumentType: Enum "IC Transaction Document Type"; DocumentNo: Code[20]; PostingDate: Date; DocumentDate: Date): Boolean var ICOutboxTransaction: Record "IC Outbox Transaction"; begin ICOutboxTransaction.SetRange("IC Partner Code", ICPartnerCode); ICOutboxTransaction.SetRange("IC Source Type", SourceType); ICOutboxTransaction.SetRange("Document Type", ICTransactionDocumentType); ICOutboxTransaction.SetRange("Document No.", DocumentNo); ICOutboxTransaction.SetRange("Posting Date", PostingDate); ICOutboxTransaction.SetRange("Document Date", DocumentDate); exit(not ICOutboxTransaction.IsEmpty()); end; local procedure ExistsInICHandledOutbox(ICPartnerCode: Code[20]; SourceType: Enum "IC Transaction Source Type"; ICTransactionDocumentType: Enum "IC Transaction Document Type"; DocumentNo: Code[20]; PostingDate: Date; DocumentDate: Date): Boolean var HandledICOutboxTransaction: Record "Handled IC Outbox Trans."; begin HandledICOutboxTransaction.SetRange("IC Partner Code", ICPartnerCode); HandledICOutboxTransaction.SetRange("IC Source Type", SourceType); HandledICOutboxTransaction.SetRange("Document Type", ICTransactionDocumentType); HandledICOutboxTransaction.SetRange("Document No.", DocumentNo); HandledICOutboxTransaction.SetRange("Posting Date", PostingDate); HandledICOutboxTransaction.SetRange("Document Date", DocumentDate); exit(not HandledICOutboxTransaction.IsEmpty()); end;}