App installieren
AutoFlow Receive ist eine Erweiterung für AutoFlow. Wie AutoFlow selbst wird es je Umgebung installiert.
Voraussetzungen
- Business Central ab Version 24.
- AutoFlow, installiert und aktiviert in derselben Umgebung. Receive setzt AutoFlow und AutoFlow Core voraus – siehe AutoFlow installieren und Produkt aktivieren.
- Ein Benutzer, der Erweiterungen installieren darf (online: ein Administrator im Microsoft-365-Mandanten; on-premises: ein Benutzer mit
SUPER-Rechten, der Apps auf der BC-Server-Instanz veröffentlichen darf).
Business Central Online (SaaS) – aus AppSource
- Melde dich an deiner Business-Central-Umgebung an.
- Öffne den Erweiterungs-Marketplace (Suche nach Erweiterungs-Marketplace in der Tell-Me-Leiste).
- Suche nach AutoFlow Receive von mse Software GmbH.
- Wähle Jetzt herunterladen, akzeptiere die Nutzungsbedingungen und wähle die Umgebung, in der Receive installiert werden soll.
- AppSource installiert AutoFlow Receive und – falls noch nicht vorhanden – AutoFlow und AutoFlow Core gleich mit. Die Installation läuft im Hintergrund und kann einige Minuten dauern.
Hast du mehrere Umgebungen, zum Beispiel eine Sandbox und eine Produktivumgebung, installierst du AutoFlow Receive in jeder Umgebung, in der du es nutzen willst.
Business Central on-premises
-
Die
.app-Datei von AutoFlow Receive für deine Business-Central-Version bekommst du von der mse Software GmbH. -
Installiere zuerst AutoFlow und AutoFlow Core, wie unter AutoFlow installieren beschrieben.
-
Öffne auf dem Server eine Business Central Administration Shell (PowerShell). Veröffentliche, synchronisiere und installiere AutoFlow Receive in jedem Mandanten, in dem du es nutzen willst:
Publish-NAVApp -ServerInstance <DeineInstanz> -Path "<Pfad>\AutoFlow Receive.app" -PackageType Extension -SkipVerification
Sync-NAVApp -ServerInstance <DeineInstanz> -Name "AutoFlow Receive" -Version <Version> -Tenant <MandantenId>
Install-NAVApp -ServerInstance <DeineInstanz> -Name "AutoFlow Receive" -Version <Version> -Tenant <MandantenId>
Bei einer Installation mit nur einem Mandanten ersetzt du <MandantenId> durch default.
Nach der Installation
- Die Karte Eingehender Beleg zeigt sofort die neuen Felder, die Rechnungszeilen und die PDF-Vorschau – siehe Der eingehende Beleg.
- In jedem Mandanten wird die Anlagenrolle E-DOC (Elektronischer Beleg) angelegt. Eigene Rollen legst du auf der Seite Anlagenrollen an.
- Die Verarbeitungsaktionen am eingehenden Beleg erscheinen, sobald auf ihrem Trigger ein Flow veröffentlicht ist – siehe Verarbeitungsaktionen.
Berechtigungssätze
| Berechtigungssatz | Für wen | Was er erlaubt |
|---|---|---|
| mse365 AF-RC ALL (mse365 AutoFlow Receive - Alle) | alle, die eingehende Belege bearbeiten | die Rechnungszeilen, die Anlagenrollen und alles Weitere, was Receive mitbringt |
Weise mse365 AF-RC ALL zusätzlich zu den Business-Central-Rechten zu, die deine Kreditorenbuchhaltung für eingehende Belege und Einkaufsrechnungen ohnehin hat. Wer die Verarbeitungs-Flows baut oder veröffentlicht, braucht außerdem die AutoFlow-Rollen – siehe Berechtigungssätze in der AutoFlow-Dokumentation.
Die Schritte für Zuordnungsregeln (Belegregeln anwenden, Zeilenregeln anwenden) funktionieren auch, wenn der Flow für jemanden läuft, der mse365 AF-RC ALL nicht hat – etwa für eine Kollegin, deren Aktion den Flow gestartet hat. Andere Schritte, die die Rechnungszeilen lesen oder ändern (Datensätze finden, For-Each-Schleife, Datensatz ändern oder ein SmartField wie {{line.Description}}), laufen mit den eigenen Rechten dieser Person; dafür braucht sie mse365 AF-RC ALL.
Netzwerkanforderungen
Dieser Abschnitt betrifft dich nur, wenn dein Business Central Server über einen Proxy oder einen Egress-Filter ins Internet geht. Bei Business Central Online ist nichts zu tun.
Einige Flow-Schritte, die Receive mitbringt, rufen einen mse-Dienst auf. Schränkt deine Firewall ausgehenden Verkehr ein, gib diese Hosts frei (HTTPS, TCP 443):
| Host | Genutzt von | Wenn gesperrt |
|---|---|---|
api.mse365-services.net | E-Beleg validieren, und ZUGFeRD-XML extrahieren, wenn Business Central das PDF nicht selbst lesen kann (unter Business Central 24 immer) | Der Schritt schlägt fehl, der Flow meldet den Fehler |
pdf-tools.autoflow365.app | E-Beleg visualisieren – erzeugt aus einer reinen XML-Rechnung ein PDF | Der Schritt schlägt fehl, der Flow meldet den Fehler |
Welche Hosts AutoFlow selbst braucht, steht unter Netzwerkanforderungen in der AutoFlow-Dokumentation.