🔥 DOCUMENT À PARTAGER AVEC LES PROSPECTS :Version Google DocVersion PDF :Fichier non disponible

1. Objectifs du document

Ce document vise à 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 compétentes (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 pour assurer la continuité de votre projet.

2. Prérequis et déploiement

Sage 100 est un logiciel de comptabilité d'entreprise fourni par Sage. Cette intégration vous permet de synchroniser les données Sage 100 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 intégration ne fonctionne que pour la FRANCE et cette section décrit les prérequis pour l'utilisation du connecteur.

2.1 Prérequis techniques

L'intégration est compatible avec la majorité de l'écosystème Sage 100.

Versions supportées ✅	Partiellement supporté 🏗️	Versions non supportées ❌
• Sage 100 Comptabilité (v6 et +) • Sage 100c • Sage 100c Comptabilité • Sage 100 i7 • Sage 100 Cloud • Sage 100 Entreprise • Sage 100 Suite comptable et financière	• Sage 100 Sage Partner Cloud (SPC, hébergé sur Sage Cloud/Azure) → Bêta pour : documents commerciaux, export journal des achats, export journal de banque & fichiers de paiement (pas encore testé) → ⚠️ Prérequis : l'agent d'exécution iO doit être installé dans l'environnement SPC	• Autres produits hors suite Sage 100 • Sage 100 Gestion commerciale • Sage 100 Paie • Sage 100 Online, Sage Hébergé (cloud privé Sage) • Sage 100 Essential Comptabilité 7.00 cloud / Sage Online (pas encore disponible)

Comment vérifier votre version

Ouvrez Sage 100
Cliquez sur " ? " puis " À propos de… "

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 Sage : Installation du service IO Manager. Ce service est unique par client, et la configuration fait partie de l'onboarding du projet IO Manager. Voir Annexe pour les prérequis détaillés d'installation

3. Informations générales

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

2.1 Flowwa

Agicap collabore avec Flowwa et sa plateforme IO Manager pour s'intégrer avec des 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 (CS Tech & PKM), nos clients et Flowwa en tant que prestataire d'intégration.

Qu'est-ce que Flowwa ? C'est 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.

2.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 engagées dans le module Trésorerie (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 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 ne fait que transmettre via la plateforme IO Manager.
Dans Agicap, la connexion ne synchronisera que s'il y a de nouvelles données ou des mises à jour à synchroniser.

4. Flux & cas d'usage

Voici les fonctionnalités disponibles via le connecteur. Certains flux sont marqués "Bêta", ce qui signifie qu'ils sont en déploiement progressif ou en phase de test final.

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

Nom	Statut	Type de flux	Description	Limitations
Rapprochement automatique des factures via export journal de banque	En Bêta			Certains clients sont en production sur cette Bêta, que ce soit avec des factures importées dans le journal des achats ERP Agicap ou des factures exportées depuis l'ERP via les documents commerciaux
Emission PA	Planifié	Agicap -> ERP		SFTP pour l'instant
Réception PA	En Bêta	Agicap -> ERP
Importer uniquement les opérations engagées dans Agicap	Disponible	ERP -> Agicap	Alimente TRY avec les opérations engagées	Connexion OpenAPI : ce type de connexion est destiné à être déprécié
Exporter les bons de commande AP depuis Agicap	Non disponible	Agicap -> ERP	Cas d'usage PDP à préciser (pour les ERP français)
Exporter la dette depuis Agicap	Non disponible	Agicap -> ERP
Exporter le financement intragroupe depuis Agicap	Non disponible	Agicap -> ERP
Exporter les relevés bancaires d'Agicap vers l'ERP	Disponible	Agicap -> ERP	Automatise la synchronisation du plan comptable et des comptes tiers entre l'ERP et Agicap	Les relevés sont exportés dans un dossier sur le serveur client mais pas directement dans Sage
Importer les documents commerciaux dans Agicap	Disponible	ERP -> Agicap	Alimente TRY avec les opérations engagées, AR avec les factures à payer et à relancer + avoirs	PublicAPI : ne récupère que les journaux d'achats et de ventes1. 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ées2. Seuls les AN des 4 derniers exercices peuvent être récupérés (les documents originaux de l'exercice en cours + si liés à un AN jusqu'à 4 ans)
Exporter les relances depuis Agicap AR	Non disponible	Agicap -> ERP
Exporter les placements financiers depuis Agicap	Non disponible	Agicap -> ERP
Importer les fichiers de paiement dans Agicap	En Bêta	ERP -> Agicap	Exploite la connectivité bancaire Agicap pour automatiser le processus de paiement et offrir une meilleure sécurité	Actuellement non disponible si le client est sur Sage SPC
Importer la base clients & contacts dans Agicap	Planifié	ERP -> Agicap	Alimente 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 (incl. PDFs)	Disponible	Agicap -> ERP	Exploite l'OCR SIM Agicap pour digitaliser les factures fournisseurs et les créer dans le journal des achats avec le PDF associé	Les écritures ne peuvent être exportées que dans un seul code journal par entité
Exporter le journal de banque TRY vers l'ERP	Disponible	Agicap -> ERP	Exploite le module de rapprochement et de journal de banque Agicap pour automatiser la création du journal de banque + auto-rapprochement des factures AR/AP	Ne fonctionne pas si la “centralisation en fin de mois” est activée sur Sage 100 FR dans le paramétrage “journal de trésorerie” (une écriture de journal de banque mensuelle produite chaque fin de mois)
Exporter les factures AP depuis Agicap	Non disponible	Agicap -> ERP	Cas d'usage PDP à préciser (pour les ERP français)
Importer les bénéficiaires dans Agicap	Non disponible	ERP -> Agicap	Alimente la liste des bénéficiaires Agicap dans le module de paiement pour éviter de les créer/mettre à jour manuellement. + besoin de sécurité : éviter les erreurs ou modifications frauduleuses dans Agicap
Exporter les prévisionnels depuis Agicap	Non disponible	Agicap -> ERP
Importer le plan comptable / codes tiers dans Agicap	Disponible	ERP -> Agicap	L'import est uniquement pour TRY. Pour récupérer les données aussi dans AP, un AFT est nécessaire.
Exporter le journal de banque Spend depuis Agicap	En Bêta	Agicap -> ERP	Automatise la création des écritures de journal de banque dans l'ERP pour les opérations réalisées avec le module spend dans Agicap	1 client en production

Note : Pour les fonctionnalités BÊTA, 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 paramétrer des filtres pour inclure/exclure des comptes et filtrer les journaux.

Où puis-je voir le statut des synchronisations ?

La date de dernière synchronisation sera indiquée à côté du nom de la connexion dans l'onglet Banque & Intégration ; le statut de synchronisation, les logs et la traçabilité ne sont accessibles que par le support Agicap.

Les paiements partiels sont-ils pris en compte dans la Trésorerie ?

Une opération saisie dans Trésorerie 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 Sage déplacent le fichier dans un répertoire média et créent le lien.

6. Annexes techniques

Prérequis d'installation

Avant de procéder à la configuration de la connexion Sage 100, veuillez vérifier et valider les éléments suivants :

Système d'exploitation : Windows Server 2016 (ou supérieur) ou Windows 8 (ou supérieur).
Gestion de base de données : SQL Server Management Studio (SSMS) doit être installé sur le serveur Sage 100.
Framework : .NET Framework version 4.7.2 (ou supérieur) doit être installé sur le serveur SQL.
Version SQL Server : Version minimale 2016 (version 13.X).
Composants Sage : Le service "Sage 100 Objets Métiers" doit être installé dans votre environnement Sage 100.
Permissions : Un accès en écriture sur les données est requis pour les cas d'usage d'écriture de journal.

Notes sur l'accès au service iO

La mise en place du connecteur implique l'installation d'un service Windows qui lit et écrit dans les bases Sage 100. Vous devez vous assurer que ce service dispose des droits suffisants sur les dossiers et bases auxquels il doit accéder.

Si le service iO n'est pas exécuté sous le compte Local System, un compte Windows dédié doit être créé avec des droits de lecture/écriture sur les bases SQL Sage 100 concernées.

Ce compte doit être configuré :

Comme login SQL Server.
Sur toutes les instances SQL susceptibles d'être utilisées par les plugins s'appuyant sur Sage 100.

Si le serveur hébergeant le service iO est différent du serveur SQL :

Le compte de service doit être un compte de domaine .
Il doit disposer des autorisations appropriées sur l'instance SQL distante

Collecte & filtrage des données

Le service IO Manager interroge régulièrement l'ERP du client pour les nouvelles données ou mises à jour.
La fréquence et le planning de ces interrogations sont configurables par projet dans IO Manager.
Des filtres peuvent être appliqués pour restreindre la collecte par journaux ou comptes généraux directement dans IO Manager.
Une récupération spécifique par exercice comptable peut être paramétrée directement dans IO Manager.

Informations générales sur les flux de données, la sécurité, les champs de données

Flux de synchronisation des données

1️⃣ Une tâche planifiée démarre le service du connecteur Sage.

2️⃣ Le service interroge la base Sage pour toutes les écritures comptables non rapprochées, factures clients et fournisseurs clôturées.

3️⃣ Le service appelle l'API Agicap pour créer, supprimer ou mettre à jour les écritures selon les besoins.

Personnalisation des données et de la synchronisation

Des personnalisations Agicap peuvent être appliquées pour adapter les libellés, dates ou montants des données importées (la faisabilité doit être étudiée par l'équipe technique Agicap).

Les données synchronisées peuvent être filtrées selon des règles spécifiques (la faisabilité doit être étudiée par l'équipe technique Agicap).

API & Sécurité

API REST sur HTTPS (chiffrement TLS)
Limitation de débit : 100 requêtes/min/utilisateur ; au-delà, une erreur HTTP 429 est retournée ; l'infrastructure peut supporter 500k+ requêtes de plus de 150 utilisateurs en quelques heures
Authentification : token depuis l'interface Agicap ; utilisé dans l'autorisation API (pas dans le header)
Aucun risque d'injection SQL/code : uniquement des entrées JSON ; objets strictement formatés
Tables de base utilisées : F_ECRITUREC, F_COMPTET, F_COMPTEG, F_JOURNAUX

Support multi-entités et multi-devises

Prise en charge des configurations multi-entités et multi-devises. Agicap crée un compte par entité (société) et par devise dans le module Trésorerie.

Exemple :

Société ALPHA (EUR), Société ALPHA (USD)
Société BETA (EUR), Société BETA (USD)

Champs de données & gestion des dates

Logique de date Sage 100

Date de facturation

Combinaison : JM_date (mois/année) + EC_jour (jour)
Exemple :**F_ECRITUREC_JM_Date = 2023-11-01F_ECRITUREC_EC_Jour = 8**→ Date de facturation : 2023-11-08

Date de paiement

Si rapproché : utiliser le champ EC_Echeance
Si rapproché et EC_Echeance vide : repli sur la date de facturation (JM_date + EC_jour)
Si non rapproché : utiliser la date de facturation

Détails par cas d'usage

Exporter les fichiers bancaires vers Sage 100

Ce connecteur permet aux clients d'utiliser Agicap comme source de données pour exporter des fichiers bancaires dans leur ERP.

💡

Export automatique des fichiers bancaires collectés dans Agicap vers un dossier désigné sur votre serveur Sage 100.
Les fichiers ne seront PAS importés automatiquement dans Sage 100 ; une importation manuelle est requise.
Tout fichier bancaire disponible via l'API publique Agicap est éligible.

Pour en savoir plus sur cette fonctionnalité, consultez :

Exporter les relevés bancaires en PDF

Le client doit toujours importer manuellement le fichier exporté dans son ERP. Ce connecteur ne fait que transférer le fichier dans un dossier désigné sur le serveur du client mais ne déclenche pas l'import dans l'ERP.

Importer le plan comptable (TRY, AR)

Paramètres additionnels
- IO
  - ⚠️ vous devez renseigner la source dans l'onglet “documents commerciaux / Engagés”
  - Cochez la case “actif” sur “Comptes fournisseurs” et “Comptes généraux”

Sage FR 100