1. Objectifs du document

Ce document a pour objectif de détailler le fonctionnement technique et fonctionnel de notre connecteur. Il définit le périmètre d’action (ce qui est couvert ou non) et liste les prérequis nécessaires à sa mise en œuvre.

Note importante : Nos équipes sont disponibles si vous avez besoin de précisions ou d’informations complémentaires.

Comment utiliser ce document ? Nous recommandons de consulter ce document avec toutes les personnes concernées (DSI, DAF, Chef Comptable, Responsable IT), dans le but de :

Vérifier si les flux proposés correspondent à vos besoins métiers.
Confirmer que votre environnement technique répond aux prérequis d’installation.

⚠️ Méthodologie de déploiement : Notre approche se veut pragmatique. Si, après analyse, les prérequis semblent validés, nous privilégierons l’installation du connecteur natif. Cependant, si pour une raison technique ou une configuration spécifique, le connecteur ne pouvait pas être activé, nous basculerons sans problème vers une méthode alternative via SFTP afin d’assurer la continuité de votre projet.

2. Prérequis et déploiement

2.1 Prérequis techniques

Cette intégration fonctionne uniquement pour la FRANCE.

Vue d’ensemble de l’intégration Sage FRP 1000

Sage FRP 1000 est un logiciel de comptabilité d’entreprise édité par Sage. Cette intégration permet de synchroniser les données Sage FRP 1000 avec Agicap, en prenant en charge les environnements multi-entités et multi-devises, le pré-lettrage des paiements et l’automatisation avancée.

Versions de Sage FRP 1000 prises en charge

Versions prises en charge ✅	Versions non prises en charge ❌
Sage FRP 1000 v8 et supérieur, quel que soit le nommage (v8, v9R2, version 11 2025 R2, et versions ultérieures)	Versions de Sage FRP 1000 inférieures à v8

ℹ️ Sage a modifié le nommage de ses versions au fil du temps (v8, v9R2, puis « 11 2025 R2 »). Il n’y a pas de limite supérieure de version. Toute version à partir de v8 est prise en charge. La compatibilité des versions est indépendante des prérequis serveurs ci-dessous (Windows Server 2016+, .NET 4.7.2+, SQL Server 2016+ pour les documents commerciaux).

Connexion de Sage FRP 1000 avec Agicap

⚠️ Cette intégration nécessite l’installation d’un logiciel sur le serveur Sage, qui sera réalisée par l’équipe technique Agicap mais requiert l’intervention de l’IT/intégrateur/administrateur serveur.

Prérequis de votre environnement

Windows Server 2016 ou supérieur / Windows 8 ou supérieur
.NET framework 4.7.2 (ou supérieur) installé sur le serveur SQL
Accès administrateur au serveur hébergeant les bases Sage
Nom du serveur SQL et des bases Sage
(Optionnel) Utilisateur SQL pour Agicap avec accès en lecture seule
Vous devez générer une clé API (Lien vers les paramètres) ; l’équipe technique Agicap vous guidera pour cette opération
La synchronisation des documents commerciaux est prise en charge à partir de SQL Server 2016
Antivirus : exclure les dossiers C:\Program Files (x86)\Les Editions CoMPAGNoNS et C:\ProgramData\Les Editions CoMPAGNoNS (recommandé), ou au minimum ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe et updater.exe. Sinon, l’antivirus peut bloquer le service ou ses mises à jour.
Le compte de service iO doit avoir un accès en lecture et écriture à ces deux dossiers, ainsi que le droit d’exécuter msiexec.exe, utilisé pour les mises à jour du service.
Type de démarrage : le service iO (« iO Main Local Service ») doit être configuré en démarrage Automatique dans les services Windows. Sinon, il ne redémarre pas après un redémarrage du serveur et les flux s’arrêtent sans erreur (ex : relevés bancaires non déposés).

2.2 Organisation du déploiement & prérequis de mise en place

L’installation de ce connecteur est un processus collaboratif qui nécessite l’intervention de trois parties prenantes :

Vos équipes : Pour la validation des accès et la sélection des comptes à synchroniser.
Votre prestataire informatique : Pour l’ouverture des accès serveur et l’installation du composant technique.
L’équipe technique de votre entreprise : Pour la configuration, les tests de flux et la mise en service.

Pour fonctionner, il nécessite l’installation d’un agent de liaison sur votre serveur Sage (le service iO Manager). Ce service est unique par client et son installation fait partie de l’onboarding projet. Les prérequis d’installation sont listés en section 2.1 ci-dessus ; les accès base de données nécessaires à chaque flux sont décrits en section 6.

⚠️ La réunion de connexion nécessite la présence d’une personne ayant un accès administrateur à Agicap et d’une personne ayant accès à l’ERP (serveur et bases Sage FRP 1000).

3. Informations générales

Cette section décrit l’infrastructure globale qui supporte les échanges de données.

Domaine / IP	Port	Direction	Commentaires
.iomanager.app	443	Sortant	Communication sortante avec iO pour les fonctionnalités comptables et de journalisation
IP du service iO Manager : 20.19.239.7	443	Entrant	Communication entrante avec iO pour les appels métiers. Utile uniquement pour les ERP SaaS
papi.lestudio.app	443	Sortant	Passerelle API Flowwa (PAPI)
sb-papi-prod-00000001-iO.servicebus.windows.net et sb-papi-prod-00000001-iO-02.servicebus.windows.net	443	Sortant	Azure Service Bus, lien sécurisé entre iO et le service local

3.1 Flowwa

