Reimpressão Pallet Pré-Impresso
Reimpressão Pallet Pré-Impresso — Estocagem (FrigosoftColetor)
A funcionalidade de Reimpressão Pallet Pré-Impresso permite ao operador reimprimir etiquetas de pallet pré-impresso diretamente pelo coletor de dados.
Visão Geral
A funcionalidade de Reimpressão Pallet Pré-Impresso permite ao operador reimprimir etiquetas de pallet pré-impresso diretamente pelo coletor de dados. A tela é identificada pelo título “Reimpressão Pallet Pré-Impressa”.
O pallet pré-impresso é um tipo de movimentação controlado, registrado no ERP com o tipo “ABTPI” (Abertura de pallet pré-impresso). Ao acionar a reimpressão, o sistema cria um novo pallet no servidor para cada cópia solicitada e, em seguida, envia o comando de impressão para a impressora térmica do posto de trabalho do operador. O que vem antes: o produto com layout de etiqueta de pallet já deve estar cadastrado no ERP. O que vem depois: os pallets criados ficam disponíveis no estoque com status Aberto, aguardando paletização.
Pré-requisitos
Para imprimir um pallet pré-impresso, o operador deve atender às seguintes condições antes de iniciar a impressão:
- Produto com layout de etiqueta configurado: somente produtos que possuem layout de etiqueta de pallet configurado no cadastro do produto aparecem na lista de seleção ([ERPATAK -> Estoque -> Itens -> Produto -> embalagem -> “layout etiqueta de pallet”]). Se nenhum produto estiver configurado, a lista ficará vazia e não será possível prosseguir.
- Série ativa para o tipo de documento “PLT” na filial corrente: o servidor precisa encontrar uma série ativa cadastrada para esse tipo de documento na filial. Se não houver série ativa, o servidor retorna erro ao tentar criar o pallet e o processo é interrompido.
- Posto de trabalho configurado para o usuário logado: se o posto de trabalho não estiver configurado, o sistema ainda cria o pallet no servidor, mas o comando de impressão não é enviado para a impressora. O pallet aparecerá na lista com status “aguardando impressão”.
- Indicador de impressora térmica habilitado no posto de trabalho: o cadastro do posto precisa ter o indicador “tem impressora térmica” habilitado. Sem esse indicador habilitado, o endereço de impressão não é resolvido e o envio falha silenciosamente (ver Troubleshooting), mesmo que o posto tenha impressora 2, impressora 3 ou acesso à porta 9500 da URL base do servidor configurados.
- Impressora térmica configurada no posto de trabalho: com o indicador do item anterior habilitado, o posto deve ter ao menos uma impressora do tipo “serviço de impressão” configurada (impressora 2 ou impressora 3), ou o serviço de impressão deve estar acessível pela porta 9500 da URL base do servidor.
Fluxo Operacional
- O operador acessa a funcionalidade de Reimpressão Pallet Pré-Impresso pelo menu de estocagem. A tela principal é carregada em estado inicial (nenhum produto selecionado, campos em branco).
- O operador aciona a seleção de produto. A tela de lista de produtos é aberta e o sistema automaticamente carrega todos os produtos disponíveis consultando o servidor.
- O operador localiza o produto desejado digitando parte do código ou nome no campo de busca. A filtragem ocorre localmente a cada caractere digitado, sem nova consulta ao servidor.
- O operador dá duplo clique no produto desejado. A tela de lista se fecha, o produto fica selecionado na tela principal e o campo “Layout de Impressão” é preenchido automaticamente com o layout cadastrado para aquele produto.
- O operador informa a quantidade de impressões no campo “Quantidade de Impressões” (até 3 dígitos numéricos).
- O operador confirma ou altera o layout no campo “Layout de Impressão” (até 9 dígitos numéricos), se necessário.
- O operador pressiona o botão “Imprimir”. O sistema exibe um diálogo de confirmação com a quantidade e o layout informados.
- O operador confirma o diálogo. O processamento inicia: para cada pallet da quantidade informada, o sistema cria o pallet no servidor e envia o comando de impressão para a impressora.
- Ao término, o sistema exibe uma mensagem de sucesso ou erro e a lista de pallets criados fica visível na tela.
- Se necessário, o operador pode acionar o botão “Limpar” para reiniciar a seleção de produto e começar uma nova operação. A lista de pallets já criados permanece visível.
Interface e Comportamentos do App
Na funcionalidade de Reimpressão Pallet Pré-Impresso, o aplicativo apresenta três telas: a tela principal, a tela de lista de produtos e o diálogo de confirmação.
Tela principal da Reimpressão Pallet Pré-Impresso
A tela principal da Reimpressão Pallet Pré-Impresso reúne a seleção de produto, os campos de impressão e a lista de pallets criados:
- Campo de seleção de produto: somente leitura, preenchido após seleção.
- Campo “Quantidade de Impressões”: aceita até 3 caracteres numéricos; obrigatório para habilitar o botão “Imprimir”.
- Campo “Layout de Impressão”: aceita até 9 caracteres numéricos; obrigatório para habilitar o botão “Imprimir”; preenchido automaticamente ao selecionar produto, mas editável.
- Botão “Imprimir”: habilitado somente quando ambos os campos obrigatórios estão preenchidos e o sistema não está processando. Durante o processamento, exibe indicador de progresso e fica desabilitado.
- Botão “Limpar”: habilitado somente quando há produto selecionado e o sistema não está processando. Ao ser acionado: remove o produto selecionado, limpa o layout e redefine o indicador de impresso para falso. A lista de pallets criados não é apagada.
- Lista de pallets criados: exibida à medida que os pallets são gerados. Para cada pallet: o identificador do pallet (ex.: “PLT001AAA000001”) e o status — “ok” se a impressora confirmou o envio; “aguardando impressão” caso contrário.
Tela de seleção de produto na Reimpressão Pallet Pré-Impresso
A tela de lista de produtos da Reimpressão Pallet Pré-Impresso apresenta o seguinte comportamento:
- Abre ao solicitar seleção de produto e carrega os produtos automaticamente do servidor.
- Exibe os produtos no formato “{código do produto}.{código de referência}-{nome}”.
- Campo de busca: filtragem local sem distinção de maiúsculas/minúsculas (o sistema converte o texto digitado e o campo do produto para maiúsculas antes de comparar); ocorre a cada caractere digitado.
- Seleção por duplo clique: fecha a tela e retorna à tela principal com o produto selecionado.
Diálogo de confirmação de impressão do pallet pré-impresso
O diálogo de confirmação da Reimpressão Pallet Pré-Impresso é exibido ao pressionar o botão “Imprimir”:
- Mensagem: “Deseja realmente imprimir {quantidade} pallets com o layout {código do layout} ?”
- O processamento só inicia após confirmação.
Feedbacks ao Operador
Esta tabela reúne os feedbacks exibidos ao operador durante a reimpressão do pallet pré-impresso.
| Situação | Feedback | Mensagem |
|---|---|---|
| Diálogo de confirmação antes de | Diálogo | “Deseja realmente imprimir {quantidade} pallets com o |
| imprimir | modal (confirm ação) | layout {código do layout} ?” |
| Impressão de todos os pallets concluída com sucesso | Toast | “Impressão dos pallets realizada com sucesso!” |
| Erro no envio para a impressora ao final do loop | Toast | “Erro durante o envio para impressão.” |
| Erro ao criar pallet ou ao enviar | Diálogo | mensagem de erro retornada pelo servidor— ver |
| impressão (qualquer iteração) | modal (OK) | Troubleshooting |
| Pallet enviado para impressão com confirmaçãoda impressora | Statusna lista | “ok” |
| Pallet criado mas impressão não confirmada pela impressora | Statusna lista | “aguardando impressão” |
Regras de Negócio
Estas são as regras de negócio da Reimpressão Pallet Pré-Impresso.
- Identificador do pallet: “PLT” + filial (3 posições) + série (3 posições) + número (6 dígitos, zero à esquerda). Exemplo: filial “001”, série “AAA”, número 1 → “PLT001AAA000001”. Se qualquer componente for vazio ou zero, o identificador resultante é uma string vazia.
- Status do pallet criado: o pallet pré-impresso criado por esta função é sempre gravado com status inicial Aberto — o mesmo status padrão de qualquer pallet recém-inserido.
- Tipos de movimento registrados: a criação do pallet grava o movimento “ABTPI” (abertura de pallet pré-impresso); a obtenção dos dados para impressão grava o movimento “IMP” (impressão) no histórico do pallet. Esse segundo registro ocorre assim que os dados de impressão são obtidos pelo servidor — mesmo que o envio à impressora física falhe depois.
- Pallet criado sem produto selecionado: o botão “Imprimir” só exige que os campos “Quantidade de Impressões” e “Layout de Impressão” estejam preenchidos — não exige que um produto tenha sido selecionado. Se o operador confirmar a impressão sem selecionar produto, o pallet é criado sem nenhum item de referência associado a ele.
- Determinação do layout de impressão para o pallet pré-impresso: o servidor segue esta ordem de prioridade — primeiro, o layout informado manualmente pelo operador no campo “Layout de Impressão”; na ausência deste, o layout cadastrado no produto-referência selecionado; na ausência de ambos, o parâmetro ERP de código 492, que define o layout padrão do sistema. Se nenhuma das três opções resultar em um layout válido, a impressão não pode ser realizada.
- Campo “Quantidade de Impressões”: se o valor digitado não corresponder a um número inteiro válido, o sistema o trata como zero.
- Loop de impressão: a criação e o envio de cada pallet para impressão ocorrem um de cada vez (execução serial). O primeiro erro, seja na criação ou no envio, interrompe o restante da operação; os pallets já criados antes do erro permanecem registrados no sistema.
- Conteúdo da etiqueta impressa: a etiqueta do pallet pré-impresso traz filial, série e número do pallet; peso bruto e peso líquido totais; capacidade de volumes e quantidade de volumes; código e referência do produto; nome do produto (em até 10 idiomas); datas de produção e de validade (menor e maior); EAN; SIF/DIPOA e SIF/DIPOA PCP; número do lote; número da ordem; nome do operador responsável; campos customizáveis do produto-referência; e os volumes agrupados por lote e data.
Integrações
Impressora térmica: na Reimpressão Pallet Pré-Impresso, o sistema envia a etiqueta ao serviço de impressão através do endereço da impressora configurada no posto de trabalho, no ponto de envio “{endereço da impressora}/atak/impressao/etiqueta/generica”. A impressora pode ser configurada como impressora 2 ou impressora 3 do tipo “serviço de impressão” no cadastro do posto de trabalho. Quando mais de uma opção está configurada, o sistema usa esta ordem de prioridade: impressora 2, depois impressora 3 e, por último, a porta 9500 da URL base do servidor.
Troubleshooting
Posto de trabalho não encontrado ao imprimir pallet pré-impresso
Cenário: o operador aciona a impressão e o servidor não encontra o posto de trabalho pelo código associado ao usuário logado.
Mensagem exibida: “Erro ao localizar o posto de trabalho. Motivo: Posto de trabalho com identificação {código do posto} não encontrado. Solução: Verifique o código do posto de trabalho e tente novamente.”
O que fazer: verificar se o posto de trabalho está cadastrado corretamente no ERP e se o código do posto associado ao usuário logado está correto.
Pallet pré-impresso não encontrado ao enviar para impressão
Cenário: o operador aciona a impressão e o servidor não encontra o pallet recém-criado pelo identificador informado.
Mensagem exibida: “Operação não realizada. Motivo: Pallet com identificação {identificador do pallet} não encontrado. Solução: Verifique o pallet informado e tente novamente.”
O que fazer: situação inesperada — o pallet foi criado mas não foi localizado para impressão. Verificar integridade do cadastro e comunicar suporte técnico.
Usuário logado sem código de cadastro configurado ao imprimir
Cenário: o operador aciona a impressão do pallet pré-impresso e o usuário logado não tem código de cadastro configurado.
Mensagem exibida: “Erro ao executar esta operação. Motivo: O usuário logado não possui um código de cadastro configurado. Solução: Por favor, configure.”
O que fazer: configurar o código de cadastro do usuário logado nas configurações do sistema ERP.
Série ativa inexistente para o tipo de documento “PLT” ao numerar o pallet
Cenário: o operador aciona a criação do pallet pré-impresso e não há série ativa para o tipo de documento “PLT” na filial, no momento de obter a série/o número do pallet.
Mensagem exibida: “Erro ao executar esta operação. Motivo: Filial: {filial} Documento: {documento}. Solução: Verifique se o parâmetro 156, Código de filial utilizado como padrão para sequência de numeração, está preenchido corretamente.”
O que fazer: cadastrar uma série ativa para o tipo de documento “PLT” na filial corrente no ERP.
Mensagem alternativa: se a ausência de série ativa for detectada ao gerar o identificador do movimento (etapa que ocorre tanto na abertura quanto no registro de impressão do pallet), a mensagem exibida é: “Não foi possível obter Série Ativa Motivo: Não foi encontrada série ativa para a Filial {filial} e código de documento {documento} Solução: Verifique filial utilizada, se necessário altere ou configure para operação”.
Item de referência do produto inativo no ERP
Cenário: o operador aciona a impressão do pallet pré-impresso com um produto cujo item de referência está inativo no ERP.
Mensagem exibida: “Erro ao obter o item. Mensagem: Este item está inativo. Item informado: {código do produto}.{código da referência} – {nome do produto}”
O que fazer: reativar o produto-referência no cadastro do ERP ou selecionar um produto ativo.
Nenhum layout de etiqueta determinado para o pallet pré-impresso
Mensagem exibida: “Não foi possível Imprimir Motivo: Não há um layout de etiqueta interna definido para o item selecionado Solução: Defina layout de etiqueta interna para concluir operação”
O que fazer: configurar o layout de etiqueta no cadastro do produto-referência no ERP, ou configurar o parâmetro ERP de código 492 com o layout padrão, ou informar manualmente o código do layout no campo “Layout de Impressão” antes de imprimir.
Posto de trabalho não configurado impede o envio da impressão
Mensagem exibida: Nenhuma — o pallet é criado e aparece na lista com “aguardando impressão”, sem mensagem de erro
O que fazer: configurar o posto de trabalho para o usuário logado. Para reimprimir a etiqueta, será necessário usar outro recurso do sistema após configurar o posto.
Lista de produtos para seleção aparece vazia
Mensagem exibida: Nenhuma — a lista exibe sem itens
O que fazer: verificar no ERP se há produtos-referência com layout de etiqueta de pallet configurado (campo não nulo) disponíveis.
Usuário logado sem cadastro geral ao registrar a abertura do pallet pré-impresso
Cenário: o operador cria o pallet pré-impresso (antes da etapa de impressão) e o usuário logado não possui cadastro geral vinculado, no momento em que o servidor registra o movimento de abertura do pallet.
Mensagem exibida: “Não foi possível prosseguir com o processo. Motivo: Não há um cadastro geral cadastrado para o usuário logado. Solução: Por favor, informe um cadastro geral a este usuário.”
O que fazer: vincular um cadastro geral ao usuário logado no ERP e repetir a operação.
Posto de trabalho sem impressora térmica habilitada
Cenário: o posto de trabalho do operador existe e está associado ao usuário, mas o indicador “tem impressora térmica” não está habilitado no cadastro do posto.
Mensagem exibida: Nenhuma mensagem específica — o pallet é criado normalmente, mas o envio para a impressora falha silenciosamente, deixando o pallet com status “aguardando impressão” na lista; ao final da operação a tela exibe o toast “Erro durante o envio para impressão.”.
O que fazer: habilitar o indicador de impressora térmica no cadastro do posto de trabalho e configurar a impressora 2, a impressora 3, ou garantir o acesso à porta 9500 da URL base do servidor.
Casos de Uso
Caso 1 — Caminho feliz, um pallet
O operador acessa a funcionalidade, seleciona o produto “001.0-FRANGO INTEIRO”, confirma o layout “15” preenchido automaticamente, informa quantidade “1” e pressiona “Imprimir”. O sistema exibe o diálogo “Deseja realmente imprimir 1 pallets com o layout 15 ?”. O operador confirma. O sistema cria o pallet “PLT001AAA000142” no servidor, envia para a impressora do posto e exibe na lista “PLT001AAA000142 — ok”. Ao final, exibe toast “Impressão dos pallets realizada com sucesso!”.
Caso 2 — Impressão múltipla, 5 pallets
O operador seleciona o produto “002.0-COXA E SOBRECOXA”, confirma o layout “22”, informa quantidade “5” e confirma o diálogo. O sistema executa o loop criando os pallets “PLT001AAA000143” a “PLT001AAA000147”, enviando cada um para impressão. A lista é atualizada a cada iteração. Ao término, exibe toast “Impressão dos pallets realizada com sucesso!”.
Caso 3 — Produto sem layout configurado no cadastro — layout informado manualmente
O operador seleciona o produto “003.0-MIÚDOS”. O campo “Layout de Impressão” fica em branco pois esse produto não tem layout cadastrado. O operador digita manualmente o layout “8”, informa quantidade “2” e prossegue. O sistema usa o layout “8” fornecido pelo operador (prioridade máxima) e cria e imprime os 2 pallets normalmente.
Caso 4 — Posto de trabalho não configurado
O operador (usuário sem posto de trabalho associado) seleciona o produto, informa quantidade “3” e layout “15” e confirma. O sistema cria os 3 pallets no servidor (“PLT001AAA000150”, “PLT001AAA000151”, “PLT001AAA000152”), mas não envia para impressão. A lista exibe os três pallets com status “aguardando impressão”. O operador deve solicitar ao responsável técnico que configure o posto de trabalho para que futuras impressões sejam enviadas automaticamente.