Allgemeines
Die Schnittstelle FNBezahlDeSales bucht Eingangszahlungen vom Konto „Bezahl.de“ auf den Endkunden um.
Hinweis: Für die Anmeldung am FibuNet-Server über die REST-Schnittstelle wird eine Benutzer-Lizenz verwendet.
Installation der Schnittstelle
Vorbereitung
Die Schnittstelle FNBezahlDeSales wird als gepacktes ZIP-Archiv geliefert.
Entpacken Sie die ZIP-Datei und kopieren Sie die Dateien in ein Verzeichnis auf dem FibuNet-Server, zum Beispiel
D:\FibuNetTools\FNBezahlDeSales. Dieses Verzeichnis ist das Stammverzeichnis dieser Instanz der Schnittstelle.
Folgende Dateien sind enthalten:
FNBezahlDeSalesSvc.exe – Der Server-Dienst mit der eigentlichen Schnittstelle.
FNBezahlDeSalesClient.exe – Das Clientprogramm zur Einrichtung und Steuerung der Schnittstelle.
FNBezahlDeSalesServerApp.exe – Alternativ zum Dienst kann die Schnittstelle auch als Applikation gestartet werden. Diese Option ist nur für Tests gedacht und sollte im Produktivbetrieb nicht genutzt werden.
ssleay32.dll – Open-SSL Implementierung für HTTPS (64-Bit)
libeay32.dll – Open-SSL Implementierung für HTTPS (64-Bit)
Installation des Dienstes
Damit der Dienst unter Windows bekannt ist, müssen Sie ihn installieren. Starten Sie dazu eine Eingabeaufforderung mit Administratorrechten und geben Sie im Stammverzeichnis der Schnittstelle folgenden Befehl ein:
FNBezahlDeSalesSvc.exe /install
Der Dienst ist jetzt installiert und kann in der Dienste-Verwaltung von Windows konfiguriert und gestartet werden.
Multiple Instanzen
In den Dienstnamen wird das Stammverzeichnis mit aufgenommen. Durch unterschiedliche Stammverzeichnisse können Sie also mehrere Instanzen der Schnittstelle auf einem System laufen lassen.
Deinstallation des Dienstes
Bevor Sie die Schnittstelle löschen oder verschieben, müssen Sie sie bei Windows deinstallieren.
Beenden Sie zunächst den Dienst in der Dienste-Verwaltung.
Starten Sie dann eine Eingabeaufforderung mit Administratorrechten und geben Sie im Stammverzeichnis der Schnittstelle folgenden Befehl ein:
FNBezahlDeSalesSvc.exe /uninstall
Die Schnittstelle wird jetzt nicht mehr in der Dienste-Liste aufgeführt.
Kommandozeilenparameter
FNBezahlDeSalesSvc kann mit folgendem Kommandozeilenparameter gestartet werden:
/Datenverzeichnis = Pfad zum Datenverzeichnis
Beispiel: FNBezahlDeSalesSvc /Datenverzeichnis=D:\FibuNetData\Clientdata
Hinweis: Im Normalfall sollte das Datenverzeichnis im Stammverzeichnis belassen werden.
Konfiguration
Starten Sie das Programm FNBezahlDeSalesClient.exe aus dem Stammverzeichnis der FNBezahlDeSales-Installation. Der Client ändert die Einstellungen in der Datei „FNBezahlDeSales.ini“ und steuert den Dienst.
Zahlungen abgleichen und umbuchen
Für Testzwecke können Sie den automatischen zeitgesteuerten Abgleich der Zahlungen stoppen und dann manuell anstoßen.
Menü „Datei/Verbindung zum Server aktualisieren“
Falls der Server-Dienst nicht gestartet oder die Verbindung gestört war, können Sie hier die Verbindung neu aufbauen.
Menü „Datei/Log Datei (Server) anzeigen“
Hier können Sie alle Log-Dateien des Servers betrachten und durchsuchen.
Menü „Datei/Einstellungen“ – Allgemein
FibuNet-Verbindung
URL des FibuNet-REST-Servers: Die URL setzt sich aus drei Komponenten zusammen:
Protokoll (
http://oderhttps://)Servername
Port
Der Port kann in der Datei FibuNet.ini auf dem FibuNet-Server eingestellt werden. Beim HTTP-Protokoll ist es meist 8181, bei HTTPS meist 9443.
Beispiel: https://Servername:9443
Hinweis: Für die Anmeldung am FibuNet-Server über die REST-Schnittstelle wird eine Benutzer-Lizenz verwendet.
Benutzer: Benutzername für die Anmeldung an FibuNet.
Kennwort: Kennwort für die Anmeldung an FibuNet.
Schaltfläche „Verbindung prüfen“: Diese Funktion prüft, ob mit den eingestellten Verbindungsdaten eine Anmeldung am FibuNet-REST-Server erfolgreich ist.
Bezahl.de-Verbindung
URL des Bezahl.de-REST-Servers: Die Bezahl.de-REST-Server sind über das Internet erreichbar.
Produktivsystem:
https://api.bezahl.de/nxt/v1/Testsystem:
https://partnerapi.staging.bezahl.de/nxt/v1/
Die allgemeine Beschreibung der Bezahl.de-Schnittstelle finden Sie unter https://docs.bezahl.de/api. Dort finden Sie auch die Zugangsdaten zur Testumgebung.
API-Authentifizierungs-Token: Für den Zugriff auf die Bezahl.de-Server benötigen Sie statt Benutzernamen und Passwort ein sogenanntes „API-Authentifizierungs-Token“. Dieses können Sie im Bezahl.de-Portal erstellen:
Rufen Sie das „Persönliche Profil“ auf.
Klicken Sie im Bereich „API-Authentifizierungs-Token“ auf „Zur Token-Übersicht“.
Erstellen Sie ein API-Token mit einer langen Gültigkeitsdauer.
Kopieren Sie das erstellte Token in die FNBezahlDeSales-Einstellungen.
Achtung: Tauschen Sie das API-Token rechtzeitig vor dem Ende des Gültigkeitszeitraumes aus. Legen Sie sich dafür einen Termin auf Wiedervorlage.
Schaltfläche „Verbindung prüfen“: Diese Funktion prüft, ob mit den eingestellten Verbindungsdaten eine Anmeldung am Bezahl.de-Server erfolgreich ist.
Menü „Datei/Einstellungen“ – Mandanten
Hier können Sie die Verbindung zwischen FibuNet-Mandant und Bezahl.de-Organisation einrichten.
Mandant: Tragen Sie hier die FibuNet-Mandantennummer ein, für die ein Zahlungsabgleich durchgeführt werden soll.
Konto f. Bezahl.de: Tragen Sie hier die Nummer des OP-geführten Kontos ein, auf dem die Einzahlungen von Bezahl.de gesammelt werden.
Mandanten-Passwort: Wenn Ihr FibuNet-Mandant mit einem Passwort geschützt ist, tragen Sie es hier ein.
Bezahl.de Organization-ID: Jede Organisation hat in Bezahl.de eine eindeutige ID. Um diese ID zu ermitteln, rufen Sie die Organisation im Bezahl.de-Portal auf. Die Organization-ID ist dann Teil der Adresszeile im Browser-Fenster.
Menü „Datei/Einstellungen“ – Automatiken
In der Schnittstelle ist ein automatisches Ereignis angelegt: der Zahlungsabgleich. Hier können Sie die Häufigkeit der Ausführung festlegen.
Menü „Datei/Einstellungen“ – Infosystem
Hier können Sie den Protokollierungsgrad der Log-Dateien einstellen. Zusätzlich können Sie einen automatischen E-Mail-Versand des Protokolls aktivieren.
Menü „Datei/Beenden“
Beendet das Clientprogramm und startet gegebenenfalls die Automatiken wieder.
Zahlungsabgleich
Der Zahlungsabgleich wird im Normalfall regelmäßig von der Automatik angestoßen. Im Testfall können Sie ihn auch im Client über die Schaltfläche „Abgleichen“ manuell starten.
Der Zahlungsabgleich läuft über alle Mandanten, die auf der Seite „Mandanten“ konfiguriert worden sind.
Vom „Konto f. Bezahl.de“ werden alle offenen Posten ausgelesen. Über die REST-API von Bezahl.de werden über den Endpunkt organization/{orgid}/paymentreportjson die Zahlungen ab 10 Tage vor dem Belegdatum der Banküberweisung abgerufen.
In diesen Zahlungen wird die Belegnummer 1 des offenen Postens als Referenz für die Suche der Zahlung im Feld „nx_id“ verwendet.
Ist für diese Zahlung ein Kunde im Feld „customer“ und eine Rechnungsnummer im Feld „invoicefields“/„no“ hinterlegt, wird die Zahlung umgebucht vom „Konto f. Bezahl.de“ auf den Kunden.
Im Feld „invoicefields“ können auch mehrere Datensätze mit Rechnungsnummern übergeben werden.