Perfil de usuário

A Devolução é operada pela equipe de expedição/logística que trabalha com o coletor de dados (leitor de código de barras) no dia a dia da operação. O documento de origem não detalha um perfil de acesso específico dentro do sistema além disso; se houver alguma restrição adicional de permissão por usuário, essa informação não está disponível na documentação de origem, e deve ser validada com o analista responsável.

Filial selecionada

É obrigatório existir uma filial selecionada na sessão do operador antes de usar a Devolução. Sem filial selecionada, tanto a consulta de um pedido específico quanto a listagem dos pedidos de devolução do dia são bloqueadas com a mensagem “Filial não informada”.

Pedido de devolução previamente lançado

A Devolução não cria o pedido do zero. Ela depende de um pedido de devolução já lançado no ERP (originado por uma nota de devolução do cliente), com as seguintes condições:

• O pedido precisa estar com a situação “Ativo”. Se estiver com outra situação, a consulta é bloqueada com uma mensagem informando que o cliente ou o pedido está inativo.
• O pedido precisa ter ao menos um item cadastrado. Pedidos sem nenhum item são bloqueados na consulta.
• O pedido precisa ter sido lançado com o perfil de tipo de movimento exatamente igual a “VDA0203”. Qualquer outro perfil é rejeitado como incompatível com a devolução.

Romaneio de devolução

Cada pedido de devolução precisa estar vinculado a um romaneio de devolução com perfil exatamente igual a “VDA0202”.

• Se o pedido consultado ainda não tiver esse romaneio vinculado, o próprio sistema cria automaticamente esse romaneio na primeira consulta do pedido, usando a série e a numeração do próprio pedido de origem e os itens do pedido. O operador não precisa fazer nenhuma ação manual para isso.
• Se o pedido já tiver um romaneio vinculado, mas esse romaneio tiver sido criado com um perfil diferente de “VDA0202” (por exemplo, por uma configuração incorreta no ERP), a consulta é bloqueada informando que o romaneio está com perfil errado, e a devolução não pode prosseguir até a correção da configuração no ERP.

Conexão com o servidor

A Devolução depende de comunicação em tempo real com o backend (ver seção 8). Não é possível iniciar ou continuar uma devolução sem conexão.

Abrir a rotina de Devolução

O operador acessa a rotina de Devolução no coletor. Ao abrir essa rotina, o sistema fixa internamente, para toda a sessão de trabalho, que o tipo de expedição em uso é “Devolução”. Essa marcação não aparece como uma tela ou seleção adicional para o operador, mas é o que garante, em cada ação seguinte (consulta de pedido, bipagem, exclusão, impressão, atualização de documento), que o sistema use as regras e as rotinas corretas de devolução.

Consultar os pedidos de devolução do dia

O operador consulta a lista de pedidos de devolução disponíveis para a data de movimentação corrente. Essa consulta exige que exista uma filial selecionada na sessão; caso contrário, é bloqueada com a mensagem “Filial não informada”.

Selecionar o pedido de devolução

O operador seleciona, na lista, o pedido de devolução que deseja conferir (ou informa o código do pedido diretamente). O sistema busca o detalhe completo desse pedido, aplicando as validações de situação “Ativo”, existência de itens e perfil de tipo de movimento (ver seção 3). Se essa for a primeira consulta feita para esse pedido, o sistema cria automaticamente, neste momento, o romaneio de devolução vinculado a ele, reaproveitando a série e a numeração do próprio pedido. Se o pedido já tiver um romaneio vinculado, esse romaneio existente é reaproveitado e nenhum novo documento é criado. Em seguida, o sistema confere se o perfil do romaneio (recém-criado ou já existente) é “VDA0202”; se não for, a consulta é bloqueada informando romaneio com perfil errado.

Bipar os volumes que estão retornando

Com o pedido selecionado e o romaneio vinculado, o operador bipa (lê com o leitor de código de barras ou digita) os volumes, pallets ou EANs que estão fisicamente retornando ao frigorífico, um de cada vez. A forma de leitura aceita (volume, pallet ou EAN) depende de como o item do pedido está configurado. Cada leitura confirmada é enviada ao sistema como uma movimentação de inclusão (adicionar) desse volume ao romaneio de devolução.

Se o código lido ou digitado contiver vírgula (por exemplo, em leituras compostas no formato “prefixo,código”), o sistema considera apenas a parte depois da última vírgula como o código válido; o restante é descartado automaticamente, sem necessidade de o operador editar o texto lido.

