Compatibilité

Modulr : relier le logiciel de courtage à une automatisation

L’essentiel

Modulr, le logiciel de courtage édité par ECILIA, propose une API REST, c’est-à-dire une interface, conforme aux usages courants du web, par laquelle un autre logiciel peut consulter ou modifier ses données, à condition qu’elle soit activée sur le compte du cabinet, ce qui se demande au service commercial de l’éditeur. Sa documentation détaillée se télécharge au format Swagger, norme courante de description technique de ces interfaces, depuis le panneau d’administration, une fois l’API activée. Le guide utilisateur public en expose les règles d’accès, les limites d’appels (nombre maximal de demandes autorisées), les filtres de recherche et le classement des documents.

Rédigé avec l’aide de l’intelligence artificielle, publié le 14 octobre 2026 et mis à jour le 2 novembre 2026 sous la responsabilité de , fondateur de Nodva ; sources vérifiées le 2 novembre 2026.

Notre offre destinée aux cabinets de courtage en assurance est présentée sur la page consacrée à ce métier.

À quoi sert Modulr ?

Modulr est un logiciel de gestion, de relation client et de GED (gestion électronique des documents) destiné aux intermédiaires d’assurance, qu’il s’agisse de courtiers de proximité, d’agents généraux, qui représentent une compagnie, de courtiers en ligne, de grossistes, intermédiaires qui conçoivent des contrats pour le compte des assureurs, ou de réseaux de courtage. Il gère des produits IARD (incendie, accidents et risques divers, c’est-à-dire assurances de biens et de responsabilité) et vie, à destination des particuliers comme des professionnels, et son guide utilisateur couvre la base clients, la production (la souscription des contrats), les sinistres, les documents, courriels et SMS, la comptabilité, les imports et exports, ainsi que l’extranet client.

L’éditeur décline le logiciel en trois offres selon la taille du cabinet, Modulr Start, Modulr Up et Modulr Plateforme. Les conditions d’accès à l’API ne figurent pas dans sa présentation commerciale : c’est la rubrique « API » du guide utilisateur qui les décrit.

De quel accès une automatisation dispose-t-elle ?

Règles relevées le 2 novembre 2026 dans le guide utilisateur public de Modulr (version 15.12)
ÉlémentCe que publie l’éditeur
Type d’accèsAPI REST, à faire activer sur le compte auprès du service commercial d’ECILIA
DocumentationTrois fichiers Swagger, c’est-à-dire une description technique de chaque fonction : routes (adresses de l’API) d’authentification, routes accessibles à un utilisateur, routes accessibles à un apporteur d’affaires, personne qui présente des clients au cabinet ; la documentation en ligne a été retirée avec la version 14.6
Utilisateur techniqueL’API s’active sur un utilisateur, par l’option « Utiliser les services web (API) » ; un utilisateur réservé à l’API peut être créé si une licence est disponible
Mot de passeUn mot de passe propre à l’API, affiché une seule fois lors de l’activation
Jeton de connexionCode d’identification valable une heure, à obtenir de nouveau ensuite
Limite d’appels2 000 appels par tranche de 5 minutes et par adresse IP (l’identifiant réseau de la machine qui interroge l’API), au‑delà desquels l’adresse est bloquée pendant 5 minutes

Ces fichiers Swagger, régénérés à chaque nouvelle version du logiciel, indiquent pour chaque champ s’il est obligatoire, quel est son type et s’il peut être lu, modifié ou les deux. Un prestataire peut ainsi examiner champ par champ la faisabilité d’une automatisation, pour peu que le cabinet les lui transmette avant l’établissement du devis.

Quelles données peuvent être reliées ?

Le guide public cite les fiches clients, les devis, les contrats et la GED parmi les données couramment manipulées par l’API. Ses rubriques complémentaires en précisent le fonctionnement :

Rubriques API du guide utilisateur de Modulr, consultées le 2 novembre 2026
RubriqueCe qu’elle établit
Gestion des documentsUn document se classe par une étiquette sur un client, un apporteur, une compagnie, un devis, un contrat, un sinistre ou une réclamation, et peut être rattaché à plusieurs d’entre eux
Champs personnalisésChamps propres au cabinet sur les clients, devis, contrats, sinistres, compagnies et contacts, à créer d’abord dans l’interface
RéférentielValeurs de base des listes déroulantes : état du devis (en tarification, remis, transformé en contrat), état du contrat (en cours, suspendu, résilié), périodicité, type d’affaire, motif de résiliation, raison d’un avenant (modification du contrat)
Apporteurs d’affairesRoutes distinctes de celles des utilisateurs du cabinet
Extranet clientJeton permettant au client d’accéder à son extranet sans nouvelle identification

Comment une automatisation sélectionne-t-elle les fiches utiles ?

