Zum Hauptinhalt springen

Kundendokumente über SFTP exportieren

Verfasst von Maxime
Diese Woche aktualisiert

Verbinden Sie den Banqup Business Space Ihrer Mandanten (aus Ihrem Partner Space) mit SFTP, um deren Dokumente und Enriched Movement Reports automatisch zu exportieren. So gelangen die Dokumente direkt in das Buchhaltungssystem, dies spart Zeit und verringert manuelle Eingaben.

Wichtig

Für die Einrichtung der SFTP-Verbindung benötigst du einen SFTP-Server. Falls Sie keinen haben, wenden Sie sich an Ihren IT-Dienstleister.

Schritt 1: Die Erweiterung installieren

  • Öffnen Sie den App-Launcher aus Ihrem Partner Space.

  • Klicken Sie auf Mehr entdecken.

  • Suchen Sie nach "SFTP".

  • Klicken Sie auf Installieren.

  • Bestätigen Sie die Zugriffsrechte.

  • Wählen Sie die zu exportierenden Dokumenttypen aus.

  • Wählen Sie das Format der exportierten Dokumente aus.

Schritt 2: Die Erweiterung konfigurieren

Geben Sie die Details des empfangenden SFTP-Servers ein:

  • Benutzername: der Benutzername des SSH-Kontos.

  • Passwort: das Passwort des SSH-Kontos.

  • Host: der Hostname oder die IP-Adresse des SFTP-Servers.

  • Port: die Portnummer, auf der der Server SFTP-Verbindungen akzeptiert.

  • Upload-Pfad: der Ordnerpfad, in den Rechnungen hochgeladen werden sollen.
    Sie können Variablen im Pfad verwenden, um die Organisation der Dokumente anzupassen.
    Für Einkaufs- und Verkaufsrechnungen:

    • [external_id] → Kundenreferenz aus der Buchhaltungssoftware (kann in Banqup pro Kunde vergeben werden, um Rechnungen korrekt zuzuordnen)

    • [uen_number] → Unternehmensnummer

    • [invoice_type] → Einkäufe oder Verkäufe

    Für erweiterte Bewegungsberichte:

    • Wie oben ([external_id], [uen_number], [invoice_type])

    • [type]→ Typ der EMR-Datei (standardmäßig „cod“)

    • [year] → Aktuelles Jahr

Beispielpfad:
/invoice_import/[external_id]_[uen_number]/[invoice_type]

Klicken Sie auf Konfiguration speichern. Danach erhalten Sie eine Bestätigung, dass die Installation erfolgreich war.

Schritt 3: IP-Whitelisting

Wenn Sie IP-Whitelisting verwenden, müssen unsere IP-Adressen in den Firewall-Einstellungen des SFTP-Servers zugelassen werden, um eine sichere Verbindung aufzubauen.

Whitelist diese IPs:

  • 18.156.159.72

  • 18.157.141.1

  • 3.127.17.114

  • 35.195.141.176

  • 34.79.110.246

  • 34.140.228.15

  • 35.187.32.127

Wenn diese nicht erlaubt sind, können wir keine Verbindung mit dem Server herstellen.

Schritt 4: Die Erweiterung für einen Kunden aktivieren

  • Gehen Sie zu Kunden.

  • Doppelklicken Sie auf einen Kunden.

  • Gehen Sie zum Reiter Integrationen.

  • Klicken Sie auf Integration hinzufügen.

  • Wählen Sie SFTP.

  • Bestätigen Sie oder passen Sie die Konfiguration aus Schritt 2 an.

  • Klicken Sie auf Weiter.

Hinweise

  • Der SFTP-Benutzer muss Schreibrechte haben.

  • Die Originaldokumente bleiben in Banqup, auch nach dem Export über SFTP.

FAQ

Entfernt die Synchronisierung mit SFTP Dokumente aus Banqup?
Nein, es werden Kopien auf dem SFTP-Server erstellt. Die Originaldokumente bleiben in Banqup.

Was passiert, wenn mein SFTP-Server vorübergehend nicht erreichbar ist?

Wenn der SFTP-Server nicht verfügbar ist, erhält das Dokument den Buchhaltungsstatus (AccountingStatus) 'Error'. Sie können es erneut senden, sobald Ihr Server wieder verfügbar ist, indem Sie zu Kundenbelege gehen > den Ordner mit dem entsprechenden Dokumenttyp öffnen (z. B. „Verkaufsrechnungen“) > auf die drei Punkte bei dem Dokument mit dem Status Error klicken > Erneut an Integrationen senden.

Kann ich historische Dokumente exportieren?

Nur Dokumente, die nach der Aktivierung der Erweiterung genehmigt oder versendet wurden, werden automatisch exportiert. Um historische Dokumente zu exportieren, können Sie jederzeit manuell die Option Erneut an Integrationen senden in den Kundenbelegen auslösen (wie in der vorherigen Frage beschrieben).

In welchem Dateiformat werden die Dokumente exportiert?

Dokumente werden standardmäßig im Format Peppol BIS 3.0 UBL exportiert. Sie können stattdessen wählen, PDF-Dokumente während der Aktivierung der Integration zu exportieren.

Hat dies Ihre Frage beantwortet?