{"title":"Codeunit 5720 Item Reference Management, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/5720-item-reference-management/points/","author":"JOP-AL","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/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":5720,"name":"Item Reference Management","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/5720-item-reference-management/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/5720-item-reference-management/source/","path":"src/Layers/W1/BaseApp/Inventory/Item/Catalog/ItemReferenceManagement.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"table:37":{"name":"Sales Line","url":"https://jonas-paprotka.de/ref/table/37-sales-line/"},"table:39":{"name":"Purchase Line","url":"https://jonas-paprotka.de/ref/table/39-purchase-line/"},"table:5777":{"name":"Item Reference","url":"https://jonas-paprotka.de/ref/table/5777-item-reference/"},"page:5735":{"name":"Item Reference List","url":"https://jonas-paprotka.de/ref/page/5735-item-reference-list/"},"page:607":{"name":"IC G/L Account List","url":"https://jonas-paprotka.de/ref/page/607-ic-g-l-account-list/"},"table:5876":{"name":"Phys. Invt. Order Line","url":"https://jonas-paprotka.de/ref/table/5876-phys-invt-order-line/"},"table:5878":{"name":"Phys. Invt. Record Line","url":"https://jonas-paprotka.de/ref/table/5878-phys-invt-record-line/"},"table:83":{"name":"Item Journal Line","url":"https://jonas-paprotka.de/ref/table/83-item-journal-line/"},"table:5851":{"name":"Invt. Document Line","url":"https://jonas-paprotka.de/ref/table/5851-invt-document-line/"}},"procs":[{"name":"EnterSalesItemReference","line":34,"kind":"procedure","params":1,"steps":[[40,"event","OnBeforeEnterSalesItemReference",1],[45,"call","FindItemReferenceForSalesLine",1],[56,"call","FillSalesDescription",1],[57,"ext","table",37,"GetItemTranslation",0],[61,"event","OnAfterSalesItemReferenceFound",0],[70,"event","OnEnterSalesItemReferenceOnAfterFillDescriptionFromItemVariant",0],[75,"event","OnEnterSalesItemReferenceOnAfterFillDescriptionFromItem",0],[77,"ext","table",37,"GetItemTranslation",0],[78,"event","OnAfterSalesItemItemRefNotFound",0]]},{"name":"FindItemReferenceForSalesLine","line":83,"kind":"procedure","access":"local","params":1,"steps":[[89,"event","OnBeforeFindItemReferenceForSalesLine",1],[97,"ext","table",37,"GetDateForCalculations",0],[105,"event","OnFindItemReferenceForSalesLineOnBeforeFindFirst",0],[113,"event","OnAfterFindItemReferenceForSalesLine",0]]},{"name":"ReferenceLookupSalesItem","line":116,"kind":"procedure","params":3,"steps":[[121,"event","OnBeforeReferenceLookupSalesItem",1],[127,"call","FindOrSelectFromItemReferenceList",7],[129,"ext","table",37,"GetDateForCalculations",0]]},{"name":"EnterPurchaseItemReference","line":132,"kind":"procedure","params":1,"steps":[[138,"event","OnBeforeEnterPurchaseItemReference",1],[143,"call","FindItemReferenceForPurchaseLine",1],[151,"event","OnEnterPurchaseItemReferenceOnAfterCalcShouldAssignDescription",0],[156,"call","FillDescription",1],[157,"ext","table",39,"GetItemTranslation",0],[160,"event","OnAfterPurchItemReferenceFound",0],[165,"call","FillDescription",1],[166,"ext","table",39,"GetItemTranslation",0],[167,"event","OnAfterPurchItemItemRefNotFound",0]]},{"name":"FindItemReferenceForPurchaseLine","line":172,"kind":"procedure","access":"local","params":1,"steps":[[178,"event","OnBeforeFindItemReferenceForPurchaseLine",1],[184,"ext","table",39,"GetDateForCalculations",0],[192,"event","OnFindItemReferenceForPurchaseLineBeforeFindFirst",0],[200,"event","OnAfterFindItemReferenceForPurchaseLine",0]]},{"name":"FillDescription","line":203,"kind":"procedure","access":"local","params":1,"steps":[[208,"event","OnBeforeFillDescription",1]]},{"name":"ReferenceLookupPurchaseItem","line":236,"kind":"procedure","params":3,"steps":[[241,"event","OnBeforeReferenceLookupPurchaseItem",1],[247,"call","FindOrSelectFromItemReferenceList",7],[249,"ext","table",39,"GetDateForCalculations",0]]},{"name":"FillItemReferenceFromItemVendor","line":262,"kind":"procedure","access":"local","params":2,"steps":[[267,"event","OnBeforeFillItemReferenceFromItemVendor",1],[272,"validate",5777,"Item No."],[273,"validate",5777,"Variant Code"],[274,"validate",5777,"Reference Type"],[275,"validate",5777,"Reference Type No."],[279,"validate",5777,"Unit of Measure"]]},{"name":"CreateItemReference","line":283,"kind":"procedure","access":"local","params":1,"steps":[[289,"event","OnBeforeCreateItemReference",1],[293,"call","FillItemReferenceFromItemVendor",2],[295,"event","OnCreateItemReferenceOnBeforeInsert",0],[296,"write",5777,"Insert"]]},{"name":"InsertItemReference","line":299,"kind":"procedure","params":1,"steps":[[303,"call","FilterItemReferenceByItemVendor",2],[305,"call","CreateItemReference",1]]},{"name":"DeleteItemReference","line":308,"kind":"procedure","params":1,"steps":[[312,"call","FilterItemReferenceByItemVendor",2],[313,"write",5777,"DeleteAll"]]},{"name":"UpdateItemReference","line":316,"kind":"procedure","params":2,"steps":[[319,"call","DeleteItemReference",1],[322,"call","CreateItemReference",1]]},{"name":"FindOrSelectFromItemReferenceList","line":330,"kind":"procedure","params":7,"steps":[[337,"call","InitItemReferenceFilters",5],[338,"call","CountItemReference",5],[341,"call","ProcessDecisionTree",7],[343,"call","SelectOrFindReference",6]]},{"name":"ProcessDecisionTree","line":348,"kind":"procedure","access":"local","params":7,"steps":[[353,"event","OnBeforeProcessDecisionTree",1],[363,"call","BarCodeCRAreMappedToDifferentItems",1],[367,"call","CustVendAndBarCodeCRAreMappedToDifferentItems",3],[369,"call","SetFiltersTypeAndTypeNoItemRef",3]]},{"name":"SelectOrFindReference","line":375,"kind":"procedure","access":"local","params":6,"steps":[[383,"event","OnBeforeSelectOrFindReference",1],[388,"call","RunPageReferenceListOnRealOrTempRec",4],[391,"call","FindFirstCustVendItemReference",3],[392,"call","FindFirstBarCodeOrBlankTypeItemReference",1]]},{"name":"InitItemReferenceFilters","line":395,"kind":"procedure","access":"local","params":5,"steps":[[405,"call","ExcludeOtherReferenceTypes",2],[406,"event","OnInitItemReferenceFiltersOnBeforeCheckIsEmpty",0]]},{"name":"CountItemReference","line":425,"kind":"procedure","access":"local","params":5,"steps":[[431,"event","OnBeforeCountItemReference",1],[436,"call","SetFiltersTypeAndTypeNoItemRef",3],[438,"call","SetFiltersBlankTypeItemRef",1]]},{"name":"BarCodeCRAreMappedToDifferentItems","line":442,"kind":"procedure","access":"local","params":1,"steps":[[447,"call","SetFiltersBlankTypeItemRef",1]]},{"name":"CustVendAndBarCodeCRAreMappedToDifferentItems","line":453,"kind":"procedure","access":"local","params":3,"steps":[[458,"call","SetFiltersTypeAndTypeNoItemRef",3],[461,"call","SetFiltersBlankTypeItemRef",1]]},{"name":"RunPageReferenceListOnRealOrTempRec","line":465,"kind":"procedure","access":"local","params":4,"steps":[[468,"call","RunPageReferenceListOnTempRecord",3],[470,"call","RunPageReferenceList",1]]},{"name":"RunPageReferenceListOnTempRecord","line":473,"kind":"procedure","access":"local","params":3,"steps":[[479,"call","SetFiltersTypeAndTypeNoItemRef",3],[480,"call","InsertTempRecords",2],[481,"call","SetFiltersBlankTypeItemRef",1],[482,"call","InsertTempRecords",2],[483,"call","RunPageReferenceList",1]]},{"name":"RunPageReferenceList","line":490,"kind":"procedure","access":"local","params":1,"steps":[[493,"run","page",5735]]},{"name":"InsertTempRecords","line":496,"kind":"procedure","access":"local","params":2,"steps":[[501,"write",5777,"Insert"]]},{"name":"FindFirstCustVendItemReference","line":505,"kind":"procedure","access":"local","params":3,"steps":[[509,"call","SetFiltersTypeAndTypeNoItemRef",3]]},{"name":"FindFirstBarCodeOrBlankTypeItemReference","line":518,"kind":"procedure","access":"local","params":1,"steps":[[522,"call","SetFiltersBlankTypeItemRef",1]]},{"name":"SetFiltersTypeAndTypeNoItemRef","line":528,"kind":"procedure","access":"local","params":3,"steps":[[533,"event","OnAfterSetFiltersTypeAndTypeNoItemRef",0]]},{"name":"SetFiltersBlankTypeItemRef","line":536,"kind":"procedure","access":"local","params":1,"steps":[[541,"event","OnBeforeSetFiltersBlankTypeItemRef",1]]},{"name":"SalesReferenceNoLookup","line":549,"kind":"procedure","params":1,"steps":[[551,"ext","table",37,"GetSalesHeader",0]]},{"name":"SalesReferenceNoLookup","line":554,"kind":"procedure","params":2,"steps":[[562,"event","OnBeforeSalesReferenceNoLookup",1],[568,"ext","table",37,"SetSalesHeader",1],[572,"ext","table",37,"GetDateForCalculations",0],[577,"event","OnSalesReferenceNoLookupOnAfterSetFilters",0],[578,"run","page",5735],[580,"call","ValidateSalesReferenceNo",5],[581,"ext","table",37,"UpdateReferencePriceAndDiscount",0],[582,"call","SalesReferenceNoLookupValidateUnitPrice",2],[587,"ext","table",37,"SetSalesHeader",1],[589,"run","page",607]]},{"name":"SalesReferenceNoLookupValidateUnitPrice","line":595,"kind":"procedure","access":"local","params":2,"steps":[[600,"event","OnSalesReferenceNoLookupOnBeforeValidateUnitPrice",1],[604,"validate",37,"Unit Price"]]},{"name":"ValidateSalesReferenceNo","line":614,"kind":"procedure","params":5,"steps":[[620,"event","OnBeforeValidateSalesReferenceNo",1],[627,"call","ReferenceLookupSalesItem",3],[631,"event","OnValidateSalesReferenceNoOnBeforeAssignNo",0],[633,"validate",37,"No."],[635,"validate",37,"Variant Code"],[637,"validate",37,"Unit of Measure Code"],[638,"event","OnValidateSalesReferenceNoOnAfterAssignNo",0],[647,"call","FillSalesDescription",1],[648,"ext","table",37,"GetItemTranslation",0],[656,"ext","table",37,"UpdateUnitPrice",1],[657,"ext","table",37,"UpdateICPartner",0],[659,"event","OnAfterValidateSalesReferenceNo",0]]},{"name":"PurchaseReferenceNoLookup","line":670,"kind":"procedure","params":2,"steps":[[677,"event","OnBeforePurchaseReferenceNoLookup",1],[685,"ext","table",39,"GetDateForCalculations",0],[690,"event","OnPurchaseReferenceNoLookUpOnAfterSetFilters",0],[691,"run","page",5735],[693,"call","ValidatePurchaseReferenceNo",5],[694,"ext","table",39,"UpdateReferencePriceAndDiscount",0],[695,"event","OnPurchaseReferenceNoLookupOnBeforeValidateDirectUnitCost",0],[696,"validate",39,"Direct Unit Cost"]]},{"name":"ValidatePurchaseReferenceNo","line":701,"kind":"procedure","params":5,"steps":[[707,"event","OnBeforeValidatePurchaseReferenceNo",1],[712,"call","ReferenceLookupPurchaseItem",3],[716,"event","OnValidatePurchaseReferenceNoOnBeforeAssignNo",0],[718,"ext","table",39,"SetPurchHeader",1],[719,"validate",39,"No."],[720,"ext","table",39,"SetVendorItemNo",0],[722,"validate",39,"Variant Code"],[724,"validate",39,"Unit of Measure Code"],[725,"event","OnValidatePurchaseReferenceNoOnBeforePurchaseLineUpdateDirectUnitCost",0],[726,"ext","table",39,"UpdateDirectUnitCost",1],[735,"call","FillDescription",1],[736,"ext","table",39,"GetItemTranslation",0],[744,"ext","table",39,"UpdateDirectUnitCost",1],[745,"ext","table",39,"UpdateICPartner",0],[747,"event","OnAfterValidatePurchaseReferenceNo",0]]},{"name":"PhysicalInventoryOrderReferenceNoLookup","line":750,"kind":"procedure","params":1,"steps":[[758,"ext","table",5876,"GetDateForCalculations",0],[763,"event","OnPhysicalInventoryOrderReferenceNoLookupOnAfterSetFilters",0],[764,"run","page",5735],[766,"call","ValidatePhysicalInventoryOrderReferenceNo",4]]},{"name":"ValidatePhysicalInventoryOrderReferenceNo","line":770,"kind":"procedure","params":4,"steps":[[777,"call","ReferenceLookupPhysicalInventoryOrderItem",3],[781,"event","OnValidatePhysicalInventoryOrderReferenceNoOnBeforeAssignNo",0],[783,"call","TestEmptyOrBaseItemUnitOfMeasure",1],[784,"validate",5876,"Item No."],[786,"validate",5876,"Variant Code"],[788,"validate",5876,"Base Unit of Measure Code"],[797,"call","FillPhysInvOrderLineDescription",1],[803,"event","OnAfterValidatePhysicalInventoryOrderReferenceNo",0]]},{"name":"FillPhysInvOrderLineDescription","line":806,"kind":"procedure","access":"local","params":1,"steps":[[811,"validate",5876,"Variant Code"]]},{"name":"ReferenceLookupPhysicalInventoryOrderItem","line":819,"kind":"procedure","params":3,"steps":[[824,"event","OnBeforeReferenceLookupPhysicalInventoryOrderItem",1],[827,"call","FindOrSelectFromItemReferenceList",7],[827,"ext","table",5876,"GetDateForCalculations",0]]},{"name":"PhysicalInventoryRecordReferenceNoLookup","line":830,"kind":"procedure","params":1,"steps":[[839,"ext","table",5878,"GetDateForCalculations",0],[844,"event","OnPhysicalInventoryRecordReferenceNoLookupOnAfterSetFilters",0],[845,"run","page",5735],[847,"call","ValidatePhysicalInventoryRecordReferenceNo",4]]},{"name":"ValidatePhysicalInventoryRecordReferenceNo","line":851,"kind":"procedure","params":4,"steps":[[858,"call","ReferenceLookupPhysicalInventoryRecordItem",3],[862,"event","OnValidatePhysicalInventoryRecordReferenceNoOnBeforeAssignNo",0],[865,"validate",5878,"Item No."],[867,"validate",5878,"Variant Code"],[869,"validate",5878,"Unit of Measure Code"],[878,"call","FillPhysInvtRecordLineDescription",1],[884,"event","OnAfterValidatePhysicalInventoryRecordReferenceNo",0]]},{"name":"FillPhysInvtRecordLineDescription","line":887,"kind":"procedure","access":"local","params":1,"steps":[[892,"validate",5878,"Variant Code"]]},{"name":"ReferenceLookupPhysicalInventoryRecordItem","line":900,"kind":"procedure","params":3,"steps":[[905,"event","OnBeforeReferenceLookupPhysicalInventoryRecordItem",1],[908,"call","FindOrSelectFromItemReferenceList",7],[908,"ext","table",5878,"GetDateForCalculations",0]]},{"name":"ItemJournalReferenceNoLookup","line":911,"kind":"procedure","params":1,"steps":[[919,"ext","table",83,"GetDateForCalculations",0],[924,"event","OnItemJournalReferenceNoLookupOnAfterSetFilters",0],[925,"run","page",5735],[927,"call","ValidateItemJournalReferenceNo",4]]},{"name":"ValidateItemJournalReferenceNo","line":931,"kind":"procedure","params":4,"steps":[[938,"call","ReferenceLookupItemJournalItem",3],[942,"event","OnValidateItemJournalReferenceNoOnBeforeAssignNo",0],[945,"validate",83,"Item No."],[947,"validate",83,"Variant Code"],[949,"validate",83,"Unit of Measure Code"],[958,"call","FillItemJournalDescription",1],[962,"event","OnAfterValidateItemJournalReferenceNo",0]]},{"name":"FillItemJournalDescription","line":965,"kind":"procedure","access":"local","params":1,"steps":[[970,"validate",83,"Variant Code"]]},{"name":"ReferenceLookupItemJournalItem","line":977,"kind":"procedure","params":3,"steps":[[982,"event","OnBeforeReferenceLookupItemJournalItem",1],[985,"call","FindOrSelectFromItemReferenceList",7],[985,"ext","table",83,"GetDateForCalculations",0]]},{"name":"ValidateInvtDocumentReferenceNo","line":988,"kind":"procedure","params":4,"steps":[[995,"call","ReferenceLookupInvtDocumentItem",3],[999,"event","OnValidateInvtDocumentReferenceNoOnBeforeAssignNo",0],[1002,"validate",5851,"Item No."],[1004,"validate",5851,"Variant Code"],[1006,"validate",5851,"Unit of Measure Code"],[1015,"call","FillInvtDocumentLine",1],[1020,"event","OnAfterValidateInvtDocumentReferenceNo",0]]},{"name":"FillInvtDocumentLine","line":1023,"kind":"procedure","access":"local","params":1,"steps":[[1028,"validate",5851,"Variant Code"]]},{"name":"ReferenceLookupInvtDocumentItem","line":1035,"kind":"procedure","params":3,"steps":[[1040,"event","OnBeforeReferenceLookupInvtDocumentItem",1],[1043,"call","FindOrSelectFromItemReferenceList",6]]},{"name":"InvtDocumentReferenceNoLookup","line":1046,"kind":"procedure","params":1,"steps":[[1053,"event","OnInvtDocumentReferenceNoLookupOnAfterSetFilters",0],[1054,"run","page",5735],[1056,"call","ValidateInvtDocumentReferenceNo",4]]}]}