Caso de Uso: Smart Component Importacao Lancamentos Contabeis Folha (De/Para)

Objetivo

Este exemplo demonstra, de forma prática, todo o fluxo necessário para utilizar o Smart Component de Importação dos Lançamentos Contábeis — desde a preparação das parametrizações até a importação final da planilha e conferência dos lotes.

O objetivo é orientar o usuário passo a passo para que a rotina seja executada com segurança, padronização e total rastreabilidade.

Configuração Inicial das Parametrizações

Antes de utilizar a rotina do Smart, é necessário garantir que as parametrizações de De/Para estejam corretamente cadastradas. Essa etapa normalmente é feita uma única vez, com eventuais manutenções sempre que novos códigos precisarem ser incluídos.

Cadastro do De/Para dos Planos de Conta

Para que o sistema consiga converter os códigos de conta antigos (vindos da planilha) para o Plano de Contas atual, siga os passos:

1. Acesse o recurso 1997 – Importação Transferência Contas Contábeis.
2. Clique em Novo para criar uma nova parametrização.
3. Preencha:

• Descrição → Nome que identifique o conjunto de contas (ex.: "Folha_2025").
• Data Escrituração → Pode ser preenchida, mas não é utilizada pela rotina.
• Tipo Importação → Selecione “Importação Lançamentos Simples.

1. Em seguida, clique no botão para adicionar itens na tabela de De/Para.
2. Pesquise e selecione o Plano de Conta atual que será utilizado. O sistema adicionará a conta ao grid.
3. No campo Código Conta Anterior, informe o código utilizado na ferramenta externa — ou seja, o código que virá na planilha.
4. Preencha demais colunas se desejar, mas elas não são consideradas pela rotina do Smart.
5. Salve o registro.

Observação: Esta parametrização não precisa ser criada novamente toda vez. Basta realizar manutenção adicionando novas contas quando necessário.

Cadastro do De/Para dos Históricos Contábeis

Agora, é preciso mapear os históricos utilizados na planilha para os Históricos Padrão do sistema:

1. Acesse o recurso 1893 – Parametrização Históricos Contábeis.
2. Clique em Novo para criar um novo registro.
3. Preencha:

• Descrição* → Uma identificação do objetivo (ex.: "Hist_Folha").
• Chave/Tipo Parametrização → Informe **"INTEGRACAO_FOLHA"**.

1. Clique em Pesquisar para selecionar o Histórico Padrão que será utilizado nos lançamentos gerados.
2. No grid, preencha o campo Código com o código do histórico utilizado na ferramenta externa — ou seja, o código que virá na planilha.
3. Salve o registro.

Observação: Assim como no De/Para de contas, a parametrização é criada apenas uma vez, com manutenções eventuais conforme necessidade.

Execução da Importação — Caso de Uso Completo

Com as parametrizações devidamente configuradas, o usuário já pode realizar a importação.

Cenário

A analista contábil Amanda recebe mensalmente a planilha da Folha de Pagamento (por exemplo, “folha_agosto_2025.xlsx”). O objetivo é importar essa planilha para gerar automaticamente os lançamentos contábeis e consolidar os lotes do período.

Passo a Passo da Importação

Acessar o Smart Component

1. Amanda acessa o recurso 1957 - Iniciar Smart Component e seleciona o SC “Importação/Transferência de Saldos Contábeis”.
2. A tela exibe os parâmetros necessários para orientar a importação.

Selecionar as Parametrizações

Nos campos exibidos pelo Smart, Amanda informa:

• De/Para Planos de Conta → Seleciona Folha_2025
• De/Para Históricos Contábeis → Seleciona Hist_Folha

Esses cadastros foram configurados previamente conforme explicado no início do caso de uso.

Selecionar o Arquivo

1. Amanda clica em Importar Dados.
2. É exibido o modal para seleção do arquivo.

Ela escolhe a planilha folha_agosto_2025.xlsx e confirma.

Sistema valida automaticamente os dados

Após confirmar, o sistema verifica:

• Se o arquivo é realmente Excel
• Se todas as contas das colunas A (Débito) e B (Crédito) existem no De/Para
• Se todos os históricos da coluna D foram parametrizados
• Se cada Centro de Resultado da coluna G está cadastrado

Caso algo esteja incorreto, o sistema exibe mensagens específicas. Caso tudo esteja correto, a importação segue normalmente.

Geração dos Lançamentos

Para cada linha válida, o sistema cria automaticamente um lançamento contábil, preenchendo:

• Conta Débito e Conta Crédito já convertidas para o plano atual
• Histórico Padrão correspondente
• Descrição do histórico
• Valor
• Data da operação
• Centro de Resultado
• Empresa e Grupo Empresa derivados do CR
• Data de cadastro = data atual
• Indicador de geração automática

Amanda revisa alguns lançamentos para conferir se a conversão está correta.

Formação dos Lotes

Após os lançamentos serem criados, o sistema organiza automaticamente os dados em lotes:

• Um lote por Grupo Empresa
• Totais de Débito e Crédito calculados automaticamente
• Saldo = Débito – Crédito
• Data do lote igual à do primeiro lançamento daquele grupo
• Origem registrada como “Importação/Transferência de Saldos Contábeis”

Amanda abre o lote e verifica se tudo está consistente.

Finalização

Com tudo revisado, Amanda conclui o processo e informa ao gestor que a importação da Folha de Agosto está concluída.

O tempo total da atividade foi de poucos minutos, substituindo o lançamento manual de dezenas de registros.

Resumo Geral do Processo

1. Configurar De/Para de contas (uma vez)
2. Configurar De/Para de históricos (uma vez)
3. Selecionar parametrizações no Smart
4. Importar planilha Excel
5. Realizar validações
6. Gerar lançamentos
7. Consolidar lotes
8. Revisar e finalizar

Benefícios

• Processo muito mais rápido e eficiente
• Redução significativa de erros operacionais
• Lançamentos padronizados e organizados
• Lotes consistentes para conferência e auditoria
• Maior clareza e rastreabilidade