Skip to main content

Install the app

AutoFlow Receive is an extension for AutoFlow. It is installed per environment, like AutoFlow itself.

Prerequisites​

  • Business Central version 24 or newer.
  • AutoFlow, installed and activated in the same environment. Receive depends on AutoFlow and AutoFlow Core – see Install AutoFlow and Activate the product.
  • A user with sufficient rights to install extensions (for online environments: an Administrator in the Microsoft 365 tenant; for on-premises: a user with SUPER permissions that is allowed to publish apps on the BC Server instance).

Business Central Online (SaaS) – from AppSource​

  1. Sign in to your Business Central environment.
  2. Open the Extension Marketplace (search for Extension Marketplace in the Tell Me bar).
  3. Search for AutoFlow Receive by mse Software GmbH.
  4. Choose Get it now, accept the terms of use and choose the environment to install it in.
  5. AppSource installs AutoFlow Receive together with AutoFlow and AutoFlow Core, if they are not there yet. The installation runs in the background and can take a few minutes.
tip

If you manage several environments (for example a sandbox and a production environment), install AutoFlow Receive in each environment where you want to use it.

Business Central on-premises​

  1. Get the AutoFlow Receive .app file matching your Business Central version from mse Software GmbH.

  2. Install AutoFlow and AutoFlow Core first, as described in Install AutoFlow.

  3. On the server, open a Business Central Administration Shell (PowerShell), then publish, synchronise and install AutoFlow Receive in every tenant where you want to use it:

    Publish-NAVApp -ServerInstance <YourInstance> -Path "<path>\AutoFlow Receive.app" -PackageType Extension -SkipVerification
    Sync-NAVApp -ServerInstance <YourInstance> -Name "AutoFlow Receive" -Version <Version> -Tenant <TenantId>
    Install-NAVApp -ServerInstance <YourInstance> -Name "AutoFlow Receive" -Version <Version> -Tenant <TenantId>
tip

For a single-tenant installation, replace <TenantId> with default.

After installation​

  • The Incoming Document card shows the new fields, the Invoice Lines and the PDF Preview straight away – see The incoming document.
  • The attachment role E-DOC (Electronic Document) is created in every company. You can add your own roles on the Attachment Roles page.
  • The processing actions on the Incoming Document appear as soon as a flow is published on their trigger – see Processing actions.

Permission sets​

Permission SetWho it's forWhat it grants
mse365 AF-RC ALL (mse365 AutoFlow Receive - All)everyone who processes incoming documentsthe invoice lines, attachment roles and everything else Receive adds

Assign mse365 AF-RC ALL alongside the Business Central permissions your accounts payable team already has for incoming documents and purchase invoices. People who build or publish the processing flows also need the AutoFlow roles – see Permission sets in the AutoFlow documentation.

The assignment rule steps (apply document rules, apply line rules) also work when the flow runs for someone who does not hold mse365 AF-RC ALL – a colleague whose action started the flow, for example. Other steps that read or change the invoice lines (Find Records, For Each Loop, Modify Record, or a SmartField such as {{line.Description}}) run with that person's own rights, so for those they need mse365 AF-RC ALL.

Network requirements​

This section only applies if your Business Central Server reaches the internet through an outbound proxy or an egress filter. For Business Central Online there is nothing to do.

Some flow steps that ship with Receive call an mse service. If your firewall restricts outbound traffic, allow these hosts (HTTPS, TCP 443):

HostUsed byIf blocked
api.mse365-services.netValidate E-Document, and Extract ZUGFeRD XML where Business Central cannot read the PDF itself (always on Business Central 24)The step fails; the flow reports the error
pdf-tools.autoflow365.appVisualize E-Document – renders an XML-only e-invoice as a PDFThe step fails; the flow reports the error

The hosts AutoFlow itself needs are listed in Network requirements in the AutoFlow documentation.