• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • Frigosoft
    • Coletor
      • Teste de Leitor e Coletores Homologados
      • abate
        • Abate de Emergência
        • Aspersão
        • DIF — Declaração de Inspeção Federal
        • Endereçamento de Carcaças
        • Evidências
        • Ocorrências
        • Rastreamento do Abate
        • Registro de pH
        • Tipificação
        • Condenação de Carcaça
      • estocagem
        • Paletização Simples
        • Paletização com Documento
        • Reimpressão Pallet Pré-Impresso
      • expedicao
        • Devolução
        • Devolução de Compra
      • producao
        • Montagem de Kit
      • pescados
        • Geração de Pedido de Pescados
        • Tipificação de Pescados
      • Apontamento de Fracionados
      • Rastreamento 01
        • Bloqueio Quantidade
        • Leitura D.I.A
    • Procedimentos Frigosoft
      • Balanção
      • Configuração Filial
      • Configurações de Tipo de Movimento
      • Fluxo
      • Contrato de Compra
    • Inventário de Estoque
      • Inventário de Meia Carcaça
      • Inventário por Local
      • Inventário por Produto
      • Inventário Rotativo
      • Inventário Total
      • Unificação de Inventário
Nenhum resultado encontrado
Inteligência Atak / Documentação / Frigosoft / Coletor / producao

Montagem de Kit

Criado por Igor Ribeiro em 17 de junho de 2026
•
Atualizado por Igor Ribeiro em 12 de novembro de 2026
Documentação Técnica

Montagem de Kit — Produção (FrigosoftColetor)

A funcionalidade de Montagem de Kit permite ao operador do módulo Produção reunir, em um único volume “pai”, um conjunto de volumes já existentes no estoque (volumes de composição), formando um novo item — o kit.

01. VISÃO GERAL

Visão Geral

A funcionalidade de Montagem de Kit permite ao operador do módulo Produção reunir, em um único volume “pai”, um conjunto de volumes já existentes no estoque (volumes de composição), formando um novo item — o kit. O operador escaneia os volumes de composição um a um; o sistema valida cada leitura, soma os pesos ao volume pai e, ao final, gera um novo volume de kit com etiqueta própria, pronto para seguir para as etapas seguintes de estoque e expedição.

O processo se encaixa depois da produção individual dos itens que vão compor o kit (esses itens já precisam existir como volumes no estoque, com código de barras próprio) e antes do fluxo de estocagem/expedição, já que o volume de kit gerado passa a ser um item de romaneio do documento do dia e fica disponível para movimentações posteriores (armazenagem, reserva para expedição, etc.).

O módulo Produção compartilha toda a base de regras e de tela com o módulo Pescados — ambos usam a mesma estrutura de volumes do estoque e a mesma lógica de apontamento, remoção, finalização e cancelamento de kit — mas têm comportamentos importantes diferentes, descritos ao longo deste manual e destacados na seção Troubleshooting:

  • No módulo Produção, o operador escolhe manualmente o produto pai do kit antes de começar a leitura dos volumes; no Pescados, o produto pai é derivado automaticamente a partir do primeiro volume lido.
  • No módulo Produção, existe uma validação adicional de “ficha de composição” que restringe quais produtos podem compor o kit.
  • No módulo Produção, o produto do volume pai não é recalculado automaticamente após cada leitura (no Pescados, sim).
  • No módulo Produção, a verificação de peso máximo da caixa (tara) nunca é aplicada, porque depende de uma sugestão de kit reservada que este módulo nunca cria — esse controle só existe efetivamente no Pescados.
  • No módulo Produção, duas falhas de implementação conhecidas afetam a experiência do operador: o cancelamento de kit é processado, por engano, pela lógica do módulo Pescados (ver Troubleshooting), e o diálogo de confirmação para “sequência de kit diferente” ou “peso excedente” nunca aparece nas raras situações em que essas condições chegam a ser avaliadas para um kit de Produção (ver Troubleshooting).

A tela é única, dividida em áreas: seleção do produto pai do kit, leitura dos volumes de composição, dados do kit em montagem (produto pai, responsável, totais), e uma tela secundária de listagem “Kits Criados”, com abas Finalizados e Pendentes.

02. PRÉ-REQUISITOS

Pré-requisitos

  1. Documento do dia (romaneio) da filial deve poder ser obtido ou criado. Ao abrir a Montagem de Kit do módulo Produção, o aplicativo busca o documento de entrada do dia da filial para a data de movimentação corrente, usando o perfil de movimento PCP0306. Se não existir nenhum documento do dia, o sistema tenta criar um novo automaticamente, obtendo uma nova chave e a série/número de sequência ativa cadastrada para esse tipo de documento na filial. Documentos criados posteriormente no mesmo dia/filial reutilizam esse mesmo documento (padrão “documento do dia”).
  • Se não estiver atendido: se não existir tipo de movimento configurado para o perfil PCP0306 na filial, a criação falha com “Falha ao localizar um tipo de movimento com o perfil {perfil}”; se não existir sequência de numeração ativa cadastrada para o documento/filial, falha com “Falha ao localizar uma sequência ativa para o documento {documento} na filial {filial}”. Em ambos os casos a tela não consegue carregar.
  1. Produtos habilitados para montagem de kit devem existir no cadastro. Somente produtos cadastrados com o atributo de composição igual a “K” aparecem na lista de seleção de produto pai. Essa lista é a mesma para os módulos Produção e Pescados (não é filtrada por módulo).
  • Se não estiver atendido: a lista de seleção de produto pai fica vazia e o operador não consegue iniciar a montagem de um novo kit.
  1. Sessão do operador deve identificar o funcionário responsável e a filial corrente. Essas informações são usadas para: identificar de quem são os kits pendentes ao abrir a tela, gravar o funcionário responsável no kit e filtrar a listagem de kits pela filial selecionada.
03. FLUXO OPERACIONAL

