Devolução de Compra
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.
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.
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).
Fluxo Operacional
- O operador abre o menu de Expedição e seleciona a opção “Devolução de
Compra” (ícone de caixas empilhadas).
- 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.
- 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.
- 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).
- Se necessário, o operador consulta os romaneios já registrados de um
item, ou remove um item já romaneado.
- O operador pode solicitar a impressão de etiqueta a qualquer momento
durante o processo.
- 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.
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).
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.
Feedbacks ao Operador
| Situação | Feedback | Texto exato |
|---|---|---|
| Lançamento bem-sucedido na Devolução de Compra, mesmo quando o servidor retorna mensagens informativas | Nenhum 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 Compra | Bloqueio | “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 habilitada | Bloqueio | “Documento com identificacao {filial}.{documento}.{serie}.{numero} ainda nao foi atualizado.” |
| Impressão de etiqueta quando o pedido ou o romaneio vinculado não é localizado | Bloqueio | “Nao foi possivel executar a movimentacao. Pedido nao encontrado.” |
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.
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.
Troubleshooting
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.
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.
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.
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.
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.
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.