O guia rápido "Personalização de histórico de lançamentos contábeis" está subdividido nas seções:

• O que é a personalização do histórico dos lançamentos contábeis?
• Por que essa funcionalidade é importante?
• Quais variáveis podem ser utilizadas no histórico?
• Como funciona a tela de edição do histórico contábil?
  • Organização da tela
  • Tabela de lançamentos contábeis padrões
• Histórico padrão x histórico personalizado
• Edição individual e edição em lote
• Como o histórico aparece nos lançamentos contábeis?
• Atualização de lançamentos já realizados
• Permissões de usuários
• Pontos de atenção

O que é a personalização do histórico dos lançamentos contábeis?

A personalização do histórico dos lançamentos contábeis é o recurso que permite à empresa definir como os textos dos históricos são gerados, substituindo descrições genéricas por textos mais ricos em informação, sem perder o vínculo com os documentos de origem.

Por meio dessa funcionalidade, o sistema permite a inclusão de informações como:

• Razão social do cliente ou fornecedor;

• Número da nota fiscal (NF-e ou NFS-e);

• Data de emissão do documento fiscal;

• Código do documento, movimentação ou lançamento;

• Datas relevantes do processo (emissão, entrada, saída, pagamento, recebimento, etc.).

Essas informações são inseridas por meio de variáveis, que são substituídas automaticamente pelos valores reais no momento da geração do lançamento contábil.

Segue abaixo um exemplo de como essa funcionalidade pode agregar na sua empresa: 

• Histórico padrão simples: Venda de serviço referente ao documento 197.

• Histórico personalizado com variáveis: Venda de serviço referente ao documento 197, Vale S/A, NF 2024/157 de 04/11/2024.

Esse padrão se repete automaticamente para todos os lançamentos derivados da mesma operação, como impostos, descontos, custos e receitas.

Veja uma imagem da tela "Editar histórico contábil":

Por que essa funcionalidade é importante?

A personalização do histórico contábil resolve uma dor recorrente em processos contábeis mais robustos: a falta de contexto nos históricos dos lançamentos.

Com históricos mais completos, a empresa ganha:

• Mais segurança na conciliação contábil, validando facilmente configurações e resultados;

• Melhor leitura do Livro Diário e do Razão, sem necessidade de consultas paralelas ao sistema;

• Aderência à linguagem contábil, especialmente em auditorias e fiscalizações;

• Padronização dos textos, mesmo com maior nível de detalhamento;

• Flexibilidade, pois a personalização é opcional e controlada por permissão.

Como observado por clientes, em processos de compra, por exemplo, a data de emissão da nota fiscal raramente coincide com a data de entrada, e esse detalhe faz toda a diferença na análise contábil.

Quais variáveis podem ser utilizadas no histórico?

O sistema disponibiliza um conjunto amplo de variáveis dinâmicas, organizadas por origem do lançamento, facilitando a configuração correta.

As variáveis incluem, entre outras:

Variáveis de identificação

• @codLancamento

• @codDocumento

• @numeroDocumentoOrigem

• @codMovimentacao

• @nomeLancamento

Variáveis de datas

• @dataLancamento

• @dataEmissao

• @dataEntrada

• @dataSaida

• @dataPagamentoRecebimento

• @dataVencimento

Variáveis de empresa e pessoa

• @nomeEmpresa

• @razaoSocialEmpresa

• @nomePessoa

• @razaoSocialPessoa

Variáveis fiscais

• @numeroNFe

• @numeroNFSe

Variáveis de produto, estoque e produção

• @codProduto

• @nomeProduto

• @setorEstoque

• @nomeOrdem

As variáveis são apresentadas na tela separadas por origem (Financeiro, Estoque, Produção, Documento de saída, Documento de entrada, etc.), evitando o uso incorreto de informações incompatíveis.

Veja uma imagem de variáveis na tela "Editar histórico contábil":

Como funciona a tela de edição do histórico contábil?

A funcionalidade conta com uma tela de edição do histórico contábil. Para acessar, segue os passos abaixo:

