• 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 de Compra

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 de Compra — Expedição (FrigosoftColetor)

A Devolução de Compra é a rotina do módulo de Expedição usada para registrar a devolução ao fornecedor de mercadoria recebida anteriormente por uma compra.

01. VISÃO GERAL

Visão Geral

A Devolução de Compra é a rotina do módulo de Expedição usada para registrar a devolução ao fornecedor de mercadoria recebida anteriormente por uma compra. Ao abrir a tela, o aplicativo fixa internamente o fluxo como “Devolução de Compra” — essa marcação direciona todas as chamadas ao servidor desta tela para os endpoints específicos deste processo, diferentes dos usados por Expedição normal, Devolução (de venda), Romaneio de Compra ou RPS.

A tela reaproveita o mesmo layout de tela de pedido único usado pelos demais fluxos por pedido do módulo de Expedição (seleção de pedido do dia, tabela de itens, botões de ação) — não há layout próprio para esta feature; toda a diferenciação ocorre nos endpoints chamados ao servidor.

No ERP, a Devolução de Compra é processada como um documento do lado de Saída (mesma tabela usada por Expedição normal, Devolução de Venda e RPS); a distinção entre esses processos é feita exclusivamente pelo perfil de tipo de movimento do documento. No fluxo do frigorífico, a Devolução de Compra ocorre depois que a compra original foi recebida e o pedido de devolução ao fornecedor foi lançado no ERP, e antes da baixa contábil (atualização) do romaneio de devolução gerado.

02. PRÉ-REQUISITOS

Pré-requisitos

  • O documento a ser consultado precisa estar classificado no ERP com o

perfil de tipo de movimento de estoque “CPA0203” — só assim é reconhecido como pedido de Devolução de Compra.

  • O romaneio (movimentação já lançada) vinculado ao pedido precisa ter o

perfil “CPA0202”; é por esse perfil que o ERP identifica o romaneio de Devolução de Compra.

  • O documento consultado precisa estar contabilizado (status contábil igual

a “S”); se não estiver e a validação de atualização estiver habilitada, a consulta é bloqueada (ver Troubleshooting).

  • Para a impressão de etiqueta, o pedido e o romaneio vinculado a ele

precisam existir e ser localizados pela chave informada; se qualquer um dos dois não for encontrado, a operação é recusada (ver Troubleshooting).

03. FLUXO OPERACIONAL

Fluxo Operacional

  1. O operador abre o menu de Expedição e seleciona a opção “Devolução de

Compra” (ícone de caixas empilhadas).

  1. O aplicativo fixa internamente o fluxo como “Devolução de Compra” e

carrega a lista de pedidos do dia para a filial e a data de movimentação da sessão.

  1. O operador seleciona um pedido; o aplicativo consulta o detalhe do

pedido (cabeçalho, itens, quantidades, taras, código de barras) informando a chave do documento e o código da filial.

  1. O operador bipa (lança) as leituras dos itens a devolver; cada leitura é

enviada ao servidor com código lido, quantidade, peso e demais indicadores da movimentação (transformação, repesagem, paletização, etiqueta múltipla, tara, lote de fornecedor, ordenação).

  1. Se necessário, o operador consulta os romaneios já registrados de um

item, ou remove um item já romaneado.

  1. O operador pode solicitar a impressão de etiqueta a qualquer momento

durante o processo.

  1. Ao concluir a conferência, o operador atualiza manualmente o documento,

enviando apenas a chave do documento, para consolidar a devolução de compra no ERP.

04. INTERFACE E COMPORTAMENTOS DO APP

Interface e Comportamentos do App

  • A tela de Devolução de Compra reutiliza o mesmo layout de pedido único

das demais rotinas de expedição por pedido — seleção de pedido do dia, tabela de itens e botões de ação. Não há elementos de tela exclusivos da Devolução de Compra; a rotina se diferencia apenas pelos endpoints chamados ao servidor.

  • Após um lançamento bem-sucedido, o banner de mensagens informativas

retornadas pelo servidor (retorno informativo) NÃO é exibido na Devolução de Compra, mesmo que o servidor devolva mensagens informativas no lançamento. Esse banner só aparece nos fluxos de Expedição normal e RPS.

  • A Devolução de Compra não suporta o modo de trabalho agrupado por carga

(vários pedidos vinculados pela mesma chave de fato do frete); qualquer tentativa de consultar ou movimentar por carga agrupada é bloqueada (ver Troubleshooting).

05. LEITURAS DE CÓDIGO DE BARRAS

Leituras de Código de Barras

  • Ao consultar os romaneios já registrados de um item na Devolução de

Compra, o aplicativo informa a chave do documento, o número do item e o número do subitem — diferente do fluxo RPS, essa consulta não envia o indicador de filtro de rastreabilidade ativa.

  • Ao remover um item já romaneado, o aplicativo envia a chave do documento,

o número do item, o número do subitem e a sequência do romaneio.

  • Ao lançar ou remover uma leitura, o aplicativo envia o mesmo payload de

