Paletização com Documento
Criado por Igor Ribeiro em 24 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Paletização com Documento — Estocagem (FrigosoftColetor)
A Paletização com Documento é a operação por meio da qual o operador associa volumes (caixas individuais) a pallets, vinculando essa movimentação a um documento de produção do dia.
Visão Geral
A Paletização com Documento é a operação por meio da qual o operador associa volumes (caixas individuais) a pallets, vinculando essa movimentação a um documento de produção do dia. Ela se encaixa no fluxo de estocagem após a produção dos volumes e antes do endereçamento dos pallets no estoque. O que vem antes é a geração dos volumes na produção; o que vem depois é o armazenamento do pallet em posição de estoque.
Diferente da Paletização Simples, esta modalidade exige que exista (ou seja criado automaticamente) um documento de produção para a filial e data do dia, ao qual todas as movimentações ficam vinculadas.
Pré-requisitos
- Sessão ativa com filial e usuário configurados. Sem esses dados, o sistema não consegue buscar nem criar o documento do dia. A tela abre, mas os campos de pallet e volume permanecem bloqueados.
- Posto de trabalho configurado para o usuário. O sistema utiliza o posto do operador para filtrar os pallets não finalizados. Se o usuário não tiver posto configurado, a consulta de pallets é bloqueada com exceção.
- Código de cadastro configurado para o usuário. Obrigatório para a operação de reabertura de pallet. Sem ele, a reabertura é bloqueada com exceção.
- Documento de produção do dia disponível ou criável. O sistema tenta localizar o documento automaticamente. Se não existir, cria um novo com série ativa e próximo número de sequência. Se a criação falhar, a tela permanece sem documento carregado.
Fluxo Operacional
- O operador abre a tela de Paletização com Documento.
- O sistema busca automaticamente o documento do dia para a filial e o usuário logados, sem nenhuma ação do operador.
- Se o documento é localizado ou criado, o código do documento é exibido e os campos de pallet e volume ficam disponíveis.
- O operador bipa (ou digita) o código do pallet. O sistema carrega as informações do pallet: produto, status, quantidade e capacidade de volumes.
- Com o pallet carregado, o operador bipa o código do volume a ser associado.
- O sistema valida o volume e, se aceito, o adiciona ao pallet.
- Se o pallet atingiu a capacidade (quantidade de volumes = capacidade), o sistema imprime automaticamente a etiqueta, exibe mensagem de pallet finalizado e limpa os campos para o próximo pallet.
- Se o pallet não atingiu a capacidade, o operador continua bipando volumes.
- Ao final, o operador pode criar um novo pallet, reabrir um pallet finalizado (mediante autenticação de supervisor) ou encerrar a sessão.
Interface e Comportamentos do App
Estado inicial — sem documento carregado, na paletização com documento
- Os campos de pallet e volume ficam desabilitados para digitação e bipagem.
- A área do documento exibe o texto “Documento não localizado” com ícone de refresh, permitindo nova pesquisa ao tocar.
Estado com documento carregado — sem pallet, na paletização com documento
- O campo de pallet fica habilitado; o campo de volume permanece desabilitado.
- O documento é exibido no formato: `{filial}.{codigo}.{serie}.{numero com 6 dígitos com zeros à esquerda}`.
Estado com pallet carregado, na paletização com documento
- O campo de volume fica habilitado.
- O scanner de volume assume o controle de todos os eventos de bipagem, inclusive a leitura de novo pallet via código PLT. O campo de pallet cede o controle para evitar disparos duplos.
- O pallet é exibido no formato: PLT + {filial} + {serie} + {numero com 6 dígitos com zeros à esquerda}.
- O produto do pallet é exibido no formato: {codigoProduto}.{codigoReferencia} – {nomeProduto}. Quando o produto não está definido, o campo fica em branco.
- O último volume lido é exibido no formato: {filialVolume}.{serieVolume}.{numeroVolume com 6 dígitos}.
- A tara do pallet é exibida com 3 casas decimais e ponto como separador (ex.: 12.500). O campo de tara fica desabilitado para edição quando há volumes no pallet (quantidade > 0).
Botões de ação do pallet na paletização com documento
- Botão “Abrir”: aparece habilitado apenas quando o pallet não está com status “Aberto” nem “Pré-Impresso”. Permite reabrir um pallet finalizado.
- Botão de ação principal: exibe “Finalizar” (com ícone de confirmação) quando o pallet aceita finalização; caso contrário, exibe “Reimprimir” (com ícone de impressora).
- O pallet aceita finalização quando o status for “Aberto”, “Pré-Impresso” ou vazio.
Criação de novo pallet na paletização com documento
- Se já há um pallet carregado com status diferente de “Gerado”, o sistema exibe confirmação antes de criar o novo pallet.
- Se não há pallet ou o status é “Gerado”, o novo pallet é criado sem confirmação.
- O novo pallet é criado com código de documento “PLT”, série ativa e próximo número de sequência, sem produto definido.
Pesquisa de documento na paletização com documento
- Ao pesquisar o documento: os campos de pallet e volume são limpos, o documento atual e o pallet atual são zerados antes de enviar a requisição.
- Após carregado um documento, a área de toque do documento fica bloqueada para interação (sem ícone de refresh).
- Como camada extra de proteção, se por algum motivo o operador tentar consultar um pallet sem que haja documento carregado, o sistema bloqueia a operação com a mensagem “Não foi possível encontrar um documento” (a mesma mensagem usada quando a própria pesquisa de documento falha).
Validação local do código de pallet e do documento na paletização com documento (antes de acionar o servidor)
- O código do pallet é validado no aplicativo antes de qualquer chamada ao servidor: se o campo estiver vazio, é exibida a mensagem “Informe um pallet”; se o valor não seguir o formato esperado (prefixo “PLT” + filial + série + número, totalizando 15 caracteres), é exibida a mensagem “Pallet inválido”. Em ambos os casos a operação é bloqueada sem contatar o servidor.
- Ao mover um volume para um pallet vinculado a documento, se o número do documento estiver vazio, o aplicativo bloqueia o envio localmente com a mensagem “Documento inválido”, sem chamar o servidor.
Status do pallet exibidos na paletização com documento
Na paletização com documento, o status do pallet aparece na tela com um dos seguintes textos: Aberto, Gerado, Em Estoque, Baixado, Reservado, Picking, Pré-Impresso ou Terceiros.
Status do volume exibidos na paletização com documento
Na paletização com documento, o status do volume aparece na tela com um dos textos: Em Estoque, Baixado, Cancelado ou Em Processo. Qualquer outro status retornado pelo servidor é exibido exatamente como veio, sem tradução.
Leituras de Código de Barras
Scanner de pallet na paletização com documento
- O scanner de pallet reage a leituras que comecem com “PLT” e tenham exatamente 15 caracteres.
Scanner de volume na paletização com documento
- O scanner de volume reage a leituras com 12 caracteres, 16 ou mais caracteres, ou quando o modo “código de terceiro” está marcado.
- O campo de volume só aceita envio se a validação passar: tamanho 12 ou 16+, ou código de terceiro marcado, ou se o código informado não começar com “PLT” com 15 caracteres.
Re-scan de pallet enquanto há pallet carregado, na paletização com documento
- Se o operador bipa um código com 15 caracteres começando com “PLT” enquanto está no campo de volume, o sistema exibe um diálogo de confirmação perguntando se deseja mover todos os volumes daquele pallet para o pallet atual antes de prosseguir.
Feedbacks ao Operador
Na paletização com documento, os feedbacks ao operador se dividem entre mensagens fixas definidas no aplicativo e mensagens de bloqueio cujo texto vem do servidor.
Feedbacks — mensagens do aplicativo na paletização com documento (documento, pallet e volume)
| Situação | Feedback | Texto exato |
|---|---|---|
| Documento localizado ou criado com sucesso | Mensagemde sucesso (toast) | “Documento obtido com sucesso!” |
| Documento não localizado (retorno vazio na pesquisa) ou | Mensagem | “Não foi possível encontrar um |
| consulta de pallet sem documento carregado (proteção extra) | (toast) ou diálogo com OK | documento” |
| Código de pallet vazio no campo | Validaçã odo campo | “Informe um pallet” |
| Código de pallet fora do formato esperado | Validaçã odo campo | “Pallet inválido” |
| Documento vazio ao mover volume vinculado a documento | Bloqueio local (sem chamar o servidor | “Documento inválido” |
| ) | ||
| Volume incluído com sucesso | Mensagemde sucesso (toast) | “Volume adicionado com sucesso” |
| Retorno vazio (sem exceção) ao mover ou remover volume | Mensagem com OK | “Volume não encontrado” |
| Retorno vazio (sem exceção) ao consultar pallet | Mensagem com OK | “Pallet não encontrado” |
| Retorno vazio (sem exceção) ao criar novo pallet | Mensagem com OK | “Falha ao criar pallet” |
| Retorno sem indicação de | Mensagem | “Falha ao criar pallet” (mesmo texto usado quando a criação de |
| sucesso ao finalizar pallet (sem exceção) | com OK | um novo pallet falha, embora o contexto aqui seja de finalização — ver Regras de |
| Negócio) | ||
| Pallet finalizado automaticamente após atingir capacidade / finalização manual com | Mensagemde sucesso | “Pallet finalizado com sucesso” |
| sucesso | ||
| Erro sem mensagem específica do servidor | Mensagem com OK | “Ocorreu um erro desconhecido.” |
Feedbacks — validações de negócio na adição de volume ao pallet, na paletização com documento
| Situação | Feedback | Mensagem |
|---|---|---|
| Volume já está no mesmo pallet informado | Bloqueio com erro | Retornada pelo servidor |
| Volume já está em outro pallet e configuração | Bloqueio | Retornada pelo servidor, identificando o |
| ID 499 = ‘S’ | com erro | pallet original |
| Documento de produção do dia contabilizado no ERP ou cancelado | Bloqueio com erro | Retornada pelo servidor |
| Status de volume inválido para paletização normal | Bloqueio com erro | Retornada pelo servidor |
| Pallet não está com status Aberto ou Pré-Impresso | Bloqueio com erro | Retornada pelo servidor |
| Pallet já atendido ou endereçado | Bloqueio com erro | Retornada pelo servidor |
| Produto do volume não corresponde ao produto do pallet | Bloqueio com erro | Retornada pelo servidor |
| Quantidade de caixas por pallet do produto é zero | Bloqueio com erro | Retornada pelo servidor |
Feedbacks — configuração, criação, finalização e reabertura do pallet, na paletização com documento
| Situação | Feedback | Mensagem |
|---|---|---|
| Erro não esperado ao criar pallet (exceção genérica não tratada) | Mensagem com OK | Texto técnico brutoda exceção |
| Usuário sem posto de trabalho configurado | Exceção bloqueando consulta | Retornada pelo servidor |
| Usuário sem código de cadastro ao tentar reabrir pallet | Exceção bloqueando reabertura | Retornada pelo servidor |
| Pallet com status Baixado ao tentar finalizar | Exceção bloqueando finalização | Retornada pelo servidor |
| Volume com quarteio associado ao tentar excluir | Bloqueio com erro | Retornada pelo servidor |
| Último movimento do pallet não é finalização ao tentar reabrir | Bloqueio com erro | Retornada pelo servidor |
Regras de Negócio
- O tipo de movimentação enviado ao criar novo pallet nesta feature é sempre “ABTD”.
- O perfil de tipo de movimento para pesquisa de documento é sempre “AVE0205”.
- Um pallet é considerado finalizado quando a quantidade de volumes é maior ou igual à capacidade de volumes, e as duas são maiores que zero. Se a capacidade ou a quantidade não estiverem definidas, o pallet é considerado não finalizado.
- A tara do pallet, após bipagem, é formatada com 3 casas decimais e ponto como separador (ex.: 12.500).
- A reimpressão é acionada quando o pallet não aceita finalização (status diferente de “Aberto”, “Pré-Impresso” ou vazio).
- A reabertura de pallet exige autenticação de supervisor de indústria. Ficam dispensados: usuários administradores de indústria e usuários cujo login contenha “@”.
- Ao excluir volume pela lista de volumes: se o pallet não estiver com status “Aberto” ou “Pré-Impresso”, o sistema solicita confirmação de reabertura e autenticação de supervisor antes de prosseguir.
- Após remoção de volume pela lista: os volumes do pallet são recarregados automaticamente do servidor.
- A lista de pallets não finalizados filtra por data de movimentação (padrão: data logada). O checkbox “Qualquer data” desativa o filtro de data e também desabilita o seletor de data.
- Quando a finalização do pallet não é bem-sucedida sem que uma exceção seja lançada (a resposta do servidor simplesmente não indica sucesso), o texto exibido ao operador é o mesmo utilizado para falha na criação de um novo pallet (“Falha ao criar pallet”), mesmo o contexto sendo de finalização e não de criação.
- Cada card da lista de pallets não finalizados exibe: identificação do pallet, produto, status decodificado e quantidade/capacidade.
- Cada linha da lista de volumes exibe: código (filial.série.número), produto (ID.referência-nome), data de produção, data de validade, peso bruto, peso líquido e status decodificado, com botão de exclusão.
Integrações
- Impressora de etiquetas: acionada automaticamente após a finalização do pallet (quando a quantidade de volumes atinge a capacidade). Após impressão bem-sucedida, a paletização é pausada automaticamente — campos de pallet, volume e tara são limpos e o estado do pallet é zerado.
Troubleshooting
Na paletização com documento, o operador abre a tela e os campos de pallet e volume ficam bloqueados, sem documento carregado
Mensagem exibida: Nenhuma — a área do documento exibe o texto padrão de documento não localizado com ícone de refresh.
O que fazer: Tocar na área do documento para acionar nova pesquisa. Se o problema persistir, verificar com o responsável técnico se existe erro na criação do documento de produção do dia para a filial.
Na paletização com documento, o operador acessa a lista de pallets não finalizados e a operação é bloqueada com exceção
Mensagem exibida: Exceção retornada pelo servidor.
O que fazer: Verificar com o responsável técnico se o usuário possui posto de trabalho configurado no cadastro do ERP.
Na paletização com documento, o operador bipa um volume e recebe erro informando que o volume já está em outro pallet
Mensagem exibida: Retornada pelo servidor, identificando o pallet original.
O que fazer: Se a configuração do sistema ID 499(Parametro SISATAK) for “S” (não permite mover volumes entre pallets), o volume deve ser primeiramente removido do pallet original. Se a configuração for diferente de “S”, o sistema move automaticamente — reportar ao responsável técnico se o bloqueio ocorrer mesmo com configuração diferente de “S”.
Na paletização com documento, o operador bipa um volume e recebe erro de status de volume inválido
Mensagem exibida: Retornada pelo servidor.
O que fazer: Verificar o status atual do volume no ERP. Para paletização normal, apenas volumes com status “Em Estoque”, “Cancelado” ou “Em Processo” são aceitos.
Na paletização com documento, o operador tenta adicionar volume e recebe erro de produto divergente
Mensagem exibida: Retornada pelo servidor.
O que fazer: O produto do volume não corresponde ao produto já definido no pallet. Verificar se o volume é do produto correto ou se deve ser alocado em outro pallet.
Na paletização com documento, o operador tenta adicionar volume e recebe erro de quantidade de caixas zero
Mensagem exibida: Retornada pelo servidor.
O que fazer: O cadastro do produto no ERP está com quantidade de caixas por pallet igual a zero([ERPATAK -> Estoque -> Itens -> Produto -> PPCP -> “Quantidade de caixas do produto em cada Pallet”]). Corrigir o cadastro do produto no ERP.
Na paletização com documento, o operador tenta adicionar volume e recebe erro de pallet endereçado ou atendido
Mensagem exibida: Retornada pelo servidor.
O que fazer: O pallet já foi endereçado no estoque ou todas as posições foram preenchidas. Selecionar ou criar outro pallet.
Na paletização com documento, o operador tenta adicionar volume e recebe erro de documento atualizado ou cancelado
Mensagem exibida: Retornada pelo servidor.
O que fazer: O documento de produção do dia está com status contábil “S” ou foi cancelado. Contactar o responsável técnico para verificar o documento no ERP.
Na paletização com documento, o operador tenta reabrir um pallet e o botão “Abrir” está desabilitado
Mensagem exibida: Nenhuma — o botão simplesmente não responde.
O que fazer: O pallet está com status “Aberto” ou “Pré-Impresso”, estados que não precisam de reabertura. Verificar o status atual do pallet.
Na paletização com documento, o operador tenta reabrir um pallet, a autenticação de supervisor é realizada, mas a reabertura é bloqueada
Mensagem exibida: Exceção retornada pelo servidor.
O que fazer: Verificar com o responsável técnico se: (1) o usuário tem código de cadastro configurado no ERP, e (2) o último movimento do pallet é do tipo finalização — caso o pallet não tenha sido finalizado formalmente pelo sistema, a reabertura é bloqueada.
Na paletização com documento, o operador tenta finalizar o pallet e recebe erro de pallet baixado
Mensagem exibida: Exceção retornada pelo servidor.
O que fazer: O pallet com status “Baixado” não pode ser finalizado. Verificar a situação do pallet no ERP com o responsável técnico.
Na paletização com documento, o operador tenta remover um volume que tem quarteio associado
Mensagem exibida: Bloqueio retornado pelo servidor.
O que fazer: Volumes com quarteio associado só podem ser removidos pela rota de quarteio. Contatar o responsável técnico para executar a remoção pelo fluxo correto.
Na paletização com documento, ao bipar o pallet, bipar o volume ou finalizar o pallet, ocorre um erro inesperado (não relacionado às validações usuais) e a tela permanece com o indicador de carregamento aberto indefinidamente, sem nenhuma mensagem — a tela “trava”
Mensagem exibida: Nenhuma.
O que fazer: Trata-se de um erro inesperado não tratado adequadamente pelo aplicativo nessas três operações. Fechar e reabrir a tela (ou o aplicativo, se necessário) e reportar ao responsável técnico o momento exato em que ocorreu (leitura de pallet, leitura de volume ou finalização).
Na paletização com documento, o operador cria um novo pallet e aparece uma mensagem com texto técnico (como “Exception” ou texto de erro de programação)
Mensagem exibida: Texto técnico bruto da exceção.
O que fazer: Trata-se de um erro inesperado não tratado adequadamente pelo aplicativo. Anotar a mensagem e reportar ao responsável técnico para análise.
Casos de Uso
Caso 1 — Paletização normal com pallet novo até a capacidade, na paletização com documento
O operador abre a tela. O sistema localiza o documento do dia da filial e exibe 001.RPT.001.000042. Os campos ficam desbloqueados. O operador bipa PLT00100100015; o sistema carrega o pallet com produto “[CODIGO].[REF] – [NOME PRODUTO], status “Aberto”, 0/12 volumes e tara 0.500. O operador bipa o primeiro volume 123456789012 (12 caracteres); o sistema valida, adiciona o volume e exibe “1/12”. O operador continua bipando até o 12º volume. Ao bipar o 12º, o sistema detecta capacidade atingida, imprime automaticamente a etiqueta, exibe mensagem de pallet finalizado e limpa os campos para o próximo pallet.
Caso 2 — Volume já em outro pallet (sistema configurado para mover), na paletização com documento
O operador bipa o volume 100200123456. O sistema detecta que o volume já está no pallet PLT100300123456. Como a configuração do sistema ID 499 não é “S”, o sistema move o volume automaticamente para o pallet atual. O volume passa a aparecer na lista do pallet atual e é removido do pallet de origem.
Caso 3 — Reabertura de pallet para correção de volume, na paletização com documento
O operador percebe que um volume foi alocado no pallet errado. O pallet já está com status “Gerado”. O operador toca em “Abrir”, o sistema solicita autenticação de supervisor. O supervisor insere suas credenciais. O sistema valida que o último movimento do pallet é do tipo finalização, remove as validades, seta o status para “Aberto” e registra o movimento de reabertura. O operador remove o volume incorreto pela lista de volumes e bipa o volume correto.
Caso 4 — Consulta de pallets pendentes de dias anteriores, na paletização com documento
O operador deseja ver pallets de dias anteriores que ainda não foram concluídos. Na lista de pallets não finalizados, marca o checkbox “Qualquer data”. O seletor de data é desabilitado automaticamente. A lista exibe todos os pallets não finalizados do posto de trabalho do operador, independente da data de movimentação.
