Visão Geral
O Importador Universal permite que você crie projetos e fases em massa no Factorial ao fazer o upload de 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 vez.
Este guia o(a) orienta por todo o processo: preparando seu arquivo, fazendo o upload, mapeando colunas, revisando seus dados e completando a importação.
Antes de começar
Permissões
Você precisa da permissão Importar recursos para usar o Importador Universal. Se você não vê a opção de importação, entre em contato com seu(a) administrador(a) do 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 projetos e fases funcionam no arquivo
Cada linha em 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 cria um projeto.
- Se você também preencher as colunas de fase (Nome da fase, Status da fase, etc.), a linha cria 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 pertencem ao mesmo projeto e criará um 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 fases diferentes.
Passo 1 - Acesse o importador
- Vá para Projetos na navegação lateral
- Clique no botão Importar (ícone de upload) na área superior direita da lista de projetos
- A janela do Importador Universal será aberta
Passo 2 - Faça o upload do seu arquivo
- Arraste e solte seu arquivo na área de upload, ou clique em Navegar 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(a)
- Uma vez feito o upload, o importador lê seu arquivo e avança para a etapa de mapeamento de colunas
Passo 3 - Mapeie suas colunas
O importador tentará combinar automaticamente suas colunas da planilha com os campos do Factorial. Revise cada mapeamento e ajuste se necessário:
- Colunas com um checkmark verde foram combinadas automaticamente
- Colunas com um ícone de aviso precisam da sua atenção — selecione o campo correto do Factorial no dropdown
- Você pode ignorar colunas que não deseja importar
Uma vez que todos os campos obrigatórios estejam mapeados, clique em Continuar.
Passo 4 - Revise e corrija erros
O importador valida seus dados e mostra uma tela de revisão semelhante a uma planilha onde você pode:
- Ver todas as suas linhas com seus valores mapeados
- Células com erros estão destacadas em vermelho — passe o mouse sobre elas para ver o que está errado
- Editar valores diretamente na tela de revisão para corrigir erros antes de importar
- Remover linhas que você não deseja importar
Erros de validação comuns incluem:
| Erro | O que significa |
|---|---|
| Campo obrigatório ausente | Nome do projeto, Status, Entidade legal ou Tipo de orçamento está vazio. |
| Intervalo de data inválido | A data de vencimento é anterior à data de início. |
| Email inválido | O email do proprietário do projeto não corresponde ao formato esperado. |
| Dados do projeto inconsistentes | Duas linhas com o mesmo nome de projeto possuem valores diferentes para campos de nível de projeto (por exemplo, status diferentes). |
| Campo de orçamento não aplicável | Um campo de orçamento está preenchido, mas não se aplica ao tipo de orçamento ou escopo selecionado. |
Corrija quaisquer erros e clique em Continuar quando seus dados estiverem limpos.
Passo 5 - Confirme e importe
Revise o resumo da importação mostrando quantos projetos e fases serão criados. Clique em Importar para iniciar o processo.
A importação ocorre em segundo plano. Você pode:
- Fechar a janela e continuar trabalhando — a importação será concluída sozinha
- Verificar o Histórico de Importação para ver o status da sua importação
Histórico de importação
Você pode revisar importações passadas na seção Histórico de Importação:
- Vá para Configurações
- Acesse a seção Histórico de Importação
- Aqui você verá todas as importações anteriores com seu status (concluído, em andamento ou falhado), o número de registros importados e quaisquer erros
Referência de campos disponíveis
Abaixo está a lista completa de campos que você pode incluir em 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 ou referência curta para o projeto. |
| Status | Sim | O status do projeto. Valores aceitos: Ativo, Rascunho, Fechado. |
| Data de início | Não | A data de início do projeto. |
| Data de vencimento | Não | A data de vencimento do projeto. Deve ser na data ou após a data de início. |
| Descrição | Não | Uma descrição textual do projeto. |
| Entidade legal | Sim | A entidade legal à qual o projeto pertence. Deve corresponder a uma entidade legal existente na sua conta do Factorial. |
| Proprietário do projeto (email) | Não | O endereço de email do(a) funcionário(a) que é o(a) proprietário(a) do projeto. Deve corresponder ao email de um(a) funcionário(a) existente. |
| Tipo de orçamento | Sim | O modelo de orçamento. Valores aceitos: Tempo & Material, Preço Fixo, Sem Orçamento. |
| Escopo do orçamento | Não | Se o orçamento é acompanhado a nível de projeto ou delegado a fases. Valores aceitos: Projeto, Fases. |
| Custo estimado | Não | O valor do custo planejado. Apenas aplicável para orçamentos de Tempo & Material ou Preço Fixo com escopo de Projeto. |
| Custo fixo | Não | O valor do custo fixo. Apenas aplicável com escopo de Projeto. |
| Horas estimadas | Não | As horas planejadas para o projeto. Apenas aplicável para orçamentos de Tempo & Material com escopo de Projeto. |
| Faturável | Não | Se o projeto é faturável. Valores aceitos: verdadeiro / falso. Apenas aplicável com escopo de Projeto. |
| Orçamento estimado do cliente | Não | A receita planejada do cliente. Apenas aplicável se o projeto for faturável, para orçamentos de Tempo & Material ou Preço Fixo. |
Campos da fase
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome da fase | Não | O nome da fase a ser criada sob o projeto. |
| Código da fase | Não | Um código ou referência curta 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 na data ou após a data de início da fase. |
| Status da fase | Não | O status da fase. Valores aceitos: Ativo, Rascunho, Fechado. |
| Descrição da fase | Não | Uma descrição textual da fase. |
| Custo da fase | Não | O custo planejado para a fase. Apenas aplicável quando o escopo do orçamento é Fases. |
| Custo fixo da fase | Não | O custo fixo para a fase. Apenas aplicável quando o escopo do orçamento é Fases. |
| Horas da fase | Não | As horas planejadas para a fase. Apenas aplicável quando o escopo do orçamento é Fases. |
| Faturável da fase | Não | Se a fase é faturável. Apenas aplicável quando o escopo do orçamento é Fases. |
| Orçamento do cliente da fase | Não | A receita planejada do cliente para a fase. Apenas aplicável quando a fase é faturável e o escopo do orçamento é Fases. |
Dicas e melhores práticas
- Baixe o modelo primeiro. Ele inclui dados de exemplo e todas as colunas disponíveis, facilitando a preparação correta do seu arquivo.
- Mantenha os nomes dos projetos consistentes. 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 capitalização e espaços).
- Os campos de nível de projeto devem ser consistentes. Se duas linhas compartilham o mesmo nome de projeto, elas devem 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 desejar acompanhar o orçamento a nível de fase. Defina como "Projeto" (ou deixe em branco) para gerenciar o orçamento a nível de projeto.
- Projetos existentes são combinados pelo nome. Se um projeto com o mesmo nome já existir na sua conta do Factorial, o importador adicionará fases a esse projeto em vez de criar um duplicado. No entanto, novas fases não serão adicionadas a projetos que existiram antes do início do processo de importação.
- Fases também são deduplicadas pelo 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.
FAQ
-
Posso atualizar projetos existentes com o importador?
O importador é projetado para criar novos projetos e fases. Se um projeto com o mesmo nome já existir, nenhuma alteração será feita nele, mas novas fases ainda podem ser adicionadas.
-
O que acontece se 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 revisar quais linhas tiveram 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.
-
Há um limite de linhas?
O importador lida com 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ê precisaria excluí-los manualmente, se necessário.