Documentação

Importar atividades em massa no Cadulis


Ganhe tempo criando várias intervenções via arquivo CSV

Precisa criar dezenas ou até centenas de atividades de uma só vez?
O Cadulis permite que você importe em massa intervenções através de um arquivo .csv, especificando informações essenciais como data, endereço, cliente, tipo de atividade…

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


🧭 1. Acessar a interface de importação

  • Menu lateral esquerdo → Atividades
  • Clique em Importar atividades
  • Você chegará na página Importação de intervenções

🔧 2. Escolher o tipo de importação

Na lista Tipo de tratamento do arquivo:

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 Tipos de atividade múltiplos se seu arquivo contiver mais de um tipo
  • Você deverá então incluir em cada linha:
    • intervention_type_id ou intervention_type_reference
    • business_unit_id ou business_unit_search_code

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


📄 4. Preparar seu arquivo 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 término
address Endereço da intervenção
duration Duração (em segundos)
comment Comentário livre
assignee_email E-mail do interveniente
status Status (pending, canceled, terminated)

👥 Colunas relacionadas ao cliente (se aplicável)

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

Se o cliente não existir, ele será criado automaticamente na importação.

📎 Dados complementares

  • Qualquer coluna não reconhecida é armazenada como “dado adicional”
  • Elas ficam 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 Próximo (no canto inferior direito)
  2. Carregue seu arquivo .csv
  3. Clique em Importar

➡️ Consulte os logs no quadro “Últimas importações” para verificar o sucesso ou possíveis erros.


Boas práticas

  • Sempre utilize uma coluna reference: isso evita duplicidades e facilita as atualizações.
  • Sempre preencha 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 de campo úteis: código de acesso, nome do contato, etc.