📍 Contexte
Interface générale de Kafinea
Kafinea permet d’importer et d’exporter des données de plusieurs manières, selon vos besoins : manuellement via des fichiers CSV (ou Excel pour l’export), ou de façon automatisée grâce à l’API. Ce guide vous accompagne dans chaque méthode, que vous souhaitiez charger vos données existantes lors de la mise en place de Kafinea ou exporter ponctuellement des informations.
1. Importer des données depuis un fichier CSV #
L’import CSV est la méthode la plus courante pour intégrer un volume important de données dans Kafinea. Le processus se déroule en trois étapes.
Lancer l’import #
Depuis n’importe quel module, cliquez sur le bouton Importer situé en haut à droite de la liste. Le formulaire d’import s’ouvre pour ce module.
Étape 1 – Charger le fichier CSV #
Sélectionnez votre fichier CSV, puis précisez :
- si le fichier contient une ligne d’en-tête
- l’encodage des caractères (UTF-8, ISO-8859-1…)
- le symbole délimiteur (virgule, point-virgule, pipe ou caret) : celui des exports de Kafinea est proposé par défaut
Étape 2 – Gérer les doublons #
Choisissez comment traiter les enregistrements qui existent déjà dans Kafinea :
| Option | Comportement |
|---|---|
| Écraser | Remplace les fiches existantes par les nouvelles données |
| Fusionner | Met à jour uniquement les champs renseignés dans le fichier |
| Ignorer | Conserve les fiches existantes telles quelles |
Vous sélectionnez les champs qui servent à détecter la correspondance entre une ligne du CSV et une fiche existante (par exemple : l’adresse email, la référence client…).
Note : Cette étape est facultative. Si vos données sont entièrement nouvelles, vous pouvez l’ignorer.
Étape 3 – Mapper les champs #
Associez chaque colonne de votre fichier CSV à un champ du module Kafinea. Vous pouvez également :
- Renseigner une valeur par défaut pour un champ non présent dans le fichier
- Sauvegarder le mappage (case Sauver ce mappage) pour le réutiliser lors d’imports futurs avec une structure de fichier similaire
- Réutiliser un mappage enregistré : choisissez-le dans la liste Utiliser les mappages enregistrés, les colonnes sont associées automatiquement
- Supprimer un mappage enregistré devenu inutile : une fois sélectionné, son nom s’affiche sous la liste ; cliquez sur l’icône corbeille puis confirmez. Le mappage est supprimé définitivement et n’est plus proposé lors des imports suivants. Pour modifier un mappage, supprimez-le puis enregistrez-en un nouveau lors de votre prochain import.
Astuce : S’il manque un champ dans Kafinea, vous pouvez le créer directement depuis le gestionnaire d’agencement sans quitter le processus d’import.
Cliquez sur Importer pour lancer l’opération.
2. Exporter une liste vers Excel ou en CSV #
Vous pouvez exporter des données à tout moment depuis n’importe quel module. Le fichier contient exactement ce que la fenêtre d’export annonce : le nombre de lignes et les colonnes sont affichés avant de lancer l’export.
Lancer l’export #
Depuis la liste d’un module, filtrez et triez les fiches comme vous le souhaitez, puis cliquez sur Plus > Exporter. La fenêtre d’export vous propose trois choix.
Choisir les lignes #
Chaque option indique le nombre de lignes qu’elle exportera :
| Option | Lignes exportées |
|---|---|
| Lignes sélectionnées | Uniquement les fiches cochées dans la liste, sur toutes les pages |
| Lignes de cette page | Les fiches de la page affichée, dans le même ordre qu’à l’écran |
| Toute la liste | Toutes les pages de la liste, avec le filtre et la recherche saisie en tête de colonnes |
Astuce : Pour exporter une partie des fiches, il suffit de saisir votre recherche en tête de colonnes : Toute la liste n’exporte alors que les fiches trouvées.
Choisir les colonnes #
| Option | Colonnes exportées |
|---|---|
| Colonnes de la liste | Les colonnes affichées dans la liste, dans le même ordre, y compris celles qui viennent d’une fiche liée (par exemple le code auxiliaire du compte sur une liste de devis). La fenêtre affiche leurs noms. |
| Tous les champs de la fiche | Tous les champs que vous êtes autorisé à consulter, utiles pour retravailler toutes les informations ou réimporter le fichier |
Pour exporter d’autres colonnes, modifiez d’abord les colonnes de la liste ou choisissez un autre filtre.
Choisir le format du fichier #
| Format | Pour quoi faire |
|---|---|
| Excel (.xlsx) (recommandé) | Consulter, trier, filtrer et calculer dans un tableur. Les montants et les dates sont de vraies valeurs, prêtes pour les formules ; les codes postaux, numéros de téléphone et références gardent leurs zéros. La première ligne reste visible et porte des filtres. |
| CSV (.csv) | Échanger avec un autre logiciel ou réimporter le fichier dans Kafinea. |
Le fichier CSV s’ouvre directement dans un tableur, accents compris. Choisissez son séparateur dans la fenêtre d’export :
- Point-virgule : pour les tableurs réglés en français et dans la plupart des pays européens (proposé par défaut) ;
- Virgule : pour les tableurs réglés en anglais.
Kafinea retient, sur ce navigateur, votre choix de format, de séparateur et de colonnes pour vos prochains exports. L’écran d’import propose le même séparateur par défaut, ce qui permet de réimporter directement un fichier exporté.
Note : Pour les activités du calendrier, un troisième format, Agenda (.ics), permet d’ajouter toutes vos activités à une autre application d’agenda.
3. Automatiser les échanges de données via l’API #
Au-delà des opérations manuelles, Kafinea dispose d’une API qui permet d’automatiser les imports et exports de données avec vos autres logiciels métier.
Ce que permet l’API #
- Import automatique : un logiciel externe envoie des données à Kafinea (par exemple, des commandes depuis une boutique en ligne)
- Export automatique : Kafinea transmet des données à un système externe (par exemple, une liste de pièces à fabriquer vers un logiciel de production)
- Déclenchement par workflow : les flux de travail de Kafinea peuvent déclencher automatiquement ces échanges selon des règles métier que vous définissez
Exemple : Une entreprise possédant une chaîne de montage robotisée peut tirer profit de l’API Kafinea : pour chaque nouvelle commande client, Kafinea envoie automatiquement la liste de produits à fabriquer (export), puis reçoit la confirmation que la fabrication est terminée (import). Un workflow envoie ensuite une notification au client pour l’informer que sa commande est en cours d’expédition.
Note : L’API permet des échanges en temps réel ou planifiés. Pour en savoir plus, consultez la documentation de l’API Kafinea.
4. Questions fréquentes #
Quels formats de fichier sont acceptés pour l’import ?
Kafinea accepte uniquement les fichiers au format CSV. Si vos données sont dans un tableur (Excel, Google Sheets…), exportez-les d’abord en CSV.
Puis-je annuler un import ?
Non, un import ne peut pas être annulé automatiquement. Vérifiez bien votre fichier et vos paramètres de mappage avant de lancer l’opération. En cas d’erreur, vous devrez corriger les fiches manuellement ou procéder à un nouvel import avec l’option Écraser.
Important : Avant tout import en masse, il est recommandé de tester avec un fichier contenant quelques lignes seulement pour valider le mappage et le traitement des doublons.
L’import gère-t-il les relations entre modules ?
Oui, vous pouvez mapper une colonne de votre CSV vers un champ de relation (par exemple, associer un contact à une organisation existante). La colonne contient le nom de la fiche liée, tel qu’il apparaît dans Kafinea, et la fiche est retrouvée par ce nom :
- Quand un champ peut désigner plusieurs types de fiche, l’import cherche le nom dans chacun d’eux. Pour viser un type précis, reprenez le format d’un export CSV de la liste : le nom du module, quatre deux-points, puis le nom de la fiche. Le plus sûr est d’exporter quelques fiches et de copier ce format.
- Dans une société, la fiche de cette société est préférée quand le même nom existe dans plusieurs sociétés.
- Une personne est retrouvée par « Prénom Nom » ou « Nom Prénom ».
- Si aucune fiche ne porte ce nom, elle est créée avec ce seul nom quand le module le permet. Les personnes ne sont jamais créées ainsi : la ligne est refusée. Vérifiez donc l’orthographe des noms avant l’import.
Puis-je planifier un import automatique récurrent ?
Les imports CSV sont manuels. Pour des imports récurrents et automatisés, utilisez l’API Kafinea, qui permet de planifier des échanges de données avec vos autres systèmes.
Comment exporter uniquement certaines fiches ?
Utilisez les listes pour filtrer les fiches souhaitées, puis cliquez sur Plus > Exporter > Toute la liste. Pour quelques fiches précises, cochez-les dans la liste et choisissez Lignes sélectionnées.
Mon fichier CSV s’affiche dans une seule colonne du tableur. Que faire ?
Le séparateur du fichier ne correspond pas à celui de votre tableur. Relancez l’export en choisissant l’autre séparateur, ou choisissez le format Excel (.xlsx), qui s’ouvre correctement quels que soient les réglages de votre ordinateur.