Histórico Padrão
Criado por Igor Ribeiro em 24 de setembro de 2025
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Documentação Técnica
Histórico Padrão
Rotina de Contabilidade / Cadastros que permite cadastrar textos padronizados usados para descrever a natureza de lançamentos contábeis ou financeiros, evitando digitação repetida a cada lançamento.
01 — VISÃO GERAL
Visão Geral da Rotina
A rotina de Histórico padrão, dentro do módulo Contabilidade (Contabilidade / Cadastros / Histórico padrão), permite cadastrar textos padronizados que descrevem a natureza de um lançamento contábil ou financeiro (por exemplo, “Pagamento de fornecedor” ou “Recebimento de duplicata”). Em vez de digitar a mesma descrição a cada lançamento, o usuário seleciona um histórico padrão já cadastrado.
Cada histórico padrão tem um código numérico e um nome, e pode ser marcado como participante do LCDPR (Livro Caixa Digital do Produtor Rural), obrigação acessória usada por produtores rurais. Além do cadastro em si, a rotina permite consultar quais “fatos contábeis” (regras de geração automática de lançamento contábil a partir de operações financeiras ou de movimentações de estoque/produção) estão associados a um histórico, e atualizar em lote a descrição já gravada nesses lançamentos quando o texto do histórico padrão muda.
02 — VÍDEO TUTORIAL
Vídeo Tutorial do Histórico Padrão
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
03 — PRÉ-REQUISITOS
Pré-requisitos e Contexto de Acesso do Histórico Padrão
Para acessar a tela de Histórico padrão, o usuário precisa ter a permissão “ListViewDeHistoricoPadrao” atribuída ao seu perfil — sem ela, o item de menu “Contabilidade / Cadastros / Histórico padrão” não é exibido.
Para executar ações específicas dentro da tela, o usuário precisa também das permissões correspondentes:
Incluir
Permissão “HistoricoPadrao/Novo”.
Editar
Permissão “HistoricoPadrao/Editar”.
Excluir
Permissão “HistoricoPadrao/Excluir”.
Exportar
Permissão “HistoricoPadrao/Exportar”.
Atualizar Fatos Contábeis
Permissão “HistoricoPadrao/AtualizarFatosContabeis”, necessária para atualizar os fatos contábeis vinculados a um histórico.
Dependência
Não há dependência de cadastro prévio de outra rotina para criar um histórico padrão em si; porém, para que um histórico seja efetivamente utilizado em lançamentos automáticos, ele precisa estar associado a um ou mais “fatos contábeis” (regras configuradas em outra rotina do sistema).
04 — PASSO A PASSO
Processo de Criação — Passo a Passo
1
Acessar a rotina
O usuário acessa “Contabilidade / Cadastros / Histórico padrão” e aciona a opção de novo cadastro.
2
Informar o código do histórico
O usuário digita o código numérico (campo “ID”) que identificará o histórico padrão. O sistema exige que esse campo seja preenchido.
3
Informar o nome do histórico
O usuário digita o texto descritivo do histórico (campo “Nome”). O sistema exige o preenchimento e limita o texto a 150 caracteres.
4
Indicar participação no LCDPR
O usuário marca ou desmarca o indicador “Participa do LCDPR”, conforme o histórico deva ou não ser considerado nessa obrigação acessória. Esse campo é opcional.
5
Salvar
O usuário confirma o cadastro. O sistema grava o novo histórico padrão e exibe a mensagem “Historico Padrão inserido com sucesso.”.
05 — CAMPOS DA TELA
Descrição de Cada Campo da Tela do Histórico Padrão
Código (campo “ID” do histórico padrão)
Tipo: número
Obrigatoriedade: obrigatório
Descrição: código numérico que identifica o histórico padrão de forma única.
Comportamento: não pode ficar em branco; é usado como chave de busca (aceita busca exata por código na listagem).
Impacto: aparece em todas as telas onde o histórico padrão é selecionado (lançamentos contábeis/financeiros) como parte do texto “Código – Nome”; é a chave usada para localizar os fatos contábeis vinculados.
Nome (campo “Nome” do histórico padrão)
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: descrição textual do histórico, exibida junto ao código nos lançamentos.
Comportamento: limitado a 150 caracteres; aceita busca por conteúdo (texto parcial) na listagem.
Impacto: é o texto exibido nos lançamentos contábeis/financeiros que utilizam este histórico; pode ser propagado retroativamente aos lançamentos de fato contábil já existentes através da funcionalidade de atualização de fatos contábeis (ver seção 8).
Participa do LCDPR (campo “Participa do LCDPR”)
Tipo: checkbox (indicador de 0 ou 1)
Obrigatoriedade: opcional — quando não informado, o sistema assume o valor 0 (não participa)
Descrição: indica se este histórico deve ser considerado na apuração do LCDPR (Livro Caixa Digital do Produtor Rural).
Comportamento: alterna entre marcado/desmarcado; não possui validação adicional.
Impacto: [informação não disponível na análise de código — validar com analista/vídeo do sistema] quanto ao relatório/processo específico do LCDPR que consome esse indicador.
06 — CONSULTAS
Utilização e Consulta de Registros do Histórico Padrão
O usuário localiza históricos padrão existentes através da grid de listagem da rotina, que exibe Código e Nome. É possível filtrar a lista digitando um texto de busca: se o texto digitado for um número, o sistema busca tanto por código exato quanto por nome que contenha o texto; se for texto, busca apenas por nome que contenha o valor digitado. A listagem também está disponível para exportação (Excel/outro formato configurado) e para consulta por outras telas do sistema (via consulta dinâmica de grid).
07 — EDIÇÃO
Processo de Edição do Histórico Padrão
Após o cadastro, o usuário pode editar o Nome e o indicador “Participa do LCDPR” de um histórico padrão existente, informando o Código do registro a ser alterado. O Código (ID) é a chave do registro e é usado para localizar o histórico a editar — a análise de código não identificou uma trava explícita contra a alteração do próprio código no fluxo de edição; ao confirmar a edição, o sistema grava a alteração e exibe a mensagem “Historico Padrão editado com sucesso.”.
Importante
A edição do Nome do histórico não altera automaticamente a descrição que já foi gravada em lançamentos anteriores (fatos contábeis Financeiro e TMV) que usam esse histórico. Para propagar o novo texto a esses lançamentos já existentes, é necessário usar a funcionalidade de atualização de fatos contábeis, descrita na seção 8.
08 — ESTRUTURA TÉCNICA
Estrutura Técnica e Comportamento do Sistema do Histórico Padrão
Integração com fatos contábeis
A rotina se integra com o módulo de lançamentos contábeis/financeiros através dos chamados “fatos contábeis” — regras que associam um histórico padrão a uma operação financeira (ex: liquidação de título) ou a um tipo de movimento (TMV, usado em operações de estoque/produção). A tela permite consultar, para um determinado código de histórico, quais fatos contábeis Financeiro e quais fatos contábeis TMV estão vinculados a ele.
Atualização em lote
Há uma funcionalidade específica de atualização em lote: ao alterar a descrição de um histórico, o usuário pode disparar uma atualização que propaga o novo texto diretamente para os registros de lançamento de fato contábil Financeiro e TMV já gravados no banco de dados, mantendo consistente a descrição exibida em lançamentos passados. Essa atualização é uma operação direta sobre os dados dos lançamentos (não altera o cadastro do histórico) e é registrada em log técnico do sistema antes e depois de cada etapa.
09 — REGRAS DE NEGÓCIO
Regras de Negócio e Restrições do Histórico Padrão
Regra 1
Código e nome são obrigatórios
O sistema não permite salvar um histórico padrão sem código (campo “ID”) ou sem nome (campo “Nome”) preenchidos — ambos são de preenchimento obrigatório.
Regra 2
Limite de tamanho do nome
O campo Nome aceita no máximo 150 caracteres.
Regra 3
Exclusão sem verificação de uso pelo sistema
A rotina de Histórico padrão não impede, por regra de negócio própria, a exclusão de um histórico que já esteja referenciado em lançamentos de fato contábil (Financeiro ou TMV) ou em outros lançamentos que utilizem esse código. Diferente de outras rotinas do módulo Contabilidade (como Divisão contábil), não há aqui uma mensagem de bloqueio de “registro em uso” — qualquer impedimento de exclusão, se ocorrer, viria de uma restrição do próprio banco de dados, não de uma validação visível ao usuário nesta tela.
Regra 4
Atualização de fatos contábeis é uma ação separada da edição do cadastro
Alterar o Nome do histórico padrão (edição do cadastro) não atualiza automaticamente o texto já gravado nos lançamentos de fato contábil existentes. O usuário precisa executar explicitamente a atualização de fatos contábeis, informando o código do histórico e o novo texto de descrição, para que a mudança seja refletida nos lançamentos Financeiro e TMV já registrados.
Regra 5
Indicador de participação no LCDPR
Quando não informado no cadastro, o indicador “Participa do LCDPR” assume o valor padrão “não participa” (0).