Fluxo Operacional

  1. O operador acessa a Montagem de Kit pelo menu do módulo Produção. O sistema obtém (ou cria) o documento do dia da filial e carrega automaticamente a lista de kits do dia (finalizados e pendentes).
  2. Cerca de 800ms depois da tela ser exibida, se o operador logado já tiver algum kit com status Pendente sob sua própria responsabilidade, o sistema exibe o aviso “Existem kits pendentes de finalização, favor verificar a lista de kits criados no dia.” com os botões “ok” e “Visualizar lista”. Ao confirmar “Visualizar lista”, o operador é levado à listagem já filtrada para Pendentes, podendo retomar um kit em andamento.
  3. Para iniciar um novo kit, o operador seleciona explicitamente o produto pai em uma lista de produtos habilitados para montagem de kit (produtos com atributo de composição “K”). O sistema pergunta “Deseja realmente criar um kit para o produto {código.referência-nome}” (sem ponto de interrogação) antes de efetivamente criar o volume pai.
  4. Confirmada a criação, o sistema cria o volume pai do kit com o produto/referência selecionado, já marcado como pertencente ao módulo Produção.
  5. O operador escaneia, um a um, os volumes que vão compor o kit. Cada leitura passa por uma sequência de validações (vínculo a outro kit, ficha de composição do produto pai, sequência de kit, peso da caixa) antes de ser somada ao kit. A cada leitura concluída com sucesso, o sistema emite um bipe de sucesso; em caso de rejeição, um bipe de erro e a mensagem correspondente.
  6. Se necessário, o operador pode remover um volume já lido da composição do kit, desde que o kit pai ainda esteja em processo. Os pesos do volume removido são subtraídos dos totais do kit pai.
  7. Quando a composição estiver completa, o operador aciona “Gerar Kit” para finalizar. O sistema vincula o volume pai e todos os volumes de composição como itens do documento do dia, atualiza o status do volume pai, gera a etiqueta do kit, envia automaticamente para o serviço de impressão do coletor e reinicia a tela, exibindo a mensagem “Kit gerado com sucesso!\nVolume criado para o KIT:” seguida do código de barras do novo volume.
  8. Alternativamente, o operador pode cancelar o kit em montagem a qualquer momento (botão Cancelar Kit), tanto antes de finalizar quanto depois de já ter finalizado um kit (via tela de listagem); o sucesso é confirmado com “Kit cancelado com sucesso”.
  9. Na tela de listagem “Kits Criados” (abas Finalizados/Pendentes), o operador pode reimprimir a etiqueta de um kit finalizado (mediante confirmação prévia), retomar um kit pendente (voltando a editá-lo na tela principal) ou remover um kit já criado (mediante confirmação “Deseja realmente remover o kit?”).
04. INTERFACE E COMPORTAMENTOS DO APP

Interface e Comportamentos do App

Na tela de Montagem de Kit do módulo Produção, a interface se organiza em áreas para seleção do produto pai, leitura dos volumes de composição, dados do kit em montagem e uma tela secundária de listagem dos kits já criados.

Documento do dia na tela principal da Montagem de Kit de Produção

No topo da tela principal, um cartão exibe o documento (romaneio) de montagem de kit do dia com os campos “Romaneio: {número do pedido}” e “Data de Carregamento: {data formatada no padrão brasileiro}”. Enquanto o documento ainda está sendo carregado, o cartão exibe “Carregando Romaneio de Montagem de Kit…”; se a carga terminar sem nenhum documento retornado, exibe “Nenhum Romaneio para Montagem de Kit encontrado!”.

Botões e menu da tela principal da Montagem de Kit de Produção

  • Os botões “Cancelar Kit” e “Finalizar” ficam desabilitados sempre que não existe um kit atualmente em edição (kit pai ainda não criado); só ficam habilitados quando há um kit em edição.
  • O menu de opções (ícone de contexto) da tela tem duas opções: “Atualizar” (habilitada somente quando há um kit em edição; recarrega do zero os dados desse kit) e “Kits Criados” (sempre disponível; abre a tela de listagem, por padrão na aba Finalizados).

Seleção do produto pai do kit (módulo Produção)

  • Lista de produtos disponíveis exibida no formato “{código do produto}.{referência}-{nome do produto}” (espaços removidos das pontas de cada parte).
  • Ao selecionar um produto da lista, o sistema pergunta “Deseja realmente criar um kit para o produto {código.referência-nome}” antes de criar o volume pai (sem ponto de interrogação).
  • No módulo Produção esta seleção é sempre manual e obrigatória antes de qualquer leitura de volume de composição. No módulo Pescados não existe essa etapa: o produto pai é derivado automaticamente a partir do primeiro volume lido.
  • Se o campo de leitura de volume de composição for submetido vazio (sem digitar/bipar nada), o sistema exige “Informe um código válido” e não envia a leitura.

Dados do kit em montagem (Montagem de Kit de Produção)

Este bloco só aparece quando já existe um volume pai criado. Os rótulos exibidos são “Volume Kit”, “Produto Kit” e “Total Kit”.

  • Produto do kit pai exibido no formato “{código.referência}-{nome do produto}”.
  • Funcionário responsável exibido no formato “{código do funcionário}-{nome do funcionário}”.
  • Totalizador do kit exibido no formato “{peso total em Kg, 2 casas decimais} Kg / {quantidade de volumes} un.” — o peso total é recalculado pelo aplicativo como a soma do peso bruto de cada volume de composição já lido em tela (não usa o peso bruto do volume pai vindo do servidor).
  • Cada volume de composição listado (ordenado de forma decrescente pelo código de barras) exibe: produto no formato “{código.referência}-{nome}” (sem remover espaços do nome), código de barras do volume, peso líquido (2 casas decimais) e número de lacre; cada item tem um botão para excluir aquele volume da composição do kit.

Tela de listagem “Kits Criados” da Montagem de Kit de Produção

  • Dividida em duas abas: Finalizados (kits cujo volume pai não está mais na situação Pendente) e Pendentes (kits cujo volume pai ainda está na situação Pendente). Cada aba exibe a contagem de itens entre parênteses no título do filtro.
  • Kits (e, dentro de cada kit, os volumes de composição) são ordenados de forma decrescente pelo código de barras.
  • O título da tela inclui a data de movimentação formatada no padrão brasileiro (dd/mm/aaaa hh:mm) e um ícone de atualização manual que recarrega a lista de kits do dia.
  • Lista vazia exibe a mensagem “Nenhum Kit encontrado”.
  • A consulta usada para montar esta listagem filtra por: filial (a informada ou, se vazia, a filial atualmente selecionada), produto, código de combinação, faixas de peso do kit e dos volumes, intervalo de datas e número de lote — ver Regras de Negócio para o alcance de cada filtro.