movimentação em ambos os casos: código lido, quantidade, peso, indicadores de transformação, repesagem, paletização e etiqueta múltipla, tara, lote de fornecedor e ordenação.

06. FEEDBACKS AO OPERADOR

Feedbacks ao Operador

SituaçãoFeedbackTexto exato
Lançamento bem-sucedido na Devolução de Compra, mesmo quando o servidor retorna mensagens informativasNenhum feedback exibido(nenhum — o banner de retorno informativo não é exibido nesta rotina)
Tentativa de consulta ou movimentação por carga agrupada na Devolução de CompraBloqueio“Nao foi possivel gerar agrupamento. Agrupamento nao suportado para entradas.”
Falha inesperada em qualquer operação de Devolução de Compra no backend (idioma português ou não mapeado)mensagem de erro“Falha ao realizar devolução de compra.”
Falha inesperada em qualquer operação de Devolução de Compra no backend (idioma inglês)mensagem de erro“Failed to perform Purchase Return.”
Falha inesperada em qualquer operação de Devolução de Compra no backend (idioma espanhol)mensagem de erro“Error al realizar la Devolucion de Compra.”
Consulta de documento ainda não contabilizado, com validação de atualização habilitadaBloqueio“Documento com identificacao {filial}.{documento}.{serie}.{numero} ainda nao foi atualizado.”
Impressão de etiqueta quando o pedido ou o romaneio vinculado não é localizadoBloqueio“Nao foi possivel executar a movimentacao. Pedido nao encontrado.”
07. PROCESSAMENTO PELO BACKEND

Processamento pelo Backend

Consulta do pedido de devolução de compra

O backend só reconhece um documento como pedido de Devolução de Compra depois de classificá-lo pelo perfil de tipo de movimento de estoque e de localizar o romaneio vinculado pelo perfil correspondente (ver Regras de Negócio); só então prossegue com a consulta.

  • Consulta de Detalhe do Pedido: o backend localiza o documento pela

chave informada, exigindo que esteja contabilizado (status contábil igual a “S”); em seguida localiza o romaneio vinculado (documento cujo perfil é o de romaneio de Devolução de Compra). Retorna o cabeçalho (código, série, número, peso líquido, participante, situação de cadastro, dados de entrega) e a lista de itens do pedido, com quantidades primária e auxiliar (próprias e de itens filhos), unidade, taras do produto (ver Regras de Negócio), indicadores de repesagem e de transformação (ver Regras de Negócio) e o código de barras do item (ver Regras de Negócio).

  • Se o documento consultado ainda não estiver contabilizado e a

validação de atualização estiver habilitada: a consulta é bloqueada com “Documento com identificacao {filial}.{documento}.{serie}.{numero} ainda nao foi atualizado.”

  • Dados de Retirada: quando as condições para busca dos dados de

retirada são atendidas (ver Regras de Negócio), o backend busca também os dados da filial de retirada do pedido de Devolução de Compra.

Agrupamento por carga na devolução de compra

A Devolução de Compra não suporta consulta nem movimentação por carga agrupada (ver Regras de Negócio). Qualquer tentativa de obter lista de pedidos por carga, obter pedido + romaneio por carga ou consultar carga agrupada é bloqueada com “Nao foi possivel gerar agrupamento. Agrupamento nao suportado para entradas.”

Impressão de etiqueta da devolução de compra

Para a impressão de etiqueta da Devolução de Compra, o backend busca o pedido pela chave informada e, em seguida, busca o romaneio vinculado a esse pedido (documento cuja origem é a chave do pedido). Se o pedido não for localizado, ou se o romaneio vinculado não for localizado, o backend recusa a operação com “Nao foi possivel executar a movimentacao. Pedido nao encontrado.” Quando ambos são localizados, o objeto de impressão gerado inclui, por item do documento: dados do produto (código, referência, nome, unidade), quantidades (primária, auxiliar e de itens filhos), código de barras, layout de etiqueta de venda ou de compra conforme o cadastro do item, sexo do animal e dados de temperatura quando aplicáveis, SIF/DIPOA, e os romaneios (pallets/volumes) vinculados a cada item, além dos dados de participante e endereços de faturamento do pedido e da entrega.

Auditoria das operações de devolução de compra

Toda operação de Devolução de Compra é registrada internamente sob um código de rotina fixo (ver Regras de Negócio), usado para fins de auditoria e rastreio técnico das operações no ERP.

08. REGRAS DE NEGÓCIO

Regras de Negócio

  • Perfis de classificação: pedido de Devolução de Compra = perfil de

tipo de movimento de estoque “CPA0203”; romaneio vinculado = perfil “CPA0202”. Essa classificação direciona toda consulta e lançamento da rotina.

  • Lado do documento no ERP: Devolução de Compra é sempre um documento

do lado de Saída — mesma tabela usada por Expedição normal, Devolução de Venda e RPS.

  • Código de rotina de auditoria: “20089”, fixo para todas as operações

