Dies ist der erste Artikel eines Leitfadens, der dich durch den Prozess der Verbindung von Moss und Microsoft Dynamics 365 Business Central SaaS / Cloud (MS BC) führt. Wenn du diesen Leitfaden Schritt für Schritt befolgst, hast du am Ende Moss erfolgreich mit MS BC verbunden.
Ziel dieses Artikels:
Dieser Artikel führt dich durch die Schritte, die du abschließen musst, bevor du Moss und MS BC verbindest. Um die Daten zwischen Moss und MS BC zu synchronisieren, musst du ein Moss Konto (Wallet), ein Moss Zahlungsausgangsbuchblatt und ein Konto für einen Standardkreditor erstellen und dem richtigen Nutzer die erforderlichen Berechtigungen geben. So kannst du dir sicher sein, dass der Datenfluss ab dem ersten Tag ohne zusätzliche Anfragen oder manuelle Korrekturen funktioniert.
Unterstützte Systeme:
Die Integration von Moss mit Microsoft Dynamics 365 Business Central (Cloud / SaaS) ist nur per API möglich. Die folgenden Systeme werden von dieser API nicht unterstützt, können aber in Kombination mit CSV-Exporten oder geplanten SFTP-Downloads verwendet werden:
Microsoft Dynamics Business Central lokal
Microsoft Dynamics Finance & Operations
Microsoft Dynamics Navision (lokale / ältere Versionen)
Checkliste (vor der Verbindung)
Richtige Nutzerberechtigungen, Zugriffsrechte und Lizenzen sicherstellen. Ein Nutzer benötigt eine aktive BC-Lizenz. Wir empfehlen zur Verbindung der API Superrechte in BC und Azure Global Admin-Rechte.
Moss Konto (Wallet) erstellen (z. B. Bankkonto) in BC
Zahlungsausgangsbuchblatt für Moss-Zahlungen erstellen (z. B. MOSS_Wallet)
"Standardkreditor" erstellen („Sammelhändler“) für Moss Kartentransaktionen ohne spezifischen Händler (z. B. MOSS DEFAULT SUPPLIER)
Autorisierungen & erforderliche Berechtigungen
Die Moss-API wird über einen bestehenden Nutzer von Microsoft Dynamics 365 Business Central autorisiert.
Detaillierte Autorisierungen und erforderliche Berechtigungen
Detaillierte Autorisierungen und erforderliche Berechtigungen
Nutzeranforderungen Business Central
Der Nutzer benötigt eine aktive Business Central Lizenz.
Die Lizenz muss so lange zugewiesen bleiben, wie die Integration genutzt wird.
⚠️ Wenn die Lizenz entfernt wird, bricht die Integration ab.
Azure AD Anwendungsfreigabe
Um die Verbindung herzustellen, muss die Moss-Anwendung in Azure Active Directory freigegeben werden.
Für diese Freigabe ist ein Azure Global Administrator erforderlich.
Wenn der Nutzer, der die Verbindung herstellt, keine Global Administrator Rechte hat, muss ein Azure Admin Folgendes tun:
Die Einwilligungsanfrage prüfen.
Die Freigabe im Azure Portal prüfen.
Die Integration kann nicht abgeschlossen werden, wenn die Freigabe nicht erteilt wurde.
Business Central Berechtigungen
Wir empfehlen, dass der Nutzer, der die API autorisiert, über SUPER-Berechtigungen in Business Central verfügt.
Dadurch werden Probleme vermieden, die durch fehlende Berechtigungen während der Einrichtung und Laufzeit verursacht werden.
Wenn du ein restriktiveres Berechtigungsmodell bevorzugst, kannst du Berechtigungen explizit zuweisen.
Verwende in diesem Fall die technische API-Dokumentation als Hilfe:
Endpunkte erforderlich
Tabellen und Vorgänge erforderlich, die von der Integration verwendet werden
Erweiterung „Upload-Berechtigung“
Die Moss-Integration lädt über die API automatisch eine Business Central Erweiterung hoch, um den Integrationsumfang zu erweitern.
Für diesen Schritt benötigt der Nutzer zusätzlich folgende Berechtigung:
TableData 5447 "API Extension Upload" = IndirectInsert
(Exclude_APIV2_)
Diese Erweiterung ist für erweiterte Integrationsfunktionen erforderlich.
Das detaillierte technische Verhalten und der Umfang sind in der technischen API-Dokumentation beschrieben.
Moss Konto (Wallet) erstellen
Um Moss-Transaktionen in Microsoft Dynamics 365 Business Central (Kreditkartentransaktionen und/oder Wallet-Zahlungen) korrekt widerzuspiegeln, musst du ein Konto erstellen, das dein Moss Wallet-Saldo repräsentiert.
Der Saldo dieses Kontos:
Erhöht sich mit Wallet-Aufladungen
Verringert sich mit Zahlungen, die von dem Moss Wallet aus getätigt werden
⚠️ Wichtiger Hinweis für Moss Credit Kunden
Wenn du Moss Credit Kunde bist und Folgendes nutzen willst:
Wallet-Zahlungen für AP-Rechnungen oder Rückerstattungen für Mitarbeiter und Moss Kreditkarten,
musst du zwei separate Konten erstellen:
Ein Konto für Wallet-Zahlungen
Ein Konto für Kreditkartenzahlungen
Der Moss Kreditrahmen wird nur für Kreditkartentransaktionen und nicht für Wallet-Zahlungen verwendet.
So erstellst du ein Moss Konto (Wallet)
So erstellst du ein Moss Konto (Wallet)
Es gibt zwei Möglichkeiten, ein Moss Wallet zu erstellen:
Moss Wallet als Bankkonto (empfohlen)
Wir empfehlen die Einrichtung des Moss Wallets in Business Central als Bankkonto.
Dies sorgt für mehr Transparenz und entspricht der üblichen Modellierung von Salden und Bargeldbewegungen.
Öffne „Suchen“ und gehe zu „Bankkonten“.
Erstelle ein neues Bankkonto und gib folgende Daten ein:
Kontonummer: Du kannst die Bankdaten des Moss Top-up Kontos verwenden.
Buchungsgruppe: Wähle eine Buchungsgruppe aus, die das Bankkonto mit dem entsprechenden Hauptkonto verknüpft.
Alternative Einrichtung: Hauptkonto
Wenn du kein Bankkonto verwenden willst, kannst du alternativ ein Hauptkonto erstellen, das deinen Moss Wallet-Saldo widerspiegelt.
Öffne „Finanzen“ und gehe zu „Kontopläne“.
Erstelle ein Bilanz-Hauptkonto.
Konfiguriere das Konto wie folgt:
Direkte Buchung: Aktiviert (für API-Nutzung erforderlich)
Abstimmungskonto: Deaktiviert
⚠️ Aktiviere das Abstimmungskonto nicht.
Moss unterstützt die Abstimmungsfunktion von Business Central nicht.
Ein neues Zahlungsausgangsbuchblatt erstellen
Um Zahlungen mit dem Moss Wallet in Business Central zu erfassen, musst du ein entsprechendes Zahlungsausgangsbuchblatt erstellen.
Moss wird:
Wallet-Zahlungen über die API direkt in diesem Zahlungsausgangsbuchblatt buchen.
Zahlungen automatisch über die Moss API-Erweiterung mit Ausgaben (z. B. Eingangsrechnungen) abgleichen, wenn das Buchblatt in Business Central verbucht wird.
So erstellst du ein neues Zahlungsausgangsbuchblatt
So erstellst du ein neues Zahlungsausgangsbuchblatt
Öffne „Cash Management“ und gehe zu „Zahlungsausgangsbuchblatt“.
Empfohlene Konfiguration
Name: Moss Wallet-Zahlungen (oder ähnlich, klar identifizierbar)
Kontotyp:
Bankkonto → wenn du das Moss Wallet als Bankkonto erstellt hast
Hauptkonto → wenn du das Moss Wallet als Hauptkonto erstellt hast
Kontonummer:
Wähle das Moss Konto (Wallet), das du im vorherigen Schritt erstellt hast+
Dieses Buchblatt wird ausschließlich für automatisierte Buchungen des Moss Wallets verwendet.
Moss Standardkreditor erstellen
Alle Moss-Kreditkartentransaktionen können in MS BC einem einzigen „Standardkreditor“ zugeordnet werden. Alternativ kannst du Transaktionen den jeweiligen Kreditorenkonten des Händlers zuordnen, den du bezahlst, oder einen hybriden Ansatz verfolgen, bei dem nur größere Transaktionen bestimmten Kreditoren zugeordnet werden, während kleinere Ausgaben dem einzigen Kreditkartenkreditor zugeordnet werden.
⚠️ Dieses Konto wird auch verwendet, um Moss-Währungsgebühren oder Bankgebühren zu verbuchen, wenn du Rechnungen und Erstattungen aus deinem Moss Wallet bezahlst.
Du kannst die Buchungsgruppe „USt Unternehmen“ für den Sammelkreditor freilassen und das USt-Szenario pro Transaktion codieren, wenn du diesen Kreditor für alle oder viele verschiedene Kreditkartentransaktionen verwenden möchtest.
Du hast die Vorbereitungen abgeschlossen.
Du bist jetzt bereit, mit der Verbindung von Moss und MSBC zu starten.