Connectez l’Espace Business Banqup de vos clients (depuis votre Espace Partenaire) à SFTP pour exporter automatiquement leurs documents et Rapports de Mouvements Enrichis. Cette intégration permet d’envoyer directement les documents vers leur logiciel comptable, ce qui fait gagner du temps et réduit les saisies manuelles.
Important
Pour configurer la connexion SFTP, vous devez disposer d’un serveur SFTP. Si vous n’en avez pas, contactez votre prestataire informatique.
Étape 1 : Installer l’extension
Ouvrez le lanceur d’applications depuis votre Espace Partenaire.
Cliquez sur Découvrir plus.
Cherchez "SFTP".
Cliquez sur Installer.
Confirmez les autorisations d’accès.
Sélectionnez les types de documents à exporter.
Sélectionnez le format des documents exportés.
Étape 2 : Configurer l’extension
Saisissez les informations du serveur SFTP de réception :
Nom d’utilisateur : le nom d’utilisateur du compte SSH.
Mot de passe : le mot de passe du compte SSH.
Hôte : le nom d’hôte ou l’adresse IP du serveur SFTP.
Port : le numéro de port utilisé pour les connexions SFTP. Seuls les ports repris sous Ports pris en charge ci-dessous peuvent être utilisés.
Chemin de dépôt : le chemin du dossier où les factures doivent être envoyées.
Vous pouvez utiliser des variables dans le chemin pour personnaliser l’organisation des documents.
Pour les factures d'achats et de vente:[external_id]→ La référence client depuis le logiciel comptable (pouvant être définie pour chaque client dans Banqup afin d’assurer que les factures soient associées au bon client)[uen_number]→ Numéro d’entreprise[invoice_type]→ Achats ou ventes
Pour les Rapports de mouvement enrichis:
Les mêmes que ci-dessus ([uen_number], [invoice_type])
[type]→ Le format des rapports de mouvement enrichis (par défaut "cod")[year]→ L'année en cours
Exemple de chemin :
/invoice_import/[external_id]_[uen_number]/[invoice_type]
Cliquez sur Enregistrer la configuration. Vous verrez une confirmation que l’installation a réussi.
Ports pris en charge
Pour des raisons de sécurité, le connecteur SFTP ne peut se connecter qu’à un ensemble limité de ports. Cela restreint l’accès réseau nécessaire à la connexion.
Assurez-vous que le serveur SFTP de votre client utilise l’un de ces ports :
22, 822, 2016, 2122, 2222, 6222, 7822, 8022, 8080, 8443, 10101, 14052, 22007, 22008, 22122, 22222, 36987, 40022, 41222, 41667, 50622
Si le serveur utilise un autre port, la connexion ne peut pas être établie. Dans ce cas, le serveur doit être configuré pour écouter sur l’un des ports pris en charge.
Étape 3 : Configuration du serveur
Pour que l’export fonctionne, le serveur doit être configuré au niveau des droits utilisateurs et, si vous l’utilisez, de la liste blanche IP.
Droits utilisateurs
Pour que l’export SFTP fonctionne, l’utilisateur SFTP doit disposer des droits nécessaires sur le dossier vers lequel les fichiers sont envoyés.
Sur les serveurs Linux : l’utilisateur doit être propriétaire du dossier et les droits doivent être définis sur 755 (lecture, écriture et exécution pour le propriétaire ; lecture et exécution pour les autres).
Sur les serveurs Windows : l’utilisateur doit disposer des droits Modifier ou Contrôle total sur le dossier de destination.
Les fichiers envoyés via SFTP sont créés avec les droits 664 (lecture et écriture pour le propriétaire et le groupe ; lecture seule pour les autres).
Liste blanche IP
Si vous utilisez une liste blanche IP, nos adresses IP doivent être ajoutées dans le pare-feu du serveur SFTP pour établir une connexion sécurisée.
Ajoutez en liste blanche les IP suivantes :
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
Si elles ne sont pas autorisées, nous ne pourrons pas nous connecter au serveur.
Étape 4 : Activer l’extension pour un client
Allez dans Clients.
Double-cliquez sur un client.
Ouvrez l’onglet Intégrations.
Cliquez sur Ajouter une intégration.
Sélectionnez SFTP.
Confirmez ou ajustez la configuration de l’Étape 2.
Cliquez sur Continuer.
Notes
L’utilisateur SFTP doit avoir un accès en écriture.
Les documents originaux restent dans Banqup même après export vers SFTP.
FAQ
La synchronisation avec SFTP supprime-t-elle les documents de Banqup ?
Non, la synchronisation crée des copies sur le serveur SFTP. Les documents originaux restent dans Banqup.
Que se passe-t-il si mon serveur SFTP est temporairement indisponible ?
Si le serveur SFTP est indisponible, le document se retrouvera avec le statut comptable (AccountingStatus) 'Error'. Vous pouvez le renvoyer une fois que votre serveur est de nouveau disponible en allant dans Documents clients > ouvrez le dossier correspondant au type de document (ex: « Factures de vente ») > cliquez sur les trois points pour le document avec le statut Erreur > Renvoyer vers les intégrations.
Puis-je exporter des documents historiques ?
Seuls les documents approuvés ou envoyés après l'activation de l'extension seront exportés automatiquement. Pour exporter des documents historiques, vous pouvez toujours déclencher manuellement l'option Envoyer vers les intégrations dans Documents clients (comme indiqué dans la question précédente).
Dans quel format de fichier les documents sont-ils exportés ?
Les documents sont exportés au format Peppol BIS 3.0 UBL par défaut. Vous pouvez choisir d'exporter des documents PDF à la place lors de l'activation de l'intégration.