Breeze Interface for Dynamics 365 BC - de-DE

Handbuch zur Administration und Nutzung von Breeze Interface for Microsoft Dynamics 365 Business Central. Die Breeze Interface App stellt eine schlüsselfertige Schnittstelle für die Abholung von Stammdaten und Buchung von Einkaufsbelegen für DEXPRO Breeze Solutions und andere externe Workflow- bzw. ECM-Systeme bereit. Mithilfe der Interface App können XML- (JSON) basierte Daten empfangen und direkt in Dynamics 365 Business Central als Standard-Eingangsbeleg verarbeitet bzw. als Buchungssatz bereitgestellt werden.

Systemvoraussetzungen

Systemvoraussetzungen zur Nutzung von Breeze Interface for Dynamics 365 BC

Systemvoraussetzungen

Unterstützte Microsoft Dynamics 365 Business Central Versionen

Die Microsoft Dynamics 365 Business Central Integration ist auf Grund von technischen Mindestvoraussetzungen ab folgender Version möglich:

Unterstützte Microsoft Dynamics 365 Business Central Versionen

Voraussetzung zum Betrieb ist, dass die jeweilige Microsoft Dynamics 365 Business Central Version sich noch im regulären Support befindet. Der erweiterte Support (extended Support) wird ausgeschlossen.

 

Systemvoraussetzungen

Unterstützte BREEZE Versionen

Für den Anschluss von BREEZE an Microsoft Dynamics 365 Business Central und für den Betrieb wird ein lizensiertes BREEZE System benötigt.

Installation

Installation

Lizenzen

Microsoft

Informationen zu den Microsoft Business Central Lizenzen.

Squeeze Extract

Das DEXPRO Squeeze Extract System welches an Business Central angeschlossen werden soll benötigt eine gültige Kunden-Lizenz.

Installation

Bezug der DEXPRO Module

Detailliertere Informationen finden Sie hier.

OnPrem

Für OnPrem Installationen wird auf Anfrage eines registrierten Resellers / Partners ein Runtime Package mit den benötigten Apps zur Verfügung gestellt. Diese werden durch den Partner der Kundenlizenz hinzugefügt und im Anschluss in das Microsoft Dynamics Business Central eingespielt.

Cloud

Für Cloud Installationen benötigt man lediglich Zugriff auf den Microsoft AppSource. Hier werden die benötigten DEXPRO Apps heruntergeladen.

BreezeInterface_icon_appsource.png

Konfiguration & Administration

Konfiguration & Administration

Berechtigungssätze

Um die Module nutzen zu können, muss den jeweiligen Anwendern der passende Berechtigungssatz zugewiesen werden.

Folgende werden mit ausgeliefert:

Konfiguration & Administration

DEXPRO Core

Der DEXPRO Core verwaltet die einzelnen DEXPRO Apps und deren Dokumente pro Mandant.

Es werden alle Belege, welche über die unterschiedlichen DEXPRO Module in Microsoft Dynamics 365 Business Central eingelaufen und verarbeitet worden sind, angezeigt. Zur Nachvervollgung von einzelnen Belegen wird auf eine globale Nummernserie, welche über alle DEXPRO Apps genutzt wird, gesetzt. Dies bietet den Vorteil, dass die Anwender mit nur einer Nummernserie pro Beleg arbeiten.

Weitere Informationen finden sie hier.

Konfiguration & Administration

Breeze Interface Einrichtung

In der Breeze Interface Einrichtung wird die Verarbeitung innerhalb der App eingerichtet.

Start

Einrichtung kopieren

Hiermit wird die Einrichtung in andere Mandanten kopiert.

Navigation

Dokumentenklassen Einrichtung

Über diesen Menüpunkt erreichen Sie die Einrichtung für die SQUEEZE Dokumentenklassen.

Zielvorlagen Einrichtung

Über diesen Menüpunkt erreichen Sie die Zielvorlagen Einrichtung. Hier werden Zielvorlagen für das Breeze Interface verwaltet.

Generische Zusatzfelder

Über diesen Menüpunkt erreichen Sie die generischen Zusatzfelder. Hier können kundenspezifische Zusatzfelder eingerichtet werden.

Allgemein

In diesem FastTab kann man die Nutzung dieser App aktivieren/deaktivieren.

image-1677145439422.png

Nummernserie

Hier wird die Nummernserie für die Breeze Interface Belege hinterlegt.

image-1677145463110.png

Konfiguration & Administration

Dokumentenklassen Einrichtung

In der SQUEEZE Dokumentenklassen Einrichtung wird die Zuordnung zwischen der jeweiligen Dokumentenklasse und Ihrer Exportschnittstelle vorgenommen. Des Weitern wird hier die Feldzuordnung jeder Dokumentenklasse heruntergeladen und so ein Set an Standard Feldern und deren Verwendung in Microsoft Dynamics 365 Business Central hergestellt.

Die Dokumentenklassen Einrichtung ist App übergreifend und wird über den DEXPRO Core verwaltet.

Vorgang

image-1646811835555.png

Feldzuordnung herunterladen

