---
title: "Codeunit 4591 SOA Item Search, extension points 29"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/points/
object: https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/
app: "Sales Order Agent"
major: 29
source: https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/
checked: 2026-11-20
changed: 2026-10-05
subject: "Microsoft Dynamics 365 Business Central"
license: "Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/"
---

# Codeunit 4591 SOA Item Search, extension points 29

JOP-AL, https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/points/

14 procedures and triggers with a step in src/Apps/W1/SalesOrderAgent/app/src/ItemSearch/SOAItemSearch.Codeunit.al, in source order, read from the text, not from a run.

## GetItemFilters

[Line 49](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L49), local.

- [78](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L78) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `CheckIsItemSearchReady`
- [79](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L79) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `InitializeSearchOptionsObject`
- [80](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L80) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `AddSearchFilter`
- [81](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L81) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `AddSearchFilter`
- [82](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L82) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `AddSearchRankingContext`
- [83](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L83) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `SetupSOACapabilityInformation`
- [84](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L84) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `SetupSearchQuery`
- [87](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L87) calls [Codeunit 4395 Global Item Search](https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/) `SearchAndReturnResultsWithColumnValues`
- [88](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L88) calls [Codeunit 4596 SOA Broader Item Search](https://jonas-paprotka.de/ref/codeunit/4596-soa-broader-item-search/) `BuildResultFilterFromCandidates`

## FindRecordItemFromList

[Line 96](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L96), local.

- [100](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L100) calls `FindRecordItem`

## FindRecordItemFromLookup

[Line 104](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L104), local.

- [108](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L108) calls `FindRecordItem`

## FindRecordItemFromMultiItemsAvailability

[Line 112](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L112), local.

- [116](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L116) calls `FindRecordItem`
- [117](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L117) calls `LogTelemetryForFindItems`

## LogInventoryInquiryReplied

[Line 121](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L121), local.

- [125](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L125) calls [Codeunit 4590 SOA Billing](https://jonas-paprotka.de/ref/codeunit/4590-soa-billing/) `LogInventoryInquiryReplied`

## OnAfterCheckItemAvailable

[Line 136](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L136), local.

- [150](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L150) calls [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) `GetForCurrentAgentSession`
- [159](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L159) calls `IsRequiredQuantityAvailable`
- [165](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L165) calls [Codeunit 4413 SOA Shipment Date Mgt.](https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/) `OrderPromisingSetupConfigured`
- [166](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L166) calls [Codeunit 4413 SOA Shipment Date Mgt.](https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/) `SetParamenters`
- [167](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L167) runs [Codeunit 4413 SOA Shipment Date Mgt.](https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/)
- [168](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L168) calls [Codeunit 4413 SOA Shipment Date Mgt.](https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/) `GetEarliestShipmentDate`
- [170](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L170) calls [Codeunit 4413 SOA Shipment Date Mgt.](https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/) `GetEarliestShipmentDate`
- [173](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L173) calls [Codeunit 1511 Notification Lifecycle Mgt.](https://jonas-paprotka.de/ref/codeunit/1511-notification-lifecycle-mgt/) `RecallNotificationsForRecordWithAdditionalContext`
- [173](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L173) calls `GetQuoteItemAvailabilityNotificationId`
- [177](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L177) calls [Codeunit 1511 Notification Lifecycle Mgt.](https://jonas-paprotka.de/ref/codeunit/1511-notification-lifecycle-mgt/) `SendNotificationWithAdditionalContext`
- [177](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L177) calls `GetQuoteItemAvailabilityNotificationId`

## FindRecordItem

[Line 192](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L192), local.

- [234](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L234) calls `ExtractSearchKeyWords`
- [238](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L238) calls `GetItemFilters`
- [242](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L242) calls [Codeunit 4596 SOA Broader Item Search](https://jonas-paprotka.de/ref/codeunit/4596-soa-broader-item-search/) `BroaderItemSearch`
- [249](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L249) calls `BuildCandidateArrayFromItemFilter`
- [251](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L251) calls `AddVariantsToCandidateArray`
- [253](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L253) calls [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) `GetForCurrentAgentSession`
- [259](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L259) calls `ShouldUseItemSelector`
- [260](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L260) calls `BuildSearchQueryText`
- [261](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L261) calls `SelectBestItem`
- [261](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L261) calls `GetTaskMessageContent`
- [267](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L267) calls `CountFilterItems`
- [268](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L268) calls `CountFilterItems`
- [269](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L269) calls `CountFilterItems`
- [269](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L269) calls `CountFilterItems`
- [289](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L289) calls `BuildFilteredItemFilter`
- [291](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L291) calls `BuildFilteredItemFilter`
- [292](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L292) calls `StoreResolvedItemVariants`
- [295](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L295) calls `StoreResolvedItemVariants`
- [301](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L301) calls `BuildFilteredItemFilter`
- [302](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L302) calls `StoreResolvedItemVariants`
- [307](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L307) calls `BuildFilteredItemFilter`
- [334](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L334) raises `OnAfterFindRecordItem`

## GetTaskMessageContent

[Line 354](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L354), local.

- [357](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L357) calls [Codeunit 4420 SOA Task Message Reader](https://jonas-paprotka.de/ref/codeunit/4420-soa-task-message-reader/) `GetLastIncomingMessageContent`

## SelectBestItem

[Line 364](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L364), local.

- [384](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L384) calls [Codeunit 4417 SOA Item Selector](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/) `SelectBestMatchingItems`
- [399](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L399) calls `RemoveVariantlessMatchesWithConcreteAlternatives`
- [401](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L401) calls `AddSelectedItem`
- [403](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L403) calls `PreferConcreteVariantAlternatives`
- [405](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L405) calls `AddSelectedItem`

## BuildCandidateArrayFromItemFilter

[Line 458](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L458), local.

- [486](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L486) writes [Table 27 Item](https://jonas-paprotka.de/ref/table/27-item/) Insert

## BuildFilteredItemFilter

[Line 661](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L661), local.

- [678](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L678) calls `FindFirstAvailableVariant`
- [680](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L680) calls `AddAvailableItemVariant`
- [686](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L686) calls `AddAvailableItemVariant`
- [686](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L686) calls `GetFirstVariantCode`

## FindFirstAvailableVariant

[Line 697](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L697), local.

- [708](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L708) calls `IsRequiredQuantityAvailable`
- [713](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L713) calls `IsRequiredQuantityAvailable`

## IsRequiredQuantityAvailable

[Line 794](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L794), local.

- [805](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L805) calls [Codeunit 353 Item Availability Forms Mgt](https://jonas-paprotka.de/ref/codeunit/353-item-availability-forms-mgt/) `CalcAvailQuantities`
- [814](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L814) calls `CalcProjAvailableBalanceInUOM`

## LogTelemetryForFindItems

[Line 838](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L838), local.

- [853](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L853) calls [Table 4325 SOA Setup](https://jonas-paprotka.de/ref/table/4325-soa-setup/) `GetForCurrentAgentSession`
- [859](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L859) calls [Codeunit 8703 Feature Telemetry](https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/) `LogUsage`
- [859](https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/#L859) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `GetFeatureName`

## Source

AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
