Devolução de Compra

Rotina do módulo de Expedição do FrigosoftColetor para registrar devoluções ao fornecedor de mercadorias recebidas em compras anteriores.

ℹ Informação Importante

O fluxo da Devolução de Compra é específico e independente de outras rotinas de expedição, garantindo que o processamento seja correto mesmo compartilhando a mesma interface visual.

▶ Tutorial em vídeo: ainda não disponível para esta rotina.

Passo 1: Abrir a Devolução de Compra

O operador acessa o menu de Expedição do coletor e toca na opção “Devolução de Compra” (identificada pelo ícone de caixas empilhadas). A partir desse toque, o aplicativo passa a tratar toda a navegação seguinte como pertencente à Devolução de Compra.

Passo 2: Consultar a lista de pedidos do dia

O aplicativo carrega automaticamente a lista de pedidos do dia referente à filial do operador e à data de movimentação da sessão em uso.

Passo 3: Selecionar o pedido

O operador toca no pedido de devolução de compra que deseja conferir. O aplicativo consulta o detalhe desse pedido no servidor, informando a chave do documento e o código da filial, e traz de volta o cabeçalho do pedido (código, série, número, peso líquido, participante/fornecedor, situação de cadastro e dados de entrega) e a lista completa de itens do pedido, já com quantidades, taras, código de barras e indicadores necessários para a conferência.

Passo 4: Bipar (lançar) os itens a devolver

Para cada item que será devolvido ao fornecedor, o operador bipa o código de barras (ou informa o código manualmente) e registra a leitura. Cada leitura enviada ao sistema carrega o código lido, a quantidade, o peso, e os indicadores de transformação, repesagem, paletização e etiqueta múltipla, além da tara, do lote de fornecedor e da ordenação daquela leitura. O sistema grava essa leitura como um romaneio (registro de movimentação) vinculado ao item do pedido.

Passo 5: Conferir ou corrigir leituras já feitas (quando necessário)

Se precisar, o operador pode consultar os romaneios (leituras) já registrados para um item, para conferir o que já foi bipado, ou remover um item que foi bipado por engano antes de fechar o documento.

Passo 6: Imprimir etiqueta (quando necessário)

A qualquer momento durante a conferência, o operador pode solicitar a impressão de etiqueta do pedido em andamento.

Passo 7: Atualizar o documento

Depois de concluir a conferência de todos os itens a devolver, o operador aciona a atualização do documento, informando apenas a chave do pedido. Esse é o passo que consolida a devolução de compra no ERP.

Código do Documento / Série / Número

Tipo: texto/número (identificador do documento)

Obrigatoriedade: obrigatório (é usado para localizar o pedido no ERP)

Descrição: identifica de forma única o pedido de devolução de compra dentro da filial, combinando filial, número do documento, série e número.

Comportamento: é essa identificação que o aplicativo usa para buscar o cabeçalho e os itens do pedido no servidor; também aparece nas mensagens de bloqueio, no formato “filial.documento.serie.numero”, quando o documento ainda não está contabilizado.

Impacto: usado em todas as telas de detalhe do pedido, na impressão de etiqueta e nas mensagens de erro exibidas ao operador.

Peso Líquido

Tipo: número

Obrigatoriedade: não se aplica (informação trazida pelo sistema, não digitada pelo operador)

Descrição: peso líquido total do pedido de devolução de compra, calculado pelo ERP.

Comportamento: é exibido junto ao cabeçalho do pedido assim que o operador seleciona o pedido na lista do dia.

Impacto: acompanha o documento consolidado no ERP após a atualização da devolução de compra.

Participante (Fornecedor)

Tipo: texto (informação trazida do cadastro do ERP)

Obrigatoriedade: não se aplica (informação trazida pelo sistema)

Descrição: identifica o fornecedor para o qual a mercadoria está sendo devolvida.

Comportamento: é exibido no cabeçalho do pedido; também é usado internamente para verificar se existe cadastro de retirada vinculado a esse participante.

Impacto: aparece no cabeçalho do pedido e nos dados de participante incluídos na impressão de etiqueta.

Situação de Cadastro

Tipo: texto/indicador (informação trazida pelo sistema)