Cartão de cada kit na tela “Kits Criados” (Montagem de Kit de Produção)

  • Cada kit exibe: Volume (código de barras do volume pai), Produto (formato “{código.referência}-{nome}”), Peso (peso bruto do volume pai, 2 casas decimais — não o peso líquido), Quantidade (número de volumes de composição) e Funcionário (formato “{código}-{nome}”).
  • O botão de expandir o kit tem o rótulo “Kit sem volumes” quando não há volumes de composição, ou “Volumes do kit” caso contrário.
  • O botão “Cancelar Kit” aparece em ambas as abas, disparado após o operador confirmar “Deseja realmente remover o kit?” — a remoção segue a mesma regra de cancelamento do kit (ver Regras de Negócio e Troubleshooting).
  • A aba Finalizados exibe também o botão “Impressão” (reimpressão da etiqueta); a aba Pendentes exibe, no lugar, o botão “Retomar”, que recarrega aquele kit como o kit atualmente em edição na tela principal.

Detalhe de cada volume de composição expandido na tela “Kits Criados” (Montagem de Kit de Produção)

Cada volume de composição, ao expandir o kit, exibe: Lacre (somente se preenchido), Peso (peso bruto do volume de composição, 2 casas decimais), Lote (somente se preenchido), Volume (código de barras), Combinação e Produto. O campo Combinação concatena, na ordem Gordura, Sashibo, Frescor, Textura, Cauda e Sangue, os códigos não vazios do volume (após remover espaços das pontas): o primeiro código não vazio encontrado é exibido prefixado por “{código de combinação}=”, os demais são apenas concatenados com espaço; se nenhum estiver preenchido, o campo fica vazio.

Diferenças de comportamento entre Produção e Pescados na Montagem de Kit

ComportamentoProduçãoPescados
Escolha do produto paiManual, antes da leituraAutomática, a partir do 1º volume lido
Validação de ficha de composiçãoSim, se o produto pai tiver ficha cadastradaNão se aplica
Exigência de sugestão de kit reservada para o volume lidoNão se aplicaSim, obrigatória
Limite de peso da caixa (tara) no apontamentoNão se aplica — nunca é verificado, pois depende da sugestão de kit reservada, que este módulo não usaAplicado sempre que a sugestão do volume tiver caixa cadastrada
Recalculo automático do produto do pai após apontamento/remoçãoNão ocorreOcorre (produto de maior peso líquido total)
Cancelamento de kitProcessado, por engano, pela lógica do módulo Pescados (falha de implementação — ver Troubleshooting)Processado pela lógica do próprio módulo Pescados
Diálogo de confirmação de sequência divergente / peso excedenteNunca aparece (falha de implementação — ver Troubleshooting)Aparece normalmente
05. LEITURAS DE CÓDIGO DE BARRAS

Leituras de Código de Barras

Na Montagem de Kit do módulo Produção, a leitura de volumes de composição é o principal mecanismo de entrada de dados da tela (scanner-first). Toda identificação de volume lida nesta feature (volume pai ou volume de composição, seja para apontar, remover ou cancelar) aceita dois formatos: se o texto lido tiver exatamente 12 caracteres, é interpretado como o código de barras completo do volume; caso tenha qualquer outro tamanho, o sistema busca o volume pelo número de lacre igual ao texto lido — havendo mais de um volume com o mesmo lacre, usa o mais recente. Ou seja, o operador pode bipar tanto o código de barras quanto o número de lacre do volume.

Cada leitura de volume de composição passa, na ordem, pelas seguintes validações antes de ser aceita:

  1. Volume pai existente: ao apontar em um kit já criado, o volume pai precisa ser localizado pela identificação informada; se não for encontrado, a leitura é rejeitada.
  2. Status do volume pai: o volume pai precisa estar no status “Em Processo” para aceitar novos volumes de composição; caso contrário, a leitura é rejeitada.
  3. Volume de composição existente: o volume lido precisa corresponder a um volume real do estoque; se a identificação informada não corresponder a nenhum volume, a leitura é rejeitada.
  4. Volume já vinculado a outro kit: se o volume lido já está vinculado a outro volume pai, a leitura é rejeitada.
  5. Ficha de composição (somente Produção): se o produto pai possuir uma ficha de composição cadastrada, o produto do volume lido só é aceito se constar entre os itens dessa ficha. Se o produto pai não tiver ficha cadastrada, qualquer produto pode compor o kit.
  6. Sugestão de kit reservada (somente Pescados): o volume lido precisa estar associado a uma sugestão de kit reservada, com status Reservado; essa exigência não existe no módulo Produção.
  7. Sequência de kit (na prática, só se manifesta no Pescados): se o volume lido pertencer a uma sequência de kit diferente da já usada pelos volumes do kit pai, e o operador ainda não confirmou a divergência, a leitura é interrompida e solicitada confirmação. Como o módulo Produção nunca tem uma sugestão de kit reservada associada aos seus volumes, essa comparação nunca encontra divergência nele — só o Pescados é afetado na prática.
  8. Peso da caixa (tara) — exclusivo do Pescados: esta verificação só é avaliada quando existe uma sugestão de kit reservada vinculada ao volume lido, o que só ocorre no módulo Pescados. Quando avaliada, se a soma dos pesos brutos ultrapassar a capacidade máxima cadastrada para a caixa vinculada à sugestão, a leitura é bloqueada ou solicita confirmação, dependendo do parâmetro de configuração (ver Regras de Negócio). No módulo Produção esta verificação nunca é executada — não há limite de peso de caixa aplicado ao apontamento de kit de Produção.

