Note: This article is intended for Business Space users. If you’re an accountant, please refer instead to the article in the Integrations for Accountants section.
Connect your Banqup space with SFTP to automatically export your business documents and Enriched Movement Reports. This integration ensures your documents flow automatically to your accounting system, saving time and reducing manual entry.
Important
To set up the SFTP connection, you will need an SFTP server. If you don't have this yet, please reach out to your IT service provider.
Installing the extension
Open the app launcher.
Click Discover more.
Search for "SFTP".
Click Install.
Confirm access permissions.
Configuration details
To connect with SFTP, you'll need to provide the details of your receiving SFTP server:
Username: the username of your SSH account.
Password: the password of your SSH account.
Host: the hostname or IP address of the SFTP server.
Port: the port to which the server listens for SFTP connections.
Upload path: specify your own path where to upload the invoices.
Tip: You can use variables to customize the upload path. The following variables are available:
[external_id] → The client’s reference from the accounting package (this can be assigned to each client in Banqup to ensure invoices are mapped to the correct client in the accounting package)
[uen_number] → For the company number
[invoice_type] → For the invoice type: purchases or sales
Example of a path with variables: /Invoice_import/[external_id]_[uen_number]/[invoice_type]
Save your configurations. From now on, the documents you approve will sync automatically.
Server configuration
In order to work properly, your server needs some configuration for user rights and IP whitelisting (if you use it).
User rights
For the SFTP export to work, the SFTP user needs the right permissions on the folder where files will be sent.
On Linux servers: The user must own the folder, and its permissions must be set to 755 (read, write, and execute for the owner; read and execute for others).
On Windows servers: The user must have Modify or Full control permissions on the target folder.
Files uploaded through SFTP are created with 664 permissions (read and write for the owner and group; read-only for others).
IP whitelisting
(Only applicable if you use IP Whitelisting)
Before we can send data to your SFTP server, it's essential to whitelist our IP addresses in your network or firewall settings. This step is necessary to ensure that our system can establish a secure connection to your SFTP server.
Please add the following IP addresses, from which we will be sending the data, to your SFTP server’s whitelist:
18.156.159.72
18.157.141.1
3.127.17.114
If these addresses are not whitelisted, we will be unable to connect to your server and send the data. Once these IP addresses are whitelisted, we can proceed with establishing the connection in this guide.
FAQ
What happens if my SFTP server is temporarily unavailable?
Banqup will automatically retry syncing at regular intervals.
Does syncing with SFTP remove documents from Banqup?
No, syncing creates copies of your documents on the SFTP server. The original documents remain in your Banqup space.
Can I sync historical documents?
No, only the documents approved or sent after activating the extension will be synced.
What file format are the documents synced in?
Documents are synced in Peppol BIS 3.0 UBL format.