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 Obligatoires pour toute connexion

Catégorie	Exigence	Comment vérifier
Édition NetSuite	Oracle NetSuite OneWorld uniquement	Une option Subsidiary Settings Manager est disponible sous l'onglet Setup.
Fonctionnalité `Subsidiaries`	Doit être activée	Nécessaire pour télécharger et installer l'Agicap SuiteApp depuis la marketplace NetSuite. Si elle est désactivée, la SuiteApp ne peut pas être installée.
Rôle utilisateur	L'utilisateur effectuant la configuration doit avoir un rôle Administrateur	Setup > Users/Roles > Manage Users
Fonctionnalités du compte	`REST WEB SERVICES`, `OAUTH 2.0`, `SuiteAnalytics Workbook`	Setup > Company > Enable Features (voir A, étape 2)
Agicap SuiteApp	Agicap for NetSuite installée	Elle crée le `AgicapIntegrationRole` dédié et prend en charge l'authentification OAuth 2.0 M2M.

🔒 Nous recommandons d'utiliser un utilisateur dédié à l'intégration plutôt qu'un compte personnel. Il s'agit d'une recommandation, pas d'une obligation : un compte personnel fonctionne si vous le préférez. La raison de cette recommandation est que l'authentification par certificat est liée à un utilisateur NetSuite et à un rôle, donc la connexion cesse de fonctionner si cette personne quitte l'entreprise ou si ses droits sont supprimés.

2.2 Prérequis supplémentaires par flux

Flux	SuiteApp supplémentaire	Configuration NetSuite supplémentaire
Import de fichier de paiement	SFTP Connector (obligatoire) Electronic Bank Payments (bundle ID 416781) si vous ne générez pas déjà de fichiers de paiement	Deux dossiers File Cabinet, une clé privée RSA 2048 au format PEM, et vos comptes bancaires configurés pour l'exécution des paiements dans Agicap.
Export de relevé bancaire	Auto Bank Statement Import (ABSI)	`Client SuiteScript` et `Server SuiteScript` activés, une clé privée RSA 2048 au format PEM, et un format de relevé bancaire pris en charge par un parseur NetSuite.

2.3 Qui fait quoi

Étape	Responsable
Installation des SuiteApps, activation des fonctionnalités du compte, attribution du rôle	Votre administrateur NetSuite / utilisateur avancé
Remplir le formulaire de connexion dans Agicap (ID du compte, certificat, ID du certificat)	Vous, guidé par ce document
Faire le mapping de vos filiales NetSuite avec vos entités Agicap, et valider la connexion	Agicap — cette étape est de notre côté et est requise avant tout flux de données
Activation de chaque flux sur votre connexion	Vous, depuis la page Banques & Intégrations une fois la connexion créée. Chaque flux dispose de son propre bouton d'activation dans les détails de synchronisation de la connexion.
Configuration des flux SFTP dans NetSuite (ABSI, SFTP Connector, parseurs)	Votre administrateur NetSuite. Le côté Agicap de ces flux est configuré par notre équipe technique, donc prévoyez un point avec eux avant de commencer.

3. Informations générales

Le connecteur Agicap NetSuite est une intégration bidirectionnelle développée et maintenue en interne par Agicap. Il utilise les API REST et endpoints SuiteQL de NetSuite, sécurisés par une authentification par certificat OAuth 2.0 machine-to-machine, pour importer vos documents métiers et données comptables dans Agicap, et pour écrire les relevés bancaires, écritures de paiement et journaux dans NetSuite.

Un connecteur, une SuiteApp. Chaque flux est une fonctionnalité optionnelle activée sur votre connexion : vous pouvez commencer par la collecte de documents métiers uniquement et ajouter des flux plus tard, sur la même connexion, sans avoir à refaire la configuration.

Mécanisme	Utilisé pour	Ce que vous installez dans NetSuite
REST API + SuiteQL (OAuth 2.0 M2M)	Documents métiers, plan comptable et tiers, plan analytique, codes taxes, export journal de banque, export journal des achats	SuiteApp Agicap for NetSuite — c'est tout. Elle crée le `AgicapIntegrationRole` dédié et embarque tout ce dont le connecteur a besoin.
SFTP (serveur hébergé par Agicap)	Import de fichiers de paiement, export de relevés bancaires	SuiteApp SFTP Connector (sortant), SuiteApp Auto Bank Statement Import (ABSI) (entrant)

Fréquence de synchronisation

Le flux de documents métiers se synchronise automatiquement deux fois par jour. Les autres flux API se synchronisent une fois par jour. Tous peuvent être déclenchés manuellement.
La plupart des appels API filtrent sur la date de modification de l'enregistrement, donc seuls les éléments modifiés sont transférés.
Les flux SFTP s'exécutent selon le planning que vous configurez dans NetSuite, couplé à celui configuré côté Agicap.
Une connexion identifiable est créée par compte NetSuite.