Leitura válida e aceita: os pesos do volume lido são somados ao volume pai e o sistema emite um bipe de sucesso. Leitura rejeitada: o sistema emite um bipe de erro e exibe a mensagem correspondente (ver Feedbacks ao Operador e Troubleshooting).

06. FEEDBACKS AO OPERADOR

Feedbacks ao Operador

Feedbacks — abertura da tela e criação do kit

SituaçãoFeedbackTexto exato
Operador seleciona um produto da lista para criar o kit paiDiálogo de confirmação“Deseja realmente criar um kit para o produto {código.referência-nome}” (sem ponto de interrogação)
Operador tem kit(s) pendente(s) sob sua responsabilidade, ~800ms após abrir a telaDiálogo de confirmação“Existem kits pendentes de finalização, favor verificar a lista de kits criados no dia.” (botões “ok” e “Visualizar lista”)
Falta o tipo de movimento configurado para o perfil PCP0306 na filialMensagem de erro (tela não carrega)“Falha ao localizar um tipo de movimento com o perfil {perfil}”
Falta a sequência ativa cadastrada para o documento/filialMensagem de erro (tela não carrega)“Falha ao localizar uma sequência ativa para o documento {documento} na filial {filial}”
Falha ao gravar o novo volume pai do kit, mesmo após todas as validações anteriores passaremMensagem de erro“Falha ao criar volume kit pai”

Feedbacks — leitura de volumes de composição

SituaçãoFeedbackTexto exato
Leitura de volume aceita e apontada com sucessoBipe sonoro de sucesso—
Leitura de volume rejeitada (qualquer motivo)Bipe sonoro de erro + mensagemmensagem correspondente à validação (ver linhas abaixo)
Volume pai informado não é encontrado (apontando em kit já existente)Mensagem de erro“Falha ao obter o volume com identificação {volume}”
Volume pai não está no status esperado ao tentar apontarMensagem de erro“Volume kit pai {volume} não possui o status esperado, status atual {status atual}, status esperado {status esperado}.”
Produto/referência escolhido não existe no cadastro (fluxo Produção, criação do kit pai)Mensagem de erro“Falha ao obter o produto com identificação {código}.{referência}.”
Nenhum produto e nenhum volume informados na criação do kit paiMensagem de erro“Volume ou Produto não informado”
Produto do volume lido não consta na ficha de composição do produto pai (somente Produção)Mensagem de erro“O produto {código.referência do produto lido} não faz parte da composição da ficha de produção do kit {código.referência do produto pai}.”
Volume lido já vinculado a outro kitMensagem de erro“Volume com identificação {volume} já esta vinculado ao kit {kit}” (grafia literal do sistema, sem acento em “esta”)
Volume lido sem sugestão de kit reservada (somente Pescados)Mensagem de erro“Não foi possível encontrar uma sugestão kit para o volume com identificação {volume}”
Sequência de kit divergente detectada (na prática só ocorre no Pescados — ver Troubleshooting)Diálogo de confirmação“O volume lido possui uma sequência Kit diferente dos volumes na caixa.\n\n Sequência lida: {sequência do volume lido}\n Sequência na caixa {sequência do kit} \n\nDeseja Continuar?”
Peso excedente detectado e parâmetro ERP 11009 = “S” (exclusivo do Pescados — ver Troubleshooting)Diálogo de confirmação“Apontamento do volume {volume} excede o permitido do kit, o peso do kit ({peso do kit} Kg) mais o peso do volume ({peso do volume} Kg) totaliza {total} Kg, oque excede o limite da caixa {tara}-{descrição da tara} cujo limite é de {limite} Kg Deseja continuar?” (grafia literal do sistema, sem espaço em “oque” e concatenado sem espaço com “Deseja continuar?”)
Peso excedente detectado e parâmetro ERP 11009 diferente de “S” (exclusivo do Pescados)Mensagem de erro (bloqueio definitivo)“Falha ao realizar apontamento do volume {volume}, o peso do kit ({peso do kit} Kg) mais o peso do volume ({peso do volume} Kg) totaliza {total} Kg, oque excede o limite da caixa {tara}-{descrição da tara} cujo limite é de {limite} Kg ” (grafia literal do sistema)

Feedbacks — remoção de volume da composição

SituaçãoFeedbackTexto exato
Volume pai informado não é encontradoMensagem de erro“Não foi possivel encontrar o volume kit pai {volume}” (grafia literal do sistema, sem acento em “possivel”)
Tentativa de remover volume de kit que não está “Em Processo”Mensagem de erro“Não é possível remover volumes de um kit que não esteja em processo, status atual do volume {status atual}, status permitido do volume {status permitido}.”
Volume de composição informado não é encontradoMensagem de erro“Não foi possivel encontrar o volume {volume}” (grafia literal do sistema, sem acento em “possivel”)
Tentativa de remover volume que não pertence ao kit pai informadoMensagem de erro“O volume {volume} não está vinculado ao volume kit pai {kit pai}.”
Remoção de volume em processamentoOverlay de carregamento“Processando…”

Feedbacks — finalização do kit

SituaçãoFeedbackTexto exato
Documento do dia não pôde ser obtido/criado no momento da finalizaçãoMensagem de erro“Falha ao obter documento para montagem de kit”
Volume pai informado não é encontrado ao finalizarMensagem de erro“Falha ao obter volume kit pai”
Finalização do kit com volume(s) em status inválidoMensagem de erro“Existem volumes com status inválido, status lido: {status lido}, status permitido: {status permitido}.”
Finalização do kit concluída com sucessoMensagem de sucesso“Kit gerado com sucesso!\nVolume criado para o KIT:” seguido do código de barras do volume pai recém-criado
Falha ao enviar a etiqueta do kit recém-gerado para a impressora (a finalização já foi efetivada)Mensagem de erro“Erro durante o envio para impressão.” seguido do detalhe técnico do erro

Feedbacks — cancelamento e remoção de kit

