Condenações

Documentação completa sobre a rotina de Condenações do Coletor FrigoSoft para registro de condenações de partes e carcaças durante o processo de abate.

Usuário autenticado

O operador precisa estar com uma sessão ativa no coletor, com o código de funcionário e o posto de trabalho já configurados no aparelho. Sem isso, o sistema não sabe identificar quem está fazendo o registro nem para qual posto de trabalho as ocorrências devem ser buscadas.

Código SIF da filial cadastrado

A filial à qual o usuário pertence precisa ter o código do SIF cadastrado no sistema central. Se esse código não existir, o sistema bloqueia qualquer novo registro de condenação e exibe a mensagem: "A filial atual não possui código do SIF cadastrado. Verifique o cadastro da filial e tente novamente."

Escala de abate válida

Só aparecem para seleção as escalas que já têm o lote efetivo de produção preenchido e o sexo do lote cadastrado. Escalas sem essas informações simplesmente não são exibidas na lista — não é possível contorná-las.

Produto cadastrado na base local

O produto vinculado à escala precisa existir na base de dados local do servidor (identificado por código e referência). Se o produto da escala não for encontrado nessa base, a escala inteira é filtrada e não aparece na lista de seleção.

Romaneio de abate criado

A escala escolhida precisa já ter o romaneio de abate criado no sistema central. Se não tiver, o sistema impede a seleção e mostra um diálogo de erro avisando que a escala não possui romaneio de abate criado.

Carregamento automático na abertura da tela

Ao entrar na tela, o sistema tenta preparar automaticamente os dados de produção do usuário e, se essa preparação der certo, já traz pré-carregadas as condenações relacionadas a ele. Se essa preparação falhar por algum motivo, o pré-carregamento é simplesmente pulado — sem exibir nenhuma mensagem de erro ao operador. Nesse caso, a tela pode não mostrar de imediato os dados esperados na primeira consulta, sendo necessário selecionar a escala novamente para atualizar as informações.

Dependência de outras rotinas

Essa rotina depende diretamente da existência prévia da escala de abate e do romaneio de abate, que são criados em etapas anteriores do processo (fora desta tela).

Passo 1: Abrir a tela de Condenações

O operador acessa a tela de Condenações no coletor. O sistema carrega e exibe a lista de escalas disponíveis, já ordenada pelo número de lote em ordem crescente.

Passo 2: Localizar a escala desejada

O operador percorre a lista até encontrar a escala correspondente ao lote que deseja trabalhar. Cada item da lista mostra o identificador da escala, o nome do pecuarista, o nome da propriedade rural, o número do lote, o sexo, a data do abate e um indicador colorido (verde ou vermelho) que sinaliza se o romaneio de abate já foi criado.

Passo 3: Selecionar a escala com duplo toque

O operador dá um duplo toque sobre a escala escolhida. Um toque simples não tem nenhum efeito — é necessário o duplo toque para que a seleção seja processada.

Passo 4: Verificação automática de lote

Se a escala selecionada não tiver um lote preenchido, o sistema exibe um aviso rápido na tela (toast) e não avança para os dados da escala.

Passo 5: Verificação automática de romaneio

Se a escala selecionada não tiver o romaneio de abate criado, o sistema exibe um diálogo de erro e também não avança.

Passo 6: Carregamento das condenações da escala

Passando pelas verificações anteriores, o sistema carrega automaticamente todas as condenações já existentes para aquela escala e lote, organizadas por produto e por ocorrência, incluindo ocorrências com quantidade zero.

Passo 7: Visualizar produtos e ocorrências

O operador visualiza a lista de produtos (ordenada pelo código do produto, do menor para o maior) e, dentro de cada produto, as ocorrências de condenação cadastradas para o seu posto de trabalho, cada uma com sua quantidade atual.

Passo 8: Registrar uma nova condenação

Para registrar uma condenação, o operador toca no botão + ao lado da ocorrência correspondente ao produto condenado.

Passo 9: Validações feitas pelo sistema antes de gravar

Antes de efetivar o registro, o sistema confirma, nessa ordem: se os dados enviados estão completos; se a escala ainda existe; se o lote efetivo da escala ainda está preenchido; se a escala não foi cancelada; se o produto está cadastrado; se a ocorrência está cadastrada e é do tipo “Condenação”; se existe vínculo cadastrado entre o posto de trabalho, a ocorrência e o produto; e se a filial do usuário possui código SIF cadastrado. Caso alguma dessas verificações falhe, o sistema exibe a mensagem de erro correspondente e o registro não é criado.