💡 Par défaut, Agicap collecte les documents métiers dont la date de modification NetSuite est inférieure à un an au moment de la création de la connexion. Un document émis plus tôt peut tout de même apparaître s'il a été modifié récemment dans NetSuite. Si vous avez besoin d'un historique plus long, prévenez-nous avant la première synchronisation.

4. Flux & cas d'usage

4.1 NetSuite → Agicap

Flux	Statut	Transport	Alimente
Import de documents métiers	En production avec limitations	REST API	Treasury, Accounts Receivable, purchase-to-pay
Import du plan comptable et des tiers	En bêta	REST API	Association, journal de banque
Import du plan analytique	En production	REST API	Treasury, et les écritures qu'Agicap réécrit
Import des codes taxes	En production	REST API	Gestion de la TVA sur les documents exportés par Agicap, et prérequis pour le journal des achats
Import des bons de commande avec lignes (P2P)	En production	REST API	Paiements, purchase-to-pay
Import de fichiers de paiement	En production avec limitations (via SFTP)	SFTP	Paiements
Import des fournisseurs	En bêta	REST API	purchase-to-pay, base tiers
Import des bénéficiaires / IBAN	En bêta	REST API	Paiements
Import des PDF AR	Prévu	REST API	Accounts Receivable
Import de la base clients et des contacts	Prévu	REST API	Accounts Receivable

4.2 Agicap → NetSuite

Flux	Statut	Transport	Écrit dans NetSuite
Export de relevés bancaires	En production avec limitations (via SFTP)	SFTP + ABSI	Écritures de relevés bancaires pour rapprochement et reporting financier
Export du journal de banque depuis Treasury, écritures de journal	En bêta	REST API	Écritures de journal, pour les mouvements bancaires sans document métier associé et pour les contreparties manuelles
Export du journal de banque depuis Treasury, association de factures	En bêta	REST API	Paiements clients et fournisseurs associés à vos factures clients / fournisseurs ouvertes. NetSuite génère l'écriture de journal à partir du paiement lui-même.
Export des factures fournisseurs, journal des achats	Prévu	REST API	Factures fournisseurs, avec le PDF de la facture en pièce jointe. NetSuite générera les écritures de journal à partir de celles-ci. Non activable pour le moment.
Émission et réception de factures électroniques (France)	Prévu	—	—
Export du journal de banque Spend, écritures transitoires, dette, financement intragroupe, relances clients, placements financiers, prévisions	Non disponible	—	Non couvert actuellement. Dites-le-nous si l'un de ces sujets vous intéresse.

📘 Lecture des statuts. En production signifie déployé et utilisé sur plusieurs comptes clients. En production avec limitations signifie disponible, avec une limitation décrite au §5 et dans le tableau des limitations. (via SFTP) signifie que le flux n'est pas porté par le connecteur API : le fichier est produit ou consommé dans NetSuite via des SuiteApps dédiées et échangé via un serveur SFTP hébergé par Agicap. En bêta signifie disponible, en déploiement progressif, et encore en amélioration — l'activation se fait au cas par cas avec votre contact Agicap. Prévu signifie sur la feuille de route et non activable pour le moment. Non disponible signifie aucun engagement à ce jour.

5. Documentation technique détaillée par cas d'usage

5.1 Import de documents métiers (NetSuite → Agicap)

Ce que cela fait. Alimente Agicap Treasury avec les mouvements de trésorerie engagés, Agicap Accounts Receivable avec les factures à encaisser et à relancer, et le flux purchase-to-pay avec vos commandes et bons de livraison.

Comment. Agicap interroge l'API REST NetSuite et les endpoints SuiteQL. Les appels filtrent sur la date de modification de l'enregistrement pour ne transférer que ce qui a changé, et seuls les champs nécessaires à Agicap sont récupérés.

Ce qui est collecté — une synchronisation, tous les types de documents ensemble :

Factures clients et avoirs clients
Factures fournisseurs et avoirs fournisseurs
Bons de commande clients, et bons de commande fournisseurs avec leurs lignes
Bons de livraison
Devis
Référentiels : devises, filiales, entités, clients, fournisseurs, moyens de paiement

Entity ici fait référence à l'enregistrement d'entité NetSuite (clients, fournisseurs et autres entités NetSuite). Cela n'a rien à voir avec une entité Agicap, qui est mappée à vos filiales NetSuite.

Il n'y a pas d'option par type de document : le flux de documents métiers collecte tous les types. Ce qui diffère, c'est l'endroit où chaque type apparaît dans Agicap, ce qui dépend des modules Agicap actifs sur votre compte, ainsi que des filtres activés pour chaque module.

Toujours actif. L'import de documents métiers est activé par défaut sur chaque connexion NetSuite et ne peut pas être désactivé. Les autres flux sont optionnels et activés un par un.

