Endereçamento de Carcaças
Endereçamento de Carcaças — Abate (FrigosoftColetor)
O Endereçamento de Carcaças é a etapa que ocorre após o abate e o registro de rastreamento, destinando cada carcaça para uma câmara de resfriamento específica dentro do frigorífico.
Visão Geral
O Endereçamento de Carcaças é a etapa que ocorre após o abate e o registro de rastreamento, destinando cada carcaça para uma câmara de resfriamento específica dentro do frigorífico. O operador informa o código da carcaça (via bipagem ou digitação) e seleciona a câmara de destino — o sistema valida a capacidade da câmara, o mercado compatível e, opcionalmente, exige o número do trilho quando a câmara opera com endereçamento completo.
Após esta etapa, a localização da carcaça fica registrada e é enviada ao ERP, possibilitando rastrear o paradeiro de cada carcaça desde o abate até o início da desossa ou expedição.
Antes desta etapa: rastreamento e pesagem de carcaça.
Após esta etapa: carcaças ficam disponíveis para consulta por câmara, podendo ser movidas ou ter a câmara zerada pelo supervisor.
Pré-requisitos
- Sessão ativa no Manager com parâmetros da filial carregados. Se a sessão não estiver ativa, qualquer operação retorna um erro de sessão encerrada e a tela principal de login é exibida.
- Câmaras de estocagem cadastradas no ERP para a filial do operador. Se não houver câmaras cadastradas, a lista é carregada vazia e nenhuma câmara pode ser selecionada.
- Carcaças (volumes) já registradas no sistema. O endereçamento opera sobre carcaças já pesadas e identificadas. Se o código informado não existir, o sistema rejeita a operação com mensagem específica.
- Data logada na sessão compatível com a data de abate das carcaças. A busca por sequência de cabeça filtra pelo dia da sessão — carcaças de outras datas não são encontradas por sequência.
Fluxo Operacional
Fluxo principal — endereçamento de carcaça em câmara
- O operador abre a tela de Endereçamento de Carcaças. A lista de câmaras disponíveis é carregada automaticamente.
- O operador toca em uma câmara da lista para selecioná-la. O sistema exibe a confirmação: “Deseja selecionar {código}?” — ao confirmar, a câmara fica destacada em azul.
- O operador informa o código da carcaça no campo “Informe o volume ou a sequência” — via teclado ou bipagem do código de barras.
- (Opcional) Se a câmara exigir trilho (configuração da filial), o operador preenche o número do trilho no campo correspondente.
- Ao bipar ou pressionar confirmar, o sistema valida e endereça a carcaça na câmara.
- Se aceito: o app exibe o toast “Volume incluído com sucesso” e limpa o campo de leitura para a próxima bipagem.
- O operador repete os passos 3–6 para cada carcaça, mantendo a câmara selecionada.
Fluxo alternativo — remoção de carcaça de câmara
- Na tela de Endereçamento de Carcaças, o operador toca no ícone de lixeira da câmara desejada. O sistema exibe “Deseja selecionar {código} para remoção?” — ao confirmar, a câmara fica destacada em âmbar.
- O operador bipa o código da carcaça a remover.
- Se aceito: o app exibe o toast “Volume deletado” e limpa o campo de leitura.
Fluxo de zeragem de câmara pelo Resumo do Endereçamento
- O operador toca no ícone de livro no canto superior direito para acessar o Resumo do Endereçamento.
- Na tela de resumo, toca no ícone de lixeira da câmara a zerar.
- O sistema exibe “Remover todos volumes da Câmara {código}?”. Ao confirmar: todos os volumes da câmara são zerados no sistema e a lista é atualizada.
Interface e Comportamentos do App
Tela principal de Endereçamento de Carcaças
- Campo de leitura: aceita código de volume ou número de sequência. A bipagem dispara automaticamente a inclusão da carcaça na câmara selecionada — não é necessário pressionar botão de confirmação.
- Campo de trilho: aparece somente quando a câmara exige, conforme a configuração da filial (ver Regras de Negócio — Endereçamento completo vs. endereçamento simples).
- Checkbox “Fixar”: quando marcado, o número do trilho permanece preenchido após cada bipagem bem-sucedida — útil para endereçar sequências de carcaças destinadas ao mesmo trilho. Quando desmarcado (padrão), o campo de trilho é limpo após cada bipagem.
- Checkbox “Permitir volumes já endereçados”: quando marcado, permite reendereçar carcaças que já têm câmara atribuída. Quando desmarcado (padrão), o sistema rejeita carcaças que já possuem endereço.
- Lista de câmaras: exibe todas as câmaras da filial com código, descrição, quantidade estocada e capacidade. A câmara selecionada fica destacada com cor correspondente ao modo (azul para endereçar, âmbar para remover).
- Ícone de lixeira em cada câmara: toque seleciona a câmara para o modo remoção. Quando no modo remoção para aquela câmara, o ícone fica vermelho.
Comportamento da tela de Endereçamento de Carcaças após operação
- Endereçamento bem-sucedido: toast “Volume incluído com sucesso” + campo de leitura limpo + campo de trilho limpo (se “Fixar” estiver desmarcado).
- Remoção bem-sucedida: toast “Volume deletado” + campo de leitura limpo.
- Em ambos os casos, a lista de câmaras é recarregada para refletir os saldos atualizados.
Tela de Resumo do Endereçamento de Carcaças
- Exibe a mesma lista de câmaras com código, descrição, quantidade estocada e capacidade.
- Ao abrir o resumo: todas as seleções da tela principal são limpas (câmara desmarcada, modo remoção desativado, “Permitir já endereçados” desmarcado).
- Cada câmara tem um ícone de lixeira que permite zerar todos os volumes daquela câmara.
Leituras de Código de Barras
No Endereçamento de Carcaças, o sistema aceita dois formatos de identificação da carcaça no campo de leitura:
Formato 1 — sequência de cabeça da carcaça (menos de 12 dígitos)
- O aplicativo interpreta a leitura como o número de sequência do animal no abate do dia.
- O sistema busca o animal pela sequência + filial + data de abate igual à data logada na sessão.
- A partir do animal encontrado, localiza o volume (carcaça) associado.
Formato 2 — código completo do volume da carcaça (12 ou mais dígitos)
- Os 3 primeiros dígitos identificam a filial.
- Os 3 dígitos seguintes identificam a série do volume.
- Os dígitos restantes formam o número do volume (deve ser inteiro).
Leitura inválida (não numérica): a leitura falha imediatamente, sem chegar a ser enviada ao servidor (ver Troubleshooting).
Feedbacks ao Operador
| Situação | Feedback | Texto exato |
|---|---|---|
| Volume endereçado com sucesso | Toast longo | “Volume incluído com sucesso” |
| Volume removido de câmara com sucesso | Toast longo | “Volume deletado” |
| Código da câmara selecionada tem menos de 3 caracteres ou contém espaço | Toast curto | “A câmara selecionada é inválida, favor selecionar uma câmara cujo código tenha tamanho igual a 3” |
| Campo de trilho vazio quando endereçamento completo ativo (ao endereçar) | Mensagem de validação no campo | “Informe o trilho” |
| Sessão no Manager encerrada por tempo | Diálogo modal OK | “Sessão Frigosoft finalizada” |
| Erro retornado pelo servidor no endereçamento | Diálogo modal OK | Mensagem específica do servidor (ver Troubleshooting) |
| Erro retornado pelo servidor na remoção | Diálogo modal OK | Mensagem específica do servidor (ver Troubleshooting) |
| Erro retornado pelo servidor na zeragem | Diálogo modal OK | Texto do erro retornado pelo servidor |
| Confirmação de seleção de câmara para endereçar | Diálogo de confirmação | “Deseja selecionar {código}?” |
| Confirmação de seleção de câmara para remoção | Diálogo de confirmação | “Deseja selecionar {código} para remoção?” |
| Confirmação de zeragem de câmara | Diálogo de confirmação | “Remover todos volumes da Câmara {código}?” |
Regras de Negócio
No Endereçamento de Carcaças, as regras a seguir definem as condições e os parâmetros que orientam o endereçamento, a remoção e a zeragem de câmara.
Validação do código da câmara antes de confirmar a operação
Antes de confirmar qualquer bipagem, remoção ou zeragem, o aplicativo confere que o código da câmara selecionada tem pelo menos 3 caracteres e não contém espaços. Sem uma câmara selecionada (código vazio) ou com uma câmara cadastrada fora desse padrão no ERP, a operação é bloqueada com a mensagem “A câmara selecionada é inválida, favor selecionar uma câmara cujo código tenha tamanho igual a 3” (ver T-01).
Reendereçamento de carcaça para outra câmara
Quando uma carcaça é endereçada para uma câmara diferente da atual (com a opção “Permitir volumes já endereçados” marcada), o sistema decrementa automaticamente o saldo da câmara anterior. O estoque nunca fica negativo — o mínimo é zero.
Repetir o endereçamento para a mesma câmara e trilho
Se a carcaça já estiver endereçada exatamente na câmara e no trilho informados, uma nova tentativa de endereçá-la para o mesmo destino não altera nada — nem o saldo da câmara, nem a comunicação com o ERP.
Endereçamento completo vs. endereçamento simples
Quando o parâmetro de endereçamento completo da filial está configurado como “S”, o campo de trilho é exibido e é obrigatório para endereçar (não para remover). No modo simples (qualquer outro valor), o trilho não é solicitado.
Capacidade máxima da câmara de estocagem
A câmara só aceita novas carcaças enquanto a quantidade estocada for menor que a capacidade cadastrada. Quando a câmara atinge o limite, novas operações de endereçamento são bloqueadas (ver T-11).
Validação de mercado compatível com a câmara
Câmaras podem ter uma lista de mercados aceitos, cadastrada no ERP. O mercado principal da carcaça precisa estar nessa lista. Câmaras sem lista de mercados cadastrada aceitam carcaças de qualquer mercado.
Zeragem de saldo da câmara pelo Resumo
A zeragem pelo Resumo do Endereçamento zera apenas o contador de saldo da câmara — as localizações das carcaças individuais continuam gravadas. Depois de uma zeragem, as carcaças ainda aparecem com endereço registrado, mas o saldo da câmara é exibido como zero.
Envio ao ERP após cada operação
O resultado de cada endereçamento, remoção ou zeragem é enviado ao ERP em segundo plano, depois que a operação já foi confirmada no coletor. O aplicativo não informa ao operador se esse envio teve sucesso ou falhou — por isso, uma falha na comunicação com o ERP não aparece na tela (ver T-14).
Troubleshooting
Operador bipa carcaça sem ter selecionado uma câmara (câmara selecionada vazia)
Mensagem exibida: “A câmara selecionada é inválida, favor selecionar uma câmara cujo código tenha tamanho igual a 3”
O que fazer: Selecionar uma câmara da lista antes de bipar a carcaça.
Campo de trilho vazio ao tentar endereçar com câmara de endereçamento completo
Mensagem exibida: “Informe o trilho” (mensagem de validação no campo)
O que fazer: Preencher o número do trilho antes de confirmar.
Código da câmara informado não é encontrado no servidor
Mensagem exibida: “A camara não foi encontrada.”
O que fazer: Verificar se a câmara está cadastrada no ERP para a filial do operador. Recarregar a lista de câmaras ou reiniciar a sessão.
Sequência de cabeça informada não encontrada na data do abate
Mensagem exibida: “Não foi possível encontrar o sisbov pelo codigo da carretilha nem pela sequência do abate.”
O que fazer: Verificar se a carcaça foi registrada no rastreamento para a data logada. Se a data da sessão estiver incorreta, reiniciar a sessão com a data correta.
Volume não encontrado pelo sisbov da sequência
Mensagem exibida: “Não foi possível encontrar volumes do sisbov informado.”
O que fazer: Verificar se o volume da carcaça foi gerado corretamente no rastreamento. Contatar suporte se o animal está registrado mas sem volume associado.
Código completo informado não localiza o volume no sistema
Mensagem exibida: “Não foi possível encontrar o volume com filial = ‘{filial}’, serie = ‘{serie}’, numero = ‘{numero}'”
O que fazer: Verificar se o código lido está correto e se o volume existe no sistema para aquela filial e série. Testar com a sequência de cabeça se disponível.
Código completo da carcaça informado com número de volume não numérico
Mensagem exibida: “Valor informado não corresponde com o padrão esperado para volume, o numero do volume precisa ser somente numeros.”
O que fazer: Verificar se o código de barras lido está correto. A parte numérica do código completo deve conter apenas dígitos.
Campo de leitura vazio ou com formato totalmente inválido
Mensagem exibida: “Valor informado não corresponde com o padrão esperado para volume.”
O que fazer: Garantir que o campo está preenchido com um valor numérico.
Carcaça já está endereçada e opção “Permitir já endereçados” está desmarcada
Mensagem exibida: “Volume informado já está endereçado, e não está permitido processar volumes já endereçados.”
O que fazer: Marcar a opção “Permitir volumes já endereçados” para reendereçar a carcaça, ou verificar se o código lido é o correto.
Câmara de destino não aceita o mercado da carcaça
Mensagem exibida: “A camara de estocagem não aceita o mercado principal do volume.”
O que fazer: Selecionar uma câmara compatível com o mercado da carcaça, ou verificar o cadastro de mercados da câmara no ERP.
Câmara de destino está com capacidade máxima atingida
Mensagem exibida: “Valor informado não corresponde com o padrão esperado para volume, o numero do volume precisa ser somente numeros.”
O que fazer: A câmara está cheia. Selecionar outra câmara com capacidade disponível. (Nota: a mensagem exibida não descreve corretamente a causa — trata-se de câmara lotada, não de erro de formato.)
Operador tenta remover carcaça que não tem câmara atribuída
Mensagem exibida: “Volume informado não está endereçado.”
O que fazer: Verificar se o código lido é o correto. A carcaça não possui endereço registrado no sistema.
Câmara selecionada para remoção não corresponde à câmara onde a carcaça está
Mensagem exibida: “Volume não endereçado na camara selecionada, camara que o volume está volume = ‘{código da câmara real}'”
O que fazer: Selecionar a câmara correta (indicada na mensagem) e repetir a operação de remoção.
Romaneio de abate não encontrado para a carcaça
Mensagem exibida: “Não foi encontrado romaneio de abate para esses volumes, para realizar o sincronismo dos volumes.”
O que fazer: Contatar suporte. A gravação local foi realizada, mas o envio ao ERP não poderá ser feito automaticamente. O dado estará no Manager, mas pode não chegar ao ERP.
Sessão do Manager expirou durante a operação
Mensagem exibida: “Sessão Frigosoft finalizada”
O que fazer: Confirmar o diálogo — o app retorna à tela de login do Manager. Fazer login novamente e repetir a operação.
Casos de Uso
Caso 1 — Endereçamento sequencial de carcaças na câmara 001
O operador seleciona a câmara “001” na lista (capacidade 50, estocado 12). Bipa a sequência de cabeça “0042” — o sistema localiza o animal pelo número 42 no abate do dia, encontra o volume correspondente, valida mercado e capacidade, e endereça a carcaça para a câmara 001. Toast “Volume incluído com sucesso”. O operador bipa a sequência “0043” na sequência e repete até a fila da câmara estar completa.
Caso 2 — Reendereçamento de carcaça com “Permitir volumes já endereçados”
O operador percebe que a carcaça 120458001001 foi endereçada para a câmara “002” por engano. Marca a opção “Permitir volumes já endereçados”, seleciona a câmara “001” e bipa o código completo da carcaça. O sistema decrementa o saldo da câmara 002 e incrementa o saldo da câmara 001. A carcaça passa a ter localização na câmara 001.
Caso 3 — Endereçamento com trilho em câmara de endereçamento completo
A filial opera com endereçamento completo. O operador seleciona a câmara “005” (campo de trilho visível). Preenche o trilho “03” e marca “Fixar”. Bipa as sequências 0100 a 0115 consecutivamente — todas vão para câmara 005, trilho 03, sem precisar redigitar o trilho a cada bipagem.
Caso 4 — Zeragem de câmara após transferência de lote
Supervisor abre o Resumo do Endereçamento. A câmara “003” está com 28 carcaças registradas mas fisicamente já foi esvaziada. O supervisor toca na lixeira da câmara 003, confirma a zeragem. O saldo da câmara 003 é zerado no sistema e o ERP é notificado do novo saldo.