• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • Frigosoft
    • Coletor
      • Teste de Leitor e Coletores Homologados
      • abate
        • Abate de Emergência
        • Aspersão
        • DIF — Declaração de Inspeção Federal
        • Endereçamento de Carcaças
        • Evidências
        • Ocorrências
        • Rastreamento do Abate
        • Registro de pH
        • Tipificação
        • Condenação de Carcaça
      • estocagem
        • Paletização Simples
        • Paletização com Documento
        • Reimpressão Pallet Pré-Impresso
      • expedicao
        • Devolução
        • Devolução de Compra
      • producao
        • Montagem de Kit
      • pescados
        • Geração de Pedido de Pescados
        • Tipificação de Pescados
      • Apontamento de Fracionados
      • Rastreamento 01
        • Bloqueio Quantidade
        • Leitura D.I.A
    • Procedimentos Frigosoft
      • Balanção
      • Configuração Filial
      • Configurações de Tipo de Movimento
      • Fluxo
      • Contrato de Compra
    • Inventário de Estoque
      • Inventário de Meia Carcaça
      • Inventário por Local
      • Inventário por Produto
      • Inventário Rotativo
      • Inventário Total
      • Unificação de Inventário
Nenhum resultado encontrado
Inteligência Atak / Documentação / Frigosoft / Coletor / expedicao

Devolução

Criado por Igor Ribeiro em 31 de agosto de 2026
•
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Documentação Técnica

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).

01. VISÃO GERAL

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.

02. PRÉ-REQUISITOS

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.
03. FLUXO OPERACIONAL

Fluxo Operacional

  1. 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.
  2. O operador consulta os pedidos de devolução disponíveis para a data de movimentação corrente.
  3. 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.
  4. 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”.
  5. 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.
  6. 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).
  7. 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.
04. INTERFACE E COMPORTAMENTOS DO APP

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.
05. LEITURAS DE CÓDIGO DE BARRAS

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.
06. FEEDBACKS AO OPERADOR

Feedbacks ao Operador

Feedbacks — Consulta de pedido de devolução

SituaçãoFeedbackMensagem
Consulta de pedido ou de pedidos do dia sem filial selecionada na sessãoBloqueio“Filial não informada”
Consulta de pedido de devolução não encontradoBloqueio“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 AtivoBloqueiomensagem informando cliente/pedido inativo
Consulta de pedido sem nenhum itemBloqueiomensagem informando pedido sem item
Consulta de pedido com perfil de tipo de movimento incompatível (diferente de VDA0203)Bloqueiomensagem informando perfil incompatível
Romaneio de devolução criado/reaproveitado com perfil diferente de VDA0202Bloqueiomensagem informando romaneio com perfil errado

Feedbacks — Movimentação de adicionar na Devolução

SituaçãoFeedbackMensagem
Retorno informativo do backend após movimentação de adicionar, quando o tipo em curso é DevoluçãoNenhum feedback exibido(nenhum — o campo é descartado silenciosamente; ver Possíveis Bugs, BUG-2)
Tentativa de movimentação agrupada por carga em DevoluçãoBloqueio“Não foi possível gerar agrupamento. Agrupamento não suportado para entradas.”
Nenhum pedido com saldo compatível com o volume/EAN lidoBloqueio“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çãoFeedbackMensagem
Exclusão por leitura que não identifica um volume físicoBloqueio“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 fatoBloqueiomensagem informando que o volume não foi encontrado no romaneio
Exclusão de volume/item de romaneio já contabilmente atualizadoBloqueio“Romaneio já atualizado”
Exclusão de volume com movimentação posterior registradaBloqueiomensagem informando que o volume possui movimentação posterior
Exclusão de volume rastreado sem mercado consumidor habilitadoBloqueio“Volume não possui mercado consumidor”
Exclusão de volume rastreado sem rastreabilidade presente/liberada na ordem de origemBloqueiomensagem informando rastreabilidade não presente/não liberada
Exclusão de volume rastreado com mercados incompatíveis entre rastreabilidade e volumeBloqueiomensagem informando incompatibilidade de mercados
Exclusão de volume rastreado que deixaria a rastreabilidade com saldo negativo de peçasBloqueiomensagem de saldo insuficiente na rastreabilidade
Remoção de item de romaneio cujo romaneio de origem não foi encontradoBloqueio“Romaneio não encontrado no documento”

Feedbacks — Atualização de documento de devolução

SituaçãoFeedbackTexto exato
Atualização de documento sem romaneio vinculadoBloqueio“Não existem romaneio vinculado do documento atual”
Atualização de documento já contabilmente atualizadoBloqueio“Documento {filial}.{código}.{série}.{número} já está atualizado”

Feedbacks — Impressão e finalização de pallet na Devolução

SituaçãoFeedbackMensagem
Impressão: pedido de devolução ou romaneio vinculado não encontrado pela chave de fatoBloqueiomensagem de pedido não encontrado
Impressão de carga agrupada em DevoluçãoNenhum bloqueio — retorna lista vazia(nenhuma mensagem — devolução não suporta impressão agrupada por carga)
Finalização de pallet retornando HTTP 404Bloqueio“Pallet não encontrado”

Feedbacks — Erros genéricos do serviço de Devolução

SituaçãoFeedbackTexto 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.”
07. PROCESSAMENTO PELO BACKEND

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”).

08. REGRAS DE NEGÓCIO

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.
09. COMPORTAMENTO OFFLINE

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.

10. INTEGRAÇÕES

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.
11. TROUBLESHOOTING

Troubleshooting

T-01

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.

T-02

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.

T-03

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.

T-04

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.

T-05

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.

T-06

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.

T-07

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.

T-08

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.

T-09

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.

T-10

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.

T-11

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.

T-12

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.

T-13

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.

T-14

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.

T-15

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.

T-16

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.

T-17

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.

T-18

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.

T-19

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.

T-20

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.

T-21

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.

T-22

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.

12. CASOS DE USO

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.

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Fluxo Operacional
  • Interface e Comportamentos do App
  • Leituras de Código de Barras
  • Feedbacks ao Operador
  • Processamento pelo Backend
  • Regras de Negócio
  • Comportamento Offline
  • Integrações
  • Troubleshooting
  • Casos de Uso
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06