Agicap collabore avec Flowwa et sa plateforme IO Manager pour s’intégrer avec les ERP on-premise tels que Sage 100, Sage FRP 1000 et EBP (hors versions cloud). Ce partenariat permet des échanges de données fluides entre les ERP de nos clients et Agicap, en prenant en charge à la fois l’import de données métiers (ex : factures, avoirs, commandes clients) et l’export de fichiers bancaires d’Agicap vers l’ERP.

Toutes les connexions, configurations et flux de données sont mis en place et maintenus en étroite collaboration entre les équipes techniques Agicap, nos clients et Flowwa en tant qu’intégrateur.

Qu’est-ce que Flowwa ? Il s’agit d’une plateforme d’intégration de données (iPaaS) spécialisée dans l’interconnexion de logiciels SaaS et d’ERP.
Sécurité : Flowwa assure le transport sécurisé des données sans stocker de façon permanente vos données comptables sur ses serveurs, garantissant ainsi une confidentialité optimale.

3.2 Fréquence de synchronisation

Les données collectées via IO Manager sont envoyées aux API Agicap en temps réel juste après chaque récupération par l’« Agent IO Manager » :
- Open API : Pour les opérations de trésorerie engagées dans le module Treasury (synchronisées dans Agicap uniquement à chaque heure pleine ou demi-heure – ex : 08:00, 08:30, 10:00, 10:30…)
- API Publique : Pour les documents commerciaux dans le module Accounts Receivable

Les flux d’import/export sont sécurisés : Flowwa ne stocke ni ne visualise les données clients, il assure uniquement la transmission via la plateforme IO Manager.
Pour chaque intégration, une connexion identifiable est créée dans Agicap (en tant qu’intégration de trésorerie ou métier, selon le cas d’usage expliqué ci-dessous).
Dans Agicap, la connexion ne synchronise que s’il y a de nouvelles données ou des mises à jour à synchroniser.
Les horaires et la fréquence de synchronisation sont configurés lors de la mise en place : le connecteur peut synchroniser autant de fois par jour que nécessaire.

3.3 Prise en charge multi-entités et multi-devises

Le connecteur prend en charge les configurations multi-entités et multi-devises.
Agicap crée un compte par entité (société) et par devise dans le module Treasury.
Exemple : Société ALPHA (EUR), Société ALPHA (USD), Société BETA (EUR), Société BETA (USD).

3.4 Personnalisation des données et de la synchronisation

Des personnalisations peuvent être appliquées pour adapter les libellés, dates ou montants des données importées. La faisabilité est étudiée par l’équipe technique Agicap.
Les données synchronisées peuvent être filtrées selon des règles spécifiques. La faisabilité est étudiée par l’équipe technique Agicap.

3.5 Prise en charge du pré-lettrage

Le pré-lettrage est pris en charge : le montant affiché dans Agicap correspond uniquement au montant restant impayé, et non au montant total de la facture.
Les opérations pré-lettrées dans Sage FRP 1000 apparaissent dans Agicap uniquement avec leur solde ouvert (non payé).

4. Flux & cas d’usage

Voici les fonctionnalités disponibles via le connecteur. Certains flux sont marqués « Beta », ce qui signifie qu’ils sont en cours de déploiement progressif ou de test final.

Pour plus de détails techniques sur les réglages additionnels et les limitations selon les cas d’usage, voir en annexe

Remarque : Pour les fonctionnalités BETA, un délai de déploiement supplémentaire peut être nécessaire selon la complexité de votre environnement.

⚠️ Il n’est pas possible d’alimenter le module Accounts Payable d’Agicap avec une connexion Sage FRP 1000.

5. Foire aux questions (FAQ)

Peut-il y avoir plusieurs synchronisations par jour ?

Oui, les horaires et fréquences de synchronisation sont configurables lors de la mise en place ; plusieurs synchronisations quotidiennes sont possibles.

Que se passe-t-il si un client ne souhaite synchroniser que certains comptes ou journaux ?

Lors de la mise en place, l’équipe technique peut paramétrer des filtres pour inclure/exclure certains comptes et journaux filtrés.

Où puis-je voir le statut des synchronisations ?

La date de dernière synchronisation s’affiche à côté du nom de la connexion dans Banques & Intégrations. Des journaux détaillés et des informations de traçabilité peuvent être demandés au Support Agicap.

Les paiements partiels sont-ils pris en compte dans Treasury ?

Une opération saisie dans Treasury impactée par un paiement partiel sera affichée directement avec son montant restant.

Comment les PDF sont-ils synchronisés vers Sage ?

Le fichier est déposé par Flowwa dans un dossier temporaire. Le chemin du fichier est mis à jour dans Sage. Les objets métiers de Sage déplacent le fichier vers un répertoire média et créent le lien.

6. Annexes techniques

6.1 Accès base de données par flux

Flux	Accès à la base Sage FRP 1000
Imports (documents commerciaux, opérations engagées, plan comptable)	Accès SQL en lecture seule.
Fichiers de paiement	Le seul flux qui écrit dans la base de données, soit via un module signé par Flowwa (DSM, installé par votre intégrateur), soit via un script PowerShell.
Export du journal de banque	La méthode d’écriture est en cours de finalisation. Les prérequis associés vous seront communiqués avant la mise en place.

6.2 API & Sécurité

Les données sont envoyées à Agicap via des API REST sur HTTPS (chiffrement TLS).
Flowwa gère uniquement la transmission des données et ne stocke pas de façon permanente vos données comptables.
Pour les flux d’import, un utilisateur SQL en lecture seule peut être créé pour Agicap (optionnel, voir 2.1).

Besoin d’aide ou de plus d’informations ?

Contactez votre support Agicap.

Sage FRP1000