Tipificação de Pescados
Criado por Igor Ribeiro em 19 de agosto de 2026
Atualizado por Igor Ribeiro em 19 de agosto de 2026
Tipificação de Pescados
Sistema de classificação peixe a peixe no coletor, com registro automatizado de qualidade e geração de volumes de estoque
Visão Geral da Tipificação de Pescados
A Tipificação de Pescados é a tela do coletor (aplicativo usado no chão de fábrica) em que o operador classifica, peixe a peixe, o resultado de uma ordem de produção de pescados. Para cada peixe processado, o operador informa a identificação (número de lacre), o peso, se o peixe chegou vivo ou morto, o produto, e uma combinação de classificações de qualidade (sashibo, frescor, textura, cauda, sangue e cobertura de gordura, de acordo com os critérios cadastrados para aquele produto), além de uma eventual ocorrência. Cada peixe tipificado gera um volume de estoque individual, com etiqueta própria.
Dentro do fluxo geral do frigorífico, esta tela só é liberada depois que uma ordem de produção de pescados já foi lançada e teve sua produção contabilmente atualizada no ERP. Ao tipificar cada peixe, o sistema gera (ou reaproveita, se já existir) um romaneio de saída de destino, cria automaticamente um volume de estoque para aquele peixe com as classificações escolhidas, e imprime a etiqueta correspondente — encerrando, para aquele peixe, o ciclo de produção que havia começado na ordem.
As classificações de qualidade escolhidas pelo operador também podem indicar, automaticamente, que o produto originalmente identificado deve ser substituído por outro produto (por exemplo, quando a combinação de qualidade aponta para uma linha de produto diferente da que foi digitada ou bipada no início). Essa substituição é resolvida pelo próprio sistema antes de a tipificação ser efetivada, sem que o operador precise fazer nada além de confirmar as classificações.
ℹ️ Contexto operacional: A tipificação é a etapa que consolida a produção de cada peixe no estoque, gerando registros individualizados de qualidade e etiquetas de identificação.
Vídeo Tutorial da Tipificação de Pescados
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso da Tipificação de Pescados
Quem acessa: Operador de produção que trabalha no coletor, no momento em que os peixes de uma ordem de produção estão sendo separados e classificados fisicamente.
Condições obrigatórias para acesso:
- Ordem de produção lançada: Precisa existir ao menos uma ordem de produção de pescados lançada para a data de movimentação corrente do aplicativo. Essa lista é buscada automaticamente quando a tela é aberta. Se a busca não encontrar nenhuma ordem, o campo de filtro de ordens fica desabilitado, mas a tela continua acessível (sem bloquear o operador).
- Produção contabilmente atualizada: A ordem de produção selecionada precisa já estar com a produção contabilmente atualizada no ERP. Se a ordem ainda não tiver sido atualizada, o sistema recusa o acesso com a mensagem “ordem de produção não atualizada, atualize a ordem de produção” — nesse caso, é necessário solicitar ao responsável pela produção que finalize/atualize a ordem antes de tentar tipificar novamente.
- Romaneio de saída de destino não atualizado: Depois que a ordem é confirmada, o sistema busca (ou cria) o documento de destino da tipificação, chamado de romaneio de saída de destino. Esse documento de destino precisa permanecer com o status contábil ainda não confirmado (“não atualizado”) durante todo o período em que a ordem estiver sendo tipificada. Se alguém finalizar/atualizar esse romaneio antes de todos os peixes da ordem serem tipificados, o sistema bloqueia o acesso à tela de tipificação com a mensagem “O documento {documento} já foi atualizado”, e nenhum peixe daquela ordem pode mais ser tipificado por ali.
- Parâmetro de peso (pTipificacaoPescadosSolicitaPesoInicioProcesso): Define se o peso do peixe deve ser pedido no início ou no fim da sequência de perguntas da tela. Esse parâmetro só é considerado “ativado” quando o valor cadastrado for exatamente a letra “S” (maiúscula ou minúscula, o sistema converte antes de comparar); qualquer outro valor, ou uma eventual falha ao ler o parâmetro, faz o sistema assumir o comportamento padrão, que é pedir o peso no fim do processo.
- Listas de apoio: As listas de apoio usadas na tela — as seis listas de classificação (sashibo, frescor, textura, sangue, cauda e cobertura de gordura), a lista de ocorrências ativas, as combinações de tipificação cadastradas e a lista de produtos disponíveis para substituição — são carregadas automaticamente e em conjunto quando a tela é aberta. Cada lista de classificação só traz os códigos marcados como ativos no cadastro correspondente; um código que tenha sido desativado nunca aparece como opção, mesmo que já tenha sido usado em tipificações feitas anteriormente.
- Critérios de tipificação do produto: Um produto só apresenta etapas de classificação na tela se tiver ao menos um critério de tipificação ativo cadastrado (sashibo, frescor, sangue, textura, cauda e/ou cobertura de gordura). Produtos sem nenhum critério cadastrado pulam direto para a etapa de ocorrência, sem pedir nenhuma classificação.
⚠️ Importante: Todas as validações de acesso são checadas automaticamente pelo sistema no momento em que a tela é aberta. Se uma condição não for atendida, uma mensagem específica orienta o operador sobre o que fazer.
Processo de Criação — Passo a Passo da Tipificação de Pescados
Selecionar a ordem de produção
O operador abre a tela de ordens de produção de pescados. O aplicativo carrega automaticamente a lista de ordens do dia, os parâmetros de configuração e as listas de apoio (classificações, ocorrências, combinações e produtos substitutos). O operador localiza a ordem desejada usando a busca textual pelo número do pedido ou pela chave de fato, e toca sobre ela na tabela. O botão “Tipificar” só fica habilitado depois que uma ordem é selecionada.
Abrir a tela de tipificação
Ao confirmar a ordem selecionada (tocando em “Tipificar”, ou dando um duplo toque direto sobre a ordem na tabela como atalho), o aplicativo busca o detalhe do documento de destino daquela ordem. Se esse documento já tiver sido contabilmente atualizado, o acesso é bloqueado com a mensagem “O documento {documento} já foi atualizado”. Caso contrário, a tela de tipificação é aberta e o aplicativo já está pronto para receber o primeiro peixe.
Informar a identificação do peixe (número de lacre)
O operador digita ou bipa o número do lacre do peixe. O valor precisa ser um número inteiro; se não for, o sistema exibe “informe a identificação do peixe” e não avança. Depois que a identificação é confirmada, o aplicativo avança automaticamente para a próxima etapa (peso ou vivo/morto, dependendo do parâmetro de peso no início) e já pré-preenche o campo seguinte com o valor informado anteriormente para aquela etapa, se houver algum.
Informar o peso do peixe ou se ele está vivo ou morto
Se o parâmetro de peso no início estiver ativado, o operador informa primeiro o peso do peixe e só depois se ele está vivo ou morto. Se o parâmetro estiver desativado (comportamento padrão), o operador informa primeiro se o peixe está vivo ou morto, e o peso é pedido mais adiante, depois da ocorrência. No campo vivo/morto, apenas as letras “V” (vivo) ou “M” (morto) são aceitas, sem diferenciar maiúsculas de minúsculas; qualquer outro valor, incluindo o campo vazio, abre a tela de seleção em vez de avançar.
Informar o código do produto
O operador digita, bipa ou escolhe na tela de seleção o código do produto do peixe. Se o código for digitado ou bipado manualmente, o sistema procura esse código exatamente na lista de itens do documento de destino já carregado; se não encontrar, abre a tela de seleção; se encontrar, busca os critérios de tipificação cadastrados para aquele produto e segue o fluxo. Se o campo ficar vazio, o sistema exibe “informe um código de produto” e não avança.
Informar as classificações de qualidade cadastradas para o produto
Para cada critério de classificação cadastrado para aquele produto (sashibo, frescor, sangue, textura, cauda e/ou cobertura de gordura, na ordem em que estiverem cadastrados), o operador informa o código correspondente, digitando, bipando ou escolhendo na tela de seleção. Se o código informado não existir na lista de códigos ativos daquele critério, o sistema exibe uma mensagem específica (por exemplo, “informe um código de sashibo válido”) e não avança. Produtos sem nenhum critério cadastrado pulam esta etapa inteira e vão direto para a etapa de ocorrência.
Informar a ocorrência (opcional)
O operador informa o código de uma ocorrência, se houver alguma a registrar para aquele peixe. Esta etapa está sempre presente na sequência, mas, diferente das demais, não exige preenchimento — o operador pode deixá-la em branco e seguir adiante.
Informar o peso do peixe, se ainda não tiver sido informado no início
Caso o parâmetro de peso no início esteja desativado, é neste ponto que o peso é solicitado. O valor precisa ser um número decimal válido; caso contrário, o sistema exibe “informe um peso válido” e não avança.
Conferir a combinação de tipificação calculada e confirmar a seleção
Na etapa final, chamada de confirmação de seleção, o sistema já calculou automaticamente a combinação de tipificação aplicável com base nos códigos escolhidos em cada classificação. Se a combinação encontrada indicar que o produto deve ser substituído por outro, o sistema exibe “Verificando ou criando item ROM…” enquanto garante que o produto substituto já existe como item no romaneio de destino, antes de deixar o operador confirmar. Se nenhuma combinação cadastrada corresponder às classificações informadas e também não existir uma combinação padrão de código “X”, o sistema exibe o aviso “Não foi possível localizar a combinação padrão com código X” e não deixa a tipificação avançar até que uma combinação válida seja obtida (ajustando classificações ou aguardando o cadastro ser corrigido).
Confirmar e efetivar a tipificação
O operador confirma a seleção final. O aplicativo exibe “Processando tipificação…” enquanto envia os dados ao servidor. Se tudo ocorrer corretamente, o sistema cria o volume de estoque daquele peixe, gera a etiqueta correspondente, envia automaticamente essa etiqueta para a impressora do posto de trabalho e exibe a mensagem “Tipificação efetuada”.
Repetir o processo para o próximo peixe
Depois da confirmação, a tela é reiniciada automaticamente, pronta para receber a identificação do próximo peixe daquela mesma ordem. Sempre que um novo código de produto é identificado, a lista de etapas de classificação, ocorrência, peso e seleção é remontada do zero, para que nenhuma resposta dada para o peixe anterior seja aproveitada por engano no peixe seguinte.
Observações válidas durante todo o processo de criação
- Botões Voltar e Recarregar: só ficam habilitados a partir do momento em que o operador sai da primeira etapa (identificação do peixe). “Voltar” apaga o valor já preenchido na etapa atual e devolve ao campo de texto o valor que havia sido informado na etapa anterior (identificação, vivo/morto ou peso, conforme o caso). “Recarregar” reinicia toda a tela de tipificação, descartando todas as respostas dadas até aquele momento para o peixe em andamento.
- Leitor de código de barras: Em aparelhos cujo leitor de código de barras não é homologado pelo sistema, a tela de seleção correspondente à etapa atual é aberta automaticamente sempre que a etapa muda, já que o operador não teria como bipar um código físico para escolher o valor. Em aparelhos com leitor homologado, a tela de seleção só abre quando o operador toca no botão de seleção correspondente.
Descrição de Cada Campo da Tela da Tipificação de Pescados
Campo de busca de ordens (na tela de seleção de ordens de produção)
Tipo: Texto
Obrigatoriedade: Opcional
Descrição: Permite localizar rapidamente uma ordem de produção de pescados digitando parte do número do pedido ou da chave de fato do documento.
Comportamento: Filtra a lista de ordens exibida na tabela conforme o texto digitado; se a lista de ordens não retornar nenhum item ao abrir a tela, este campo fica desabilitado, mas a tela permanece acessível.
Impacto: Não gera nenhum dado próprio — serve apenas para facilitar a localização da ordem que será tipificada.
Tabela de ordens de produção de pescados
Tipo: Lista/Tabela de registros
Obrigatoriedade: Não aplicável (exibição de dados)
Descrição: Mostra as ordens de produção de pescados disponíveis para tipificação na data de movimentação corrente do aplicativo.
Comportamento: O operador toca em uma linha para selecionar a ordem (o botão “Tipificar” só é habilitado após essa seleção); um duplo toque sobre a linha já seleciona a ordem e abre diretamente a tela de tipificação, pulando a etapa de tocar no botão “Tipificar”.
Impacto: A ordem selecionada define para qual documento de destino os peixes tipificados a seguir serão direcionados.
Botão “Tipificar”
Tipo: Botão de ação
Obrigatoriedade: Não aplicável (ação, não campo de preenchimento)
Descrição: Confirma a ordem selecionada e solicita ao sistema a abertura da tela de tipificação para aquela ordem.
Comportamento: Só fica habilitado depois que uma ordem é selecionada na tabela; ao ser acionado, busca o detalhe do documento de destino e bloqueia o acesso se esse documento já tiver sido contabilmente atualizado.
Impacto: Abre a tela onde os peixes daquela ordem serão efetivamente tipificados.
Informe o id do peixe (identificação do peixe / número de lacre)
Tipo: Número (inteiro)
Obrigatoriedade: Obrigatório
Descrição: Identifica de forma única o peixe que está sendo tipificado, por meio do número do lacre físico afixado nele.
Comportamento: Aceita digitação manual ou leitura por código de barras; o valor precisa ser um número inteiro, senão o sistema exibe “informe a identificação do peixe” e não avança. Depois de confirmado, o sistema verifica, no momento da efetivação, se já existe um volume lançado com o mesmo lacre na mesma data de produção do romaneio; se existir, recusa a tipificação com a mensagem “já existe volume lançado com o número de lacre {lacre} em {data}”.
Impacto: Fica registrado no volume de estoque gerado para aquele peixe e é usado para impedir lançamentos duplicados do mesmo lacre na mesma data.
Informe o peso
Tipo: Número decimal
Obrigatoriedade: Obrigatório
Descrição: Representa o peso do peixe tipificado, usado tanto como peso líquido quanto como peso bruto no volume de estoque gerado.
Comportamento: O valor digitado é convertido para decimal e formatado com três casas decimais; se o valor digitado não for um número decimal válido, o sistema exibe “informe um peso válido” e não avança (um valor inválido, se de alguma forma for aceito internamente, é tratado como zero). Dependendo do parâmetro de configuração do ERP, esta etapa aparece logo no início da sequência (depois da identificação do peixe) ou mais ao final (depois da ocorrência).
Impacto: É gravado no volume de estoque como peso líquido e peso bruto, usado no cálculo de estoque e nos relatórios que dependem desse volume.
Vivo/Morto
Tipo: Seleção (texto restrito a duas opções)
Obrigatoriedade: Obrigatório
Descrição: Indica se o peixe chegou vivo ou morto ao processamento.
Comportamento: Aceita apenas os valores “V” (vivo) ou “M” (morto), digitados, bipados ou escolhidos na tela de seleção, sem diferenciar maiúsculas de minúsculas; qualquer outro valor, incluindo o campo vazio, abre a tela de seleção em vez de avançar. O valor é sempre armazenado em letra maiúscula.
Impacto: É gravado no volume de estoque gerado (como o indicador de checksum vivo/morto) e pode ser usado como critério de conferência em processos posteriores.
Informe o código do produto
Tipo: Texto/Autocomplete
Obrigatoriedade: Obrigatório
Descrição: Identifica o produto (peixe/corte) que está sendo tipificado, dentre os itens já previstos no documento de destino daquela ordem.
Comportamento: Pode ser digitado, bipado ou escolhido na tela de seleção; se digitado ou bipado manualmente, o sistema procura o código exatamente na lista de itens do documento de destino já carregado — se não encontrar, abre a tela de seleção; se encontrar, busca os critérios de classificação cadastrados para aquele produto e monta a sequência de etapas seguintes. Se o campo ficar vazio, o sistema exibe “informe um código de produto” e não avança. Sempre que um novo produto é identificado, todas as etapas de classificação, ocorrência, peso e seleção são remontadas do zero, descartando respostas de uma tentativa anterior.
Impacto: Define quais classificações de qualidade serão pedidas em seguida, qual item do romaneio de destino receberá a quantidade tipificada, e pode ser substituído automaticamente por outro produto conforme a combinação de qualidade calculada no final.
Informe a classificação de sashibo
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de sashibo cadastrado como ativo; produtos sem esse critério não exibem esta etapa.
Descrição: Representa a avaliação de qualidade do peixe quanto ao critério de sashibo, usada para compor a combinação de tipificação final.
Comportamento: Aceita código digitado, bipado ou escolhido na tela de seleção, sempre entre os códigos ativos cadastrados para esse critério; um código fora dessa lista faz o sistema exibir uma mensagem específica (por exemplo, “informe um código de sashibo válido”) e não avançar. O valor informado é sempre armazenado em letra maiúscula.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe a classificação de frescor
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de frescor cadastrado como ativo.
Descrição: Representa a avaliação de qualidade do peixe quanto ao frescor, usada para compor a combinação de tipificação final.
Comportamento: Mesmo comportamento de validação, seleção e armazenamento em maiúsculas descrito para a classificação de sashibo, aplicado ao critério de frescor.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe a classificação de sangue
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de sangue cadastrado como ativo.
Descrição: Representa a avaliação de qualidade do peixe quanto à presença ou ausência de sangue, usada para compor a combinação de tipificação final.
Comportamento: Mesmo comportamento de validação, seleção e armazenamento em maiúsculas descrito para a classificação de sashibo, aplicado ao critério de sangue.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe a classificação de textura
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de textura cadastrado como ativo.
Descrição: Representa a avaliação de qualidade do peixe quanto à textura, usada para compor a combinação de tipificação final.
Comportamento: Mesmo comportamento de validação, seleção e armazenamento em maiúsculas descrito para a classificação de sashibo, aplicado ao critério de textura.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe a classificação de cauda
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de cauda cadastrado como ativo.
Descrição: Representa a avaliação de qualidade do peixe quanto à cauda, usada para compor a combinação de tipificação final.
Comportamento: Mesmo comportamento de validação, seleção e armazenamento em maiúsculas descrito para a classificação de sashibo, aplicado ao critério de cauda.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe a classificação de gordura (cobertura de gordura)
Tipo: Seleção
Obrigatoriedade: Condicional — obrigatório apenas quando o produto identificado tiver o critério de gordura cadastrado como ativo.
Descrição: Representa a avaliação de qualidade do peixe quanto à cobertura de gordura, usada para compor a combinação de tipificação final.
Comportamento: Mesmo comportamento de validação, seleção e armazenamento em maiúsculas descrito para a classificação de sashibo, aplicado ao critério de cobertura de gordura.
Impacto: Entra no cálculo da combinação de tipificação, é gravado no volume de estoque gerado e aparece no texto da combinação impresso na etiqueta.
Informe o código de ocorrência
Tipo: Seleção
Obrigatoriedade: Opcional (esta etapa está sempre presente na sequência, mas o sistema não exige preenchimento)
Descrição: Registra alguma ocorrência observada naquele peixe específico, dentre as ocorrências ativas cadastradas no sistema.
Comportamento: Aceita código digitado, bipado ou escolhido na tela de seleção; ao contrário das demais etapas, o campo vazio não bloqueia o avanço. Quando o parâmetro de peso no início está ativado, é justamente ao chegar nesta etapa que o sistema tenta calcular a combinação de tipificação com os dados já completos; se não conseguir, o operador permanece nesta etapa até que uma combinação válida seja obtida.
Impacto: É gravado no volume de estoque gerado para aquele peixe, quando informada.
Combinação (texto informativo da combinação calculada)
Tipo: Texto informativo (somente leitura, calculado automaticamente pelo sistema)
Obrigatoriedade: Não aplicável (não é preenchido pelo operador)
Descrição: Mostra o nome da combinação de tipificação já calculada pelo sistema com base nas classificações informadas para aquele peixe.
Comportamento: Exibe o nome da combinação, se já houver uma calculada; se ao menos um critério aplicável ao produto já tiver sido preenchido e o peso também já tiver sido informado, mas nenhuma combinação bater, exibe em itálico o texto “Nenhuma combinação encontrada”; se nenhuma dessas condições estiver satisfeita ainda, o campo permanece em branco.
Impacto: Define, junto com as regras de substituição de produto, qual será o produto e as classificações efetivamente gravadas no volume de estoque, e compõe o texto impresso na etiqueta do peixe.
Confirmar Seleção (exibido como “Seleção:”)
Tipo: Seleção / Etapa de confirmação
Obrigatoriedade: Obrigatório (etapa final do fluxo)
Descrição: Etapa final em que o operador confere os dados informados e, se aplicável, escolhe um produto de substituição entre os produtos disponíveis para substituição.
Comportamento: Nesta etapa, a tela de seleção (quando aberta) lista os produtos substitutos cadastrados; ao confirmar, o sistema já calculou a combinação de tipificação aplicável e, se ela indicar substituição de produto, verifica ou cria automaticamente o item correspondente no romaneio de destino antes de liberar a confirmação final.
Impacto: Dispara a efetivação da tipificação no servidor, a geração do volume de estoque e a impressão automática da etiqueta.
Botão “Voltar”
Tipo: Botão de ação
Obrigatoriedade: Não aplicável (ação, não campo de preenchimento)
Descrição: Permite ao operador retornar à etapa anterior da sequência de tipificação.
Comportamento: Só fica habilitado quando a etapa atual não é a primeira (identificação do peixe); ao ser acionado, apaga o valor já preenchido na etapa atual e devolve ao campo de texto o valor que havia sido informado na etapa anterior (identificação do peixe, vivo/morto ou peso, conforme o caso).
Impacto: Não altera nenhum dado já salvo — afeta apenas o preenchimento em andamento na tela.
Botão “Recarregar”
Tipo: Botão de ação
Obrigatoriedade: Não aplicável (ação, não campo de preenchimento)
Descrição: Permite ao operador reiniciar completamente a tipificação do peixe em andamento.
Comportamento: Só fica habilitado quando a etapa atual não é a primeira; ao ser acionado, reinicia toda a tela de tipificação, descartando todas as respostas dadas até então para aquele peixe.
Impacto: Não altera nenhum dado já salvo — afeta apenas o preenchimento em andamento na tela.
Botão de seleção dinâmica (ícone de lista)
Tipo: Botão de ação
Obrigatoriedade: Não aplicável (ação, não campo de preenchimento)
Descrição: Abre uma tela de lista com as opções válidas para a etapa atual, para o operador escolher em vez de digitar ou bipar. Disponível em vivo/morto, código do produto, cada classificação, ocorrência e seleção final.
Comportamento: Em aparelhos cujo leitor de código de barras não é homologado pelo sistema, essa tela abre automaticamente sempre que a etapa muda; em aparelhos com leitor homologado, ela só abre quando o operador toca neste botão. O título da tela de seleção muda conforme a etapa (por exemplo, “Selecionar vivo ou morto”, “Selecionar código do produto”, “Selecionar sashibo/frescor/textura/cauda/sangue/gordura”, “Selecionar ocorrência”, “Selecionar produto de substituição”). Nas etapas de código de produto e de ocorrência, se a lista de opções estiver vazia, é exibida a mensagem “Nenhum {título} encontrado”; nas demais etapas, a lista simplesmente aparece vazia. As opções de classificação são ordenadas pelo nível de classificação cadastrado, do menor para o maior (quando não há nível cadastrado, é tratado como o menor valor).
Impacto: O valor escolhido preenche o campo da etapa atual da mesma forma que se tivesse sido digitado ou bipado.
Tabela de produtos tipificados
Tipo: Lista/Tabela de registros
Obrigatoriedade: Não aplicável (exibição de dados)
Descrição: Mostra, dentro da ordem selecionada, os produtos distintos que já tiveram ao menos um peixe tipificado.
Comportamento: Cada linha exibe o texto “{código} – {nome}” do produto, separado em duas colunas (código e descrição); o operador toca em uma linha para filtrar, na tabela abaixo, apenas os peixes tipificados daquele produto.
Impacto: Controla o que é exibido na tabela de peixes tipificados, descrita a seguir.
Tabela de peixes tipificados
Tipo: Lista/Tabela de registros
Obrigatoriedade: Não aplicável (exibição de dados)
Descrição: Mostra os volumes (peixes) já tipificados para o produto selecionado na tabela de produtos tipificados.
Comportamento: Antes de qualquer produto ser selecionado na tabela acima, exibe a mensagem “Selecione um produto acima”. Depois de um produto ser selecionado, mostra somente os volumes cujo produto corresponda exatamente ao selecionado, ordenados pelo número do volume em ordem decrescente (o mais recente aparece primeiro). A partir desta tabela o operador pode solicitar a reimpressão da etiqueta de um volume ou excluir a tipificação de um volume lançado incorretamente (ver seções 6 e 7).
Impacto: Cada volume listado corresponde a um peixe já tipificado com sucesso, com seu volume de estoque já criado.
Utilização e Consulta de Registros da Tipificação de Pescados
Localizar uma ordem de produção
Para localizar uma ordem de produção já lançada, o operador usa o campo de busca textual na tela inicial de ordens de produção de pescados, que filtra pela ordem/pedido ou pela chave de fato do documento. Não há outros filtros adicionais descritos para essa lista além da busca textual.
Consultar peixes já tipificados
Depois que uma ordem é aberta na tela de tipificação, o operador pode consultar, a qualquer momento, os peixes já tipificados naquela ordem: primeiro escolhe um produto na tabela de produtos tipificados (que reúne os produtos distintos já lançados naquela ordem) e, em seguida, a tabela de peixes tipificados é preenchida automaticamente somente com os volumes daquele produto, do mais recente para o mais antigo. Antes de escolher um produto, a tabela de peixes tipificados fica vazia com o aviso “Selecione um produto acima”. Volumes que já fazem parte de um kit não aparecem nessa lista de consulta.
Ações disponíveis sobre um volume já lançado
A partir da tabela de peixes tipificados, o operador tem duas ações disponíveis sobre um volume já lançado:
Reimprimir a etiqueta
O aplicativo pergunta “Deseja enviar para reimpressão?” com o aviso “Ao confirmar será enviado para reimpressão”. Ao confirmar, o sistema busca novamente os dados de impressão daquele volume e os envia para a impressora térmica configurada no posto de trabalho do usuário logado. Se o envio for bem-sucedido, aparece uma notificação temporária de 3 segundos “Enviado para reimpressão”; se falhar, aparece o aviso “Ocorreu um erro ao enviar para reimpressão”. Se o servidor não conseguir buscar os dados de impressão, o sistema mostra um erro com a mensagem devolvida pelo próprio servidor.
Excluir a tipificação de um volume
Descrita em detalhes na seção 7, a seguir, já que se trata da única forma de “desfazer” um lançamento feito incorretamente.
Processo de Edição da Tipificação de Pescados
⚠️ Restrição operacional: A Tipificação de Pescados não permite editar diretamente os dados de um peixe já tipificado (não é possível abrir um volume já criado e alterar o peso, a identificação, o produto ou as classificações registradas). Isso ocorre porque, ao confirmar a tipificação, o sistema já gera o volume de estoque, o item de romaneio vinculado e a etiqueta correspondente — ou seja, o registro passa a fazer parte do controle de estoque do frigorífico.
A única forma de corrigir um lançamento feito incorretamente é excluir a tipificação daquele volume e lançar o peixe novamente do zero. A exclusão é feita a partir da tabela de peixes tipificados (seção 6) e segue estas regras:
Procedimento de exclusão
- Confirmação obrigatória: O operador solicita a exclusão e o sistema pede confirmação com “Deseja excluir o volume?” e o aviso “Esta ação irá remover o registro do banco”.
- Validação local: Antes de enviar o pedido ao servidor, o aplicativo verifica localmente se o código do volume e a chave de fato do documento não estão vazios; se algum estiver vazio, a exclusão é cancelada sem nem chegar a consultar o servidor.
- Verificação de romaneio: Se não existir romaneio de destino vinculado à ordem, a exclusão é recusada com “falha ao localizar o romaneio de destino do documento {chave}”.
- Volumes reservados para kit: Se o volume estiver reservado para a montagem de um kit (mas a montagem ainda não começou), a sugestão de kit é cancelada automaticamente e o volume é apenas marcado como cancelado — o registro do volume é preservado, não é apagado.
- Volumes em processo de montagem: Se o volume já estiver em processo de montagem de um kit, a exclusão é totalmente bloqueada com a mensagem “volume já está em processo de montagem do kit {identificação do kit}”; nesse caso, é necessário resolver a montagem do kit antes de tentar excluir o volume.
- Volumes sem relação com kit: Se não houver nenhuma sugestão de kit associada ao volume, ele é excluído definitivamente (removido do banco, e não apenas marcado como cancelado).
- Erro de integridade do banco: Se o servidor recusar a exclusão por uma restrição de integridade do banco de dados (ou seja, o volume ainda está sendo referenciado por outro registro do sistema), o aplicativo exibe a mensagem amigável “Este volume não pode ser deletado” no lugar da mensagem técnica original.
- Sucesso na exclusão: Ao concluir a exclusão com sucesso, o sistema exibe “Volume {volume} removido” e a lista de peixes tipificados é recarregada automaticamente.
ℹ️ Informação não disponível: Não há, na documentação de origem, registro de um histórico ou log de alterações visível ao operador para consultas posteriores sobre exclusões realizadas — validar com analista responsável.
Estrutura Técnica e Comportamento do Sistema da Tipificação de Pescados
Criação e reaproveitamento do romaneio de saída
Quando o operador seleciona uma ordem de produção, o sistema busca o detalhe do documento de destino daquela ordem e, se necessário, cria automaticamente o documento chamado romaneio de saída de destino — com os mesmos itens da ordem de produção original, porém com as quantidades ainda zeradas (as quantidades reais só vão sendo preenchidas conforme cada peixe é tipificado). Se esse romaneio já existir, mas a ordem tiver itens que ainda não constam nele, os itens que faltam são criados automaticamente dentro do romaneio já existente, sem gerar um documento novo. Ou seja, o romaneio de destino é criado uma única vez por ordem e vai sendo completado com itens novos apenas quando necessário.
Configurações e parâmetros carregados
O sistema também traz, junto com o detalhe do documento de destino, um conjunto de configurações que controlam o comportamento da tela durante a tipificação daquela ordem, entre elas:
- Se é permitido substituir o produto identificado por outro
- Se é permitido alterar a unidade de medida do item
- Se o volume emite etiqueta automaticamente após ser incluído
- Se o sistema bloqueia o lançamento de uma quantidade maior que a prevista (por padrão, bloqueia, a menos que essa trava tenha sido explicitamente desligada na configuração)
- Se o volume de estoque é criado automaticamente após a inclusão
- Se é usado um identificador alternativo para o volume
Além disso, para cada item do documento, o sistema busca as informações de tara e as permissões de repesagem/transformação cadastradas no custo daquele produto na filial; quando não existe custo cadastrado para o produto naquela filial, essas informações ficam em branco e o sistema assume, por padrão, que não é permitido repesar nem transformar o produto.
Sequência de operações na efetivação
Ao efetivar a tipificação de um peixe, o sistema executa, em sequência:
- Verificação de duplicação: Confere se já existe um volume lançado com o mesmo lacre na mesma data de produção do romaneio, recusando o lançamento em caso positivo.
- Criação do volume de estoque: Cria um novo volume de estoque vinculado ao item do romaneio de destino, com as seis classificações informadas, a ocorrência (se houver), o número de lacre, o indicador vivo/morto e o código da combinação aplicada — o status inicial desse volume segue a configuração do tipo de movimento para “status após inclusão” (ou “em estoque”, se nada estiver configurado), e o lote do volume é o lote do item de origem (quando o produto controla lote) ou o lote padrão configurado no sistema (quando não controla).
- Criação do item de romaneio: Cria também um item de romaneio de movimentação vinculado a esse volume, fechando a ligação entre a ordem de produção original, o romaneio de destino e o volume físico gerado.
Geração e retorno da etiqueta
Imediatamente depois de criar o volume, o próprio sistema já monta e devolve os dados da etiqueta de impressão na mesma resposta da tipificação — sem precisar de uma segunda consulta só para buscar a etiqueta. Os dados de impressão incluem a descrição do produto em até 10 idiomas cadastrados, além dos dados da combinação e das classificações do volume; o layout de impressão e a impressora/porta de destino usados são os configurados no cadastro do produto e no posto de trabalho do usuário logado.
Proteção contra reenvio duplicado
O envio da tipificação ao servidor é protegido contra reenvio duplicado por queda de conexão (uma chave de controle garante que o mesmo envio não seja processado duas vezes). Além disso, o aplicativo só considera a tipificação como realmente concluída se a lista de itens de romaneio devolvida pelo servidor vier preenchida — se vier vazia, o aplicativo trata como falha, mesmo que o servidor tenha tecnicamente respondido com sucesso.
Tratamento de erros
Qualquer erro que não tenha um tratamento específico, nas operações de buscar o detalhe do documento, verificar/criar o item no romaneio ou efetivar a tipificação, é devolvido ao aplicativo como um erro de acesso não autorizado, contendo apenas o texto da falha ocorrida — diferente do formato padrão de resposta usado quando a operação dá certo. Toda a comunicação da tipificação de pescados acontece exclusivamente com o sistema ERP — nenhuma etapa dessa funcionalidade depende do serviço de tempo real (Manager).
ℹ️ Informação incompleta: Existe, no aplicativo, um componente de tela relacionado ao detalhamento de classificações que não foi possível confirmar em qual momento do fluxo ele é efetivamente exibido ao operador — validar com analista responsável.
Regras de Negócio e Restrições da Tipificação de Pescados
Ordem de produção precisa estar atualizada
A tipificação de uma ordem só é liberada depois que a produção daquela ordem estiver contabilmente atualizada no ERP. Enquanto isso não ocorrer, o sistema recusa o acesso com “ordem de produção não atualizada, atualize a ordem de produção”.
Documento de destino não pode estar atualizado durante a tipificação
Enquanto os peixes de uma ordem estão sendo tipificados, o documento de destino (romaneio de saída) precisa permanecer com o status contábil ainda não confirmado. Se esse documento for atualizado antes de a ordem ser totalmente tipificada, o acesso à tela é bloqueado com “O documento {documento} já foi atualizado”.
Romaneio de destino único por ordem
O sistema cria o romaneio de saída de destino apenas uma vez para cada ordem de produção; nas tipificações seguintes daquela mesma ordem, o romaneio existente é reaproveitado, sendo apenas complementado automaticamente com itens que ainda não constem nele.
Lacre não pode se repetir na mesma data
Não é permitido lançar dois volumes com o mesmo número de lacre na mesma data de produção do romaneio de destino; se isso for tentado, o sistema recusa com “já existe volume lançado com o número de lacre {lacre} em {data}”.
Cálculo da combinação de tipificação
O sistema procura, entre as combinações cadastradas, a primeira cuja lista de códigos aceitos contemple o código escolhido em cada critério de classificação que exista para o produto identificado; critérios que não existem para aquele produto são considerados automaticamente atendidos. A comparação dos códigos não diferencia maiúsculas de minúsculas.
Combinação padrão “X” como alternativa
Se nenhuma combinação cadastrada corresponder às classificações informadas, o sistema procura a combinação cadastrada com o código padrão “X”. Se nem essa existir, exibe o aviso “Não foi possível localizar a combinação padrão com código X” e a tipificação não prossegue até que uma combinação válida seja encontrada.
Momento em que a combinação é calculada
Se o parâmetro de peso no início estiver ativado, o sistema tenta calcular a combinação já na etapa de ocorrência (quando todos os dados já estão completos); se estiver desativado, o cálculo só é tentado na etapa de peso, e o operador só avança para a confirmação final se uma combinação válida for obtida.
Substituição automática de produto
Quando a combinação encontrada tem um produto de substituição cadastrado e a opção “substitui ao tipificar” está marcada para essa combinação, o produto originalmente identificado é automaticamente substituído pelo produto da combinação antes de a tipificação ser efetivada — o produto realmente lançado no estoque pode, portanto, ser diferente do produto que o operador digitou ou bipou no início.
Peso líquido igual ao peso bruto
O peso informado pelo operador é usado tanto como peso líquido quanto como peso bruto do volume gerado; se o valor informado não puder ser interpretado como um número, ele é tratado como zero.
Produtos substitutos precisam ter critério cadastrado
Só aparecem, na lista de produtos disponíveis para substituição, produtos que tenham ao menos um critério de tipificação cadastrado; produtos sem nenhum critério configurado nunca são oferecidos como opção de substituição.
Classificações inativas nunca aparecem como opção
Um código de classificação marcado como inativo no cadastro nunca aparece nas listas de opções da tela, mesmo que já tenha sido usado em tipificações anteriores.
Consulta de peixes tipificados exclui volumes de kit
A lista de peixes tipificados exibida na tela exclui automaticamente qualquer volume que já faça parte de um kit.
Texto da combinação impresso na etiqueta
O texto da combinação impresso na etiqueta é montado como “{código da combinação} =” seguido do código de cada classificação cadastrada para aquele produto (sashibo, cauda, frescor, gordura, sangue ou textura, conforme o caso), na mesma ordem em que os critérios estão cadastrados para o produto.
Resposta da tipificação só é válida com itens de romaneio
Mesmo que o servidor responda com sucesso técnico, o aplicativo só considera a tipificação como efetivamente concluída se a lista de itens de romaneio devolvida na resposta vier preenchida; se vier vazia, é tratada como falha.
Critérios de classificação habilitados conforme cadastro do produto
Cada tipo de critério (sashibo, frescor, sangue, textura, cauda ou cobertura de gordura) só aparece na sequência da tela se estiver cadastrado como ativo para o produto identificado, respeitando a ordem cadastrada para aquele produto; um produto sem nenhum critério cadastrado pula direto para a etapa de ocorrência.
Regras de exclusão de um volume tipificado
A exclusão de um peixe já tipificado depende do estado do volume: se estiver apenas reservado para um kit, a reserva é cancelada e o volume é marcado como cancelado (preservando o registro); se já estiver em processo de montagem de um kit, a exclusão é bloqueada com “volume já está em processo de montagem do kit {identificação do kit}”; se não houver nenhuma relação com kit, o volume é excluído definitivamente; e se o banco de dados recusar a exclusão por o volume ainda estar referenciado em outro registro, o sistema exibe “Este volume não pode ser deletado”.
Erros não tratados não seguem o formato padrão de mensagens
Qualquer erro não tratado ao buscar o detalhe do documento, verificar/criar item no romaneio ou efetivar a tipificação é devolvido de um jeito diferente das mensagens de negócio normais da tela, contendo apenas o texto da falha ocorrida.
Tipificação de pescados só conversa com o ERP
Toda a comunicação desta funcionalidade acontece exclusivamente com o sistema ERP; nenhuma parte da tipificação de pescados depende do serviço de tempo real (Manager).
Proteção contra reenvio duplicado
O envio da confirmação de tipificação é protegido por um controle interno que evita que o mesmo lançamento seja processado duas vezes caso a conexão do aparelho caia e o operador tente novamente.
Documento gerado automaticamente — Tipificação de Pescados para Frigosoft Coletor