Ocorrências em Lote — Controle Patrimonial
Criado por Igor Ribeiro em 06 de novembro de 2025
Atualizado por Elton Parma em 31 de agosto de 2026
Ocorrências em Lote — Controle Patrimonial
Permite lançar a mesma ocorrência para vários bens de uma só vez, em vez de repetir o lançamento bem a bem na tela normal de Ocorrências do Bem.
Visão Geral da Rotina
A rotina Ocorrências em Lote permite lançar a mesma ocorrência para vários bens de uma só vez, em vez de repetir o lançamento bem a bem na tela normal de Ocorrências do Bem. É a ferramenta usada quando um mesmo evento atinge um conjunto de bens ao mesmo tempo — uma depreciação, uma baixa em bloco ou uma reavaliação de um grupo de bens.
O fluxo tem duas etapas bem definidas: primeiro o usuário seleciona os bens, informa a data e o tipo de ocorrência e o sistema simula o resultado de cada bem sem gravar nada; depois, com os valores conferidos, o usuário confirma e o sistema cria uma ocorrência individual para cada bem da lista.
A rotina reaproveita integralmente a engine de ocorrências do patrimônio: cada bem passa exatamente pelas mesmas validações, cálculos, integrações contábeis e efeitos em cascata de um lançamento individual. A tela não possui listagem, exportação nem exclusão próprias — é exclusivamente um fluxo de lançamento em lote.
Vídeo Tutorial
Pré-requisitos e Contexto de Acesso
O acesso à rotina exige o perfil com a permissão de menu para Ocorrências em Lote (ID 4723), específica desta tela e diferente da permissão da tela normal de Ocorrências do Bem. Essa mesma permissão libera a etapa de simulação. Para confirmar o lançamento, o usuário precisa da permissão para confirmação de ocorrência em lote (ID 4725).
Os bens que receberão a ocorrência precisam estar cadastrados e disponíveis para seleção. Como cada lançamento segue as mesmas regras da rotina de Ocorrências do Bem, valem aqui todos os pré-requisitos daquela rotina: motivo de ocorrência cadastrado para o tipo escolhido, perfil contábil do patrimônio configurado para a geração dos lançamentos contábeis e período contábil aberto na data da ocorrência.
Processo de Criação — Passo a Passo
Acessar a rotina
O usuário abre o menu Controle Patrimonial e seleciona Ocorrências em Lote. O sistema apresenta a tela de seleção de bens e os campos de data e tipo de ocorrência.
Selecionar os bens
O usuário seleciona na grid todos os bens que receberão a ocorrência. A seleção múltipla é o ponto de partida do lote.
Informar a data da ocorrência
O usuário preenche o campo Data da Ocorrência, que vale igualmente para todos os bens selecionados.
Informar o tipo de ocorrência
O usuário seleciona o Tipo de Ocorrência que será lançado para todos os bens do lote.
Simular o lançamento
O usuário aciona a simulação. Para cada bem selecionado, o sistema calcula o valor de depreciação na data informada e monta o quadro informativo atualizado, sem gravar nada. Se algum bem apresentar erro no cálculo, o sistema acumula esse erro na lista de retorno e continua processando os demais bens.
Conferir o resultado da simulação
O usuário confere, bem a bem, os valores apresentados e os eventuais erros sinalizados. É nesse momento que ele ajusta a seleção de bens ou os dados informados, antes de gravar.
Confirmar o lançamento em lote
O usuário clica em Confirmar. O sistema cria uma ocorrência individual para cada bem da lista, processando um bem por vez com todas as validações da rotina de Ocorrências do Bem.
Conferir o retorno por bem
Ao final, o sistema apresenta a lista completa dos bens processados, indicando individualmente quais foram concluídos com sucesso e quais falharam, com a mensagem de erro correspondente a cada falha.
Descrição de Cada Campo da Tela
Campo Bens Selecionados — Ocorrências em Lote
Rótulo na tela: Bens
Descrição: relação dos bens que receberão a ocorrência. Cada linha selecionada gera uma ocorrência individual no momento da confirmação.
Comportamento: o sistema usa a lista selecionada tanto na simulação quanto na confirmação. Na simulação, calcula os valores de cada bem separadamente; na confirmação, processa um bem por vez, de forma independente dos demais.
Impacto: define a quantidade de ocorrências criadas. Cada bem selecionado recebe um registro próprio na tabela de ocorrências, com seus lançamentos contábeis e efeitos em cascata.
Campo Data da Ocorrência — Ocorrências em Lote
Rótulo na tela: Data da Ocorrência
Descrição: data em que a ocorrência é lançada para todos os bens do lote.
Comportamento: o sistema aplica a mesma data a todos os bens selecionados e a utiliza como referência no cálculo de depreciação da simulação. Na confirmação, a data passa pelas mesmas validações de período da rotina de Ocorrências do Bem.
Impacto: determina a competência dos lançamentos gerados, refletindo nos saldos do bem, nas integrações contábeis e nos relatórios de ocorrência por período.
Campo Tipo de Ocorrência — Ocorrências em Lote
Rótulo na tela: Tipo de Ocorrência
Descrição: tipo de movimento do patrimônio aplicado a todos os bens do lote, como depreciação (DEPR), baixa (BXA) ou transferência (TRNS).
Comportamento: o sistema utiliza o tipo selecionado para calcular a simulação de cada bem e para criar as ocorrências na confirmação. O tipo é o mesmo para todos os bens do lote — não é possível misturar tipos diferentes em uma única execução.
Impacto: define a natureza do lançamento, os motivos disponíveis, as contas contábeis utilizadas na integração e a forma como o valor afeta o saldo de cada bem.
Campo Quadro Informativo Simulado — Ocorrências em Lote
Rótulo na tela: Quadro Informativo
Descrição: resultado da simulação por bem, com os valores que a ocorrência produziria na data e no tipo informados.
Comportamento: o sistema preenche o quadro na etapa de simulação, sem gravar nenhum registro. Erros de cálculo em bens específicos aparecem na própria lista, sem interromper a simulação dos demais.
Impacto: é a base de conferência antes da confirmação; os valores apresentados são os que o sistema grava quando o usuário confirma o lote.
Campo Resultado do Processamento — Ocorrências em Lote
Rótulo na tela: Resultado
Descrição: retorno individual de cada bem após a confirmação, indicando sucesso ou falha no lançamento.
Comportamento: o sistema apresenta, para cada bem, o indicador de sucesso e, em caso de falha, a mensagem: “O Bem {CodigoDoBem} não foi concluido com sucesso! {mensagem da exceção}”.
Impacto: identifica quais bens ficaram sem ocorrência lançada, permitindo ao usuário reprocessar apenas esses bens em uma nova execução.
Utilização e Consulta de Registros
A rotina não possui listagem própria de registros. Ela existe apenas para executar o fluxo de simulação e confirmação do lote.
A consulta das ocorrências geradas acontece na rotina de Ocorrências do Bem, onde cada lançamento criado pelo lote aparece como uma ocorrência individual do respectivo bem, com seus filtros habituais de bem, tipo, data e filial.
Os relatórios de ocorrência também apresentam os lançamentos gerados em lote: o WRCPM052 mostra o extrato de movimentações de um bem específico, o WRCPM054 lista as ocorrências por período de forma analítica, o WRCPM056 traz a versão totalizada e o WRCPM060 permite conferir se cada ocorrência gerou o lançamento contábil correspondente.
Processo de Edição
A rotina não permite editar registros. Ela não mantém nenhum registro próprio: o único resultado da execução são as ocorrências individuais criadas em cada bem.
A alteração ou o cancelamento de uma ocorrência gerada pelo lote acontece na rotina de Ocorrências do Bem, bem a bem, respeitando as regras de edição e exclusão daquela rotina. A rotina de lote também não oferece exclusão nem exportação próprias.
Estrutura Técnica e Comportamento do Sistema
A tela de lançamento em lote não possui lógica de negócio própria: ela consome as mesmas rotinas da tela normal de Ocorrências do Bem, reaproveitando integralmente as validações, os cálculos, as integrações contábeis e os efeitos em cascata já existentes.
A etapa de simulação processa o quadro informativo de cada bem sem gravar nada no banco de dados. Os erros encontrados por bem são acumulados em uma lista e devolvidos junto com o resultado, sem interromper o processamento dos demais bens.
A confirmação do lote não é uma transação única. Cada bem é processado individualmente, chamando exatamente a mesma lógica do lançamento unitário de ocorrência. Se um bem falhar, os demais continuam sendo processados normalmente, e a resposta traz o resultado individual de cada um.
Todas as proteções de banco de dados da rotina de Ocorrências do Bem valem aqui da mesma forma, bem a bem: as triggers da tabela de Ocorrências do Bem e a check constraint que restringe os tipos de ocorrência aceitos.
As ocorrências geradas alimentam a integração contábil do patrimônio, que consulta o Perfil Contábil do Patrimônio para determinar a conta de cada tipo de movimento, e passam a compor os saldos lidos pelos relatórios de ocorrência e pelo fechamento patrimonial.
Regras de Negócio e Restrições
Simulação obrigatória antes da confirmação
O fluxo da rotina começa pela simulação: o usuário informa a data e o tipo de ocorrência, o sistema calcula os valores de cada bem selecionado e só então o lançamento é confirmado com os dados já apurados.
Simulação não grava nada
A etapa de simulação não cria ocorrências, não gera lançamentos contábeis e não altera saldos. Serve exclusivamente para conferência prévia dos valores.
Mesmo tipo e mesma data para todo o lote
Todos os bens do lote recebem a mesma data e o mesmo tipo de ocorrência. Para lançar tipos ou datas diferentes, o usuário executa a rotina mais de uma vez.
Uma ocorrência por bem
A confirmação cria uma ocorrência individual para cada bem selecionado, com os dados específicos daquele bem já apurados na simulação.
Processamento independente por bem
Cada item da lista é processado individualmente, com todas as validações, mensagens de erro e efeitos em cascata da rotina de Ocorrências do Bem aplicados bem a bem.
Lote não é transação única
Se o lançamento de um bem falhar, os demais continuam sendo processados normalmente. O bem com falha recebe o indicador de insucesso e a mensagem: “O Bem {CodigoDoBem} não foi concluido com sucesso! {mensagem da exceção}”.
Erros na simulação não interrompem a lista
Durante a simulação, erros de cálculo em bens específicos são acumulados e retornados junto com o resultado, sem interromper o processamento dos bens restantes.
Retorno individualizado
A resposta da confirmação traz a lista completa dos bens com o resultado de cada um, permitindo identificar exatamente quais lançamentos foram efetivados e quais precisam de nova tentativa.
Ausência de listagem, exclusão e exportação
A rotina não mantém registros próprios e não oferece listagem, exclusão nem exportação. Todas essas operações acontecem na rotina de Ocorrências do Bem.
Proteções de banco de dados aplicadas por bem
As triggers da tabela de Ocorrências do Bem e a check constraint de tipos de ocorrência atuam individualmente em cada lançamento do lote, da mesma forma que em um lançamento unitário.
Permissões por ação
O acesso à rotina e a etapa de simulação exigem a permissão para Ocorrências em Lote (ID 4723). A confirmação do lançamento em lote exige a permissão para confirmação de ocorrência em lote (ID 4725).
