<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Documentation &#8226; Kafinea</title>
	<atom:link href="https://www.kafinea.com/documentation/feed/" rel="self" type="application/rss+xml" />
	<link>https://www.kafinea.com/documentation/</link>
	<description>Une solution unique pour toutes vos ambitions</description>
	<lastbuilddate>Wed, 15 Apr 2026 14:32:07 +0000</lastbuilddate>
	<language>fr-FR</language>
	<sy:updateperiod>
	hourly	</sy:updateperiod>
	<sy:updatefrequency>
	1	</sy:updatefrequency>
	

<image>
	<url>https://www.kafinea.com/wp-content/uploads/2024/05/cropped-Favicon-orange-32x32.png</url>
	<title>Documentation &#8226; Kafinea</title>
	<link>https://www.kafinea.com/documentation/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Permettre aux collaborateurs de compléter leur dossier RH en autonomie</title>
		<link>https://www.kafinea.com/documentation/guides-metier/onboarding-rh-extranet/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Tue, 14 Apr 2026 00:17:22 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/onboarding-rh-extranet/</guid>

					<description><![CDATA[<p>📍 Comment accéder à cette fonctionnalité ?Paramétrage &#62; Configuration du module &#62; Layout Editor + Paramétrage &#62; Portail client La situation Une entreprise gère des centaines de collaborateurs en contrats courts. Aujourd&#8217;hui, l&#8217;envoi des accès à l&#8217;espace collaborateur est déjà automatisé grâce aux workflows de Kafinea. Mais l&#8217;entreprise voudrait aller encore plus loin pour que...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/guides-metier/onboarding-rh-extranet/">Permettre aux collaborateurs de compléter leur dossier RH en autonomie</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Comment accéder à cette fonctionnalité ?</strong><br /><em>Paramétrage &gt; Configuration du module &gt; Layout Editor + Paramétrage &gt; Portail client</em></p>
</blockquote>
<h2>La situation</h2>
<p>Une entreprise gère des centaines de collaborateurs en contrats courts. Aujourd&rsquo;hui, l&rsquo;envoi des accès à l&rsquo;espace collaborateur est déjà automatisé grâce aux workflows de Kafinea. Mais l&rsquo;entreprise voudrait aller encore plus loin pour que le collaborateur complète lui-même les informations indispensables à son dossier : numéro de sécurité sociale, coordonnées bancaires…</p>
<p>Le service RH perd un temps considérable à collecter ces informations manuellement, par email ou par téléphone, pour chaque nouvelle recrue.</p>
<h2>L&rsquo;objectif</h2>
<p>Permettre à chaque collaborateur de <strong>compléter son dossier directement depuis son espace extranet</strong>, de manière autonome, sécurisée et guidée. Le service RH peut suivre l&rsquo;avancement en un coup d&rsquo;œil et relancer automatiquement les retardataires.</p>
<hr />
<h2>1. Créer un bloc de suivi sur la fiche Personne</h2>
<p>Depuis le Layout Editor (<em>Paramètres &gt; Configuration du module &gt; Personnes &gt; Mise en page</em>), créer un <strong>nouveau bloc</strong> dédié au suivi de la complétude du dossier, contenant les champs suivants :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Champ</th>
<th>Type</th>
<th>Valeur par défaut</th>
<th>Rôle</th>
</tr>
</thead>
<tbody>
<tr>
<td>N° sécu renseigné</td>
<td>Checkbox</td>
<td>Non</td>
<td>Coché automatiquement quand le numéro de sécurité sociale est renseigné</td>
</tr>
<tr>
<td>Compte bancaire renseigné</td>
<td>Checkbox</td>
<td>Non</td>
<td>Coché automatiquement quand un compte bancaire est marqué par défaut</td>
</tr>
<tr>
<td>Dossier complet</td>
<td>Checkbox</td>
<td>Non</td>
<td>Coché automatiquement quand les deux conditions précédentes sont remplies</td>
</tr>
<tr>
<td>Dernier rappel envoyé</td>
<td>Date/Heure</td>
<td>(vide)</td>
<td>Mis à jour automatiquement par le workflow de rappel</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-note">
<p><strong>Note :</strong> Ces champs servent uniquement au suivi automatisé. Ils ne sont pas destinés à être modifiés manuellement.</p>
</blockquote>
<hr />
<h2>2. Configurer le portail collaborateur</h2>
<h3>Rendre les comptes bancaires accessibles depuis l&rsquo;extranet</h3>
<ol>
<li>Aller dans <em>Paramètres &gt; Portail client</em></li>
<li>Ajouter le module <strong>Comptes bancaires tiers</strong> aux modules visibles</li>
<li>Configurer les champs et permissions :</li>
</ol>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Champ</th>
<th>Visible</th>
<th>Éditable</th>
</tr>
</thead>
<tbody>
<tr>
<td>IBAN</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>BIC</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Nom du compte</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Titulaire du compte</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Compte bancaire par défaut</td>
<td>✅</td>
<td>✅</td>
</tr>
</tbody>
</table>
</div>
<ol start="4">
<li>Activer les permissions <strong>Créer</strong> et <strong>Modifier</strong> un enregistrement</li>
</ol>
<blockquote class="bq-important">
<p><strong>Important :</strong> Le champ &quot;Compte bancaire de&quot; ne doit <strong>pas</strong> être rendu visible sur le portail. Il est automatiquement renseigné par le système avec l&rsquo;identité de la personne connectée. Cela garantit qu&rsquo;un collaborateur ne peut créer un compte bancaire que pour lui-même.</p>
</blockquote>
<h3>Vérifier le champ Numéro de sécurité sociale sur le profil</h3>
<p>Le numéro de sécurité sociale est déjà activé en écriture sur le portail. Vérifier simplement qu&rsquo;il apparaît bien dans la configuration des champs du module Personnes sur le portail.</p>
<hr />
<h2>3. Créer les workflows</h2>
<h3>Workflow 1 : Numéro de sécurité sociale renseigné</h3>
<ul>
<li><strong>Module :</strong> Personnes</li>
<li><strong>Déclencheur :</strong> À chaque modification</li>
<li><strong>Condition :</strong> Le numéro de sécurité sociale n&rsquo;est pas vide <strong>ET</strong> &quot;N° sécu renseigné&quot; n&rsquo;est pas coché</li>
<li><strong>Action :</strong> Cocher le champ &quot;N° sécu renseigné&quot;</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> La condition &quot;N° sécu renseigné n&rsquo;est pas coché&quot; est indispensable. Sans elle, le workflow se déclencherait inutilement à chaque modification de la fiche Personne pendant toute la durée de vie du collaborateur, alors que l&rsquo;onboarding est terminé depuis longtemps.</p>
</blockquote>
<hr />
<h3>Workflow 2 : Compte bancaire par défaut renseigné</h3>
<ul>
<li><strong>Module :</strong> Comptes bancaires tiers</li>
<li><strong>Déclencheur :</strong> À chaque sauvegarde (création ou modification)</li>
<li><strong>Condition :</strong> Le champ &quot;Compte bancaire par défaut&quot; est coché</li>
<li><strong>Action :</strong> Cocher le champ &quot;Compte bancaire renseigné&quot; sur la <strong>fiche Personne parente</strong> (via le champ &quot;Compte bancaire de&quot;)</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Le moteur de workflows Kafinea permet de mettre à jour un champ sur un enregistrement parent de l&rsquo;entité en cours.</p>
</blockquote>
<hr />
<h3>Workflow 3 : Dossier complet</h3>
<ul>
<li><strong>Module :</strong> Personnes</li>
<li><strong>Déclencheur :</strong> À chaque modification</li>
<li><strong>Condition :</strong> &quot;N° sécu renseigné&quot; est coché <strong>ET</strong> &quot;Compte bancaire renseigné&quot; est coché <strong>ET</strong> &quot;Dossier complet&quot; n&rsquo;est pas coché</li>
<li><strong>Action :</strong> Cocher le champ &quot;Dossier complet&quot;</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> La condition &quot;Dossier complet n&rsquo;est pas coché&quot; évite que le workflow ne se déclenche inutilement à chaque modification ultérieure de la fiche.</p>
</blockquote>
<hr />
<h3>Workflow 4 : Notification au collaborateur à chaque modification de compte bancaire</h3>
<ul>
<li><strong>Module :</strong> Comptes bancaires tiers</li>
<li><strong>Déclencheur :</strong> À chaque sauvegarde (création ou modification)</li>
<li><strong>Condition :</strong> Aucune (toujours notifier)</li>
<li><strong>Action :</strong> Envoyer un email à la <strong>personne propriétaire</strong> (via le champ &quot;Compte bancaire de&quot;)</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> Ce workflow est un dispositif de sécurité essentiel. Il permet au collaborateur de détecter toute modification suspecte de son compte bancaire. Inclure dans le message : <em>&quot;Si vous n&rsquo;êtes pas à l&rsquo;origine de cette modification, contactez immédiatement le service RH.&quot;</em></p>
</blockquote>
<hr />
<h3>Workflow 5 : Rappel automatique</h3>
<ul>
<li><strong>Module :</strong> Personnes</li>
<li><strong>Déclencheur :</strong> Planifié (quotidien ou hebdomadaire selon le besoin)</li>
<li><strong>Condition :</strong> La personne a un accès extranet actif <strong>ET</strong> &quot;Dossier complet&quot; n&rsquo;est pas coché</li>
<li><strong>Actions :</strong>
<ol>
<li>Envoyer un email de rappel à la personne</li>
<li>Mettre à jour le champ &quot;Dernier rappel envoyé&quot; avec la date/heure courante</li>
</ol>
</li>
</ul>
<hr />
<h2>4. Sécurité</h2>
<h3>Validation automatique des données bancaires</h3>
<p>L&rsquo;IBAN et le BIC saisis depuis l&rsquo;extranet sont <strong>validés automatiquement</strong> par le système :</p>
<ul>
<li>L&rsquo;IBAN est vérifié (checksum, format, code pays) — un IBAN mal formé est rejeté avec un message d&rsquo;erreur visible par le collaborateur</li>
<li>Le BIC est vérifié (format strict 8 ou 11 caractères)</li>
</ul>
<p>Le service RH n&rsquo;a pas besoin de valider manuellement les IBAN. La validation technique rend extrêmement improbable qu&rsquo;un IBAN saisi au hasard passe le contrôle.</p>
<h3>Isolation des données</h3>
<p>Chaque collaborateur ne peut voir et modifier que <strong>ses propres</strong> comptes bancaires. Le système force automatiquement le propriétaire du compte lors de la création depuis l&rsquo;extranet.</p>
<h3>Détection de fraude</h3>
<p>La notification automatique au collaborateur (workflow 4) est le principal mécanisme de détection. Si quelqu&rsquo;un modifie le compte bancaire d&rsquo;un collaborateur à son insu, celui-ci en est immédiatement informé par email.</p>
<hr />
<h2>5. Le parcours du collaborateur</h2>
<ol>
<li>Le collaborateur reçoit ses accès extranet (via un workflow existant)</li>
<li>Il se connecte à son espace et accède à son profil</li>
<li>Il renseigne son <strong>numéro de sécurité sociale</strong> → le système coche automatiquement &quot;N° sécu renseigné&quot;</li>
<li>Il accède à la section <strong>Comptes bancaires</strong> et crée son compte (IBAN et BIC validés automatiquement) → le système coche &quot;Compte bancaire renseigné&quot;</li>
<li>Il reçoit un <strong>email de confirmation</strong> (sécurité)</li>
<li>Le système coche <strong>&quot;Dossier complet&quot;</strong> sur sa fiche</li>
<li>Si le dossier n&rsquo;est pas complété dans les délais, des <strong>rappels automatiques</strong> sont envoyés</li>
</ol>
<hr />
<h2>6. Checklist de mise en place</h2>
<ul>
<li>[ ] Créer le bloc de suivi et les 4 champs personnalisés sur la fiche Personne (Layout Editor)</li>
<li>[ ] Configurer le portail : rendre les comptes bancaires accessibles avec les champs et permissions appropriés</li>
<li>[ ] Vérifier que le numéro de sécurité sociale est visible sur le profil extranet</li>
<li>[ ] Créer les 5 workflows (n° sécu, compte bancaire, dossier complet, notification collaborateur, rappels)</li>
<li>[ ] Tester le parcours complet depuis l&rsquo;extranet</li>
<li>[ ] Vérifier que les erreurs de validation IBAN/BIC s&rsquo;affichent correctement</li>
</ul>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<li><a href="../../120_ressources-humaines/200_extranet-collaborateur/010_le-portail-collaborateur.md">Le portail collaborateur</a></li>
<li><a href="../../120_ressources-humaines/010_les-personnes.md">Les personnes</a></li>
<li><a href="../../200_automatisation/015_les-workflows.md">Les workflows</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/guides-metier/onboarding-rh-extranet/">Permettre aux collaborateurs de compléter leur dossier RH en autonomie</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les agents IA</title>
		<link>https://www.kafinea.com/documentation/parametrage/les-agents-ia/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:04:20 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/les-agents-ia/</guid>

					<description><![CDATA[<p>Introduction L&#8217;Explorateur Agents IA est l&#8217;interface d&#8217;administration permettant de superviser l&#8217;activité des agents IA dans Kafinea. Il offre une vue consolidée des exécutions (runs), des statistiques d&#8217;utilisation et des coûts associés. Cette page est réservée aux administrateurs et aux administrateurs restreints. 1. Accès Accédez à l&#8217;explorateur via Paramètres &#62; Extensions &#62; Explorateur Agents IA. 2....</p>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/les-agents-ia/">Les agents IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<hr />
<h2>Introduction</h2>
<p>L&rsquo;<strong>Explorateur Agents IA</strong> est l&rsquo;interface d&rsquo;administration permettant de superviser l&rsquo;activité des agents IA dans Kafinea. Il offre une vue consolidée des exécutions (runs), des statistiques d&rsquo;utilisation et des coûts associés.</p>
<p>Cette page est réservée aux administrateurs et aux administrateurs restreints.</p>
<hr />
<h2>1. Accès</h2>
<p>Accédez à l&rsquo;explorateur via <strong>Paramètres &gt; Extensions &gt; Explorateur Agents IA</strong>.</p>
<hr />
<h2>2. Dashboard de statistiques</h2>
<p>Le haut de la page affiche un tableau de bord synthétique avec :</p>
<ul>
<li><strong>Nombre total de runs</strong> : nombre d&rsquo;exécutions d&rsquo;agents IA</li>
<li><strong>Coût estimé</strong> : coût total estimé en fonction des tokens consommés</li>
<li><strong>Tokens utilisés</strong> : répartition entre tokens de prompt (entrée) et tokens de complétion (sortie)</li>
<li><strong>Statistiques par période</strong> : ventilation mensuelle ou hebdomadaire</li>
</ul>
<hr />
<h2>3. Liste des exécutions</h2>
<p>La liste paginée affiche chaque exécution d&rsquo;agent IA avec les informations suivantes :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Colonne</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Run ID</strong></td>
<td>Identifiant unique de l&rsquo;exécution</td>
</tr>
<tr>
<td><strong>Agent</strong></td>
<td>Nom de l&rsquo;agent ayant effectué l&rsquo;exécution</td>
</tr>
<tr>
<td><strong>Modèle</strong></td>
<td>Modèle IA utilisé (ex : gpt-4, claude-3, etc.)</td>
</tr>
<tr>
<td><strong>Utilisateur</strong></td>
<td>L&rsquo;utilisateur Kafinea ayant déclenché l&rsquo;exécution</td>
</tr>
<tr>
<td><strong>Statut</strong></td>
<td>État de l&rsquo;exécution : running, completed, failed</td>
</tr>
<tr>
<td><strong>Tokens</strong></td>
<td>Nombre de tokens de prompt / complétion / total</td>
</tr>
<tr>
<td><strong>Coût</strong></td>
<td>Coût estimé de l&rsquo;exécution</td>
</tr>
<tr>
<td><strong>Durée</strong></td>
<td>Temps d&rsquo;exécution</td>
</tr>
<tr>
<td><strong>Date</strong></td>
<td>Date et heure de lancement</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>4. Filtres</h2>
<p>Vous pouvez filtrer la liste des exécutions par :</p>
<ul>
<li><strong>Statut</strong> : running, completed, failed</li>
<li><strong>Agent</strong> : nom de l&rsquo;agent</li>
<li><strong>Modèle</strong> : modèle IA utilisé</li>
<li><strong>Utilisateur</strong> : utilisateur ayant déclenché l&rsquo;exécution</li>
</ul>
<hr />
<h2>5. Détail d&rsquo;une exécution</h2>
<p>En cliquant sur une exécution, vous accédez au détail qui comprend :</p>
<ul>
<li>Le résumé de l&rsquo;entrée (prompt envoyé)</li>
<li>La liste des événements (étapes intermédiaires de l&rsquo;agent)</li>
<li>La réponse générée</li>
<li>Les métriques détaillées (tokens, coût, durée)</li>
</ul>
<hr />
<h2>6. Outils disponibles pour les agents</h2>
<p>Les agents IA disposent d&rsquo;un ensemble d&rsquo;outils leur permettant d&rsquo;interagir avec les données de Kafinea :</p>
<ul>
<li><strong>Recherche</strong> : rechercher des enregistrements dans les modules</li>
<li><strong>Lecture</strong> : consulter le détail d&rsquo;un enregistrement</li>
<li><strong>Navigation</strong> : parcourir les relations entre enregistrements</li>
<li><strong>Analyse</strong> : calculer des agrégats ou des statistiques</li>
<li><strong>Création</strong> : créer de nouveaux enregistrements <em>(nécessite le toggle Beta)</em></li>
<li><strong>Modification</strong> : mettre à jour des enregistrements existants <em>(nécessite le toggle Beta)</em></li>
<li><strong>Suppression</strong> : supprimer des enregistrements <em>(nécessite le toggle Beta)</em></li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Les agents respectent les droits d&rsquo;accès de l&rsquo;utilisateur qui déclenche l&rsquo;exécution. Les outils de création, modification et suppression ne sont disponibles que si l&rsquo;option <strong>(Beta) Autoriser l&rsquo;Agent IA à modifier les données</strong> est activée dans <strong>Paramètres &gt; Fonctionnalités</strong>.</p>
</blockquote>
<hr />
<h2>7. Configuration</h2>
<p>La configuration des agents IA est gérée dans les fichiers de configuration de Kafinea :</p>
<ul>
<li><strong>Clé API</strong> : configurée dans les paramètres de la passerelle IA</li>
<li><strong>Feature flags</strong> : activation/désactivation des fonctionnalités IA</li>
<li><strong>Modèles disponibles</strong> : liste des modèles IA utilisables</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> La modification de ces paramètres nécessite un accès au serveur.</p>
</blockquote>
<hr />
<h2>FAQ</h2>
<p><strong>Comment voir combien coûte l&rsquo;utilisation de l&rsquo;IA ?</strong><br />
Le dashboard de l&rsquo;explorateur affiche le coût estimé par exécution et le coût total. Ces estimations sont basées sur le nombre de tokens consommés.</p>
<p><strong>Un agent peut-il modifier des données ?</strong><br />
Les agents de type workflow (VTMdsPromptAITask) peuvent mettre à jour les champs configurés dans le mapping. Le chat IA peut créer, modifier et supprimer des enregistrements uniquement si l&rsquo;option <strong>(Beta) Autoriser l&rsquo;Agent IA à modifier les données</strong> est activée dans <strong>Paramètres &gt; Fonctionnalités</strong>. Lorsque cette option est désactivée, le chat IA fonctionne en lecture seule.</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="/205_intelligence-artificielle/020_le-chat-ia.md">Le chat IA</a></li>
<li><a href="/205_intelligence-artificielle/010_lassistant-de-texte-ia.md">L&rsquo;assistant de texte IA</a></li>
<li><a href="/205_intelligence-artificielle/030_les-workflows-ia.md">Les workflows IA</a></li>
<li><a href="/205_intelligence-artificielle/040_connecter-une-ia-externe-mcp.md">Connecter une IA externe (MCP)</a></li>
<li><a href="/205_intelligence-artificielle/050_locr-de-factures-assiste-par-ia.md">L&rsquo;OCR de factures assisté par IA</a></li>
<li><a href="https://www.kafinea.com/documentation/parametrage/le-serveur-mcp/">Le serveur MCP</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/les-agents-ia/">Les agents IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Le serveur MCP</title>
		<link>https://www.kafinea.com/documentation/parametrage/le-serveur-mcp/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:04:17 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/le-serveur-mcp/</guid>

					<description><![CDATA[<p>Introduction Le serveur MCP (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) de se connecter à l&#8217;instance ERP pour interroger les données via un protocole standardisé. Cette page décrit l&#8217;architecture technique, la sécurité et la configuration du serveur MCP pour les administrateurs. 1. Architecture Le serveur...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/le-serveur-mcp/">Le serveur MCP</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<hr />
<h2>Introduction</h2>
<p>Le <strong>serveur MCP</strong> (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) de se connecter à l&rsquo;instance ERP pour interroger les données via un protocole standardisé.</p>
<p>Cette page décrit l&rsquo;architecture technique, la sécurité et la configuration du serveur MCP pour les administrateurs.</p>
<hr />
<h2>1. Architecture</h2>
<p>Le serveur MCP de Kafinea est composé de plusieurs briques :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Composant</th>
<th>Rôle</th>
</tr>
</thead>
<tbody>
<tr>
<td>Point d&rsquo;entrée HTTP</td>
<td>Réception des requêtes MCP (protocole Streamable HTTP)</td>
</tr>
<tr>
<td>Outils (Tools)</td>
<td>Fonctions exposées aux clients IA (recherche, lecture, navigation)</td>
</tr>
<tr>
<td>Ressources (Resources)</td>
<td>Données de contexte consultables par le client IA</td>
</tr>
<tr>
<td>Authentification</td>
<td>Validation des identifiants utilisateur à chaque requête</td>
</tr>
<tr>
<td>Sécurité</td>
<td>Application des droits d&rsquo;accès et des contrôles de sécurité</td>
</tr>
<tr>
<td>Configuration</td>
<td>Paramètres d&rsquo;activation et de limitation du serveur</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>2. Authentification</h2>
<p>L&rsquo;authentification se fait via le header HTTP <code>X-Kafinea-Credentials</code> au format :</p>
<pre><code>X-Kafinea-Credentials: username:accesskey
</code></pre>
<ul>
<li>Le <strong>username</strong> est le nom d&rsquo;utilisateur Kafinea</li>
<li>L&rsquo;<strong>accesskey</strong> est la clé d&rsquo;accès de l&rsquo;utilisateur (visible dans Mes Préférences)</li>
</ul>
<p>Le serveur valide les identifiants et établit le contexte utilisateur pour la requête.</p>
<hr />
<h2>3. Sécurité</h2>
<h3>Droits d&rsquo;accès</h3>
<p>Chaque requête MCP est exécutée dans le contexte de l&rsquo;utilisateur authentifié. Les droits d&rsquo;accès aux modules, enregistrements et champs sont respectés.</p>
<h3>Contrôles de sécurité supplémentaires</h3>
<p>En plus des droits d&rsquo;accès utilisateur, le serveur MCP applique des contrôles supplémentaires :</p>
<ul>
<li>Validation des paramètres d&rsquo;entrée</li>
<li>Filtrage des modules et champs sensibles</li>
<li>Protection contre les injections</li>
</ul>
<h3>Recommandations</h3>
<ul>
<li>Déployez le serveur MCP uniquement sur des connexions HTTPS</li>
<li>Ne publiez jamais les identifiants dans un dépôt public</li>
<li>Surveillez les logs d&rsquo;accès pour détecter les usages anormaux</li>
<li>Utilisez des clés d&rsquo;accès dédiées pour les intégrations MCP si possible</li>
</ul>
<hr />
<h2>4. Outils exposés (Tools)</h2>
<p>Les outils exposés par le serveur MCP permettent aux clients IA de :</p>
<ul>
<li><strong>Rechercher</strong> des enregistrements dans les modules Kafinea</li>
<li><strong>Lire</strong> le détail d&rsquo;un enregistrement spécifique</li>
<li><strong>Naviguer</strong> les relations entre enregistrements</li>
<li><strong>Lister</strong> les modules et champs disponibles</li>
</ul>
<p>Chaque outil respecte les droits d&rsquo;accès de l&rsquo;utilisateur connecté.</p>
<hr />
<h2>5. Ressources exposées (Resources)</h2>
<p>Les ressources exposent des données de contexte que le client IA peut consulter :</p>
<ul>
<li>Informations sur l&rsquo;instance Kafinea</li>
<li>Structure des modules disponibles</li>
<li>Métadonnées des champs</li>
</ul>
<hr />
<h2>6. Configuration</h2>
<p>La configuration du serveur MCP est gérée par l&rsquo;administrateur serveur. Les paramètres incluent :</p>
<ul>
<li>Activation/désactivation du serveur</li>
<li>Liste des modules exposés</li>
<li>Limites de requêtes</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Contactez votre administrateur serveur si vous souhaitez modifier la liste des modules exposés ou les limites de requêtes.</p>
</blockquote>
<hr />
<h2>7. Activation</h2>
<p>Le serveur MCP est activé via les feature flags de Kafinea. Pour l&rsquo;activer :</p>
<ol>
<li>Vérifiez que le feature flag MCP est activé dans la configuration</li>
<li>Assurez-vous que le endpoint <code>mcp/index.php</code> est accessible depuis l&rsquo;extérieur (ou depuis le réseau des utilisateurs)</li>
<li>Informez les utilisateurs qu&rsquo;ils peuvent récupérer leur configuration depuis <strong>Mes Préférences &gt; Configuration MCP</strong></li>
</ol>
<hr />
<h2>8. Diagnostic</h2>
<p>En cas de problème de connexion :</p>
<ol>
<li>Vérifiez que le endpoint MCP est accessible depuis le poste de l&rsquo;utilisateur</li>
<li>Vérifiez les identifiants utilisateur (username + accesskey valides)</li>
<li>Vérifiez que le feature flag MCP est bien activé</li>
<li>Consultez l&rsquo;Explorateur Agents IA pour identifier d&rsquo;éventuelles erreurs</li>
</ol>
<hr />
<h2>FAQ</h2>
<p><strong>Le serveur MCP est-il compatible avec tous les clients IA ?</strong><br />
Le serveur implémente le protocole MCP standard (Streamable HTTP). Tout client compatible MCP peut s&rsquo;y connecter.</p>
<p><strong>Puis-je limiter les modules accessibles via MCP ?</strong><br />
Oui, via les droits d&rsquo;accès des profils utilisateurs dans Kafinea. L&rsquo;administrateur serveur peut également restreindre la liste des modules exposés au niveau de la configuration du serveur.</p>
<p><strong>Les requêtes MCP sont-elles loguées ?</strong><br />
Oui, l&rsquo;activité MCP peut être consultée depuis l&rsquo;Explorateur Agents IA dans Kafinea.</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="/205_intelligence-artificielle/040_connecter-une-ia-externe-mcp.md">Connecter une IA externe (MCP)</a></li>
<li><a href="https://www.kafinea.com/documentation/parametrage/les-agents-ia/">Les agents IA</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/le-serveur-mcp/">Le serveur MCP</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les workflows IA</title>
		<link>https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:03:55 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/les-workflows-ia/</guid>

					<description><![CDATA[<p>Introduction Les workflows IA permettent d&#8217;automatiser des traitements intelligents sur les enregistrements de Kafinea. En ajoutant une tâche de type Prompt IA dans un workflow, vous pouvez faire analyser, résumer, traduire ou classifier automatiquement des données par un modèle d&#8217;intelligence artificielle. 1. Créer un workflow avec une tâche IA Accédez à Paramètres &#62; Automatisation et...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<hr />
<h2>Introduction</h2>
<p>Les <strong>workflows IA</strong> permettent d&rsquo;automatiser des traitements intelligents sur les enregistrements de Kafinea. En ajoutant une tâche de type <strong>Prompt IA</strong> dans un workflow, vous pouvez faire analyser, résumer, traduire ou classifier automatiquement des données par un modèle d&rsquo;intelligence artificielle.</p>
<hr />
<h2>1. Créer un workflow avec une tâche IA</h2>
<ol>
<li>Accédez à <strong>Paramètres &gt; Automatisation et communication &gt; Workflows</strong></li>
<li>Créez un nouveau workflow ou modifiez un workflow existant</li>
<li>Choisissez le module cible (Contacts, Factures, Devis, etc.)</li>
<li>Définissez les conditions de déclenchement</li>
<li>Ajoutez une tâche de type <strong>Prompt IA</strong></li>
</ol>
<hr />
<h2>2. Configurer la tâche Prompt IA</h2>
<p>La tâche Prompt IA comporte deux parties :</p>
<h3>Le prompt (instruction)</h3>
<p>C&rsquo;est l&rsquo;instruction textuelle envoyée au modèle IA. Vous pouvez y inclure des variables du module pour personnaliser la requête.</p>
<p><strong>Exemple de prompt :</strong></p>
<pre><code>Résume en 2 phrases le contenu de la description suivante : $description
Classifie le niveau d'urgence du ticket parmi : faible, moyen, élevé, critique.
</code></pre>
<h3>Le mapping des champs de retour</h3>
<p>Pour chaque champ que l&rsquo;IA doit remplir, vous configurez :</p>
<ul>
<li><strong>Le champ cible</strong> : le champ de l&rsquo;enregistrement à mettre à jour</li>
<li><strong>L&rsquo;instruction spécifique</strong> : ce que l&rsquo;IA doit générer pour ce champ</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> La réponse de l&rsquo;IA est attendue au format JSON avec les noms des champs comme clés. Le système gère automatiquement l&rsquo;extraction même si la réponse contient du texte autour du JSON.</p>
</blockquote>
<hr />
<h2>3. Données contextuelles transmises à l&rsquo;IA</h2>
<p>La tâche IA transmet automatiquement au modèle :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Donnée</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Données de l&rsquo;enregistrement</strong></td>
<td>Tous les champs de l&rsquo;enregistrement courant</td>
</tr>
<tr>
<td><strong>Enregistrements parents</strong></td>
<td>Les données des enregistrements liés (contact, compte, etc.)</td>
</tr>
<tr>
<td><strong>Description des modules</strong></td>
<td>Noms et types des champs, valeurs des listes de sélection</td>
</tr>
<tr>
<td><strong>Lignes de détail</strong></td>
<td>Pour les modules de type inventaire (factures, devis, commandes)</td>
</tr>
<tr>
<td><strong>Données de l&rsquo;organisation</strong></td>
<td>Informations de la société liée à l&rsquo;enregistrement</td>
</tr>
<tr>
<td><strong>Contenu de document</strong></td>
<td>Si le module est Documents, le contenu du fichier joint</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>4. Exemples d&rsquo;utilisation</h2>
<h3>Résumé automatique de tickets</h3>
<ul>
<li><strong>Module</strong> : HelpDesk</li>
<li><strong>Déclencheur</strong> : À la création</li>
<li><strong>Prompt</strong> : « Résume ce ticket de support en une phrase concise. »</li>
<li><strong>Champ cible</strong> : <code>cf_summary</code> ← instruction : « Une phrase résumant le problème »</li>
</ul>
<h3>Classification de contacts</h3>
<ul>
<li><strong>Module</strong> : Contacts</li>
<li><strong>Déclencheur</strong> : À la sauvegarde</li>
<li><strong>Prompt</strong> : « Analyse les informations de ce contact et suggère un segment commercial. »</li>
<li><strong>Champ cible</strong> : <code>cf_segment</code> ← instruction : « Le segment parmi : PME, ETI, Grande Entreprise, Particulier »</li>
</ul>
<h3>Traduction de description produit</h3>
<ul>
<li><strong>Module</strong> : Products</li>
<li><strong>Déclencheur</strong> : À la sauvegarde</li>
<li><strong>Prompt</strong> : « Traduis la description du produit en anglais. »</li>
<li><strong>Champ cible</strong> : <code>cf_description_en</code> ← instruction : « La traduction anglaise de la description »</li>
</ul>
<hr />
<h2>5. Gestion des erreurs</h2>
<p>Si l&rsquo;IA ne renvoie pas de réponse valide, le workflow continue sans mettre à jour les champs. Les erreurs sont enregistrées dans les logs du serveur :</p>
<ul>
<li><strong>Clé API manquante</strong> : vérifiez la configuration de la passerelle IA</li>
<li><strong>Réponse vide</strong> : le prompt est peut-être trop vague ou les données insuffisantes</li>
<li><strong>Erreur de parsing JSON</strong> : le système tente automatiquement plusieurs stratégies d&rsquo;extraction</li>
</ul>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Consultez les logs PHP (<code>error_log</code>) pour diagnostiquer les problèmes d&rsquo;exécution des workflows IA.</p>
</blockquote>
<hr />
<h2>6. Limites</h2>
<ul>
<li>La taille du prompt est limitée par le modèle IA utilisé (généralement 4 096 tokens de réponse max).</li>
<li>Les fichiers images volumineux ou les documents très longs peuvent être tronqués.</li>
<li>Le workflow s&rsquo;exécute de manière synchrone : un appel IA lent peut ralentir le traitement.</li>
</ul>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="/200_automatisation/020_le-planificateur.md">Le planificateur</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/">Le chat IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/">L&rsquo;assistant de texte IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/">Connecter une IA externe (MCP)</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/la-saisie-automatique-depuis-un-pdf/">L&rsquo;OCR de factures assisté par IA</a></li>
<li><a href="/250_parametrage/120_les-agents-ia.md">Les agents IA</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>L&#8217;assistant de texte IA</title>
		<link>https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:03:53 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/lassistant-de-texte-ia/</guid>

					<description><![CDATA[<p>📍 Comment accéder à cette fonctionnalité ?Tout champ texte ou éditeur riche &#62; bouton « IA » L&#8217;assistant de texte IA permet de transformer, améliorer ou reformuler le contenu d&#8217;un champ texte directement depuis l&#8217;interface Kafinea, sans quitter la fiche en cours. 1. Accès Un bouton IA apparaît automatiquement à côté de chaque zone de...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/">L&rsquo;assistant de texte IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Comment accéder à cette fonctionnalité ?</strong><br /><em>Tout champ texte ou éditeur riche &gt; bouton « IA »</em></p>
</blockquote>
<p>L&rsquo;assistant de texte IA permet de transformer, améliorer ou reformuler le contenu d&rsquo;un champ texte directement depuis l&rsquo;interface Kafinea, sans quitter la fiche en cours.</p>
<hr />
<h2>1. Accès</h2>
<p>Un bouton <strong>IA</strong> apparaît automatiquement à côté de chaque zone de texte multi-lignes (zone de texte simple ou éditeur riche) dans Kafinea. Il n&rsquo;est pas disponible sur les champs de saisie simples (une seule ligne). Pour ouvrir l&rsquo;assistant :</p>
<ol>
<li>Cliquez sur le bouton <strong>IA</strong> situé à côté du champ texte souhaité</li>
<li>Une fenêtre modale s&rsquo;ouvre avec deux panneaux côte à côte : le <strong>texte original</strong> (à gauche) et le <strong>texte généré par IA</strong> (à droite)</li>
</ol>
<blockquote class="bq-note">
<p><strong>Note :</strong> Le bouton IA est également disponible dans la fenêtre de rédaction d&#8217;emails, à côté du bouton de sélection de modèle.</p>
</blockquote>
<hr />
<h2>2. Actions disponibles</h2>
<p>L&rsquo;assistant propose 13 actions, sélectionnables via le menu déroulant <strong>Action IA</strong> :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Action</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Résumer</strong></td>
<td>Produit un résumé concis du texte</td>
</tr>
<tr>
<td><strong>Améliorer le texte</strong></td>
<td>Améliore le style, la clarté et le professionnalisme</td>
</tr>
<tr>
<td><strong>Corriger la grammaire</strong></td>
<td>Corrige l&rsquo;orthographe et la grammaire</td>
</tr>
<tr>
<td><strong>Développer le texte</strong></td>
<td>Enrichit et développe le contenu</td>
</tr>
<tr>
<td><strong>Condenser le texte</strong></td>
<td>Raccourcit le texte en conservant l&rsquo;essentiel</td>
</tr>
<tr>
<td><strong>Extraire les points clés</strong></td>
<td>Identifie et liste les idées principales</td>
</tr>
<tr>
<td><strong>Traduire</strong></td>
<td>Traduit le texte dans une langue cible</td>
</tr>
<tr>
<td><strong>Changer le ton</strong></td>
<td>Reformule le texte avec un ton différent</td>
</tr>
<tr>
<td><strong>Réécrire pour l&rsquo;audience</strong></td>
<td>Adapte le texte à une audience spécifique</td>
</tr>
<tr>
<td><strong>Créer des éléments d&rsquo;action</strong></td>
<td>Extrait les tâches et actions à mener</td>
</tr>
<tr>
<td><strong>Formater pour email</strong></td>
<td>Reformate le texte pour un usage email</td>
</tr>
<tr>
<td><strong>Créer une liste de contrôle</strong></td>
<td>Transforme le contenu en checklist</td>
</tr>
<tr>
<td><strong>Prompt personnalisé</strong></td>
<td>Permet de saisir des instructions libres</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>3. Options contextuelles</h2>
<p>Certaines actions affichent des options supplémentaires :</p>
<p><strong>Traduire :</strong><br />
Un sélecteur <strong>Langue cible</strong> apparaît avec les langues disponibles : anglais, français, espagnol, allemand, italien, portugais, néerlandais, russe, chinois, japonais.</p>
<p><strong>Changer le ton :</strong><br />
Un sélecteur <strong>Ton cible</strong> apparaît avec les options suivantes : professionnel, amical, formel, décontracté, technique, simple.</p>
<p><strong>Réécrire pour l&rsquo;audience :</strong><br />
Un sélecteur <strong>Audience cible</strong> apparaît avec les choix suivants : direction, équipe technique, clients, utilisateurs finaux, grand public.</p>
<p><strong>Prompt personnalisé :</strong><br />
Un champ de texte libre permet de saisir des instructions spécifiques à envoyer à l&rsquo;IA.</p>
<hr />
<h2>4. Utilisation</h2>
<ol>
<li>Cliquez sur le bouton <strong>IA</strong> du champ à traiter</li>
<li>Vérifiez le texte original dans le panneau de gauche</li>
<li>Choisissez une <strong>action IA</strong> dans le menu déroulant</li>
<li>Si nécessaire, configurez les options supplémentaires (langue, ton, audience)</li>
<li>Cliquez sur <strong>Demander à l&rsquo;IA</strong></li>
<li>Le résultat apparaît dans le panneau de droite (<strong>Texte généré par IA</strong>)</li>
<li>Cliquez sur <strong>Appliquer les modifications</strong> pour remplacer le contenu du champ original</li>
</ol>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Vous pouvez redimensionner les deux panneaux en glissant le séparateur central pour ajuster la répartition de l&rsquo;espace.</p>
</blockquote>
<blockquote class="bq-note">
<p><strong>Note :</strong> Sur mobile, les deux panneaux s&rsquo;affichent l&rsquo;un au-dessus de l&rsquo;autre pour une meilleure lisibilité.</p>
</blockquote>
<hr />
<h2>5. Texte riche (HTML)</h2>
<p>Lorsque l&rsquo;assistant détecte que le champ source contient du texte riche (HTML), il fonctionne en <strong>mode riche</strong> :</p>
<ul>
<li>Le panneau de gauche affiche le contenu avec sa mise en forme</li>
<li>Le résultat généré conserve la mise en forme HTML</li>
<li>L&rsquo;application des modifications préserve le formatage dans le champ source</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Ce mode est utilisé automatiquement pour les champs de description et les éditeurs d&#8217;emails.</p>
</blockquote>
<hr />
<h2>FAQ</h2>
<p><strong>L&rsquo;assistant modifie-t-il directement mon champ ?</strong><br />
Non, pas automatiquement. Le résultat s&rsquo;affiche d&rsquo;abord dans le panneau de droite. Vous devez cliquer sur <strong>Appliquer les modifications</strong> pour remplacer le contenu du champ original.</p>
<p><strong>Puis-je utiliser l&rsquo;assistant sur un champ vide ?</strong><br />
Non. L&rsquo;assistant nécessite un texte de départ. Si le champ est vide, un message d&rsquo;avertissement vous invite à saisir du contenu.</p>
<p><strong>L&rsquo;assistant est-il disponible sur tous les champs texte ?</strong><br />
Le bouton IA apparaît sur toutes les zones de texte multi-lignes de Kafinea, y compris les éditeurs de texte riche et les fenêtres d&rsquo;envoi d&#8217;emails. Il n&rsquo;est pas disponible sur les champs de saisie simples (une seule ligne).</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/">Le chat IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/">Connecter une IA externe (MCP)</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/la-saisie-automatique-depuis-un-pdf/">L&rsquo;OCR de factures assisté par IA</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/">L&rsquo;assistant de texte IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Le chat IA</title>
		<link>https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:03:51 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/le-chat-ia/</guid>

					<description><![CDATA[<p>Introduction Le chat IA de Kafinea est un assistant intégré directement dans l&#8217;interface de l&#8217;ERP. Il permet de poser des questions en langage naturel et d&#8217;obtenir des réponses contextualisées sur vos données, vos processus métier ou des tâches courantes. Le panneau de chat est accessible depuis n&#8217;importe quelle page de Kafinea, sans quitter votre écran...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/">Le chat IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<hr />
<h2>Introduction</h2>
<p>Le <strong>chat IA</strong> de Kafinea est un assistant intégré directement dans l&rsquo;interface de l&rsquo;ERP. Il permet de poser des questions en langage naturel et d&rsquo;obtenir des réponses contextualisées sur vos données, vos processus métier ou des tâches courantes.</p>
<p>Le panneau de chat est accessible depuis n&rsquo;importe quelle page de Kafinea, sans quitter votre écran de travail.</p>
<hr />
<h2>1. Ouvrir le panneau de chat</h2>
<p>Le panneau IA s&rsquo;ouvre via le bouton situé dans la barre supérieure de l&rsquo;interface. Une fois ouvert, il s&rsquo;affiche sur le côté droit de l&rsquo;écran sous forme de panneau latéral redimensionnable.</p>
<ul>
<li>Cliquez sur le bouton pour ouvrir ou fermer le panneau.</li>
<li>Le panneau conserve son état (ouvert/fermé) durant votre session de navigation.</li>
<li>La largeur du panneau est ajustable par glisser-déposer sur son bord gauche.</li>
</ul>
<hr />
<h2>2. Envoyer un message</h2>
<p>Saisissez votre question ou instruction dans la zone de texte en bas du panneau, puis appuyez sur <strong>Entrée</strong> ou cliquez sur le bouton d&rsquo;envoi.</p>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Utilisez <strong>Maj + Entrée</strong> pour passer à la ligne sans envoyer le message.</p>
</blockquote>
<p>Le chat supporte les questions en français et en anglais. Les réponses sont formatées en Markdown (listes, tableaux, mise en forme).</p>
<hr />
<h2>3. Les modèles de messages</h2>
<p>Le bouton <strong>Modèles</strong> propose des messages pré-rédigés pour les tâches courantes :</p>
<ul>
<li>Résumer un enregistrement</li>
<li>Traduire un texte</li>
<li>Vérifier la grammaire</li>
<li>Expliquer un concept</li>
<li>Améliorer un texte</li>
</ul>
<p>Ces modèles facilitent l&rsquo;utilisation de l&rsquo;assistant sans avoir à formuler la requête manuellement.</p>
<hr />
<h2>4. Les actions rapides</h2>
<p>La barre d&rsquo;actions rapides, située en haut du panneau, propose des raccourcis contextuels :</p>
<ul>
<li><strong>Résumer</strong> : résumer le texte sélectionné</li>
<li><strong>Traduire</strong> : traduire le texte sélectionné</li>
<li><strong>Grammaire</strong> : vérifier l&rsquo;orthographe et la grammaire</li>
<li><strong>Expliquer</strong> : expliquer un terme ou un texte complexe</li>
<li><strong>Presse-papiers</strong> : analyser le contenu du presse-papiers</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Certaines actions rapides nécessitent d&rsquo;avoir sélectionné du texte au préalable dans la page.</p>
</blockquote>
<hr />
<h2>5. Historique des conversations</h2>
<p>L&rsquo;historique des conversations est sauvegardé automatiquement sur le serveur. Vous pouvez :</p>
<ul>
<li><strong>Reprendre une conversation</strong> précédente en cliquant sur le bouton <strong>Historique</strong></li>
<li><strong>Supprimer</strong> une conversation depuis la liste de l&rsquo;historique</li>
<li><strong>Démarrer une nouvelle conversation</strong> à tout moment</li>
</ul>
<p>L&rsquo;historique persiste entre les sessions de navigation : vous retrouvez vos conversations même après avoir fermé et rouvert votre navigateur.</p>
<hr />
<h2>6. Effacer le chat</h2>
<p>Le bouton <strong>Effacer</strong> supprime tous les messages de la conversation en cours et démarre une nouvelle conversation vierge.</p>
<blockquote class="bq-important">
<p><strong>Important :</strong> L&rsquo;effacement est définitif et supprime aussi la conversation du serveur.</p>
</blockquote>
<hr />
<h2>7. Capacités et limites</h2>
<p>L&rsquo;assistant IA peut :</p>
<ul>
<li>Répondre à des questions sur l&rsquo;utilisation de Kafinea</li>
<li>Aider à rédiger ou reformuler des textes</li>
<li>Analyser des données contextuelles de l&rsquo;enregistrement en cours</li>
<li>Effectuer des traductions</li>
<li>Créer, modifier et supprimer des enregistrements <em>(nécessite l&rsquo;option Beta, voir ci-dessous)</em></li>
</ul>
<h3>Modification des données</h3>
<p>Lorsque l&rsquo;option <strong>(Beta) Autoriser l&rsquo;Agent IA à modifier les données</strong> est activée dans <strong>Paramètres &gt; Fonctionnalités</strong>, le chat IA peut créer, modifier et supprimer des enregistrements dans Kafinea, en respectant les droits d&rsquo;accès de l&rsquo;utilisateur. Lorsque cette option est désactivée, le chat IA fonctionne en lecture seule.</p>
<p>L&rsquo;assistant IA <strong>ne peut pas</strong> :</p>
<ul>
<li>Accéder à des informations extérieures à votre instance</li>
<li>Garantir une exactitude absolue sur les calculs financiers ou réglementaires</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> Vérifiez toujours les informations critiques (montants, obligations légales) fournies par l&rsquo;assistant.</p>
</blockquote>
<hr />
<h2>8. Activation</h2>
<p>Le chat IA est activé par l&rsquo;administrateur via les feature flags de Kafinea. Si le panneau n&rsquo;apparaît pas dans votre interface, contactez votre administrateur.</p>
<hr />
<h2>FAQ</h2>
<p><strong>Le chat conserve-t-il mes messages si je ferme l&rsquo;onglet ?</strong><br />
Oui, les conversations sont sauvegardées sur le serveur et restaurées automatiquement à la reconnexion.</p>
<p><strong>Puis-je utiliser le chat en anglais ?</strong><br />
Oui, l&rsquo;assistant comprend et répond en français et en anglais.</p>
<p><strong>Le chat a-t-il accès à mes données confidentielles ?</strong><br />
L&rsquo;assistant accède uniquement aux données de l&rsquo;enregistrement en cours et aux informations que vous lui transmettez dans la conversation. Il respecte les droits d&rsquo;accès de votre profil utilisateur.</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/">L&rsquo;assistant de texte IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/">Connecter une IA externe (MCP)</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/la-saisie-automatique-depuis-un-pdf/">L&rsquo;OCR de factures assisté par IA</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/">Le chat IA</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Connecter une IA externe (MCP)</title>
		<link>https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Mon, 13 Apr 2026 00:03:47 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/connecter-une-ia-externe-mcp/</guid>

					<description><![CDATA[<p>Introduction Le protocole MCP (Model Context Protocol) permet de connecter un client IA externe (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) directement à votre instance Kafinea. L&#8217;IA externe peut alors interroger vos données ERP, consulter des enregistrements et effectuer des recherches sans quitter votre outil de travail habituel. 1. Qu&#8217;est-ce que MCP ? MCP est...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/">Connecter une IA externe (MCP)</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<hr />
<h2>Introduction</h2>
<p>Le protocole <strong>MCP</strong> (Model Context Protocol) permet de connecter un client IA externe (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) directement à votre instance Kafinea. L&rsquo;IA externe peut alors interroger vos données ERP, consulter des enregistrements et effectuer des recherches sans quitter votre outil de travail habituel.</p>
<hr />
<h2>1. Qu&rsquo;est-ce que MCP ?</h2>
<p>MCP est un protocole standard permettant aux clients IA de se connecter à des serveurs d&rsquo;outils. Kafinea expose un serveur MCP qui donne accès aux données de l&rsquo;ERP de manière sécurisée, en respectant les droits d&rsquo;accès de l&rsquo;utilisateur connecté.</p>
<hr />
<h2>2. Accéder à la page de configuration</h2>
<ol>
<li>Connectez-vous à Kafinea</li>
<li>Accédez à <strong>Mes Préférences</strong> (menu utilisateur en haut à droite)</li>
<li>Cliquez sur le bouton <strong>Configuration MCP (IA externe)</strong></li>
</ol>
<p>La page affiche vos identifiants personnels et les configurations JSON prêtes à copier pour chaque client IA supporté.</p>
<hr />
<h2>3. Vos identifiants</h2>
<p>La page de configuration affiche trois informations essentielles :</p>
<ul>
<li><strong>Point d&rsquo;accès (URL)</strong> : l&rsquo;adresse du serveur MCP de votre instance Kafinea</li>
<li><strong>Nom d&rsquo;utilisateur</strong> : votre identifiant Kafinea</li>
<li><strong>Clé d&rsquo;accès</strong> : votre clé d&rsquo;accès personnelle (Access Key)</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> Ne partagez jamais votre clé d&rsquo;accès. Elle donne accès à vos données Kafinea avec vos droits utilisateur.</p>
</blockquote>
<hr />
<h2>4. Configurer votre client IA</h2>
<p>Pour chaque client IA, la page propose un bloc de configuration JSON prêt à copier. Cliquez sur le bouton <strong>Copier</strong> à côté du client souhaité.</p>
<h3>Claude Desktop</h3>
<ol>
<li>Ouvrez Claude Desktop</li>
<li>Accédez à <strong>Settings → Developer → MCP Servers</strong></li>
<li>Collez la configuration JSON copiée dans le fichier <code>claude_desktop_config.json</code></li>
<li>Redémarrez Claude Desktop</li>
</ol>
<h3>Cursor</h3>
<ol>
<li>Ouvrez Cursor</li>
<li>Accédez à <strong>Settings → MCP → Add Server</strong></li>
<li>Choisissez le type <strong>JSON</strong></li>
<li>Collez la configuration copiée</li>
</ol>
<h3>Windsurf</h3>
<ol>
<li>Ouvrez le fichier <code>mcp_config.json</code> de Windsurf</li>
<li>Collez la configuration copiée</li>
<li>Redémarrez Windsurf</li>
</ol>
<h3>VS Code / GitHub Copilot</h3>
<ol>
<li>Créez ou ouvrez le fichier <code>.vscode/mcp.json</code> dans votre projet</li>
<li>Ou accédez aux settings utilisateur de VS Code</li>
<li>Collez la configuration copiée</li>
</ol>
<h3>JetBrains (IntelliJ, PhpStorm, …)</h3>
<ol>
<li>Accédez à <strong>Settings → Tools → AI Assistant → MCP Servers</strong></li>
<li>Collez la configuration copiée</li>
</ol>
<hr />
<h2>5. Tester la connexion</h2>
<p>Une fois la configuration en place :</p>
<ol>
<li>Redémarrez votre client IA si nécessaire</li>
<li>Posez une question qui fait référence à des données Kafinea (par exemple : « Liste mes dernières factures »)</li>
<li>Le client IA devrait être capable d&rsquo;interroger Kafinea et d&rsquo;afficher les résultats</li>
</ol>
<hr />
<h2>6. Sécurité</h2>
<ul>
<li>Chaque utilisateur a sa propre clé d&rsquo;accès</li>
<li>Les requêtes MCP respectent les droits d&rsquo;accès de l&rsquo;utilisateur</li>
<li>Ne publiez jamais la configuration JSON dans un dépôt public</li>
<li>Si votre clé d&rsquo;accès est compromise, générez-en une nouvelle depuis Mes Préférences</li>
</ul>
<hr />
<h2>FAQ</h2>
<p><strong>Ma clé d&rsquo;accès a changé, que faire ?</strong><br />
Retournez sur la page Configuration MCP et copiez à nouveau la configuration avec la nouvelle clé.</p>
<p><strong>Le client IA n&rsquo;arrive pas à se connecter</strong><br />
Vérifiez que l&rsquo;URL du point d&rsquo;accès est correcte et accessible depuis votre poste. Vérifiez aussi que le serveur MCP est activé par votre administrateur.</p>
<p><strong>Quelles données l&rsquo;IA externe peut-elle voir ?</strong><br />
Uniquement les données auxquelles vous avez accès dans Kafinea, selon votre profil et vos droits.</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/le-chat-ia/">Le chat IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/lassistant-de-texte-ia/">L&rsquo;assistant de texte IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a></li>
<li><a href="https://www.kafinea.com/documentation/intelligence-artificielle/la-saisie-automatique-depuis-un-pdf/">L&rsquo;OCR de factures assisté par IA</a></li>
<li><a href="/250_parametrage/130_le-serveur-mcp.md">Le serveur MCP (admin)</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/intelligence-artificielle/connecter-une-ia-externe-mcp/">Connecter une IA externe (MCP)</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>La configuration des taxes</title>
		<link>https://www.kafinea.com/documentation/parametrage/la-configuration-des-taxes/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Sun, 12 Apr 2026 18:57:04 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/la-configuration-des-taxes/</guid>

					<description><![CDATA[<p>📍 Où trouver ce module ?Paramètres &#62; Gestion fiscale &#62; Calcul des taxes Introduction Le module Calcul des taxes permet de configurer les taxes applicables aux produits et services dans Kafinea. Il est accessible via Paramètres &#62; Gestion fiscale &#62; Calcul des taxes. Le panneau de configuration comporte trois onglets : Taxes : les taxes...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/la-configuration-des-taxes/">La configuration des taxes</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Où trouver ce module ?</strong><br /><em>Paramètres &gt; Gestion fiscale &gt; Calcul des taxes</em></p>
</blockquote>
<hr />
<h2>Introduction</h2>
<p>Le module <strong>Calcul des taxes</strong> permet de configurer les taxes applicables aux produits et services dans Kafinea. Il est accessible via <em><strong>Paramètres &gt; Gestion fiscale &gt; Calcul des taxes</strong></em>.</p>
<p>Le panneau de configuration comporte trois onglets :</p>
<ul>
<li><strong>Taxes</strong> : les taxes applicables aux produits et services (TVA, écotaxe, etc.)</li>
<li><strong>Charges et leurs taxes</strong> : les taxes sur les frais annexes (livraison, etc.)</li>
<li><strong>Régions fiscales</strong> : les zones géographiques avec des taux de taxation différents</li>
</ul>
<hr />
<h2>1. Comprendre les catégories de taxes</h2>
<h3>La TVA en France</h3>
<p>:::info À noter<br />
Les taux de TVA présentés ci-dessous sont fournis <strong>à titre indicatif</strong> et reflètent les taux en vigueur au moment de la rédaction de cette documentation. La réglementation fiscale pouvant évoluer, il appartient à chaque entreprise de vérifier les taux applicables auprès des sources officielles (ex : <a href="https://www.service-public.fr">service-public.fr</a>) et de mettre à jour sa configuration dans Kafinea en conséquence.<br />
:::</p>
<p>En France, la TVA se décline en <strong>quatre catégories</strong> dont le taux varie selon la zone géographique :</p>
<table>
<thead>
<tr>
<th>Catégorie</th>
<th>France métropolitaine</th>
<th>Corse</th>
<th>DOM (Guadeloupe, Martinique, Réunion)</th>
<th>Guyane / Mayotte</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Taux normal</strong></td>
<td>20 %</td>
<td>20 %</td>
<td>8,5 %</td>
<td>0 %</td>
</tr>
<tr>
<td><strong>Taux intermédiaire</strong></td>
<td>10 %</td>
<td>10 %</td>
<td>2,1 %</td>
<td>0 %</td>
</tr>
<tr>
<td><strong>Taux réduit</strong></td>
<td>5,5 %</td>
<td>5,5 %</td>
<td>2,1 %</td>
<td>0 %</td>
</tr>
<tr>
<td><strong>Taux super-réduit</strong></td>
<td>2,1 %</td>
<td>0,9 %</td>
<td>1,05 %</td>
<td>0 %</td>
</tr>
</tbody>
</table>
<h3>Les autres taxes</h3>
<p>La TVA n&rsquo;est pas la seule taxe applicable aux produits et services. Selon votre activité, d&rsquo;autres taxes peuvent s&rsquo;appliquer :</p>
<ul>
<li>Taxe sur les métaux précieux</li>
<li>Contribution sur les emballages</li>
<li>Écotaxe / éco-contribution</li>
<li>DEEE (déchets d&rsquo;équipements électriques et électroniques)</li>
<li>Taxe sur les huiles alimentaires</li>
</ul>
<p>Chaque taxe doit faire l&rsquo;objet d&rsquo;une entrée distincte dans Kafinea.</p>
<hr />
<h2>2. Configurer les régions fiscales</h2>
<blockquote class="bq-important">
<p><strong>Important :</strong> Configurez les régions fiscales <strong>avant</strong> de créer vos taxes de type Variable.</p>
</blockquote>
<p>Les régions fiscales permettent de définir des taux différents pour une même taxe selon la zone géographique.</p>
<h3>Créer une région</h3>
<ol>
<li>Accédez à <em><strong>Paramètres &gt; Gestion fiscale &gt; Calcul des taxes</strong></em></li>
<li>Cliquez sur l&rsquo;onglet <strong>Régions fiscales</strong></li>
<li>Cliquez sur <strong>Ajouter une nouvelle région</strong></li>
<li>Saisissez le nom de la région (ex : « France métropolitaine »)</li>
</ol>
<h3>Régions recommandées pour la France</h3>
<ul>
<li><strong>France métropolitaine</strong></li>
<li><strong>Corse</strong></li>
<li><strong>DOM</strong> (Guadeloupe, Martinique, Réunion)</li>
<li><strong>Guyane / Mayotte</strong></li>
</ul>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Vous pouvez regrouper plusieurs territoires dans une même région s&rsquo;ils partagent les mêmes taux de taxation.</p>
</blockquote>
<hr />
<h2>3. Créer les taxes</h2>
<h3>Bonnes pratiques de nommage</h3>
<p><strong>Nommez vos taxes par catégorie</strong>, et non par taux.</p>
<table>
<thead>
<tr>
<th>✅ Bonne pratique</th>
<th>❌ Mauvaise pratique</th>
</tr>
</thead>
<tbody>
<tr>
<td>TVA &#8211; Taux normal</td>
<td>TVA 20 %</td>
</tr>
<tr>
<td>TVA &#8211; Taux intermédiaire</td>
<td>TVA 10 %</td>
</tr>
<tr>
<td>TVA &#8211; Taux réduit</td>
<td>TVA 5,5 %</td>
</tr>
<tr>
<td>TVA &#8211; Taux super-réduit</td>
<td>TVA 2,1 %</td>
</tr>
</tbody>
</table>
<blockquote class="bq-important">
<p><strong>Important :</strong> Nommer une taxe « TVA 20 % » est trompeur car le taux de 20 % ne s&rsquo;applique qu&rsquo;en France métropolitaine. En Corse ou dans les DOM, le taux normal est différent.</p>
</blockquote>
<h3>Créer une taxe de type Variable</h3>
<ol>
<li>Accédez à l&rsquo;onglet <strong>Taxes</strong></li>
<li>Cliquez sur <strong>Ajouter une nouvelle taxe</strong></li>
<li>Renseignez le <strong>nom</strong> (ex : « TVA &#8211; Taux normal »)</li>
<li>Sélectionnez le type <strong>Variable</strong></li>
<li>Renseignez la <strong>valeur par défaut</strong> (ex : 20 pour la France métropolitaine)</li>
<li>Ajoutez des <strong>tranches régionales</strong> en cliquant sur <strong>Ajouter une tranche de taxe</strong> :
<ul>
<li>Sélectionnez la ou les régions concernées</li>
<li>Indiquez le taux applicable</li>
</ul>
</li>
</ol>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Pour la taxe « TVA &#8211; Taux normal » :</p>
<ul>
<li>Valeur par défaut : 20 (France métropolitaine)</li>
<li>Corse : 20</li>
<li>DOM : 8,5</li>
<li>Guyane / Mayotte : 0</li>
</ul>
</blockquote>
<h3>Type Fixed vs Variable</h3>
<ul>
<li><strong>Fixed</strong> : un taux unique, identique quelle que soit la région. Adapté aux taxes qui ne varient pas géographiquement.</li>
<li><strong>Variable</strong> : un taux par défaut + des taux spécifiques par région. <strong>Recommandé pour la TVA</strong> et toute taxe dont le taux varie selon la zone géographique.</li>
</ul>
<h3>Méthode de calcul</h3>
<ul>
<li><strong>Simple</strong> : la taxe est calculée sur le montant de base</li>
<li><strong>Composée</strong> (Compound) : la taxe est calculée sur le montant de base + d&rsquo;autres taxes sélectionnées</li>
<li><strong>Déduite</strong> (Deducted) : la taxe est incluse dans le prix et déduite du montant</li>
</ul>
<hr />
<h2>4. Affecter les taxes aux produits et services</h2>
<p>Une fois les taxes configurées, chaque fiche produit ou service affiche les taxes disponibles dans le bloc <strong>Information tarif</strong>.</p>
<ol>
<li>Ouvrez la fiche d&rsquo;un produit ou service en mode édition</li>
<li>Dans la section des taxes, <strong>cochez</strong> la ou les taxes applicables à cet article</li>
<li>Le taux affiché est le taux par défaut ; il sera automatiquement ajusté selon la région fiscale sélectionnée lors de la création d&rsquo;un devis, d&rsquo;une facture ou d&rsquo;une commande</li>
</ol>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> En général, un produit standard n&rsquo;a besoin que d&rsquo;une seule catégorie de TVA cochée (ex : « TVA &#8211; Taux normal »). Certains produits spécifiques peuvent nécessiter des taxes supplémentaires.</p>
</blockquote>
<hr />
<h2>5. Utilisation dans les documents commerciaux</h2>
<p>Lors de la création d&rsquo;un devis, d&rsquo;une facture ou d&rsquo;une commande :</p>
<ul>
<li>La <strong>région fiscale</strong> est sélectionnée sur le document</li>
<li>Le système applique automatiquement le taux correspondant à la région pour chaque taxe de type Variable</li>
<li>Si aucune région n&rsquo;est spécifiée, le taux par défaut est utilisé</li>
</ul>
<hr />
<h2>FAQ</h2>
<p><strong>Pourquoi ne pas simplement créer « TVA 20 % » ?</strong><br />
Parce que le taux de TVA dépend de la zone géographique. En créant « TVA &#8211; Taux normal » avec le type Variable, vous permettez au système d&rsquo;appliquer automatiquement le bon taux (20 % en métropole, 8,5 % dans les DOM, etc.).</p>
<p><strong>Un produit peut-il avoir plusieurs taxes ?</strong><br />
Oui. Un produit peut être soumis à la TVA et à une autre taxe (écotaxe, DEEE, etc.). Cochez toutes les taxes applicables sur la fiche produit.</p>
<p><strong>Que se passe-t-il si je ne configure pas de régions fiscales ?</strong><br />
Les taxes fonctionneront avec leur taux par défaut (type Fixed ou valeur par défaut du type Variable). Vous ne pourrez pas bénéficier de l&rsquo;ajustement automatique par zone géographique.</p>
<hr />
<h2>Références associées</h2>
<ul>
<li><a href="/documentation/public/080_catalogue">Les produits</a> — Gestion du catalogue produits</li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/parametrage/la-configuration-des-taxes/">La configuration des taxes</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les flux de travail (workflows)</title>
		<link>https://www.kafinea.com/documentation/automatisation/les-workflows/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Fri, 10 Apr 2026 22:10:35 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/les-workflows/</guid>

					<description><![CDATA[<p>Les flux de travail (ou workflows) sont le moteur d&#8217;automatisation de Kafinea. Ils permettent de déclencher automatiquement des actions lorsqu&#8217;un événement survient sur un enregistrement : envoi d&#8217;email, mise à jour de champs, création d&#8217;enregistrement, appel à un service externe, etc. Correctement configurés, ils éliminent les tâches répétitives, réduisent les erreurs humaines et garantissent l&#8217;application...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/automatisation/les-workflows/">Les flux de travail (workflows)</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<p>Les <strong>flux de travail</strong> (ou <em>workflows</em>) sont le moteur d&rsquo;automatisation de Kafinea. Ils permettent de déclencher automatiquement des actions lorsqu&rsquo;un événement survient sur un enregistrement : envoi d&#8217;email, mise à jour de champs, création d&rsquo;enregistrement, appel à un service externe, etc. Correctement configurés, ils éliminent les tâches répétitives, réduisent les erreurs humaines et garantissent l&rsquo;application systématique de vos règles métier.</p>
<hr />
<h2>1. Accéder aux workflows</h2>
<p>Les workflows se gèrent depuis <em><strong>Paramètres &gt; Automatisation et communication &gt; Flux de travail</strong></em>. La liste affiche tous les workflows existants avec leur module cible, leur statut (actif/inactif) et leur description.</p>
<p>Depuis cette liste, vous pouvez :</p>
<ul>
<li><strong>Créer</strong> un nouveau workflow</li>
<li><strong>Modifier</strong> un workflow existant</li>
<li><strong>Activer ou désactiver</strong> un workflow</li>
<li><strong>Supprimer</strong> un workflow</li>
</ul>
<hr />
<h2>2. Créer un workflow</h2>
<p>La création d&rsquo;un workflow se déroule en trois étapes : les informations de base, le déclencheur, puis les conditions et actions.</p>
<h3>Étape 1 — Informations de base</h3>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Champ</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Nom</strong></td>
<td>Un nom explicite pour identifier le workflow (ex : « Relance facture impayée »)</td>
</tr>
<tr>
<td><strong>Description</strong></td>
<td>Une description optionnelle du comportement attendu</td>
</tr>
<tr>
<td><strong>Module cible</strong></td>
<td>Le module sur lequel le workflow s&rsquo;applique (Factures, Contacts, Tickets…)</td>
</tr>
<tr>
<td><strong>Statut</strong></td>
<td>Actif ou inactif — un workflow inactif ne se déclenche jamais</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Adoptez une convention de nommage claire pour vos workflows. Par exemple : « [Module] — Action » (ex : « Facture — Envoi automatique après finalisation »). Cela facilite la maintenance lorsque le nombre de workflows augmente.</p>
</blockquote>
<h3>Étape 2 — Déclencheur</h3>
<p>Le déclencheur détermine <strong>quand</strong> le workflow s&rsquo;exécute. Trois types de déclencheurs sont disponibles :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Déclencheur</th>
<th>Comportement</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>À la création</strong></td>
<td>Le workflow s&rsquo;exécute uniquement lors de la création d&rsquo;un nouvel enregistrement</td>
</tr>
<tr>
<td><strong>À la modification</strong></td>
<td>Le workflow s&rsquo;exécute à chaque modification de l&rsquo;enregistrement (y compris à la création)</td>
</tr>
<tr>
<td><strong>Par intervalle de temps</strong></td>
<td>Le workflow s&rsquo;exécute selon une planification temporelle (voir section « Planification »)</td>
</tr>
</tbody>
</table>
</div>
<p><strong>Récurrence (pour le déclencheur « À la modification ») :</strong></p>
<p>Lorsque vous choisissez le déclencheur « À la modification », vous pouvez préciser la récurrence :</p>
<ul>
<li><strong>La première fois que la condition est remplie</strong> : le workflow ne s&rsquo;exécute qu&rsquo;une seule fois par enregistrement, la première fois que les conditions sont satisfaites</li>
<li><strong>À chaque fois que la condition est remplie</strong> : le workflow s&rsquo;exécute à chaque sauvegarde tant que les conditions sont satisfaites</li>
</ul>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Un workflow « Envoyer un email de bienvenue » sur le module Contacts avec la récurrence « La première fois que la condition est remplie » garantit qu&rsquo;un seul email de bienvenue est envoyé par contact, même si la fiche est modifiée plusieurs fois par la suite.</p>
</blockquote>
<h3>Planification (déclencheur par intervalle de temps)</h3>
<p>Lorsque le déclencheur est « Par intervalle de temps », vous configurez la fréquence d&rsquo;exécution :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Fréquence</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Toutes les heures</strong></td>
<td>Exécution à chaque heure</td>
</tr>
<tr>
<td><strong>Quotidien</strong></td>
<td>Exécution une fois par jour à une heure précise</td>
</tr>
<tr>
<td><strong>Hebdomadaire</strong></td>
<td>Exécution certains jours de la semaine à une heure précise</td>
</tr>
<tr>
<td><strong>Mensuel par date</strong></td>
<td>Exécution certains jours du mois (ex : le 1er et le 15)</td>
</tr>
<tr>
<td><strong>Date spécifique</strong></td>
<td>Exécution unique à une date précise</td>
</tr>
<tr>
<td><strong>Annuel</strong></td>
<td>Exécution à des dates précises chaque année</td>
</tr>
</tbody>
</table>
</div>
<p>Pour toutes les fréquences sauf « Toutes les heures », vous définissez l&rsquo;heure d&rsquo;exécution.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> Les workflows planifiés sont exécutés par le planificateur de Kafinea. Ils s&rsquo;appliquent à <strong>tous les enregistrements</strong> du module cible qui correspondent aux conditions définies, et non à un enregistrement unique. C&rsquo;est ce qui les rend particulièrement puissants pour les traitements en masse (relances, mises à jour périodiques, notifications…).</p>
</blockquote>
<blockquote class="bq-important">
<p><strong>Important :</strong> Le nombre de workflows planifiés est limité. Si la limite est atteinte, l&rsquo;option « Par intervalle de temps » est désactivée. Contactez votre administrateur si vous avez besoin d&rsquo;augmenter cette limite.</p>
</blockquote>
<h3>Étape 3 — Conditions et actions</h3>
<p>Après avoir défini le déclencheur, vous configurez les <strong>conditions</strong> de filtrage et les <strong>actions</strong> à exécuter.</p>
<hr />
<h2>3. Les conditions</h2>
<p>Les conditions déterminent <strong>quels enregistrements</strong> sont concernés par le workflow. Elles fonctionnent comme un filtre avancé.</p>
<h3>Construire une condition</h3>
<p>Chaque condition se compose de :</p>
<ol>
<li><strong>Un champ</strong> du module cible (ou d&rsquo;un module lié)</li>
<li><strong>Un opérateur</strong> de comparaison</li>
<li><strong>Une valeur</strong> de référence</li>
</ol>
<p><strong>Opérateurs disponibles :</strong></p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Opérateur</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>est égal à</strong></td>
<td>Valeur exacte</td>
</tr>
<tr>
<td><strong>n&rsquo;est pas égal à</strong></td>
<td>Différent de la valeur</td>
</tr>
<tr>
<td><strong>commence par</strong></td>
<td>Le champ commence par la valeur</td>
</tr>
<tr>
<td><strong>se termine par</strong></td>
<td>Le champ se termine par la valeur</td>
</tr>
<tr>
<td><strong>contient</strong></td>
<td>Le champ contient la valeur</td>
</tr>
<tr>
<td><strong>ne contient pas</strong></td>
<td>Le champ ne contient pas la valeur</td>
</tr>
<tr>
<td><strong>est inférieur à</strong></td>
<td>Valeur numérique ou date inférieure</td>
</tr>
<tr>
<td><strong>est supérieur à</strong></td>
<td>Valeur numérique ou date supérieure</td>
</tr>
<tr>
<td><strong>est inférieur ou égal à</strong></td>
<td>Valeur numérique ou date inférieure ou égale</td>
</tr>
<tr>
<td><strong>est supérieur ou égal à</strong></td>
<td>Valeur numérique ou date supérieure ou égale</td>
</tr>
<tr>
<td><strong>est vide</strong></td>
<td>Le champ n&rsquo;a pas de valeur</td>
</tr>
<tr>
<td><strong>n&rsquo;est pas vide</strong></td>
<td>Le champ a une valeur</td>
</tr>
<tr>
<td><strong>a changé</strong></td>
<td>Le champ a été modifié (utile avec le déclencheur « À la modification »)</td>
</tr>
<tr>
<td><strong>a changé pour</strong></td>
<td>Le champ a été modifié et sa nouvelle valeur correspond</td>
</tr>
</tbody>
</table>
</div>
<h3>Groupes de conditions</h3>
<p>Les conditions peuvent être combinées avec les opérateurs logiques <strong>ET</strong> et <strong>OU</strong> :</p>
<ul>
<li><strong>Toutes les conditions</strong> (ET) : toutes les conditions du groupe doivent être vraies</li>
<li><strong>Au moins une condition</strong> (OU) : au moins une condition du groupe doit être vraie</li>
</ul>
<p>Vous pouvez créer plusieurs groupes de conditions pour construire des règles complexes.</p>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Pour un workflow de relance de factures impayées, vous pourriez définir :</p>
<ul>
<li>Groupe 1 (ET) : Statut <em>est égal à</em> « Envoyée » <strong>ET</strong> Date d&rsquo;échéance <em>est inférieur à</em> « aujourd&rsquo;hui »</li>
</ul>
<p>Ce workflow ciblera toutes les factures envoyées dont la date d&rsquo;échéance est dépassée.</p>
</blockquote>
<h3>Expressions dans les conditions</h3>
<p>En plus des valeurs fixes, vous pouvez utiliser des <strong>expressions</strong> dynamiques dans les conditions :</p>
<ul>
<li><strong>Aujourd&rsquo;hui</strong> : la date du jour</li>
<li><strong>Demain</strong> : la date du lendemain</li>
<li><strong>Hier</strong> : la date de la veille</li>
<li><strong>Valeur d&rsquo;un autre champ</strong> : comparer un champ avec la valeur d&rsquo;un autre champ du même enregistrement</li>
</ul>
<hr />
<h2>4. Les actions (tâches)</h2>
<p>Les actions définissent <strong>ce que fait</strong> le workflow lorsque les conditions sont remplies. Vous pouvez ajouter plusieurs actions à un même workflow, qui s&rsquo;exécuteront dans l&rsquo;ordre.</p>
<h3>Envoyer un email</h3>
<p>Envoie un email à un ou plusieurs destinataires.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Destinataire</strong></td>
<td>Adresse email d&rsquo;un champ de l&rsquo;enregistrement, d&rsquo;un utilisateur, d&rsquo;un groupe, ou une adresse fixe</td>
</tr>
<tr>
<td><strong>Objet</strong></td>
<td>L&rsquo;objet de l&#8217;email (peut contenir des variables de l&rsquo;enregistrement)</td>
</tr>
<tr>
<td><strong>Corps</strong></td>
<td>Le contenu de l&#8217;email au format texte enrichi (peut contenir des variables de l&rsquo;enregistrement)</td>
</tr>
<tr>
<td><strong>Pièces jointes</strong></td>
<td>Documents liés à l&rsquo;enregistrement</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-note">
<p><strong>Note :</strong> Les emails ne sont pas envoyés instantanément. Ils sont placés dans une file d&rsquo;attente et envoyés par le <a href="https://www.kafinea.com/documentation/automatisation/le-planificateur/">planificateur</a>. Un léger délai est donc normal entre le déclenchement du workflow et la réception de l&#8217;email.</p>
</blockquote>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Utilisez les variables (ex : <code>$contacts-lastname$</code>, <code>$invoice-invoice_no$</code>) pour personnaliser le contenu de l&#8217;email avec les données de l&rsquo;enregistrement. La liste des variables disponibles est affichée dans l&rsquo;éditeur.</p>
</blockquote>
<h3>Mettre à jour des champs</h3>
<p>Modifie automatiquement la valeur d&rsquo;un ou plusieurs champs de l&rsquo;enregistrement.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Champ</strong></td>
<td>Le champ à modifier</td>
</tr>
<tr>
<td><strong>Valeur</strong></td>
<td>La nouvelle valeur (fixe, expression, ou valeur d&rsquo;un autre champ)</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Lorsqu&rsquo;un ticket passe au statut « Résolu », mettre automatiquement le champ « Date de résolution » à la date du jour.</p>
</blockquote>
<h3>Créer une tâche (todo)</h3>
<p>Crée automatiquement une tâche dans le calendrier.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Titre</strong></td>
<td>Le titre de la tâche</td>
</tr>
<tr>
<td><strong>Statut</strong></td>
<td>Le statut initial de la tâche</td>
</tr>
<tr>
<td><strong>Priorité</strong></td>
<td>La priorité de la tâche</td>
</tr>
<tr>
<td><strong>Date d&rsquo;échéance</strong></td>
<td>La date limite (peut être calculée, ex : « 3 jours après aujourd&rsquo;hui »)</td>
</tr>
<tr>
<td><strong>Assigné à</strong></td>
<td>L&rsquo;utilisateur ou le groupe responsable</td>
</tr>
</tbody>
</table>
</div>
<h3>Créer un événement</h3>
<p>Crée automatiquement un événement dans le calendrier (réunion, appel…).</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Titre</strong></td>
<td>Le titre de l&rsquo;événement</td>
</tr>
<tr>
<td><strong>Type</strong></td>
<td>Appel, réunion, etc.</td>
</tr>
<tr>
<td><strong>Date et heure</strong></td>
<td>Le début et la fin de l&rsquo;événement</td>
</tr>
<tr>
<td><strong>Assigné à</strong></td>
<td>L&rsquo;utilisateur ou le groupe responsable</td>
</tr>
</tbody>
</table>
</div>
<h3>Créer un enregistrement</h3>
<p>Crée automatiquement un nouvel enregistrement dans un autre module.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Module cible</strong></td>
<td>Le module dans lequel créer l&rsquo;enregistrement</td>
</tr>
<tr>
<td><strong>Correspondance des champs</strong></td>
<td>L&rsquo;association entre les champs de l&rsquo;enregistrement source et ceux du nouvel enregistrement</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> À la création d&rsquo;un devis accepté, créer automatiquement une commande client avec les mêmes lignes de produits.</p>
</blockquote>
<h3>Appeler une fonction personnalisée</h3>
<p>Exécute une fonction métier spécifique développée pour votre instance Kafinea. Ces fonctions permettent d&rsquo;automatiser des traitements complexes qui ne sont pas réalisables avec les actions standard.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> Les fonctions personnalisées disponibles dépendent de votre configuration. Consultez votre intégrateur pour connaître les fonctions disponibles et en créer de nouvelles.</p>
</blockquote>
<h3>Webhook</h3>
<p>Envoie une requête HTTP vers un service externe lorsque le workflow se déclenche. C&rsquo;est l&rsquo;outil idéal pour connecter Kafinea à d&rsquo;autres applications.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>URL</strong></td>
<td>L&rsquo;adresse du service externe à appeler</td>
</tr>
<tr>
<td><strong>Méthode HTTP</strong></td>
<td>POST, GET, PUT, PATCH ou DELETE</td>
</tr>
<tr>
<td><strong>Format</strong></td>
<td>Le format des données envoyées (JSON)</td>
</tr>
<tr>
<td><strong>Authentification</strong></td>
<td>Aucune, Basic Auth, Bearer Token ou en-tête personnalisé</td>
</tr>
</tbody>
</table>
</div>
<p>Les données de l&rsquo;enregistrement sont automatiquement incluses dans la requête au format JSON, avec le type d&rsquo;enregistrement et l&rsquo;ensemble de ses champs.</p>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Lorsqu&rsquo;une facture est finalisée, envoyer un webhook vers votre logiciel de comptabilité pour synchroniser automatiquement les écritures.</p>
</blockquote>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Les webhooks permettent d&rsquo;intégrer Kafinea avec des plateformes d&rsquo;automatisation comme Zapier, Make (ex-Integromat) ou n8n, ouvrant ainsi des possibilités d&rsquo;intégration quasi illimitées.</p>
</blockquote>
<h3>Prompt IA</h3>
<p>Envoie les données de l&rsquo;enregistrement à un service d&rsquo;intelligence artificielle avec un prompt personnalisé, puis met à jour automatiquement des champs avec la réponse générée.</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Paramètre</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Prompt</strong></td>
<td>Les instructions envoyées à l&rsquo;IA (ce que vous lui demandez de faire)</td>
</tr>
<tr>
<td><strong>Champs à mettre à jour</strong></td>
<td>Les champs de l&rsquo;enregistrement qui recevront la réponse de l&rsquo;IA</td>
</tr>
</tbody>
</table>
</div>
<p>L&rsquo;IA reçoit automatiquement le contexte complet de l&rsquo;enregistrement : ses champs, les enregistrements parents liés, les documents attachés, les images, les lignes de produits et les informations de l&rsquo;organisation.</p>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> À la création d&rsquo;un ticket de support, utiliser l&rsquo;IA pour analyser la description du problème et remplir automatiquement le champ « Catégorie » et le champ « Priorité suggérée ».</p>
</blockquote>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> À la réception d&rsquo;une facture fournisseur numérisée, utiliser l&rsquo;IA pour extraire automatiquement le montant, la date et le numéro de facture depuis le document attaché.</p>
</blockquote>
<h3>Envoyer un SMS</h3>
<p>Envoie un SMS à un numéro de téléphone issu de l&rsquo;enregistrement.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> Cette action nécessite la configuration préalable d&rsquo;un fournisseur SMS dans les paramètres de Kafinea.</p>
</blockquote>
<hr />
<h2>5. Cas d&rsquo;usage courants</h2>
<h3>Automatisation commerciale</h3>
<ul>
<li><strong>Relance de factures impayées</strong> : workflow planifié quotidien qui envoie un email de relance pour les factures dont la date d&rsquo;échéance est dépassée</li>
<li><strong>Notification de nouveau devis</strong> : à la création d&rsquo;un devis, envoyer un email au responsable commercial</li>
<li><strong>Suivi des opportunités</strong> : créer une tâche de rappel lorsqu&rsquo;une opportunité n&rsquo;a pas été mise à jour depuis 7 jours</li>
</ul>
<h3>Gestion de projet</h3>
<ul>
<li><strong>Notification d&rsquo;affectation</strong> : envoyer un email à une personne lorsqu&rsquo;elle est affectée à une tâche de projet</li>
<li><strong>Mise à jour de statut</strong> : mettre à jour automatiquement le statut d&rsquo;un projet lorsque toutes ses tâches sont terminées</li>
</ul>
<h3>Support client</h3>
<ul>
<li><strong>Accusé de réception</strong> : envoyer un email de confirmation au client lors de la création d&rsquo;un ticket</li>
<li><strong>Escalade automatique</strong> : si un ticket n&rsquo;est pas traité dans les 48 heures, envoyer une notification au responsable d&rsquo;équipe</li>
<li><strong>Notification de résolution</strong> : envoyer un email au client lorsque le ticket passe au statut « Résolu »</li>
</ul>
<h3>Ressources humaines</h3>
<ul>
<li><strong>Email de bienvenue</strong> : envoyer un email de bienvenue lors de la création d&rsquo;une nouvelle fiche personne</li>
<li><strong>Rappel de fin de contrat</strong> : workflow planifié qui notifie le service RH 30 jours avant la fin d&rsquo;un contrat de travail</li>
</ul>
<h3>Intégrations externes</h3>
<ul>
<li><strong>Synchronisation comptable</strong> : envoyer un webhook vers le logiciel de comptabilité à chaque facture finalisée</li>
<li><strong>Notification Slack/Teams</strong> : envoyer un webhook vers un canal de messagerie lors d&rsquo;événements importants</li>
<li><strong>Enrichissement par IA</strong> : analyser automatiquement les documents entrants et remplir les champs pertinents</li>
</ul>
<hr />
<h2>6. Bonnes pratiques</h2>
<ul>
<li><strong>Un workflow = une responsabilité</strong> : évitez de surcharger un workflow avec trop d&rsquo;actions. Préférez plusieurs workflows simples à un workflow complexe</li>
<li><strong>Nommez clairement</strong> : un bon nom de workflow décrit son déclencheur et son action (ex : « Facture — Relance J+30 »)</li>
<li><strong>Testez avant d&rsquo;activer</strong> : créez le workflow en statut inactif, vérifiez les conditions sur quelques enregistrements, puis activez-le</li>
<li><strong>Utilisez la récurrence « une seule fois »</strong> pour les notifications ponctuelles (bienvenue, confirmation) afin d&rsquo;éviter les envois multiples</li>
<li><strong>Documentez vos workflows</strong> : utilisez le champ description pour expliquer le contexte métier et les règles appliquées</li>
<li><strong>Surveillez les workflows planifiés</strong> : vérifiez régulièrement dans le <a href="https://www.kafinea.com/documentation/automatisation/le-planificateur/">planificateur</a> que les exécutions se déroulent correctement</li>
</ul>
<hr />
<h2>7. Questions fréquentes</h2>
<p><strong>Puis-je avoir plusieurs actions dans un même workflow ?</strong><br />
Oui, vous pouvez ajouter autant d&rsquo;actions que nécessaire. Elles s&rsquo;exécutent dans l&rsquo;ordre dans lequel elles apparaissent.</p>
<p><strong>Mon email de workflow n&rsquo;est pas envoyé immédiatement, est-ce normal ?</strong><br />
Oui, les emails sont placés dans une file d&rsquo;attente et envoyés par le <a href="https://www.kafinea.com/documentation/automatisation/le-planificateur/">planificateur</a>. Le délai dépend de la fréquence d&rsquo;exécution du planificateur (généralement quelques minutes).</p>
<p><strong>Comment savoir si un workflow s&rsquo;est bien exécuté ?</strong><br />
Consultez le <a href="https://www.kafinea.com/documentation/parametrage/le-journal-devenements/">journal d&rsquo;événements</a> pour vérifier les exécutions et identifier d&rsquo;éventuelles erreurs.</p>
<p><strong>Puis-je utiliser un workflow pour modifier un enregistrement lié (parent ou enfant) ?</strong><br />
Oui, l&rsquo;action « Mettre à jour des champs » permet de modifier directement les champs d&rsquo;un enregistrement parent lié via un champ de référence. Dans l&rsquo;interface de configuration, les champs des modules liés apparaissent sous la forme « (Champ de référence : (Module) Champ cible) ». Par exemple, vous pouvez mettre à jour le téléphone d&rsquo;un compte depuis un workflow sur les contacts. En revanche, pour modifier des enregistrements enfants (qui référencent l&rsquo;enregistrement courant), utilisez l&rsquo;action « Appeler une fonction personnalisée » ou créez un workflow séparé sur le module enfant.</p>
<p><strong>Quelle est la différence entre un workflow planifié et le planificateur ?</strong><br />
Le <a href="https://www.kafinea.com/documentation/automatisation/le-planificateur/">planificateur</a> est le moteur technique qui exécute les tâches en arrière-plan (dont les workflows planifiés). Un workflow planifié est une règle métier que vous configurez et qui sera exécutée par le planificateur selon la fréquence définie.</p>
<p><strong>Puis-je dupliquer un workflow existant ?</strong><br />
Il n&rsquo;existe pas de fonction de duplication directe. Vous devez créer un nouveau workflow et reconfigurer les paramètres manuellement.</p>
<p><strong>Les workflows fonctionnent-ils lors d&rsquo;un import CSV ?</strong><br />
Non, les workflows ne se déclenchent pas lors d&rsquo;un import CSV. L&rsquo;import utilise un traitement par lot optimisé pour les performances qui ne passe pas par le mécanisme de déclenchement des workflows. Si vous avez besoin d&rsquo;appliquer des traitements automatiques après un import, vous pouvez utiliser un workflow planifié qui vérifiera périodiquement les enregistrements récemment créés ou modifiés.</p>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/automatisation/les-formulaires/">Les formulaires</a></li>
<li><a href="https://www.kafinea.com/documentation/automatisation/le-planificateur/">Le planificateur</a></li>
<li><a href="https://www.kafinea.com/documentation/modeles/les-modeles-d-emails/">Les modèles d&#8217;emails</a></li>
<li><a href="https://www.kafinea.com/documentation/parametrage/le-journal-devenements/">Le journal d&rsquo;événements</a></li>
<li><a href="https://www.kafinea.com/documentation/interface-kafinea/limport-export-de-donnees/">L&rsquo;import / export de données</a></li>
<li><a href="https://www.kafinea.com/documentation/api/api-rest-introduction/">L&rsquo;API Kafinea</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/automatisation/les-workflows/">Les flux de travail (workflows)</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>L&#8217;assistant de commandes fournisseurs</title>
		<link>https://www.kafinea.com/documentation/catalogue/lassistant-de-commandes-fournisseurs/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubdate>Fri, 03 Apr 2026 09:26:04 +0000</pubdate>
				<guid ispermalink="false">https://www.kafinea.com/documentation/uncategorized/lassistant-de-commandes-fournisseurs/</guid>

					<description><![CDATA[<p>📍 Comment accéder à cette fonctionnalité ?Fiche d&#039;un devis ou d&#039;une commande client &#62; bouton « Assistant commandes fournisseurs » L&#8217;assistant de commandes fournisseurs permet de générer automatiquement des bons de commande fournisseur à partir d&#8217;un devis ou d&#8217;une commande client, en s&#8217;appuyant sur les offres fournisseurs de vos produits standards. 1. Présentation Lorsqu&#8217;un devis...</p>
<p>L’article <a href="https://www.kafinea.com/documentation/catalogue/lassistant-de-commandes-fournisseurs/">L&rsquo;assistant de commandes fournisseurs</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Comment accéder à cette fonctionnalité ?</strong><br /><em>Fiche d&#039;un devis ou d&#039;une commande client &gt; bouton « Assistant commandes fournisseurs »</em></p>
</blockquote>
<p>L&rsquo;assistant de commandes fournisseurs permet de générer automatiquement des bons de commande fournisseur à partir d&rsquo;un devis ou d&rsquo;une commande client, en s&rsquo;appuyant sur les offres fournisseurs de vos produits standards.</p>
<hr />
<h2>1. Présentation</h2>
<p>Lorsqu&rsquo;un devis ou une commande client contient des <strong>produits standards</strong>, l&rsquo;assistant analyse les offres fournisseurs disponibles et propose de générer les bons de commande correspondants, <strong>groupés par fournisseur</strong>.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> L&rsquo;assistant ne concerne que les lignes contenant des produits standards. Les produits classiques (non standards) ne sont pas pris en compte par l&rsquo;assistant.</p>
</blockquote>
<h3>Différence avec « Créer Bon de commande »</h3>
<p>Les devis et commandes clients proposent deux actions distinctes pour créer des bons de commande fournisseur :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Action</th>
<th>Fonctionnement</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Créer Bon de commande</strong></td>
<td>Crée un bon de commande fournisseur unique en copiant directement les lignes du document. Le fournisseur doit être choisi manuellement. Fonctionne avec tous les produits.</td>
</tr>
<tr>
<td><strong>Assistant commandes fournisseurs</strong></td>
<td>Analyse les produits standards, sélectionne automatiquement les meilleurs fournisseurs à partir des offres, et génère un bon de commande par fournisseur. Fonctionne uniquement avec les produits standards.</td>
</tr>
</tbody>
</table>
</div>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Utilisez <strong>« Créer Bon de commande »</strong> pour un approvisionnement simple auprès d&rsquo;un fournisseur unique. Utilisez l&rsquo;<strong>assistant</strong> lorsque vos lignes contiennent des produits standards avec des offres fournisseurs multiples.</p>
</blockquote>
<hr />
<h2>2. Lancer l&rsquo;assistant</h2>
<ol>
<li>Ouvrez la fiche d&rsquo;un <strong>devis</strong> ou d&rsquo;une <strong>commande client</strong></li>
<li>Cliquez sur le bouton <strong>« Assistant commandes fournisseurs »</strong> dans les actions du document</li>
</ol>
<p>L&rsquo;assistant s&rsquo;ouvre et analyse automatiquement les lignes du document.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> Le bouton n&rsquo;apparaît que si vous avez les droits de création sur le module Bons de commande fournisseur.</p>
</blockquote>
<hr />
<h2>3. Écran de l&rsquo;assistant</h2>
<p>L&rsquo;assistant affiche un tableau avec les lignes du document contenant des produits standards :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Colonne</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>☑</strong></td>
<td>Cochez ou décochez pour inclure ou exclure la ligne</td>
</tr>
<tr>
<td><strong>Produit standard</strong></td>
<td>Le produit du devis ou de la commande</td>
</tr>
<tr>
<td><strong>Produit spécifique</strong></td>
<td>Le produit concret à commander (modifiable)</td>
</tr>
<tr>
<td><strong>Fournisseur</strong></td>
<td>L&rsquo;offre fournisseur sélectionnée (modifiable)</td>
</tr>
<tr>
<td><strong>Prix d&rsquo;achat</strong></td>
<td>Prix unitaire de l&rsquo;offre sélectionnée</td>
</tr>
<tr>
<td><strong>Délai</strong></td>
<td>Délai de livraison en jours</td>
</tr>
<tr>
<td><strong>Quantité</strong></td>
<td>Quantité reprise du document source</td>
</tr>
<tr>
<td><strong>Total ligne</strong></td>
<td>Prix × Quantité</td>
</tr>
</tbody>
</table>
</div>
<p>Le <strong>total général</strong> est affiché en bas du tableau et se met à jour en temps réel.</p>
<hr />
<h2>4. Personnaliser les choix</h2>
<p>Avant de générer les commandes, vous pouvez ajuster chaque ligne :</p>
<ul>
<li><strong>Changer de produit spécifique</strong> : sélectionnez un autre produit spécifique dans la liste déroulante</li>
<li><strong>Changer de fournisseur</strong> : sélectionnez une autre offre fournisseur dans la liste déroulante</li>
<li><strong>Exclure une ligne</strong> : décochez la case à gauche</li>
<li><strong>Tout sélectionner / désélectionner</strong> : utilisez la case en en-tête de colonne</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Les quantités sont reprises du document source et ne sont pas modifiables dans l&rsquo;assistant. Si vous devez ajuster une quantité, modifiez-la directement sur le bon de commande fournisseur après sa création.</p>
</blockquote>
<hr />
<h2>5. Générer les commandes</h2>
<ol>
<li>Vérifiez vos choix dans le tableau</li>
<li>Cliquez sur <strong>« Générer les bons de commande »</strong></li>
<li>Le système crée automatiquement <strong>un bon de commande fournisseur par fournisseur distinct</strong></li>
<li>Vous êtes redirigé vers le premier bon de commande créé</li>
</ol>
<p><strong>Ce qui est créé :</strong></p>
<ul>
<li>Un bon de commande fournisseur par fournisseur distinct parmi les lignes sélectionnées</li>
<li>Chaque bon de commande contient les lignes des produits spécifiques correspondants</li>
<li>Les prix sont ceux des offres fournisseurs sélectionnées</li>
<li>Les quantités sont identiques au document source</li>
<li>Les bons de commande sont créés en statut <strong>brouillon</strong></li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> Les bons de commande fournisseurs sont créés en brouillon. Ils doivent être vérifiés et validés manuellement avant envoi au fournisseur.</p>
</blockquote>
<hr />
<h2>6. Avertissements</h2>
<p>L&rsquo;assistant peut afficher des avertissements dans un bandeau en haut de l&rsquo;écran :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Avertissement</th>
<th>Cause</th>
<th>Action recommandée</th>
</tr>
</thead>
<tbody>
<tr>
<td>« Aucun spécifique pour… »</td>
<td>Le produit standard n&rsquo;a pas de produit spécifique rattaché</td>
<td>Créez un produit spécifique rattaché au standard</td>
</tr>
<tr>
<td>« Aucune offre valide… »</td>
<td>Pas d&rsquo;offre fournisseur valide pour les produits spécifiques</td>
<td>Ajoutez des offres fournisseurs</td>
</tr>
</tbody>
</table>
</div>
<p>Les lignes en avertissement sont désactivées (case grisée) et ne peuvent pas être incluses dans la génération.</p>
<blockquote class="bq-note">
<p><strong>Note :</strong> La validité des offres est évaluée à la <strong>date du document source</strong> (par exemple la date du devis), afin de sélectionner les offres applicables à la période concernée.</p>
</blockquote>
<hr />
<h2>7. Workflow type</h2>
<p>Voici le parcours complet d&rsquo;utilisation :</p>
<p><strong>Étape 1 — Préparer le catalogue :</strong></p>
<ol>
<li>Créez vos produits standards avec leurs paramètres de pricing</li>
<li>Rattachez des produits spécifiques à chaque standard</li>
<li>Créez les offres fournisseurs sur les produits spécifiques</li>
</ol>
<p><strong>Étape 2 — Vendre :</strong><br />
4. Créez un devis ou une commande client avec les produits standards (les prix de vente sont déjà calculés)</p>
<p><strong>Étape 3 — Approvisionner :</strong><br />
5. Depuis le devis ou la commande, cliquez sur <strong>« Assistant commandes fournisseurs »</strong><br />
6. Vérifiez les choix dans l&rsquo;assistant et ajustez si nécessaire<br />
7. Cliquez sur <strong>« Générer les bons de commande »</strong><br />
8. Vérifiez et envoyez les bons de commande fournisseur</p>
<hr />
<h2>8. Questions fréquentes</h2>
<h3>Le bouton « Assistant commandes fournisseurs » n&rsquo;apparaît pas</h3>
<p>Vérifiez que votre profil dispose de la permission de création sur le module <strong>Bons de commande fournisseur</strong> (<em>Paramètres &gt; Profils</em>).</p>
<h3>Le document ne contient pas de produit standard</h3>
<p>L&rsquo;assistant affiche un message d&rsquo;information. Seules les lignes contenant des produits standards sont traitées par l&rsquo;assistant. Pour les autres produits, utilisez le bouton <strong>« Créer Bon de commande »</strong>.</p>
<h3>Puis-je modifier les bons de commande après génération ?</h3>
<p>Oui. Les bons de commande sont créés en brouillon et sont entièrement modifiables : vous pouvez ajuster les quantités, les prix, ajouter ou supprimer des lignes avant de les valider.</p>
<h3>Quelle est la différence avec « Créer Bon de commande » ?</h3>
<p><strong>« Créer Bon de commande »</strong> copie les lignes du document vers un seul bon de commande, sans analyse des offres fournisseurs. L&rsquo;<strong>assistant</strong> sélectionne automatiquement les meilleures offres et crée un bon de commande par fournisseur. Voir le tableau comparatif en section 1.</p>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/catalogue/les-produits/">Les produits</a></li>
<li><a href="https://www.kafinea.com/documentation/catalogue/la-gestion-du-sourcing/">La gestion du sourcing</a></li>
<li><a href="https://www.kafinea.com/documentation/achats/les-bons-de-commande-fournisseur/">Les bons de commande fournisseur</a></li>
<li><a href="https://www.kafinea.com/documentation/ventes/les-devis-client/">Les devis client</a></li>
<li><a href="https://www.kafinea.com/documentation/ventes/les-bons-de-commande-client/">Les bons de commande client</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/documentation/catalogue/lassistant-de-commandes-fournisseurs/">L&rsquo;assistant de commandes fournisseurs</a> est apparu en premier sur <a href="https://www.kafinea.com">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
