Bei Verwendung einer dateibasierten Integration kann Perk Ihre Rechnungsexportdaten an eine SFTP-Verbindung senden, sodass Sie die Dateien programmatisch abrufen können, anstatt sie aus der Webanwendung herunterzuladen. Dieser Artikel beschreibt die Einrichtung der SFTP-Exportkonfiguration, die steuert, wie Perk exportierte Rechnungsdateien in Ihren SFTP-Ordner überträgt.
Hinweis: Neukunden können Rechnungsdaten ausschließlich per SFTP exportieren. Perk unterstützt für Neukunden keinen Datenimport (z. B. von Kostenobjekten oder Benutzern) per SFTP. Bestandskunden, die vor dem Upgrade auf Perk den SFTP-Import genutzt haben, können ihre bestehende Importkonfiguration beibehalten.
Hinweis: Bevor Sie beginnen, benötigen Sie eine aktive SFTP-Verbindung und die Ordner, in die Sie exportieren möchten, müssen bereits in Ihrem sicheren Verzeichnis erstellt sein. Richten Sie dies zuerst ein, falls Sie dies noch nicht getan haben – weitere Informationen finden Sie hier. Richten Sie eine SFTP-Verbindung ein.Wenn Sie diesen Schritt überspringen, erscheint eine Warnung und Sie können die SFTP-Exportkonfiguration nicht einrichten. Neue SFTP-Verbindungen benötigen bis zu 24 Stunden, um aktiv zu werden.
SFTP-Exportkonfiguration für Rechnungen einrichten
Die SFTP-Exportkonfiguration richten Sie für jede Rechnungs-Exportfunktion separat unter Einstellungen Integrationen Rechnungs-Export ein.
- Gehen Sie zu Einstellungen Integrationen und wählen Sie die Rechnungsexport-Karte aus.
- Öffnen Sie die Exportfunktion, die Sie konfigurieren möchten, und wechseln Sie dann zur Registerkarte Export via SFTP.
- Wählen Sie den Speicherort für die Dateien. Im Dropdown-Menü werden nur Ordner angezeigt, die auf Ihrem SFTP-Server vorhanden sind. Wenn Sie einen selbst gehosteten SFTP-Server verwenden, kann Perk den Dateipfad weder anzeigen noch bestätigen.
- Wählen Sie Ihre Exporteinstellungen (siehe Tabelle unten).
- Klicken Sie auf Weiter, um Ihre SFTP-Exportkonfiguration beizubehalten, und anschließend auf Speichern, um das Fenster zu schließen.
Perk exportiert alle für Rechnungen generierten Dateien gemäß dieser Konfiguration in den von Ihnen angegebenen SFTP-Ordner.
Tipp: Wenn Sie die Exportfunktion zum ersten Mal einrichten, speichern und aktivieren Sie die Konfiguration, bevor Sie die SFTP-Exporteinstellungen konfigurieren. Die Registerkarte Export via SFTP ist nur für dateibasierte Exportintegrationen verfügbar, nicht für API-basierte.
SFTP-Exporteinstellungen für Rechnungen
Mit diesen Einstellungen können Sie steuern, wie Perk mit Dateien in Ihrem SFTP-Ordner umgeht.
| Einstellung | Was es tut |
|---|---|
| Dateien überschreiben | Aktivieren Sie diese Option, damit Perk bei jedem neuen Export vorhandene Dateien im SFTP-Ordner überschreibt. Deaktivieren Sie sie, fügt Perk stattdessen jedem Dateinamen einen Zeitstempel hinzu, sodass vorhandene Dateien niemals überschrieben werden. |
| Windows-Kompatibilität | Aktivieren Sie diese Option, um exportierte Dateinamen mit Windows kompatibel zu machen. Perk ersetzt Doppelpunkte (:) und Punkte (.) in Dateinamen. Wir empfehlen dies, wenn Sie die exportierten Dateien in ein Windows-basiertes System importieren möchten. |
Achtung: Perk unterstützt nicht das Filtern der in Ihren SFTP-Ordner übertragenen Dateien anhand des Dateinamens mithilfe regulärer Ausdrücke. Dies kann zu einem Fehler beim SFTP-Export führen. Falls Sie diese Funktion benötigen, wenden Sie sich bitte an Perk. Kontaktieren Sie unsDie
Hinweis: Die Ordnerprüfung hängt von Ihrer Konfiguration ab. Bei von Perk gehosteten SFTP-Servern muss der Zielordner bereits existieren, bevor Sie ihn auswählen können. Bei selbst gehosteten SFTP-Servern kann Perk die Existenz des Ordners nicht im Voraus bestätigen. Überprüfen Sie daher den Pfad sorgfältig.