Obrigatoriedade: não se aplica

Descrição: indica a situação cadastral do pedido/participante no ERP no momento da consulta.

Comportamento: [informação não disponível na documentação de origem, validar com analista responsável quanto aos valores possíveis e ao que cada um representa para o operador]

Impacto: exibida junto ao cabeçalho do pedido.

Dados de Entrega

Tipo: texto (endereço/informações de entrega trazidas do cadastro)

Obrigatoriedade: não se aplica

Descrição: informações de entrega vinculadas ao pedido de devolução de compra, usadas para identificar para onde a mercadoria devolvida está indo.

Comportamento: são trazidas junto com o cabeçalho do pedido ao ser selecionado.

Impacto: reaproveitadas na impressão de etiqueta, junto com os endereços de faturamento do pedido e da entrega.

Quantidade Primária do Item

Tipo: número

Obrigatoriedade: não se aplica (calculada/trazida pelo sistema)

Descrição: quantidade do item na unidade principal de medida, tanto a quantidade própria do item quanto a soma vinda de eventuais itens filhos.

Comportamento: exibida na tabela de itens do pedido; é atualizada conforme as leituras (bipagens) são lançadas.

Impacto: usada na conferência do que já foi devolvido e consolidada no documento após a atualização.

Quantidade Auxiliar do Item

Tipo: número

Obrigatoriedade: não se aplica (calculada/trazida pelo sistema)

Descrição: quantidade do item em uma unidade de medida auxiliar (própria e de itens filhos), quando aplicável ao produto.

Comportamento: exibida junto com a quantidade primária na tabela de itens.

Impacto: usada na conferência e consolidada no documento final.

Unidade

Tipo: texto/seleção (trazida do cadastro do produto)

Obrigatoriedade: não se aplica

Descrição: unidade de medida do item exibido na tabela do pedido.

Comportamento: vem do cadastro do produto no ERP.

Impacto: usada para exibir corretamente as quantidades do item na tela e na etiqueta impressa.

Tara do Item

Tipo: número

Obrigatoriedade: não se aplica (calculada pelo sistema)

Descrição: peso de tara (interna e externa) descontado do peso bruto do item na devolução de compra.

Comportamento: o sistema usa a tara cadastrada no produto; se existir uma tara específica cadastrada para a filial do operador no PCP, essa tara específica sobrepõe a tara padrão do produto.

Impacto: afeta diretamente o peso líquido considerado na devolução de compra daquele item.

Indicador de Repesagem

Tipo: indicador (sim/não)

Obrigatoriedade: não se aplica (trazido do cadastro)

Descrição: informa se o item exige repesagem durante a conferência da devolução de compra.

Comportamento: vem do cadastro do PCP do produto.

Impacto: orienta o operador sobre a necessidade de repesar o item antes ou durante a bipagem.

Indicador de Transformação

Tipo: indicador (sim/não)

Obrigatoriedade: não se aplica (trazido do cadastro)

Descrição: informa se o item está sujeito a transformação dentro do processo de conferência.

Comportamento: vem do cadastro do PCP do produto.

Impacto: usado tanto na exibição do item quanto no payload enviado quando o operador lança a leitura desse item.

Código de Barras do Item

Tipo: texto/código (lido pelo leitor de código de barras ou digitado)

Obrigatoriedade: obrigatório para identificar o item durante a bipagem

Descrição: código usado para identificar o item físico durante a conferência da devolução de compra.

Comportamento: o sistema usa o GTIN cadastrado do produto; se o produto não tiver GTIN cadastrado, o sistema usa o código EAN padrão do produto no lugar.

Impacto: é o código de barras que o operador bipa nesta e nas demais telas da rotina, e o que aparece impresso na etiqueta de venda ou de compra do item.

Código Lido (na leitura/bipagem)

Tipo: texto/código

Obrigatoriedade: obrigatório para registrar uma leitura

Descrição: código efetivamente lido (bipado) pelo operador no momento do lançamento do item a devolver.

Comportamento: enviado ao sistema junto com quantidade, peso e demais indicadores da leitura.

Impacto: gera um novo romaneio (registro de movimentação) vinculado ao item do pedido.

