Dokumentation

Aktivitäten massenhaft in Cadulis importieren


Sparen Sie Zeit durch das Anlegen mehrerer Einsätze per CSV-Datei

Müssen Sie Dutzende oder sogar Hunderte Aktivitäten auf einmal erstellen?
Cadulis ermöglicht Ihnen den Massenimport von Einsätzen über eine .csv-Datei, in der Sie wichtige Informationen wie Datum, Adresse, Kunde, Aktivitätstyp usw. angeben können.

Diese Anleitung erklärt, wie Sie Ihre Datei vorbereiten, den Import konfigurieren und die Rückmeldungen der Plattform interpretieren.


🧭 1. Zugriff auf die Import-Oberfläche

  • Linke Seitenleiste → Aktivitäten
  • Klicken Sie auf Aktivitäten importieren
  • Sie gelangen auf die Seite Einsatzimport

🔧 2. Importtyp wählen

In der Liste Dateiverarbeitungsart:

Option Verhalten
Nur Erstellung Erstellt pro Zeile eine Aktivität. Fehler, wenn bereits vorhanden
Nur Erstellung (ohne Fehler bei Vorhandensein) Überspringt bereits vorhandene Zeilen
Nur Änderung Aktualisiert Aktivitäten per id oder reference
Änderung (ohne Fehler bei Fehlen) Überspringt Zeilen ohne Entsprechung
Erstellung und Änderung Erstellt oder aktualisiert je nach Vorhandensein

🔁 3. Import mehrerer Aktivitätstypen (optional)

  • Aktivieren Sie den Schalter Mehrere Aktivitätstypen, wenn Ihre Datei verschiedene Typen enthält
  • Sie müssen dann in jeder Zeile angeben:
    • intervention_type_id oder intervention_type_reference
    • business_unit_id oder business_unit_search_code

💡 Wenn dies nicht aktiviert ist, können Sie über ein Dropdown einen einheitlichen Typ für alle Zeilen auswählen.


📄 4. Ihre CSV-Datei vorbereiten

✨ Nützliche Standardspalten

Spalte Beschreibung
reference Eindeutige Kennung der Aktivität
title Titel des Einsatzes
scheduled_start_at Startdatum/-uhrzeit
scheduled_end_at Enddatum/-uhrzeit
address Einsatzadresse
duration Dauer (in Sekunden)
comment Freier Kommentar
assignee_email E-Mail des Außendienstmitarbeiters
status Status (pending, canceled, terminated)

👥 Spalten zum Kunden (falls zutreffend)

  • customer.reference (empfohlen)
  • customer.name, customer.address, customer.email usw.

Wenn der Kunde nicht existiert, wird er beim Import automatisch angelegt.

📎 Zusätzliche Daten

  • Jede nicht erkannte Spalte wird als „zusätzliche Daten“ gespeichert
  • Diese stehen anschließend in Formularen, Exports, Berichten zur Verfügung

🚫 Automatisch ignorierte Spalten

Bestimmte Spalten sind reserviert oder werden nicht verwendet, zum Beispiel:

  • created_at, assigned_user, intervention_type_name usw.

🚀 5. Import starten

  1. Klicken Sie unten rechts auf Weiter
  2. Laden Sie Ihre .csv-Datei hoch
  3. Klicken Sie auf Importieren

➡️ Prüfen Sie die Protokolle im Bereich “Letzte Importe”, um Erfolg oder Fehler zu kontrollieren.


Best Practices

  • Verwenden Sie immer eine reference-Spalte: Das verhindert Dubletten und erleichtert Aktualisierungen.
  • Geben Sie konsequent die customer.reference an, auch für bestehende Kunden.
  • Testen Sie zunächst mit 2 oder 3 Zeilen, bevor Sie einen Massenimport durchführen.
  • Legen Sie eine comment-Spalte an, um nützliche Felddaten wie Zugangscode, Ansprechpartner usw. zu erfassen.