Passo 10: Confirmação do registro

Se todas as verificações passarem, o sistema grava o registro de condenação, atualiza a quantidade da ocorrência na tela e recalcula o totalizador do lote automaticamente.

Passo 11: Envio para o ERP

Depois de gravar o registro no sistema central, o envio para o ERP é agendado para acontecer em segundo plano. O operador já recebe a confirmação da gravação e pode continuar trabalhando sem esperar essa sincronização terminar.

Passo 12: Repetir o processo para outras ocorrências e produtos

O operador repete os passos 8 a 11 para cada nova condenação identificada, podendo alternar entre diferentes produtos e ocorrências dentro da mesma escala.

Passo 13: Trocar de escala, se necessário

Caso o operador precise trabalhar em outra escala, ele toca no botão Limpar, que remove a escala atualmente selecionada e zera todos os dados de condenações exibidos na tela, sem enviar nenhuma informação ao servidor. Em seguida, o operador repete os passos 2 e 3 para selecionar a nova escala.

Identificador da escala (item da lista de escalas)

Tipo: Informativo (texto composto, somente leitura)

Obrigatoriedade: Não aplicável — é uma informação exibida pelo sistema, não preenchida pelo operador

Descrição: Identifica de forma única cada escala de abate disponível, combinando a filial, o código, a série e o número do documento da escala.

Comportamento: É exibido automaticamente para cada escala da lista; não pode ser editado pelo operador.

Impacto: É usado internamente pelo sistema para localizar a escala correta ao registrar ou consultar condenações.

Nome do pecuarista (item da lista de escalas)