Se, depois de processar a leitura, não existir nenhum pedido com saldo compatível com o volume ou EAN informado, o sistema recusa a inclusão com a mensagem “Nenhum pedido possui saldo suficiente para processar este volume”.

Corrigir uma leitura feita por engano (se necessário)

Caso o operador perceba que bipou um volume errado ou queira desfazer uma leitura já registrada, ele pode excluir esse volume de duas formas: lendo novamente o código de barras físico do volume (pallet, Volume ou EAN128) ou localizando o item na listagem de volumes já lançados no romaneio. O detalhamento completo das regras de exclusão está na seção 7 (Processo de Edição).

Finalizar pallet, quando aplicável

Se o item bipado usa paletização, o operador pode, durante a bipagem, acionar a finalização do pallet físico que está sendo montado. Essa ação é sempre feita no mesmo pallet que está em formação com aquele conjunto de volumes.

Solicitar impressão, quando necessário

Durante a bipagem, o operador pode solicitar a impressão do objeto correspondente ao que está sendo trabalhado (volume, pallet, kit ou EAN). A impressão só é efetivamente enviada à impressora configurada se a tela da devolução ainda estiver ativa (o operador não navegou para outra tela) e se o sistema realmente encontrar um objeto de impressão válido para aquele item. Se qualquer uma dessas duas condições não for atendida, a impressão é simplesmente ignorada, sem nenhuma mensagem de erro exibida ao operador. A Devolução também não permite impressão de carga agrupada (várias devoluções de uma vez); se essa opção for tentada, o sistema apenas retorna uma lista vazia, sem gerar impressão e sem mensagem de erro.

Atualizar o documento (consolidar a devolução)

Depois de conferir e bipar todos os volumes que retornaram, o operador aciona a atualização do documento de devolução. Essa ação consolida contabilmente o romaneio de devolução no ERP, encerrando o ciclo dessa devolução. Duas situações impedem essa atualização:

• Se o pedido ainda não tiver nenhum romaneio vinculado, o sistema bloqueia com a mensagem “Não existem romaneio vinculado do documento atual”; nesse caso, o operador precisa realizar a expedição (bipar ao menos um volume) antes, pois é isso que cria o romaneio.
• Se o romaneio já tiver sido atualizado contabilmente antes (por exemplo, por outro operador), o sistema bloqueia com a mensagem “Documento {filial}.{código}.{série}.{número} já está atualizado” (os quatro números entre chaves identificam exatamente qual documento já foi consolidado). Nesse caso, qualquer ajuste posterior só pode ser feito por quem tem acesso ao ERP, desatualizando o documento lá, pois o coletor não permite reverter essa consolidação.

Se nenhuma dessas duas situações ocorrer, o documento é atualizado com sucesso no ERP e o sistema retorna ao operador o detalhe do pedido já refletindo essa atualização.

Campo de leitura/bipagem de volume, pallet ou EAN

Consulta de pedido de devolução

Listagem de pedidos de devolução do dia

Listagem de volumes já lançados no romaneio

Ação “Finalizar Pallet”

Ação “Imprimir” (volume, pallet, kit ou EAN)

Ação “Atualizar Documento”

Filial selecionada na sessão

Formas de localização

O operador localiza pedidos de devolução já existentes de duas formas:

• Pela listagem de pedidos de devolução disponíveis para a data de movimentação corrente (o filtro principal e automático dessa lista é a data do dia de trabalho).
• Informando diretamente o código do pedido de devolução, quando já conhecido.

Requisito obrigatório

Em ambos os casos, é obrigatório existir uma filial selecionada na sessão do operador; sem isso, a consulta é bloqueada com “Filial não informada”.

Listagem de volumes durante conferência

Durante a conferência de um pedido já selecionado, o operador também consulta a listagem de volumes já lançados no romaneio de devolução em andamento, usada tanto para acompanhar o que já foi bipado quanto para localizar um item específico que precise ser excluído (ver seção 7).

Filtros e limitações

A documentação de origem não descreve filtros adicionais de busca (por exemplo, filtro por cliente, por transportadora ou por faixa de datas) além da listagem de pedidos do dia e da consulta direta por código de pedido; se existirem outros filtros na tela, essa informação não está disponível na documentação de origem, e deve ser validada com o analista responsável.

Exclusão de um volume inteiro

