Documentación

Importar actividades en masa en Cadulis


Ahorre tiempo creando múltiples intervenciones mediante archivo CSV

¿Necesita crear decenas o incluso cientos de actividades de una sola vez?
Cadulis le permite importar masivamente intervenciones mediante un archivo .csv, especificando información esencial como la fecha, la dirección, el cliente, el tipo de actividad, etc.

Esta guía le explica cómo preparar su archivo, configurar la importación e interpretar los resultados de la plataforma.


🧭 1. Acceder a la interfaz de importación

  • Menú lateral izquierdo → Actividades
  • Haga clic en Importar actividades
  • Llegará a la página Importación de intervenciones

🔧 2. Elegir el tipo de importación

En la lista Tipo de tratamiento del archivo:

Opción Comportamiento
Solo creación Crea una actividad por línea. Error si ya existe
Solo creación (sin error si existe) Ignora las líneas ya existentes
Solo modificación Actualiza actividades mediante id o reference
Modificación (sin error si no existe) Ignora las líneas sin correspondencia
Creación y modificación Crea o actualiza según la existencia

🔁 3. Importar varios tipos de actividades (opcional)

  • Active el switch Tipos de actividad múltiples si su archivo contiene varios tipos
  • Entonces deberá incluir en cada línea:
    • intervention_type_id o intervention_type_reference
    • business_unit_id o business_unit_search_code

💡 Si no está activado, puede aplicar un tipo único a todas las líneas mediante una lista desplegable.


📄 4. Preparar su archivo CSV

✨ Columnas estándar útiles

Columna Descripción
reference Identificador único de la actividad
title Título de la intervención
scheduled_start_at Fecha/hora de inicio
scheduled_end_at Fecha/hora de fin
address Dirección de la intervención
duration Duración (en segundos)
comment Comentario libre
assignee_email E-mail del interventor
status Estado (pending, canceled, terminated)

👥 Columnas relacionadas con el cliente (si aplica)

  • customer.reference (recomendado)
  • customer.name, customer.address, customer.email, etc.

Si el cliente no existe, se creará automáticamente durante la importación.

📎 Datos complementarios

  • Toda columna no reconocida se almacena como “dato adicional”
  • Luego están disponibles en los formularios, exportaciones, informes

🚫 Columnas ignoradas automáticamente

Algunas columnas están reservadas o no se utilizan, por ejemplo:

  • created_at, assigned_user, intervention_type_name, etc.

🚀 5. Iniciar la importación

  1. Haga clic en Siguiente (abajo a la derecha)
  2. Suba su archivo .csv
  3. Haga clic en Importar

➡️ Consulte los logs en el recuadro “Últimas importaciones” para verificar el éxito o los errores.


Buenas prácticas

  • Utilice siempre una columna reference: evita duplicados y facilita las actualizaciones.
  • Complete sistemáticamente el customer.reference, incluso para clientes existentes.
  • Pruebe primero con 2 o 3 líneas antes de una importación masiva.
  • Prepare una columna comment para incluir información de campo útil: código de acceso, nombre del contacto, etc.