SFTP-Download konfigurieren | wiki.konfipay.de

Dieser Artikel wird zeitnah um Abbildungen ergänzt.

Im Register Herunterladen einer SFTP-Verbindung wird festgelegt, aus welchem Verzeichnis konfipay Umsatzdateien abholt und welche Dateien dabei berücksichtigt werden. Die Einstellungen werden erst wirksam, wenn das Kontrollkästchen Aktiviert gesetzt ist; ist es nicht gesetzt, werden die Felder abgeblendet und es finden keine Abrufe statt.

Einstellungen

Feld	Bedeutung
Remote-Pfad (vom Stammverzeichnis)	Verzeichnis auf dem SFTP-Server, aus dem abgeholt wird. Es wird genau dieses Verzeichnis ausgelesen; Unterverzeichnisse werden nicht durchsucht.
Dateiformate	Auswahl der erwarteten Umsatzformate: camt.052, camt.053, camt.054, MT940 und MT942. Es lassen sich mehrere Formate gleichzeitig auswählen.
Dateifilter / Muster	Bestimmt, welche Dateinamen im Verzeichnis berücksichtigt werden. Es können mehrere Muster erfasst werden; eine Datei wird abgeholt, sobald sie zu einem der Muster passt.

Dateifilter und Muster

Die Muster werden frei erfasst und folgen der üblichen Schreibweise mit Platzhaltern:

Platzhalter	Bedeutung	Beispiel
`*`	Beliebig viele Zeichen innerhalb eines Verzeichnisnamens.	`camt053_*.xml`
`?`	Genau ein beliebiges Zeichen.	`auszug_?.sta`
`**`	Beliebig viele Zeichen einschließlich Pfadtrennern.	`*/camt053.xml`

Groß- und Kleinschreibung wird nicht unterschieden. Wird kein Verzeichnis im Muster angegeben, gilt es für die Dateinamen im konfigurierten Remote-Pfad.

Dateien mit der Endung .downloaded werden immer übergangen. Einige Kreditinstitute kennzeichnen bereits abgeholte Dateien auf diese Weise, wenn der Zugang kein Verschieben oder Löschen erlaubt; ohne diese Ausnahme würden solche Dateien erneut als neu erkannt.

Verarbeitung der abgeholten Dateien

Abgeholte Dateien werden wie regulär abgerufene Kontoauszüge verarbeitet: Die enthaltenen Umsätze und Salden werden ausgewertet und stehen anschließend in den Kontoinformationen zur Verfügung. Dabei gilt:

Jede Datei wird nur einmal verarbeitet. Bleibt eine Datei auf dem Server liegen, führt das nicht zu doppelten Umsätzen.
Enthält eine Datei Umsätze zu einem Bankkonto, das im Mandanten noch nicht vorhanden ist, wird das Bankkonto angelegt und die Salden werden übernommen.
Lässt sich eine Datei nicht auswerten – etwa weil sie unvollständig ist oder nicht dem erwarteten Format entspricht –, wird die Verarbeitung mehrfach wiederholt und danach nicht mehr erneut versucht, damit nachfolgende Abrufe nicht dauerhaft blockiert werden. Die Fehlermeldungen bleiben im Kommunikationslog erhalten.

Abruf ausführen

Der Abruf erfolgt auf drei Wegen:

Planmäßig – konfipay ruft in einem festen Intervall ab, standardmäßig alle acht Stunden. Das Intervall wird in der Administration unter Automatisierung über die Regel SFTP Dateien herunterladen angepasst.
Aus der Verbindung heraus – über Download starten im Register Herunterladen einer bereits gespeicherten Verbindung.
Über den Umsatzabruf – unter Kontoinformationen > Kontoumsätze abrufen im Register SFTP. Dort lassen sich mehrere Verbindungen auswählen und über Abruf starten gemeinsam abrufen.

Für den manuellen Abruf ist die Berechtigung Download ausführen erforderlich. Der Abruf läuft im Hintergrund; das Ergebnis wird als Meldung angezeigt und im Kommunikationslog festgehalten.

Typische Rückmeldungen

Meldung	Bedeutung
Keine Dateien auf dem SFTP-Server gefunden	Im Remote-Pfad liegen keine Dateien, die zu den Mustern passen. Zu prüfen sind Pfad, Muster und Groß-/Kleinschreibung des erwarteten Dateinamens.
Keine neuen Inhalte verfügbar	Es wurden Dateien gefunden, diese waren jedoch bereits verarbeitet.
Host-Schlüssel geändert	Der Server hat einen anderen Schlüssel vorgelegt als beim ersten Verbindungsaufbau. Nach Klärung mit dem Betreiber lässt sich der gespeicherte Fingerprint in der Verbindung zurücksetzen (siehe SFTP-Verbindung einrichten).