Pode ser feita lendo novamente o código de barras físico do volume (pallet, Volume ou EAN128) ou selecionando o item na listagem de volumes já lançados. Uma leitura solta, sem essas tags de identificação, é rejeitada com a mensagem “Exclusão via leitura somente permitida para pallet, Volume ou EAN 128 com tags para identificar volume. Em outras situações favor utilizar a exclusão via listagem de volumes.”; nesse caso, o operador deve usar a listagem.

Remoção de um item do romaneio

Quando o item removido tem filial, série e número de volume identificados, o sistema trata essa remoção exatamente como uma exclusão de volume completo, aplicando as mesmas validações (rastreabilidade e movimentação posterior). Quando o item não tem um volume físico vinculado, apenas o próprio item do romaneio é removido, sem acionar as validações de exclusão de volume.

Efeito sobre o pallet

Ao excluir todos os volumes de um pallet inteiro na Devolução, o status desse pallet passa para “Baixado”.

Histórico de alterações

Cada movimentação de inclusão feita na Devolução é registrada internamente com um código de rotina de auditoria específico (“20043”), permitindo rastrear, no ERP, qual sub-rotina originou aquele lançamento. A documentação de origem não detalha uma tela específica no coletor onde o operador possa consultar esse histórico de auditoria; se essa consulta existir, a informação não está disponível na documentação de origem, e deve ser validada com o analista responsável.

Depois de atualizado

Depois de atualizado (consolidado contabilmente), o documento de devolução não pode mais ser alterado pelo coletor de forma alguma; qualquer necessidade de correção depende de a área responsável desatualizar o documento diretamente no sistema ERP.

Roteamento por tipo de expedição

Ao abrir a Devolução, o sistema marca internamente, uma única vez, que o tipo de expedição em uso é “Devolução”. Essa marcação é o que faz o sistema usar, em cada ação seguinte (consulta de pedido, consulta de romaneio, bipagem de inclusão ou exclusão, consulta dos pedidos do dia, atualização de documento, impressão), as regras específicas de devolução, mesmo que a tela usada seja visualmente idêntica à de outros tipos de expedição.

Criação automática de romaneio

Como já descrito na seção 3 e no passo 3 da seção 4, o romaneio de devolução é criado automaticamente pelo sistema na primeira consulta de um pedido que ainda não tenha romaneio vinculado, usando a série e numeração do pedido de origem. O operador não precisa realizar nenhuma ação manual separada para isso.

Vínculo do pedido de origem

Quando o sistema busca os romaneios vinculados a um item de pedido, ele mesmo (o aplicativo) associa o identificador do pedido de origem a cada romaneio retornado; essa associação não vem pronta do servidor, mas isso não muda nada na forma como o operador usa a tela.

Sem agrupamento por carga

A Devolução nunca processa mais de um pedido de uma só vez (agrupado por carga). Toda movimentação de devolução é tratada pelo sistema como uma entrada individual, pedido a pedido; qualquer tentativa de agrupamento é sempre recusada com a mensagem “Não foi possível gerar agrupamento. Agrupamento não suportado para entradas.”. Isso também se aplica à impressão: uma tentativa de impressão agrupada em Devolução simplesmente não retorna nada para imprimir, sem mensagem de erro.

Retirada de endereçamento no armazém (WMS)

Se o volume incluído na devolução estava endereçado em um pallet físico dentro do armazém, e as regras de expedição/endereçamento exigirem isso (ou o volume estiver marcado como pallet parcial), o sistema retira automaticamente esse volume do endereço físico e registra esse movimento de retirada no sistema de gestão de armazém (WMS). Essa regra é compartilhada com os demais tipos de expedição do coletor.

Status do pallet ao incluir volumes

Na Devolução, assim que qualquer volume é incluído em um pallet, esse pallet já é marcado como “Gerado”, independentemente de ter atingido a quantidade de caixas configurada (diferente do Recebimento comum) e independentemente de todos os volumes estarem baixados (diferente da Expedição de saída).

Integração com o serviço de impressão

Os objetos de impressão (volume, pallet, kit ou EAN) obtidos durante a Devolução são enviados ao serviço de impressão configurado no ambiente do operador para gerar a etiqueta física correspondente.

Consolidação com o ERP

A ação de “Atualizar Documento” é o ponto em que a Devolução realmente grava, no sistema ERP, a consolidação contábil do romaneio de devolução conferido no coletor.