⚠️ Limitation connue — volumes élevés. Les connexions avec un très grand volume de documents commerciaux, ou fonctionnant sur une instance NetSuite limitée, peuvent rencontrer des erreurs de timeout lors de la synchronisation. Les documents cessent alors d’être mis à jour dans Agicap jusqu’à la prochaine exécution réussie. Nos équipes travaillent activement sur ce sujet. Si cela se produit, gardez la connexion API en place et contactez le Support Agicap en indiquant le nom de la connexion et le message d’erreur affiché dans les détails de synchronisation.

Optionnel — champs personnalisés. Vous pouvez demander à Agicap de collecter les champs personnalisés NetSuite et de les utiliser pour construire le libellé de vos documents commerciaux dans Treasury et Accounts Receivable, ou demander un filtre spécifique. En cliquant sur le libellé d’un champ dans NetSuite, vous affichez son identifiant interne, par exemple custbody_phy_patient_name. Cela fonctionne pour les champs au niveau en-tête d’un document d’opération ; les champs au niveau des lignes ne sont pas couverts. Déclarez les champs nécessaires lors de la création de la connexion (voir B, étape 5) — les ajouter plus tard nécessite de renouveler les identifiants de connexion.

5.1.1 Importer les bons de commande avec lignes (NetSuite → Agicap)

Ce que cela fait. Importe vos bons de commande NetSuite, ligne par ligne, dans le flux purchase-to-pay d’Agicap afin que les factures fournisseurs puissent être associées à leur commande.

La collecte elle-même fait partie de la synchronisation des documents commerciaux (§5.1). Ce flux ajoute l’exposition de ces commandes dans le module Accounts Payable d’Agicap, ce qui nécessite que le module correspondant soit actif sur votre compte — informez votre contact Agicap si vous attendez de voir les bons de commande ici et qu’ils n’apparaissent pas.

5.2 Importer le plan comptable et les tiers (NetSuite → Agicap)

Ce que cela fait. Maintient vos comptes comptables et tiers synchronisés afin que vous n’ayez jamais à gérer ces listes manuellement dans Agicap.

Comptes comptables. Agicap récupère la liste complète des comptes depuis NetSuite (ID interne, intitulé, numéro, type, affectation à la filiale) et rattache chaque compte aux entités Agicap concernées via la cartographie multi-entités configurée lors du paramétrage.

Exclus de l’import : les comptes sans numéro de compte et les comptes de type NonPosting.

Tiers. Les clients et fournisseurs sont importés dans le modèle de tiers Agicap avec leur nom, code, compte comptable lié et ID interne NetSuite.

💡 Si les listes de sélection de comptes dans Agicap vous semblent encombrées, désactiver les comptes qui n’ont jamais eu de mouvement, par filiale, est le moyen le plus rapide de les épurer.

5.3 Importer le plan analytique et les codes taxes (NetSuite → Agicap)

Ce que cela fait. Importe vos dimensions analytiques NetSuite afin que les flux de trésorerie puissent être analysés par axe dans Agicap, et que ces mêmes dimensions puissent être reprises sur les écritures qu’Agicap envoie dans NetSuite.

Synchronisé : class, department, location et vos segments personnalisés.

Les codes taxes sont importés via le même mécanisme et alimentent la gestion de la TVA sur les documents exportés par Agicap.

👀 Segments personnalisés. Pour importer des segments personnalisés, le rôle AgicapIntegrationRole (ou votre rôle personnalisé) doit avoir la permission de lecture sur chaque segment concerné. Vérifiez cela avec votre administrateur NetSuite.

5.4 Importer les fichiers de paiement (NetSuite → Agicap, via SFTP)

Ce que cela fait. Vos fichiers de paiement, générés dans NetSuite, sont exportés vers un serveur SFTP hébergé par Agicap et alimentent le module Payment d’Agicap. Vous exécutez ensuite les paiements via la connectivité bancaire d’Agicap, ce qui vous offre un point unique d’exécution et de contrôle.

❗ Ce flux n’est pas géré par le connecteur API. Vous générez vous-même le fichier de paiement dans NetSuite, dans un format supporté par NetSuite, et la SuiteApp SFTP Connector l’envoie. Paramétrage en C.

Ce dont vous avez besoin

Vous savez déjà comment générer des fichiers de paiement dans NetSuite, ou vous installez la SuiteApp Electronic Bank Payments (bundle ID 416781).
La SuiteApp SFTP Connector.
Chaque compte bancaire référencé dans ces fichiers est configuré dans Agicap pour l’exécution des paiements : host-to-host, EBICS TS, banque centralisatrice ou export global de fichier.

Où le fichier arrive dans Agicap. Si le format du fichier est accepté par la banque pour ce compte, il peut être importé soit comme À payer, soit comme À préparer. Si le format n’est pas accepté par la banque, il est importé comme À préparer afin qu’Agicap Payment puisse le convertir dans un format accepté par la banque.

5.5 Exporter les relevés bancaires (Agicap → NetSuite, via SFTP)

Ce que cela fait. Agicap récupère vos relevés bancaires via sa propre connectivité bancaire (EBICS, H2H, SWIFT), puis les envoie vers un serveur SFTP. La SuiteApp ABSI les récupère et les importe dans NetSuite, où ils sont analysés et rapprochés avec vos comptes GL pour le rapprochement et le reporting financier.

