Devolução
Devolução — Expedição (FrigosoftColetor)
A Devolução é a rotina de expedição usada para registrar o retorno físico de mercadoria que havia sido entregue a um cliente e está voltando ao frigorífico (uma expedição do tipo “entrada”, ao contrário da expedição de saída comum).
Visão Geral
A Devolução é a rotina de expedição usada para registrar o retorno físico de mercadoria que havia sido entregue a um cliente e está voltando ao frigorífico (uma expedição do tipo “entrada”, ao contrário da expedição de saída comum). O operador consulta o pedido de devolução já lançado no ERP, bipa os volumes que estão retornando e, ao final, atualiza o documento para consolidar a devolução contabilmente.
A Devolução reaproveita toda a infraestrutura de telas e serviços compartilhada com os demais tipos de expedição (Expedição comum, Recebimento/Romaneio de Compra, RPS, Devolução de Compra): a mesma tela de consulta de pedidos, a mesma tela de bipagem de item, a mesma lógica de finalização e impressão de pallet. O que diferencia a Devolução dos demais tipos é a rota de backend usada em cada chamada e um conjunto de regras e mensagens específicas do processo de devolução, descritas abaixo. No fluxo do frigorífico, a Devolução ocorre depois que o pedido de devolução foi lançado no ERP (originado por uma nota de devolução do cliente) e antes da baixa contábil definitiva do romaneio de devolução gerado.
Pré-requisitos
- Para operar a Devolução, deve existir uma filial selecionada na sessão do operador. Sem filial selecionada, tanto a consulta de detalhe de um pedido quanto a listagem de pedidos de devolução do dia são bloqueadas com o erro “Filial não informada”.
- O pedido de devolução consultado precisa estar com a situação “Ativo” no ERP — senão a consulta é bloqueada informando cliente/pedido inativo.
- O pedido precisa ter ao menos um item — pedidos sem item são bloqueados na consulta.
- O perfil de tipo de movimento do pedido precisa ser exatamente “VDA0203” — qualquer outro perfil é rejeitado como incompatível com a devolução.
- Quando o pedido já possui romaneio de devolução vinculado, o perfil desse romaneio precisa ser exatamente “VDA0202” — caso contrário a consulta é bloqueada informando romaneio com perfil errado.
- Se o pedido ainda não tiver romaneio de devolução vinculado, o próprio sistema cria esse romaneio automaticamente ao consultar o pedido pela primeira vez (ver Processamento pelo Backend — Consulta de detalhe do pedido de devolução); não é necessário nenhuma ação manual do operador para isso.
Fluxo Operacional
- O operador abre a rotina de Devolução; o tipo de expedição do fluxo é fixado internamente como “Devolução” para toda a sessão, sem nenhuma tela ou seleção adicional — essa marcação decide, em cada chamada seguinte, qual rota de backend é usada.
- O operador consulta os pedidos de devolução disponíveis para a data de movimentação corrente.
- O operador seleciona um pedido; o sistema busca o detalhe do pedido — se for a primeira consulta, o romaneio de devolução do pedido é criado automaticamente neste momento.
- O operador bipa (lê ou digita) os volumes, pallets ou EANs que estão retornando, um a um; cada leitura é enviada como uma movimentação de “adicionar”.
- Se o operador precisar desfazer uma leitura ou excluir um item já registrado, aciona a remoção — por leitura de um volume físico (pallet/volume/EAN128) ou pela listagem de volumes já lançados.
- Durante a bipagem, o operador pode finalizar um pallet (quando o item usa paletização) e/ou solicitar a impressão do objeto correspondente (volume, pallet, kit ou EAN).
- Ao concluir a conferência de todos os volumes retornados, o operador aciona a atualização do documento, que consolida contabilmente o romaneio de devolução no ERP.
Interface e Comportamentos do App
- A Devolução não oferece modo de trabalho “agrupado por carga” — todo o processamento é sempre pedido a pedido (ver Regras de Negócio — Agrupamento não suportado para entradas).
- Ao registrar uma movimentação (adicionar), o retorno informativo eventualmente enviado pelo backend no corpo da resposta só é exibido ao operador quando o tipo de expedição em curso é RPS ou Expedição comum. Para Devolução (e também para Romaneio de Compra e Devolução de Compra), esse mesmo campo — se vier preenchido — é descartado silenciosamente, sem qualquer aviso em tela (ver Possíveis Bugs, BUG-2).
- Na impressão de pallet: a busca do objeto de impressão só resulta em envio efetivo ao serviço de impressão configurado se a tela ainda estiver ativa (o operador não navegou para fora) E o objeto retornado não vier vazio. Se qualquer uma dessas condições falhar, a impressão é silenciosamente ignorada — nenhuma mensagem é exibida ao operador.
Leituras de Código de Barras
- Na Devolução, a bipagem de movimentação aceita leitura de volume, pallet ou EAN, conforme a forma de leitura configurada para o item do pedido.
- Se o código lido ou digitado contiver vírgula (leituras compostas do tipo “prefixo,código”), apenas a parte após a última vírgula é considerada o código e enviada ao backend — o prefixo é descartado.
- Na exclusão de um volume por leitura, somente são aceitas leituras que identifiquem um volume físico (tags de pallet, Volume ou EAN128). Uma leitura solta, sem essas tags, é rejeitada — o operador deve usar a exclusão via listagem de volumes nesse caso.
Feedbacks ao Operador
Feedbacks — Consulta de pedido de devolução
| Situação | Feedback | Mensagem |
|---|---|---|
| Consulta de pedido ou de pedidos do dia sem filial selecionada na sessão | Bloqueio | “Filial não informada” |
| Consulta de pedido de devolução não encontrado | Bloqueio | “Não foi possível executar a movimentação. Pedido não encontrado. Verifique o código lido.” |
| Consulta de pedido com situação diferente de Ativo | Bloqueio | mensagem informando cliente/pedido inativo |
| Consulta de pedido sem nenhum item | Bloqueio | mensagem informando pedido sem item |
| Consulta de pedido com perfil de tipo de movimento incompatível (diferente de VDA0203) | Bloqueio | mensagem informando perfil incompatível |
| Romaneio de devolução criado/reaproveitado com perfil diferente de VDA0202 | Bloqueio | mensagem informando romaneio com perfil errado |
Feedbacks — Movimentação de adicionar na Devolução
| Situação | Feedback | Mensagem |
|---|---|---|
| Retorno informativo do backend após movimentação de adicionar, quando o tipo em curso é Devolução | Nenhum feedback exibido | (nenhum — o campo é descartado silenciosamente; ver Possíveis Bugs, BUG-2) |
| Tentativa de movimentação agrupada por carga em Devolução | Bloqueio | “Não foi possível gerar agrupamento. Agrupamento não suportado para entradas.” |
| Nenhum pedido com saldo compatível com o volume/EAN lido | Bloqueio | “Nenhum pedido possui saldo suficiente para processar este volume” |
Feedbacks — Exclusão de volume e remoção de item de romaneio na Devolução
| Situação | Feedback | Mensagem |
|---|---|---|
| Exclusão por leitura que não identifica um volume físico | Bloqueio | “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.” |
| Exclusão de volume não encontrado em nenhum romaneio da chave de fato | Bloqueio | mensagem informando que o volume não foi encontrado no romaneio |
| Exclusão de volume/item de romaneio já contabilmente atualizado | Bloqueio | “Romaneio já atualizado” |
| Exclusão de volume com movimentação posterior registrada | Bloqueio | mensagem informando que o volume possui movimentação posterior |
| Exclusão de volume rastreado sem mercado consumidor habilitado | Bloqueio | “Volume não possui mercado consumidor” |
| Exclusão de volume rastreado sem rastreabilidade presente/liberada na ordem de origem | Bloqueio | mensagem informando rastreabilidade não presente/não liberada |
| Exclusão de volume rastreado com mercados incompatíveis entre rastreabilidade e volume | Bloqueio | mensagem informando incompatibilidade de mercados |
| Exclusão de volume rastreado que deixaria a rastreabilidade com saldo negativo de peças | Bloqueio | mensagem de saldo insuficiente na rastreabilidade |
| Remoção de item de romaneio cujo romaneio de origem não foi encontrado | Bloqueio | “Romaneio não encontrado no documento” |
Feedbacks — Atualização de documento de devolução
| Situação | Feedback | Texto exato |
|---|---|---|
| Atualização de documento sem romaneio vinculado | Bloqueio | “Não existem romaneio vinculado do documento atual” |
| Atualização de documento já contabilmente atualizado | Bloqueio | “Documento {filial}.{código}.{série}.{número} já está atualizado” |
Feedbacks — Impressão e finalização de pallet na Devolução
| Situação | Feedback | Mensagem |
|---|---|---|
| Impressão: pedido de devolução ou romaneio vinculado não encontrado pela chave de fato | Bloqueio | mensagem de pedido não encontrado |
| Impressão de carga agrupada em Devolução | Nenhum bloqueio — retorna lista vazia | (nenhuma mensagem — devolução não suporta impressão agrupada por carga) |
| Finalização de pallet retornando HTTP 404 | Bloqueio | “Pallet não encontrado” |
Feedbacks — Erros genéricos do serviço de Devolução
| Situação | Feedback | Texto exato |
|---|---|---|
| Erro genérico de processamento no serviço de Devolução (idioma português) | Bloqueio | “Falha ao realizar Devolução.” |
| Erro genérico de processamento no serviço de Devolução (idioma inglês) | Bloqueio | “Failed to perform Return.” |
| Erro genérico de processamento no serviço de Devolução (idioma espanhol) | Bloqueio | “Error al realizar la Devolución.” |
Processamento pelo Backend
Movimentação de adicionar na Devolução
Ao registrar uma movimentação de adicionar na Devolução, o endpoint dedicado delega toda a lógica ao serviço de expedição de entrada de devolução, sempre com o parâmetro de agrupamento fixado como falso — a API de devolução via coletor nunca agrupa por carga. Qualquer exceção lançada durante o processamento é convertida em resposta HTTP 403 (Forbidden), com a mensagem da exceção enviada como texto simples.
- Se solicitada como agrupada mesmo assim, a movimentação é recusada (ver Regras de Negócio — Agrupamento não suportado para entradas).
- Se, após toda a leitura e validação, nenhum item ficar disponível para aplicar no banco (nenhum pedido com saldo compatível com o volume/EAN lido), a operação é bloqueada com “Nenhum pedido possui saldo suficiente para processar este volume”.
- Ao concluir a inclusão de volumes vinculados a um pallet, o status do pallet de destino é atualizado (ver Regras de Negócio — Status do pallet ao adicionar).
- Se aplicável, o volume é retirado do endereçamento em pallet físico (ver Regras de Negócio — Retirada de endereçamento).
- Pedidos e romaneios com perfil diferente do aceito para Devolução são rejeitados (ver Regras de Negócio — Perfis aceitos).
- Cada movimentação é registrada com o código de rotina de auditoria correspondente (ver Regras de Negócio — Código de rotina de auditoria).
Movimentação de remover (exclusão de volume) na Devolução
Ao excluir um volume na Devolução, o backend aplica uma sequência de validações antes de efetivar a remoção.
- Se a leitura informada não corresponder a um volume físico identificável, a exclusão é bloqueada com “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.”
- Se, ao final da busca em todos os romaneios da chave de fato, nenhum volume for de fato encontrado/casado com a leitura, a exclusão é bloqueada informando que o volume não foi encontrado no romaneio.
- Se o romaneio ao qual o volume pertence já estiver com o status contábil marcado como atualizado, a exclusão é bloqueada com “Romaneio já atualizado”.
- Antes de aplicar a exclusão no banco, cada volume é verificado quanto à existência de movimentação posterior à data/hora do item no romaneio; se houver, a exclusão é bloqueada informando que o volume possui movimentação posterior.
- Quando a exclusão exige validação de rastreabilidade e o item é rastreado: o volume precisa ter ao menos um mercado consumidor habilitado (senão bloqueia com “Volume não possui mercado consumidor”); a rastreabilidade do volume precisa estar presente e liberada na ordem de origem (senão bloqueia informando rastreabilidade não presente/não liberada); os mercados permitidos da rastreabilidade precisam ser compatíveis com os mercados do volume (senão bloqueia). Ao confirmar a exclusão, a rastreabilidade é decrementada (ver Regras de Negócio — Decremento de rastreabilidade na exclusão).
- Após excluir todos os volumes de um pallet inteiro, o status do pallet é atualizado (ver Regras de Negócio — Status do pallet ao remover).
Remoção de item de romaneio na Devolução
Ao remover um item de romaneio (sem excluir o volume inteiro) na Devolução, o backend bloqueia com “Romaneio não encontrado no documento” se o romaneio de origem não for encontrado, e bloqueia com “Romaneio já atualizado” se o romaneio já estiver contabilmente atualizado. Se o item removido tiver filial, série e número de volume identificados, a remoção é redirecionada internamente para a rotina de exclusão de volume completo, usando o código de barras montado a partir desses três dados; caso contrário, apenas o próprio item/romaneio é removido, sem acionar a exclusão de volume (ver Regras de Negócio — Remoção de item de romaneio equivalente à exclusão de volume).
Consulta de detalhe do pedido de devolução
Ao consultar o detalhe de um pedido de devolução, o backend bloqueia a consulta se o pedido não for encontrado (“Não foi possível executar a movimentação. Pedido não encontrado. Verifique o código lido.”), se a situação do pedido não for “Ativo” (mensagem informando cliente/pedido inativo), se o pedido não tiver nenhum item (mensagem de pedido sem item) ou se o perfil do tipo de movimento do pedido não for o perfil aceito para devolução (mensagem informando perfil incompatível; ver Regras de Negócio — Perfis aceitos).
Ao consultar um pedido de devolução que ainda não possui romaneio vinculado, o romaneio de devolução é criado neste exato momento da consulta — não em uma ação explícita separada do operador — usando a mesma série/numeração do pedido de origem e os itens do pedido. A direção do documento gerado é de saída (o backend gera o romaneio e o retorna ao app já vinculado ao pedido); o gatilho é a primeira consulta de detalhe de um pedido de devolução sem romaneio vinculado. Se o pedido já tiver romaneio vinculado, o romaneio existente é reaproveitado e nenhum novo documento é criado. Após criar o romaneio, o pedido é reconsultado para refletir o vínculo criado. Em seguida, o perfil do romaneio obtido/criado é validado contra o perfil esperado para o romaneio de devolução (ver Regras de Negócio — Perfis aceitos); se não bater, a consulta é bloqueada informando romaneio com perfil errado.
Atualização de documento de devolução
Ao atualizar o documento de uma devolução, o backend bloqueia a operação se não existir romaneio vinculado ao pedido, com “Não existem romaneio vinculado do documento atual” (orientando realizar a expedição para criar o romaneio primeiro); e bloqueia se o romaneio já estiver contabilmente atualizado, com “Documento {filial}.{código}.{série}.{número} já está atualizado” (orientando usar o sistema ERP para desatualizar, já que o app não permite reverter). Caso nenhuma das duas condições se aplique, o documento é efetivamente atualizado no ERP e o detalhe do pedido, já refletindo a atualização, é retornado ao app.
Impressão na Devolução
Ao processar uma impressão na Devolução, se a impressão solicitada for de uma carga agrupada, o serviço retorna uma lista vazia (sem erro) — devolução não suporta impressão agrupada por carga. Para impressão não agrupada: o pedido de devolução e o romaneio vinculado são buscados pela chave de fato; se qualquer um dos dois não for encontrado, bloqueia com a mensagem de pedido não encontrado. Encontrados ambos, a montagem final do objeto de impressão (dados do motorista da carga, dados do volume/pallet, código de barras) é delegada à lógica genérica de expedição, compartilhada com os demais tipos de documento.
Finalização de pallet na Devolução
A finalização de pallet na Devolução delega inteiramente ao módulo compartilhado de consulta de pallet, enviando o código do pallet ao endpoint compartilhado de finalização — não há lógica de negócio adicional específica de devolução nesta etapa. Um retorno HTTP 404 do endpoint é reescrito para a mensagem “Pallet não encontrado” antes de propagar o erro ao chamador (demais erros mantêm a mensagem original do servidor).
Impressão de pallet na Devolução
Na impressão de pallet da Devolução, o corpo da requisição enviada ao endpoint compartilhado de paletização inclui o código do pallet, o código do posto de trabalho do usuário logado e o código de layout de impressão (opcional). Se o backend não retornar sucesso ou o campo do objeto de impressão vier nulo, o método retorna nulo silenciosamente (tratado pelo chamador como “sem nada a imprimir”).
Regras de Negócio
- Roteamento por tipo de expedição: o tipo de expedição (“Devolução”) é fixado uma única vez ao abrir a rotina e determina, em toda chamada subsequente (consulta de pedido, consulta de romaneio, remoção de item, movimentação de adicionar/remover, consulta de pedidos do dia, atualização de documento, impressão), qual rota específica de backend é usada — a mesma lógica de tela e de serviço é reaproveitada por todos os tipos de expedição, mudando apenas a rota chamada.
- Vínculo de romaneio ao pedido de origem: ao obter a lista de romaneios vinculados a um item de pedido, cada romaneio retornado recebe o identificador do pedido de origem atribuído explicitamente pelo aplicativo — esse vínculo não vem pronto do backend.
- Corpo da remoção de item de romaneio: contém a chave de fato do pedido, o número do item, o número do subitem e a sequência do romaneio.
- Normalização de código lido: se o código lido ou digitado contiver vírgula, apenas a parte após a última vírgula é enviada ao backend como código.
- Formato da data de produção: quando informada, é enviada ao backend formatada como aaaa-mm-dd; se não informada, o campo é enviado como texto vazio.
- Movimentação agrupada (regra compartilhada, não aplicável em Devolução na prática): quando uma movimentação é agrupada por carga, os sinalizadores de transformação e de repesagem sempre são enviados como falsos ao backend, mesmo que a tela tenha ativado essas opções para o item. Em Devolução esse cenário não ocorre em condições normais, pois o agrupamento por carga é sempre bloqueado no backend para expedições do tipo Entrada.
- Agrupamento não suportado para entradas: toda movimentação de Devolução é tratada como expedição de Entrada; solicitações de agrupamento por carga são sempre recusadas — a Devolução opera exclusivamente pedido a pedido.
- Perfis aceitos: pedido de devolução só é aceito com perfil “VDA0203”; romaneio de devolução só é aceito com perfil “VDA0202”.
- Código de rotina de auditoria: toda movimentação de Devolução é registrada internamente com o código “20043”, para rastreio de qual sub-rotina do ERP originou o lançamento.
- Mensagem de erro genérica por idioma: quando ocorre um erro genérico de processamento no serviço de Devolução, o prefixo da mensagem varia conforme o idioma do usuário: “Falha ao realizar Devolução.” (português), “Failed to perform Return.” (inglês) ou “Error al realizar la Devolución.” (espanhol).
- Status do pallet ao adicionar: em Devolução, o pallet de destino é marcado “Gerado” assim que qualquer volume é incluído — não depende de atingir a quantidade de caixas configurada (diferença em relação ao Recebimento comum) nem de todos os volumes estarem baixados (diferença em relação à Expedição de saída).
- Status do pallet ao remover: ao excluir todos os volumes de um pallet inteiro na Devolução, o pallet passa para “Baixado” — mesmo comportamento do Recebimento comum, diferente da Expedição de saída (que passaria para “Gerado” nesse cenário).
- Retirada de endereçamento: se o volume estiver endereçado em pallet e as travas de expedição/endereçamento exigirem (ou o volume estiver marcado como pallet parcial), ele é retirado do pallet físico e um movimento de retirada é registrado no WMS — regra compartilhada com os demais tipos de expedição.
- Decremento de rastreabilidade na exclusão: ao confirmar a exclusão de um volume rastreado, a quantidade de peças consumidas da rastreabilidade é decrementada em 1; se o resultado for negativo, a exclusão é bloqueada por saldo insuficiente na rastreabilidade.
- Remoção de item de romaneio equivalente à exclusão de volume: quando o item removido do romaneio tem filial, série e número de volume identificados, o efeito é idêntico ao de excluir o volume inteiro (mesmas validações de rastreabilidade e movimentação posterior); quando não tem volume físico vinculado, apenas o item/romaneio específico é removido.
Comportamento Offline
A Devolução não opera sem conexão com o servidor: a consulta de pedidos, a consulta e criação de romaneio, a bipagem de movimentação, a exclusão de volumes e a atualização de documento dependem de comunicação em tempo real com o backend.
Integrações
- Serviço de impressão configurado: usado para imprimir o objeto (volume, pallet, kit ou EAN) obtido do endpoint dedicado de devolução ou do endpoint compartilhado de paletização.
- WMS (retirada de endereçamento): quando o volume incluído estava endereçado em pallet e as travas configuradas exigem, um movimento de retirada de pallet é registrado no WMS como parte da inclusão.
Troubleshooting
Consulta de pedido ou de pedidos do dia sem filial selecionada na sessão
Mensagem exibida: “Filial não informada”
O que fazer: Orientar o operador a selecionar a filial antes de consultar pedidos de devolução.
Tentativa de processar a movimentação de devolução como agrupada por carga
Mensagem exibida: “Não foi possível gerar agrupamento. Agrupamento não suportado para entradas.”
O que fazer: Nenhuma ação corretiva — a Devolução não suporta agrupamento por carga; o operador deve trabalhar pedido a pedido.
Após leitura e validação, nenhum pedido tem saldo compatível com o volume/EAN lido
Mensagem exibida: “Nenhum pedido possui saldo suficiente para processar este volume”
O que fazer: Conferir se o volume lido pertence de fato a um pedido de devolução em aberto com saldo disponível; verificar no ERP se o saldo do pedido está correto.
Exclusão de volume por leitura que não identifica um volume físico (sem tags de pallet, Volume ou EAN128)
Mensagem exibida: “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.”
O que fazer: Orientar o operador a usar a tela de listagem de volumes para localizar e excluir o item, em vez de ler um código solto.
Volume lido para exclusão não é encontrado em nenhum romaneio da chave de fato do pedido
Mensagem exibida: Mensagem informando que o volume não foi encontrado no romaneio.
O que fazer: Confirmar se o volume realmente pertence a essa devolução; verificar no ERP se o item já foi removido por outro meio.
Exclusão de volume ou de item de romaneio já contabilmente atualizado
Mensagem exibida: “Romaneio já atualizado”
O que fazer: Explicar ao operador que o romaneio já foi consolidado contabilmente; qualquer ajuste depende de desatualização via ERP pelo setor responsável.
Exclusão de volume que já possui movimentação posterior registrada
Mensagem exibida: Mensagem informando que o volume possui movimentação posterior.
O que fazer: Verificar no ERP qual movimentação posterior foi lançada sobre o volume antes de tentar excluí-lo novamente.
Exclusão de volume rastreado sem mercado consumidor habilitado
Mensagem exibida: “Volume não possui mercado consumidor”
O que fazer: Acionar o setor responsável pelo cadastro de mercado consumidor do volume antes de tentar a exclusão.
Exclusão de volume rastreado cuja rastreabilidade não está presente ou não está liberada na ordem de origem
Mensagem exibida: Mensagem informando rastreabilidade não presente/não liberada.
O que fazer: Verificar no ERP a rastreabilidade e a ordem de origem do volume antes de repetir a exclusão.
Exclusão de volume rastreado com mercados permitidos incompatíveis com os mercados do volume
Mensagem exibida: Mensagem informando incompatibilidade de mercados.
O que fazer: Confirmar com o setor de qualidade/rastreabilidade se os mercados cadastrados para o volume e para a rastreabilidade estão corretos.
Exclusão de volume rastreado deixaria a quantidade de peças consumidas da rastreabilidade negativa
Mensagem exibida: Mensagem de saldo insuficiente na rastreabilidade.
O que fazer: Verificar no ERP o saldo de peças consumidas da rastreabilidade antes de repetir a exclusão.
Remoção de item de romaneio cujo romaneio de origem não foi localizado
Mensagem exibida: “Romaneio não encontrado no documento”
O que fazer: Confirmar no ERP se o romaneio associado ao item ainda existe e está vinculado ao documento correto.
Consulta de pedido de devolução não encontra o pedido informado
Mensagem exibida: “Não foi possível executar a movimentação. Pedido não encontrado. Verifique o código lido.”
O que fazer: Conferir o código do pedido lido/digitado; verificar no ERP se o pedido de devolução realmente existe para a filial selecionada.
Pedido de devolução consultado está com situação diferente de “Ativo”
Mensagem exibida: Mensagem informando cliente/pedido inativo.
O que fazer: Verificar no ERP a situação do cliente/pedido antes de tentar processar a devolução.
Pedido de devolução consultado não possui nenhum item
Mensagem exibida: Mensagem informando pedido sem item.
O que fazer: Verificar no ERP se o pedido de devolução foi lançado corretamente com seus itens.
Perfil do tipo de movimento do pedido consultado é diferente de “VDA0203”
Mensagem exibida: Mensagem informando perfil incompatível.
O que fazer: Confirmar com o setor responsável se o pedido foi lançado com o tipo de movimento correto para devolução.
Romaneio de devolução obtido ou criado automaticamente tem perfil diferente de “VDA0202”
Mensagem exibida: Mensagem informando romaneio com perfil errado.
O que fazer: Acionar o suporte técnico/ERP para verificar a configuração de perfil do tipo de movimento usado na criação do romaneio de devolução.
Atualização de documento solicitada sem romaneio vinculado ao pedido
Mensagem exibida: “Não existem romaneio vinculado do documento atual”
O que fazer: Orientar o operador a realizar a expedição (bipar ao menos um volume) antes de tentar atualizar o documento, pois isso cria o romaneio.
Atualização de documento solicitada para um romaneio já contabilmente atualizado
Mensagem exibida: “Documento {filial}.{código}.{série}.{número} já está atualizado”
O que fazer: Explicar que o documento já foi consolidado; qualquer reversão depende de desatualização manual pelo setor responsável no sistema ERP.
Impressão não agrupada em que o pedido de devolução ou o romaneio vinculado não é encontrado pela chave de fato
Mensagem exibida: Mensagem de pedido não encontrado.
O que fazer: Confirmar se o pedido e o romaneio de devolução realmente existem e estão vinculados antes de repetir a impressão.
Finalização de pallet retorna HTTP 404 (pallet não localizado)
Mensagem exibida: “Pallet não encontrado”
O que fazer: Confirmar o código do pallet lido; verificar no ERP se o pallet existe e está vinculado à devolução em andamento.
Erro genérico de processamento durante qualquer operação do serviço de Devolução
Mensagem exibida: “Falha ao realizar Devolução.” (ou “Failed to perform Return.” / “Error al realizar la Devolución.”, conforme o idioma do usuário)
O que fazer: Registrar a mensagem completa exibida (inclui detalhe da exceção) e acionar o suporte técnico para investigar a causa raiz.
Casos de Uso
Caso 1 — Caminho feliz — devolução completa de um pedido
O operador seleciona o pedido de devolução 12.500 do dia; como é a primeira consulta, o sistema cria automaticamente o romaneio de devolução vinculado, usando a mesma série/numeração do pedido. O operador bipa os volumes retornados, um a um (ex.: volume de um lote pesando 287 kg), cada leitura sendo registrada com o código de rotina “20043”. Ao concluir a conferência de todos os volumes, o operador atualiza o documento e o romaneio de devolução é consolidado contabilmente no ERP.
Caso 2 — Exclusão de volume rastreado
Durante a conferência de uma devolução, o operador percebe que bipou um volume rastreado por engano e aciona a exclusão pela listagem de volumes. O sistema valida mercado consumidor, rastreabilidade liberada e mercados compatíveis; confirmada a exclusão, decrementa em 1 a quantidade de peças consumidas da rastreabilidade de origem.
Caso 3 — Caso de borda — pedido com romaneio de perfil incorreto
Ao consultar, na Devolução, um pedido cujo romaneio de devolução já existente foi criado com perfil diferente de “VDA0202” (por exemplo, por um erro de configuração de tipo de movimento no ERP), o sistema bloqueia a consulta informando romaneio com perfil errado, impedindo a continuidade até que o setor responsável corrija a configuração.
Caso 4 — Caso de borda — documento já atualizado
Na Devolução, o operador tenta atualizar o documento de uma devolução que outro operador já havia consolidado; o sistema recusa com “Documento {filial}.{código}.{série}.{número} já está atualizado”, evitando duplicidade de consolidação contábil.