> For the complete documentation index, see [llms.txt](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/modulos/migracoes.md). # Migrações O que é o módulo Migrações, para que serve e quais dados cada planilha permite importar para o UpGestão. ### Objetivo Importar em lote, por planilha, os cadastros e lançamentos que a empresa já possui em outro sistema ou em Excel, evitando a digitação manual ao começar a usar o UpGestão. O módulo também serve para **atualizar registros em massa**: quando o código informado na planilha já existe, o registro é alterado em vez de duplicado. ### Antes de começar * Permissão de acesso ao menu **Migrações** * Dados de origem organizados em planilha (exportação do sistema antigo ou Excel) * Recomendado: fazer um **backup** dos cadastros atuais antes de migrar clientes ou produtos ### Resultado esperado Registros importados no UpGestão e, quando houver linhas com erro, uma planilha de correção disponível para download na **Listagem de Migrados**. *** ### O que pode ser migrado A tela possui uma aba para cada tipo de dado: | Aba | O que importa | Backup | | ----------------------------------- | ------------------------------------------------------------------ | ------ | | [Clientes](#clientes) | Clientes, fornecedores e transportadoras, com endereços e contatos | Sim | | [Produtos](#produtos) | Produtos e serviços, com dados fiscais e até 5 preços | Sim | | [Finanças](#financas) | Contas a receber e a pagar, pagas ou em aberto | Não | | [Centro de Custo](#centro-de-custo) | Centros de resultado para receitas e despesas | Não | | [Categoria](#categoria) | Plano de categorias financeiras (usado no DRE) | Não | | [Inventário](#inventario) | Saldo inicial de estoque (uso exclusivo do suporte) | Não | *** ### Como migrar {% stepper %} {% step %} ### Escolher a aba e baixar o modelo 1. Acesse **Migrações** no menu lateral. 2. Selecione a aba do tipo de dado. 3. Clique em **Baixe o modelo** para obter a planilha padrão. ![Migrações, aba Clientes, com a Listagem de Migrados](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FSLAo7TMBoDDYX723ZHD3%2Fmigracoes-01-clientes.jpg?alt=media) {% endstep %} {% step %} ### Preencher a planilha seguindo as regras * Não altere o cabeçalho, a ordem das colunas nem exclua colunas. * Deixe vazias as colunas sem informação (exceto as colunas de código, quando indicado). * Não deixe linhas totalmente em branco no meio dos dados. * Envie no máximo **5.000 registros** por arquivo. * Campos marcados com **\*** são obrigatórios. {% endstep %} {% step %} ### Selecionar o arquivo e migrar 1. Clique em **Selecione o arquivo** e escolha a planilha (**.xls**, **.xlsx**, **.csv** ou **.txt**, até **2 MB**). 2. Clique em **Migrar** na barra superior. {% endstep %} {% step %} ### Conferir o resultado A **Listagem de Migrados** mostra cada importação com **Data**, quantidade de registros **Alterados**, **Migrados** e **Rejeitados**. Se houver rejeições, clique em **Logs** para baixar a planilha de correção. Ela indica o erro de cada linha. Corrija e migre somente as linhas rejeitadas. {% endstep %} {% endstepper %} {% hint style="info" %} Nas abas **Clientes** e **Produtos**, o botão **Fazer Backup** baixa uma planilha com os cadastros atuais. Use-a antes de uma atualização em massa. {% endhint %} *** ### Clientes Importa **clientes, fornecedores e transportadoras** em uma única planilha. ![Aba Clientes](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FSLAo7TMBoDDYX723ZHD3%2Fmigracoes-01-clientes.jpg?alt=media) | Campo | Regra | | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Código** | Chave do cadastro, deve conter um número. Se já existir, o cadastro é **atualizado**. Caso contrário, é incluído como novo | | Código Externo, Data de Cadastro | Opcionais | | Inativo | 0 = ativo, 1 = inativo | | **Cliente/Fornecedor/Transportadora**\* | 1 = cliente, 2 = fornecedor, 3 = transportadora (aceita combinações) | | **Pessoa**\* | F = física, J = jurídica | | **Razão Social/Nome**\*, Nome Fantasia | Nome do cadastro | | CNPJ/CPF, IE/RG, IM/Produtor Rural, Sexo (M/F) | Documentos e dados pessoais | | Tipo Contribuinte ICMS | 9 = consumidor, 1 = contribuinte com inscrição estadual, 2 = contribuinte sem inscrição estadual | | Contribuinte ISS | 0 = não, 1 = sim | | Data de Nascimento, Tipo de Cadastro, E-mail | Opcionais | | Endereço de faturamento | CEP, Endereço, Número, Complemento, Bairro, Cidade e **UF**\* | | Endereço de entrega | Mesmos campos do faturamento | | Contatos | Nome do contato, Fone, Fone 2, Celular, Site e Anotações | | Senha Ecommerce, Limite de Crédito | Acesso à loja virtual e limite para vendas a prazo | | Vendedores, Marcadores | Códigos já cadastrados no sistema | *** ### Produtos Importa **produtos e serviços** com dados fiscais e preços. ![Aba Produtos](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FxJQBtRohELFmcICmvDlZ%2Fmigracoes-03-produtos.jpg?alt=media) | Campo | Regra | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Código | Em branco, é gerado automaticamente. Se já existir, o produto é **atualizado** | | Data de Cadastro, Inativo | Opcionais (Inativo: 0 ou 1) | | **Descrição**\* | Nome do produto | | NCM, CEST | NCM com 8 dígitos e CEST com 7 dígitos | | CSOSN, Origem | Código de situação da operação no Simples Nacional e origem da mercadoria | | Código de Barras, Unidade | Opcionais (unidade com 2 caracteres, ex.: PC, KG, LT) | | Peso Líquido, Peso Bruto | Até 3 casas decimais. O peso bruto deve ser maior ou igual ao líquido | | Tipo de Produção | P = próprio, T = terceiros, I = insumo | | É Serviço | 0 = produto, 1 = serviço | | Tipo Específico | Em branco = normal. 0 = normal, 1 = veículo, 2 = medicamento, 3 = combustível, 4 = perecível, 5 = pesável, 6 = rastreável, 7 = controlado | | Preço 1 a Preço 5 | Preço de venda e tabelas adicionais | | Código Interno, Markup | Opcionais | *** ### Finanças Importa **lançamentos financeiros** (receitas e despesas), pagos ou em aberto. ![Aba Finanças](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FzZYFKtfFZrN3E5boDLZ5%2Fmigracoes-04-financas.jpg?alt=media) | Campo | Regra | | -------------------------------------------------- | --------------------------------------------------------------------------------------- | | CPF/CNPJ, **Nome do Cliente**\* | Cadastro vinculado ao lançamento | | **Data de Lançamento**\*, **Data de Vencimento**\* | Datas do título | | **Tipo**\* | 1 = receita, 2 = despesa | | Parcelamento/Recorrência, Qtd. Parcelas | 1 = parcelado, 2 = recorrente, em branco = nenhum | | Periodicidade | 365 = anual, 180 = semestral, 90 = trimestral, 30 = mensal, 15 = quinzenal, 7 = semanal | | Documento, **Descrição**\* | Identificação do título | | Conta Financeira, **Forma de Pagamento**\* | Cadastros existentes no sistema | | Centro de Resultado, Categoria | Classificação financeira | | Campo Adicional 1 e 2, Vendedor, Observações | Opcionais | | **Subtotal**\* | Valor do título | | **Título Pago**\*, Data de Pagamento | 0 = em aberto, 1 = pago (informe a data de pagamento) | *** ### Centro de Custo Importa os **centros de resultado** usados para classificar receitas e despesas. ![Aba Centro de Custo](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FnpIGn7DSR0PYjnBaKtOk%2Fmigracoes-05-centro-de-custo.jpg?alt=media) | Campo | Regra | | --------------- | ------------------------------------- | | **Descrição**\* | Nome do centro de custo | | **Categoria**\* | 0 = ambos, 1 = receitas, 2 = despesas | *** ### Categoria Importa o **plano de categorias financeiras**, que alimenta relatórios como o DRE. ![Aba Categoria](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FHVNZ1iz6CKXGnUtL2a80%2Fmigracoes-06-categoria.jpg?alt=media) | Campo | Regra | | ---------------------------- | ------------------------------------------------------------------------------------- | | **Descrição**\* | Nome da categoria | | **Categoria Pai**\* | Uma categoria pai padrão ou uma categoria criada em linha **acima** na mesma planilha | | Compõe DRE | 0 = não, 1 = sim | | É despesa fixa?, Compõe CAC? | 0 ou 1. Apenas para categorias de despesa | Categorias pai padrão: * **Receitas**: Receita Operacional Bruta, Receitas Financeiras e Outras Receitas * **Despesas**: Deduções da Receita Bruta, Custo dos Produtos e Serviços, Despesas Operacionais, Despesas Financeiras, Outras Despesas e Impostos *** ### Inventário Migra o **saldo inicial de estoque** a partir de um inventário (SPED ou Sintegra). A migração é feita uma única vez e oferece a opção **Recalcular Estoque**. ![Aba Inventário protegida por senha](https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2Fl0uGhk3tvTifZzFaMP3m%2Fmigracoes-07-inventario.jpg?alt=media) {% hint style="warning" %} A aba **Inventário** é de uso exclusivo dos analistas de suporte e é protegida por senha. Para importar o estoque inicial, entre em contato com o suporte. {% endhint %}