Tratamento de erros inesperados

Se ocorrer um erro inesperado durante o processamento de qualquer operação da Devolução, o sistema não expõe códigos técnicos ao operador; em vez disso, exibe uma mensagem de falha genérica, cujo texto muda conforme o idioma configurado para o usuário: “Falha ao realizar Devolução.” (português), “Failed to perform Return.” (inglês) ou “Error al realizar la Devolución.” (espanhol). Da mesma forma, quando o servidor não localiza um pallet na finalização, o sistema traduz automaticamente essa falha técnica para a mensagem simples “Pallet não encontrado”, em vez de mostrar um erro técnico ao operador.

Ausência de retorno informativo em tela

Depois de registrar uma movimentação de inclusão na Devolução, mesmo que o servidor devolva alguma informação adicional no retorno da operação, essa informação não é exibida ao operador (esse comportamento é específico da Devolução, do Romaneio de Compra e da Devolução de Compra; em RPS e na Expedição comum essa mesma informação, quando existe, é mostrada em tela).

Comportamento offline

A Devolução não funciona sem conexão com o servidor. A consulta de pedidos, a consulta e a criação de romaneio, a bipagem de movimentações, a exclusão de volumes e a atualização do documento exigem comunicação em tempo real com o backend; nenhuma dessas ações fica disponível para uso totalmente offline.

Perfis aceitos para pedido e romaneio

Um pedido só é aceito na Devolução se tiver sido lançado no ERP com o perfil de tipo de movimento “VDA0203”. O romaneio de devolução vinculado a esse pedido só é aceito se tiver o perfil “VDA0202”. Qualquer divergência nesses perfis bloqueia a consulta, informando o pedido ou o romaneio como incompatível/com perfil errado, impedindo a continuidade até a correção da configuração no ERP.

Situação do pedido deve ser “Ativo”

Só é possível consultar e processar um pedido de devolução se a situação dele no ERP for “Ativo”. Pedidos com outra situação são bloqueados na consulta, com uma mensagem informando cliente/pedido inativo.

Pedido precisa ter ao menos um item

Pedidos de devolução sem nenhum item cadastrado são bloqueados na consulta, com uma mensagem informando pedido sem item.

Filial obrigatória na sessão

Nenhuma consulta de pedido (individual ou da lista do dia) é realizada sem uma filial selecionada na sessão do operador; sem filial, o sistema bloqueia com “Filial não informada”.

Criação automática de romaneio na primeira consulta

Quando um pedido de devolução ainda não tem romaneio vinculado, o próprio sistema cria esse romaneio automaticamente na primeira consulta de detalhe desse pedido, usando a série e a numeração do pedido de origem e os itens do pedido. Se o pedido já tiver romaneio, o existente é reaproveitado, e nenhum novo romaneio é criado.

Agrupamento por carga não é permitido

Toda movimentação de Devolução é tratada como uma entrada individual, sempre pedido a pedido. Qualquer tentativa de processar a devolução como agrupada por carga (várias devoluções ao mesmo tempo) é recusada com a mensagem “Não foi possível gerar agrupamento. Agrupamento não suportado para entradas.”. A mesma regra vale para a impressão: uma impressão agrupada em Devolução não retorna nenhum objeto para imprimir, sem mensagem de erro.

Saldo do pedido precisa ser compatível com o volume lido

Ao bipar um volume ou EAN, se, depois da validação, não existir nenhum pedido com saldo suficiente para aquele item, a inclusão é bloqueada com a mensagem “Nenhum pedido possui saldo suficiente para processar este volume”. O operador deve conferir se o volume lido realmente pertence a um pedido de devolução em aberto com saldo disponível, verificando o saldo do pedido no ERP se necessário.

Exclusão de volume só por leitura física válida ou por listagem

A exclusão de um volume por leitura de código de barras só é aceita quando o código lido identifica claramente um volume físico (tags de pallet, Volume ou EAN128). Uma leitura solta, sem essas informações, é rejeitada com a mensagem “Exclusão via leitura somente permitida para pallet, Volume ou EAN 128 com tags para identificar volume. Em outras situações favor utilizar a exclusão via listagem de volumes.”, e o operador deve usar a listagem de volumes já lançados para localizar e excluir o item.

Romaneio já atualizado bloqueia exclusão e nova atualização

