<?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/fr/documentation/feed/" rel="self" type="application/rss+xml" />
	<link>https://www.kafinea.com/fr/documentation/</link>
	<description>Une solution unique pour toutes vos ambitions</description>
	<lastBuildDate>Sat, 16 May 2026 20:34:55 +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/fr/documentation/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Liens entre éléments</title>
		<link>https://www.kafinea.com/fr/documentation/interface-kafinea/liens-entre-elements/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Sat, 16 May 2026 20:34:55 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/liens-entre-elements/</guid>

					<description><![CDATA[<p>📍 ContexteInterface générale de Kafinea Kafinea permet de créer des liens typés entre différents éléments de l&#8217;ERP (Tickets, Projets, Tâches de projet, etc.). Ces liens permettent de structurer l&#8217;information et de visualiser les dépendances directement depuis la vue résumé d&#8217;un enregistrement. Types de liens disponibles Il existe quatre types de relations pour qualifier le lien...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/liens-entre-elements/">Liens entre éléments</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Contexte</strong><br /><em>Interface générale de Kafinea</em></p>
</blockquote>
<p>Kafinea permet de créer des liens typés entre différents éléments de l&rsquo;ERP (Tickets, Projets, Tâches de projet, etc.). Ces liens permettent de structurer l&rsquo;information et de visualiser les dépendances directement depuis la vue résumé d&rsquo;un enregistrement.</p>
<h2>Types de liens disponibles</h2>
<p>Il existe quatre types de relations pour qualifier le lien entre deux éléments :</p>
<ul>
<li><strong>Lié à</strong> : Relation simple et symétrique indiquant que deux éléments ont un rapport entre eux sans dépendance particulière.</li>
<li><strong>Bloque / Est bloqué par</strong> : Relation de dépendance indiquant qu&rsquo;un élément doit être terminé ou résolu avant un autre.</li>
<li><strong>Duplique / Est dupliqué par</strong> : Utilisé pour marquer des éléments identiques ou redondants.</li>
<li><strong>Parent de / Enfant de</strong> : Permet de créer une hiérarchie entre les éléments (par exemple, un ticket principal décomposé en sous-tickets).</li>
</ul>
<h2>Utilisation du widget</h2>
<p>Sur les modules compatibles, un bloc &quot;Liens entre éléments&quot; est disponible dans la vue résumé.</p>
<h3>Ajouter un lien</h3>
<ol>
<li>Cliquez sur le bouton <strong>Ajouter</strong> dans le bloc &quot;Liens entre éléments&quot;.</li>
<li>Sélectionnez le <strong>Type de lien</strong> souhaité.</li>
<li>Recherchez et sélectionnez l&rsquo;<strong>Élément cible</strong> à l&rsquo;aide de la barre de recherche (recherche multi-module).</li>
<li>Cliquez sur <strong>Enregistrer</strong>.</li>
</ol>
<p>Le lien apparaît immédiatement dans le widget, groupé par type. L&rsquo;élément cible verra également le lien apparaître automatiquement dans son propre widget (avec l&rsquo;orientation inverse si nécessaire, par exemple &quot;Est bloqué par&quot; si le lien initial était &quot;Bloque&quot;).</p>
<h3>Supprimer un lien</h3>
<p>Pour supprimer un lien, cliquez sur l&rsquo;icône de suppression (croix rouge) à côté du lien concerné dans le widget. Une confirmation vous sera demandée.</p>
<h2>Modules compatibles</h2>
<p>Au lancement, les liens entre éléments sont disponibles sur les modules suivants :</p>
<ul>
<li>Tickets</li>
<li>Projets</li>
<li>Tâches de projet</li>
</ul>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/liens-entre-elements/">Liens entre éléments</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les lignes de documents</title>
		<link>https://www.kafinea.com/fr/documentation/interface-kafinea/les-lignes-de-documents/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Wed, 13 May 2026 01:57:06 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/les-lignes-de-documents/</guid>

					<description><![CDATA[<p>📍 ContexteInterface générale de Kafinea Introduction Le module Lignes de documents rassemble en une seule liste toutes les lignes d&#8217;articles (produits et services) saisies dans vos documents : devis, commandes, factures, avoirs, bons de livraison, bons de réception, factures fournisseurs et mouvements de stock. Il est accessible via Lignes de documents. Cette vue transverse permet...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/les-lignes-de-documents/">Les lignes de documents</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Contexte</strong><br /><em>Interface générale de Kafinea</em></p>
</blockquote>
<hr />
<h2>Introduction</h2>
<p>Le module <strong>Lignes de documents</strong> rassemble en une seule liste toutes les lignes d&rsquo;articles (produits et services) saisies dans vos documents : devis, commandes, factures, avoirs, bons de livraison, bons de réception, factures fournisseurs et mouvements de stock. Il est accessible via <em><strong>Lignes de documents</strong></em>.</p>
<p>Cette vue transverse permet d&rsquo;analyser, filtrer et exporter le détail de toutes les lignes sans devoir ouvrir chaque document un par un. Elle est particulièrement utile pour le reporting commercial, les analyses de marge, l&rsquo;export vers un outil décisionnel, ou simplement pour retrouver rapidement toutes les lignes concernant un article ou un client donné.</p>
<blockquote class="bq-important">
<p><strong>Important</strong> : ce module est en <strong>lecture seule</strong>. Pour ajouter, modifier ou supprimer une ligne, vous devez ouvrir le document parent (devis, facture, etc.).</p>
</blockquote>
<hr />
<h2>1. Consulter la liste des lignes</h2>
<p>La liste affiche par défaut, pour chaque ligne :</p>
<ul>
<li>Le <strong>type</strong> du document parent (devis, facture, commande…)</li>
<li>Le <strong>document parent</strong> (numéro / lien vers le document)</li>
<li>La <strong>désignation</strong> de la ligne</li>
<li>L&rsquo;<strong>article</strong> (lien vers la fiche produit ou service)</li>
<li>La <strong>quantité</strong></li>
<li>Le <strong>prix unitaire</strong></li>
<li>La <strong>date de création</strong> du document parent</li>
</ul>
<p>Vous pouvez :</p>
<ul>
<li><strong>Trier</strong> chaque colonne en cliquant sur son entête</li>
<li><strong>Filtrer</strong> avec la barre de recherche ou via des vues personnalisées</li>
<li><strong>Naviguer</strong> vers le document parent ou la fiche article en cliquant sur les liens</li>
</ul>
<hr />
<h2>2. Créer une vue personnalisée</h2>
<p>Comme pour toutes les listes Kafinea, vous pouvez créer vos propres vues filtrées :</p>
<ol>
<li>Cliquez sur <em><strong>Créer une vue</strong></em> depuis le menu des vues</li>
<li>Sélectionnez les <strong>colonnes</strong> à afficher</li>
<li>Définissez les <strong>filtres</strong> (par article, par période, par société, par utilisateur…)</li>
<li>Enregistrez la vue et, si besoin, partagez-la avec votre équipe</li>
</ol>
<p><strong>Exemples d&rsquo;usage :</strong></p>
<ul>
<li>Toutes les lignes vendues sur un article donné le mois dernier</li>
<li>Toutes les lignes des factures d&rsquo;un compte client précis</li>
<li>Toutes les lignes au-dessus d&rsquo;un certain montant de remise</li>
</ul>
<hr />
<h2>3. Exporter au format CSV</h2>
<p>Le bouton <em><strong>Exporter</strong></em> génère un fichier CSV contenant les lignes de la vue courante avec les filtres et les colonnes sélectionnés. Ce fichier peut ensuite être ouvert dans un tableur ou importé dans un outil d&rsquo;analyse externe.</p>
<blockquote>
<p><strong>Bon à savoir</strong> : l&rsquo;export reprend exactement les colonnes et l&rsquo;ordre de tri de la vue affichée. Préparez d&rsquo;abord la vue qui correspond à votre besoin, puis exportez.</p>
</blockquote>
<hr />
<h2>4. Utiliser les lignes dans les rapports</h2>
<p>Le module <strong>Lignes de documents</strong> est disponible comme module principal dans le générateur de <em><strong>Rapports</strong></em>. Vous pouvez :</p>
<ul>
<li>Choisir des colonnes issues du document parent (numéro, statut, date, client…) et de l&rsquo;article</li>
<li>Filtrer par <strong>date</strong> (création ou dernière modification du document parent), par <strong>utilisateur</strong>, par <strong>article</strong></li>
<li>Regrouper par <strong>année</strong> ou <strong>mois</strong> pour suivre l&rsquo;évolution dans le temps</li>
<li>Produire des graphiques (barres, camembert, lignes)</li>
</ul>
<p>Cas d&rsquo;usage typiques :</p>
<ul>
<li><strong>CA par article</strong> sur une période donnée</li>
<li><strong>Top clients</strong> par volume d&rsquo;articles vendus</li>
<li><strong>Analyse des remises</strong> par commercial ou par famille d&rsquo;articles</li>
<li><strong>Suivi des quantités livrées</strong> sur les bons de livraison</li>
</ul>
<hr />
<h2>5. Sécurité d&rsquo;accès</h2>
<p>La visibilité des lignes suit <strong>exactement</strong> celle des documents parents :</p>
<ul>
<li>Si vous n&rsquo;avez pas accès à un devis, vous ne voyez pas ses lignes</li>
<li>Si vous travaillez dans plusieurs sociétés, vous ne voyez que les lignes de la société active</li>
<li>Les administrateurs voient toutes les lignes</li>
</ul>
<p>Aucune ligne ne peut donc apparaître si son document parent n&rsquo;est pas accessible à l&rsquo;utilisateur courant.</p>
<hr />
<h2>6. Questions fréquentes</h2>
<p><strong>Puis-je modifier une ligne directement depuis cette liste ?</strong><br />
Non. Pour modifier une ligne (article, quantité, prix, remise…), ouvrez le document parent et modifiez-la depuis ce document. La liste se mettra à jour automatiquement.</p>
<p><strong>Pourquoi je ne vois pas certaines lignes que je m&rsquo;attendais à voir ?</strong><br />
Vérifiez :</p>
<ul>
<li>que le document parent existe toujours (les documents mis à la corbeille n&rsquo;apparaissent pas) ;</li>
<li>que vous avez bien accès au document parent (en cas de partage privé) ;</li>
<li>que vous êtes dans la bonne société (en environnement multi-sociétés).</li>
</ul>
<p><strong>Pourquoi le clic sur une ligne ne m&rsquo;amène pas sur une fiche ligne ?</strong><br />
Une ligne n&rsquo;a pas de fiche détaillée propre : c&rsquo;est le document parent qui porte tout le contexte. Selon la colonne sur laquelle vous cliquez, vous obtenez :</p>
<ul>
<li>une <strong>fiche résumé</strong> de la ligne qui regroupe les informations principales et propose un lien vers le document parent ;</li>
<li>la <strong>fiche du document parent</strong> si vous cliquez sur la colonne du document parent ;</li>
<li>la <strong>fiche de l&rsquo;article</strong> si vous cliquez sur la colonne article.</li>
</ul>
<p><strong>Puis-je accéder à ces lignes via l&rsquo;API ?</strong><br />
Oui, en lecture seule. Les opérations d&rsquo;écriture (création, modification, suppression) ne sont pas autorisées sur ce module — il faut passer par le document parent.</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/les-lignes-de-documents/">Les lignes de documents</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>L&#8217;enregistrement automatique</title>
		<link>https://www.kafinea.com/fr/documentation/interface-kafinea/l-enregistrement-automatique/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Tue, 12 May 2026 07:44:18 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/l-enregistrement-automatique/</guid>

					<description><![CDATA[<p>📍 ContexteInterface générale de Kafinea Note : Sur les modules qui le supportent, Kafinea peut enregistrer automatiquement vos modifications pendant la saisie, sans que vous ayez besoin de cliquer sur Enregistrer. Cette page explique comment cette fonctionnalité se présente, comment l&#8217;activer pour votre instance et comment la désactiver à titre individuel. 1. À quoi sert...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/l-enregistrement-automatique/">L&rsquo;enregistrement automatique</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Contexte</strong><br /><em>Interface générale de Kafinea</em></p>
</blockquote>
<blockquote class="bq-note">
<p><strong>Note :</strong> Sur les modules qui le supportent, Kafinea peut <strong>enregistrer automatiquement</strong> vos modifications pendant la saisie, sans que vous ayez besoin de cliquer sur <strong>Enregistrer</strong>. Cette page explique comment cette fonctionnalité se présente, comment l&rsquo;activer pour votre instance et comment la désactiver à titre individuel.</p>
</blockquote>
<hr />
<h2>1. À quoi sert l&rsquo;enregistrement automatique</h2>
<p>Lors de la saisie d&rsquo;une fiche longue (typiquement un document de vente avec de nombreuses lignes), il est inconfortable de devoir penser à enregistrer régulièrement. L&rsquo;enregistrement automatique répond à ce besoin :</p>
<ul>
<li>Vos modifications sont enregistrées <strong>en arrière-plan</strong>, peu de temps après votre dernière saisie.</li>
<li>Un <strong>indicateur d&rsquo;état</strong> affiche en permanence où en est l&rsquo;enregistrement de votre document.</li>
<li>Vous gardez la possibilité de <strong>forcer un enregistrement immédiat</strong> à tout moment.</li>
</ul>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Même lorsque l&rsquo;enregistrement automatique est actif, le bouton <strong>Enregistrer</strong> classique reste disponible et fonctionne comme d&rsquo;habitude.</p>
</blockquote>
<hr />
<h2>2. L&rsquo;indicateur d&rsquo;état d&rsquo;enregistrement</h2>
<p>Lorsque l&rsquo;enregistrement automatique est disponible sur la fiche en cours, un <strong>indicateur cliquable</strong> apparaît dans la barre d&rsquo;outils, en haut de l&rsquo;écran. Il prend l&rsquo;un des états suivants :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>État affiché</th>
<th>Signification</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Enregistré</strong></td>
<td>Toutes vos modifications sont enregistrées. Rien à faire.</td>
</tr>
<tr>
<td><strong>Modifications non enregistrées</strong></td>
<td>Vous avez modifié la fiche et l&rsquo;enregistrement va être fait automatiquement au bout de quelques secondes. Si vous souhaitez enregistrer immédiatement, vous pouvez cliquer sur l&rsquo;état.</td>
</tr>
<tr>
<td><strong>Enregistrement…</strong></td>
<td>Un enregistrement est en cours.</td>
</tr>
<tr>
<td><strong>Erreur</strong></td>
<td>Le dernier enregistrement a échoué (problème réseau, conflit, etc.). Cliquez pour réessayer.</td>
</tr>
<tr>
<td><strong>Conflit détecté</strong></td>
<td>Un autre utilisateur a modifié le document depuis votre ouverture. Cliquez pour choisir comment résoudre le conflit.</td>
</tr>
<tr>
<td><strong>Enregistrement automatique désactivé</strong></td>
<td>L&rsquo;enregistrement automatique est désactivé pour votre compte. Pensez à enregistrer manuellement.</td>
</tr>
</tbody>
</table>
</div>
<h3>Forcer un enregistrement immédiat</h3>
<p>Trois façons équivalentes de déclencher un enregistrement tout de suite, sans attendre l&rsquo;enregistrement automatique :</p>
<ul>
<li><strong>Cliquer sur l&rsquo;indicateur</strong> d&rsquo;état lorsqu&rsquo;il indique « Modifications non enregistrées ».</li>
<li>Utiliser le <strong>raccourci clavier <code>Ctrl+S</code></strong> (<code>Cmd+S</code> sur Mac). Kafinea intercepte ce raccourci pendant l&rsquo;édition : il n&rsquo;enregistrera pas la page du navigateur, mais bien votre formulaire.</li>
<li>Cliquer sur le bouton <strong>Enregistrer</strong> en bas de la fiche, comme d&rsquo;habitude.</li>
</ul>
<blockquote class="bq-important">
<p><strong>Important :</strong> Si vous tentez de fermer l&rsquo;onglet ou de quitter la page alors que des modifications ne sont pas encore enregistrées, Kafinea affiche une <strong>confirmation</strong> pour éviter toute perte de saisie.</p>
</blockquote>
<hr />
<h2>3. Activer la fonctionnalité pour votre instance</h2>
<p>L&rsquo;enregistrement automatique fait partie d&rsquo;un mode d&rsquo;édition avancé qui doit être activé au niveau de l&rsquo;instance par un administrateur. Cette activation est faite <strong>une seule fois</strong>, et bénéficie ensuite à tous les utilisateurs.</p>
<p><strong>Procédure (administrateur) :</strong></p>
<ol>
<li>Accédez à <em>Menu principal &gt; Configuration &gt; Paramètres</em>.</li>
<li>Ouvrez la section <strong>Gestion des modules &gt; Fonctionnalités</strong>.</li>
<li>Activez la fonctionnalité <strong>Édition avancée des documents</strong> (sticky toolbar, sections pliables, raccourcis clavier, palette de commandes…).</li>
<li>Enregistrez.</li>
</ol>
<p>Une fois la fonctionnalité activée, le nouvel écran d&rsquo;édition — avec l&rsquo;indicateur d&rsquo;état — s&rsquo;affiche automatiquement pour tous les utilisateurs lorsqu&rsquo;ils ouvrent une fiche éligible.</p>
<h3>Gestion des conflits (Verrouillage optimiste)</h3>
<p>Par défaut, si deux utilisateurs modifient le même document, le dernier qui enregistre « gagne » et écrase les modifications du précédent. Pour éviter cela, vous pouvez activer la <strong>Gestion des conflits de modification</strong>.</p>
<p><strong>Procédure (administrateur) :</strong></p>
<ol>
<li>Accédez à <em>Menu principal &gt; Configuration &gt; Paramètres</em>.</li>
<li>Ouvrez la section <strong>Gestion des modules &gt; Fonctionnalités</strong>.</li>
<li>Localisez le groupe <strong>Présentation générale</strong>.</li>
<li>Activez la fonctionnalité <strong>Gestion des conflits de modification</strong> (alerte si le document a été modifié par un autre utilisateur).</li>
<li>Enregistrez.</li>
</ol>
<p>Lorsque cette fonctionnalité est active :</p>
<ul>
<li>Kafinea mémorise la version du document au moment où vous l&rsquo;ouvrez.</li>
<li>Lors de chaque enregistrement (automatique ou manuel), il vérifie que personne d&rsquo;autre n&rsquo;a enregistré le document entre-temps.</li>
<li>En cas de conflit, une fenêtre s&rsquo;affiche pour vous proposer de <strong>recharger</strong> la version du serveur (en perdant vos modifications locales) ou de <strong>forcer l&rsquo;écrasement</strong> (si vous êtes sûr de votre coup).</li>
</ul>
<blockquote class="bq-note">
<p><strong>Note :</strong> Si l&rsquo;enregistrement automatique ne s&rsquo;affiche pas sur un module donné alors que la fonctionnalité est activée, contactez votre administrateur. Il saura confirmer si le module concerné est déjà couvert ou non.</p>
</blockquote>
<hr />
<h2>4. Désactiver l&rsquo;enregistrement automatique pour votre compte</h2>
<p>Certains utilisateurs préfèrent garder le contrôle complet du moment où leurs modifications partent en base. Kafinea permet de <strong>désactiver l&rsquo;enregistrement automatique individuellement</strong>, sans impacter les autres utilisateurs.</p>
<h3>Depuis la barre d&rsquo;outils d&rsquo;édition</h3>
<ol>
<li>Ouvrez une fiche en mode édition.</li>
<li>Dans la barre d&rsquo;outils en haut, ouvrez le <strong>menu ⋯</strong> (trois petits points).</li>
<li>Cliquez sur <strong>Enregistrement automatique activé</strong> pour basculer l&rsquo;option sur OFF.</li>
</ol>
<p>L&rsquo;indicateur d&rsquo;état affiche alors en permanence un bandeau <strong>« Enregistrement automatique désactivé »</strong> tant que des modifications ne sont pas enregistrées. C&rsquo;est volontaire : il s&rsquo;agit d&rsquo;un rappel visuel pour vous éviter d&rsquo;oublier de cliquer sur <strong>Enregistrer</strong>.</p>
<h3>Depuis vos préférences utilisateur</h3>
<p>L&rsquo;option est également disponible dans vos <a href="https://www.kafinea.com/documentation/parametrage/les-preferences-utilisateur/">préférences utilisateur</a>, sous le libellé <strong>Enregistrement automatique des devis et factures</strong>. Décocher cette option a le même effet que désactiver depuis la barre d&rsquo;outils.</p>
<blockquote class="bq-astuce">
<p><strong>Astuce :</strong> Le réglage est stocké sur votre compte (pas dans votre navigateur). Vous le retrouverez donc identique sur un autre poste ou après vidage du cache.</p>
</blockquote>
<blockquote class="bq-important">
<p><strong>Important :</strong> Lorsque l&rsquo;enregistrement automatique est désactivé, vous restez <strong>entièrement responsable</strong> d&rsquo;enregistrer vos modifications avant de quitter la fiche. Le raccourci <code>Ctrl+S</code> et la confirmation à la fermeture de l&rsquo;onglet restent actifs pour vous aider.</p>
</blockquote>
<hr />
<h2>5. Questions fréquentes</h2>
<p><strong>À quelle fréquence l&rsquo;enregistrement automatique se déclenche-t-il ?</strong></p>
<p>Quelques secondes après votre dernière modification, sans interrompre votre saisie. Le délai s&rsquo;adapte automatiquement à la taille du document et à la rapidité du dernier enregistrement, pour éviter de surcharger le serveur sur les très grosses fiches.</p>
<p><strong>Que se passe-t-il si quelqu&rsquo;un d&rsquo;autre modifie la même fiche en même temps que moi ?</strong></p>
<p>Si la fonctionnalité <strong>Gestion des conflits de modification</strong> est activée par votre administrateur (voir section 3), Kafinea détecte les modifications concurrentes. Si la fiche a été modifiée par un autre utilisateur depuis votre ouverture, l&rsquo;enregistrement affiche un message de <strong>conflit</strong> et vous propose le choix entre <strong>recharger</strong> la version la plus récente ou <strong>forcer</strong> votre propre enregistrement.</p>
<p>Si cette fonctionnalité n&rsquo;est pas activée, c&rsquo;est le principe du « dernier rédacteur » qui s&rsquo;applique : l&rsquo;enregistrement le plus récent remplace le précédent sans avertissement.</p>
<p><strong>L&rsquo;enregistrement automatique fonctionne-t-il sur toutes les fiches ?</strong></p>
<p>Non. Il est disponible sur les écrans d&rsquo;édition pour lesquels Kafinea a déployé le mode d&rsquo;édition avancé. S&rsquo;il n&rsquo;est pas disponible sur un module qui vous intéresse, contactez votre administrateur : il pourra vérifier la configuration de l&rsquo;instance et, le cas échéant, remonter le besoin.</p>
<p><strong>Je ne vois pas l&rsquo;indicateur d&rsquo;état dans la barre d&rsquo;outils, pourquoi ?</strong></p>
<p>Deux causes possibles : soit la fonctionnalité <strong>Édition avancée des documents</strong> n&rsquo;est pas activée pour votre instance (voir section 3), soit le module sur lequel vous travaillez n&rsquo;est pas encore couvert. Dans les deux cas, votre administrateur peut vous aider.</p>
<p><strong>Mes collègues ont activé l&rsquo;enregistrement automatique mais moi je ne le veux pas. Est-ce possible ?</strong></p>
<p>Oui. La préférence est <strong>strictement individuelle</strong> : la désactiver pour votre compte n&rsquo;a aucun impact sur les autres utilisateurs (voir section 4).</p>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<li><a href="https://www.kafinea.com/documentation/interface-kafinea/les-enregistrements/">Les enregistrements</a></li>
<li><a href="https://www.kafinea.com/documentation/parametrage/les-preferences-utilisateur/">Les préférences utilisateur</a></li>
<li><a href="https://www.kafinea.com/documentation/ventes/les-devis-client/">Les devis client</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/interface-kafinea/l-enregistrement-automatique/">L&rsquo;enregistrement automatique</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les marges dans les devis</title>
		<link>https://www.kafinea.com/fr/documentation/ventes/les-marges-dans-les-devis/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Tue, 12 May 2026 07:10:57 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/les-marges-dans-les-devis/</guid>

					<description><![CDATA[<p>📍 Où trouver ce module ?Menu principal &#62; Ventes &#62; Devis Introduction Kafinea affiche, directement sur la fiche d&#8217;un devis, une analyse de marge complète : marge en euros, taux de marque, coefficient — ligne par ligne et agrégés par catégorie, par famille et par section du devis. L&#8217;objectif est de donner au commercial un...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/ventes/les-marges-dans-les-devis/">Les marges dans les devis</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Où trouver ce module ?</strong><br /><em>Menu principal &gt; Ventes &gt; Devis</em></p>
</blockquote>
<hr />
<h2>Introduction</h2>
<p>Kafinea affiche, directement sur la fiche d&rsquo;un devis, une <strong>analyse de marge</strong> complète : marge en euros, taux de marque, coefficient — ligne par ligne et agrégés par catégorie, par famille et par section du devis. L&rsquo;objectif est de donner au commercial un retour immédiat sur la rentabilité de la proposition avant de l&rsquo;envoyer au client.</p>
<blockquote>
<p>🔒 <strong>Information strictement interne</strong> : le bloc d&rsquo;analyse de marge n&rsquo;est <strong>jamais visible par le client</strong>. Il <strong>n&rsquo;apparaît pas</strong> dans le PDF du devis ni dans le devis envoyé au client.</p>
</blockquote>
<hr />
<h2>1. Où trouver les marges sur un devis</h2>
<p>L&rsquo;analyse de marge est visible à deux endroits :</p>
<ul>
<li>Sur la <strong>fiche du devis</strong> (vue détaillée) : un bloc dédié « Analyse de marge » est affiché sous la ligne des totaux. Il propose trois onglets (Catégorie, Famille, Section).</li>
<li>Dans le <strong>formulaire d&rsquo;édition</strong> (création / modification du devis) : le même bloc est mis à jour <strong>en direct</strong> au fur et à mesure que vous modifiez les quantités, les prix ou les remises.</li>
</ul>
<hr />
<h2>2. Les indicateurs affichés</h2>
<p>Pour chaque agrégat (catégorie, famille, section) et pour le total du devis, le tableau présente :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Colonne</th>
<th>Signification</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>CA HT</strong></td>
<td>Chiffre d&rsquo;affaires HT après remise ligne.</td>
</tr>
<tr>
<td><strong>Coût</strong></td>
<td>Prix d&rsquo;achat (PA) HT total des lignes considérées.</td>
</tr>
<tr>
<td><strong>Marge</strong></td>
<td>Marge en euros : <code>CA − Coût</code>.</td>
</tr>
<tr>
<td><strong>Taux de marque</strong></td>
<td>Marge rapportée au prix de <strong>vente</strong> : <code>(CA − Coût) ÷ CA</code>. Affiché en %.</td>
</tr>
<tr>
<td><strong>Coefficient</strong></td>
<td>Multiplicateur appliqué au coût : <code>CA ÷ Coût</code>. Affiché en <code>×</code>.</td>
</tr>
</tbody>
</table>
</div>
<p>Un <strong>tooltip</strong> sur la cellule « Taux de marque » donne aussi le <strong>taux de marge sur achat</strong> (<code>(CA − Coût) ÷ Coût</code>), utile pour les utilisateurs habitués à raisonner sur le PA.</p>
<blockquote class="bq-astuce">
<p>💡 <strong>Attention au vocabulaire</strong> : un « 50 % de marge » peut désigner deux choses très différentes. Avec un PA de 100 € :</p>
<ul>
<li><strong>Taux de marque</strong> à 50 % ⇒ PV = 200 €</li>
<li><strong>Taux de marge sur achat</strong> (coefficient 1,5) à 50 % ⇒ PV = 150 €</li>
</ul>
<p>Kafinea affiche par défaut le <strong>taux de marque</strong> dans le tableau, conformément à l&rsquo;usage courant des ERP français. Le taux de marge sur achat reste accessible dans le tooltip.</p>
</blockquote>
<h3>Marge ligne par ligne</h3>
<p>Dans le tableau des lignes du devis, chaque ligne dispose également d&rsquo;une <strong>cellule Marge</strong> dont le tooltip détaille :</p>
<ul>
<li>PA unitaire × quantité = PA total</li>
<li>PV unitaire (net de remise) × quantité = CA</li>
<li>Marge €</li>
<li>Taux de marque (%)</li>
<li>Taux de marge sur achat (%)</li>
<li>Coefficient (×)</li>
</ul>
<hr />
<h2>3. Les trois axes d&rsquo;agrégation</h2>
<p>Le bloc « Analyse de marge » propose trois axes d&rsquo;analyse à bascule :</p>
<h3>Par catégorie produit</h3>
<p>Regroupe les lignes selon la <strong>catégorie</strong> rattachée à chaque produit ou service. Idéal pour repérer rapidement les familles de prestations qui dégradent la marge globale.</p>
<h3>Par famille</h3>
<p>Regroupe par <strong>famille d&rsquo;articles</strong>. Les familles permettent en plus de définir des <strong>seuils de marge</strong> (voir section <em>Seuils et pills colorées</em> ci-dessous).</p>
<h3>Par section</h3>
<p>Si le devis est structuré en plusieurs <strong>sections</strong> (par ex. « Phase 1 — Étude », « Phase 2 — Réalisation »), un onglet supplémentaire <strong>Section</strong> apparaît et affiche la marge cumulée par section, dans l&rsquo;ordre du document. Cet onglet n&rsquo;est visible que lorsque le devis comporte au moins deux sections distinctes.</p>
<hr />
<h2>4. Seuils et pills colorées</h2>
<p>Sur l&rsquo;onglet <strong>Famille</strong>, le taux de marque est affiché sous forme de <strong>pastille colorée</strong> :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Couleur</th>
<th>Sens</th>
</tr>
</thead>
<tbody>
<tr>
<td>🟢 Vert</td>
<td>Marge ≥ seuil « sain » défini sur la famille.</td>
</tr>
<tr>
<td>🟠 Orange</td>
<td>Marge entre le seuil « alerte » et le seuil « sain ».</td>
</tr>
<tr>
<td>🔴 Rouge</td>
<td>Marge inférieure au seuil « alerte » (ou négative).</td>
</tr>
</tbody>
</table>
</div>
<p>Les seuils sont configurés <strong>famille par famille</strong> dans le module <strong>Familles d&rsquo;articles</strong> :</p>
<ul>
<li><em>Seuil sain — taux de marque (%)</em></li>
<li><em>Seuil alerte — taux de marque (%)</em></li>
<li><em>Activer la coloration</em></li>
</ul>
<p>À défaut de seuils configurés sur une famille, Kafinea applique une coloration générique (&lt; 15 % rouge, &lt; 25 % orange, ≥ 25 % vert). <strong>Cette coloration de repli n&rsquo;est qu&rsquo;une aide visuelle</strong> et ne reflète pas vos seuils métier — pensez à configurer les seuils par famille pour une analyse pertinente.</p>
<hr />
<h2>5. Cas du PA manquant</h2>
<p>Si une ligne du devis pointe vers un produit ou service <strong>sans prix d&rsquo;achat renseigné</strong>, Kafinea <strong>n&rsquo;invente jamais une marge à zéro</strong> (pas de fallback silencieux) :</p>
<ul>
<li>La ligne est <strong>exclue</strong> du calcul du coût agrégé, mais son CA est <strong>conservé</strong> dans le total.</li>
<li>Le bucket (catégorie / famille / section) où elle apparaît est marqué d&rsquo;un <strong>avertissement « ! »</strong> et ses indicateurs de taux (taux de marque, coefficient) affichent <code>—</code>.</li>
<li>Un message en haut du bloc liste explicitement les lignes concernées (« 3 ligne(s) sans prix d&rsquo;achat — Afficher »).</li>
</ul>
<blockquote class="bq-astuce">
<p>💡 <strong>Bonne pratique</strong> : renseignez systématiquement le <strong>prix d&rsquo;achat</strong> des produits et services dans le catalogue. À défaut, vous pouvez aussi saisir le PA directement sur la ligne du devis (champ « PA » dans le tableau des produits).</p>
</blockquote>
<hr />
<h2>6. Cas des kits (produits composés)</h2>
<p>Lorsqu&rsquo;un devis contient un <strong>kit</strong> (produit composé de sous-produits), Kafinea peut être configuré pour <strong>éclater le kit</strong> dans l&rsquo;analyse de marge : chaque composant est compté séparément (avec sa catégorie et sa famille propres). Les agrégats reflètent ainsi le mix réel des items vendus.</p>
<ul>
<li>Si l&rsquo;éclatement est désactivé, la ligne kit est traitée telle quelle : seul le PA du kit lui-même est utilisé.</li>
<li>L&rsquo;activation est un <strong>paramètre d&rsquo;instance</strong> (administrateur).</li>
</ul>
<hr />
<h2>7. Qui voit l&rsquo;analyse de marge ?</h2>
<p>L&rsquo;affichage de l&rsquo;analyse de marge dépend des <strong>droits d&rsquo;accès au champ « Prix d&rsquo;achat »</strong> :</p>
<ul>
<li>Un utilisateur qui <strong>n&rsquo;a pas accès</strong> au champ <code>Prix d'achat</code> sur les Produits <strong>et</strong> sur les Services ne voit pas le bloc.</li>
<li>Si le devis contient au moins une ligne issue d&rsquo;un module dont le PA est invisible pour l&rsquo;utilisateur, un message explique que l&rsquo;analyse ne peut pas être affichée.</li>
<li>Les <strong>administrateurs</strong> voient toujours le bloc.</li>
</ul>
<blockquote>
<p>ℹ️ Les droits d&rsquo;accès au champ <code>Prix d'achat</code> se configurent via les <strong>profils</strong> (panneau d&rsquo;administration). Pour qu&rsquo;un commercial voie les marges, son profil doit donner au moins l&rsquo;accès en lecture au champ <code>Prix d'achat</code> des Produits et/ou Services.</p>
</blockquote>
<hr />
<h2>8. Confidentialité — PDF et envoi au client</h2>
<p>Le bloc d&rsquo;analyse de marge :</p>
<ul>
<li><strong>N&rsquo;apparaît jamais dans le PDF</strong> du devis (ni dans l&rsquo;aperçu d&rsquo;impression).</li>
<li><strong>N&rsquo;est pas inclus dans l&#8217;email</strong> envoyé au client.</li>
<li><strong>N&rsquo;est pas visible dans l&rsquo;extranet client</strong> (portail).</li>
</ul>
<p>Il est strictement réservé à l&rsquo;usage interne, sur les écrans de Kafinea.</p>
<hr />
<h2>9. Questions fréquentes</h2>
<h3>Pourquoi le bloc « Analyse de marge » n&rsquo;apparaît-il pas sur mes devis ?</h3>
<p>Trois causes possibles :</p>
<ol>
<li>Votre profil n&rsquo;a pas accès au champ <code>Prix d'achat</code> des Produits/Services. Demandez à un administrateur de le débloquer.</li>
<li>La fonctionnalité est désactivée au niveau de l&rsquo;instance. Un administrateur peut l&rsquo;activer dans les paramètres avancés.</li>
<li>Le module concerné n&rsquo;est pas encore supporté : l&rsquo;analyse de marge est aujourd&rsquo;hui disponible sur les <strong>Devis</strong>. Le support des commandes client, factures et commandes fournisseur sera ajouté ultérieurement.</li>
</ol>
<h3>Comment changer les seuils de coloration ?</h3>
<p>Les seuils sont définis <strong>par famille d&rsquo;articles</strong>. Ouvrez la fiche d&rsquo;une famille dans le module <strong>Familles d&rsquo;articles</strong>, puis renseignez le seuil sain et le seuil alerte (en % de taux de marque).</p>
<h3>Pourquoi le taux est-il « — » sur certaines lignes ?</h3>
<p>Quand le prix d&rsquo;achat est manquant, Kafinea refuse d&rsquo;afficher un taux faux. Renseignez le PA dans la fiche produit ou directement sur la ligne du devis.</p>
<h3>La marge tient-elle compte de la remise globale du devis ?</h3>
<p>La marge est calculée à partir du CA <strong>après remise ligne</strong> mais <strong>avant</strong> ajustements globaux du document (remise globale, frais de document). Pour la marge nette après remise globale, basez-vous sur le total final du devis ramené au coût agrégé.</p>
<h3>Le client verra-t-il les marges sur son devis PDF ?</h3>
<p><strong>Non.</strong> Le bloc est exclu de l&rsquo;impression et de l&rsquo;export PDF. Il reste interne à Kafinea.</p>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<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/catalogue/les-produits/">Les produits</a></li>
<li><a href="https://www.kafinea.com/documentation/catalogue/les-services/">Les services</a></li>
<li><a href="https://www.kafinea.com/documentation/grille-tarifaire/l-utilisation-d-une-grille-tarifaire/">Utilisation d&rsquo;une grille tarifaire</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/ventes/les-marges-dans-les-devis/">Les marges dans les devis</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les kits de produits</title>
		<link>https://www.kafinea.com/fr/documentation/catalogue/les-kits-de-produits/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Wed, 22 Apr 2026 23:48:18 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/les-kits-de-produits/</guid>

					<description><![CDATA[<p>📍 Où trouver ce module ?Menu principal &#62; Catalogue &#62; Produits Un kit (ou bundle) est un produit composé de plusieurs sous-produits. Il permet de vendre un ensemble d&#8217;articles sous une seule référence, tout en conservant la traçabilité de chaque composant. Exemple : Un kit « Poste de travail » peut contenir un écran, un...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/catalogue/les-kits-de-produits/">Les kits de produits</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Où trouver ce module ?</strong><br /><em>Menu principal &gt; Catalogue &gt; Produits</em></p>
</blockquote>
<p>Un <strong>kit</strong> (ou bundle) est un produit composé de plusieurs sous-produits. Il permet de vendre un ensemble d&rsquo;articles sous une seule référence, tout en conservant la traçabilité de chaque composant.</p>
<blockquote class="bq-exemple">
<p><strong>Exemple :</strong> Un kit « Poste de travail » peut contenir un écran, un clavier et une souris, vendus ensemble sous un prix unique.</p>
</blockquote>
<hr />
<h2>1. Créer un kit</h2>
<ol>
<li>Créez ou ouvrez un produit dans <em>Menu principal &gt; Catalogue &gt; Produits</em>.</li>
<li>Dans l&rsquo;onglet <strong>Sous-produits</strong> (Product Bundles), ajoutez les produits qui composent le kit en cliquant sur <strong>« Sélectionner un produit »</strong>.</li>
<li>Pour chaque composant, indiquez la <strong>quantité</strong> incluse dans le kit.</li>
</ol>
<p>Dès qu&rsquo;un produit possède au moins un sous-produit, il est considéré comme un kit.</p>
<hr />
<h2>2. Mode de calcul du prix du kit</h2>
<p>Le bloc <strong>Tarification du kit</strong> apparaît sur la fiche d&rsquo;un produit kit. Il contient le champ <strong>Mode de calcul du prix du kit</strong> qui détermine comment le prix de vente est obtenu :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Mode</th>
<th>Comportement</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Saisie manuelle</strong></td>
<td>Le prix est <strong>saisi à la main</strong> sur le kit. Kafinea <strong>ne le recalcule pas</strong> lorsque les composants changent.</td>
</tr>
<tr>
<td><strong>Calculé à partir des composants</strong></td>
<td>Le prix de vente du kit est <strong>calculé automatiquement</strong> comme la somme des prix unitaires de ses composants, pondérés par leurs quantités.</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>3. Affichage et comportement sur la fiche du kit</h2>
<h3>3.1 Bandeau contextuel dans le bloc <em>Informations tarif</em></h3>
<p>Un bandeau informatif apparaît en tête du bloc tarif :</p>
<ul>
<li>En mode <em>Saisie manuelle</em> : « Saisie manuelle : le prix n&rsquo;est pas recalculé automatiquement à partir des composants. »</li>
<li>En mode <em>Calculé à partir des composants</em> : « Le prix de vente de ce kit est calculé automatiquement à partir de ses composants. »</li>
</ul>
<h3>3.2 Champ <em>Prix unitaire</em> en lecture seule + badge « Calculé (kit) »</h3>
<p>En mode <em>Calculé à partir des composants</em>, le champ <strong>Prix unitaire</strong> est présenté en <strong>lecture seule</strong> et accompagné d&rsquo;un badge <strong>« Calculé (kit) »</strong>. Une info-bulle précise : <em>« Ce prix est calculé automatiquement à partir des composants du kit. Passez en mode Saisie manuelle (pas de recalcul) pour le saisir. »</em></p>
<p>En mode <em>Saisie manuelle</em>, le champ redevient éditable.</p>
<h3>3.3 Recalcul automatique</h3>
<p>Lorsque le mode est <em>Calculé à partir des composants</em>, le prix du kit est recalculé automatiquement dans les cas suivants :</p>
<ul>
<li>Ajout ou suppression d&rsquo;un composant.</li>
<li>Modification de la quantité d&rsquo;un composant.</li>
<li>Modification du prix unitaire d&rsquo;un composant.</li>
</ul>
<hr />
<h2>4. Règles métier</h2>
<ol>
<li>
<p><strong>Un kit ne peut pas être un produit générique.</strong> Les deux concepts sont mutuellement exclusifs. Si vous tentez de cocher <em>Produit générique</em> sur un kit, Kafinea bloque l&rsquo;enregistrement avec le message :</p>
<blockquote>
<p><em>Un produit générique ne peut pas être un kit.</em></p>
</blockquote>
</li>
<li>
<p><strong>Un kit ne peut pas être un produit spécifique</strong> (rattaché à un générique). Le message affiché est :</p>
<blockquote>
<p><em>Un produit spécifique ne peut pas être un kit.</em></p>
</blockquote>
</li>
<li>
<p><strong>Un produit générique ne peut pas être ajouté comme composant d&rsquo;un kit.</strong> Le message affiché est :</p>
<blockquote>
<p><em>Un produit générique ne peut pas être ajouté comme composant d&rsquo;un kit.</em></p>
</blockquote>
</li>
<li>
<p><strong>Un produit spécifique ne peut pas être ajouté comme composant d&rsquo;un kit.</strong> Le message affiché est :</p>
<blockquote>
<p><em>Un produit spécifique (enfant d&rsquo;un générique) ne peut pas être ajouté comme composant d&rsquo;un kit.</em></p>
</blockquote>
</li>
</ol>
<blockquote class="bq-note">
<p><strong>Note :</strong> Ces règles garantissent la cohérence du catalogue. Les kits regroupent des produits « standards » (ni génériques, ni spécifiques). Pour gérer le sourcing fournisseur, utilisez les <a href="https://www.kafinea.com/documentation/catalogue/les-produits-generiques/">produits génériques</a>.</p>
</blockquote>
<hr />
<h2>5. Foire aux questions</h2>
<p><strong>Pourquoi je ne peux pas cocher « Produit générique » sur mon kit ?</strong><br />
Parce qu&rsquo;un kit regroupe des composants concrets avec des prix définis, alors qu&rsquo;un produit générique est un modèle abstrait dont le prix est calculé à partir de spécifiques enfants. Les deux mécanismes de calcul de prix sont incompatibles.</p>
<p><strong>Pourquoi le prix unitaire de mon kit est-il en lecture seule ?</strong><br />
Parce que le mode de calcul est <em>Calculé à partir des composants</em>. Le prix est la somme des prix de ses composants. Pour le saisir manuellement, basculez le mode sur <em>Saisie manuelle</em>.</p>
<p><strong>Le prix de mon kit ne se met pas à jour après avoir modifié un composant, pourquoi ?</strong><br />
Vérifiez que le mode de calcul est bien <em>Calculé à partir des composants</em> et non <em>Saisie manuelle</em>. En mode manuel, le prix n&rsquo;est jamais recalculé automatiquement.</p>
<p><strong>Puis-je imbriquer des kits (un kit dans un kit) ?</strong><br />
Oui, un composant d&rsquo;un kit peut lui-même être un kit. Cependant, le recalcul automatique ne se propage pas en cascade : si vous modifiez un composant du sous-kit, le prix du sous-kit sera recalculé (s&rsquo;il est en mode <em>Calculé à partir des composants</em>), mais le kit parent ne sera pas recalculé automatiquement. Vous devrez modifier manuellement le kit parent (par exemple en retirant puis ré-ajoutant le sous-kit) pour déclencher son recalcul.</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/les-produits-generiques/">Les produits génériques</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/catalogue/les-kits-de-produits/">Les kits de produits</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les produits génériques</title>
		<link>https://www.kafinea.com/fr/documentation/catalogue/les-produits-generiques/</link>
		
		<dc:creator><![CDATA[David Valminos]]></dc:creator>
		<pubDate>Wed, 22 Apr 2026 10:47:13 +0000</pubDate>
				<guid isPermaLink="false">https://www.kafinea.com/documentation/uncategorized/les-produits-generiques/</guid>

					<description><![CDATA[<p>📍 Où trouver ce module ?Menu principal &#62; Catalogue &#62; Produits Kafinea distingue deux catégories de produits pour gérer le sourcing fournisseur : Produit générique : article « modèle » utilisé dans vos devis, commandes clients et factures (ex. : Câble HDMI 2m). Il ne correspond à aucune référence fournisseur précise. Produit spécifique : variante...</p>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/catalogue/les-produits-generiques/">Les produits génériques</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></description>
										<content:encoded><![CDATA[<blockquote class="bq-exemple">
<p>📍 <strong>Où trouver ce module ?</strong><br /><em>Menu principal &gt; Catalogue &gt; Produits</em></p>
</blockquote>
<p>Kafinea distingue deux catégories de produits pour gérer le sourcing fournisseur :</p>
<ul>
<li><strong>Produit générique</strong> : article « modèle » utilisé dans vos devis, commandes clients et factures (ex. : <em>Câble HDMI 2m</em>). Il ne correspond à aucune référence fournisseur précise.</li>
<li><strong>Produit spécifique</strong> : variante concrète rattachée à un produit générique et achetée auprès d&rsquo;un fournisseur (ex. : <em>Câble HDMI 2m – Marque Alpha, Ref ABC123</em>).</li>
</ul>
<blockquote>
<p>Cette fonctionnalité n&rsquo;est active que si le paramètre <strong>Produits génériques &amp; sourcing fournisseur</strong> est activé dans <em>Paramètres &gt; Fonctionnalités</em>.</p>
</blockquote>
<hr />
<h2>1. Identifier un produit générique ou spécifique</h2>
<p>Sur la fiche produit, cochez <strong>Produit générique</strong> dans le bloc <em>Produits génériques</em>.</p>
<ul>
<li>Un <strong>badge bleu « Générique »</strong> apparaît à côté du nom du produit sur la fiche détail pour identifier immédiatement les produits génériques.</li>
<li>Les produits spécifiques n&rsquo;affichent pas de badge.</li>
</ul>
<hr />
<h2>2. Bloc <em>Produits génériques</em> de la fiche</h2>
<p>Le bloc contient les champs liés à la gestion générique/spécifique. Selon le choix effectué, certains champs sont applicables, d&rsquo;autres non :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Champ</th>
<th>Générique</th>
<th>Spécifique</th>
</tr>
</thead>
<tbody>
<tr>
<td>Produit générique (checkbox)</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Produit générique parent</td>
<td>❌</td>
<td>✅ (pointe vers un générique)</td>
</tr>
<tr>
<td>Mode de calcul du prix</td>
<td>✅</td>
<td>❌</td>
</tr>
<tr>
<td>Marge (%)</td>
<td>✅ (sauf mode <em>Saisie manuelle</em>)</td>
<td>❌</td>
</tr>
<tr>
<td>Arrondi du prix</td>
<td>✅ (sauf mode <em>Saisie manuelle</em>)</td>
<td>❌</td>
</tr>
<tr>
<td>Coût de référence</td>
<td>✅ (calculé, sauf <em>Saisie manuelle</em>)</td>
<td>❌</td>
</tr>
<tr>
<td>Dernier calcul de prix</td>
<td>✅ (calculé)</td>
<td>❌</td>
</tr>
<tr>
<td>Statut du calcul</td>
<td>✅ (calculé)</td>
<td>❌</td>
</tr>
</tbody>
</table>
</div>
<p><strong>Champs non applicables</strong> : ils ne sont pas masqués, ils restent <strong>visibles mais grisés</strong> avec une info-bulle « Non applicable aux produits génériques » ou « Non applicable aux produits spécifiques ». Cela évite toute perte d&rsquo;information perçue et documente la raison du grisé pour l&rsquo;utilisateur.</p>
<hr />
<h2>3. Modes de calcul du prix</h2>
<p>Le <strong>mode de calcul</strong> détermine comment Kafinea alimente le prix de vente du produit générique. <strong>Vous devez choisir un mode explicite</strong> : aucune valeur par défaut n&rsquo;est appliquée silencieusement. Si le mode est vide ou inconnu, le statut <em>Erreur : mode de calcul non défini</em> apparaît et le prix en place est conservé.</p>
<p>Six modes sont disponibles :</p>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Mode</th>
<th>Source du coût</th>
<th>Comportement</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Saisie manuelle (pas de recalcul)</strong></td>
<td>—</td>
<td>Le prix est <strong>saisi à la main</strong> sur le générique. Kafinea <strong>ne le recalcule jamais</strong>, y compris lorsqu&rsquo;un spécifique enfant est modifié.</td>
</tr>
<tr>
<td><strong>Offre la moins chère</strong></td>
<td>Offres fournisseurs des spécifiques enfants</td>
<td>Retient l&rsquo;offre fournisseur valide au <strong>prix le plus bas</strong>.</td>
</tr>
<tr>
<td><strong>Offre préférée</strong></td>
<td>Offres fournisseurs des spécifiques enfants</td>
<td>Retient l&rsquo;offre marquée <em>préférée</em>. À défaut, bascule sur l&rsquo;offre la moins chère.</td>
</tr>
<tr>
<td><strong>Moyenne des offres</strong></td>
<td>Offres fournisseurs des spécifiques enfants</td>
<td>Retient la <strong>moyenne</strong> des prix des offres valides.</td>
</tr>
<tr>
<td><strong>Spécifique le moins cher</strong></td>
<td>Prix d&rsquo;achat des spécifiques enfants</td>
<td>Retient le <strong>prix d&rsquo;achat</strong> (<code>unit_price</code>) du spécifique enfant le <strong>moins cher</strong>, sans passer par les offres.</td>
</tr>
<tr>
<td><strong>Moyenne des spécifiques</strong></td>
<td>Prix d&rsquo;achat des spécifiques enfants</td>
<td>Retient la <strong>moyenne</strong> des prix d&rsquo;achat des spécifiques enfants, sans passer par les offres.</td>
</tr>
</tbody>
</table>
</div>
<p>Pour les cinq modes automatiques, le prix final est ensuite obtenu selon la formule :</p>
<blockquote>
<p><strong>Prix de vente</strong> = Coût de référence × (1 + Marge %) puis <strong>arrondi</strong> selon le paramétrage.</p>
</blockquote>
<h3>Statuts de calcul possibles</h3>
<div style="overflow-x:auto">
<table>
<thead>
<tr>
<th>Statut</th>
<th>Signification</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>OK</strong></td>
<td>Calcul réussi, prix mis à jour.</td>
</tr>
<tr>
<td><strong>Non applicable</strong></td>
<td>Mode <em>Saisie manuelle</em> : aucun calcul n&rsquo;a été effectué, le prix est celui saisi.</td>
</tr>
<tr>
<td><strong>Aucun spécifique</strong></td>
<td>Le générique n&rsquo;a pas de spécifique enfant rattaché.</td>
</tr>
<tr>
<td><strong>Offres manquantes</strong></td>
<td>Aucune offre fournisseur valide à la date de calcul.</td>
</tr>
<tr>
<td><strong>Prix manquants</strong></td>
<td>Les spécifiques (ou leurs offres) n&rsquo;ont pas de prix exploitable.</td>
</tr>
<tr>
<td><strong>Erreur : mode de calcul non défini</strong></td>
<td>Aucun mode n&rsquo;a été choisi ou le mode est inconnu : le prix n&rsquo;est pas modifié.</td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>4. Affichage et comportement sur la fiche du produit générique</h2>
<p>Pour les produits génériques, plusieurs éléments visuels vous aident à comprendre comment le prix est obtenu et si vous pouvez le modifier.</p>
<h3>4.1 Bandeau contextuel dans le bloc <em>Informations tarif</em></h3>
<p>Un bandeau informatif apparaît en tête du bloc tarif :</p>
<ul>
<li>En mode <em>Saisie manuelle</em> : « Saisie manuelle : le prix n&rsquo;est pas recalculé automatiquement. ».</li>
<li>Dans les autres modes : « Le prix de vente est recalculé automatiquement à partir des produits spécifiques enfants (mode : %s). » suivi de la date du <strong>dernier calcul</strong>.</li>
</ul>
<p>Le bandeau contient également un lien <strong>« Voir les enfants »</strong> pour accéder rapidement aux produits spécifiques rattachés. Le bouton <strong>« Recalculer »</strong> du produit générique reste disponible en haut de la fiche.</p>
<h3>4.2 Champ <em>Prix unitaire</em> en lecture seule + badge « Calculé »</h3>
<p>Lorsque le générique n&rsquo;est <strong>pas</strong> en mode <em>Saisie manuelle</em>, le champ <strong>Prix unitaire</strong> est présenté en <strong>lecture seule</strong> et accompagné d&rsquo;un badge <strong>« Calculé »</strong>. Une info-bulle précise : <em>« Ce prix est calculé automatiquement (mode : %s). Passez en mode Saisie manuelle (pas de recalcul) pour le saisir. »</em>.</p>
<p>En mode <em>Saisie manuelle</em>, le champ redevient éditable : vous pouvez saisir librement le prix de vente, qui ne sera jamais écrasé par un recalcul automatique.</p>
<h3>4.3 Popover « Comment est calculé ce prix ? »</h3>
<p>À côté du champ <em>Prix unitaire</em>, une icône <strong>ⓘ</strong> ouvre un popover qui détaille :</p>
<ul>
<li>Le <strong>mode</strong> de calcul actif.</li>
<li>Le <strong>coût de référence</strong> retenu, la <strong>marge</strong> appliquée et l&rsquo;<strong>arrondi</strong>.</li>
<li>La liste des <strong>sources utilisées</strong> : selon le mode, produits spécifiques enfants (avec leur prix d&rsquo;achat) ou offres fournisseurs (avec fournisseur et prix).</li>
<li>Le <strong>prix final</strong> obtenu.</li>
</ul>
<p>Si aucune donnée de calcul n&rsquo;est disponible, le popover affiche <em>« Aucune donnée de calcul disponible. »</em>.</p>
<hr />
<h2>5. Règles métier</h2>
<ol>
<li>
<p><strong>Un produit générique ne peut pas avoir de parent.</strong></p>
<ul>
<li>Si vous cochez <em>Produit générique</em> et qu&rsquo;un parent est renseigné, Kafinea bloque l&rsquo;enregistrement avec le message :<br />
<blockquote>
<p><em>Un produit générique ne peut pas avoir de produit parent.</em></p>
</blockquote>
</li>
<li>Cette règle s&rsquo;applique à <strong>tous</strong> les canaux : édition UI, édition rapide, édition en masse, API REST, workflows, import CSV.</li>
</ul>
</li>
<li>
<p><strong>Le parent d&rsquo;un produit spécifique doit lui-même être un produit générique.</strong> Kafinea vérifie automatiquement cette cohérence à l&rsquo;enregistrement.</p>
</li>
<li>
<p><strong>Recalcul automatique du prix</strong> : lorsqu&rsquo;un produit spécifique change de parent, qu&rsquo;une offre fournisseur est créée/modifiée/supprimée, ou que le prix d&rsquo;achat d&rsquo;un spécifique évolue, le prix du produit générique concerné est recalculé automatiquement — <strong>sauf si</strong> le générique est en mode <em>Saisie manuelle</em> (dans ce cas, le prix reste strictement celui que vous avez saisi).</p>
</li>
<li>
<p><strong>Choix explicite du mode</strong> : le système n&rsquo;applique plus de mode par défaut silencieux. Un générique sans mode de calcul produira un statut <em>Erreur : mode de calcul non défini</em> et son prix ne sera pas modifié, jusqu&rsquo;à ce que vous sélectionniez un mode.</p>
</li>
<li>
<p><strong>Un produit générique ne peut pas être un kit</strong> (et inversement). Les deux mécanismes de calcul de prix sont incompatibles. Si vous tentez de transformer un kit en produit générique (ou d&rsquo;ajouter des sous-produits à un générique), Kafinea bloque l&rsquo;opération. Voir <a href="https://www.kafinea.com/documentation/catalogue/les-kits-de-produits/">Les kits de produits</a> pour plus de détails.</p>
</li>
</ol>
<hr />
<h2>6. Bascule générique ↔ spécifique</h2>
<p>Vous pouvez changer à tout moment un produit de générique à spécifique (et inversement) :</p>
<ul>
<li>Les valeurs non applicables sont <strong>conservées en base</strong> mais simplement grisées à l&rsquo;écran.</li>
<li>Si vous rebasculez, les données redeviennent visibles et éditables.</li>
<li>Vous ne perdez donc aucune information lors d&rsquo;un changement de type.</li>
</ul>
<hr />
<h2>7. Foire aux questions</h2>
<p><strong>Pourquoi je ne peux pas saisir un parent sur mon produit générique ?</strong><br />
Parce qu&rsquo;un générique est par définition un « modèle » sans rattachement fournisseur direct. Seuls les produits spécifiques possèdent un parent générique.</p>
<p><strong>Pourquoi le prix unitaire de mon produit générique est-il en lecture seule ?</strong><br />
Parce que le mode de calcul actif recalcule automatiquement ce prix à partir des spécifiques enfants ou de leurs offres fournisseurs. Pour le saisir manuellement, basculez le mode de calcul sur <em>Saisie manuelle (pas de recalcul)</em>.</p>
<p><strong>Quelle différence entre <em>Offre la moins chère</em> et <em>Spécifique le moins cher</em> ?</strong><br />
<em>Offre la moins chère</em> (et ses variantes <em>Offre préférée</em> / <em>Moyenne des offres</em>) s&rsquo;appuie sur les <strong>offres fournisseurs</strong> rattachées aux spécifiques enfants. <em>Spécifique le moins cher</em> (et <em>Moyenne des spécifiques</em>) utilise directement le <strong>prix d&rsquo;achat</strong> porté par les produits spécifiques, sans passer par les offres.</p>
<p><strong>Pourquoi les champs de calcul de prix sont-ils grisés sur mon produit spécifique ?</strong><br />
Ces champs servent uniquement au calcul automatique du prix du générique. Ils n&rsquo;ont pas de sens sur un produit spécifique, qui reflète une offre fournisseur précise.</p>
<p><strong>Le statut affiche <em>Erreur : mode de calcul non défini</em>. Que faire ?</strong><br />
Ouvrez la fiche du produit générique et sélectionnez un mode dans <em>Mode de calcul du prix</em>, puis enregistrez. Kafinea relancera le calcul à la prochaine mise à jour ou via le bouton <em>Recalculer</em>.</p>
<p><strong>Le badge « Générique » ne s&rsquo;affiche pas, pourquoi ?</strong><br />
Vérifiez que le paramètre <em>Produits génériques &amp; sourcing fournisseur</em> est activé dans <em>Paramètres &gt; Fonctionnalités</em>, et que la case <em>Produit générique</em> est bien cochée sur la fiche.</p>
<hr />
<h2>Références associées 🔗</h2>
<ul>
<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/catalogue/lassistant-de-commandes-fournisseurs/">L&rsquo;assistant de commandes fournisseurs</a></li>
<li><a href="https://www.kafinea.com/documentation/catalogue/les-produits/">Les produits</a></li>
<li><a href="https://www.kafinea.com/documentation/catalogue/les-kits-de-produits/">Les kits de produits</a></li>
</ul>
<p>L’article <a href="https://www.kafinea.com/fr/documentation/catalogue/les-produits-generiques/">Les produits génériques</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Permettre aux collaborateurs de compléter leur dossier RH en autonomie</title>
		<link>https://www.kafinea.com/fr/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/fr/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/fr/">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/fr/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/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les agents IA</title>
		<link>https://www.kafinea.com/fr/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/fr/documentation/parametrage/les-agents-ia/">Les agents IA</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">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/fr/documentation/parametrage/les-agents-ia/">Les agents IA</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Le serveur MCP</title>
		<link>https://www.kafinea.com/fr/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/fr/documentation/parametrage/le-serveur-mcp/">Le serveur MCP</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">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/fr/documentation/parametrage/le-serveur-mcp/">Le serveur MCP</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Les workflows IA</title>
		<link>https://www.kafinea.com/fr/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/fr/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">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/fr/documentation/intelligence-artificielle/les-workflows-ia/">Les workflows IA</a> est apparu en premier sur <a href="https://www.kafinea.com/fr/">Kafinea</a>.</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
