Montagem de KIT – Produção
Montagem de Kit Produção
Rotina que permite ao operador agregar fisicamente dois ou mais volumes de carne em uma única caixa identificada pelo sistema como “kit”, com controle de peso total, validação de composição e registro no documento de produção do dia (TMV PCP0306).
Visão Geral
A rotina Montagem de Kit (Produção) permite ao operador agregar fisicamente dois ou mais volumes de carne em uma única caixa identificada pelo sistema como “kit”. O sistema cria um volume pai — representando a caixa do kit — e associa a ele os volumes componentes bipados pelo operador. Durante o processo, o sistema controla o peso total, valida a composição conforme a estrutura de produto configurada e, ao finalizar, registra o kit no documento de produção do dia (TMV PCP0306) e aciona o serviço de impressão da etiqueta.
Essa rotina formaliza, no sistema, a montagem de kits industriais realizada fisicamente no setor de produção. Ela é executada após a etapa de Produção/Desossa e antecede o fluxo de Expedição/Estoque. O documento gerado (TMV PCP0306) é o registro fiscal e operacional que vincula o kit ao fluxo de saída da produção.
Pré-requisitos e Contexto de Acesso
O usuario precisa ter acesso ao menu COLETOR > PRODUÇÃO > MONTAGEM KIT ,atribuindo permissões pela rotina: ERPATAK > TABELAS AUXILIARES > USUARIOS > PERMISSÃO CHÃO DE FABRICA
Configurações Obrigatórias para Funcionamento da Rotina
Sem essa configuração, a tela não carrega — o sistema retorna erro imediatamente ao tentar localizar o documento do dia.
Necessária para que o sistema crie automaticamente o documento de produção do dia caso ele ainda não exista.
Cenario_3 = 'K'Somente produtos com essa configuração aparecem na lista de seleção do produto pai do kit.
tbEstruturaProd com Opcao_pcp='K')ERPATAK > ESTOQUE > FICHA TÉCNICA > MONTAGEM DE KIT
Se configurada, o sistema permite apenas a bipagem de volumes cujo produto conste na estrutura. Se não configurada, qualquer volume pode ser adicionado ao kit.
11009 = 'S'ERPATAK > CUSTOMIZAÇÃO > PARAMETRO > FRIGORIFICO
Define se o excesso de peso da caixa em relação à tara configurada é tratado como advertência com possibilidade de confirmação (S) ou como bloqueio definitivo sem substituir.
ERPATAK > ESTOQUE > CADASTRO > ITENS > EMBALAGEM > PESO MINIMO / PESO MAXIMO
Se configurada, habilita o controle de capacidade de peso do kit. Sem essa configuração, o sistema não executa a validação de peso.
177 (lote padrão)Se o lote do kit pai for o lote padrão e um volume componente possuir lote diferente, o sistema faz o kit herdar o lote do volume componente.
Dependências de Cadastros Prévios
- Os volumes a serem bipados devem existir previamente no sistema com status
E - Em Estoque. - O produto pai do kit deve estar cadastrado com
TBPRODUTOREF.Cenario_3 = 'K'antes do acesso à rotina. - Caso a estrutura de composição seja utilizada, ela deve estar cadastrada em
tbEstruturaProdcomOpcao_pcp='K'antes do início da montagem.ERPATAK > ESTOQUE > FICHA TÉCNICA > MONTAGEM DE KIT
ERPATAK > ESTOQUE > CADASTRO >ITENS > PPCP > CENARIOS > CENARIO 3 = 'K - Produto Kit'
Processo de Criação — Passo a Passo
O operador acessa a opção “Montagem de Kit” no módulo de Produção. O sistema aguarda 800 milissegundos e inicia automaticamente o carregamento da tela. Internamente, o sistema localiza o documento de registro de produção do dia para a filial logada utilizando o perfil de TMV PCP0306. Se o documento não existir para a data atual, o sistema o cria automaticamente com numeração baseada na data no formato ddMMyy. Simultaneamente, o sistema carrega em segundo plano a lista de kits já criados no dia para a filial logada.
Se o operador logado possuir kits com status “Pendente” (kits iniciados e não finalizados em sessões anteriores), o sistema exibe uma mensagem de confirmação avisando sobre a existência desses kits em andamento. O operador pode fechar a mensagem e continuar para a criação de um novo kit, ou tocar no botão “Visualizar Lista” para ser direcionado à tela de lista de kits do dia, onde pode localizar e retomar um kit pendente.
Na tela principal, quando não há kit ativo, o sistema exibe o botão “Produto Kit Pai” (ícone de busca). O operador toca nesse botão. O sistema consulta a API e retorna a lista de produtos configurados com cenário K (campo TBPRODUTOREF.Cenario_3 = 'K'). O operador localiza e seleciona o produto desejado na lista retornada.
Após a seleção do produto pai, o sistema exibe uma mensagem de confirmação com o texto: “Deseja criar kit [código produto].[referência]-[nome do produto]?”. O operador toca em confirmar. O sistema envia o produto selecionado para a API, que cria o volume pai do kit — um novo volume com código de barras gerado automaticamente na série VOL — marcado internamente com o identificador de kit de Produção. A tela passa para o estado “com kit ativo”, habilitando os controles de bipagem, cancelamento e finalização.
Com o kit ativo, o campo de leitura de código de barras é exibido na tela. O operador posiciona o leitor laser no lacre do volume e bipa, ou digita manualmente o código de barras e pressiona Enter. O sistema envia o código de barras para a API e aguarda a resposta. O campo de leitura fica bloqueado enquanto a requisição está em andamento para evitar bipagens duplicadas.
O backend executa, para cada volume bipado, as seguintes validações em sequência:
Valida se o produto do volume consta na estrutura do produto pai (tbEstruturaProd com Opcao_pcp='K'), caso essa estrutura esteja configurada para o produto pai. Se não constar, a bipagem é rejeitada com mensagem de erro identificando o produto do volume e o produto pai.
Valida se o volume não está vinculado a outro kit. Se estiver, a bipagem é rejeitada.
Se o parâmetro de sequência de kit estiver ativo e o volume possuir sequência de kit (seqKit) diferente dos volumes já adicionados ao kit em andamento, o sistema exibe a mensagem de confirmação. Atenção: conforme limitação conhecida do sistema, a confirmação em Sim não produz efeito; a validação bloqueia novamente — veja Regra 5 na Seção 7.
Se a tara da caixa estiver configurada e o peso total do kit somado ao peso do novo volume ultrapassar a capacidade, o sistema reage conforme o parâmetro 11009. Se configurado como S, exibe advertência com opção de confirmação. Se não configurado como S, bloqueia definitivamente. Atenção: conforme limitação conhecida do sistema, a confirmação em Sim no caso do parâmetro S não produz efeito — veja Regra 6 na Seção 7.
Se todas as validações forem aprovadas, o sistema vincula o volume ao kit pai, soma o peso do volume adicionado ao peso total do kit e atualiza os totais exibidos na tela. O volume adicionado passa a aparecer na lista de composição do kit com as informações: produto, código de volume, peso e lacre. O campo de leitura é limpo automaticamente para que o operador realize a próxima bipagem.
O operador repete os Passos 5 a 7 para cada volume que compõe o kit. Não há limite de volumes documentado na fonte — cada bipagem bem sucedida adiciona o volume à composição e atualiza o peso total do kit.
Quando todos os volumes foram adicionados, o operador toca no botão “Finalizar”. O sistema envia o código de barras do volume pai, a filial e a data para a API. O backend executa:
- Localiza o documento de registro de produção do dia (TMV PCP0306) para a filial logada.
- Cria o item do produto pai no documento.
- Para cada volume de composição: valida que o status do volume é
E-Em Estoque, cria o subitem no romaneio do documento e vincula definitivamente o volume ao kit pai. - Atualiza o status do kit pai.
- Aciona o serviço de impressão de etiquetas configurado para gerar a etiqueta do kit.
Após a finalização bem sucedida, o sistema exibe a mensagem: “Kit gerado. Volume criado: [código de barras]”. A etiqueta é enviada automaticamente para o serviço de impressão configurado. Se o serviço de impressão falhar, o sistema exibe uma mensagem de erro de impressão separadamente — o kit permanece gerado e registrado no sistema independentemente da falha de impressão. A tela retorna ao estado sem kit ativo, pronta para o início de uma nova montagem.
Utilização e Consulta de Registros
Acesso à Lista de Kits do Dia
O operador acessa a lista de kits do dia por dois caminhos:
Pelo menu suspenso (ícone de três pontos) disponível na tela principal, selecionando a opção Kits Criados.
Pela mensagem de kits pendentes exibida na abertura da tela, tocando em Visualizar Lista.
Organização da Lista
A tela de lista de kits do dia exibe os registros separados em duas abas:
Kits que concluíram o processo de montagem e foram registrados no documento fiscal. Ordenados por código de barras de forma decrescente.
Kits iniciados e ainda não finalizados. Ordenados por código de barras de forma decrescente.
Ações Disponíveis na Lista
O operador toca no botão Retomar em um registro da aba Pendentes. O sistema busca o estado atual do kit na API e retorna à tela principal com esse kit ativo, permitindo continuar a bipagem de volumes de onde a montagem havia parado.
Na aba Finalizados, o operador toca no botão Impressão no registro desejado e confirma a mensagem de confirmação exibida. O sistema busca o JSON de impressão da etiqueta do kit e reencaminha para o serviço de impressão configurado.
Processo de Edição
A rotina Montagem de Kit (Produção) não permite a edição de registros após a finalização do kit. Um kit finalizado é um registro contábil e operacional vinculado ao documento fiscal TMV PCP0306 e ao romaneio de produção — sua alteração comprometeria a integridade do documento fiscal e do controle de estoque.
A única operação de modificação disponível antes da finalização é o cancelamento do kit em andamento (status Pendente), por meio do botão Cancelar Kit na tela principal. O cancelamento está sujeito à restrição descrita na Regra 8 da Seção 7 (volumes reservados em expedição impedem o cancelamento).
Estrutura Técnica e Comportamento do Sistema
A finalização do kit cria e/ou atualiza o documento de produção do dia identificado pelo perfil de Tipo de Movimento de Estoque PCP0306 para a filial logada. O documento é criado automaticamente na abertura da tela se ainda não existir para a data do dia, com numeração no formato ddMMyy. O kit finalizado gera um item de produto pai no documento e subitens de romaneio para cada volume componente.
O volume pai do kit é criado com código de barras gerado automaticamente na série VOL. Esse volume é marcado internamente como kit de Produção e serve como identificador único do kit no sistema.
Ao finalizar o kit, o sistema aciona automaticamente o serviço de impressão de etiquetas configurado para a filial. A impressão é um processo separado da geração do kit — uma falha no serviço de impressão não reverte nem cancela o kit gerado. A etiqueta pode ser reimpressa posteriormente via tela de lista de kits finalizados.
Volumes componentes de um kit podem ser incluídos em documentos de expedição. Quando isso ocorre, o volume recebe status de reservado, o que impede o cancelamento do kit pai enquanto o volume estiver nessa condição.
Os botões Cancelar Kit e Finalizar ficam desabilitados quando não há kit ativo na tela. São habilitados apenas quando um kit está em andamento (status Pendente com kit ativo na sessão). O campo de leitura de código de barras fica bloqueado durante o processamento de qualquer requisição de apontamento, evitando o envio duplo de bipagens.
O menu suspenso (ícone de três pontos) disponibiliza a opção Atualizar, disponível apenas com kit ativo. Ao selecionar, o sistema busca o estado atual completo do kit na API. Se o retorno indicar que o kit não está mais com status P (em processo), a tela é resetada para o estado sem kit ativo.
Se o parâmetro 177 estiver configurado e o lote do kit pai for o lote padrão, o sistema faz o kit herdar o lote do volume componente quando esse volume possuir um lote específico diferente do padrão.
Regras de Negócio e Restrições
O operador acessa a tela de Montagem de Kit (Produção) em uma filial que não possui o Tipo de Movimento de Estoque com perfil PCP0306 configurado, ou não possui sequência de numeração ativa para esse tipo de documento.
A tela não carrega o documento de produção do dia. O sistema retorna uma mensagem de erro imediatamente ao abrir a rotina.
O operador fica impedido de iniciar qualquer montagem de kit até que o responsável pelo ERP configure o TMV e a sequência de numeração para a filial.
Um produto é selecionado como pai do kit.
O sistema exibe na lista de seleção apenas produtos com TBPRODUTOREF.Cenario_3 = 'K'. Produtos sem essa configuração não aparecem na lista e não podem ser utilizados como produto pai de kit nessa rotina.
Produtos não configurados com cenário K não podem ser usados como kit pai. O responsável pelo cadastro de produtos deve realizar a configuração prévia.
O produto pai do kit possui estrutura de produto configurada em tbEstruturaProd com Opcao_pcp='K', e o operador bipa um volume cujo produto não consta nessa estrutura.
O sistema rejeita a bipagem e exibe a mensagem: “Falha ao realizar apontamento de kit: produto [código].[referência] não faz parte da composição do produto [código pai].[referência pai].”
O volume não é adicionado ao kit. O operador deve verificar se bipou o volume correto ou acionar o responsável para revisar a estrutura de produto no ERP.
O operador bipa um volume que já foi adicionado a outro kit anteriormente.
O sistema rejeita a bipagem e exibe mensagem informando que o volume já está vinculado a outro kit.
O volume não pode ser adicionado ao kit em andamento. Cada volume físico só pode pertencer a um único kit simultaneamente.
O operador bipa um volume com seqKit diferente dos volumes já adicionados ao kit em andamento. O sistema exibe o diálogo de confirmação e o operador toca em “Sim”.
A confirmação em “Sim” não produz efeito. A validação bloqueia a bipagem novamente. Tocar em “Não” cancela a operação e limpa o campo de leitura.
O operador deve bipar apenas volumes com a mesma sequência de kit dos demais volumes já adicionados, ou cancelar o kit atual e iniciar um novo kit. Esse comportamento é uma limitação conhecida do sistema.
O peso total do kit somado ao peso do novo volume ultrapassa a capacidade da caixa configurada na tara, e o parâmetro 11009 está configurado como S. O sistema exibe a advertência e o operador toca em “Sim” para confirmar.
A confirmação em “Sim” não produz efeito. A validação bloqueia a bipagem novamente. Tocar em “Não” cancela a operação.
O operador deve remover um ou mais volumes do kit para reduzir o peso antes de tentar adicionar o novo volume. Esse comportamento é uma limitação conhecida do sistema.
O peso total do kit somado ao peso do novo volume ultrapassa a capacidade da caixa configurada na tara, e o parâmetro 11009 não está configurado como S.
O sistema rejeita a bipagem definitivamente, sem oferecer ao operador a opção de confirmar ou fazer substituir. A mensagem de erro de peso é exibida sem botão de confirmação.
O volume não pode ser adicionado ao kit nessa condição. O operador deve remover volumes para liberar capacidade ou encaminhar a ocorrência ao responsável pela configuração do parâmetro.
O operador tenta cancelar um kit em andamento (status Pendente), mas um ou mais volumes de composição do kit já foram incluídos em um documento de expedição (status reservado para saída).
O sistema bloqueia o cancelamento e exibe mensagem de falha informando a existência de volumes reservados.
O operador deve acionar o setor de expedição para que o kit seja removido do romaneio de saída antes de tentar cancelá-lo novamente.
O operador finaliza o kit com sucesso, mas o serviço de impressão de etiquetas retorna erro.
O sistema confirma a geração do kit com a mensagem de sucesso e exibe separadamente a mensagem de erro de impressão. O kit permanece registrado no documento fiscal TMV PCP0306. Nenhuma parte do registro é revertida.
O kit está gerado e válido no sistema. O operador pode reimprimir a etiqueta acessando a lista de kits finalizados e usando a opção “Impressão” no registro correspondente.
O operador tenta finalizar o kit, mas um ou mais volumes de composição possuem status diferente de EmEstoque no momento da finalização (ex: volume já em expedição, cancelado ou com status inconsistente).
O sistema bloqueia a finalização e exibe mensagem informando os volumes com status inválido. Nenhuma alteração é salva no banco de dados — o documento TMV PCP0306 não é atualizado e o kit não é gerado.
O operador deve verificar o estado de cada volume bipado e corrigir a inconsistência antes de tentar finalizar novamente.
O parâmetro 177 está configurado, o lote atribuído ao kit pai é o lote padrão do sistema, e um volume componente bipado possui um lote específico diferente do lote padrão.
O sistema faz o kit pai herdar o lote do volume componente.
O lote do kit pai é substituído automaticamente pelo lote do volume, sem intervenção manual do operador.