Visão geral
O Importador Universal permite criar projetos e fases em massa no Factorial , carregando uma planilha. Em vez de adicionar projetos um por um, você pode preparar todos os seus dados em formato Excel ou CSV e importar tudo de uma só vez.
Este guia orienta você em todo o processo: preparação do arquivo, upload, mapeamento de colunas, revisão dos dados e conclusão da importação.
Antes de começar
Permissões
Você precisa da permissão "Importar recursos" para usar o importador universal. Se você não vir a opção de importação, entre em contato com o administrador Factorial .

Formatos de arquivo suportados
O importador aceita os seguintes tipos de arquivo:
- .xlsx (Microsoft Excel)
- .xls (Excel legado)
- .csv (Valores separados por vírgula)
Como funcionam os projetos e as fases no arquivo
Cada linha da sua planilha representa um projeto ou um projeto com uma fase. Veja como funciona:
- Se você preencher apenas as colunas de nível de projeto, a linha criará um projeto .
- Se você também preencher as colunas de fase (Nome da fase, Status da fase, etc.), a linha criará um projeto com uma fase .
- Para adicionar várias fases ao mesmo projeto, use várias linhas com o mesmo nome de projeto . O importador detectará que elas pertencem ao mesmo projeto e criará um único projeto com várias fases.

Exemplo: Para importar um projeto chamado "Redesign do Site" com duas fases ("Design" e "Desenvolvimento"), crie duas linhas. Ambas as linhas têm "Redesign do Site" como nome do projeto, mas nomes de fase diferentes.
Etapa 1 - Acesse o importador
- Acesse Projetos na barra de navegação lateral.
- Clique no botão Importar (ícone de upload) no canto superior direito da lista de projetos.
- A janela do importador universal será aberta.
Etapa 2 - Envie seu arquivo
- Arraste e solte o arquivo na área de upload ou clique em Procurar para selecionar um arquivo do seu computador.
- Você também pode baixar um modelo para ver o formato esperado antes de preparar seus dados. O modelo inclui valores de exemplo para orientá-lo.
- Após o upload, o importador lê o seu arquivo e passa para a etapa de mapeamento de colunas.

Etapa 3 - Mapeie suas colunas
O importador tentará corresponder automaticamente as colunas da sua planilha aos campos Factorial . Revise cada mapeamento e ajuste-o, se necessário.
- As colunas com uma marca de seleção verde foram correspondidas automaticamente.
- As colunas com um ícone de aviso exigem sua atenção — selecione o campo Factorial correto no menu suspenso.
- Você pode ignorar as colunas que não deseja importar.
Após preencher todos os campos obrigatórios, clique em Continuar .

Etapa 4 - Revisar e corrigir erros
O importador valida seus dados e exibe uma tela de revisão semelhante a uma planilha, onde você pode:
- Veja todas as suas linhas com seus respectivos valores mapeados.
- As células com erros são destacadas em vermelho — passe o cursor sobre elas para ver o que está errado.
- Edite os valores diretamente na tela de revisão para corrigir erros antes da importação.
- Remova as linhas que você não deseja importar.
Os erros de validação mais comuns incluem:
| Erro | O que significa |
|---|---|
| Campo obrigatório ausente | O nome do projeto, o status, a entidade legal ou o tipo de orçamento estão vazios. |
| Intervalo de datas inválido | A data de vencimento é anterior à data de início. |
| E-mail inválido | O e-mail do responsável pelo projeto não está no formato esperado. |
| Dados inconsistentes do projeto | Duas linhas com o mesmo nome de projeto podem ter valores diferentes para os campos de nível de projeto (por exemplo, status diferentes). |
| Campo de orçamento não aplicável | Um campo de orçamento foi preenchido, mas não se aplica ao tipo ou escopo de orçamento selecionado. |
Corrija quaisquer erros e clique em Continuar quando seus dados estiverem limpos.

Etapa 5 - Confirme e importe
Analise o resumo da importação, que mostra quantos projetos e fases serão criados. Clique em Importar para iniciar o processo.
A importação é executada em segundo plano. Você pode:
- Feche a janela e continue trabalhando — a importação será concluída automaticamente.
- Consulte o Histórico de Importação para verificar o status da sua importação.
Histórico de importação
Você pode consultar as importações anteriores na seção Histórico de importações :
- Acesse as Configurações.
- Acesse a seção Histórico de importação
- Aqui você verá todas as importações anteriores com seus respectivos status (concluída, em andamento ou com falha), o número de registros importados e quaisquer erros.