desta rotina.

  • Agrupamento por carga: não suportado; qualquer tentativa de consulta

ou movimentação agrupada por chave de frete é bloqueada.

  • Mensagem de erro genérica por idioma: português ou não mapeado →

“Falha ao realizar devolução de compra.”; inglês → “Failed to perform Purchase Return.”; espanhol → “Error al realizar la Devolucion de Compra.”

  • Cálculo de tara do item: tara interna e externa vêm do cadastro do

produto, com sobreposição pelas taras específicas da filial cadastradas no PCP quando existirem.

  • Código de barras do item: GTIN cadastrado; se não houver GTIN, usa o

EAN padrão do produto (fallback).

  • Indicadores de repesagem e transformação: vêm do cadastro do PCP do

produto.

  • Dados de retirada: só são buscados quando o pedido é do lado de

Saída, o usuário logado tem cadastro vinculado, e o pedido tem cadastro de retirada definido; quando o participante tem vínculo em mais de uma filial, prioriza-se o cadastro na mesma filial do pedido.

09. TROUBLESHOOTING

Troubleshooting

T-01

Documento de devolução de compra ainda não contabilizado

Cenário: o operador consulta um documento de Devolução de Compra que ainda não está contabilizado, com a validação de atualização habilitada.

Mensagem exibida: “Documento com identificacao {filial}.{documento}.{serie}.{numero} ainda nao foi atualizado.”

O que fazer: Confirmar se o pedido de devolução de compra já foi contabilizado no ERP; se não, aguardar a contabilização ou acionar o setor responsável.

T-02

Pedido ou romaneio não localizado na impressão de etiqueta

Cenário: o operador solicita a impressão de etiqueta de um pedido de Devolução de Compra e o pedido ou o romaneio vinculado a ele não é localizado pela chave informada.

Mensagem exibida: “Nao foi possivel executar a movimentacao. Pedido nao encontrado.”

O que fazer: Confirmar se o pedido de devolução de compra e o romaneio vinculado realmente existem no ERP com a chave informada antes de repetir a impressão.

T-03

Agrupamento por carga não suportado

Cenário: o operador tenta consultar ou movimentar pedidos agrupados por carga (mesma chave de fato do frete) na Devolução de Compra.

Mensagem exibida: “Nao foi possivel gerar agrupamento. Agrupamento nao suportado para entradas.”

O que fazer: Nenhuma ação corretiva — a Devolução de Compra não suporta agrupamento por carga; orientar o operador a trabalhar pedido a pedido.

T-04

Falha inesperada no backend da devolução de compra

Cenário: ocorre em qualquer operação de Devolução de Compra no backend (consulta, lançamento, remoção, impressão ou atualização).

Mensagem exibida: “Falha ao realizar devolução de compra.” (ou “Failed to perform Purchase Return.” / “Error al realizar la Devolucion de Compra.”, conforme o idioma do usuário)

O que fazer: Registrar a mensagem completa exibida e acionar o suporte técnico para investigar a causa raiz.

T-05

Nenhuma confirmação exibida após lançamento bem-sucedido

Cenário: o operador lança uma leitura com sucesso na Devolução de Compra, mas não recebe nenhuma confirmação informativa em tela, mesmo quando o servidor devolveu uma mensagem informativa no lançamento.

Mensagem exibida: Nenhuma — o banner de retorno informativo não é exibido nesta rotina (comportamento esperado, não é falha).

O que fazer: Nenhuma ação corretiva necessária; orientar o operador a conferir a lista de itens/romaneios para confirmar que o lançamento foi aplicado.

10. CASOS DE USO

Casos de Uso

Caso 1 — Caminho feliz — devolução de compra completa

O operador abre a Devolução de Compra, seleciona o pedido do dia referente a uma compra de matéria-prima já recebida, consulta o detalhe do pedido e bipa os itens a devolver ao fornecedor, um a um — por exemplo, um item pesando 287 kg. Ao concluir, atualiza o documento, consolidando a devolução no ERP.

Caso 2 — Item com tara específica de filial

Ao consultar o detalhe de um pedido de Devolução de Compra, um dos itens tem tara específica cadastrada no PCP para a filial do operador; essa tara sobrepõe a tara padrão do cadastro do produto, e o peso líquido considerado na devolução de compra usa o valor da filial.

Caso 3 — Caso de borda — romaneio não localizado na impressão

O operador tenta imprimir a etiqueta de um pedido de Devolução de Compra cujo romaneio vinculado ainda não foi gerado; o sistema recusa a impressão com “Nao foi possivel executar a movimentacao. Pedido nao encontrado.”, e o operador é orientado a lançar ao menos uma leitura antes de tentar novamente.

Caso 4 — Caso de borda — tentativa de agrupamento por carga

O operador tenta consultar pedidos agrupados por frete na Devolução de Compra (fluxo disponível em outras rotinas de expedição); o sistema bloqueia com a mensagem de agrupamento não suportado, e o operador precisa consultar pedido a pedido.

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
  • 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