Documentatie van de software voor beheer, planning en optimalisatie van interventies

Activiteiten in bulk importeren in Cadulis


Bespaar tijd door meerdere interventies aan te maken via een CSV-bestand

Moet u tientallen of zelfs honderden activiteiten in één keer aanmaken?
Cadulis stelt u in staat om massaal interventies te importeren via een .csv-bestand, waarbij u essentiële informatie zoals datum, adres, klant, type activiteit enz. opgeeft.

Deze gids legt uit hoe u uw bestand voorbereidt, de import configureert en de feedback van het platform interpreteert.


🧭 1. Toegang tot de importinterface

  • Linker zijmenu → Activiteiten
  • Klik op Activiteiten importeren
  • U komt op de pagina Interventies importeren

🔧 2. Kies het type import

In de lijst Type verwerking van het bestand:

Optie Gedrag
Alleen aanmaken Maakt per regel een activiteit aan. Fout als deze al bestaat
Alleen aanmaken (zonder fout als bestaat) Negeert reeds bestaande regels
Alleen wijzigen Werkt activiteiten bij via id of reference
Wijzigen (zonder fout als afwezig) Negeert regels zonder overeenkomst
Aanmaken en wijzigen Maakt aan of werkt bij naargelang het bestaan

🔁 3. Meerdere typen activiteiten importeren (optioneel)

  • Activeer de schakelaar Meerdere activiteitentypes als uw bestand verschillende types bevat
  • U moet dan per regel opnemen:
    • intervention_type_id of intervention_type_reference
    • business_unit_id of business_unit_search_code

💡 Als dit niet geactiveerd is, kunt u een uniek type voor alle regels toepassen via een keuzelijst.


📄 4. Uw CSV-bestand voorbereiden

✨ Nuttige standaardkolommen

Kolom Beschrijving
reference Unieke identificatie van de activiteit
title Titel van de interventie
scheduled_start_at Startdatum/-tijd
scheduled_end_at Einddatum/-tijd
address Interventieadres
duration Duur (in seconden)
comment Vrij veld voor opmerkingen
assignee_email E-mailadres van de uitvoerder
status Status (pending, canceled, terminated)

👥 Klantgerelateerde kolommen (indien van toepassing)

  • customer.reference (aanbevolen)
  • customer.name, customer.address, customer.email, enz.

Als de klant niet bestaat, wordt deze automatisch aangemaakt bij het importeren.

📎 Aanvullende gegevens

  • Elke niet-herkende kolom wordt opgeslagen als “aanvullende gegevens”
  • Deze zijn vervolgens beschikbaar in formulieren, exports, rapporten

🚫 Automatisch genegeerde kolommen

Bepaalde kolommen zijn gereserveerd of niet in gebruik, bijvoorbeeld:

  • created_at, assigned_user, intervention_type_name, enz.

🚀 5. De import starten

  1. Klik op Volgende (rechtsonder)
  2. Upload uw .csv-bestand
  3. Klik op Importeren

➡️ Raadpleeg de logs in het blok “Laatste imports” om het succes of eventuele fouten te controleren.


Best practices

  • Gebruik altijd een reference-kolom: dit voorkomt dubbele invoer en vergemakkelijkt updates.
  • Vul altijd de customer.reference in, ook voor bestaande klanten.
  • Test eerst met 2 of 3 regels voordat u een grote import uitvoert.
  • Voorzie een comment-kolom om nuttige veldinformatie toe te voegen: toegangscode, naam contactpersoon, enz.