SituaçãoFeedbackTexto exato
Cancelamento de kit já finalizado com volume já reservado para expediçãoMensagem de erro (bloqueio)“Falha ao remover kit, existem volumes do kit que já estão reservados para uma expedição.”
Cancelamento concluído com sucesso (tela principal ou listagem)Mensagem de sucesso“Kit cancelado com sucesso”
Operador aciona remover/cancelar kit na tela de listagemDiálogo de confirmação“Deseja realmente remover o kit?”

Feedbacks — reimpressão de etiqueta

SituaçãoFeedbackTexto exato
Operador aciona a reimpressão de um kit finalizadoDiálogo de confirmaçãoTítulo “Deseja enviar para impressão?”, mensagem “Ao confirmar será enviado para Impressão”
Reimpressão em processamentoOverlay de carregamento“Enviando para Impressao”
Reimpressão de etiqueta concluída com sucessoMensagem de sucesso“Enviado para impressão com Sucesso!”
Reimpressão de etiqueta falhouMensagem de erro“Ocorreu um erro ao enviar para Impressão”
07. REGRAS DE NEGÓCIO

Regras de Negócio

Produto pai e composição do kit (Montagem de Kit de Produção)

  1. Produto pai do kit: só pode ser escolhido entre produtos cadastrados com atributo de composição igual a “K”. A lista não é filtrada por módulo — é a mesma usada pelo Pescados.
  2. Ficha de composição (exclusiva do Produção): se o produto pai possuir ficha de composição cadastrada, somente produtos constantes nessa ficha podem compor o kit. Se o produto pai não tiver ficha cadastrada, qualquer produto pode compor o kit. O Pescados nunca aplica esta validação.

Identificação de volumes e cálculo de pesos (Montagem de Kit de Produção)

  1. Identificação de volumes por número de lacre: qualquer leitura de identificação de volume nesta feature (volume pai ou de composição, para apontar, remover ou cancelar) que não tenha exatamente 12 caracteres é tratada como número de lacre em vez de código de barras; havendo mais de um volume com o mesmo lacre, prevalece o de maior número de volume (mais recente).
  2. Cálculo dos pesos do kit pai: a cada apontamento aceito, os pesos bruto e líquido (nominal e real) do volume pai = pesos atuais do volume pai + pesos do volume lido. A cada remoção, os pesos do volume pai = pesos atuais do volume pai – pesos do volume removido (peso bruto, peso líquido, peso bruto real e peso líquido real).
  3. Herança de lote: se o lote do volume pai ainda for o valor padrão definido pelo parâmetro de configuração do ERP de código 177, e o volume lido tiver lote diferente, o lote do volume pai passa a ser o lote do volume lido no apontamento.
  4. Limite de peso da caixa (tara) e parâmetro ERP 11009 (exclusivo Pescados): esta regra só é avaliada quando o volume lido tem uma sugestão de kit reservada vinculada — na prática, exclusiva do módulo Pescados, já que o módulo Produção nunca gera esse tipo de sugestão. Quando avaliada e a soma dos pesos brutos ultrapassa a capacidade máxima cadastrada da caixa vinculada à sugestão: se o parâmetro de configuração do ERP de código 11009 estiver com valor “S”, o operador pode confirmar e prosseguir mesmo excedendo o limite; com qualquer outro valor, o apontamento é definitivamente bloqueado. Kits do módulo Produção não têm limite de peso de caixa aplicado.
  5. Recalculo automático do produto pai (exclusivo Pescados): após cada apontamento ou remoção, o produto do volume pai passa a ser o produto de maior peso líquido total somado entre os volumes que compõem o kit. No Produção, o produto do pai nunca muda automaticamente.
  6. Ao remover um volume de composição, se existir uma sugestão de kit reservada em status Montagem vinculada a esse volume, ela é cancelada e volta a ficar disponível para ser processada novamente (exclusivo Pescados — o módulo Produção nunca associa sugestão de kit reservada aos seus volumes).

Status do kit e finalização (Montagem de Kit de Produção)

  1. Status esperado do volume pai: deve ser “Em Processo” para aceitar novos apontamentos ou permitir remoções. Ao finalizar, o status de cada volume de composição precisa ser igual ao status esperado configurado no tipo de movimento do documento.
  2. Status do volume pai após finalização: assume o status configurado como “status após inclusão” do tipo de movimento do documento, ou “Em Estoque” quando esse status não está configurado.
  3. Sugestões de kit “soltas” ao finalizar: se, ao finalizar um kit, existirem outras sugestões de kit com a mesma sequência que ficaram reservadas para um volume pai diferente (por exemplo, por engano do operador ao montar mais de um kit com a mesma sequência), essas sugestões são automaticamente canceladas e voltam para a fila geral de processamento de sugestões.
  4. Cancelamento de kit: se o kit ainda não foi vinculado a nenhum documento (ainda em montagem), cancelar libera todos os volumes de composição, que voltam a poder ser usados em outro kit. Se o kit já foi finalizado (vinculado ao documento do dia), o cancelamento só é permitido enquanto nenhum volume de composição estiver reservado para uma expedição (ver Troubleshooting); sendo permitido, os volumes de composição são removidos do documento e ficam novamente disponíveis.
  5. Conteúdo da etiqueta do kit: inclui somente os volumes de composição cuja sugestão de kit esteja com status “Finalizado”. O layout de impressão usado é o cadastrado para o produto/referência do volume pai.

Listagem “Kits Criados” (Montagem de Kit de Produção)

  1. Abas da listagem: Finalizados reúne os kits cujo volume pai não está mais na situação Pendente; Pendentes reúne os kits cujo volume pai ainda está na situação Pendente.
  2. Ordenação da listagem: decrescente pelo código de barras do volume pai; dentro de cada kit, os volumes de composição também são ordenados de forma decrescente pelo código de barras.
  3. Exclusão de kits reservados/cancelados da listagem: a consulta de listagem de kits (carga automática e tela “Kits Criados”) nunca traz kits com status Cancelado nem kits cujo volume pai já esteja reservado para uma expedição, independentemente de qualquer filtro informado pelo operador.
  4. Alcance dos filtros da listagem: filial, faixa de peso do próprio kit pai e intervalo de datas restringem a consulta diretamente, afetando qualquer kit, inclusive um que ainda não tenha nenhum volume de composição. Já código de combinação, produto, faixa de peso dos volumes de composição e número de lote só se aplicam a kits que já têm pelo menos um volume de composição vinculado — um kit recém-criado sem volumes aparece na listagem independentemente desses quatro filtros. O filtro de produto compara pelo formato “código-referência” (com hífen); tanto ele quanto o de combinação aceitam múltiplos valores separados por barra vertical “|”, bastando que um único volume de composição do kit atenda a um dos valores informados. O filtro de peso dos volumes é satisfeito se pelo menos um volume de composição estiver dentro da faixa informada (não é uma soma).
  5. Indicador de módulo de origem: todo volume pai de kit é gravado com um indicador que identifica se pertence ao módulo Produção ou Pescados, garantindo que a listagem de um módulo nunca misture kits do outro.