Le guide décrit une recherche générique, valable pour tous les champs de toutes les entités, c’est-à-dire de tous les types de fiches, qui accepte plusieurs filtres combinables :

  • Les comparaisons de valeurs ou de dates, par exemple une date postérieure ou égale à un jour donné, ce qui permet de retenir les contrats dont l’échéance tombe dans une période déterminée.
  • Les listes de valeurs à inclure ou à exclure, par exemple pour écarter les contrats résiliés ou suspendus.
  • La recherche approchée sur un texte et le filtre sur les champs vides, utiles pour repérer une fiche incomplète.
  • Le tri des résultats, notamment sur la date de dernière mise à jour, qui permet de ne relire que les fiches modifiées depuis le passage précédent.

Une automatisation interroge ainsi l’API à intervalle régulier pour repérer les changements. La limite de 2 000 appels par tranche de 5 minutes laisse une marge large à un cabinet de quelques salariés, pourvu que l’automatisation respecte le blocage de 5 minutes imposé en cas de dépassement.

Que vaut-il mieux confier à Modulr lui‑même ?

Modulr couvre lui‑même plusieurs besoins courants du cabinet :

  • Les envois de courriels et de SMS depuis la fiche client, que le logiciel prend déjà en charge.
  • Le publipostage à partir des modèles et des étiquettes prévus par le guide.
  • Les imports et exports ponctuels, accessibles dans l’interface sans développement.
  • L’extranet client, intégré au logiciel.

Une automatisation extérieure trouve en revanche son utilité pour les informations qui circulent hors de Modulr, comme les pièces reçues dans une boîte de messagerie partagée, les demandes parvenues par le site, les tableaux de suivi tenus en parallèle ou un logiciel comptable. Les échanges avec les extranets des compagnies relèvent d’autres systèmes que cette API. Le conseil au client demeure de la compétence du courtier ; l’automatisation prépare les éléments qu’un collaborateur valide ensuite.

Les précautions à prendre avant un projet avec Modulr

Avant de transmettre à un prestataire l’accès à l’API de Modulr, le cabinet a intérêt à prendre les dispositions suivantes :

  • Faites activer l’API sur un utilisateur réservé à l’automatisation, afin de pouvoir la désactiver sans toucher aux comptes des collaborateurs.
  • Conservez le mot de passe de l’API dans un gestionnaire de mots de passe : l’éditeur précise qu’il ne peut pas être récupéré, seulement régénéré en désactivant puis en réactivant l’option.
  • Écartez les données de santé, notamment celles des sinistres corporels, qui relèvent d’un cadre spécifique (RGPD, article 9, et hébergement certifié HDS, propre aux données de santé) étudié séparément.
  • Faites signer au prestataire un contrat de sous-traitance des données personnelles (RGPD, article 28) avant de lui transmettre l’accès.

Aucun partenariat

Nodva n’est ni partenaire ni revendeur d’ECILIA ni de Modulr. Le nom Modulr n’est cité que pour indiquer la compatibilité d’un service avec ce logiciel (code de la propriété intellectuelle, article L713-6). Les informations de cette page proviennent du guide utilisateur public de l’éditeur, consulté le 2 novembre 2026.

Nodva conçoit des workflows reliés aux logiciels de votre cabinet. Par défaut, tout envoi destiné à l’extérieur est soumis à la validation de vos équipes, et un envoi automatique n’est mis en place qu’avec votre accord écrit. L’automatisation d’une tâche reliée à un ou deux logiciels coûte de 1 200 à 1 800 €, et le diagnostic de 30 minutes qui la précède est gratuit.

Questions reçues

Questions fréquentes

Modulr dispose-t-il d’une API ?

Oui, d’une API REST, qui doit être activée sur le compte du cabinet ; le guide renvoie pour cela au service commercial d’ECILIA. Le guide utilisateur public en décrit les règles, tandis que la documentation détaillée se télécharge au format Swagger dans le panneau d’administration.

Où se trouve la documentation de l’API de Modulr ?

Dans le logiciel, sous Panneau d’administration puis Utilisateurs, une icône apparaît sur les utilisateurs dont l’API est activée et donne accès à trois fichiers Swagger. Ces fichiers ont remplacé la documentation en ligne, retirée avec la version 14.6.

Quelle est la limite d’appels de l’API de Modulr ?

Le guide fixe la limite à 2 000 appels par tranche de 5 minutes et par adresse IP. Au‑delà, l’API renvoie une erreur 429, code qui signale un excès de demandes, et bloque l’adresse pendant 5 minutes ; l’automatisation doit donc être conçue pour respecter ce délai.

L’utilisateur API requiert-il une licence supplémentaire ?

Le guide indique que l’API s’active sur un utilisateur existant ou sur un utilisateur créé à cet effet, cette création supposant qu’une licence soit disponible. Le service commercial d’ECILIA est l’interlocuteur indiqué par le guide pour obtenir une licence supplémentaire.

Comment une automatisation repère-t-elle les contrats qui ont changé ?

Elle consulte l’API à intervalle régulier et s’appuie sur les filtres de recherche décrits par le guide, par exemple en ne retenant que les fiches dont la date de dernière mise à jour est postérieure au passage précédent.