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

Microsoft Dynamics 365 Business Central est une solution ERP cloud destinée aux petites et moyennes entreprises. Cette intégration vous permet de synchroniser les données de Business Central avec Agicap, en prenant en charge l'import de documents métiers et les flux de données bidirectionnels.

2.1 Prérequis d'accès & identifiants

Déploiement : Business Central Online (Cloud) uniquement — les déploiements On-Premise ne sont pas pris en charge par ce connecteur.
Rôle utilisateur : L'utilisateur doit disposer des permissions administrateur sur l'environnement Business Central pour autoriser l'intégration.
Extension Business Central : L'extension Business Central requise par l'intégration doit être installée et à jour dans votre environnement (voir la page d'aide Chift ci-dessous).

Pour toute question concernant les prérequis et/ou la méthode de collecte des informations, Chift a créé une page d'aide dédiée pour chaque ERP.

2.2 Organisation du déploiement

L'activation de ce connecteur est simple : la connexion est créée et configurée par le Support Agicap sur la plateforme Chift, à l'aide des identifiants fournis par votre administrateur Business Central.

2.3 Prérequis fonctionnels

Token API Agicap : Chift se connecte à Agicap avec un token API Agicap. Un seul token suffit pour toutes vos entités. Il doit être généré par un administrateur Agicap : un administrateur d'organisation pour l'API Publique (configuration standard), ou un administrateur de l'entité connectée pour l'Open API (anciennes connexions).
Clé de taxe (code TVA) : Pour les écritures exportées vers Business Central, la clé de taxe (TaxKey) renseignée dans Agicap doit correspondre à un code TVA existant dans votre environnement Business Central (voir la FAQ pour un exemple).
Clés d'association pour l'export du journal de banque : Pour que l'export du journal de banque permette également l'association (lettrage) des factures concernées dans Business Central, ces factures doivent d'abord avoir été importées dans Agicap avec les bonnes clés d'association : le numéro de facture et la date d'échéance de la facture (format jj/mm/aaaa). Merci de vérifier cela avant la mise en place de la connexion.
Journal de banque et opérations engagées : Si vous exportez votre journal de banque via Chift, n'importez pas également vos opérations engagées (prévisions) via Chift.
Export du journal des achats : Le module Gestion des factures fournisseurs (SIM) ou Spend d'Agicap doit être activé sur l'entité.

3. Informations générales

3.1 Chift

Agicap collabore avec Chift pour s'intégrer à un large éventail d'ERP cloud et on-premise.

Qu'est-ce que Chift ? Chift développe des connecteurs vers divers logiciels métiers, tous accessibles via une API unique. Vous pouvez considérer Chift comme un « connecteur de logiciels métiers ». Agicap utilise Chift comme intégrateur pour établir des connexions avec de nombreux ERP déjà couverts par Chift, au lieu de développer un connecteur interne pour chacun.
Objectif & fonctionnement : L'intégration permet à Agicap de (i) importer en toute sécurité les documents métiers clés de l'ERP client dans les modules Agicap (Treasury, Accounts Receivable) et (ii) exporter les écritures comptables (journal des achats, journal de banque) d'Agicap vers l'ERP du client. Les fichiers de paiement et relevés bancaires ne sont pas couverts par Chift (voir le tableau des cas d'usage).
Mise en place du projet : Chaque intégration client nécessite une connexion dédiée sur la plateforme Chift. La création de la connexion et la configuration initiale sont assurées par le Support Agicap.
Sécurité : Chift agit comme une couche de transport de données sécurisée entre votre ERP et Agicap ; les données sont échangées via l'API unifiée de Chift.
Voir la liste complète des intégrations Chift.

3.2 Fréquence de synchronisation

La synchronisation des données entre Agicap et l'ERP via Chift s'effectue une fois par jour automatiquement.
Il n'existe pas de déclencheur manuel de synchronisation.
Une connexion dédiée et identifiable est créée pour chaque intégration.

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 déploiement progressif ou en phase de test final.

Nom	Statut	Type de flux	Description	Limitations
Réception PA (France uniquement)	🟡 Disponible avec limitations			si d'autres flux en plus de l'export du journal des achats sont nécessaires comme l'import de bons de commande ou de bons de réception en P2P, un SFTP est requis
Émission PA (France uniquement)	🔴 Non disponible
Auto-associer les factures dans l'ERP via l'export du journal de banque	🔵 En Beta	Agicap → ERP	Tirer parti du module d'association et du journal de banque Agicap pour automatiser la création du journal de banque + l'association automatique des factures clients/fournisseurs	Juin 2026 : l'auto-association ne fonctionne que lorsque les factures ont été préalablement importées de l'ERP dans Agicap (via les documents métiers). Les factures créées dans Agicap (non importées de l'ERP) ne seront pas auto-associées.
Exporter les prévisions depuis Agicap	🔴 Non disponible	Agicap → ERP
Exporter le financement intragroupe depuis Agicap	🔴 Non disponible	Agicap → ERP
Exporter le journal des achats d'Agicap vers l'ERP	🔵 En Beta	Agicap → ERP	Tirer parti de l'OCR SIM Agicap pour digitaliser les factures fournisseurs et les créer dans le journal des achats avec le PDF associé	Informations uniquement au niveau de l'en-tête
Exporter le journal de banque sans automatisation de l'association TRY vers l'ERP	🔵 En Beta	Agicap → ERP	Tirer parti du module d'association et du journal de banque Agicap pour automatiser la création du journal de banque
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
Importer les documents métiers dans Agicap	🔵 En Beta	ERP → Agicap	Alimenter TRY avec les opérations engagées, AR avec les factures à payer et à relancer + le PDF
Exporter les bons de commande 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 les factures fournisseurs depuis Agicap	🔴 Non disponible	Agicap → ERP	Cas d'usage pour PDP à préciser (pour les ERP français)
Importer les bénéficiaires dans Agicap	🔴 Non disponible	ERP → Agicap	Alimenter la liste des bénéficiaires dans le module de paiement Agicap pour éviter de devoir les créer/mettre à jour manuellement. + besoin de sécurité : éviter les erreurs ou modifications frauduleuses dans Agicap
Exporter les relances depuis Agicap AR	🔴 Non disponible	Agicap → ERP
Exporter les placements financiers depuis Agicap	🔴 Non disponible	Agicap → ERP
Exporter le journal de banque Spend depuis Agicap	🔵 En Beta	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 Spend d'Agicap
Exporter la dette depuis Agicap	🔴 Non disponible	Agicap → ERP
Importer le plan comptable / codes tiers dans Agicap	🔵 En Beta	ERP → Agicap
Importer les fichiers de paiement dans Agicap	🔴 Non disponible	ERP → Agicap	Tirer parti de la connectivité bancaire Agicap pour automatiser le processus de paiement et offrir une meilleure sécurité

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

4.1 Import de documents métiers : historique

Import initial : factures dont la date de facture est dans les 6 derniers mois. Lorsque l'ERP permet à Chift de ne récupérer que les enregistrements mis à jour, toutes les factures plus anciennes encore impayées sont également importées.
Mises à jour quotidiennes : dans ce cas, les factures créées ou mises à jour depuis la dernière synchronisation sont récupérées chaque jour. Sinon, Agicap relit chaque jour une fenêtre glissante de factures remontant jusqu'à 6 mois avant la date d'activation, plafonnée à 12 mois.

4.2 Options d'export pré-comptabilité (journal des achats / journal de banque)

Lorsque le flux d'export est configuré, les options suivantes sont définies avec vous :

Journal : le journal des achats ou de banque de l'entité dans Business Central.
Comptes d'attente : si un compte utilisé dans Agicap n'a pas d'équivalent dans votre plan comptable Business Central, l'écriture exportée est enregistrée dans ces comptes d'attente.
Heure de synchronisation : exprimée en UTC (ex : 06:00 UTC = 07:00 en France en hiver).
Date de début : aucune écriture datée avant cette date n'est exportée.
Option brouillon : exporte les écritures en brouillon dans l'ERP pour une relecture finale. Non recommandé : nous conseillons de relire les écritures dans Agicap à la place.
Factures sans pièce jointe : choisissez si elles sont incluses dans les écritures exportées.
Libellé de l'écriture : intitulé de l'achat, nom du fournisseur, ou les deux (recommandé).
Pièces justificatives : les reçus et factures issus de SIM ou Spend peuvent être joints aux écritures exportées. Les documents Accounts Receivable ne peuvent pas être exportés via Chift.
Les erreurs d'export, le cas échéant, sont visibles directement dans votre compte Agicap.

5. Foire aux questions (FAQ)

Business Central On-Premise est-il pris en charge ?

Non. Seul Business Central Online (Cloud) est pris en charge via ce connecteur.

Qu'est-ce qui doit être en place dans Business Central avant la connexion ?

Un utilisateur avec des permissions d'administrateur, et l'extension Business Central requise installée et à jour dans votre environnement.

Quelle clé de taxe (TaxKey) doit être saisie dans Agicap ?

La clé de taxe doit identifier un code TVA de votre environnement Business Central. Vous pouvez utiliser soit l'ID du code TVA, soit son code sans caractères spéciaux (insensible à la casse). Par exemple, pour ce code TVA dans Business Central :

{  "id": "1a2b3c4d-0000-0000-0000-000000000000",  "code": "DRITTLAND / EUST",  "label": "EK: Drittland Einfuhrumsatzsteuer",  "rate": 100}

la clé de taxe dans Agicap peut être 1a2b3c4d-0000-0000-0000-000000000000 ou DRITTLANDEUST (ou drittlandeust ).

Mes factures ne sont pas associées dans Business Central après l'export du journal de banque. Pourquoi ?

Les factures doivent avoir été importées dans Agicap avec les clés d'association attendues (numéro de facture et date d'échéance de la facture). Vérifiez que ces clés sont présentes sur les factures importées.

Sur quelle période les factures sont-elles importées ?

Jusqu'à 6 mois en fonction de la date de facture lors du premier import (ainsi que les factures impayées plus anciennes si l'ERP le permet), puis des mises à jour quotidiennes sur une fenêtre de 6 à 12 mois.

Puis-je exporter mon journal de banque et importer mes opérations engagées via Chift en même temps ?

Non. Si le journal de banque est exporté via Chift, les opérations engagées ne doivent pas être importées via Chift.

Puis-je déclencher une synchronisation manuellement ?

Non. La synchronisation s'exécute automatiquement une fois par jour, à l'heure définie lors de la configuration (en UTC).

Qui doit générer le jeton API Agicap ?

Un administrateur Agicap : un administrateur d'organisation pour l'API Publique, ou un administrateur de l'entité connectée pour l'Open API. Un seul jeton suffit pour toutes les entités.

L'export du journal des achats n'est pas disponible. Pourquoi ?

Le module Gestion des factures fournisseurs (SIM) ou Spend d'Agicap doit être activé sur l'entité.

Où puis-je voir les erreurs d'export ou d'import ?

Les erreurs sont affichées directement dans votre compte Agicap.

6. Annexes techniques

Fonctionnalités Chift utilisées par l'export du journal de banque

Synchronisation du plan comptable et des tiers : GET /chart-of-accounts , GET /clients , GET /suppliers
Création d'écritures de journal de banque : POST /journal-entries
Association automatique (lettrage) : POST /matching

Besoin d'aide ou de plus d'informations ?

Contactez votre support Agicap.

Business Central - Chift