Formatos de exibição (Montagem de Kit de Produção)

  1. Produto = “{código}.{referência}-{nome}” (espaços removidos das pontas); funcionário responsável = “{código}-{nome}”; totalizador do kit na tela principal = “{peso total, 2 casas decimais} Kg / {quantidade de volumes} un.” (o peso total é recalculado pelo aplicativo como a soma do peso bruto de cada volume de composição em tela, não é o peso bruto do volume pai vindo do servidor); data do título da listagem = dd/mm/aaaa hh:mm (padrão brasileiro).
08. DOCUMENTOS GERADOS EM SEGUNDO PLANO

Documentos Gerados em Segundo Plano

Documento do dia (romaneio de entrada) da Montagem de Kit de Produção

Tipo: documento de entrada, perfil de movimento PCP0306.

  • Condição de reuso: se já existe um documento do dia para a filial e a data de movimentação corrente, ele é reutilizado (nenhum documento novo é gerado) — este é o padrão “documento do dia” desta feature.
  • Condição de criação: se não existe, o sistema cria automaticamente um novo documento de entrada no momento da abertura da tela, obtendo uma nova chave de identificação e a série/número de sequência ativa cadastrada para esse tipo de documento na filial.
  • Todos os volumes (pai e de composição) de um kit finalizado são lançados como itens/subitens de romaneio dentro deste mesmo documento do dia.

Etiqueta do kit da Montagem de Kit de Produção

Tipo: etiqueta de impressão do volume de kit. Gerada ao finalizar o kit com sucesso (ação “Gerar Kit”) ou por reimpressão manual pela tela “Kits Criados”.

  • Conteúdo: inclui somente os volumes de composição cuja sugestão de kit esteja com status “Finalizado”. O layout de impressão usado é o cadastrado para o produto/referência do volume pai.
  • Se o conteúdo gerado não estiver vazio, a etiqueta é automaticamente enviada ao serviço de impressão do coletor logo após a finalização; a reimpressão busca esse mesmo conteúdo novamente sob demanda.
09. INTEGRAÇÕES

Integrações

Na Montagem de Kit do módulo Produção, a impressora do coletor (serviço de impressão) recebe automaticamente a etiqueta do kit: ao finalizar o kit com sucesso, a etiqueta gerada é enviada automaticamente ao serviço de impressão do coletor, desde que o conteúdo da etiqueta não esteja vazio. A reimpressão, disponível na listagem de kits finalizados, repete esse envio buscando novamente o conteúdo de etiqueta do volume.

10. TROUBLESHOOTING

Troubleshooting

T-01

Tela da Montagem de Kit de Produção não carrega por falta de configuração do documento do dia

Cenário: não existe tipo de movimento configurado para o perfil PCP0306 na filial, ou não existe sequência de numeração ativa cadastrada para o documento/filial.

Mensagem exibida: “Falha ao localizar um tipo de movimento com o perfil {perfil}” (falta o tipo de movimento) ou “Falha ao localizar uma sequência ativa para o documento {documento} na filial {filial}” (falta a sequência); em ambos os casos a tela não consegue carregar.

O que fazer: verificar no ERP se existe um tipo de movimento configurado para o perfil PCP0306 na filial corrente, e se há uma série/sequência de numeração ativa cadastrada para esse tipo de documento nessa filial. Corrigido o cadastro, reabrir a tela.

T-02

Volume pai do kit fora do status esperado ao apontar ou remover volume (Montagem de Kit de Produção)

Cenário: o operador tenta apontar (ou remover) um volume, mas o volume pai não está no status “Em Processo”.

Mensagem exibida: “Volume kit pai {volume} não possui o status esperado, status atual {status atual}, status esperado {status esperado}.”

O que fazer: verificar o status atual do volume pai no ERP. Se o kit já foi finalizado ou cancelado, não é mais possível apontar ou remover volumes dele — é necessário iniciar um novo kit.

T-03

Produto do volume lido fora da ficha de composição do kit (exclusivo Produção)

Cenário: o operador lê um volume cujo produto não consta na ficha de composição cadastrada para o produto pai.

Mensagem exibida: “O produto {código.referência do produto lido} não faz parte da composição da ficha de produção do kit {código.referência do produto pai}.”

O que fazer: confirmar com o responsável técnico/PCP se o produto lido realmente deveria compor esse kit. Se sim, a ficha de composição do produto pai precisa ser atualizada no ERP para incluir esse produto. Se o produto pai não deveria ter restrição de composição, a ficha pode ser removida do cadastro (nesse caso, qualquer produto passa a ser aceito).

T-04

Volume já vinculado a outro kit (Montagem de Kit de Produção)

Cenário: o operador lê um volume que já está vinculado a outro kit.

Mensagem exibida: “Volume com identificação {volume} já esta vinculado ao kit {kit}” (grafia literal do sistema, sem acento em “esta”).

O que fazer: verificar se o volume foi lido por engano (código de barras ou lacre errado) ou se já foi usado em outro kit anteriormente. Se for erro operacional, ler o volume correto.

T-05

Volume lido não é reconhecido pelo sistema (Montagem de Kit de Produção)

Cenário: o operador bipa/digita um código de barras ou número de lacre que não corresponde a nenhum volume existente no estoque.