Cela signifie que vous n’avez plus à maintenir une connexion bancaire séparée côté NetSuite : un seul paramétrage bancaire dans Agicap sert aux deux outils.

⚠️ Le format de fichier est la principale contrainte, vérifiez-le dès le début. NetSuite prend en charge une liste fixe de formats et de versions de relevés. Par exemple, CAMT.053.001.02 est supporté par défaut, alors que CAMT.053.001.08 ne l’est pas. Approche recommandée : demandez à votre banque de fournir les relevés dans un format et une version supportés par NetSuite. C’est la solution la plus simple et la plus robuste. Si cela n’est pas possible : une transformation personnalisée du fichier peut être réalisée par Agicap et est évaluée au cas par cas. Ces transformations sont livrées en version bêta, sur la base du meilleur effort, et font l’objet d’un accord écrit avant mise en œuvre.

Paramétrage en D.

5.6 Exporter le journal de banque et le rapprochement automatique (Agicap → NetSuite)

Ce que cela fait. Vous rapprochez les mouvements bancaires avec les factures dans Agicap. Agicap écrit ensuite le résultat dans NetSuite, de sorte que votre journal de banque et vos éléments AR/AP ouverts sont mis à jour sans ressaisie manuelle.

Comment cela fonctionne. Deux mécanismes, selon ce qui a été rapproché :

Cas	Ce qu’Agicap écrit dans NetSuite
Un mouvement bancaire rapproché avec un document commercial	Un objet paiement — un paiement client ou un paiement fournisseur. NetSuite génère alors lui-même l’écriture comptable, selon vos propres règles de comptabilité. C’est le même mécanisme que le flux manuel « Effectuer un paiement » dans NetSuite.
Un mouvement bancaire sans document commercial associé, ou des contreparties manuelles ajoutées à un mouvement bancaire rapproché.	L’opération bancaire est écrite directement comme une écriture de journal.

Statut : En bêta.

Prérequis.

Le flux de plan comptable (§5.2) doit être actif, afin que les comptes soient reconnus des deux côtés.
Les fonctionnalités journal de banque et rapprochement doivent être actives sur votre compte Agicap, avec l’option export manuel désactivée. Le Support Agicap active ces paramètres pour vous : contactez-les avant d’activer ce flux.

💡 Le champ Causale du journal de banque Agicap n’a pas d’équivalent dans NetSuite, il n’est donc pas mappé. Ce n’est pas bloquant : l’export fonctionne sans.

Paiements couvrant plusieurs tiers. NetSuite exige que chaque paiement client référence un seul tiers. Lorsqu’un paiement bancaire règle des factures appartenant à plusieurs tiers NetSuite, Agicap le divise automatiquement en un paiement par tiers. Les lignes sans tiers identifiable sont exportées directement comme une écriture de journal distincte.

⚠️ Deux points à préparer de votre côté. Dédupliquez vos fournisseurs et clients dans NetSuite. Un paiement doit référencer la facture et le tiers de façon cohérente. Deux fiches pour la même société peuvent entraîner le rejet de l’export. Les factures fournisseurs créées dans Agicap, et non dans NetSuite, ne peuvent pas encore être rapprochées automatiquement par ce flux : le connecteur recherche une référence côté NetSuite qui n’existe pas sur ces factures. Un support natif est prévu. Si c’est votre cas, discutez des options provisoires avec votre contact Agicap.

5.7 Importer les fournisseurs et bénéficiaires (NetSuite → Agicap)

Statut : En bêta. Deux flux distincts, même paramétrage : rien de plus que A et B, plus leur activation.

Importer les fournisseurs alimente la base fournisseurs d’Accounts Payable et le flux purchase-to-pay avec les données fournisseurs issues de NetSuite.
Importer les bénéficiaires / IBANs alimente la liste des bénéficiaires du module Payment, afin que vous n’ayez pas à la gérer manuellement dans Agicap.

Si ce flux fait partie de votre projet, discutez du périmètre et du calendrier avec votre contact Agicap plutôt que de planifier à partir de cette page.

5.8 Exporter les factures fournisseurs, journal des achats (Agicap → NetSuite)

Statut : Prévu. Le développement est en cours et le flux ne peut pas encore être activé.

Ce qu’il fera. Les factures fournisseurs numérisées par Agicap (OCR) sont créées dans NetSuite comme vendor bills, avec le PDF de la facture attaché à l’enregistrement. NetSuite génère ensuite lui-même les écritures comptables à partir de ces factures, de sorte que votre journal des achats est alimenté sans ressaisie.

Si ce flux fait partie de votre projet, discutez du périmètre et du calendrier avec votre contact Agicap plutôt que de planifier à partir de cette page.

Procédure de paramétrage

