Documentazione

Importare attività in massa in Cadulis


Risparmia tempo creando più interventi tramite file CSV

Hai bisogno di creare decine o addirittura centinaia di attività in una sola volta?
Cadulis ti permette di importare in massa interventi tramite un file .csv, specificando le informazioni essenziali come data, indirizzo, cliente, tipo di attività…

Questa guida ti spiega come preparare il tuo file, configurare l’importazione e interpretare i feedback della piattaforma.


🧭 1. Accedere all’interfaccia di importazione

  • Menu laterale sinistro → Attività
  • Clicca su Importa attività
  • Arrivi alla pagina Importazione interventi

🔧 2. Scegliere il tipo di importazione

Nella lista Tipo di trattamento del file:

Opzione Comportamento
Solo creazione Crea un’attività per riga. Errore se già esistente
Solo creazione (senza errore se esiste) Ignora le righe già esistenti
Solo modifica Aggiorna attività tramite id o reference
Modifica (senza errore se assente) Ignora le righe senza corrispondenza
Creazione e modifica Crea o aggiorna in base all’esistenza

🔁 3. Importare più tipi di attività (opzionale)

  • Attiva lo switch Tipi di attività multipli se il tuo file ne contiene diversi
  • Dovrai quindi includere in ogni riga:
    • intervention_type_id o intervention_type_reference
    • business_unit_id o business_unit_search_code

💡 Se non è attivato, puoi applicare un tipo unico a tutte le righe tramite un menu a tendina.


📄 4. Preparare il tuo file CSV

✨ Colonne standard utili

Colonna Descrizione
reference Identificativo univoco dell’attività
title Titolo dell’intervento
scheduled_start_at Data/ora di inizio
scheduled_end_at Data/ora di fine
address Indirizzo dell’intervento
duration Durata (in secondi)
comment Commento libero
assignee_email E-mail dell’operatore sul campo
status Stato (pending, canceled, terminated)

👥 Colonne relative al cliente (se applicabile)

  • customer.reference (consigliato)
  • customer.name, customer.address, customer.email, ecc.

Se il cliente non esiste, verrà creato automaticamente durante l’importazione.

📎 Dati aggiuntivi

  • Qualsiasi colonna non riconosciuta viene salvata come “dato aggiuntivo”
  • Sono poi disponibili nei moduli, esportazioni, report

🚫 Colonne ignorate automaticamente

Alcune colonne sono riservate o inutilizzate, ad esempio:

  • created_at, assigned_user, intervention_type_name, ecc.

🚀 5. Avviare l’importazione

  1. Clicca su Avanti (in basso a destra)
  2. Carica il tuo file .csv
  3. Clicca su Importa

➡️ Consulta i log nel riquadro “Ultime importazioni” per verificare il successo o eventuali errori.


Buone pratiche

  • Usa sempre una colonna reference: evita duplicati e facilita gli aggiornamenti.
  • Inserisci sempre il customer.reference, anche per clienti già esistenti.
  • Fai prima una prova con 2 o 3 righe prima di un’importazione massiva.
  • Prepara una colonna comment per includere informazioni utili dal campo: codice di accesso, nome del contatto, ecc.