Tipo: Informativo (texto, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Mostra o nome do pecuarista responsável pelo lote de animais associado à escala, ajudando o operador a identificar visualmente a escala correta.

Comportamento: Exibido automaticamente conforme o cadastro da escala no sistema central.

Impacto: Apenas informativo na tela; não é enviado como parte do registro de condenação.

Nome da propriedade rural (item da lista de escalas)

Tipo: Informativo (texto, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Indica de qual propriedade rural é o lote de animais vinculado à escala.

Comportamento: Exibido automaticamente conforme o cadastro da escala.

Impacto: Apenas informativo na tela; não é enviado como parte do registro de condenação.

Número do lote (item da lista de escalas)

Tipo: Informativo (número, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Identifica o lote de abate ao qual a escala pertence. É o número usado para localizar a escala certa e para exibir o totalizador de condenações.

Comportamento: A lista de escalas é ordenada por esse número, do menor para o maior, tratando-o como número inteiro. Se o lote estiver vazio ou não preenchido, o sistema considera o valor 0 apenas para fins de ordenação — mas escalas sem lote preenchido, na prática, nem chegam a aparecer para seleção completa.

Impacto: Aparece também no cartão da escala selecionada e no texto do totalizador de condenações.

Sexo (item da lista de escalas)

Tipo: Informativo (texto, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Indica o sexo do lote de animais (por exemplo, macho ou fêmea) associado à escala.

Comportamento: Escalas com esse campo vazio no cadastro não aparecem na lista de seleção.

Impacto: É usado internamente pelo sistema na formação do código de rastreabilidade gerado para cada condenação registrada.

Data do abate (item da lista de escalas / cartão da escala selecionada)

Tipo: Informativo (data, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Mostra a data em que o abate do lote foi realizado.

Comportamento: Exibida no formato brasileiro (dia/mês/ano) tanto na lista de escalas quanto no cartão da escala já selecionada.

Impacto: É usada internamente pelo sistema na formação do código de rastreabilidade de cada condenação.

Indicador de romaneio (ícone colorido no item da lista de escalas)

Tipo: Indicador visual (cor)

Obrigatoriedade: Não aplicável

Descrição: Mostra rapidamente se a escala já pode ser usada para lançar condenações. A cor verde indica que o romaneio de abate já foi criado; a cor vermelha indica que ainda não foi criado.

Comportamento: Se o operador tentar selecionar (com duplo toque) uma escala com indicador vermelho, o sistema exibe um diálogo de erro e não permite prosseguir.

Impacto: Nenhum dado é enviado ao servidor por causa desse indicador — ele serve apenas para orientar visualmente o operador antes da tentativa de seleção.

Cartão da escala selecionada — Lote

Tipo: Informativo (número, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Reforça, após a seleção, qual é o número do lote da escala atualmente em uso na tela.

Comportamento: Atualizado automaticamente sempre que uma nova escala é selecionada ou quando o botão Limpar é acionado (nesse caso, o cartão desaparece).

Impacto: Usado como referência visual e também compõe o texto do totalizador.

Cartão da escala selecionada — Data do abate

Tipo: Informativo (data, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Reforça, após a seleção, qual é a data do abate da escala em uso.

Comportamento: Exibida no formato dia/mês/ano; atualizada automaticamente conforme a escala selecionada.

Impacto: Apenas informativo na tela.

Produto (agrupador na lista de condenações)

Tipo: Informativo (texto, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Identifica o produto ao qual as ocorrências de condenação abaixo dele pertencem, exibido no formato “código.referência – nome do produto” (por exemplo: “101.REF – Dianteiro com Osso”).

Comportamento: Os produtos são listados em ordem crescente pelo código do produto. Só aparecem produtos cujo cadastro foi localizado na base local do servidor.

Impacto: É o agrupador usado para organizar visualmente as ocorrências e para localizar corretamente o registro certo ao adicionar ou remover uma condenação.

Ocorrência (dentro de cada produto, na lista de condenações)

Tipo: Informativo (texto, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Representa o motivo da condenação (por exemplo, “Fasciolose”, “Abscesso”, “Contaminação”) cadastrado para aquele produto e para o posto de trabalho do usuário logado.

Comportamento: Todas as ocorrências cadastradas para o posto de trabalho do usuário são exibidas, inclusive as que ainda estão com quantidade zero.

Impacto: É a informação usada para identificar exatamente qual tipo de condenação está sendo registrada ou removida.

Quantidade da ocorrência

Tipo: Informativo (número, somente leitura, atualizado automaticamente)

Obrigatoriedade: Não aplicável

Descrição: Mostra quantas peças já foram condenadas para aquela ocorrência e produto, dentro da escala e do lote selecionados.

Comportamento: Exibida sempre sem casas decimais. É atualizada automaticamente a cada toque nos botões + ou -.

Impacto: Soma-se ao totalizador geral do lote, exibido na parte inferior da tela.

Total de condenações Lote ({lote}): {soma total}

Tipo: Informativo (número calculado automaticamente, somente leitura)

Obrigatoriedade: Não aplicável

Descrição: Mostra a soma de todas as condenações de todos os produtos e ocorrências registradas para o lote da escala selecionada.

Comportamento: Recalculado automaticamente a cada novo registro (+) ou remoção (-); exibido sempre sem casas decimais.

Impacto: Serve como conferência rápida do total de condenações do lote antes do encerramento do processo de abate.

Botão + (adicionar condenação)

Tipo: Botão de ação

Obrigatoriedade: Não aplicável (ação disponível para cada ocorrência listada)

Descrição: Usado pelo operador para registrar uma nova ocorrência de condenação para o produto correspondente.

Comportamento: Ao ser tocado, o sistema envia o registro ao servidor, que executa uma série de verificações (escala, produto, ocorrência, vínculo com o posto de trabalho e SIF da filial) antes de gravar. Se alguma verificação falhar, um diálogo de erro correspondente é exibido e nada é gravado. Se tudo estiver correto, a quantidade da ocorrência e o totalizador são atualizados na tela.

Impacto: Gera um novo registro de condenação no sistema central, que é sincronizado em segundo plano com o ERP.

Botão – (remover condenação)

Tipo: Botão de ação

Obrigatoriedade: Não aplicável (ação disponível para cada ocorrência listada)

Descrição: Usado pelo operador para remover o registro de condenação mais recente daquela ocorrência e produto.

Comportamento: Se a quantidade atual da ocorrência for maior que zero, o sistema localiza e exclui o registro mais recente daquela combinação de escala, lote, ocorrência e produto, atualizando a quantidade exibida e o totalizador. Se a quantidade já estiver em zero, o toque é ignorado e nenhuma mensagem é exibida.

Impacto: Remove o registro correspondente no sistema central e agenda também a remoção no ERP em segundo plano.

Botão Limpar

Tipo: Botão de ação

Obrigatoriedade: Não aplicável

Descrição: Usado pelo operador para desfazer a seleção da escala atual e começar de novo com outra escala.

Comportamento: Ao ser tocado, remove a escala selecionada e zera toda a lista de condenações exibida na tela, sem enviar nenhuma informação ao servidor — é uma ação apenas local, no aparelho.

Impacto: Nenhum impacto nos dados já gravados no servidor; serve apenas para reiniciar a visualização da tela no coletor.

Campos que podem ser alterados

Nenhum campo do registro já lançado pode ser editado diretamente (como quantidade, ocorrência ou produto). A única alteração possível é adicionar um novo registro (+) ou remover o mais recente (-).

Campos bloqueados e motivo

Todos os dados do registro já gravado (funcionário, data e hora, código de rastreabilidade, quantidade) ficam bloqueados para edição direta, pois o sistema trabalha com lançamentos individuais somados — cada toque em + ou – representa um evento próprio, e não a edição de um valor já existente.

Condição que impede a remoção

Se a quantidade exibida para a ocorrência já estiver em zero, o toque no botão – é simplesmente ignorado, sem nenhum aviso na tela.

Histórico ou log de alterações

A documentação de origem não descreve uma tela de histórico visível ao operador para consultar quem lançou ou removeu cada condenação. O que existe é a atualização imediata da quantidade e do totalizador na própria tela a cada ação. [informação não disponível na documentação de origem — validar com analista responsável] quanto à existência de um relatório de histórico em outra tela do sistema.

Validações no sistema central

Sempre que o operador toca em + ou em -, o sistema primeiro confirma, no sistema central, se a escala, o produto, a ocorrência e as demais condições ainda são válidas naquele momento (por exemplo, se a escala não foi cancelada ou alterada por outra pessoa desde que o operador a carregou no aparelho). Só depois dessas confirmações o registro é efetivamente gravado ou removido.

Sincronização assíncrona com ERP

Depois que o registro é gravado ou removido no sistema central, o envio dessa informação para o ERP acontece automaticamente, em segundo plano, sem que o operador precise esperar. Isso significa que o operador recebe a confirmação da operação rapidamente, mesmo que a comunicação com o ERP demore um pouco mais para se completar.

Código de rastreabilidade automático

Cada condenação registrada recebe, automaticamente, um código de rastreabilidade próprio, formado pela junção do código SIF da filial, da data do abate da escala, do número do lote e do sexo do lote. Esse código ajuda a garantir a rastreabilidade completa da condenação até a origem do lote, sendo usado internamente pelo sistema e pelo ERP.

Processamento no ERP

Quando a informação chega ao ERP, ele gera seu próprio número de controle para aquele registro de condenação (diferente do número usado no coletor e no Manager) e vincula o lançamento a uma data de movimento correspondente ao dia em que a condenação foi realizada. Quando uma remoção é sincronizada, o ERP localiza o registro correspondente e o apaga por completo — não existe, nesse ponto, um cancelamento que apenas “marca” o registro como cancelado, mantendo-o na base.

Tratamento de erros de sincronização

Se, durante essa sincronização em segundo plano, o ERP retornar algum erro, o sistema captura a mensagem de erro e exibe um aviso na sessão ativa do operador, informando o que aconteceu. Importante: mesmo que esse aviso apareça, a operação já foi concluída no sistema central — ou seja, o lançamento ou a remoção feita pelo operador não é desfeita por causa desse erro de sincronização; apenas a atualização no ERP é que pode precisar ser verificada e reprocessada pelo suporte técnico.

Dependência de comunicação com servidor

Esta rotina não possui modo de funcionamento offline: tanto para consultar as escalas e condenações existentes quanto para registrar ou remover uma condenação, o coletor precisa estar conectado ao servidor no momento da operação.

Regra 1 — Seleção de escala exige duplo toque

Um toque simples sobre uma escala na lista não produz nenhum efeito. É necessário um duplo toque para que o sistema tente selecioná-la.

Regra 2 — Escala sem lote não pode ser usada

Escalas sem o lote efetivo de produção preenchido não podem ser selecionadas. O sistema exibe um aviso rápido na tela e não avança.

Regra 3 — Escala sem romaneio de abate não pode ser usada

Escalas cujo romaneio de abate ainda não foi criado no sistema central não podem ser selecionadas. O sistema exibe um diálogo de erro e não avança. Visualmente, essas escalas aparecem com indicador vermelho na lista.

Regra 4 — Escala sem sexo cadastrado ou com produto não localizado não aparece na lista

Escalas com o campo sexo vazio, ou cujo produto associado não foi encontrado na base local do servidor, são automaticamente removidas da lista de seleção — o operador nem chega a vê-las.

Regra 5 — Filial sem código SIF bloqueia novos registros

Se a filial do operador não tiver o código SIF cadastrado, nenhum novo registro de condenação pode ser feito, em nenhuma escala, até que esse cadastro seja corrigido no sistema central.

Regra 6 — Remoção com quantidade zero é ignorada

O botão – aparece ao lado de todas as ocorrências, mesmo daquelas com quantidade zero, mas o toque não tem nenhum efeito quando a quantidade já está em zero — e nenhuma mensagem é exibida ao operador nesse caso.

Regra 7 — Exclusão sempre remove o registro mais recente

Ao tocar em -, o sistema nunca pergunta qual registro remover: ele localiza automaticamente, dentro da combinação de escala, lote, ocorrência e produto, o registro com a data e hora mais recente e o exclui.

Regra 8 — Ordenação das escalas

A lista de escalas é sempre ordenada pelo número do lote, do menor para o maior, tratando esse número como valor inteiro. Caso o lote esteja vazio, ele é tratado como 0 apenas para fins de ordenação.

Regra 9 — Ordenação dos produtos

Dentro da lista de condenações de uma escala, os produtos aparecem sempre ordenados pelo código do produto, do menor para o maior.

Regra 10 — Quantidades sempre exibidas sem casas decimais

Tanto a quantidade de cada ocorrência quanto o total geral do lote são sempre mostrados como números inteiros, sem casas decimais.

Regra 11 — Cada toque em + representa um lançamento individual

A cada toque no botão +, o sistema registra uma nova condenação individual (quantidade auxiliar 1) e o servidor é quem soma esses lançamentos para exibir a quantidade agrupada por ocorrência e o total do lote.

Regra 12 — Validações obrigatórias antes de gravar uma condenação

Antes de gravar qualquer novo registro, o sistema confirma, em sequência: se os dados enviados estão completos, se a escala ainda existe, se o lote efetivo ainda está preenchido, se a escala não está cancelada, se o produto está cadastrado, se a ocorrência está cadastrada e é do tipo Condenação, se existe vínculo cadastrado entre posto de trabalho, ocorrência e produto, e se a filial possui SIF cadastrado. Qualquer falha nessas verificações impede a gravação e exibe uma mensagem de erro específica ao operador.

Regra 13 — Escala cancelada ou alterada impede novos lançamentos

Se a escala tiver sido cancelada ou tiver o lote efetivo removido no sistema central após ter sido carregada no coletor, o sistema bloqueia novos lançamentos e orienta o operador a atualizar a lista de escalas.

Regra 14 — Rastreabilidade gerada automaticamente

Cada condenação registrada recebe um código de rastreabilidade formado pelo código SIF da filial, pela data do abate, pelo número do lote e pelo sexo do lote, gerado automaticamente pelo sistema — o operador não preenche nem visualiza esse código diretamente na tela.

Regra 15 — Sincronização com o ERP é assíncrona

O operador recebe a confirmação do lançamento ou da remoção assim que o sistema central processa a operação, sem precisar esperar a confirmação do ERP. Caso a sincronização com o ERP falhe depois, um aviso aparece na sessão do operador, mas o lançamento ou remoção já realizado no sistema central não é desfeito por causa desse erro.

Regra 16 — Botão Limpar não envia dados ao servidor

Acionar o botão Limpar apenas remove a escala e zera a lista de condenações na tela do coletor; nenhuma informação é enviada ou alterada no sistema central por causa dessa ação.

Regra 17 — Rotina depende de comunicação constante com o servidor

Não existe modo offline para esta rotina: tanto a consulta de escalas e condenações quanto o registro ou a remoção de uma condenação exigem que o coletor esteja conectado ao servidor no momento da operação.