🧭 Ordre des opérations. A et B sont obligatoires pour chaque flux API et doivent être complétés avant l’activation de tout flux. C et D sont les flux SFTP : ils sont indépendants et peuvent être préparés en parallèle. Prévoyez environ 30 minutes avec votre administrateur NetSuite pour A et B.

A - Paramétrage NetSuite

Étape 1 — Installer la SuiteApp Agicap

Commencez ici : une installation réussie prouve que votre édition NetSuite est compatible.

Cliquez sur les trois points en haut à droite, puis SuiteApps.
Recherchez Agicap for NetSuite (barre de recherche en haut à gauche) et cliquez sur Installer.
Vérifiez l’installation : Personnalisation → SuiteCloud Development → Liste des SuiteApps installées. Vous devriez voir l’enregistrement AgicapSuiteApp.

⚠️ Si la SuiteApp ne peut pas être installée, vérifiez que la fonctionnalité Subsidiaries est activée. Sur un compte non-OneWorld, elle n’est pas disponible et le connecteur API ne peut pas être utilisé — il faudra alors passer à l’alternative SFTP.

Étape 2 — Activer les fonctionnalités requises du compte

Allez dans Setup → Company → Enable Features. La plupart sont généralement déjà activées, mais vérifiez bien ces trois-là :

Fonctionnalité	Sous-onglet → section	Pourquoi c’est nécessaire
`REST WEB SERVICES`	SuiteCloud → SuiteTalk (Web Services)	Tous les appels de lecture et d'écriture d'enregistrements
`OAUTH 2.0`	SuiteCloud → Gérer l'authentification	Authentification machine à machine
`SuiteAnalytics Workbook`	Analytics → SuiteAnalytics Workbook	Requêtes SuiteQL utilisées pour les documents commerciaux et le plan comptable

Enregistrer. L'activation d'une fonctionnalité peut prendre un moment avant d'être effective.

Étape 3 — Assigner le AgicapIntegrationRole

La SuiteApp Agicap crée un rôle dédié qui possède exactement les permissions nécessaires au connecteur, et rien de plus.

Configuration → Utilisateurs/Rôles → Gérer les utilisateurs.
Sélectionnez l'utilisateur qui portera l'intégration — nous recommandons de créer un utilisateur dédié à l'intégration — puis cliquez sur Modifier.
Dans l'onglet Accès en bas de la page, ajoutez AgicapIntegrationRole.
Cliquez sur Ajouter, puis sur Enregistrer.

🔒 Le rôle est maintenu par Agicap et livré avec la SuiteApp. Lorsqu'un nouveau flux ou un correctif nécessite une permission supplémentaire, nous mettons à jour le rôle et il est propagé avec la version de la SuiteApp : aucune reconnexion ni nouveau certificat n'est nécessaire de votre côté. Si votre politique de sécurité l'exige, vous pouvez remplacer le rôle standard par un rôle personnalisé dédié à votre compte, limité à vos équipes. Signalez-le à votre contact Agicap avant l'appel de configuration. Une conséquence à connaître avant de faire ce choix : un rôle personnalisé ne reçoit pas les mises à jour automatiques de permissions ci-dessus. Lorsqu'un nouveau flux ou un correctif nécessite une permission, votre connexion peut passer en erreur jusqu'à ce que votre équipe l'ajoute manuellement.

B - Formulaire de connexion Agicap

Dans Agicap, ouvrez Banques & Intégrations et recherchez NetSuite. Le formulaire de connexion s'ouvre. Gardez un onglet NetSuite ouvert à côté : vous ferez deux allers-retours.

Étape 1 — ID du compte

Votre ID de compte NetSuite est visible soit directement dans l'URL de votre session NetSuite, soit dans Configuration → Société → Informations sur la société.

Étape 2 — Télécharger la clé publique Agicap

Agicap s'authentifie avec un flux OAuth 2.0 client credentials basé sur un certificat. Agicap génère le certificat ; vous l'importez dans NetSuite.

Dans le formulaire de connexion, cliquez sur Télécharger la clé publique et gardez le fichier à portée de main.

Étape 3 — Créer l'intégration M2M dans NetSuite

Dans NetSuite, allez dans Configuration → Intégration → Configuration OAuth 2.0 Client Credentials (M2M).
Créez une nouvelle correspondance de client credentials entre :
1. l'entité, c'est-à-dire l'utilisateur NetSuite de l'étape 3 de la partie A,
2. le rôle AgicapIntegrationRole,
3. l'application Agicap SuiteApp,

et importez le certificat que vous avez téléchargé à l'étape 2.

Enregistrez.

Étape 4 — Copier l'ID du certificat dans Agicap

Copiez l'ID du certificat que vous venez de créer et collez-le dans le champ ID du certificat du formulaire Agicap.

👀 La liste des certificats NetSuite n'est pas triée par date de création. Si vous avez créé plusieurs certificats, assurez-vous de prendre le plus récent. Vérifiez l'utilisateur et le rôle liés au certificat pour confirmer.

Étape 5 — Optionnel : déclarer les champs personnalisés à collecter

