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

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

Cette section décrit les prérequis pour utiliser le connecteur.

2.1 Prérequis techniques

L’intégration est compatible avec les installations EBP on-premise, y compris EBP hébergé sur le serveur de votre intégrateur (souvent appelé « cloud »), à condition que l’accès serveur et SQL puisse être accordé. L’offre cloud SaaS propre à EBP n’est pas prise en charge.

Pris en charge ✅	Non pris en charge ❌
• EBP Comptabilité (Compta) on-premise, gammes Pro et PME, à partir de la version 21.0 • EBP hébergé sur le serveur ou la VM d’un intégrateur, si l’accès serveur et SQL peut être accordé	• Offre cloud SaaS EBP • Versions EBP inférieures à 21.0

La version exacte est confirmée lors de la phase de déploiement avec votre intégrateur EBP et l’équipe technique Agicap.

2.2 Organisation du déploiement & prérequis d’installation

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 EBP : Installation du service IO Manager. Ce service est unique par client et son installation fait partie de l’onboarding projet.

2.3 Prérequis d’installation

Environnement EBP

Paramètres régionaux Windows : la culture Windows doit être définie sur fr-FR avant l’installation de la base EBP sur le serveur.
Instance SQL : toutes les sociétés EBP d’un même projet doivent être hébergées sur la même instance SQL. Si vos sociétés sont réparties sur plusieurs instances SQL, un projet par instance est requis.
Modèle de base de données : une base SQL = une société EBP = une entité Agicap.
Comptabilité auxiliaire : non requise. Sans comptabilité auxiliaire, le connecteur lit les comptes généraux à la place des comptes tiers.
Avant la connexion : supprimez les données de démonstration (fictives) de votre compte Agicap, afin qu’elles ne soient pas mélangées avec les données synchronisées depuis EBP.

Accès au service iO

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.
Droits sur les dossiers : le compte du service iO doit avoir les droits de lecture et d’écriture sur 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. : les relevés bancaires ne sont plus déposés).

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 de comptabilité 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 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 d’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 des logiciels SaaS et des 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 d’Agicap en temps réel juste après chaque récupération de données 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 ou 08:30 ou 10:00 ou 10:30…)
- API Publique : Pour les documents métiers 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 ne fait que transmettre via la plateforme IO Manager.
Pour chaque intégration, une connexion identifiable est créée dans Agicap (en tant qu’intégration de flux de trésorerie ou intégration 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 œuvre : 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 (une base SQL = une société EBP = une entité Agicap).
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 non payé, et non au montant total de la facture.
Les opérations pré-lettrées dans EBP 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 phase de test final.

Nom	Statut	Type de flux	Description	Limitations
Emission PA (France uniquement)	🔴 Non disponible
Réception PA (France uniquement)	🔴 Non disponible
[OBSOLETE] Importer uniquement les opérations engagées dans Agicap	🔴 Non disponible	ERP → Agicap	Alimenter TRY avec les opérations engagées	OBSOLETE : flux OpenAPI historique, remplacé par « Importer les documents métiers dans Agicap » (API Publique). Ne pas utiliser pour de nouvelles connexions. Cette page sera supprimée une fois toutes les connexions migrées.
Exporter le rapprochement dans l’ERP via le journal de banque	🔴 Non disponible
Exporter les prévisions depuis Agicap	🔴 Non disponible	Agicap → ERP
Importer les documents métiers dans Agicap	🟢 Disponible	ERP → Agicap	Alimenter TRY avec les opérations engagées, AR avec les factures à payer et à relancer + avoirs	API Publique : ne récupère que les journaux d’achats et de ventes 1. Seules les écritures lettrées de l’exercice en cours et des 6 derniers mois de l’exercice précédent répondant aux critères ci-dessus sont synchronisées 2. Seuls les AN des 4 exercices précédents peuvent être récupérés (les documents originaux de l’exercice en cours + si liés à un AN jusqu’à 4 ans) ⚠️ Non disponible si EBP Cloud, sauf si hébergé chez l’intégrateur (dans ce cas, il est traité comme on-premise).
Exporter les factures fournisseurs depuis Agicap	🔴 Non disponible	Agicap → ERP	Cas d’usage pour PDP à préciser (pour les ERP français)
Importer la base clients & contacts dans Agicap	🔴 Non disponible	ERP → Agicap	Alimenter le module AR d’Agicap avec les données clients de l’ERP pour éviter les mises à jour manuelles dans Agicap
Exporter le journal des achats d’Agicap vers l’ERP	🔴 Non disponible	Agicap → ERP	Exploiter Agicap SIM OCR pour digitaliser les factures fournisseurs et les créer dans le journal des achats avec le PDF associé
Exporter les relances depuis Agicap AR	🔴 Non disponible	Agicap → ERP
Importer les bénéficiaires dans Agicap	🔴 Non disponible	ERP → Agicap	Alimentez la liste des bénéficiaires Agicap dans le module de paiement pour éviter d'avoir à les créer/mettre à jour manuellement. + besoin de sécurité : éviter les erreurs ou modifications frauduleuses dans Agicap
Importer le plan comptable / codes tiers dans Agicap	🔴 Non disponible	ERP → Agicap
Exporter le journal des achats depuis Agicap	🔴 Non disponible	Agicap → ERP	Automatiser la création des écritures de journal de banque dans l’ERP pour les opérations réalisées avec le module de gestion des dépenses dans Agicap
Exporter les relevés bancaires d’Agicap vers l’ERP	🔴 Non disponible	Agicap → ERP	Automatiser la synchronisation du plan comptable et des comptes tiers entre l’ERP et Agicap
Exporter le financement intragroupe depuis Agicap	🔴 Non disponible	Agicap → ERP
Exporter les placements financiers depuis Agicap	🔴 Non disponible	Agicap → ERP
Importer des fichiers de paiement dans Agicap	🔴 Non disponible	ERP → Agicap	Tirer parti de la connectivité bancaire d’Agicap pour automatiser le processus de paiement et offrir une meilleure sécurité
Exporter la dette depuis Agicap	🔴 Non disponible	Agicap → ERP
Exporter le journal de banque sans automatisation du rapprochement TRY vers l’ERP	🔴 Non disponible	Agicap → ERP	Tirer parti du module de rapprochement et de journal de banque d’Agicap pour automatiser la création du journal de banque + auto rapprochement des factures clients/fournisseurs
Exporter les bons de commande fournisseurs (AP) depuis Agicap	🔴 Non disponible	Agicap → ERP	Cas d’usage pour PDP à préciser (pour les ERP français)

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

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 que certains comptes ou journaux ?

Lors de la mise en place, l’équipe technique peut définir 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 engagée dans Treasury impactée par un paiement partiel sera affichée directement avec son montant restant.

Besoin d’aide ou de plus d’informations ?

Contactez votre support Agicap.