konfipaySync 2.0

konfipaySync 2.0 verbindet ein ERP-System, eine Finanzbuchhaltung oder eine andere Software über das Dateisystem mit konfipay. Es holt Kontoumsätze und weitere Dokumente bei konfipay ab und legt sie in einem Verzeichnis ab, aus dem die Software sie einliest. In der Gegenrichtung überträgt es Zahlungsdateien und Dokumente, die die Software in einem Verzeichnis bereitstellt, an konfipay. Eine Anpassung der Software ist dafür nicht nötig.

konfipaySync läuft als Windows-Dienst auf einem Rechner in Ihrem Unternehmen und arbeitet nach Zeitplan, ohne dass jemand angemeldet sein muss. Eingerichtet wird es über eine Oberfläche im Browser.

konfipaySync 2.0 ist der Nachfolger der Anwendung konfipay sync. Es ist eine vollständige Neuentwicklung auf Grundlage der aktuellen konfipay-API.

Was ist neu in konfipaySync 2.0?

• Aktuelle konfipay-API: konfipaySync arbeitet mit Version 6 der konfipay-API und nutzt deren zusätzliche Funktionen.

• Mehr Abrufarten: Kontoumsätze zusätzlich als camt.054 und als PDF-Kontoauszug, sonstige Dokumente nach EBICS-Auftragsart und PayPal-Transaktionen.

• Mehr Übertragungsarten: Zahlungsdateien im Format SEPA und ISO 20022 CrossBorder sowie Dokumente, die unter einer EBICS-Auftragsart bei der Bank eingereicht werden.

• Kontrolle bei Zahlungen: Jede Zahlungsdatei wird anhand ihres Inhalts wiedererkannt und nur einmal übertragen, auch wenn sie erneut im Quellverzeichnis liegt. Übertragen wird erst, wenn eine Datei vollständig geschrieben ist. Nach der Übertragung verfolgt konfipaySync den Zahlungsstatus. Auf Wunsch wird eine Zahlung nur hochgeladen und anschließend im konfipay-Portal freigegeben.

• Geprüfter API-Schlüssel: Beim Hinterlegen prüft konfipaySync, zu welchem konfipay-Account der Schlüssel gehört und ob er alle benötigten Berechtigungen hat. Fehlt eine Berechtigung oder arbeitet der Schlüssel nicht mehr, steht das auf der Übersicht.

• Sicherer Zugang: Anmeldung mit dem bestehenden konfipay-Konto einschließlich zweitem Faktor, nur für Administratoren des konfipay-Accounts. API-Schlüssel und Zugangsdaten werden verschlüsselt gespeichert. Ein Windows-Benutzerkonto mit Kennwort je Aufgabe ist nicht nötig.

• Ausführliches Protokoll: Jeder Lauf zeigt Ergebnis und Auslöser, jede verarbeitete Datei mit ihrem Ergebnis und Zahlungsstatus sowie ein Ausführungsprotokoll, das während des Laufs live mitläuft. Die Liste der Dateien lässt sich als CSV exportieren.

• Flexible Zeitpläne: mehrere Zeitpläne je Aufgabe, Intervalle mit Zeitfenster, wöchentlich, monatlich, einmalig oder als Cron-Ausdruck, jeweils mit Vorschau der nächsten Ausführungen.

• Trockenlauf: zeigt, was eine Aufgabe tun würde, ohne etwas zu übertragen, abzulegen, zu verschieben oder zu quittieren.

• Verzeichnisse prüfen: Ordnerauswahl aus Sicht des Dienstes, „Prüfen“ mit einem echten Lese- und Schreibversuch und Zugangsdaten für Netzwerkfreigaben.

• Geführte Einrichtung: Ein Assistent führt in drei Schritten durch jede Aufgabe; Vorlagen für Dateinamen und Zeitpläne decken die üblichen Fälle ab.

Systemvoraussetzungen

Installation

1. Laden Sie im konfipay-Portal unter API › konfipay sync das Installationspaket konfipaySync.msi herunter.

   

2. Starten Sie die Datei und bestätigen Sie die Rückfrage der Benutzerkontensteuerung.

