Dieser Artikel beschreibt die grundlegende Einrichtung der collana pay App über das Assisted Setup in Business Central.
Start des Assisted Setup
Das Assisted Setup startet automatisch nach der Installation der App. Alternativ kann es jederzeit über die Suche oder über die collana pay Einrichtung im Menüband über Assisted Setup gestartet werden.
Der Setup-Prozess wird über Next gestartet.
Einrichtung der Tenant-Verbindung
Im ersten Schritt wird die Verbindung zu copal hergestellt.
Sandbox-Umgebung
- Sandbox Mode aktivieren.
- Die Tenant ID aus der copal Sandbox-Umgebung eintragen.
Live-Umgebung
- Sandbox Mode deaktivieren.
- Die Tenant ID aus der copal Live-Umgebung eintragen.
Nach Eingabe der Tenant ID werden der Name sowie der API Key automatisch geladen.
Einrichtung der Provider Accounts
Im nächsten Schritt werden vorhandene Provider Accounts aus copal geladen.
Wenn bereits Provider Accounts vorhanden sind, werden diese automatisch angezeigt.
Sollten noch keine Provider Accounts existieren, erscheint eine entsprechende Fehlermeldung. In diesem Fall müssen zunächst Provider Accounts in copal eingerichtet werden. Die Vorgehensweise ist hier beschrieben.
Einrichtung der Zahlungsmethoden
Nach der Einrichtung der Provider Accounts werden die verfügbaren Zahlungsmethoden aus copal geladen.
In der Spalte Select kann ausgewählt werden, welche Zahlarten in Business Central eingerichtet werden sollen.
Für jede ausgewählte Zahlart muss ein Code in der Spalte Payment Method Code hinterlegt werden.
Beim Klick in das Feld stehen folgende Optionen zur Verfügung:
- Auswahl eines bestehenden Zahlungsformcodes
- Anlage eines neuen Codes über Neu
Nach der Zuordnung der Codes erfolgt die Bestätigung über Next.
Konfiguration der Zahlarten
In der folgenden Übersicht können die Business Central spezifischen Einrichtungen vorgenommen werden. Diese Einstellungen können auch später über die collana pay Einrichtung vorgenommen oder verändert werden und weiterführende Erklärungen zur Einstellung sind im Artikel zur collana pay Einrichtung zu finden.
Microsoft Entra Registrierung
Im nächsten Schritt erfolgt die Registrierung der Anwendung in Microsoft Entra.
Eine Entra Anwendung muss eingerichtet werden, die es collana pay ermöglicht, Benachrichtigungen an einen Business Central Webservice zu senden.
Durch Klicken auf Zustimmung erteilen wird der Zugriff für collana pay gewährt. Dies muss von einem Entra-Administrator durchgeführt werden.
Nach der Bestätigung wird automatisch eine Authentication ID in copal erstellt und in der collana pay Einrichtung hinterlegt.
Wenn die Einrichtung später durchgeführt werden soll, kann dies in der collana pay Einrichtung unter Entra Registrierung getan werden.
Fehlerbehebung bei Kommunikationsproblemen zwischen Business Central und collana pay
In einigen Fällen kann es vorkommen, dass zusätzliche Erweiterungen oder Anwendungen in Business Central die Kommunikation zwischen collana pay und Business Central verhindern.
Wenn solche Konflikte auftreten, kann es erforderlich sein, die Benutzerberechtigungssätze in der zugehörigen Microsoft Entra Anwendungskarte anzupassen.
Welche Berechtigungssätze erforderlich sind, hängt von der jeweiligen Business Central Konfiguration sowie von installierten Erweiterungen ab.
Manuelle Einrichung der Entra Anwendung
Die automatische Einrichtung der Entra Anwendung wird empfohlen. Eine manuelle Einrichtung der Entra Anwendung ist in diesem Artikel beschrieben.
Weitere Konfigurationen sind in der collana pay Einrichtung vorzunehmen.