Condenação de Carcaça
Condenação de Carcaça — Abate (FrigosoftColetor)
A funcionalidade de Condenação de Carcaça permite que o operador registre a saída de meia carcaça do estoque por motivo de condenação sanitária, utilizando leitura de código de barras.
Visão Geral
A funcionalidade de Condenação de Carcaça permite que o operador registre a saída de meia carcaça do estoque por motivo de condenação sanitária, utilizando leitura de código de barras. Também é possível desfazer uma condenação registrada anteriormente por meio da operação de exclusão. O sistema gera e mantém automaticamente os documentos de saída correspondentes no ERP, agrupando as condenações do dia por tipo de animal, filial e data.
Pré-requisitos
- Para condenar ou excluir uma condenação de carcaça, o operador deve estar autenticado no aplicativo com filial e data de trabalho definidas.
- O volume a ser condenado deve existir no sistema e estar com status Em Estoque (para meia carcaça) ou Cancelado (para volumes associados que não são meia carcaça).
- A meia carcaça deve possuir SISBOV cadastrado (valor diferente de zero) e o campo de identificação da meia carcaça deve estar preenchido com exatamente 12 caracteres.
- O documento de saída de condenação do dia não pode estar com situação contábil encerrada (status contábil igual a “Sim”) — caso contrário, a operação é bloqueada.
- Para desfazer uma condenação (exclusão), a meia carcaça deve estar com status Baixado e o documento correspondente não pode estar encerrado contabilmente.
Fluxo Operacional
Fluxo de Condenação de Carcaça
- O operador acessa a tela de Condenação de Carcaça. O sistema carrega automaticamente os documentos do dia para a filial e data logadas, sem necessidade de ação do operador.
- Por padrão, a ação selecionada é Condenar. O operador pode alternar para Excluir pelo botão de rádio na tela, se necessário.
- O operador posiciona o leitor de código de barras sobre o volume da carcaça. Ao capturar um código com exatamente 12 caracteres, o processamento é iniciado automaticamente.
- O sistema emite um bipe de leitura, bloqueia o campo de entrada para evitar leituras simultâneas e exibe um indicador de carregamento.
- O servidor valida o volume, localiza a meia carcaça associada, cria ou reutiliza o documento de saída do dia e registra o romaneio de condenação.
- Ao concluir com sucesso, o sistema emite um bipe de confirmação, exibe a mensagem “Carcaça condenada com sucesso”, limpa o campo de entrada, recarrega a lista de documentos e exibe no painel de última leitura os dados da meia carcaça condenada.
- Em caso de erro, o sistema emite um bipe de erro e exibe um diálogo com o texto exato retornado pelo servidor.
Exclusão de Condenação de Carcaça
- Para desfazer uma condenação de carcaça, o operador seleciona a ação Excluir pelo botão de rádio.
- O operador lê o código de barras do volume (pode ser a meia carcaça ou um volume associado — o sistema localiza automaticamente a meia carcaça pelo campo de vínculo).
- O sistema valida que a meia carcaça está com status Baixado e que o documento não está encerrado contabilmente.
- O romaneio é removido, o status da meia carcaça é revertido para Em Estoque e os volumes associados retornam ao status Cancelado.
- Ao concluir com sucesso, o sistema emite bipe de confirmação, exibe a mensagem “Exclusão da condenação realizada com sucesso”, limpa o campo e recarrega a lista de documentos.
Interface e Comportamentos do App
Na tela de Condenação de Carcaça, o aplicativo apresenta os seguintes comportamentos de interface:
- Seletor de ação: dois botões de rádio — “Condenar” (padrão ao abrir a tela) e “Excluir”. A troca é imediata; o estado é mantido enquanto a tela estiver aberta.
- Campo de volume: aceita entrada manual ou leitura por scanner. O processamento automático é disparado somente quando o valor capturado tiver exatamente 12 caracteres. Valores com comprimento diferente de 12 não disparam o processamento — aguardam acionamento manual ou nova leitura.
- Campo bloqueado durante processamento: enquanto o servidor está sendo consultado, o campo de volume fica desabilitado. Ao concluir (sucesso ou erro), o campo é reabilitado automaticamente.
- Painel de última leitura: exibido somente quando existe resultado de uma operação recente. Apresenta o identificador do volume, o status, o peso bruto e o peso líquido (ambos com 2 casas decimais). Se não houver leitura recente, o painel fica oculto.
- Lista de documentos do dia: exibe os documentos de saída de condenação já registrados para a filial e data logadas. Cada item mostra a chave do documento e sua identificação completa. O duplo clique em um documento abre a tela de itens desse documento.
- Tela de itens do documento: cada item é exibido com número e subnúmero no formato `{número}.{subnúmero}`, lote, produto no formato `{código}-{referência} {nome}`, quantidade primária com unidade e quantidade auxiliar com unidade. Ao expandir o item, são listados os romaneios com sequência, quantidade primária e quantidade auxiliar.
- Estados da lista de documentos:
- Enquanto carrega: exibe `”Carregando quantidades do dia…”`
- Se vazia após o carregamento: exibe `”Nenhuma quantidade do dia encontrada.”`
Leituras de Código de Barras
Para condenar ou excluir uma condenação de carcaça, o código de barras do volume deve ter exatamente 12 caracteres, com a seguinte estrutura:
| Posições | Conteúdo |
|---|---|
| 1 a 3 | Código da filial |
| 4 a 6 | Série do volume |
| 7 a 12 | Número do volume (6 dígitos) |
O processamento automático ocorre somente quando o valor lido tiver exatamente 12 caracteres e o campo não estiver vazio. Valores com comprimento diferente não disparam o fluxo automaticamente.
Feedbacks ao Operador
A tabela abaixo lista os feedbacks sonoros e textuais que o aplicativo exibe ao operador durante a condenação e a exclusão de condenação de carcaça.
| Situação | Feedback | Texto exato |
|---|---|---|
| Leitura capturada (processamento iniciado) | Bipe sonoro de leitura | — (som, sem texto) |
| Condenação registrada com sucesso | Bipe de confirmação + toast | `”Carcaça condenada com sucesso”` |
| Exclusão de condenação realizada com sucesso | Bipe de confirmação + toast | `”Exclusão da condenação realizada com sucesso”` |
| Erro retornado pelo servidor | Bipe de erro + diálogo | Texto literal retornado pelo servidor (varia conforme o erro — veja Troubleshooting) |
| Lista de documentos vazia | Mensagem na tela | `”Nenhuma quantidade do dia encontrada.”` |
| Lista de documentos carregando | Mensagem na tela | `”Carregando quantidades do dia…”` |
| Campo de volume vazio ao acionar manualmente | Bloqueio da operação + mensagem | `”Informe um volume válido”` |
| Volume com comprimento diferente de 12 caracteres informado manualmente | Bloqueio da operação + mensagem | `”Volume inválido”` |
Regras de Negócio
Regras da tela de Condenação de Carcaça
Ação padrão ao abrir a tela Ao abrir a tela de Condenação de Carcaça, a ação selecionada é sempre Condenar. O operador pode alternar para Excluir a qualquer momento pelo botão de rádio. O estado persiste enquanto a tela estiver aberta.
Carregamento automático dos documentos Ao abrir a tela, o sistema carrega automaticamente a lista de documentos do dia para a filial e data logadas, sem necessidade de ação do operador.
Validação do campo de volume (entrada manual) Se o campo de volume estiver vazio ao acionar o processamento manualmente: o sistema bloqueia a operação e exibe `”Informe um volume válido”`. Se o campo estiver preenchido com comprimento diferente de 12 caracteres: o sistema bloqueia a operação e exibe `”Volume inválido”`.
Processamento automático por scanner Quando o scanner emite um valor com exatamente 12 caracteres e o campo não está vazio, o processamento é iniciado automaticamente. Valores com outro comprimento não disparam o processamento automático — aguardam nova leitura ou acionamento manual.
Bloqueio do campo durante processamento Durante o processamento (condenação ou exclusão), o campo de volume é desabilitado para evitar leituras simultâneas. Ao concluir — com sucesso ou erro — o campo é reabilitado automaticamente.
Feedback da operação de Condenar Se a condenação for concluída com sucesso (a meia carcaça condenada é retornada pelo servidor): o sistema emite bipe de confirmação, exibe toast `”Carcaça condenada com sucesso”`, limpa o campo de volume e recarrega a lista de documentos. Se a operação não retornar resultado algum: nenhum feedback é exibido ao operador e a lista de documentos não é recarregada.
Feedback da operação de Excluir Se a exclusão for concluída com sucesso (a meia carcaça é retornada pelo servidor): o sistema emite bipe de confirmação, exibe toast `”Exclusão da condenação realizada com sucesso”`, limpa o campo de volume e recarrega a lista de documentos. Se a operação não retornar resultado algum: nenhum feedback é exibido ao operador e a lista de documentos não é recarregada.
Tratamento de erro do servidor Se ocorrer um erro no processamento pelo servidor: o sistema emite bipe de erro e exibe um diálogo com o texto exato da mensagem de erro retornada.
Limpeza e recarga após operação bem-sucedida Após cada operação de condenação ou exclusão concluída com sucesso, o campo de volume é limpo automaticamente e a lista de documentos é recarregada.
Painel de última leitura O painel de última leitura é exibido somente quando existe resultado de uma operação recente. Exibe identificador do volume, status, peso bruto e peso líquido com 2 casas decimais. Quando não há leitura recente, o painel fica oculto.
Navegação para itens do documento O duplo clique em um item da lista de documentos do dia navega para a tela de itens desse documento.
Formato de exibição dos itens do documento Cada item exibe: número e subnúmero no formato `{número}.{subnúmero}`, lote, produto no formato `{código}-{referência} {nome}`, quantidade primária com unidade, quantidade auxiliar com unidade. Ao expandir, exibe romaneios com sequência, quantidade primária e quantidade auxiliar.
Estado da lista de documentos Enquanto a lista carrega: exibe `”Carregando quantidades do dia…”`. Se a lista estiver vazia após o carregamento: exibe `”Nenhuma quantidade do dia encontrada.”`.
Regras de validação e processamento da condenação de carcaça no servidor
Validação do código no servidor Ao processar a condenação, se o código do volume estiver vazio ou tiver comprimento diferente de 12 caracteres, a operação é interrompida e é exibida mensagem de erro indicando código inválido (ver T-03).
Localização do volume Se o volume não for localizado no sistema a partir da filial, série e número informados no código de barras, é exibida mensagem de erro indicando volume não encontrado (ver T-04).
Validação da carcaça para condenação O campo de identificação da meia carcaça deve ter exatamente 12 caracteres e estar preenchido. O SISBOV do volume deve ser diferente de zero. Se qualquer um desses critérios falhar, o volume é considerado inválido e a operação é rejeitada (ver T-05).
Tipo do volume e status esperado Se o volume lido for identificado como meia carcaça: seu status deve ser Em Estoque para a condenação ser aceita. Se o volume lido não for meia carcaça: seu status deve ser Cancelado para a condenação ser aceita. Em qualquer caso de status incompatível com o esperado, a operação é rejeitada com mensagem de erro (ver T-06).
Localização da meia carcaça associada Para processar a condenação, o sistema localiza a meia carcaça vinculada ao volume lido. Essa meia carcaça vinculada deve estar com status Em Estoque. Se não for encontrada ou estiver com status diferente, a operação é rejeitada (ver T-07).
Documento de saída de condenação O documento de saída é criado ou reutilizado conforme tipo de animal, filial e data. O perfil de movimento utilizado é o `ABT0120` — perfil de saída por condenação sanitária —, obrigatoriamente configurado como tipo Saída no ERP. Se o tipo de movimento estiver configurado de outra forma, a operação é rejeitada.
Série do documento A série do documento é composta por `C` + código do tipo de animal + um dígito numérico (ex.: `CB1` para bovino), sempre com exatamente 3 caracteres. Se não existir série ativa para a combinação, uma nova é criada automaticamente com sufixo `1`. Quando há mais de uma série ativa para a mesma combinação, a mais recente é utilizada.
Número do documento O número do documento é a data de trabalho no formato `DDMMAA`. Exemplo: data 22/06/2026 → número `220626`.
Reuso e bloqueio de documento existente Se já existir um documento para a mesma filial, tipo de documento, série e data: ele é reutilizado. Se esse documento já estiver com status contábil encerrado (igual a “Sim”): a operação é rejeitada, pois o documento já foi atualizado e não pode ser utilizado (ver T-08).
Localização ou criação de item no documento O item do documento é localizado pelo produto, código de referência, local de estoque e lote da meia carcaça. Se não existir item correspondente, um novo é criado automaticamente.
Atualização de status na condenação Após registrar o romaneio, o status da meia carcaça é alterado para Baixado. Os demais volumes vinculados à mesma meia carcaça (aqueles sem identificação própria de meia carcaça) também têm seu status alterado para Baixado.
Erro durante o processamento Se ocorrer um erro durante o processamento da condenação, nenhuma alteração é aplicada: nem o romaneio, nem a mudança de status da meia carcaça e dos volumes associados são gravados.
Regras de validação e reversão na exclusão de condenação de carcaça
Localização da meia carcaça na exclusão Na exclusão de uma condenação de carcaça, se o volume lido não for meia carcaça, o sistema localiza automaticamente a meia carcaça vinculada pelo campo de vínculo antes de prosseguir.
Validação do documento na exclusão O documento que contém o romaneio do volume deve existir; se não for encontrado, é exibida mensagem de erro indicando que o volume não foi localizado no romaneio (ver T-10). Se o documento estiver com status contábil encerrado, a exclusão é bloqueada com a mesma mensagem de documento já atualizado (ver T-08).
Status da meia carcaça na exclusão Na exclusão, a meia carcaça deve estar com status Baixado. Se estiver em outro status, a operação é rejeitada (ver T-09).
Reversão de status na exclusão Na exclusão, o romaneio é removido do item do documento. O status da meia carcaça é revertido para Em Estoque. Os volumes associados têm seu status alterado para Cancelado.
Erro durante a exclusão Se ocorrer um erro durante o processamento da exclusão, nenhuma alteração é aplicada: nem a remoção do romaneio, nem a reversão dos status da meia carcaça e dos volumes associados.
Troubleshooting
Tentativa de condenação com campo de volume vazio
Mensagem exibida: `”Informe um volume válido”`
O que fazer: Preencher o campo com o código de barras do volume ou realizar nova leitura com o scanner.
Volume informado com comprimento diferente de 12 caracteres
Mensagem exibida: `”Volume inválido”`
O que fazer: Verificar se o código de barras está sendo lido corretamente. O código deve ter exatamente 12 caracteres (3 filial + 3 série + 6 número).
Código do volume inválido — validação do servidor (vazio ou comprimento errado)
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (varia conforme a validação que falhou)
O que fazer: Confirmar que o código de barras do volume está correto e com 12 caracteres. Verificar o volume no ERP.
Volume não encontrado no banco de dados
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (volume não encontrado)
O que fazer: Verificar se o volume foi cadastrado corretamente no ERP para a filial, série e número identificados no código de barras.
Volume inválido para condenação — campo de meia carcaça incompleto ou SISBOV zerado
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (volume inválido para operação)
O que fazer: Verificar no ERP se o campo de identificação da meia carcaça está preenchido com 12 caracteres e se o SISBOV do animal está cadastrado.
Status do volume incompatível com a operação
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (status inválido para operação)
O que fazer: Verificar o status atual do volume no ERP. A meia carcaça deve estar com status “Em Estoque” para ser condenada. Se já estiver baixada, pode ter sido condenada anteriormente. Volumes associados devem estar com status “Cancelado”.
Meia carcaça vinculada não encontrada ou com status diferente de “Em Estoque”
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (meia carcaça associada não disponível)
O que fazer: Verificar no ERP o vínculo entre o volume lido e a meia carcaça. Confirmar o status da meia carcaça associada.
Documento de condenação do dia já encerrado contabilmente
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (documento já foi atualizado e não pode ser utilizado)
O que fazer: O documento de saída do dia já foi fechado contabilmente. Entrar em contato com o setor responsável pelo fechamento contábil para avaliar a reabertura do documento ou registrar a condenação por outro meio.
Tentativa de exclusão com meia carcaça em status diferente de “Baixado”
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (status inválido para exclusão)
O que fazer: Verificar o status atual da meia carcaça no ERP. A exclusão somente é permitida para volumes com status “Baixado” (que foram condenados anteriormente).
Tentativa de exclusão e volume não encontrado no romaneio
Mensagem exibida: Nenhuma — Diálogo exibindo texto de erro retornado pelo servidor (volume não encontrado no romaneio)
O que fazer: Verificar se o volume foi de fato condenado anteriormente. Pesquisar o romaneio do documento de saída de condenação no ERP.
Casos de Uso
Caso 1 — Condenação de meia carcaça pelo scanner
Para condenar uma carcaça, o inspetor aponta o leitor de código de barras para a etiqueta da meia carcaça (12 dígitos). O sistema inicia automaticamente o processamento, registra a saída de condenação no ERP e exibe os dados da carcaça no painel de última leitura com a confirmação sonora e visual.
Caso 2 — Condenação de volume associado (não meia carcaça)
Na condenação de carcaça, o operador lê o código de barras de um volume associado à meia carcaça (ex.: quarto traseiro). O sistema identifica que o volume não é meia carcaça e localiza automaticamente a meia carcaça vinculada para executar a condenação.
Caso 3 — Desfazer uma condenação registrada no mesmo dia
O operador percebe que condenou um volume por engano. Seleciona a ação Excluir, lê novamente o código do volume (meia carcaça ou volume associado) e o sistema remove o romaneio, revertendo os status para os valores anteriores à condenação.
Caso 4 — Consultar documentos de condenação do dia
O supervisor acessa a tela e visualiza na lista de documentos do dia todos os registros de saída por condenação. Ao dar duplo clique em um documento, visualiza os itens e romaneios com as quantidades e pesos registrados.
Caso 5 — Tentativa de condenação com documento já encerrado
O operador tenta condenar uma carcaça após o fechamento contábil do dia. O sistema retorna erro informando que o documento já foi atualizado e não pode ser utilizado. O operador aciona o setor de contabilidade para tratar o caso.