Referência dos campos disponíveis
Abaixo está a lista completa dos campos que você pode incluir no seu arquivo de importação.
Campos do projeto
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome do projeto | Sim | O nome do projeto. Usado para agrupar linhas pertencentes ao mesmo projeto. |
| Código do projeto | Não | Um código curto ou uma referência para o projeto. |
| Status | Sim | Status do projeto. Valores aceitos: Ativo , Rascunho , Concluído . |
| Data de início | Não | A data de início do projeto. |
| Data de vencimento | Não | A data de entrega do projeto. Deve ser igual ou posterior à data de início. |
| Descrição | Não | Descrição textual do projeto. |
| Pessoa jurídica | Sim | A entidade jurídica à qual o projeto pertence. Deve corresponder a uma entidade jurídica já existente na sua conta Factorial . |
| Proprietário do projeto (e-mail) | Não | O endereço de e-mail do funcionário responsável pelo projeto. Deve ser o mesmo de um funcionário já cadastrado. |
| Tipo de orçamento | Sim | Modelo de orçamento. Valores aceitos: Tempo e Material , Preço Fixo , Sem Orçamento . |
| Escopo do orçamento | Não | Indica se o orçamento é monitorado em nível de projeto ou delegado a fases. Valores aceitos: Projeto , Fases . |
| Custo estimado | Não | Valor do custo planejado. Aplicável somente a orçamentos por tempo e material ou preço fixo com escopo de projeto. |
| Custo fixo | Não | O valor do custo fixo. Aplicável somente ao escopo do projeto. |
| Horas estimadas | Não | O número de horas planejadas para o projeto. Aplicável somente a orçamentos de Tempo e Material com escopo de Projeto. |
| Faturável | Não | Indica se o projeto é faturável. Valores aceitos: verdadeiro / falso . Aplicável somente ao escopo do projeto. |
| Orçamento estimado do cliente | Não | Receita prevista do cliente. Aplicável somente se o projeto for faturável, para orçamentos de Tempo e Material ou Preço Fixo. |
Campos de fase
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome da fase | Não | Nome da fase a ser criada no âmbito do projeto. |
| Código de fase | Não | Um código curto ou referência para a fase. |
| data de início da fase | Não | A data de início da fase. |
| data de vencimento da fase | Não | A data de vencimento da fase. Deve ser igual ou posterior à data de início da fase. |
| Status da fase | Não | O estado da fase. Valores aceitos: Ativo , Rascunho , Concluído . |
| Descrição da fase | Não | Descrição textual da fase. |
| Custo da fase | Não | Custo previsto para a fase. Aplicável somente quando o escopo do orçamento for "Fases" . |
| custo fixo da fase | Não | Custo fixo para a fase. Aplicável somente quando o escopo do orçamento for "Fases" . |
| Horas da fase | Não | Horário previsto para a fase. Aplicável somente quando o escopo do orçamento for "Fases" . |
| Faturável por fase | Não | Indica se a fase é faturável. Aplicável somente quando o escopo do orçamento for "Fases" . |
| Orçamento do cliente da fase | Não | Receita planejada do cliente para a fase. Aplicável somente quando a fase for faturável e o escopo do orçamento for "Fases" . |
Dicas e boas práticas
- Primeiro, baixe o modelo. Ele inclui dados de exemplo e todas as colunas disponíveis, facilitando a preparação correta do seu arquivo.
- Mantenha a consistência nos nomes dos projetos. Ao importar várias fases para o mesmo projeto, certifique-se de que o nome do projeto seja idêntico em todas as linhas (incluindo maiúsculas e minúsculas e espaços).
- Os campos de nível de projeto devem ser consistentes. Se duas linhas compartilharem o mesmo nome de projeto, elas deverão ter os mesmos valores para todos os campos de nível de projeto (status, entidade legal, tipo de orçamento etc.). Caso contrário, você receberá um erro de validação.
- Use o escopo do orçamento com sabedoria. Defina o escopo do orçamento como "Fases" se quiser acompanhar o orçamento no nível da fase. Defina-o como "Projeto" (ou deixe em branco) para gerenciar o orçamento no nível do projeto.
- Os projetos existentes são identificados pelo nome. Se já existir um projeto com o mesmo nome na sua conta Factorial , o importador adicionará as fases a esse projeto em vez de criar uma duplicata. No entanto, novas fases não serão adicionadas a projetos que já existiam antes do início do processo de importação.
- As fases também são desduplicadas por nome. Dentro da mesma importação, se duas linhas tiverem o mesmo nome de projeto e o mesmo nome de fase, apenas uma fase será criada.
Perguntas frequentes
-
Posso atualizar projetos existentes com o importador?
O importador foi projetado para criar novos projetos e fases. Se já existir um projeto com o mesmo nome, nenhuma alteração será feita nele, mas novas fases ainda poderão ser adicionadas.
-
O que acontece se a minha importação falhar durante o processo?
Cada linha é processada independentemente dentro de uma transação. Se uma linha falhar, isso não afetará as outras linhas. Você pode verificar quais linhas foram processadas com sucesso e quais falharam no histórico de importação.
-
Posso importar projetos sem fases?
Sim. Basta deixar todas as colunas de fase vazias e o importador criará projetos sem nenhuma fase.
-
Existe um limite de linhas?
O importador processa arquivos com centenas de linhas. Para importações muito grandes, considere dividi-las em vários arquivos.
-
Posso desfazer uma importação?
Projetos e fases importados não podem ser desfeitos automaticamente. Você precisará excluí-los manualmente, se necessário.