Quantidade (na leitura/bipagem)

Tipo: número

Obrigatoriedade: obrigatório para registrar uma leitura

Descrição: quantidade do item que está sendo devolvida naquele lançamento.

Comportamento: enviada junto com o código lido e o peso ao registrar a leitura.

Impacto: soma-se às quantidades já lançadas para o item e é consolidada no documento ao final.

Peso (na leitura/bipagem)

Tipo: número

Obrigatoriedade: obrigatório para registrar uma leitura, quando o item é pesável

Descrição: peso do item devolvido naquele lançamento específico.

Comportamento: enviado junto com o código lido e a quantidade; participa do cálculo do peso líquido do pedido de devolução de compra.

Impacto: consolidado no peso líquido do documento após a atualização.

Indicador de Paletização

Tipo: indicador (sim/não)

Obrigatoriedade: condicional (aplicável quando o item é lançado em pallet)

Descrição: informa se aquela leitura está sendo lançada como parte de um pallet.

Comportamento: enviado junto com o restante do payload da leitura, tanto ao lançar quanto ao remover um item já romaneado.

Impacto: influencia como o romaneio (pallet/volume) daquele item é organizado e depois impresso na etiqueta.

Indicador de Etiqueta Múltipla

Tipo: indicador (sim/não)

Obrigatoriedade: condicional

Descrição: informa se aquela leitura corresponde a um lançamento com etiqueta múltipla (mais de um volume na mesma leitura).

Comportamento: enviado junto com o restante do payload da leitura.

Impacto: influencia a geração dos romaneios (pallets/volumes) vinculados ao item.

Lote de Fornecedor

Tipo: texto

Obrigatoriedade: condicional (quando aplicável ao item/produto)

Descrição: identifica o lote de origem do fornecedor para o item devolvido.

Comportamento: enviado junto com o restante do payload de leitura ao lançar ou remover um item.

Impacto: [informação não disponível na documentação de origem sobre onde esse dado é exibido posteriormente, validar com analista responsável]

Ordenação

Tipo: número/indicador de ordem

Obrigatoriedade: [informação não disponível na documentação de origem, validar com analista responsável]

Descrição: define a ordem de exibição ou de processamento daquela leitura entre as demais leituras do mesmo item.

Comportamento: enviada junto com o restante do payload de leitura.

Impacto: [informação não disponível na documentação de origem, validar com analista responsável]

Listagem Automática de Pedidos do Dia

Ao entrar na Devolução de Compra, o operador já vê automaticamente a lista de pedidos do dia referente à sua filial e à data de movimentação da sessão em uso; não é necessário aplicar nenhum filtro adicional para essa lista inicial.

Consulta de Romaneios de Item Específico

Para conferir o que já foi lançado em um item específico, o operador pode consultar os romaneios (leituras) já registrados daquele item. Essa consulta é feita informando a chave do documento (pedido), o número do item e o número do subitem. Diferente do que acontece no fluxo de RPS, essa consulta na Devolução de Compra não usa nenhum filtro de rastreabilidade ativa: ela sempre traz todos os romaneios já lançados para aquele item.

⚠ Limitação: Sem Agrupamento por Carga

A Devolução de Compra não oferece a opção de consultar pedidos agrupados por carga (vários pedidos ligados pela mesma chave de fato de frete). Se o operador tentar usar esse tipo de consulta ou movimentação agrupada, o sistema bloqueia a operação com a mensagem “Nao foi possivel gerar agrupamento. Agrupamento nao suportado para entradas.”. Nesses casos, o operador precisa consultar e trabalhar pedido a pedido.

Dados de Cabeçalho: Não Editáveis

Os dados de cabeçalho do pedido (peso líquido, participante, situação de cadastro, dados de entrega) são trazidos diretamente do ERP e não são editáveis dentro da tela de Devolução de Compra; eles apenas refletem o que já está lançado no ERP.

Alteração de Itens Já Bipados

O que pode ser alterado durante a conferência é a lista de itens já bipados: o operador pode remover um item que já foi romaneado (lançado) por engano, antes de concluir a atualização do documento. Para 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 que será removido.

