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
SUPERpermissions that is allowed to publish apps on the BC Server instance).
Business Central Online (SaaS) – from AppSource
- Sign in to your Business Central environment.
- Open the Extension Marketplace (search for Extension Marketplace in the Tell Me bar).
- Search for AutoFlow Receive by mse Software GmbH.
- Choose Get it now, accept the terms of use and choose the environment to install it in.
- 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.
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
-
Get the AutoFlow Receive
.appfile matching your Business Central version from mse Software GmbH. -
Install AutoFlow and AutoFlow Core first, as described in Install AutoFlow.
-
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>
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 Set | Who it's for | What it grants |
|---|---|---|
| mse365 AF-RC ALL (mse365 AutoFlow Receive - All) | everyone who processes incoming documents | the 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):
| Host | Used by | If blocked |
|---|---|---|
api.mse365-services.net | Validate 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.app | Visualize E-Document – renders an XML-only e-invoice as a PDF | The step fails; the flow reports the error |
The hosts AutoFlow itself needs are listed in Network requirements in the AutoFlow documentation.