This documentation page has not yet been translated

We make every effort to translate the documentation.
If you need help on a specific subject, do not hesitate to contact us using the contact form.

---

Gagnez du temps en créant plusieurs interventions via fichier CSV

Besoin de créer des dizaines, voire des centaines d’activités d’un coup ?
Cadulis vous permet d’importer en masse des interventions via un fichier .csv, en précisant les informations essentielles comme la date, l’adresse, le client, le type d’activité…

Ce guide vous explique comment préparer votre fichier, configurer l’import, et interpréter les retours de la plateforme.

---

🧭 1. Accéder à l’interface d’import

• Menu latéral gauche → Activités
• Cliquez sur Importer des activités
• Vous arrivez sur la page Import d’interventions

---

🔧 2. Choisir le type d’import

Dans la liste Type de traitement du fichier :

Option	Comportement
Création uniquement	Crée une activité par ligne. Erreur si déjà existante
Création uniquement (sans erreur si existe)	Ignore les lignes déjà existantes
Modification uniquement	Met à jour des activités via id ou reference
Modification (sans erreur si absente)	Ignore les lignes sans correspondance
Création et modification	Crée ou met à jour selon l’existence

---

🔁 3. Importer plusieurs types d’activités (optionnel)

• Activez le switch Types d’activité multiples si votre fichier en contient plusieurs
• Vous devrez alors inclure dans chaque ligne :
  • intervention_type_id ou intervention_type_reference
  • business_unit_id ou business_unit_search_code

💡 Si ce n’est pas activé, vous pouvez appliquer un type unique à toutes les lignes via une liste déroulante.

---

📄 4. Préparer votre fichier CSV

✨ Colonnes standards utiles

Colonne	Description
reference	Identifiant unique de l’activité
title	Titre de l’intervention
scheduled_start_at	Date/heure de début
scheduled_end_at	Date/heure de fin
address	Adresse d’intervention
duration	Durée (en secondes)
comment	Commentaire libre
assignee_email	E-mail de l’intervenant
status	Statut (pending, canceled, terminated)

👥 Colonnes liées au client (si applicable)

• customer.reference (recommandé)
• customer.name, customer.address, customer.email, etc.

Si le client n’existe pas, il sera automatiquement créé à l’import.

📎 Données complémentaires

• Toute colonne non reconnue est stockée comme “donnée supplémentaire”
• Elles sont ensuite disponibles dans les formulaires, exports, rapports

🚫 Colonnes ignorées automatiquement

Certaines colonnes sont réservées ou inutilisées, par exemple :

• created_at, assigned_user, intervention_type_name, etc.

---

🚀 5. Lancer l’import

1. Cliquez sur Suivant (en bas à droite)
2. Téléversez votre fichier .csv
3. Cliquez sur Importer

➡️ Consultez les logs dans l’encart “Derniers imports” pour vérifier le succès ou les erreurs.

---