ℹ Validação Pendente

A documentação de origem não detalha se existe algum status do pedido que bloqueie especificamente a remoção de um item já lançado (por exemplo, um item que já tenha sido considerado em alguma etapa posterior do processo) nem se existe um histórico/log específico dessas remoções visível ao operador. [informação não disponível na documentação de origem, validar com analista responsável]

ℹ Pós-Atualização

Depois que o operador conclui a atualização do documento (Passo 7 do processo de criação), essa ação consolida a devolução de compra no ERP. A documentação de origem não detalha se, e em que condições, é possível reabrir ou alterar um documento de Devolução de Compra depois dessa atualização. [informação não disponível na documentação de origem, validar com analista responsável]

Modo Próprio de Processamento

Por trás da tela, a Devolução de Compra funciona como um “modo” próprio dentro do aplicativo: assim que o operador entra nessa opção do menu, todas as consultas e lançamentos seguintes passam a usar o caminho específico da Devolução de Compra no servidor, diferente do caminho usado pela Expedição normal, pela Devolução de Venda, pelo Romaneio de Compra ou pelo RPS. Isso é o que garante que, mesmo a tela sendo visualmente igual à de outras rotinas de expedição por pedido, o processamento por trás seja o correto para uma devolução ao fornecedor.

Registro no ERP como Documento de Saída

No ERP, esse documento é registrado do lado de Saída, na mesma estrutura usada para Expedição normal, Devolução de Venda e RPS; o que diferencia esses processos entre si é o perfil de tipo de movimento configurado no documento (para a Devolução de Compra, os perfis “CPA0203” no pedido e “CPA0202” no romaneio vinculado, conforme descrito nos pré-requisitos).

Consulta de Detalhe do Pedido

Quando o operador consulta o detalhe de um pedido, o sistema primeiro confirma que o documento tem o perfil correto de Devolução de Compra e localiza o romaneio vinculado a ele antes de trazer qualquer informação para a tela. Se as condições para busca dos dados de retirada forem atendidas (pedido do lado de Saída, usuário logado com cadastro vinculado e pedido com cadastro de retirada definido), o sistema também busca automaticamente os dados da filial de retirada relacionada ao pedido; quando o fornecedor tem vínculo com mais de uma filial, o sistema prioriza o cadastro da mesma filial do pedido.

Impressão de Etiqueta

Quando o operador solicita a impressão de etiqueta, o sistema busca o pedido e depois o romaneio vinculado a ele; encontrando os dois, monta automaticamente um objeto de impressão com, para cada item do documento: dados do produto (código, referência, nome, unidade), as quantidades, o código de barras, o layout de etiqueta correto (de venda ou de compra, conforme o cadastro do item), sexo do animal e dados de temperatura quando aplicáveis ao produto, informações de SIF/DIPOA, os romaneios (pallets/volumes) vinculados a cada item, além dos dados do fornecedor e dos endereços de faturamento e de entrega do pedido.

Registro de Auditoria

Todas as operações realizadas dentro da Devolução de Compra (consultas, lançamentos, remoções, impressões e a atualização final) são registradas internamente pelo sistema sob um código fixo de rotina, usado para fins de auditoria e de rastreio técnico das operações realizadas no ERP. Esse registro acontece automaticamente, sem qualquer ação adicional do operador.

ℹ Comportamento de Mensagens Informativas

Diferente das rotinas de Expedição normal e de RPS, a Devolução de Compra não exibe ao operador o banner de mensagens informativas que o servidor eventualmente retorna após um lançamento bem-sucedido, mesmo quando essa mensagem existe. Isso é um comportamento esperado desta rotina, e não uma falha.

Classificação Obrigatória do Pedido e do Romaneio

Um documento só é reconhecido pelo sistema como pedido de Devolução de Compra se estiver classificado no ERP com o perfil de tipo de movimento de estoque “CPA0203”. O romaneio vinculado a esse pedido só é reconhecido como romaneio de Devolução de Compra se estiver classificado com o perfil “CPA0202”. Sem essa classificação correta em ambos, o pedido não aparece corretamente disponível para esta rotina.

Documento Sempre do Lado de Saída