Si vous souhaitez qu'Agicap construise les libellés des documents commerciaux à partir de champs personnalisés NetSuite, déclarez ici leurs identifiants internes, lors de la connexion. Cliquer sur un libellé de champ dans NetSuite révèle son identifiant interne, par exemple custbody_phy_patient_name. Uniquement les champs au niveau de l'en-tête sur les documents de transaction.

Pour ajouter des champs personnalisés après la mise en service de la connexion :

Ouvrez la connexion dans Banques & Intégrations → Gérer la connexion → Renouveler l'autorisation et complétez le flux.
La connexion repasse en statut Configuration en cours : le Support Agicap doit la valider à nouveau avant que les synchronisations ne reprennent.
Une fois la synchronisation rétablie, contactez le Support Agicap avec le type de document commercial et le module où le libellé doit être construit.

⚠️ Dès que vous cliquez sur Renouveler l'autorisation ou Modifier les identifiants, une nouvelle clé publique est générée et les anciennes données d'authentification sont supprimées. Vous devez aller au bout du flux, sinon toutes les synchronisations suivantes échoueront. Si cela arrive, recommencez simplement le flux jusqu'au bout.

Étape 6 — Agicap valide la connexion

Après avoir soumis le formulaire, la connexion apparaît dans Banques & Intégrations avec le statut Configuration en cours. Agicap effectue alors la correspondance multi-entités entre vos filiales NetSuite et vos entités Agicap, puis valide la connexion.

⚠️ Cette correspondance ne peut plus être modifiée une fois validée. Veuillez vérifier votre liste de filiales avec votre contact Agicap avant qu'elle ne soit enregistrée. Corriger une erreur implique de supprimer la connexion et de la recréer depuis le début.

Les filiales inactives n'ont pas besoin d'être sélectionnées : le connecteur les ignore.

Tant que la connexion est en Configuration en cours, aucun flux de données n'a lieu. C'est normal.

Étape 7 — Vérifier la première synchronisation

La connexion a quitté le statut Configuration en cours

La chronologie de synchronisation affiche une exécution terminée

Vos documents apparaissent dans Treasury et Accounts Receivable, pour au moins une entité

Les montants et devises correspondent à ce que vous voyez dans NetSuite

La synchronisation automatique s'exécute ensuite deux fois par jour pour les documents commerciaux et une fois par jour pour les autres flux, et peut être lancée manuellement à tout moment.

💡 Sur un grand compte, la toute première synchronisation peut prendre nettement plus de temps que les synchronisations quotidiennes, car elle collecte l'historique par fenêtres successives. Si elle semble bloquée, contactez votre interlocuteur Agicap plutôt que de recréer la connexion.

C - Fichiers de paiement via SFTP (NetSuite → Agicap)

📌 Commencez par demander à votre contact Agicap de mettre en place le transfert de fichiers. L'URL du serveur, le port, l'identifiant et la clé d'hôte vous seront fournis, et la configuration NetSuite ci-dessous ne peut être complétée sans eux.

Étape 1 — Préparer la clé SSH

⚠️ Contraintes de format de clé. Le connecteur SFTP NetSuite accepte les clés RSA, ECDSA et DSA, et la clé privée doit être au format PEM. Les serveurs Agicap acceptent RSA et EdDSA. Le choix sûr est une clé RSA 2048 dont la clé privée est au format PEM. L'export OpenSSH de WinSCP ci-dessous permet de produire ce fichier, il ne s'agit pas d'un format différent.

Générez une paire de clés RSA 2048 bits, par exemple avec le générateur de clés WinSCP.
Assurez-vous que le fichier de clé privée commence par -----BEGIN RSA PRIVATE KEY-----. Sinon, convertissez-le : WinSCP → Outils → Convertir le fichier de clé → chargez la clé privée → Exporter la clé OpenSSH. Ne cochez pas « forcer le nouveau format ».
Envoyez la clé publique à votre contact Agicap, qui provisionnera votre transfert de fichiers et vous retournera l'URL du serveur, le port, l'identifiant et la clé d'hôte.

Étape 2 — Préparer les fichiers de paiement dans NetSuite

Si vous générez déjà des fichiers de paiement dans NetSuite, rien à faire ici.

Si ce n'est pas le cas, installez la SuiteApp Electronic Bank Payments : Personnalisation → SuiteBundler → Rechercher & Installer des bundles → Liste, bundle ID 416781, puis configurez vos modèles de fichiers de paiement par banque.

💡 La génération des fichiers de paiement est un sujet de configuration NetSuite, pas Agicap. Votre intégrateur NetSuite est généralement la voie la plus rapide si vous le mettez en place pour la première fois.

Étape 3 — Créer les dossiers File Cabinet

Créez deux dossiers dans votre File Cabinet, un pour les fichiers en attente de transfert et un pour les fichiers déjà transférés. Noms suggérés :

agicap payment - processing
agicap payment - processed

Notez l'ID interne de chaque dossier, vous en aurez besoin à l'étape 5.