Mensagem exibida: “Falha ao obter o volume com identificação {identificação}” (apontando em kit já criado) ou “Não foi possivel encontrar o volume {identificação}” (removendo da composição — grafia literal do sistema, sem acento em “possivel”).

O que fazer: conferir se o código de barras ou o número de lacre foi lido corretamente; se o volume realmente não existe no estoque, ele precisa ser produzido/cadastrado antes de compor um kit.

T-06

Peso excedente da caixa bloqueia definitivamente o apontamento (exclusivo Pescados)

Cenário: a soma dos pesos do kit ultrapassa a capacidade da caixa (tara) vinculada à sugestão de kit reservada do volume lido, e o parâmetro de configuração do ERP de código 11009 não está com valor “S”. Esta verificação só é avaliada quando existe uma sugestão de kit reservada associada ao volume — na prática, isso só ocorre no módulo Pescados; o módulo Produção nunca cria esse tipo de sugestão, então nunca chega a esbarrar nesse limite.

Mensagem exibida: “Falha ao realizar apontamento do volume {volume}, o peso do kit ({peso do kit} Kg) mais o peso do volume ({peso do volume} Kg) totaliza {total} Kg, oque excede o limite da caixa {tara}-{descrição da tara} cujo limite é de {limite} Kg ” (grafia literal do sistema).

O que fazer: direcionar o volume para outra caixa/kit com capacidade disponível, ou avaliar com o responsável se o parâmetro ERP 11009 deve ser habilitado para permitir exceções mediante confirmação do operador.

T-07

Volume não pertence ao kit pai informado na remoção (Montagem de Kit de Produção)

Cenário: o operador tenta remover um volume que não pertence ao kit pai informado.

Mensagem exibida: “O volume {volume} não está vinculado ao volume kit pai {kit pai}.”

O que fazer: confirmar se o código de barras lido para remoção é do volume correto e se ele realmente pertence ao kit atualmente em edição.

T-08

Volume de composição com status inválido ao finalizar o kit (Montagem de Kit de Produção)

Cenário: ao finalizar o kit, algum volume de composição está com status diferente do esperado pelo tipo de movimento do documento.

Mensagem exibida: “Existem volumes com status inválido, status lido: {status lido}, status permitido: {status permitido}.”

O que fazer: verificar no ERP o status atual dos volumes de composição. Pode ser necessário reprocessar ou corrigir o status de algum volume antes de tentar finalizar o kit novamente.

T-09

Cancelamento de kit finalizado bloqueado por volume reservado para expedição (Montagem de Kit de Produção)

Cenário: o operador tenta cancelar um kit já finalizado, mas algum volume de composição já está reservado para uma expedição.

Mensagem exibida: “Falha ao remover kit, existem volumes do kit que já estão reservados para uma expedição.”

O que fazer: verificar com a expedição se a reserva pode ser desfeita. Só é possível cancelar o kit depois que nenhum volume de composição estiver mais reservado para expedição.

T-10

Falha ao reimprimir etiqueta de kit finalizado (Montagem de Kit de Produção)

Cenário: a reimpressão de etiqueta de um kit finalizado falha ao enviar para o serviço de impressão.

Mensagem exibida: “Ocorreu um erro ao enviar para Impressão”.

O que fazer: verificar se a impressora do posto de trabalho está ligada, conectada à rede e configurada corretamente. Tentar reimprimir novamente após a verificação.

T-11

Falha ao enviar a etiqueta logo após finalizar o kit (Montagem de Kit de Produção)

Cenário: ao finalizar o kit (Gerar Kit), a etiqueta é gerada mas o envio automático ao serviço de impressão falha; a finalização em si já foi efetivada no servidor.

Mensagem exibida: “Erro durante o envio para impressão.” seguido do detalhe técnico do erro, exibida antes da mensagem de sucesso da finalização.

O que fazer: o kit já foi gerado normalmente (o volume existe e está pronto para as próximas etapas). Reimprimir a etiqueta pela tela “Kits Criados” depois de verificar a impressora do posto de trabalho.

T-12

Tela da Montagem de Kit de Produção quebra ao carregar kit, volume ou item de lista

Cenário: a tela quebra inesperadamente durante o carregamento de um kit, volume ou item de lista, geralmente associada a respostas do servidor com campos ausentes, nulos ou em formato numérico inesperado (peso informado como número inteiro em vez de decimal, por exemplo).

Mensagem exibida: Nenhuma mensagem amigável — falha inesperada da tela.

O que fazer: reportar ao suporte técnico com o horário exato da ocorrência e, se possível, o kit/volume que estava sendo carregado, para que o time técnico possa correlacionar com o log do servidor.

T-13

Confirmação de sequência de kit divergente nunca aparece (teórico no Produção)

Cenário: este cenário depende de o volume lido ter uma sequência de kit divergente da já usada pelo kit em montagem, o que por sua vez depende de uma sugestão de kit reservada — mecanismo que o módulo Produção nunca usa. Na prática esta situação só chega a ocorrer no Pescados. Caso ainda assim ocorresse no Produção: no módulo Pescados o aplicativo exibiria um diálogo de confirmação com o texto completo da divergência de sequência; no módulo Produção esse diálogo nunca apareceria, porque o tratamento dessa situação não foi implementado da mesma forma nos dois módulos — o Produção sempre trata o caso como um erro comum, e não como um pedido de confirmação.

Mensagem exibida: mensagem de erro técnica no formato “ValidacaoSeqKit|NoKit=…|Novo=…” (texto bruto, exibido sem tradução), sem opção de confirmar e prosseguir.

O que fazer: caso o operador de Produção veja essa mensagem técnica, reportar ao suporte — é sinal de que o volume lido carrega uma sequência de kit de origem incomum. Iniciar um novo kit ou confirmar com o PCP qual sequência deve ser usada antes de montar o kit.

T-14

Confirmação de peso excedente nunca aparece mesmo com parâmetro habilitado (teórico no Produção)