3. Folgen Sie dem Installationsprogramm. Es legt das Programm unter C:\Program Files\konfipaySync ab, richtet den Windows-Dienst konfipaySync mit automatischem Start ein, startet ihn und legt im Startmenü den Eintrag konfipaySync öffnen an.

4. Klicken Sie auf Fertig stellen. Die Oberfläche öffnet sich in einem eigenen Fenster.

Die Oberfläche ist auf diesem Rechner unter http://localhost:8080 erreichbar. Über den Startmenü-Eintrag konfipaySync öffnen rufen Sie sie jederzeit wieder auf.

Anmeldung

Sie melden sich mit Ihrem bestehenden konfipay-Konto an. konfipaySync speichert Ihr Passwort zu keinem Zeitpunkt.

1. Öffnen Sie konfipaySync über den Startmenü-Eintrag konfipaySync öffnen.

2. Wählen Sie unter konfipay-Instanz das Portal, mit dem Sie arbeiten: portal.konfipay.de oder portal.konfipay.ch.

3. Geben Sie E-Mail-Adresse und Passwort ein und klicken Sie auf Anmelden. Mit E-Mail-Adresse merken steht die Adresse beim nächsten Mal schon im Feld.

4. Ist für Ihr Konto ein zweiter Faktor eingerichtet, geben Sie den sechsstelligen Code aus Ihrer E-Mail, App oder Ihrem Hardware-Token ein und klicken auf Bestätigen.

• Ist für Ihren Account die Anmeldung über Microsoft vorgeschrieben, ist eine Anmeldung an konfipaySync derzeit nicht möglich.

• Verlangt konfipay einen Passwortwechsel, nehmen Sie ihn im konfipay-Portal vor und melden sich danach erneut an.

• Nach 30 Minuten ohne Aktivität meldet konfipaySync Sie automatisch ab. Die Aufgaben laufen davon unabhängig weiter.

• Abmelden können Sie sich jederzeit über das Benutzermenü oben rechts.

API-Schlüssel hinterlegen

Die Aufgaben arbeiten mit einem API-Schlüssel Ihres konfipay-Accounts. Nach der ersten Anmeldung fordert konfipaySync deshalb den Schlüssel an; bis er hinterlegt ist, ist nur diese Seite erreichbar. Später finden Sie sie unter Einstellungen › API-Schlüssel.

1. Erstellen Sie im konfipay-Portal einen API-Schlüssel mit den Berechtigungen aus der Tabelle unten. Der Link Schlüssel im konfipay-Portal erstellen führt direkt dorthin. Wie ein Schlüssel angelegt wird, beschreibt der Artikel API-Schlüssel.

2. Fügen Sie den Schlüssel in konfipaySync ein und klicken Sie auf Prüfen und speichern.

3. konfipaySync prüft den Schlüssel gegen konfipay und zeigt den verbundenen konfipay-Account an: Accountname, Account-Kennung, Kundennummer, den Schlüssel mit seinen ersten zehn Zeichen – so, wie ihn auch das konfipay-Portal anzeigt – und den Zeitpunkt der Prüfung. Darunter stehen die Berechtigungen des Schlüssels, jede mit Haken oder Kreuz.

Der Schlüssel wird verschlüsselt gespeichert und nie wieder vollständig angezeigt. Ein Schlüssel, der zu einem anderen konfipay-Account gehört als Ihre Anmeldung, wird abgewiesen.

Benötigte Berechtigungen

konfipaySync zeigt alle Berechtigungen an, die eine seiner Aufgabenarten braucht. Fehlt eine, scheitern nur die Aufgaben, die sie benötigen: Wer keine PayPal-Transaktionen abruft, braucht die Berechtigung PayPal nicht. Fehlende Berechtigungen vergeben Sie im konfipay-Portal am Schlüssel und prüfen ihn danach mit Schlüssel erneut prüfen.

Schlüssel wechseln

Mit Schlüssel entfernen löschen Sie den hinterlegten Schlüssel aus konfipaySync; im konfipay-Portal bleibt er unverändert. Bis ein neuer Schlüssel hinterlegt ist, laufen keine Aufgaben. Danach hinterlegen Sie den neuen Schlüssel wie oben beschrieben.

Aufbau der Oberfläche

Betriebseinstellungen