A Devolução de Compra é sempre tratada no ERP como um documento do lado de Saída de mercadoria, na mesma estrutura usada pela Expedição normal, pela Devolução de Venda e pelo RPS. A diferença entre esses processos está apenas no perfil de tipo de movimento configurado, não na estrutura do documento em si.

Documento Precisa Estar Contabilizado para Ser Consultado

Se a validação de atualização estiver habilitada e o documento consultado ainda não estiver contabilizado no ERP (situação contábil diferente de “S”), o sistema bloqueia a consulta com a mensagem “Documento com identificacao {filial}.{documento}.{serie}.{numero} ainda nao foi atualizado.”. Nesse caso, é preciso aguardar a contabilização do documento no ERP ou acionar o setor responsável antes de tentar novamente.

Pedido e Romaneio Precisam Existir para a Impressão de Etiqueta

A impressão de etiqueta de um pedido de Devolução de Compra só é realizada se o pedido e o romaneio vinculado a ele forem localizados pela chave informada. Se qualquer um dos dois não for encontrado, o sistema recusa a impressão com a mensagem “Nao foi possivel executar a movimentacao. Pedido nao encontrado.”.

Cálculo da Tara do Item

A tara (interna e externa) considerada na devolução de compra vem do cadastro do produto; se existir uma tara específica cadastrada para a filial do operador no PCP, essa tara específica sobrepõe a tara padrão do produto no cálculo do peso líquido do item.

Código de Barras com Substituto Automático

O código de barras usado para identificar o item é o GTIN cadastrado no produto; se o produto não tiver GTIN cadastrado, o sistema usa automaticamente o código EAN padrão do produto no lugar.

Indicadores de Repesagem e de Transformação Vêm do Cadastro

Os indicadores que informam se um item exige repesagem ou está sujeito a transformação vêm diretamente do cadastro do PCP do produto; o operador não define esses indicadores manualmente na tela.

Agrupamento por Carga Não é Suportado

A Devolução de Compra não suporta consultar ou movimentar pedidos agrupados pela mesma chave de fato de frete (carga agrupada). Qualquer tentativa nesse sentido é bloqueada com a mensagem “Nao foi possivel gerar agrupamento. Agrupamento nao suportado para entradas.”, e o operador precisa trabalhar pedido a pedido.

Condições para Busca dos Dados de Retirada

Os dados de retirada de um pedido de Devolução de Compra só são buscados automaticamente quando três condições são atendidas ao mesmo tempo: o pedido é do lado de Saída, o usuário que está logado tem cadastro vinculado, e o pedido tem um cadastro de retirada definido. Quando o fornecedor (participante) tem vínculo com mais de uma filial, o sistema prioriza o cadastro da mesma filial do pedido.

Nenhuma Confirmação Informativa é Exibida Após o Lançamento

Diferente da Expedição normal e do RPS, a Devolução de Compra não exibe ao operador nenhuma mensagem informativa de confirmação após um lançamento bem-sucedido, mesmo quando o servidor retorna esse tipo de mensagem. Esse é o comportamento esperado da rotina, e o operador deve conferir a lista de itens/romaneios na tela para confirmar que o lançamento foi aplicado corretamente.

Mensagens de Erro Variam Conforme o Idioma do Operador

Quando ocorre uma falha inesperada em qualquer operação da Devolução de Compra (consulta, lançamento, remoção, impressão ou atualização), o sistema exibe uma mensagem de erro genérica, cujo texto varia conforme o idioma configurado: em português (ou idioma não mapeado) aparece “Falha ao realizar devolução de compra.”, em inglês aparece “Failed to perform Purchase Return.” e em espanhol aparece “Error al realizar la Devolucion de Compra.”. Em qualquer um desses casos, o operador deve registrar a mensagem completa exibida e acionar o suporte técnico para investigar a causa.

Registro de Auditoria Fixo para Todas as Operações

Toda operação realizada dentro da Devolução de Compra é registrada internamente pelo sistema sob um código fixo de rotina (“20089”), usado para fins de auditoria e de rastreio técnico das operações no ERP. Esse registro é automático e não depende de nenhuma ação extra do operador.