• Acesse a tela "Lançamentos contábeis padrões".

• Filtre pelos lançamentos contábeis desejado.

• Selecione os lançamentos e clique no botão "Ações".

• Em seguida, clique em "Editar histórico contábil em lote".

Veja uma imagem do botão "Ações" da tela lançamentos contábeis padrões:

Organização da tela

Segue abaixo como a tela 

• Variáveis organizadas por origem:

  • Estoque

  • Produção

  • Financeiro

  • Documento de saída

  • Documento de entrada

  • Documento de venda de serviço

  • Documento de compra de serviço

• As variáveis são exibidas fechados por padrão, melhorando a organização.

• Cada variável possui nome e contexto, auxiliando o uso correto.

Veja uma imagem das variáveis organizadas por origem:

Tabela de lançamentos contábeis padrões

A tela apresenta uma tabela semelhante à já existente no sistema, com as seguintes características:

• A coluna Histórico é editável;

• A coluna Histórico base exibe o histórico padrão do sistema, apenas para consulta;

• As demais colunas permanecem apenas para visualização.

Veja uma imagem da tabela de lançamentos contábeis padrões em destaque:

Histórico padrão x histórico personalizado

O sistema trabalha sempre com dois históricos distintos:

• Histórico padrão do sistema: Texto nativo, imutável e sempre preservado.

• Histórico personalizado da empresa: Texto configurável, utilizado na geração dos lançamentos quando preenchido.

Se o histórico personalizado estiver vazio, o sistema utiliza automaticamente o histórico padrão.
 

Isso garante segurança e evita a perda do padrão original.

Veja uma imagem com as colunas referentes ao histórico personalizado:

Edição individual e edição em lote

Na tela de Lançamentos contábeis padrões, o sistema permite:

• Seleção de múltiplos lançamentos;

• Ação “Editar histórico contábil em lote”;

• Submenu “Editar histórico contábil” para edição individual.

Quando um lançamento possui histórico personalizado, o sistema exibe um ícone informativo (i), que permite visualizar o histórico padrão original diretamente na tela.

Veja uma imagem da tela "Lançamentos contábeis padrões" com o submenu em destaque:

Como o histórico aparece nos lançamentos contábeis?

Após a configuração, o resultado pode ser visto diretamente nas telas operacionais, como na aba Contabilidade do Documento de saída. Nessa tela:

• O histórico já aparece processado, com as variáveis substituídas;

• Os lançamentos derivados (receita, custo, impostos, etc.) mantêm coerência textual;

• A leitura contábil fica clara e contextualizada.

Atualização de lançamentos já realizados

A personalização do histórico não altera lançamentos já existentes.

• Lançamentos já gerados só podem ser atualizados por reprocessamento contábil;

• Isso evita inconsistências com exportações para sistemas contábeis externos;

• Caso uma variável não esteja disponível para aquela origem, o sistema exibirá o nome da variável, facilitando a correção.

Permissões de usuários

O acesso à funcionalidade é controlado por permissão de grupo de usuários.

Na tela de edição/criação de grupo, aba Permissões do sistema, quadro Contabilidade Gerencial, é necessário habilitar:

• Editar histórico de lançamento contábil padrão.

• Editar lançamento contábil padrão.

Somente usuários autorizados podem alterar os históricos.

Veja uma imagem da edição de um grupo de usuários com as permissões em destaque:

Pontos de atenção

• O histórico padrão do sistema nunca pode ser apagado;

• Salvar o histórico personalizado em branco restaura automaticamente o padrão;

• O sistema valida o uso de variáveis incompatíveis com a origem;

• Alterações impactam apenas lançamentos futuros;

A personalização do histórico dos lançamentos contábeis permite que a empresa eleve significativamente a qualidade da informação contábil, tornando os registros mais claros, completos e alinhados às exigências contábeis e legais.

Com esse recurso, o sistema mantém a segurança do padrão nativo, ao mesmo tempo em que oferece flexibilidade, rastreabilidade e padronização, beneficiando conciliações, auditorias e fiscalizações sem comprometer a governança contábil.