Importar dados para o Clockify
Se você tiver dados históricos de folhas de ponto no Excel ou se estiver migrando de outros aplicativos, poderá importar os dados do seu espaço de trabalho, incluindo projetos, tarefas, clientes, etiquetas, entrada de horas e seus campos personalizados para o Clockify usando um Arquivo CSV.
O processo de importação de dados do Clockify foi projetado para orientá-lo e ajudá-lo a detectar erros antes de finalizar a importação.
Importar dados e permissões #
| Data | Função do usuário | Plano de assinatura |
| Projetos, clientes, tarefas, etiquetas | proprietário/administrador | Qualquer plano |
| Planilha de horas | proprietário/administrador | Somente planos pagos |
| Usuários (Em breve) | proprietário/administrador | Plano padrão e superior |
Detalhes da importação #
- Tamanho do arquivo: O tamanho máximo do arquivo CSV é de 10 MB.
- Limite de importação: Você pode importar até 1.000 usuários por arquivo.
- SCIM: Se você tiver o SCIM ativado, deverá gerenciar os usuários por meio do seu Provedor de Identidade (IdP) em vez desta ferramenta CSV.
- Observação sobre o período de teste: A importação de usuários não é suportada durante o período de teste gratuito.
Formate seus dados #
Para garantir que a importação seja concluída com sucesso, seus dados CSV devem corresponder ao formato exigido pelo Clockify.
Baixar modelos (recomendado)
A maneira mais fácil de formatar seus dados corretamente é baixando nossos modelos predefinidos.
Para fazer isso:
- Clique nos três pontos ao lado do nome do seu Espaço de trabalho
- Selecione Configurações do espaço de trabalho
- Clique na aba Importar
- Clique no botão correspondente (Planilhas de Horas, Projetos e Clientes ou Usuários) para baixar o arquivo correto

EM BREVE
Para importações de usuários, você pode escolher entre:
- Usuários com acesso limitado: Para usuários com acesso restrito (requer nome)
- Usuários completos: Para membros padrão da equipe (requer e-mail)
Use cabeçalhos em inglês #
Todos os cabeçalhos de coluna do arquivo CSV devem estar em inglês e corresponder exatamente aos nomes nas configurações do seu espaço de trabalho, mesmo que você use o aplicativo em um idioma diferente.
Inclua todas as colunas obrigatórias.
- Importação de tempo: Os campos E-mail, Data de início, Hora de início e Duração são obrigatórios.
- Importação completa do usuário: O e-mail é sempre obrigatório. Se a função for Gerente de Projeto ou Gerente de Equipe, você também deverá preencher as colunas de Gerenciamento.
- Importação de usuários limitada: o nome é o único campo obrigatório.
Valores múltiplos
Para atribuir várias funções, gerenciar projetos, gerenciar funcionários ou grupos a um único usuário, separe cada entrada com uma vírgula.
Associação de projeto e cliente
Se um projeto pertence a um cliente específico (por exemplo, Projeto A sob o Cliente A), use o seguinte formato na coluna Projetos Gerenciados:
Nome do Projeto: Nome do Cliente
O sistema reconhecerá automaticamente o projeto e o cliente associado usando essa sintaxe.
Campos opcionais
Os campos a seguir são opcionais. Se deixados em branco, o sistema aplicará automaticamente as configurações padrão do seu espaço de trabalho:
- Capacidade de trabalho diário
- Taxas faturáveis e de custo
- Dias de trabalho e início da semana
Iniciar importação #
Para iniciar o processo de importação:
- Acesse as Configurações do espaço de trabalho
- Clique na aba Importar
- Arraste e solte um arquivo CSV ou faça o upload a partir do seu computador.
- Siga o processo de verificação em duas etapas:
Etapa 1: Inspecionar dados (tela de pré-visualização) #
Após o upload do arquivo, uma pré-visualização será exibida. Aqui, você poderá revisar os dados e corrigir quaisquer problemas antes de prosseguir.
Detecção de erro
As linhas e os erros são destacados automaticamente. Use a opção Mostrar apenas linhas com erros para filtrar rapidamente a lista e ver o que precisa ser corrigido.

Corrigir erros e reenviar
O Clockify detecta automaticamente delimitadores comuns (vírgulas e ponto e vírgulas). Se um nome de coluna não for reconhecido, ele será marcado com um aviso e os dados dessa coluna não serão importados.
Se você identificar erros que precisam ser corrigidos, poderá modificar o arquivo externamente e, em seguida, enviar a versão corrigida diretamente desta etapa no Clockify.

Verificações específicas do quadro de horários #
Se você estiver importando dados de folha de ponto, precisará confirmar o formato de data usado no seu arquivo.
Você também será notificado se estiver importando dados de folha de ponto de usuários que ainda não estão em seu espaço de trabalho, permitindo que você os adicione primeiro.
Importação administrativa
Ao importar usuários com a função de Administrador, você precisa verificar as permissões deles.
Assentos faltando
Se você não tiver vagas suficientes para novos usuários, poderá comprar vagas imediatamente ou cancelar a importação para revisar sua lista.
Etapa 2: Resumo da importação #
Ao clicar em Importar, uma barra de progresso acompanhará o status. Quando concluído, um resumo exibirá os resultados:
- Planilhas de horas/projetos: Link para os dados importados
- Usuários: Detalhamento de novos administradores, gerentes e membros com links para a página da sua equipe

Verifique os formatos de hora e data #
Os formatos do seu arquivo CSV devem corresponder exatamente aos configurados na sua conta Clockify.
| Formato | Onde verificar as configurações | Exemplo de incompatibilidade |
| Hora (12 horas / 24 horas) | Configurações do perfil | Se o seu arquivo CSV tiver 13:00, mas suas configurações usarem o formato de 24 horas, a importação falhará. |
| Duração (hh:mm:ss, etc.) | Configurações do espaço de trabalho | Seu formato de duração do CSV (ex.: 1:30) não corresponde ao formato definido em seu espaço de trabalho. |
| Data (DD/MM/AAAA, etc.) | Configurações do perfil | Seu formato de data CSV não corresponde ao definido em seu perfil. |
Limites de caracteres #
- Descrição: 3000
- Tarefas: 1000
- Projetos: 250
- Clientes: 100
- Etiquetas: 100
Importante observação #
- Todos os usuários importados receberão um convite por e-mail e os usuários existentes do Clockify simplesmente farão login para aceitar o convite
- Os novos usuários serão solicitados a se cadastrar usando o nome fornecido no arquivo CSV como nome de usuário sugerido
- Campos obrigatórios para importação de tempo: Email, Data inicial, Hora inicial, Duração
- Campos opcionais para importação de tempo: Faturável, Descrição, Projeto, Tarefa, Cliente, Etiqueta (se algum campo obrigatório estiver habilitado, ele também será obrigatório no CSV)
- Se você não agrupar os projetos por cliente, deverá renomear a coluna de clientes no arquivo CSV de acordo
- A data e a hora de término são calculadas automaticamente com base na hora de início e na duração
- As entradas de tempo são importadas de acordo com o fuso horário da pessoa que faz a importação
- Se você não especificar o status de faturamento de uma entrada, ele será herdado do projeto