{"title":"Codeunit 3307 Payables Agent Setup, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/3307-payables-agent-setup/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-24","object":{"type":"codeunit","id":3307,"name":"Payables Agent Setup","app":"Payables Agent","url":"https://jonas-paprotka.de/ref/codeunit/3307-payables-agent-setup/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/3307-payables-agent-setup/source/","path":"src/Apps/W1/PayablesAgent/app/Setup/PayablesAgentSetup.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":{"codeunit:3304":{"name":"PA Setup Configuration","url":"https://jonas-paprotka.de/ref/codeunit/3304-pa-setup-configuration/"},"codeunit:4324":{"name":"Agent Setup","url":"https://jonas-paprotka.de/ref/codeunit/4324-agent-setup/"},"table:3303":{"name":"Payables Agent Setup","url":"https://jonas-paprotka.de/ref/table/3303-payables-agent-setup/"},"codeunit:9024":{"name":"Azure AD Graph User","url":"https://jonas-paprotka.de/ref/codeunit/9024-azure-ad-graph-user/"},"codeunit:457":{"name":"Environment Information","url":"https://jonas-paprotka.de/ref/codeunit/457-environment-information/"},"codeunit:3310":{"name":"PA Validate Setup","url":"https://jonas-paprotka.de/ref/codeunit/3310-pa-validate-setup/"},"codeunit:6196":{"name":"E-Doc. PO Matching","url":"https://jonas-paprotka.de/ref/codeunit/6196-e-doc-po-matching/"},"codeunit:3309":{"name":"PA Demo Guide","url":"https://jonas-paprotka.de/ref/codeunit/3309-pa-demo-guide/"},"table:6103":{"name":"E-Document Service","url":"https://jonas-paprotka.de/ref/table/6103-e-document-service/"},"table:6122":{"name":"E-Doc. Service Supported Type","url":"https://jonas-paprotka.de/ref/table/6122-e-doc-service-supported-type/"},"table:6121":{"name":"E-Document","url":"https://jonas-paprotka.de/ref/table/6121-e-document/"},"codeunit:2200":{"name":"Azure Key Vault","url":"https://jonas-paprotka.de/ref/codeunit/2200-azure-key-vault/"},"codeunit:4321":{"name":"Agent","url":"https://jonas-paprotka.de/ref/codeunit/4321-agent/"},"codeunit:8347":{"name":"Feature Configuration","url":"https://jonas-paprotka.de/ref/codeunit/8347-feature-configuration/"},"codeunit:1266":{"name":"Cryptography Management","url":"https://jonas-paprotka.de/ref/codeunit/1266-cryptography-management/"},"codeunit:2000000022":{"name":"Agent Utilities","url":"https://jonas-paprotka.de/ref/codeunit/2000000022-agent-utilities/"},"codeunit:7773":{"name":"Copilot Capability","url":"https://jonas-paprotka.de/ref/codeunit/7773-copilot-capability/"},"codeunit:3307":{"name":"Payables Agent Setup","url":"https://jonas-paprotka.de/ref/codeunit/3307-payables-agent-setup/"},"table:2000000261":{"name":"Agent Access Control","url":"https://jonas-paprotka.de/ref/table/2000000261-agent-access-control/"},"codeunit:4317":{"name":"Agent System Permissions","url":"https://jonas-paprotka.de/ref/codeunit/4317-agent-system-permissions/"},"codeunit:152":{"name":"User Permissions","url":"https://jonas-paprotka.de/ref/codeunit/152-user-permissions/"},"codeunit:3318":{"name":"PA Trial","url":"https://jonas-paprotka.de/ref/codeunit/3318-pa-trial/"},"table:4310":{"name":"Agent Setup Buffer","url":"https://jonas-paprotka.de/ref/table/4310-agent-setup-buffer/"},"table:2000000291":{"name":"Access Control Buffer","url":"https://jonas-paprotka.de/ref/table/2000000291-access-control-buffer/"},"table:3304":{"name":"Payables Agent KPI","url":"https://jonas-paprotka.de/ref/table/3304-payables-agent-kpi/"},"codeunit:6140":{"name":"E-Doc. Import","url":"https://jonas-paprotka.de/ref/codeunit/6140-e-doc-import/"},"table:3308":{"name":"PA Known Sender","url":"https://jonas-paprotka.de/ref/table/3308-pa-known-sender/"},"codeunit:8904":{"name":"Email Message","url":"https://jonas-paprotka.de/ref/codeunit/8904-email-message/"}},"procs":[{"name":"LoadSetupConfiguration","line":44,"kind":"procedure","params":1,"steps":[[54,"ext","codeunit",3304,"GetSkipAgentConfiguration",0],[55,"call","GetAgent",1],[56,"ext","codeunit",4324,"GetSetupRecord",6],[60,"call","AgentUserName",0],[61,"call","AgentDisplayName",0],[64,"ext","codeunit",3304,"SetAgentSetupBuffer",1],[67,"ext","table",3303,"GetSetup",0],[71,"ext","codeunit",3304,"SetPayablesAgentSetup",1],[72,"ext","codeunit",3304,"SetEDocumentService",1],[73,"ext","codeunit",3304,"SetOutlookSetup",1]]},{"name":"ApplyPayablesAgentSetup","line":81,"kind":"procedure","params":1,"steps":[[102,"ext","codeunit",9024,"IsUserDelegatedAdmin",0],[102,"ext","codeunit",9024,"IsUserDelegatedHelpdesk",0],[108,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[108,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[109,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[110,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[117,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[117,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[118,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[125,"ext","codeunit",3304,"GetOutlookSetup",0],[126,"ext","codeunit",3304,"GetOutlookSetup",0],[127,"ext","codeunit",3304,"GetOutlookSetup",0],[128,"ext","codeunit",3304,"GetOutlookSetup",0],[129,"ext","codeunit",3304,"GetOutlookSetup",0],[133,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[133,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[134,"ext","codeunit",3304,"GetSkipEmailVerification",0],[136,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[137,"ext","codeunit",3304,"GetOutlookSetup",0],[141,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[143,"ext","codeunit",3304,"SetPayablesAgentSetup",1],[146,"ext","codeunit",457,"IsSaaS",0],[146,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[147,"ext","codeunit",3310,"SetOutlookSetup",1],[148,"run","codeunit",3310],[150,"ext","codeunit",3304,"GetEmailAccount",0],[164,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[164,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[165,"call","InitializeTrialIfEligible",0],[168,"ext","table",3303,"GetSetup",0],[169,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[172,"ext","codeunit",3304,"GetSkipAgentConfiguration",0],[173,"call","ApplyAgentSetup",2],[176,"call","ApplyEDocumentServiceSetup",2],[177,"write",3303,"Modify"],[179,"ext","codeunit",6196,"ConfigureDefaultPOMatchingSettings",0],[180,"ext","codeunit",3309,"SendDemoEmail",1],[182,"call","InsertAccessControlForEligibleUsers",1]]},{"name":"GetOrCreateAgentEDocumentService","line":185,"kind":"procedure","params":0,"steps":[[191,"write",6103,"Insert",1],[193,"ext","table",6122,"InsertDefaultIfMissing",3],[194,"ext","table",6122,"InsertDefaultIfMissing",3]]},{"name":"AllowCreditMemosOnAgentEDocumentService","line":198,"kind":"procedure","access":"internal","params":0,"steps":[[204,"ext","table",6122,"InsertDefaultIfMissing",3]]},{"name":"WasEDocumentCreatedByAgent","line":207,"kind":"procedure","params":1,"steps":[[209,"ext","table",6121,"GetEDocumentService",0]]},{"name":"GetAgent","line":228,"kind":"procedure","params":2,"steps":[[233,"ext","table",3303,"GetSetup",1],[241,"call","AgentUserName",0],[245,"write",3303,"Modify"]]},{"name":"SetAgentInstructions","line":249,"kind":"procedure","access":"internal","params":1,"steps":[[257,"call","ApplyAgentInstructions",1],[259,"ext","table",3303,"GetSetup",0],[262,"write",3303,"Modify"]]},{"name":"ApplyAgentInstructions","line":271,"kind":"procedure","access":"local","params":1,"steps":[[279,"call","IsAgentDrivenLineMatchingEnabled",0],[284,"ext","codeunit",2200,"GetAzureKeyVaultSecret",2],[287,"call","FeatureName",0],[290,"ext","codeunit",4321,"SetInstructions",2],[292,"call","GetInstructionsConfigHash",0]]},{"name":"IsAgentDrivenLineMatchingEnabled","line":298,"kind":"procedure","access":"internal","params":0,"steps":[[302,"ext","codeunit",8347,"GetConfiguration",1]]},{"name":"EnsureAgentInstructionsMatchConfiguration","line":311,"kind":"procedure","access":"internal","params":1,"steps":[[317,"ext","table",3303,"GetSetup",0],[318,"call","GetInstructionsConfigHash",0],[320,"call","FeatureName",0],[321,"call","SetAgentInstructions",1]]},{"name":"TryEnsureAgentInstructionsMatchConfiguration","line":330,"kind":"procedure","access":"internal","params":1,"steps":[[332,"call","EnsureAgentInstructionsMatchConfiguration",1]]},{"name":"GetInstructionsConfigHash","line":340,"kind":"procedure","access":"internal","params":0,"steps":[[348,"call","GetInstructionsExperimentKeys",0],[351,"ext","codeunit",8347,"GetConfiguration",1],[354,"ext","codeunit",1266,"GenerateHash",2]]},{"name":"CanShowAgentActions","line":364,"kind":"procedure","access":"internal","params":0,"steps":[[371,"ext","codeunit",2000000022,"IsAgentsFeatureEnabled",0],[374,"ext","codeunit",7773,"IsCapabilityActive",1],[377,"ext","codeunit",3307,"GetAgent",1],[378,"call","AllowCreateNewAgent",0]]},{"name":"InsertAccessControlForEligibleUsers","line":387,"kind":"procedure","access":"internal","params":1,"steps":[[393,"call","GetUsersThatHaveCreatedPostedPurchInvoice",0],[407,"write",2000000261,"Insert"]]},{"name":"AllowCreateNewAgent","line":416,"kind":"procedure","access":"internal","params":0,"steps":[[424,"ext","codeunit",2000000022,"IsAgentsFeatureEnabled",0],[427,"ext","codeunit",7773,"IsCapabilityActive",1],[430,"ext","codeunit",3307,"GetAgent",2],[434,"ext","codeunit",4317,"CurrentUserHasCanManageAllAgentsPermission",0],[437,"ext","codeunit",2000000022,"CanCurrentUserCreateAgent",1],[440,"call","HasUserCreatedPostedPurchInvoice",0]]},{"name":"ApplyAgentSetup","line":458,"kind":"procedure","access":"local","params":2,"steps":[[470,"ext","codeunit",3304,"GetAgentSetupBuffer",1],[471,"ext","codeunit",4324,"SaveChanges",1],[482,"ext","codeunit",152,"IsSuper",1],[482,"ext","codeunit",152,"HasUserPermissionSetAssigned",5],[484,"ext","codeunit",152,"AssignPermissionSets",3],[490,"call","ApplyAgentInstructions",1]]},{"name":"ApplyEDocumentServiceSetup","line":494,"kind":"procedure","access":"local","params":2,"steps":[[500,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[500,"ext","codeunit",3304,"GetAgentSetupBuffer",0],[502,"validate",6103,"Auto Import"],[503,"write",6103,"Modify"],[507,"call","GetOrCreateAgentEDocumentService",0],[509,"validate",6103,"Automatic Import Processing"],[510,"validate",6103,"Import Process"],[514,"write",6103,"Modify"],[516,"validate",6103,"Auto Import"],[518,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[519,"validate",6103,"Service Integration V2"],[520,"validate",6103,"Auto Import"],[526,"validate",6103,"Auto Import"],[527,"write",6103,"Modify"]]},{"name":"InitializeTrialIfEligible","line":531,"kind":"procedure","access":"local","params":0,"steps":[[535,"ext","codeunit",3318,"IsEligibleToStart",0],[536,"ext","codeunit",3318,"StartTrial",0]]},{"name":"EnsureAgentActivated","line":546,"kind":"procedure","access":"internal","params":1,"steps":[[553,"ext","table",3303,"GetSetup",0],[560,"call","LoadSetupConfiguration",1],[561,"ext","codeunit",3304,"GetPayablesAgentSetup",0],[564,"ext","codeunit",3304,"SetPayablesAgentSetup",1],[565,"ext","codeunit",3304,"GetAgentSetupBuffer",1],[566,"validate",4310,"State"],[567,"ext","codeunit",3304,"SetAgentSetupBuffer",1],[568,"ext","codeunit",3304,"SetSkipEmailVerification",1],[569,"call","ApplyPayablesAgentSetup",1]]},{"name":"GetDefaultProfile","line":573,"kind":"procedure","access":"internal","params":1,"steps":[[579,"ext","codeunit",4321,"PopulateDefaultProfile",3]]},{"name":"GetDefaultAccessControls","line":582,"kind":"procedure","access":"internal","params":1,"steps":[[592,"write",2000000291,"Insert"]]},{"name":"HandleOnAfterCreatedNewCompanyByCopyCompany","line":596,"kind":"procedure","access":"local","params":1,"steps":[[602,"write",3303,"DeleteAll"],[605,"write",3304,"DeleteAll"]]},{"name":"ImportInvoiceFile","line":657,"kind":"procedure","params":2,"steps":[[663,"ext","codeunit",6140,"CreateFromType",5],[663,"ext","codeunit",3307,"GetOrCreateAgentEDocumentService",0],[665,"write",6121,"Modify"],[666,"ext","codeunit",6140,"ProcessAutomaticallyIncomingEDocument",1]]},{"name":"ShouldRequestReview","line":674,"kind":"procedure","params":1,"steps":[[684,"ext","table",3303,"GetSetup",0],[694,"call","MonitoredFolderConfigured",0],[698,"call","IsSenderAuthenticated",1],[702,"ext","table",3308,"GetForEDocument",2],[706,"call","IsSenderInternal",1]]},{"name":"IsSenderRejected","line":717,"kind":"procedure","params":1,"steps":[[721,"ext","table",3308,"GetForEDocument",2]]},{"name":"IsSenderAuthenticated","line":740,"kind":"procedure","params":1,"steps":[[744,"call","TryGetSourceEmailHeader",3],[745,"call","CompAuthPassed",1],[747,"call","IsSenderInternal",1]]},{"name":"IsSenderInternal","line":756,"kind":"procedure","params":1,"steps":[[760,"call","TryGetSourceEmailHeader",3]]},{"name":"TryGetSourceEmailHeader","line":765,"kind":"procedure","access":"local","params":3,"steps":[[771,"ext","codeunit",8904,"Get",1],[773,"ext","codeunit",8904,"GetHeader",2]]},{"name":"ClassifyKnownSendersUnusedByChange","line":789,"kind":"procedure","params":3,"steps":[[796,"call","ClassifyByPolicyAndFolder",2]]},{"name":"ClassifyKnownSendersUnusedReason","line":803,"kind":"procedure","params":2,"steps":[[805,"call","ClassifyByPolicyAndFolder",2]]}]}