Ocorrências
Ocorrências — Abate (FrigosoftColetor)
A tela de Ocorrências permite ao inspetor registrar as ocorrências sanitárias verificadas em uma carcaça durante o abate.
Visão Geral
A tela de Ocorrências permite ao inspetor registrar as ocorrências sanitárias verificadas em uma carcaça durante o abate. O operador identifica a carcaça pelo número de sequência (ou código de carretilha, dependendo da filial), seleciona o motivo de inspeção e até quatro ocorrências distintas, além da parte afetada. O registro é enviado ao servidor e o coletor é atualizado. Esta etapa ocorre após a carcaça ter passado pela linha de abate e antes de qualquer condenação ou pesagem definitiva — os dados lançados aqui alimentam os processos de inspeção SIF.
Pré-requisitos
Para registrar uma ocorrência, a sessão do coletor e o cadastro no servidor devem atender às seguintes condições:
- O operador deve estar com sessão ativa no coletor, com filial e data de abate configuradas. Sem sessão válida, os parâmetros de produção não são definidos e nenhuma operação é executada.
- As ocorrências (tipos de inspeção, motivos e partes afetadas) devem estar cadastradas e disponíveis no servidor. Se o carregamento falhar, os dropdowns ficam vazios e o operador não consegue selecionar nenhuma opção.
- A carcaça buscada deve existir no servidor, para a filial e data da sessão. Carcaças não encontradas bloqueiam o prosseguimento com mensagem de erro.
Fluxo Operacional
- O operador abre a tela de Ocorrências. O sistema carrega automaticamente a lista de ocorrências do servidor e preenche os dropdowns disponíveis.
- O operador informa o número de sequência da carcaça (digitando ou usando o scanner de código de barras). O sistema busca os dados da carcaça no servidor.
- Se a carcaça for encontrada, o painel de informações é preenchido (manejo, data de abate, sequência, sexo) e os dropdowns são habilitados para seleção.
- O operador seleciona obrigatoriamente o motivo de inspeção e pelo menos uma das quatro ocorrências disponíveis. Opcionalmente, seleciona a parte afetada.
- O operador toca no botão de gravar. O sistema envia os dados ao servidor.
- Após confirmação de sucesso, todos os campos são limpos e o painel de carcaça é resetado, permitindo registrar a próxima ocorrência.
Interface e Comportamentos do App
A tela de Ocorrências possui um campo de sequência para identificação da carcaça, um painel de informações da carcaça (manejo, data de abate, sequência de cabeça, sexo), quatro dropdowns de ocorrência (posições 0, 1, 2 e 3), um dropdown de motivo de inspeção e um dropdown de parte afetada.
Enquanto nenhuma carcaça estiver carregada, todos os dropdowns e o botão de gravar ficam bloqueados visualmente e não respondem a toques — uma sobreposição cobre esses elementos impedindo interação.
Quando uma carcaça é carregada com sucesso, os bloqueios são removidos e o operador pode interagir livremente com os dropdowns.
Todos os dropdowns iniciam sem seleção. As condições para habilitar o botão de gravar estão detalhadas em Regras de Negócio.
O formato de exibição de cada ocorrência nos dropdowns segue o padrão: {id}-{nome} (sem espaços ao redor do hífen).
O campo de sequência aceita apenas números quando a filial não usa código de carretilha. Quando a filial possui configuração de carretilha com valor S, M ou A, o campo aceita texto livre.
O painel de informações da carcaça exibe:
- Manejo: o código de manejo da carcaça.
- Data de Abate: no formato dd/MM/yyyy; se a data não estiver disponível, exibe 00/00/0000.
- Sequência: o número de sequência de cabeça; se não disponível, exibe 000.
- Sexo: exibe M-Macho quando o valor for M; exibe F-Fêmea quando o valor for F; para qualquer outro valor, exibe o próprio valor retornado pelo servidor.
Leituras de Código de Barras
Na tela de Ocorrências, o scanner dispara automaticamente a busca da carcaça ao ler um código de barras, desde que o coletor não esteja em estado de carregamento e o código lido não seja vazio. Nenhuma ação adicional do operador é necessária após a leitura.
O campo de sequência aceita o código lido como texto livre quando a filial opera com carretilha, ou como número quando não opera. Códigos que não correspondam a nenhuma carcaça no servidor resultam em limpeza do painel e exibição de dialog de erro.
Feedbacks ao Operador
| Situação | Feedback | Texto exato |
|---|---|---|
| Envio de ocorrência realizado com sucesso | Toast curto | “Enviado com sucesso” |
| Carcaça não encontrada para a filial e data da sessão | Dialog modal | “Sisbov não encontrado para a filial {0} e data {1}.” |
| Carcaça já processada na pesagem do abate | Dialog modal | “Sisbov já processado na pesagem do abate.” |
| Motivo de inspeção não informado no processamento | Dialog modal | “Não foi possível processar o sisbov, motivo inspeção não informado.” |
| Carcaça não localizada pelo identificador local no processamento | Dialog modal | “Não foi possível encontrar o sisbov.” |
| Erro no envio ou na busca da carcaça (outros erros) | Dialog modal | Nenhuma — a mensagem de erro retornada pelo servidor é exibida |
Regras de Negócio
Bloqueio de registro de ocorrência para carcaça já processada na pesagem do abate
Uma carcaça de ocorrência já processada na pesagem do abate não pode receber novo registro. Ao tentar registrar, a mensagem “Sisbov já processado na pesagem do abate.” é exibida e o registro é bloqueado.
Classificação das ocorrências retornadas pelo servidor nos dropdowns
As ocorrências retornadas pelo servidor para a tela de Ocorrências são classificadas segundo o próprio tipo cadastrado:
- Ocorrências com tipo igual a 9 são destinadas exclusivamente ao dropdown de parte afetada.
- Ocorrências com tipo igual a 5 que possuam o campo de destino preenchido são excluídas de ambas as listas.
- Todas as demais ocorrências (tipo diferente de 9; tipo 5 sem destino; qualquer outro tipo) são destinadas aos quatro dropdowns de ocorrência.
Prevenção de seleção duplicada de ocorrência nos dropdowns
Não é possível selecionar a mesma ocorrência em dois dropdowns de ocorrência diferentes. Se o operador tentar selecionar um valor já selecionado em outro dropdown, a alteração é silenciosamente ignorada e o dropdown retorna ao valor anterior. A limpeza de um dropdown (retorno ao estado sem seleção) é sempre permitida, independentemente dos demais.
Habilitação do botão de gravar ocorrência
O botão de gravar a ocorrência só fica ativo quando ambas as condições forem atendidas simultaneamente:
- O dropdown de motivo de inspeção possui um valor selecionado.
- Pelo menos um dos quatro dropdowns de ocorrência possui um valor selecionado.
Preservação de valores não selecionados ao gravar a ocorrência
Ao gravar uma ocorrência, apenas os dropdowns que o inspetor efetivamente selecionou (ocorrência 1 a 4, parte afetada e motivo de inspeção) são atualizados no registro da carcaça. Campos deixados sem seleção não são alterados — se a carcaça já tinha um valor registrado anteriormente nesses campos, ele permanece.
Limpeza do campo de sequência da carcaça quando submetido vazio
Se o operador submeter o campo de sequência vazio ou nulo, o painel de informações da carcaça e o registro interno da carcaça são limpos sem realizar chamada ao servidor.
Fixação dos parâmetros de produção durante a sessão de ocorrências
Os parâmetros de produção (filial e data de abate) usados no registro de ocorrências são definidos no momento de inicialização da sessão e permanecem fixos durante toda a sessão. Alterações de filial ou data só têm efeito após encerramento e reinicialização da sessão.
Troubleshooting
Carcaça não localizada ao informar a sequência
Cenário: o operador informa a sequência (ou código de carretilha) da carcaça, mas o painel de informações não é preenchido.
Mensagem exibida: “Sisbov não encontrado para a filial {0} e data {1}.”
O que fazer: Verificar se a sequência ou código de carretilha está correto para a data de abate da sessão. Confirmar se o animal foi registrado no sistema antes de tentar lançar a ocorrência. Se o problema persistir, acionar o responsável técnico para verificar o cadastro no servidor.
Registro de ocorrência bloqueado: carcaça já processada na pesagem do abate
Mensagem exibida: “Sisbov já processado na pesagem do abate.”
O que fazer: A carcaça já passou pela etapa de pesagem do abate. O lançamento de ocorrência nesse estágio não é permitido. Acionar o responsável pelo processo para verificar se a ocorrência deve ser registrada por outro meio.
Gravação de ocorrência rejeitada por motivo de inspeção não informado
Mensagem exibida: “Não foi possível processar o sisbov, motivo inspeção não informado.”
O que fazer: Selecionar o motivo de inspeção antes de gravar. O botão de gravar só deveria estar ativo com o motivo preenchido — se o botão estava ativo sem o motivo, reportar ao responsável técnico.
Carcaça não localizada pelo identificador interno ao gravar a ocorrência
Cenário: o servidor não localiza o registro interno da carcaça durante o processamento da ocorrência.
Mensagem exibida: “Não foi possível encontrar o sisbov.”
O que fazer: O registro da carcaça pode ter sido removido do servidor após o carregamento do painel. Recarregar a tela, buscar novamente a carcaça e tentar gravar. Se o erro persistir, acionar o responsável técnico.
Dropdown de ocorrência não aceita seleção duplicada
Cenário: o operador tenta selecionar, em outro dropdown de ocorrência, uma ocorrência já escolhida em outro dropdown.
Mensagem exibida: Nenhuma — o dropdown retorna silenciosamente ao valor anterior.
O que fazer: Selecionar uma ocorrência diferente para o dropdown desejado. Cada ocorrência só pode ser usada uma vez por registro.
Busca de carcaça não é realizada e nenhuma mensagem aparece (filial sem código de carretilha)
Cenário: a filial não opera com código de carretilha e o operador informa uma sequência que não corresponde a um número válido diferente de zero.
Mensagem exibida: Nenhuma — a busca não é realizada e o painel de informações da carcaça permanece vazio, sem alteração.
O que fazer: Informar um número de sequência válido. Se o campo foi preenchido corretamente e o problema persistir, acionar o responsável técnico.
Casos de Uso
Caso 1 — Caminho feliz, carcaça com ocorrência simples
O inspetor abre a tela de Ocorrências. O sistema carrega as opções disponíveis. O inspetor digita a sequência 00142 e confirma. O painel exibe: manejo M0041, data de abate 22/06/2026, sequência 142, sexo M-Macho. O inspetor seleciona o motivo de inspeção e uma ocorrência. Toca em gravar. O sistema exibe o toast “Enviado com sucesso” e limpa todos os campos, pronto para o próximo animal.
Caso 2 — Filial com carretilha, leitura por scanner
A filial opera com código de carretilha (configuração M). O inspetor posiciona o scanner sobre o código de barras da carcaça. O sistema lê o código automaticamente e busca a carcaça. O painel é preenchido com os dados do animal pesando 312 kg. O inspetor seleciona motivo de inspeção, duas ocorrências e a parte afetada. Toca em gravar. Registro enviado com sucesso.
Caso 3 — Tentativa de duplicar ocorrência
O inspetor seleciona a ocorrência 12-Contusão no primeiro dropdown. Em seguida, tenta selecionar 12-Contusão no segundo dropdown. O sistema ignora silenciosamente a tentativa e mantém o segundo dropdown sem seleção. O inspetor então seleciona 07-Abscesso no segundo dropdown sem problemas.
Caso 4 — Carcaça já processada na pesagem
O inspetor informa a sequência 00089. O sistema exibe o dialog com “Sisbov já processado na pesagem do abate.”. O inspetor conclui que o animal já passou pela pesagem e informa o supervisor para verificar se o lançamento da ocorrência deve ocorrer por outro processo.