Documentação do software de gestão, planeamento e otimização das intervenções

Importar atividades em massa no Cadulis


Poupe tempo ao criar várias intervenções via ficheiro CSV

Precisa de criar dezenas ou até centenas de atividades de uma só vez?
O Cadulis permite-lhe importar em massa intervenções através de um ficheiro .csv, especificando informações essenciais como data, morada, cliente, tipo de atividade…

Este guia explica como preparar o seu ficheiro, configurar a importação e interpretar os retornos da plataforma.


🧭 1. Aceder ao ecrã de importação

  • Menu lateral esquerdo → Atividades
  • Clique em Importar atividades
  • Chega ao ecrã Importação de intervenções

🔧 2. Escolher o tipo de importação

Na lista Tipo de tratamento do ficheiro:

Opção Comportamento
Apenas criação Cria uma atividade por linha. Erro se já existir
Apenas criação (sem erro se existir) Ignora as linhas já existentes
Apenas modificação Atualiza atividades via id ou reference
Modificação (sem erro se ausente) Ignora as linhas sem correspondência
Criação e modificação Cria ou atualiza conforme a existência

🔁 3. Importar vários tipos de atividades (opcional)

  • Ative o switch Vários tipos de atividade se o seu ficheiro contiver vários tipos
  • Terá então de incluir em cada linha:
    • intervention_type_id ou intervention_type_reference
    • business_unit_id ou business_unit_search_code

💡 Se não estiver ativado, pode aplicar um tipo único a todas as linhas através de uma lista suspensa.


📄 4. Preparar o seu ficheiro CSV

✨ Colunas padrão úteis

Coluna Descrição
reference Identificador único da atividade
title Título da intervenção
scheduled_start_at Data/hora de início
scheduled_end_at Data/hora de fim
address Morada da intervenção
duration Duração (em segundos)
comment Comentário livre
assignee_email E-mail do interveniente
status Estado (pending, canceled, terminated)

👥 Colunas relacionadas com o cliente (se aplicável)

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

Se o cliente não existir, será automaticamente criado ao importar.

📎 Dados complementares

  • Qualquer coluna não reconhecida é armazenada como “dado adicional”
  • Ficam depois disponíveis nos formulários, exportações, relatórios

🚫 Colunas ignoradas automaticamente

Algumas colunas são reservadas ou não utilizadas, por exemplo:

  • created_at, assigned_user, intervention_type_name, etc.

🚀 5. Iniciar a importação

  1. Clique em Seguinte (no canto inferior direito)
  2. Carregue o seu ficheiro .csv
  3. Clique em Importar

➡️ Consulte os registos no painel “Últimas importações” para verificar o sucesso ou eventuais erros.


Boas práticas

  • Utilize sempre uma coluna reference: evita duplicados e facilita as atualizações.
  • Preencha sistematicamente o customer.reference, mesmo para clientes já existentes.
  • Teste primeiro com 2 ou 3 linhas antes de uma importação em massa.
  • Prepare uma coluna comment para incluir informações úteis do terreno: código de acesso, nome do contacto, etc.