Motivo de Ocorrência — Controle Patrimonial
Criado por Igor Ribeiro em 06 de novembro de 2025
Atualizado por Elton Parma em 31 de agosto de 2026
Motivo de Ocorrência — Controle Patrimonial
Cadastro dos motivos usados para justificar e classificar as ocorrências lançadas nos bens do patrimônio.
Visão Geral da Rotina
A rotina Motivo de Ocorrência é o cadastro dos motivos usados para justificar e classificar as ocorrências lançadas nos bens do patrimônio. Quando o usuário registra uma baixa, uma transferência ou uma reavaliação de um bem, ele indica o motivo daquele movimento — e é nesta rotina que os motivos disponíveis são criados e mantidos.
Cada motivo é vinculado a um tipo de ocorrência específico, o que garante que, na tela de Ocorrências do Bem, o sistema ofereça apenas os motivos compatíveis com o tipo de movimento que está sendo lançado.
É uma tela principal, com cadastro próprio, disponível no menu de Controle Patrimonial do ERP V2. O cadastro é simples: código, descrição e tipo de ocorrência vinculado.
Vídeo Tutorial
Pré-requisitos e Contexto de Acesso
O acesso à listagem exige o papel MOTIVOOCORRENCIAMENU. As demais ações têm papéis próprios: MOTIVOOCORRENCIANOVO para criar, MOTIVOOCORRENCIAEDITAR para editar, MOTIVOOCORRENCIAEXCLUIR para excluir e MOTIVOOCORRENCIAEXPORTAR para exportar a listagem.
O cadastro não depende de nenhuma etapa anterior além do conhecimento dos tipos de ocorrência do patrimônio, já definidos pelo sistema. Em contrapartida, a rotina de Ocorrências do Bem depende deste cadastro: sem motivos cadastrados para um tipo de ocorrência, o usuário não tem opção para selecionar ao lançar aquele tipo de movimento.
Processo de Criação — Passo a Passo
Acessar a rotina
O usuário abre o menu Controle Patrimonial e seleciona Motivo de Ocorrência. O sistema exibe a listagem dos motivos já cadastrados, em formato de grid.
Iniciar um novo cadastro
O usuário clica no botão Novo. O sistema abre a tela de cadastro com os campos em branco.
Informar o código do motivo
O usuário preenche o campo Código com até três caracteres. É o identificador do motivo dentro do sistema.
Informar a descrição
O usuário preenche o campo Nome com a descrição do motivo, com até cinquenta caracteres. É esse texto que aparece nas telas de ocorrência e nos relatórios.
Selecionar o tipo de ocorrência
O usuário seleciona o Tipo de Ocorrência ao qual o motivo se aplica. O vínculo determina em quais lançamentos o motivo fica disponível.
Salvar o cadastro
O usuário clica em Salvar. O sistema cria o registro com o código, o nome e o tipo de ocorrência informados, e retorna à listagem com o novo motivo disponível para uso.
Descrição de Cada Campo da Tela
Campo Código — Motivo de Ocorrência
Rótulo na tela: Código
Descrição: identificador do motivo de ocorrência. Corresponde ao campo Código, com três caracteres.
Comportamento: o sistema usa o código como chave do registro, tanto na edição quanto na exclusão. O campo também é usado como critério na pesquisa da listagem, que localiza registros cujo código contém o texto informado.
Impacto: grava a chave do motivo; é o valor referenciado pelas ocorrências de bem que utilizam o motivo e aparece nos relatórios de ocorrência e de conferência contábil.
Campo Nome — Motivo de Ocorrência
Rótulo na tela: Nome
Descrição: descrição do motivo, exibida ao usuário nas telas de lançamento e nos relatórios. Corresponde ao campo Nome, com até cinquenta caracteres.
Comportamento: o sistema aceita o texto livre e o utiliza também como critério de pesquisa na listagem, localizando registros cujo nome contém o texto informado.
Impacto: aparece na seleção de motivo da tela de Ocorrências do Bem, na listagem desta rotina, no arquivo exportado e na coluna de motivo do relatório WRCPM060.
Campo Tipo de Ocorrência — Motivo de Ocorrência
Rótulo na tela: Tipo de Ocorrência
Descrição: tipo de movimento do patrimônio ao qual o motivo se aplica, como baixa, transferência ou reavaliação. Corresponde ao campo Tipo de Ocorrência, com quatro caracteres.
Comportamento: o sistema converte o valor selecionado para o tipo de ocorrência correspondente ao gravar. Se o valor informado não corresponder a um tipo válido, a operação falha com erro técnico, sem mensagem de negócio.
Impacto: define em quais lançamentos de ocorrência o motivo fica disponível para seleção, funcionando como filtro na tela de Ocorrências do Bem.
Campo Pesquisar (filtro de consulta) — Motivo de Ocorrência
Rótulo na tela: Pesquisar
Descrição: pesquisa livre sobre os motivos cadastrados.
Comportamento: o sistema retorna os registros cujo código ou nome contêm o texto informado, mantendo a paginação da grid.
Impacto: afeta somente a consulta em tela; a exportação não considera este filtro.
Utilização e Consulta de Registros
O usuário localiza os motivos já cadastrados na tela de listagem da rotina, que apresenta os registros em grid com paginação.
O filtro disponível é o campo Pesquisar, que localiza registros cujo código ou nome contêm o texto informado. A rotina não oferece filtros adicionais por tipo de ocorrência ou por período.
Para consultar um registro específico, o usuário clica sobre a linha desejada e o sistema abre a tela de edição com os dados carregados.
O botão Exportar gera a listagem em Excel. A exportação traz até mil registros e não considera o texto digitado no campo de pesquisa — o arquivo sai com a listagem completa dentro desse limite.
Processo de Edição
A rotina permite editar os motivos cadastrados. O usuário abre o registro pela listagem e altera os campos Nome e Tipo de Ocorrência.
O campo Código funciona como chave do registro e não é alterado na edição: o sistema o utiliza para localizar o motivo e atualizar os demais dados. Para mudar o código de um motivo, o usuário cadastra um novo registro.
Não existe status ou condição que impeça a edição de um motivo já em uso. Alterar o nome de um motivo já utilizado em ocorrências passa a refletir a nova descrição nas consultas e relatórios que leem o cadastro.
A rotina não mantém registro de histórico nem log de alterações dos motivos.
Estrutura Técnica e Comportamento do Sistema
O cadastro é gravado na tabela TBMOTIVOOCORRENCIA. A tela do ERP V2 repassa as operações para o back-end do ERP V1, que atualiza o registro diretamente, sem camada de serviço intermediária.
No sistema legado, o recurso pertence ao módulo de permissão Patrimônio, e não a Controle Patrimonial, embora apareça no menu de Controle Patrimonial.
A tabela TBMOTIVOOCORRENCIA não possui triggers nem check constraints. Duas chaves estrangeiras controlam a integridade dos dados: FK_MOTIVO_OCORRENCIABEM, que liga TBOCORRENCIABEM a TBMOTIVOOCORRENCIA e bloqueia a exclusão de um motivo já usado em alguma ocorrência de bem; e FK_FATOCONTABIL_MOTIVOOCORRENC, que liga TBMOTIVOOCORRENCIA a TBFATOCONTABIL pela coluna COD_FATO.
A rotina não possui mensagens de negócio customizadas. Erros como tipo de ocorrência inválido ou código inexistente na edição e exclusão resultam em exceções técnicas apresentadas ao usuário.
Regras de Negócio e Restrições
Vínculo obrigatório com tipo de ocorrência
Cada motivo pertence a um único tipo de ocorrência. O vínculo determina em quais lançamentos o motivo fica disponível para seleção na tela de Ocorrências do Bem.
Tipo de ocorrência inválido
Se o valor informado no campo Tipo de Ocorrência não corresponder a um tipo válido do patrimônio, o sistema não grava o registro e apresenta erro técnico, sem mensagem de negócio.
Código como chave do registro
O código identifica o motivo e é usado para localizar o registro na edição e na exclusão. A edição atualiza apenas o nome e o tipo de ocorrência.
Registro inexistente na edição ou exclusão
Se o código informado não existir, a operação falha com erro técnico, sem mensagem de negócio orientativa.
Bloqueio de exclusão de motivo em uso
A tela não verifica o uso do motivo antes de excluir, mas o banco de dados bloqueia a remoção quando existe qualquer ocorrência de bem lançada com aquele motivo, por meio da chave estrangeira FK_MOTIVO_OCORRENCIABEM. A operação falha com erro técnico de violação de chave estrangeira.
Vínculo com fato contábil
O motivo referencia um fato contábil pela coluna COD_FATO, controlada pela chave estrangeira FK_FATOCONTABIL_MOTIVOOCORRENC. Esse vínculo não é configurável pela tela.
Configuração contábil não editável pela tela
As catorze colunas de configuração contábil de ganho, perda, contas padrão e atualização de prazo de depreciação existem na tabela e são consumidas pela integração contábil do patrimônio, mas não são apresentadas nem editáveis na tela de cadastro.
Limite da exportação
A exportação para Excel traz até mil registros e não aplica o texto informado no campo de pesquisa.
Ausência de histórico
A rotina não mantém log nem histórico de alterações dos motivos cadastrados.
Permissões por ação
O acesso à listagem exige MOTIVOOCORRENCIAMENU; a criação exige MOTIVOOCORRENCIANOVO; a edição exige MOTIVOOCORRENCIAEDITAR; a exclusão exige MOTIVOOCORRENCIAEXCLUIR; e a exportação exige MOTIVOOCORRENCIAEXPORTAR.