Dieser Abschnitt richtet sich an die IT, die konfipaySync betreibt.

Einstellungsdatei

Die Betriebseinstellungen stehen in der Datei C:\Program Files\konfipaySync\konfipaysync.settings.json. Jede Einstellung ist dort kommentiert. Die Datei bleibt bei einer Aktualisierung erhalten. Nach einer Änderung muss der Dienst neu gestartet werden, etwa in der Dienste-Verwaltung oder in einer Eingabeaufforderung mit Administratorrechten:

net stop konfipaySync && net start konfipaySync

Zugriff von anderen Arbeitsplätzen

In der Vorgabe ist die Oberfläche nur auf dem Rechner erreichbar, auf dem konfipaySync läuft. Soll sie auch von anderen Arbeitsplätzen erreichbar sein, gehört ein Reverse Proxy mit TLS davor. Eine Adresse wie http://0.0.0.0:8080 gäbe die Oberfläche unverschlüsselt ins Netz.

Dienstkonto

Der Dienst läuft unter dem Konto LocalSystem. Auf Netzwerkfreigaben greift er damit mit dem Computerkonto des Rechners zu (DOMÄNE\RECHNERNAME$). Liegen die Austauschverzeichnisse auf einem Server in einer Windows-Domäne, kann die IT dieses Computerkonto auf der Freigabe berechtigen. Alternativ lässt sich in der Dienste-Verwaltung im Reiter Anmelden ein Domänen-Dienstkonto hinterlegen; es braucht dann Schreibrecht auf C:\ProgramData\konfipaySync\data. Mehr dazu im Artikel Verzeichnisse und Netzwerkfreigaben.

Ablageorte

Warnungen und Fehler des Dienstes stehen zusätzlich in der Windows-Ereignisanzeige unter Windows-Protokolle › Anwendung, Quelle konfipaySync.

Sichern Sie den Ordner C:\ProgramData\konfipaySync\data vollständig. Datenbank und Schlüsselring gehören zusammen: Ohne den Schlüsselring lassen sich API-Schlüssel und Zugangsdaten nicht mehr entschlüsseln und müssen neu hinterlegt werden.

Aktualisierung

Zum Aktualisieren starten Sie das Installationspaket der neuen Version. Das Installationsprogramm hält den Dienst an, ersetzt die Programmdateien und startet den Dienst wieder. Aufgaben, Zeitpläne, Protokolle, API-Schlüssel und die Einstellungsdatei bleiben erhalten. Beim ersten Start der neuen Version passt konfipaySync die Datenbank an und legt vorher eine Sicherung an.

Eine ältere Version lässt sich nicht über eine neuere installieren. Welche Version installiert ist, steht in der Fußzeile der Oberfläche.

Deinstallation

1. Öffnen Sie in Windows Einstellungen › Apps › Installierte Apps (oder in der Systemsteuerung Programme und Features).

2. Wählen Sie konfipaySync mit dem Herausgeber cisbox Group und klicken Sie auf Deinstallieren. Ist die Vorgängeranwendung noch installiert, erscheint sie dort ebenfalls unter dem Namen konfipaySync, mit dem Herausgeber windata GmbH & Co. KG.

Entfernt werden das Programm, der Dienst und der Startmenü-Eintrag. Erhalten bleiben:

• der Ordner C:\ProgramData\konfipaySync mit Datenbank, Schlüsselring und Protokolldateien – eine spätere Neuinstallation arbeitet damit weiter. Wer konfipaySync vollständig entfernen möchte, löscht den Ordner nach der Deinstallation von Hand;

• die Einstellungsdatei konfipaysync.settings.json;

• alle Verzeichnisse, mit denen die Aufgaben gearbeitet haben, samt Ihren Dateien.

Der API-Schlüssel bleibt im konfipay-Portal bestehen. Wird er nicht mehr gebraucht, deaktivieren oder löschen Sie ihn dort.

Weiterführende Seiten

• Sync-Aufgaben anlegen

• Verzeichnisse und Netzwerkfreigaben

• Dateinamen, Platzhalter und Dateimuster

• Zeitpläne

• Protokoll und Laufdetails

• Datenübernahme aus der Vorgängerversion

• Häufige Fehler und ihre Behebung