WRSUP017 – Histórico de fornecedor
WRSUP017 – Histórico de fornecedor — Suprimentos (ERPAtak)
O relatório WRSUP017 – Histórico de fornecedor, do módulo Suprimentos (menu Relatórios), mostra o que cada fornecedor vendeu à filial no período: por fornecedor e produto, as quantidades compradas, o frete, o valor e o custo da compra e os impostos; mais um quadro com as devoluções ao fornecedor e um quadro de análise (primeira e última compra, maior e menor compra, prazo e atrasos).
Visão Geral
O relatório WRSUP017 – Histórico de fornecedor, do módulo Suprimentos (menu Relatórios), mostra o que cada fornecedor vendeu à filial no período: por fornecedor e produto, as quantidades compradas, o frete, o valor e o custo da compra e os impostos; mais um quadro com as devoluções ao fornecedor e um quadro de análise (primeira e última compra, maior e menor compra, prazo e atrasos). Serve ao comprador e ao gestor de suprimentos que avaliam fornecedores e negociam preço e prazo. Os dados vêm das notas de compra do perfil SUP0501 (Suprimentos – Nota de Compra), com seus itens, impostos e parcelas, e das notas de devolução do perfil SUP0601 (Suprimentos – Devolução Nota de Compra). O relatório sai em PDF, Excel (três opções) ou Word.
Pré-requisitos
- Acesso ao relatório: o usuário precisa do recurso 50988 (WRSUP017 – Histórico de fornecedor), ou ser administrador. Ver Permissões e Acesso.
- Notas de compra do perfil SUP0501 na filial e no período: sem elas o relatório sai sem registros.
- Impostos registrados nos itens da nota: o relatório principal só traz itens que tenham ao menos um imposto registrado.
- Parcelas nas notas de compra: o quadro de análise só considera notas que tenham parcelas.
- Documento de origem (pedido de compra) nas notas: o atraso do quadro de análise compara a nota com o documento de origem.
- Notas de devolução do perfil SUP0601: alimentam o quadro de devoluções; sem elas o quadro sai com uma linha zerada.
- Parâmetro de suprimentos 7021 (Nivel de Estoque por Filial x Local de Estoque): habilita o filtro de local de estoque em outros relatórios de Suprimentos. O WRSUP017 não tem esse filtro, então o parâmetro não altera este relatório.
Permissões e Acesso
Recurso e acesso ao relatório WRSUP017
O relatório WRSUP017 aparece em Suprimentos > Relatórios (recurso de menu 50322) com o recurso próprio 50988. O usuário administrador sempre acessa. Para os demais, o acesso depende do recurso: ele pode estar bloqueado a todos os usuários ou liberado por perfil ou por usuário. Com duplo clique no relatório, o sistema consulta o acesso antes de abrir a aba de parâmetros.
Mensagens de acesso negado do relatório WRSUP017
Sem acesso, a tela do menu mostra o aviso “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRSUP017/Acesso”. Se o recurso estiver bloqueado a todos, a mensagem do sistema traz o recurso, a frase “Você não tem permissão para acessar este recurso” e a observação de que o recurso está bloqueado a todos os usuários e deve ser desbloqueado pelo administrador. Na emissão, se o acesso for negado, a janela do relatório mostra “Acesso Negado” com “Recurso: WRSUP017/Acesso”.
Permissões do visualizador do relatório WRSUP017
Depois de gerado, o visualizador do relatório confere duas permissões do usuário: imprimir e exportar. Sem a permissão, aparece “Acesso Negado” com “Você não tem permissão para acessar este recurso <br /> Recurso: WRSUP017/Impressão” ou “… Recurso: WRSUP017/Exportar”.
Botão Download do relatório WRSUP017
O botão Download (Ctrl + Y) só fica disponível para usuários cujo código começa com “@” (usuários de suporte). Para os demais o botão fica oculto; se a ação for acionada, aparece “Acesso Negado” com “Você não tem permissão para acessar este recurso.”.
Fluxo Operacional
Fluxo de emissão do Histórico de fornecedor
- O usuário abre Suprimentos > Relatórios; a tela mostra a aba “Lista de Relatórios de Suprimentos”.
- O usuário dá duplo clique em “WRSUP017 – Histórico de fornecedor”. O sistema confere o acesso e abre a aba “WRSUP017 – Histórico de Fornecedor”, com o cursor no campo Filial.
- O usuário escolhe a Filial e informa o período em “Data da Compra” e “até”.
- Opcionalmente, o usuário escolhe um Fornecedor, um Produto ou uma Família para reduzir o resultado.
- O usuário aciona “Gerar PDF” (Ctrl + P), “Exportar Excel” (Ctrl + E) ou “Exportar Word” (Ctrl + W).
- A tela confere os campos obrigatórios; se algum estiver vazio, destaca o campo e não gera nada.
- O sistema monta o histórico e o relatório abre. Se nenhuma linha for encontrada, aparece “Relatório não possui registros”.
Fluxo de configuração salva do Histórico de fornecedor
O usuário digita um “Apelido para configuração” (sem espaços em branco) e aciona “Salvar configuração” (Ctrl + S) para guardar os parâmetros preenchidos. A configuração aparece na lista de configurações salvas do relatório; com duplo clique nela, os campos da tela são preenchidos de novo. “Excluir configuração” (Ctrl + Del) remove a configuração selecionada.
Interface e Comportamentos da Tela
Parâmetros do Histórico de fornecedor
A tela de parâmetros do WRSUP017 abre com o grupo “WRSUP017 – Histórico de Fornecedor”. Os campos são:
| Parâmetro | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Filial | Lista de seleção de uma filial (código e nome) | Sim | Recebe o foco ao abrir a aba. Aceita uma única filial. |
| Data da Compra | Data (dd/mm/aaaa) | Sim | Início do período. |
| até | Data (dd/mm/aaaa) | Sim | Fim do período. |
| Fornecedor | Pesquisa de cadastro geral, só fornecedores | Não | Vazio traz todos os fornecedores. |
| Produto | Pesquisa de produto (código e referência) | Não | Só o código do produto é usado; a referência não filtra. |
| Família | Pesquisa de produto (código e referência) | Não | Filtra o relatório principal e as devoluções, não a análise. |
Comportamentos específicos da tela do Histórico de fornecedor
O WRSUP017 não tem validação própria de combinação de filtros: a única conferência da tela é a dos campos obrigatórios (Filial, “Data da Compra” e “até”), que ficam destacados com “Este campo é obrigatório.” quando vazios. O campo Fornecedor pesquisa só o cadastro de fornecedores. Quando o idioma do usuário não é português, os rótulos das listas de seleção são traduzidos.
Configuração de parâmetro do Histórico de fornecedor
O grupo “Configuração de parâmetro” do WRSUP017 traz o texto fixo “Para a configuração ficar salva, digite um apelido e utilize o botão “Salvar configuração” na parte superior da tela. O apelido da configuração não pode conter espaços em branco.”, o campo “Apelido para configuração” e a lista de configurações salvas do relatório.
Barra de ferramentas do Histórico de fornecedor
A barra de ferramentas do WRSUP017 tem Gerar PDF (Ctrl + P), Exportar Excel (Ctrl + E), Exportar Word (Ctrl + W), Salvar configuração (Ctrl + S), Excluir configuração (Ctrl + Del), Download (Ctrl + Y, só para usuários de suporte) e Fechar Aba (Ctrl + O).
Feedbacks ao Usuário
Feedbacks — filtros e emissão do Histórico de fornecedor
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo obrigatório vazio (Filial, Data da Compra, até) | Campo destacado | “Este campo é obrigatório.” |
| Relatório sem linhas | Aviso “Relatório não possui registros” | “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.” |
| Exportação direta para PDF no visualizador | Janela “Exportando relatórios” | “O sistema está trabalhando, por favor aguarde…” |
| Opções de Excel | Janela “Opções de exportação para Excel” | “Arquivo Excel”, “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)” |
Feedbacks — acesso ao relatório WRSUP017
| Situação | Feedback | Texto exato |
|---|---|---|
| Sem acesso ao abrir o relatório | Aviso “Acesso Negado” | “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRSUP017/Acesso” |
| Sem acesso ao emitir | Aviso “Acesso Negado” | “Você não tem permissão para acessar este recurso <br /> Recurso: WRSUP017/Acesso” |
| Sem permissão de imprimir no visualizador | Aviso “Acesso Negado” | “Você não tem permissão para acessar este recurso <br /> Recurso: WRSUP017/Impressão” |
| Sem permissão de exportar no visualizador | Aviso “Acesso Negado” | “Você não tem permissão para acessar este recurso <br /> Recurso: WRSUP017/Exportar” |
| Download por usuário que não é de suporte | Aviso “Acesso Negado” | “Você não tem permissão para acessar este recurso.” |
Feedbacks — configuração de parâmetros do Histórico de fornecedor
| Situação | Feedback | Texto exato |
|---|---|---|
| Salvar sem apelido | Aviso “Configuração de parâmetros” | “Informe um apelido para a configuração.” |
| Configuração salva | Informação “Configuração de parâmetros” | “A configuração de parâmetros foi salva com sucesso.” |
| Falha ao salvar | Erro “Configuração de parâmetros” | “A configuração de parâmetros não foi salva com sucesso.” |
| Configuração excluída | Informação “CONFIGURAÇÃO DE PARÂMETROS!!!” | “A configuração de parâmetros foi excluída com sucesso.” |
| Falha ao excluir | Aviso ou erro “CONFIGURAÇÃO DE PARÂMETROS!!!” | “A configuração de parâmetros não foi excluída com sucesso.” |
Regras de Negócio
Filial e período das compras do Histórico de fornecedor
O WRSUP017 considera as notas de entrada de perfil SUP0501 (Suprimentos – Nota de Compra) da “Filial” escolhida cuja primeira data da nota (a data da compra) está entre “Data da Compra” e “até”, inclusive. Só uma filial é aceita; o cabeçalho do relatório mostra os dados dessa filial e a data de hoje.
Filtros de fornecedor, produto e família no Histórico de fornecedor
“Fornecedor” vazio traz todos os fornecedores; preenchido, traz só as notas desse fornecedor. “Produto” usa apenas o código do produto, sem a referência, e traz os itens desse produto em qualquer referência. “Família” compara o valor escolhido (código e referência) com o produto de linha cadastrado na referência do item; ela vale para o relatório principal e para as devoluções, mas não para o quadro de análise. O relatório principal só traz itens que tenham ao menos um imposto registrado: um item sem imposto fica de fora.
Valores por item de compra no Histórico de fornecedor
Para cada item de nota de compra, o relatório calcula: valor médio igual ao valor líquido do item dividido pela quantidade primária e custo médio igual ao custo gerencial do item dividido pela quantidade primária; com quantidade primária zero, ambos valem 0. O valor da compra é o valor líquido do item, o custo da compra é o custo gerencial do item e o valor de imposto é a soma dos impostos do item.
Consolidação do relatório principal do Histórico de fornecedor
O relatório principal agrupa os itens por fornecedor (código e nome), produto (código, referência e nome), unidade primária e tipo de frete. Em cada grupo mostra: menor quantidade e maior quantidade (a menor e a maior quantidade de um item de nota), quantidade (soma das quantidades primárias), valor do frete (soma), valor médio (soma dos valores médios de cada item), custo médio (soma dos custos médios de cada item), valor de imposto (soma), valor da compra (soma) e custo da compra (soma). O valor médio e o custo médio do grupo, portanto, são somas dos valores médios dos itens, e não médias ponderadas pela quantidade.
Quadro de devoluções do Histórico de fornecedor
O quadro de devoluções considera as saídas de perfil SUP0601 (Suprimentos – Devolução Nota de Compra) da filial cuja data de movimento está entre “Data da Compra” e “até”, inclusive, com os mesmos filtros de fornecedor, produto e família e com o mesmo cálculo por item (valor médio, custo médio, imposto). Agrupa por fornecedor e produto (código, referência, nome e unidade primária) e mostra: quantidade (soma), valor do frete (soma), valor médio (média dos valores médios dos itens), custo médio (média dos custos médios dos itens), valor de imposto (soma), valor da compra (soma) e custo da compra (soma). Sem devoluções, o quadro leva uma linha com fornecedor 0 e produto e referência “0”.
Quadro de análise do fornecedor no Histórico de fornecedor
O quadro de análise parte das notas de compra do período com os filtros de fornecedor e produto, sem o filtro de família, e só considera notas que tenham parcelas. Cada vencimento de parcela gera uma linha com a quantidade primária de todos os itens da nota. Para cada linha o sistema calcula o prazo e o atraso:
- Prazo: diferença absoluta, em dias, entre a data da compra e o vencimento da parcela.
- Atraso: diferença absoluta, em dias, entre a segunda data da nota e a data de movimento do documento de origem (pedido). Quando só uma das duas datas existe (nota sem documento de origem, ou nota sem segunda data), a data ausente vale 01/01/0001 e a diferença fica muito grande.
As linhas são agrupadas por fornecedor, prazo, atraso e data da compra, com a soma das quantidades. Por fornecedor o quadro mostra: primeira compra (menor data), última compra (maior data), maior compra e menor compra (maior e menor quantidade de um desses grupos), maior prazo, prazo médio (média dos prazos dos grupos) e quantidade de atrasos (número de grupos com atraso maior que zero). Como cada vencimento diferente gera um grupo com a quantidade da nota, notas parceladas contam mais de uma vez nesses números.
Filtros utilizados no relatório do Histórico de fornecedor
O relatório entrega ao layout um texto com os parâmetros preenchidos: cada linha traz o nome do parâmetro seguido de “igual” ou “entre … e …” e do valor informado.
Relatórios e Exportações
Formatos de saída do Histórico de fornecedor
O WRSUP017 gera PDF (Gerar PDF), Excel (Exportar Excel, com as opções “Arquivo Excel”, “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”) e Word (Exportar Word). Os três formatos usam os mesmos dados e as mesmas validações da tela. O nome do arquivo gerado no visualizador combina o código do relatório, o usuário e a data.
Conteúdo do relatório principal do WRSUP017
O relatório principal entrega, por linha, o fornecedor (código e nome), o produto (código, referência e nome), a unidade primária, a menor e a maior quantidade, o tipo de frete (com “Sem Frete” quando não há), a quantidade, o valor do frete, o valor médio, o custo médio, o valor de imposto, o valor da compra e o custo da compra. O arranjo das colunas, os agrupamentos e os totais ficam no layout do relatório, que o código não descreve.
Quadros de devoluções e de análise do WRSUP017
O quadro de devoluções entrega, por fornecedor e produto, a quantidade, o frete, o valor médio, o custo médio, o imposto, o valor da compra e o custo da compra devolvidos. O quadro de análise entrega, por fornecedor, a primeira e a última compra, a maior e a menor compra, o maior prazo, o prazo médio e a quantidade de atrasos.
Troubleshooting
Relatório WRSUP017 não abre: acesso negado ao recurso
Mensagem exibida: Aviso “Acesso Negado”: “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRSUP017/Acesso”
Cenário: o usuário não é administrador e o recurso 50988 não está liberado para o perfil ou para ele.
O que fazer: pedir ao administrador que libere o recurso 50988 para o perfil ou para o usuário.
Relatório WRSUP017 bloqueado a todos os usuários
Mensagem exibida: Erro “Recurso : {recurso}* “, Motivo “Mensagem : Você não tem permissão para acessar este recurso”, Solução “Obs.: Este recurso está bloqueado a todos os usuários. Para desbloqueá-lo entre em contato com o administrador do sistema.”
O que fazer: entrar em contato com o administrador do sistema para desbloquear o recurso.
Geração recusada: campo obrigatório não preenchido
Mensagem exibida: “Este campo é obrigatório.”
Cenário: Filial, “Data da Compra” ou “até” está vazio; o campo fica destacado e nada é gerado.
O que fazer: preencher o campo destacado.
Relatório sai sem registros
Mensagem exibida: Aviso “Relatório não possui registros”: “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.”
Cenário: a filial não tem notas de compra de perfil SUP0501 no período; ou o fornecedor, o produto ou a família informados não combinam com as notas; ou os itens das notas não têm imposto registrado.
O que fazer: conferir a filial, o período e os filtros; ampliar o período ou deixar Fornecedor, Produto e Família em branco.
Relatório sem registros com Família preenchida
Mensagem exibida: Aviso “Relatório não possui registros”: “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.”
Cenário: o filtro Família compara o valor escolhido (código e referência) com o produto de linha cadastrado na referência do item; se o item escolhido não for o produto de linha cadastrado nas referências das compras, nenhum item combina.
O que fazer: repetir a emissão sem Família e filtrar por Fornecedor ou por Produto.
Item comprado não aparece no relatório principal
Mensagem exibida: Nenhuma — o item comprado não consta nas linhas do fornecedor.
Cenário: o item da nota de compra não tem nenhum imposto registrado, e o relatório principal só traz itens com imposto.
O que fazer: conferir os impostos do item na nota de compra.
Valor médio ou custo médio maior do que o esperado
Mensagem exibida: Nenhuma — o valor médio e o custo médio do relatório principal aparecem acima do preço unitário praticado.
Cenário: nesse relatório o valor médio e o custo médio de cada grupo são a soma dos valores médios de cada item de nota, e não uma média ponderada; com várias notas do mesmo produto, o valor cresce.
O que fazer: para o preço médio do período, dividir o valor da compra pela quantidade.
Quadro de devoluções com linha zerada
Mensagem exibida: Nenhuma — o quadro de devoluções mostra uma linha com fornecedor 0 e produto “0”.
Cenário: não há notas de devolução de perfil SUP0601 na filial e no período para os filtros informados.
O que fazer: nenhuma ação; o fornecedor não teve devoluções nos filtros informados.
Quadro de análise sem fornecedor ou com atrasos em excesso
Mensagem exibida: Nenhuma — o fornecedor não aparece no quadro de análise, ou a quantidade de atrasos é igual ao número de grupos de compra.
Cenário: notas sem parcelas não entram na análise; quando só uma das duas datas existe (nota sem documento de origem, ou nota sem a segunda data), a data ausente vale 01/01/0001 e a nota é contada como atrasada.
O que fazer: conferir as parcelas, o documento de origem e a segunda data das notas de compra.
Configuração de parâmetros não salva: apelido não informado
Mensagem exibida: Aviso “Configuração de parâmetros”: “Informe um apelido para a configuração.”
O que fazer: digitar um apelido sem espaços em branco no campo “Apelido para configuração” e acionar “Salvar configuração” de novo.
Falha ao salvar ou excluir a configuração de parâmetros
Mensagem exibida: “A configuração de parâmetros não foi salva com sucesso.” ou “A configuração de parâmetros não foi excluída com sucesso.”
O que fazer: repetir a operação; se persistir, acionar o suporte.
Casos de Uso
Caso 1 — Histórico de todos os fornecedores do trimestre
O comprador Rafael abre o WRSUP017, escolhe a Filial 001, informa “Data da Compra” 01/01/2026 e “até” 31/03/2026 e deixa Fornecedor, Produto e Família em branco. Aciona “Gerar PDF” e recebe, por fornecedor e produto, as quantidades, o frete, os valores e os impostos do trimestre, mais os quadros de devoluções e de análise.
Caso 2 — Avaliação de um fornecedor específico
A gestora Ana escolhe em Fornecedor o cadastro 1250 (Distribuidora Alfa), com o período do ano de 2025. No quadro de análise confere a primeira e a última compra, o prazo médio e a quantidade de atrasos para negociar prazos.
Caso 3 — Histórico de um produto em Excel
O comprador Pedro preenche Produto com 000150.0001 e aciona “Exportar Excel” com “Arquivo Excel – Somente dados”. O relatório traz todos os fornecedores que venderam o produto 000150, em qualquer referência, no período.