Depois que um romaneio de devolução é consolidado contabilmente (“atualizado”), o sistema bloqueia qualquer nova tentativa de exclusão de volume ou de item desse romaneio com a mensagem “Romaneio já atualizado”, e bloqueia uma nova tentativa de atualização do documento com a mensagem “Documento {filial}.{código}.{série}.{número} já está atualizado”. Nos dois casos, qualquer ajuste posterior depende de a área responsável desatualizar o documento diretamente no sistema ERP, já que o coletor não permite reverter essa consolidação.

Movimentação posterior impede exclusão do volume

Antes de excluir qualquer volume, o sistema verifica se já existe alguma movimentação registrada depois daquele lançamento. Se existir, a exclusão é bloqueada com uma mensagem informando que o volume possui movimentação posterior, e o operador deve verificar no ERP qual movimentação foi lançada sobre esse volume antes de tentar excluí-lo novamente.

Validações de rastreabilidade na exclusão de volume rastreado

Ao excluir um volume que tem controle de rastreabilidade, o sistema exige: que o volume tenha ao menos um mercado consumidor habilitado (senão bloqueia com “Volume não possui mercado consumidor”); que a rastreabilidade esteja presente e liberada na ordem de origem (senão bloqueia informando rastreabilidade não presente/não liberada); e que os mercados permitidos da rastreabilidade sejam compatíveis com os mercados do volume (senão bloqueia por incompatibilidade). Confirmada a exclusão, a quantidade de peças consumidas da rastreabilidade é reduzida em 1; se isso deixasse o saldo negativo, a exclusão é bloqueada por saldo insuficiente na rastreabilidade.

Romaneio de origem precisa existir para remoção de item

Ao remover um item de romaneio, se o romaneio de origem daquele item não for localizado, o sistema bloqueia com a mensagem “Romaneio não encontrado no documento”.

Atualização exige romaneio vinculado

O documento de devolução só pode ser atualizado (consolidado) se já existir um romaneio vinculado ao pedido. Se não existir, o sistema bloqueia com “Não existem romaneio vinculado do documento atual”, e o operador precisa realizar a expedição (bipar ao menos um volume) antes, pois é isso que cria o romaneio automaticamente.

Status do pallet conforme a ação

Ao incluir qualquer volume em um pallet durante a Devolução, esse pallet é imediatamente marcado como “Gerado”, sem depender de atingir uma quantidade mínima de caixas nem de todos os volumes estarem baixados. Ao excluir todos os volumes de um pallet inteiro, esse pallet passa para o status “Baixado”.

Retirada automática de endereçamento no armazém

Se o volume incluído estava endereçado em um pallet físico no armazém e as regras de expedição/endereçamento exigirem (ou o volume estiver marcado como pallet parcial), o sistema retira automaticamente esse volume do endereço físico e registra esse movimento no sistema de gestão de armazém (WMS).

Impressão de pallet só é enviada se houver algo a imprimir

Na impressão de pallet, a solicitação só resulta em impressão de fato se a tela ainda estiver ativa e se o objeto de impressão retornado não vier vazio. Se qualquer uma dessas condições falhar, a impressão é ignorada silenciosamente, sem mensagem para o operador.

Finalização de pallet não localizado

Se o pallet informado na finalização não for localizado pelo sistema, a operação é bloqueada com a mensagem “Pallet não encontrado”.

Rastreio interno das movimentações de devolução

Toda movimentação de inclusão realizada na Devolução é registrada internamente com o código de rotina “20043”, usado para identificar, no ERP, qual sub-rotina originou aquele lançamento. Esse código não aparece diretamente para o operador durante o uso normal do coletor.

Mensagem de erro genérica conforme o idioma do usuário

Quando ocorre um erro inesperado durante o processamento de qualquer operação da Devolução, a mensagem exibida varia conforme o idioma configurado para o usuário: “Falha ao realizar Devolução.” (português), “Failed to perform Return.” (inglês) ou “Error al realizar la Devolución.” (espanhol). Ao encontrar essa mensagem, o operador deve registrar o texto completo exibido (que inclui detalhes do erro) e acionar o suporte técnico para investigar a causa.

Documento consolidado é definitivo para o coletor

Depois que o documento de devolução é atualizado (consolidado contabilmente), nenhuma exclusão de volume, remoção de item ou nova atualização é mais permitida por meio do coletor para esse documento. Qualquer correção depende de a área responsável desatualizar o documento diretamente no sistema ERP.