Étape 4 — Installer la SuiteApp SFTP Connector

Personnalisation → SuiteApps → recherchez SFTP Connector → Installer.

Étape 5 — Créer et mapper la configuration sortante

SFTP → Enregistrements SFTP → Configurations sortantes → Nouveau.
Renseignez le nom, l'URL du serveur, le port, la clé d'hôte et la méthode d'authentification, en utilisant les identifiants fournis par Agicap.
Dans le sous-onglet Outbound Mapping, saisissez les IDs internes des deux dossiers File Cabinet de l'étape 3, et le nom du dossier sur le serveur SFTP Agicap dans le champ Dossier bancaire.
Enregistrez, puis rouvrez la configuration en mode Modifier et cliquez sur Tester la connexion. Remarque : Tester la connexion ne fonctionne pas en mode Affichage.
Cliquez sur Outbound-Manual pour lancer une exportation manuelle et confirmer l'arrivée du fichier.

Étape 6 — Planifier l'export

SFTP → Enregistrements SFTP → Configurations sortantes → Afficher sur votre enregistrement.
Cliquez sur Outbound-Schedule. Une page de déploiement de script s'ouvre.
Définissez la fréquence souhaitée et Enregistrez.

💡 Si vous gérez plusieurs entités, validez la structure des dossiers et le nommage des fichiers avec votre contact Agicap avant la planification, afin que les fichiers de paiement puissent être séparés par entité à l'arrivée.

D - Relevés bancaires via SFTP et ABSI (Agicap → NetSuite)

📌 Même point de départ que C : demandez d'abord à votre contact Agicap de provisionner le transfert de fichiers. Les identifiants et la clé d'hôte vous seront fournis.

Étape 1 — Vérifiez d'abord vos formats de relevés

Avant toute configuration, listez les banques et formats de relevés concernés et confirmez que chacun est pris en charge par un parseur NetSuite. C'est souvent à cette étape que les projets bloquent. Voir l'encadré au §5.5.

Étape 2 — Droits et SuiteApp

Assurez-vous de disposer des droits Administrateur, ou des permissions ABSI spécifiques.
Installez Auto Bank Statement Import : Personnalisation → SuiteApps (ou SuiteCloud Development → SuiteApp Marketplace) → recherchez → Installer.

Étape 3 — Activer SuiteScript

Configuration → Société → Activer les fonctionnalités → sous-onglet SuiteCloud.
Sous SuiteScript, cochez Client SuiteScript et Server SuiteScript.
Enregistrez. C'est ce qui rend la page des clés privées accessible.

Étape 4 — Importer la clé privée

Configuration → Société → Préférences → Clés → Créer nouveau.
Onglet Détails : un Nom descriptif, un ID de script sans espaces ni caractères spéciaux (NetSuite le préfixe avec custkey), et une Description indiquant à quoi sert la clé et qui la maintient.
Onglet Fichiers : choisissez le fichier de clé privée. Il doit être au format PEM — voir C, étape 1 pour savoir comment en produire un.
Mot de passe : la phrase secrète utilisée lors de la génération de la clé, si applicable.
Onglet Audience, optionnel : cochez Restreindre aux employés pour limiter quels employés peuvent utiliser la clé dans SuiteScript, et utilisez Restreindre aux scripts pour la limiter à des scripts spécifiques.
Enregistrer. NetSuite valide et stocke la clé.

Étape 5 — Créer la fiche de l'établissement financier et le profil de format

❗ Créez une fiche d'établissement financier par banque, puis un profil de format par format et version de fichier. Mélanger plusieurs formats dans un même profil est la cause la plus fréquente d'échec d'import.

Configuration → Comptabilité → Établissements financiers → Liste → Nouveau.
Dans la fiche, ajoutez un Profil de format et choisissez Connectivité SFTP comme méthode.
Saisissez l'URL du serveur, l'identifiant, le mot de passe et la clé hôte fournis par Agicap. Pour un serveur Agicap, l'URL est files.agicap.com ; le port, l'identifiant et la clé hôte sont transmis avec les identifiants envoyés par votre contact.
Définissez le modèle de nom de fichier à télécharger. Validez le nom exact du fichier et le répertoire avec votre contact Agicap.

Étape 6 — Liaison des comptes

Faites correspondre les données que NetSuite va analyser avec vos comptes GL. Listez chaque compte concerné par les relevés que vous importez, et pour chaque valeur extraite par le parseur, placez cette valeur dans la première colonne et liez-la au compte GL NetSuite correspondant dans la troisième colonne.

Le format de la première colonne doit correspondre exactement à ce que produit le parseur choisi.

Étape 7 — Configurer le parseur

Format	Points de vigilance
CAMT.053	Ajoutez tous les codes d'opération qui peuvent apparaître dans les relevés que vous recevez. Un code manquant fait échouer tout l'import. Vérifiez ensuite la correspondance des balises pour chaque champ NetSuite.
MT940	Parseur standard NetSuite, suivez la documentation NetSuite.
BAI2	Parseur standard NetSuite, suivez la documentation NetSuite.
CSV	Solution de repli lorsqu'une transformation était nécessaire. Les colonnes et formats doivent correspondre exactement à la définition d'import CSV de NetSuite.