Cenário: assim como o T-13, este cenário depende de uma sugestão de kit reservada com caixa cadastrada — mecanismo que o módulo Produção nunca usa (ver T-06); na prática só ocorre no Pescados. Caso ainda assim ocorresse no Produção com o parâmetro ERP 11009 = “S”: no Pescados o aplicativo exibiria o diálogo de confirmação de peso excedente; no Produção esse diálogo nunca apareceria, pelo mesmo motivo técnico do T-13.

Mensagem exibida: mensagem de erro técnica no formato “ValidacaoPeso|Msg=…” (texto bruto, exibido sem tradução), sem opção de confirmar e prosseguir.

O que fazer: reportar ao suporte técnico. Como contorno operacional, avaliar com o PCP se o volume deve ser direcionado a outra caixa/kit com capacidade disponível.

T-15

Cancelamento de kit no módulo Produção é processado pela lógica do Pescados

Cenário: ao acionar “Cancelar Kit” (tanto na tela principal quanto na listagem de kits criados) dentro do módulo Produção, o cancelamento é processado pela lógica de cancelamento do módulo Pescados, e não pela lógica própria de cancelamento do módulo Produção (que existe no sistema, mas nunca é usada por essa tela).

Mensagem exibida: nenhuma mensagem de erro visível para o operador em condições normais — o cancelamento tende a “funcionar” aparentemente, pois a lógica de Pescados processa a mesma estrutura de dados de volume compartilhada entre os módulos.

O que fazer: o comportamento hoje não bloqueia o operador, mas representa um risco silencioso: qualquer mudança futura feita apenas na lógica de cancelamento do Pescados (regra de autorização, nova validação) passará a afetar também o cancelamento de kits de Produção, sem que ninguém perceba essa dependência oculta. O time técnico deve corrigir o aplicativo para usar a lógica de cancelamento própria do módulo Produção, já existente no sistema, e monitorar (via auditoria do ERP) se os cancelamentos de kits de Produção estão sendo registrados com a origem correta.

T-16

Kit finalizado pode reaproveitar item de outro produto quando dois produtos compartilham o mesmo lote (Montagem de Kit de Produção)

Cenário: ao finalizar um kit, o sistema tenta reaproveitar um item já lançado no documento do dia em vez de criar um novo; quando um número de lote é informado, essa busca considera apenas se o lote é igual, sem confirmar se o produto e a referência realmente são os mesmos. Se dois produtos diferentes compartilharem o mesmo número de lote no mesmo documento do dia, o item reaproveitado pode acabar sendo de um produto diferente do esperado.

Mensagem exibida: Nenhuma — a finalização do kit é concluída normalmente, sem qualquer aviso sobre a divergência de produto.

O que fazer: conferir no ERP, após a finalização, se os itens lançados no documento do dia realmente correspondem ao produto de cada kit gerado, especialmente quando dois produtos diferentes usam o mesmo número de lote no mesmo dia. Se identificar um item associado ao produto errado, reportar ao suporte técnico e corrigir o lançamento no ERP.

11. CASOS DE USO

Casos de Uso

Caso 1 — Caminho feliz, kit completo na Montagem de Kit de Produção

O operador acessa a Montagem de Kit no módulo Produção. Seleciona o produto pai “001.010-KIT LINGUIÇA CALABRESA 5KG”. Confirma “Deseja realmente criar um kit para o produto 001.010-KIT LINGUIÇA CALABRESA 5KG”. O sistema cria o volume pai. O operador escaneia 3 volumes de composição (produto “001.010”, 1,8 Kg cada), todos aceitos com bipe de sucesso. O totalizador do kit passa a exibir “5,40 Kg / 3 un.”. O operador aciona “Gerar Kit”: o sistema vincula os volumes ao documento do dia, gera a etiqueta, envia para a impressora do posto e exibe “Kit gerado com sucesso!\nVolume criado para o KIT: 000198765432”.

Caso 2 — Rejeição por ficha de composição (exclusivo Produção)

O operador cria o kit pai “001.020-KIT FILÉ MISTO” na Montagem de Kit do módulo Produção. Esse produto tem ficha de composição cadastrada permitindo apenas os produtos “002.005-FILÉ DE FRANGO” e “002.006-FILÉ DE PEITO”. O operador escaneia por engano um volume do produto “002.099-COXA E SOBRECOXA”. O sistema rejeita com “O produto 002.099-COXA E SOBRECOXA não faz parte da composição da ficha de produção do kit 001.020-KIT FILÉ MISTO” e emite bipe de erro. O operador escaneia o volume correto do produto “002.005”, que é aceito normalmente.

Caso 3 — Leitura de volume por número de lacre na Montagem de Kit de Produção

Na Montagem de Kit do módulo Produção, o operador não consegue bipar o código de barras do volume (etiqueta danificada) e digita, em vez disso, o número de lacre gravado no volume. Como o texto digitado não tem 12 caracteres, o sistema busca o volume pelo número de lacre e localiza o volume corretamente, aceitando a leitura normalmente.

Caso 4 — Retomando um kit pendente pela listagem na Montagem de Kit de Produção

Na Montagem de Kit do módulo Produção, ao abrir a tela, o operador (que deixou um kit pendente no dia anterior sob sua responsabilidade) recebe o aviso “Existem kits pendentes de finalização, favor verificar a lista de kits criados no dia.”. Confirma “Visualizar lista” e é levado à listagem já filtrada em Pendentes. Localiza o kit pendente “000198765400” e aciona “Retomar” — o kit volta a ser exibido como o kit atual em edição na tela principal, com o produto pai, o responsável e os volumes de composição já lidos anteriormente.

Caso 5 — Kit reservado para expedição desaparece da listagem na Montagem de Kit de Produção

Um kit de Produção foi finalizado e, posteriormente, seu volume foi reservado para uma expedição. Ao abrir a tela “Kits Criados” e consultar a aba Finalizados, esse kit não aparece mais em nenhum filtro — a consulta de listagem sempre exclui kits com volume pai já reservado para expedição.

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Fluxo Operacional
  • Interface e Comportamentos do App
  • Leituras de Código de Barras
  • Feedbacks ao Operador
  • Regras de Negócio
  • Documentos Gerados em Segundo Plano
  • Integrações
  • Troubleshooting
  • Casos de Uso
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06