Evidências
Criado por Igor Ribeiro em 25 de agosto de 2026
Atualizado por Igor Ribeiro em 26 de agosto de 2026
Evidências
Registre fotos de ocorrências sanitárias e irregularidades durante o processo de abate, documentando cada ponto de inspeção com precisão e rastreabilidade.
Visão Geral das Evidências
A rotina de Evidências, dentro do módulo de Abate do FrigosoftColetor, permite ao operador registrar fotos vinculadas a um animal durante o processo de abate, documentando ocorrências sanitárias ou irregularidades observadas em diferentes pontos da linha — como Vivo, Rastreamento (Rast1 e Rast2), Vísceras, DIF (Departamento de Inspeção Final) e Balança de Abate. Cada foto registrada é associada a um local de inspeção, a uma ocorrência específica (por exemplo, “Pneumonia” ou “Contusão”) e, quando o local exige, também a uma banda (o lado da carcaça em que a irregularidade foi encontrada).
No fluxo geral do módulo de Abate, a captura de evidências acontece depois que o animal já passou pelas etapas de rastreamento e tipificação. Trata-se, portanto, de um registro de apoio ao processo de inspeção sanitária, e não de uma etapa obrigatória de todo animal — ela é usada sempre que o inspetor ou o operador identifica algo que precisa ser fotografado e documentado.
As fotos registradas ficam disponíveis para consulta posterior dentro da própria tela de Evidências, junto com os dados do animal. Quando existe Romaneio de Abate vinculado ao animal, essas evidências também são enviadas automaticamente ao ERP, tornando-se parte do histórico sanitário oficial do abate daquele animal.
Vídeo Tutorial das Evidências
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso das Evidências
Perfil de usuário
A tela de Evidências é utilizada pelo operador que atua na linha de abate, responsável por fotografar e registrar as irregularidades observadas nos animais durante o processo.
Sessão ativa com filial e data de abate definidas
O sistema usa a filial e a data de abate da sessão logada para saber quais animais devem aparecer na lista e para filtrar corretamente as operações. Se a sessão não estiver ativa ou não tiver esses dados definidos, a lista de animais e a lista de ocorrências não são carregadas, e a tela de Evidências não funciona.
Configuração de uso de carretilha
Cada filial pode ou não trabalhar com carretilha (um código usado para identificar o animal na linha). Essa configuração vem definida pelo servidor, a partir do cadastro da filial — o operador não escolhe nem altera essa configuração dentro do aplicativo. Se a informação não estiver configurada, o sistema assume que a filial não usa carretilha, e a busca do animal passa a ser feita pela sequência numérica de abate.
Animais do dia disponíveis
É necessário que existam animais já cadastrados na data de abate da sessão ativa. Sem animais cadastrados nessa data, a lista fica vazia e não há animal disponível para receber uma evidência.
Dependência de etapas anteriores
A captura de evidências pressupõe que o animal já tenha passado pelas etapas de rastreamento e tipificação no fluxo de abate. A rotina de Evidências não substitui essas etapas — ela documenta ocorrências observadas ao longo delas.
Sincronização com o ERP (quando aplicável)
Para que a evidência seja enviada automaticamente ao ERP no momento do salvamento, é necessário que exista Romaneio de Abate vinculado ao animal. Sem Romaneio de Abate, a evidência é salva normalmente no Manager, mas não é sincronizada com o ERP no momento do salvamento.
Processo de Criação — Passo a Passo das Evidências
Abrir a tela de Evidências
O operador abre a tela de Evidências. O sistema carrega, ao mesmo tempo, a lista de animais do dia e a lista de ocorrências disponíveis para vínculo com as evidências.
Aguardar o carregamento inicial
Enquanto os dados carregam, a tela exibe um indicador de carregamento. Ao concluir, o sistema exibe a lista de animais do dia. Se algum dos dois carregamentos (animais ou ocorrências) falhar, o sistema exibe a mensagem de erro retornada pelo servidor; se essa mensagem estiver vazia, exibe um texto genérico de erro de conexão. Caso os dois carregamentos falhem ao mesmo tempo, apenas a mensagem do primeiro erro é exibida — a mensagem do segundo é descartada.
Localizar o animal
O operador localiza o animal desejado de uma das duas formas:
- Digitando a sequência de abate (quando a filial não usa carretilha) ou o código de carretilha (quando a filial usa carretilha) no campo de busca e pressionando a tecla de envio do teclado.
- Selecionando o animal diretamente na lista de animais exibida na tela — o sistema preenche o campo de busca automaticamente e dispara a busca em seguida.
O sistema localiza o animal no servidor
O sistema envia o valor digitado (ou selecionado) ao servidor para localizar o animal. Se o animal for localizado com sucesso, o sistema exibe o painel de informações do animal (sequência de cabeça, sexo, manejo e data de abate) e a lista de evidências já registradas para ele. Se o animal não for localizado, o sistema exibe a mensagem “Não foi possível encontrar o sisbov.” e nenhum animal fica selecionado.
Campo de busca é bloqueado
Enquanto o animal permanecer selecionado, o campo de busca fica desabilitado, evitando que o operador troque acidentalmente de animal antes de finalizar o trabalho com o animal atual.
Acionar o botão “Evidências”
Para registrar uma nova evidência, o operador aciona o botão “Evidências”, disponível no rodapé da tela quando um animal está selecionado. O aplicativo abre a câmera do dispositivo automaticamente.
Fotografar a irregularidade
O operador fotografa a irregularidade observada no animal. Se o operador cancelar a câmera sem fotografar, a tela de captura se fecha automaticamente e nenhuma evidência é registrada.
Selecionar local, ocorrência e banda (quando exigida)
Com a foto capturada, o operador seleciona o local de evidência correspondente ao ponto da linha onde a irregularidade foi observada (por exemplo, “3-Vísceras” ou “4-DIF”) e a ocorrência que descreve o problema encontrado (por exemplo, “005-Pneumonia”). Se o local selecionado for DIF, Rast2 ou Balança Abate, o campo de banda também se torna obrigatório e o operador seleciona o lado da carcaça correspondente.
Botão de envio é habilitado
O sistema habilita o botão de envio somente quando todos os campos obrigatórios estiverem preenchidos: local de evidência, ocorrência, foto capturada e, quando exigida pelo local escolhido, a banda. Enquanto algum desses campos estiver faltando, o botão permanece desabilitado, sem exibir nenhuma mensagem de erro.
Enviar a evidência
O operador aciona o envio. Antes de enviar, o sistema comprime a imagem automaticamente (qualidade de 70%, dimensão mínima de 1280×1280 pixels, formato JPEG); se a compressão falhar por algum motivo, o sistema envia a imagem original sem avisar o operador. Em caso de sucesso, o sistema exibe uma mensagem de confirmação de envio e a lista de evidências do animal é atualizada automaticamente com a nova foto. Em caso de falha (erro de negócio ou de rede), o sistema exibe a mensagem literal retornada pelo servidor ou pela falha de conexão.
Finalizar o trabalho com o animal
Ao concluir o registro de todas as evidências necessárias para aquele animal, o operador aciona “Finalizar”, no rodapé da tela. O sistema limpa completamente o estado: o animal é deselecionado, a lista de evidências é zerada, e o campo de busca volta a ficar habilitado e vazio, pronto para que o operador localize o próximo animal.
Descrição de Cada Campo da Tela das Evidências
Campo de busca do animal
Lista de animais do dia
Painel de informações do animal
Local de evidência (na tela de nova evidência)
Ocorrência (na tela de nova evidência)
Banda (na tela de nova evidência)
Foto da evidência
Card de evidência registrada
Utilização e Consulta de Registros das Evidências
Para consultar as evidências já registradas, o operador primeiro localiza o animal — pelo campo de busca (digitando a sequência de abate ou o código de carretilha) ou selecionando-o diretamente na lista de animais do dia. Ao localizar o animal com sucesso, o sistema já exibe automaticamente, junto com o painel de informações, a lista completa de evidências (cards) já registradas para aquele animal — não é necessário nenhum filtro ou busca adicional para ver as evidências existentes.
A lista de animais do dia, por si só, também funciona como uma forma de consulta: ela mostra, para cada animal, a quantidade de imagens de evidência já vinculadas, permitindo ao operador identificar rapidamente, mesmo antes de selecionar o animal, quais já têm evidências registradas e quais ainda não têm.
Não há, na tela de Evidências, filtros de busca adicionais além da localização do próprio animal (por sequência ou carretilha) — ou seja, não é possível filtrar as evidências por local, por ocorrência ou por período diretamente nessa tela. A filtragem dos animais exibidos na lista (pela filial e pela data de abate) é feita automaticamente pelo sistema, com base na sessão ativa do operador, sem que ele precise configurar nada.
Para visualizar uma evidência em detalhe, o operador aciona o menu de contexto do card correspondente e escolhe a opção de visualizar a imagem em tela cheia — essa opção só fica disponível quando a imagem estiver presente no card.
⚠️ Troubleshooting
Se a tela de Evidências abrir exibindo uma mensagem de erro em vez da lista de animais e ocorrências, isso indica falha no carregamento inicial: verifique se a sessão está ativa e se o servidor está acessível, refazendo o login caso a sessão tenha expirado. Se a busca por um animal específico retornar a mensagem “Não foi possível encontrar o sisbov.”, confirme se a sequência ou o código de carretilha foi digitado corretamente e se o animal pertence à data de abate da sessão atual — animais de outra data não aparecem nessa tela enquanto a sessão não for alterada para a data correta.
Processo de Edição das Evidências
ℹ️ Restrição importante
A rotina de Evidências não permite editar os dados de uma evidência já registrada. Depois que uma evidência é salva, não é possível alterar o local, a ocorrência, a banda ou substituir a foto diretamente naquele registro.
Exclusão de evidências
A única alteração possível sobre uma evidência já existente é a exclusão. Para excluir uma evidência, o operador aciona o menu de contexto do card correspondente, dentro da lista de evidências do animal selecionado, e escolhe a opção de excluir. O sistema exibe um diálogo de confirmação antes de remover a imagem, para evitar exclusões acidentais. Após a confirmação, o sistema deleta a evidência e atualiza a lista de evidências do animal com os dados retornados pelo servidor. A exclusão dispara sempre a sincronização com o ERP, independentemente de o animal ter ou não Romaneio de Abate vinculado — diferente do salvamento, que só sincroniza automaticamente quando existe Romaneio de Abate.
Correção de dados incorretos
Se o operador precisar corrigir uma evidência registrada com dados errados (por exemplo, local ou ocorrência incorretos), o caminho é excluir a evidência incorreta e registrar uma nova evidência com os dados corretos, seguindo o processo descrito na seção “Processo de Criação — Passo a Passo das Evidências”.
Histórico e logs
Não há, na documentação de origem, menção a uma tela de histórico ou log de alterações visível ao operador para as evidências — [informação não disponível na documentação de origem — validar com analista responsável].
Tratamento de falhas na exclusão
Sobre condições que impedem a exclusão: se a imagem não for localizada pelo identificador interno no momento da exclusão, ou se o animal vinculado a ela não for localizado, o sistema exibe a mensagem “Não foi possível encontrar o sisbov.” e nenhuma exclusão é realizada. Nesse caso, é recomendável finalizar o trabalho com o animal (botão “Finalizar”) e selecioná-lo novamente para recarregar a lista de evidências antes de tentar excluir de novo.
Estrutura Técnica e Comportamento do Sistema das Evidências
Fluxo de salvamento de evidências
Quando o operador salva uma nova evidência, o sistema primeiro confirma que o animal informado realmente existe. Se não existir, nada é gravado e o sistema informa que não foi possível encontrar o animal. Em seguida, o sistema calcula automaticamente um identificador para a nova imagem, com base no maior identificador já usado entre as imagens existentes daquele animal, somando 1 a esse valor (se ainda não houver nenhuma imagem, o primeiro identificador gerado é o número 1). Depois de gravar a imagem, o sistema verifica se existe Romaneio de Abate vinculado ao animal: se existir, a evidência é enviada automaticamente para o ERP nesse mesmo momento; se não existir, a evidência permanece salva apenas no Manager, sem envio imediato ao ERP.
Fluxo de exclusão de evidências
Quando o operador exclui uma evidência, o sistema também confirma a existência da imagem e do animal vinculado a ela antes de remover o registro. Diferente do salvamento, a exclusão sempre dispara o envio da informação de exclusão ao ERP, independentemente de existir ou não Romaneio de Abate para o animal — ou seja, mesmo evidências que nunca chegaram a ser sincronizadas com o ERP no momento do salvamento ainda geram um aviso de exclusão para o ERP.
Sincronização com o ERP
Ao receber uma evidência enviada pelo Manager, o ERP não usa o mesmo identificador interno do Manager para localizar o animal — ele localiza o animal correto combinando o contrato de origem, a data do abate e a sequência de cabeça enviados junto com a evidência. Se, nesse momento, o animal ainda não tiver chegado (não tiver sido sincronizado) no ERP, a gravação da evidência é temporariamente recusada, com a mensagem “ID do Sisbov não encontrado, pois ainda não foi sincronizado no abate”. Isso não significa que a evidência foi perdida: o mecanismo de envio do sistema tenta automaticamente de novo depois, até que o animal já esteja sincronizado no ERP e a evidência possa, então, ser gravada com sucesso. Antes de gravar, o ERP também busca a ocorrência sanitária informada pelo código enviado, para vinculá-la corretamente à imagem, e gera, do seu próprio lado, um identificador local para a nova imagem, usando o mesmo tipo de cálculo (maior identificador existente mais 1), de forma independente do identificador gerado no Manager.
Tratamento de exclusões no ERP
Ao receber uma exclusão, o ERP localiza a imagem pelo identificador informado; se não conseguir localizá-la, a exclusão é abortada do lado do ERP, com a mensagem “Não foi possível excluir SisBovImagem — SisBovImagem não encontrado”, e nenhum registro é removido nesse caso — mesmo que a imagem já tenha sido excluída normalmente do lado do Manager.
Cálculo da contagem de imagens
Ao listar os animais do dia, o servidor também calcula, para cada animal, quantas imagens de evidência já existem, e envia esse número junto com os dados do animal — é esse número que aparece na lista de animais da tela de Evidências. As imagens em si só são carregadas quando o operador seleciona um animal específico.
Atualização da lista após salvamento
Depois de salvar uma nova evidência, se o servidor devolver a lista de evidências vazia ou nula por qualquer motivo, o sistema mantém a lista anterior que já estava sendo exibida, em vez de limpá-la — evitando que o operador veja a tela momentaneamente sem nenhuma evidência por uma resposta incompleta do servidor. Já na exclusão, a lista de evidências exibida é sempre substituída pelo retorno mais recente do servidor.
Parâmetros da sessão
Por fim, a filial, a data de abate e a configuração de uso de carretilha usadas em todas essas operações são sempre resolvidas pelo próprio servidor, a partir da sessão ativa do operador — o aplicativo não envia esses dados diretamente nas chamadas realizadas para buscar animal, salvar ou excluir evidência.
Regras de Negócio e Restrições das Evidências
Modo de busca do animal conforme a filial
Se a filial usa carretilha, o campo de busca aceita texto alfanumérico e a busca é feita pelo código de carretilha do animal. Se a filial não usa carretilha, o campo aceita apenas números e a busca é feita pela sequência numérica de abate. Em ambos os casos, o valor digitado é convertido para letras maiúsculas antes de ser enviado ao servidor.
Filtro de animais do dia
Somente aparecem na lista de animais os registros cuja filial corresponde à filial da sessão ativa e cuja data de abate corresponde à data da sessão ativa. Animais de outra filial, ou de outra data de abate, não aparecem na lista, mesmo que já estejam cadastrados no sistema.
Status do animal na lista
O status “L” faz o animal aparecer como “Liberado”, exibido em verde. Qualquer outro valor de status faz o animal aparecer como “Bloqueado”, exibido em laranja. Essa exibição é apenas informativa dentro da tela de Evidências e não impede o registro de evidências para o animal.
Obrigatoriedade de banda por local de evidência
Os locais Vivo (1), Rast1 (2) e Vísceras (3) não exigem banda — o campo de banda é enviado como nulo ao servidor nesses casos. Os locais DIF (4), Rast2 (6) e Balança Abate (7) exigem banda; sem preenchê-la, o botão de envio da evidência permanece desabilitado. Não existe local com código 5 nessa lista.
Identificação da ocorrência selecionada
O sistema identifica o código da ocorrência lendo o texto que aparece antes do hífen no formato exibido (“{ID}-{Nome}”). A seleção só é aceita se esse texto puder ser dividido em pelo menos duas partes pelo hífen. Ao comparar o código da ocorrência para exibição no card da evidência, o sistema ignora espaços em branco extras e diferenças entre letras maiúsculas e minúsculas, evitando que pequenas inconsistências no cadastro impeçam a exibição correta da ocorrência.
Compressão da imagem antes do envio
Toda imagem de evidência é comprimida antes de ser enviada ao servidor, com qualidade de 70%, dimensão mínima de 1280×1280 pixels, no formato JPEG. Se essa compressão falhar por qualquer motivo, o sistema envia a imagem original, sem aviso ao operador sobre a ausência de compressão.
Dados enviados ao salvar uma evidência
Ao salvar uma evidência, o sistema envia ao servidor: o identificador do animal no ERP, o identificador do animal no Manager, o código do local de evidência (como tipo de imagem), a banda (nula quando não exigida), a imagem em base64 e o código da ocorrência selecionada.
Dados enviados ao excluir uma evidência
Ao excluir uma evidência, o sistema envia ao servidor apenas o identificador local da imagem a ser excluída — nenhum outro dado do animal ou da evidência é necessário para a exclusão.
Sincronização diferenciada com o ERP
Ao salvar uma evidência, a sincronização automática com o ERP só ocorre se existir Romaneio de Abate vinculado ao animal. Ao excluir uma evidência, a sincronização com o ERP ocorre sempre, independentemente de existir ou não Romaneio de Abate.
Geração do identificador local da imagem
O identificador local de uma nova imagem de evidência é calculado como o maior identificador já usado entre as imagens existentes, mais 1. Se ainda não existir nenhuma imagem para o animal, o primeiro identificador gerado é o número 1. Esse cálculo é feito de forma independente tanto no Manager quanto no ERP.
Atualização da lista de evidências após operações
Depois de salvar uma evidência, a lista exibida é substituída pelos dados retornados pelo servidor; se o servidor retornar a lista vazia ou nula, o sistema mantém a lista anterior, sem limpar a tela. Depois de excluir uma evidência, a lista exibida é sempre substituída pelos dados mais recentes retornados pelo servidor.
Finalização do trabalho com o animal
Ao acionar “Finalizar”, o sistema limpa completamente o estado da tela: a lista de evidências é zerada, o animal fica deselecionado, qualquer mensagem exibida é limpa, e o campo de busca volta a ficar vazio e habilitado para a próxima consulta.
Tratamento de falhas simultâneas na abertura da tela
Se, ao abrir a tela de Evidências, tanto o carregamento da lista de animais quanto o carregamento da lista de ocorrências falharem ao mesmo tempo, o sistema exibe apenas a mensagem referente ao primeiro erro ocorrido; a mensagem do segundo erro é descartada e não é exibida ao operador.
Parâmetros de sessão resolvidos pelo servidor
A filial, a data de abate e a configuração de uso de carretilha usadas nas buscas e nos registros de evidência são sempre determinadas pelo servidor, com base na sessão ativa do operador — o aplicativo nunca envia esses três dados diretamente nas chamadas de busca, salvamento ou exclusão de evidência.
Sincronização pendente quando o animal ainda não chegou ao ERP
Se o ERP ainda não tiver recebido a sincronização do animal no momento em que a evidência é enviada, a gravação da evidência é temporariamente recusada, com a mensagem informando que o ID do Sisbov ainda não foi sincronizado no abate. Isso não representa perda da evidência: o mecanismo de envio tenta automaticamente de novo depois, até que o animal esteja sincronizado no ERP.
Exclusão recusada no ERP quando a imagem não é localizada
Se, no momento de processar uma exclusão, o ERP não localizar a imagem pelo identificador recebido, a exclusão é abortada do lado do ERP e nenhum registro é removido ali, mesmo que a exclusão já tenha sido concluída normalmente do lado do Manager.
Documentação técnica gerada automaticamente | Plataforma IA-ATAK