Étape 8 — Tester et activer

Demandez à Agicap de déposer d'abord un fichier correspondant sur le serveur SFTP, afin que le test soit pertinent.
Cliquez sur Soumettre, et non directement sur Enregistrer.
Si le résultat est vert, cliquez sur Enregistrer.
Cliquez sur Suivre le statut pour confirmer que le fichier a bien été récupéré et analysé.

💡 Fréquence. Le flux d'import s'exécute environ une fois par jour. Vous pouvez le déclencher manuellement en renvoyant le Profil de format, avec un minimum de 60 minutes entre deux exécutions. Rétention. NetSuite ne déplace ni ne supprime les fichiers une fois traités. La stratégie d'archivage sur le serveur SFTP est définie avec votre contact Agicap lors de la configuration, afin qu'un même relevé ne soit pas importé deux fois.

Éviter les imports en double. NetSuite doit ignorer un fichier déjà importé, mais nous recommandons l'une de ces stratégies, à valider avec votre contact Agicap :

Date dans le nom de fichier — chaque nom de fichier inclut sa date (par exemple bank_statement_2024-06-15.csv), et votre modèle de nom de fichier NetSuite accepte cette date.
Flux à deux dossiers — les fichiers sont déposés dans un dossier à traiter puis déplacés dans un dossier traité une fois la fenêtre de traitement NetSuite passée.
SuiteScript personnalisé de votre côté qui renomme ou déplace les fichiers après import.

Plusieurs banques ou formats. Chaque parseur NetSuite doit uniquement récupérer les fichiers de sa propre banque. Utilisez soit un dossier par banque (par exemple /Bank_A/, /Bank_B/), soit un seul dossier avec une convention de nommage (un préfixe ou suffixe banque dans chaque nom de fichier, par exemple BANKA_20240615.csv) et configurez chaque Profil de format pour ne prendre que son propre modèle. Un mix des deux est possible.

Comment activer chaque cas d'usage

Une fois la configuration terminée et une première collecte de documents métier effectuée, vous pouvez activer les autres flux directement sur la page Banques & intégrations > Détails de synchronisation. Chaque flux dispose de son propre interrupteur on/off. L'import des documents métier est activé par défaut et ne peut pas être désactivé.

6. Erreurs fréquentes

Erreur	Ce que vous voyez	Cause	Que faire
Délai d'attente lors de la première synchronisation	Aucune opération engagée n'apparaît dans Treasury après la première synchronisation	Trop d'historique récupéré d'un coup (par défaut, les 365 derniers jours de documents modifiés)	Contactez le Support Agicap : ils peuvent réduire la fenêtre de collecte initiale, par exemple à 90 jours.
Délai d'attente sur une connexion en cours Message dans les détails de synchronisation : `The request was canceled due to the configured HttpClient.Timeout of 300 seconds elapsing. > The operation was canceled.`	Les documents ne sont plus mis à jour dans Agicap	NetSuite a mis plus de 5 minutes à répondre à un appel API. Agicap arrête les appels après 5 minutes pour éviter que les synchronisations ne restent bloquées indéfiniment.	Relancez la synchronisation un peu plus tard. Si l'erreur persiste, contactez le Support Agicap avec le nom de la connexion et le message d'erreur. Ne supprimez ni ne remplacez la connexion.
`Aggregator error : Invalid URL: The hostname could not be parsed.`	Toutes les synchronisations échouent après modification des identifiants	Modifier les identifiants ou Renouveler l'autorisation a été lancé mais pas terminé. Une nouvelle clé publique est générée dès que vous cliquez, et les précédentes données d'authentification sont supprimées.	Refaites le parcours d'identifiants et allez jusqu'au bout (B, étapes 2 à 4).
La connexion reste en Configuration en cours	La connexion a été créée mais rien ne se synchronise	La correspondance entre vos filiales NetSuite et vos entités Agicap n'a pas encore été complétée et validée, ou une autorisation renouvelée n'a pas été revalidée	Contactez le Support Agicap : la correspondance et la validation sont faites côté Agicap (B, étape 6).
Export du journal de banque rejeté sur un tiers spécifique	Un export échoue, les autres passent	Doublon de tiers dans NetSuite, donc la référence de facture et la référence tiers ne pointent pas vers la même fiche	Dédupliquez les fournisseurs et clients dans NetSuite.
Bons de commande collectés mais non visibles dans Accounts Payable	Rien n'apparaît dans Accounts Payable après une synchronisation réussie	La fonctionnalité Agicap correspondante n'est pas activée sur votre compte	Contactez le Support Agicap pour l'activer.

Besoin d'aide ou de plus d'informations ?

Contactez votre support Agicap.

Oracle NetSuite (externe)