Hiermit wird die Feldstruktur der SQUEEZE Dokumentenklasse heruntergeladen. Diese werden für die Metadaten-Zuordnung benötigt.

Navigation

image-1646811861396.png

Metadaten-Zuordnung

Über diesen Menüpunkt erreichen Sie die Metadaten-Zuordnung. In dieser wird definiert welche Felder wie an Microsoft Dynamics 365 Business Central übertragen werden sollen.

 

Liste

Dokumentenklassen

In dieser Übersicht werden alle eingerichteten Dokumentenklassen aufgelistet.

image-1671447413471.png

Karte

Dokumentenklasse

Hier wird jede Dokumentenklasse individuell eingerichtet.

Allgemein

image-1677144005353.png

In diesem Fastab wird der Name der Dokumentenklasse, der nächste Prozessschritt, sowie die automatische Anreicherung der Positionen eingerichtet.

Breeze Interface

image-1677144339201.png

Hier legt man die Standard Zielvorlage für diese Dokumentenklasse fest.

Folgende gibt es im Standard:

image-1687943322241.png

Konfiguration & Administration

Zielvorlagen Einrichtung

Hier werden Zielvorlagen für das Breeze Interface verwaltet. Im Standard sind diese Vorlagen verfügbar:

image-1687943221943.png

image-1677145077646.png

Allgemein

Hier sehen Sie welche Zielvorlage gerade bearbeitet wird.

Plausibilitätsprüfung

Hier können bestimmte Plausibilitätsprüfungen pro Zielvorlage deaktiviert werden.

Konfiguration & Administration

Generische Zusatzfelder

Hier können Kundenspezifische Felder hinzugefügt werden, welche unser Standard Template erweitern oder davon abweichen. Dieses Mapping sorgt dafür, dass diese zusätzlichen Inhalte an die richtigen Stellen zugeordnet werden.

image-1707821087292.png

Zu jedem technischen JSON Feldnamen wird das entsprechende BC Feld zugewiesen.

Konfiguration & Administration

OAuth 2.0 Einrichtung (nur für SaaS)

Der Zugriff auf Webservices in Microsoft Dynamics 365 Business Central (BC) ist in der SaaS Variante nur noch per OAuth 2.0 möglich. Die notwendige Einrichtung der App in Azure Active Directory sowie deren Verknüpfung mit BC wird im folgenden dargestellt.

Azure Portal

Azure Portal öffnen und zu Microsoft Entra ID navigieren

image-1703164621193.png

Unter App registrations eine neue App anlegen

image-1666695222272.png

image-1666695353025.png

API permissions (Berechtigungen) anlegen

Die Application (client) ID kann an dieser Stelle bereits kopiert und abgelegt werden (wird später benötigt)

image-1666698096645.png

image-1666696539153.png

image-1666696558451.png

image-1666696591385.png

Client secret anlegen und sicher ablegen

image-1666697533453.png

image-1666697558892.png

Business Central

Microsoft Entra-Anwendungen öffnen und einen neuen Eintrag anlegen

image-1666698214082.png

image-1666698320217.png

Microsoft Entra-Anwendungen einrichten
  1.  Client ID eintragen
  2. Beschreibung eintragen (Beschreibung ist etwas irreführend. Es handelt sich hier eher um einen Benutzernamen)
  3.  Benutzerberechtigungssätze individuell vergeben
  4. (Optional)
  5. Anwendung aktivieren

image-1666700870271.png

 

 

 

 

 

 

 

 

 

 

 

 

 

Konfiguration & Administration

Breeze Workflow

Um unseren Breeze Invoice Workflow an Dynamics 365 BC anzuschließen lesen Sie bitte dieses Handbuch.

 

Anwendung / Nutzung

Hier wird der Prozesses von der Bereitstellung validierter Squeeze Einkaufsbelege an externe Workflows bis zur Buchungsübergabe freigegebener Belege beschrieben.

Anwendung / Nutzung

Breeze Interface Belege

Hier werden alle Belege welche sich im Breeze Prozess befinden aufgelistet.

image-1677146997274.png

Statuswerte
Anwendung / Nutzung

Übergabe in die ungebuchten EK-Belege

Nach der Freigabe des EK-Belegs durch das Workflow System wird der Beleg an das Breeze Interface übergeben. Im Anschluss findet eine Plausibilitätsprüfung im Interface statt. Wenn die Prüfung erfolgreich war, wird ein ungebuchter EK-Beleg angelegt.

Wenn die Plausibilitätsprüfung fehlschlug, wird der Beleg auf den Status "error" gesetzt und die Fehlermeldung an der jeweiligen Stelle in der Json Struktur des Belegs angehängt. Nun wartet der Beleg wieder auf Abholung und Korrektur durch den Workflow.

image-1677150630849.png

Der ungebuchte EK-Beleg wird mit allen Daten aus der Json Struktur angelegt. Sollten Anhänge aus dem Prozess angehängt worden sein, werden auch diese mit an den ungebuchten Beleg übergeben.

image-1677149521926.png

Anwendung / Nutzung

Breeze Interface API

Hier finden Sie die Dokumentationen zu folgenden Produkten: