{"title":"Codeunit 1217 Pre-map Incoming Purch. Doc, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/1217-pre-map-incoming-purch-doc/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":1217,"name":"Pre-map Incoming Purch. Doc","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/1217-pre-map-incoming-purch-doc/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/1217-pre-map-incoming-purch-doc/source/","path":"src/Layers/W1/BaseApp/System/DataExchange/PremapIncomingPurchDoc.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:130":{"name":"Incoming Document","url":"https://jonas-paprotka.de/ref/table/130-incoming-document/"},"table:1214":{"name":"Intermediate Data Import","url":"https://jonas-paprotka.de/ref/table/1214-intermediate-data-import/"},"codeunit:1251":{"name":"Record Match Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/1251-record-match-mgt/"},"table:5777":{"name":"Item Reference","url":"https://jonas-paprotka.de/ref/table/5777-item-reference/"},"table:2000000026":{"name":"Integer","url":"https://jonas-paprotka.de/ref/table/2000000026-integer/"},"table:700":{"name":"Error Message","url":"https://jonas-paprotka.de/ref/table/700-error-message/"},"table:1251":{"name":"Text-to-Account Mapping","url":"https://jonas-paprotka.de/ref/table/1251-text-to-account-mapping/"}},"procs":[{"name":"OnRun","line":27,"kind":"trigger","steps":[[35,"call","FindDistinctRecordNos",4],[42,"call","ValidateCompanyInfo",2],[43,"call","ValidateCurrency",2],[44,"call","SetDocumentType",3],[46,"call","CorrectHeaderData",2],[47,"call","FindBuyFromVendor",2],[48,"call","FindPayToVendor",2],[49,"call","FindInvoiceToApplyTo",2],[51,"call","PersistHeaderData",4],[53,"call","ProcessLines",3]]},{"name":"ValidateCompanyInfo","line":89,"kind":"procedure","access":"local","params":2,"steps":[[103,"ext","table",130,"GetGeneratedFromOCRAttachment",1],[107,"ext","table",1214,"FindEntry",5],[115,"call","ValidateCompanyInfoByNameAndAddress",2],[120,"call","LogErrorMessage",4],[125,"call","LogErrorMessage",4],[135,"call","ExtractVatRegNo",2],[135,"call","ExtractVatRegNo",2],[138,"call","LogErrorMessage",4]]},{"name":"ValidateCompanyInfoByNameAndAddress","line":144,"kind":"procedure","access":"local","params":2,"steps":[[159,"ext","table",1214,"FindEntry",5],[162,"ext","codeunit",1251,"CalculateStringNearness",4],[162,"call","MatchThreshold",0],[162,"call","NormalizingFactor",0],[168,"ext","codeunit",1251,"CalculateStringNearness",4],[168,"call","MatchThreshold",0],[168,"call","NormalizingFactor",0],[170,"call","RequiredNearness",0],[171,"call","LogErrorMessage",4],[173,"call","RequiredNearness",0],[174,"call","LogErrorMessage",4]]},{"name":"ValidateCurrency","line":177,"kind":"procedure","access":"local","params":2,"steps":[[188,"call","LogErrorMessage",4],[191,"ext","table",1214,"GetEntryValue",5],[193,"call","LogSimpleErrorMessage",2],[202,"write",1214,"Modify"],[208,"call","LogSimpleErrorMessage",2],[211,"write",1214,"DeleteAll"],[219,"call","LogSimpleErrorMessage",2],[222,"write",1214,"DeleteAll"]]},{"name":"ProcessLines","line":225,"kind":"procedure","access":"local","params":3,"steps":[[235,"call","FindDistinctRecordNos",4],[237,"call","InsertLineForTotalDocumentAmount",4],[242,"call","ProcessLine",4]]},{"name":"CorrectHeaderData","line":246,"kind":"procedure","access":"local","params":2,"steps":[[258,"call","CorrectHeaderField",5],[260,"call","CorrectHeaderField",5],[262,"call","CorrectHeaderField",5],[264,"call","CorrectHeaderField",5],[266,"call","CorrectHeaderField",5],[268,"call","CorrectHeaderField",5],[270,"call","CorrectHeaderField",5],[272,"call","CorrectHeaderField",5],[274,"call","CorrectHeaderField",5],[276,"call","CorrectCurrencyCode",5],[278,"call","CorrectHeaderField",5],[280,"call","CorrectHeaderField",5],[282,"call","CorrectHeaderField",5],[284,"call","CorrectHeaderField",5],[287,"event","OnAfterCorrectHeaderData",0]]},{"name":"CorrectHeaderField","line":290,"kind":"procedure","params":5,"steps":[[296,"call","CheckDataExchMappingNotExist",3],[299,"ext","table",1214,"GetEntryValue",5],[302,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"CorrectCurrencyCode","line":325,"kind":"procedure","access":"local","params":5,"steps":[[332,"ext","table",1214,"GetEntryValue",5],[336,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"PersistHeaderData","line":339,"kind":"procedure","access":"local","params":4,"steps":[[359,"validate",130,"Vendor No."],[361,"validate",130,"Vendor No."],[364,"ext","table",1214,"GetEntryValue",5],[365,"validate",130,"Vendor Name"],[367,"ext","table",1214,"GetEntryValue",5],[370,"validate",130,"Amount Incl. VAT"],[372,"ext","table",1214,"GetEntryValue",5],[375,"validate",130,"Amount Excl. VAT"],[377,"ext","table",1214,"GetEntryValue",5],[380,"validate",130,"VAT Amount"],[382,"ext","table",1214,"GetEntryValue",5],[385,"ext","table",1214,"GetEntryValue",5],[388,"ext","table",1214,"GetEntryValue",5],[390,"validate",130,"Vendor Invoice No."],[392,"ext","table",1214,"GetEntryValue",5],[393,"validate",130,"Order No."],[395,"ext","table",1214,"GetEntryValue",5],[396,"validate",130,"Document Date"],[398,"ext","table",1214,"GetEntryValue",5],[399,"validate",130,"Due Date"],[401,"ext","table",1214,"GetEntryValue",5],[406,"ext","table",1214,"GetEntryValue",5],[407,"validate",130,"Vendor VAT Registration No."],[410,"ext","table",1214,"GetEntryValue",5],[411,"validate",130,"Vendor IBAN"],[414,"ext","table",1214,"GetEntryValue",5],[415,"validate",130,"Vendor Bank Branch No."],[418,"ext","table",1214,"GetEntryValue",5],[419,"validate",130,"Vendor Phone No."],[422,"ext","table",1214,"GetEntryValue",5],[423,"validate",130,"Vendor Bank Account No."],[426,"write",130,"Modify"]]},{"name":"FindBuyFromVendor","line":429,"kind":"procedure","access":"local","params":2,"steps":[[446,"ext","table",1214,"GetEntryValue",5],[447,"call","FindVendorById",4],[451,"ext","table",1214,"GetEntryValue",5],[452,"call","FindVendorByNo",4],[456,"ext","table",1214,"GetEntryValue",5],[458,"ext","table",1214,"FindEntry",5],[472,"ext","table",1214,"InsertOrUpdateEntry",6],[487,"call","FindVendorByBankAccount",3],[490,"call","FindVendorByPhoneNo",4],[493,"call","FindVendorByNameAndAddress",5],[502,"call","ExtractVatRegNo",2],[503,"call","ExtractVatRegNo",2],[505,"ext","table",1214,"InsertOrUpdateEntry",6],[515,"call","FindVendorByBankAccount",3],[518,"call","FindVendorByPhoneNo",4],[521,"call","FindVendorByNameAndAddress",5],[528,"call","LogErrorMessage",4]]},{"name":"FindPayToVendor","line":533,"kind":"procedure","access":"local","params":2,"steps":[[546,"ext","table",1214,"FindEntry",5],[563,"call","FindVendorByNameAndAddress",5],[571,"ext","table",1214,"InsertOrUpdateEntry",6],[585,"call","ExtractVatRegNo",2],[586,"call","ExtractVatRegNo",2],[588,"ext","table",1214,"InsertOrUpdateEntry",6],[598,"call","LogErrorMessage",4]]},{"name":"FindVendorByNameAndAddress","line":603,"kind":"procedure","access":"local","params":5,"steps":[[618,"ext","codeunit",1251,"CalculateStringNearness",4],[618,"call","MatchThreshold",0],[618,"call","NormalizingFactor",0],[620,"call","RequiredNearness",0],[622,"ext","codeunit",1251,"CalculateStringNearness",4],[622,"call","MatchThreshold",0],[622,"call","NormalizingFactor",0],[623,"call","RequiredNearness",0],[623,"call","RequiredNearness",0],[624,"ext","table",1214,"InsertOrUpdateEntry",6],[632,"call","LogErrorMessage",4]]},{"name":"FindVendorByBankAccount","line":637,"kind":"procedure","access":"local","params":3,"steps":[[646,"ext","table",1214,"FindEntry",5],[659,"call","TryFindLeastBlockedVendorNoByVendorBankAcc",1],[666,"call","TryFindLeastBlockedVendorNoByVendorBankAcc",1],[670,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"FindVendorByPhoneNo","line":677,"kind":"procedure","access":"local","params":4,"steps":[[692,"ext","codeunit",1251,"CalculateStringNearness",4],[692,"call","MatchThreshold",0],[692,"call","NormalizingFactor",0],[693,"call","RequiredNearness",0],[694,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"FindVendorById","line":702,"kind":"procedure","access":"local","params":4,"steps":[[717,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"FindVendorByNo","line":721,"kind":"procedure","access":"local","params":4,"steps":[[732,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"FindInvoiceToApplyTo","line":736,"kind":"procedure","access":"local","params":2,"steps":[[744,"ext","table",1214,"GetEntryValue",5],[751,"ext","table",1214,"InsertOrUpdateEntry",6],[753,"ext","table",1214,"InsertOrUpdateEntry",6],[762,"call","LogErrorMessage",4],[768,"call","LogErrorMessage",4]]},{"name":"ProcessLine","line":772,"kind":"procedure","access":"local","params":4,"steps":[[778,"event","OnBeforeProcessLine",1],[783,"call","IsDescriptionOnlyLine",3],[784,"call","CleanDescriptionOnlyLine",3],[789,"call","ResolveUnitOfMeasureFromDataImport",4],[790,"call","FindItemReferenceForLine",5],[791,"call","FindItemForLine",4],[792,"call","FindGLAccountForLine",4],[793,"call","LogErrorIfItemNotFound",4],[795,"call","ValidateLineDiscount",3]]},{"name":"InsertLineForTotalDocumentAmount","line":798,"kind":"procedure","access":"local","params":4,"steps":[[808,"event","OnBeforeInsertLineForTotalDocumentAmount",1],[815,"ext","table",1214,"GetEntryValue",5],[819,"ext","table",1214,"InsertOrUpdateEntry",6],[821,"ext","table",1214,"InsertOrUpdateEntry",6],[823,"ext","table",1214,"InsertOrUpdateEntry",6],[824,"call","GetTotalAmountExclVAT",2],[825,"call","FindGLAccountForLine",4]]},{"name":"GetTotalAmountExclVAT","line":828,"kind":"procedure","access":"local","params":2,"steps":[[833,"ext","table",1214,"FindEntry",5],[834,"call","LogSimpleErrorMessage",2]]},{"name":"FindItemForLine","line":840,"kind":"procedure","access":"local","params":4,"steps":[[847,"ext","table",1214,"FindEntry",5],[859,"write",1214,"Modify"],[861,"ext","table",1214,"InsertOrUpdateEntry",6],[864,"call","ResolveUnitOfMeasureFromItem",5]]},{"name":"FindItemReferenceForLine","line":869,"kind":"procedure","access":"local","params":5,"steps":[[879,"ext","table",1214,"FindEntry",5],[889,"call","FindMatchingItemReference",2],[892,"ext","table",1214,"InsertOrUpdateEntry",6],[894,"ext","table",1214,"InsertOrUpdateEntry",6],[897,"call","ResolveUnitOfMeasureFromItemReference",5]]},{"name":"FindMatchingItemReference","line":902,"kind":"procedure","access":"local","params":2,"steps":[[910,"ext","table",5777,"HasValidUnitOfMeasure",0],[917,"ext","table",5777,"HasValidUnitOfMeasure",0]]},{"name":"IsDescriptionOnlyLine","line":925,"kind":"procedure","access":"local","params":3,"steps":[[931,"ext","table",1214,"FindEntry",5]]},{"name":"CleanDescriptionOnlyLine","line":941,"kind":"procedure","access":"local","params":3,"steps":[[946,"ext","table",1214,"InsertOrUpdateEntry",6],[955,"write",1214,"DeleteAll"]]},{"name":"LogErrorIfItemNotFound","line":958,"kind":"procedure","access":"local","params":4,"steps":[[967,"ext","table",1214,"GetEntryValue",5],[970,"ext","table",1214,"GetEntryValue",5],[973,"ext","table",1214,"GetEntryValue",5],[977,"call","LogErrorMessage",4],[983,"call","LogErrorMessage",4],[989,"call","LogErrorMessage",4]]},{"name":"FindGLAccountForLine","line":997,"kind":"procedure","access":"local","params":4,"steps":[[1007,"ext","table",1214,"GetEntryValue",5],[1009,"ext","table",1214,"GetEntryValue",5],[1014,"event","OnFindGLAccountForLineOnBeforeFindAppropriateGLAccount",1],[1016,"call","FindAppropriateGLAccount",5],[1019,"ext","table",1214,"InsertOrUpdateEntry",6],[1021,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"InsertOrUpdateUnitOfMeasureCode","line":1027,"kind":"procedure","access":"local","params":4,"steps":[[1032,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"ResolveUnitOfMeasureFromItemReference","line":1036,"kind":"procedure","access":"local","params":5,"steps":[[1044,"call","ResolveUnitOfMeasureFromItem",5],[1048,"call","LogErrorMessage",4],[1049,"call","UnitCodeToString",1],[1053,"ext","table",5777,"HasValidUnitOfMeasure",0],[1054,"call","LogErrorMessage",4],[1055,"call","UnitCodeToString",1],[1059,"call","InsertOrUpdateUnitOfMeasureCode",4]]},{"name":"ResolveUnitOfMeasureFromItem","line":1063,"kind":"procedure","access":"local","params":5,"steps":[[1072,"call","LogErrorMessage",4],[1073,"call","UnitCodeToString",1],[1077,"call","InsertOrUpdateUnitOfMeasureCode",4]]},{"name":"ResolveUnitOfMeasureFromDataImport","line":1081,"kind":"procedure","access":"local","params":4,"steps":[[1088,"ext","table",1214,"FindEntry",5],[1091,"call","LogSimpleErrorMessage",2],[1098,"call","InsertOrUpdateUnitOfMeasureCode",4],[1105,"call","InsertOrUpdateUnitOfMeasureCode",4],[1114,"call","InsertOrUpdateUnitOfMeasureCode",4],[1122,"call","InsertOrUpdateUnitOfMeasureCode",4],[1126,"call","LogErrorMessage",4]]},{"name":"ValidateLineDiscount","line":1137,"kind":"procedure","access":"local","params":3,"steps":[[1149,"ext","table",1214,"GetEntryValue",5],[1153,"ext","table",1214,"GetEntryValue",5],[1157,"ext","table",1214,"GetEntryValue",5],[1161,"ext","table",1214,"GetEntryValue",5],[1166,"ext","table",1214,"InsertOrUpdateEntry",6],[1169,"write",1214,"Modify"]]},{"name":"FindDistinctRecordNos","line":1187,"kind":"procedure","access":"local","params":4,"steps":[[1194,"write",2000000026,"DeleteAll"],[1208,"write",2000000026,"Insert"]]},{"name":"LogErrorMessage","line":1213,"kind":"procedure","access":"local","params":4,"steps":[[1222,"ext","table",700,"SetContext",1],[1223,"ext","table",700,"LogMessage",4]]},{"name":"LogSimpleErrorMessage","line":1226,"kind":"procedure","access":"local","params":2,"steps":[[1235,"ext","table",700,"SetContext",1],[1236,"ext","table",700,"LogSimpleMessage",2]]},{"name":"SetDocumentType","line":1239,"kind":"procedure","access":"local","params":3,"steps":[[1249,"ext","table",1214,"FindEntry",5],[1250,"call","LogErrorMessage",4],[1251,"call","ConstructDocumenttypeUnknownErr",0],[1254,"call","GetDocumentTypeOptionString",1],[1255,"call","GetDocumentTypeOptionCaption",1],[1257,"call","GetDocumentTypeOptionString",1],[1258,"call","GetDocumentTypeOptionCaption",1],[1262,"call","LogErrorMessage",4],[1263,"call","ConstructDocumenttypeUnknownErr",0],[1266,"ext","table",1214,"InsertOrUpdateEntry",6]]},{"name":"ConstructDocumenttypeUnknownErr","line":1293,"kind":"procedure","params":0,"steps":[[1303,"call","GetDocumentTypeOptionCaption",1],[1304,"call","GetDocumentTypeOptionCaption",1]]},{"name":"FindAppropriateGLAccount","line":1310,"kind":"procedure","params":5,"steps":[[1321,"ext","table",1214,"GetEntryValue",5],[1326,"ext","table",1251,"SearchEnteriesInText",3],[1328,"call","FindCorrectAccountFromMapping",3],[1330,"call","LogErrorMessage",4],[1336,"ext","table",1251,"SearchEnteriesInText",3],[1338,"call","FindCorrectAccountFromMapping",3],[1340,"call","LogErrorMessage",4],[1361,"call","LogErrorMessage",4]]}]}