WRCAD089 – Relatório de clientes
WRCAD089 – Relatório de clientes — Cadastro Geral (ERPAtak)
O relatório WRCAD089 – Relatório de clientes, do módulo Cadastro Geral (menu Relatórios), lista os clientes do cadastro geral com os dados cadastrais, de endereço, de contato e comerciais (vendedor, área, ramo de atividade, percurso, grupo econômico, condição de pagamento e limite de crédito), agrupados conforme a quebra escolhida (Área, Cidade/Uf, Percurso ou Vendedor).
Visão Geral
O relatório WRCAD089 – Relatório de clientes, do módulo Cadastro Geral (menu Relatórios), lista os clientes do cadastro geral com os dados cadastrais, de endereço, de contato e comerciais (vendedor, área, ramo de atividade, percurso, grupo econômico, condição de pagamento e limite de crédito), agrupados conforme a quebra escolhida (Área, Cidade/Uf, Percurso ou Vendedor). Serve à área comercial para emitir a carteira de clientes por vendedor, região ou percurso. Os dados vêm do cadastro geral (somente os tipos de cadastro de cliente), do cadastro de cliente (vendedor, grupo econômico e limite), do cadastro de endereços, de áreas, de condições de pagamento, de percursos e do plano de contas. O cabeçalho usa a filial em que o usuário está logado, mesmo existindo o filtro de Filial.
Pré-requisitos
- Tipos de cadastro de cliente configurados: o parâmetro pTipoCadCliente do ERP lista os tipos de cadastro considerados clientes (separados por vírgula); sem esse parâmetro o relatório WRCAD089 não é emitido (ver T-06).
- Cliente com vendedor, área e endereço: só entram no relatório os clientes que têm vendedor, área válida e endereço do tipo escolhido.
- Parâmetros obrigatórios na tela: Tipo endereço, Tipo de relatório e Quebra já vêm com valor padrão e não podem ficar vazios.
- Acesso ao recurso 50589: o usuário precisa ter o relatório WRCAD089 liberado (ver Permissões e Acesso).
Permissões e Acesso
Recurso do WRCAD089 e acesso por perfil
O relatório WRCAD089 – Relatório de clientes é o recurso 50589 do módulo Cadastro Geral e fica no menu Cadastro Geral > Relatórios. Ao dar duplo clique no relatório na aba “Lista de Relatórios de Cadastro Geral”, a tela registra a navegação e pergunta ao sistema se o usuário pode acessá-lo. O usuário administrador sempre acessa. Para os demais, o acesso depende de o recurso estar liberado para o perfil ou para o usuário.
Relatório WRCAD089 bloqueado a todos os usuários
Quando o recurso 50589 do relatório WRCAD089 está bloqueado a todos os usuários, só o administrador consegue abrir o relatório e os demais recebem a mensagem de bloqueio descrita no Troubleshooting (T-09). O desbloqueio é feito pelo administrador do sistema.
Acesso negado ao WRCAD089
Quando o usuário não tem o recurso 50589 liberado, a tela do relatório WRCAD089 mostra o diálogo “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD089/Acesso”. Se a negativa vier durante a emissão do relatório, a janela do relatório mostra o diálogo “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD089/Acesso”.
Botão Download do WRCAD089
O botão Download (Ctrl + Y) da tela do relatório WRCAD089 só funciona para usuários cujo código começa com “@” (usuários de suporte). Para os demais, a tela mostra “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso.”.
Fluxo Operacional
Fluxo de emissão do WRCAD089
- O usuário abre Cadastro Geral > Relatórios e dá duplo clique em “WRCAD089 – Relatório de clientes” na aba “Lista de Relatórios de Cadastro Geral”.
- A tela confere o acesso ao recurso 50589 e, com acesso, abre a aba “WRCAD089 – Relatório de clientes”.
- O usuário confere os valores iniciais de Tipo endereço (Faturamento), Tipo de relatório (Analítico) e Quebra (Vendedor) e, se quiser, restringe a lista por Filial, Cód. situação, Data cadastro, Nome cadastro, Área atuação, Ramo atividade, Vendedor, Grupo Econom., Cep, UF e Percurso.
- O usuário aciona Gerar PDF, Exportar Excel ou Exportar Word.
- O sistema lê os clientes que atendem aos parâmetros e entrega o relatório, ou mostra o aviso de relatório sem registros.
Fluxo de reutilização de parâmetros do WRCAD089
O usuário preenche os parâmetros, digita um apelido em Apelido para configuração e aciona Salvar configuração. Depois, na lista de configurações salvas, o duplo clique no apelido preenche de novo os parâmetros.
Interface e Comportamentos da Tela
Parâmetros de seleção do cliente no WRCAD089
A tela do relatório WRCAD089 – Relatório de clientes tem um grupo de parâmetros com o título “WRCAD089 – Relatório de clientes”. Ao abrir a tela, o foco vai para o campo Filial.
| Parâmetro | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Filial | Lista de filiais com seleção múltipla (código e nome) | Não | Vazio traz clientes de todas as filiais |
| Tipo endereço | Lista (Trabalho, Residencial, Faturamento, Cobrança, Entrega) | Sim, na tela | Valor padrão Faturamento; seleção única |
| Cód. situação | Lista de situações do cadastro com seleção múltipla (código e nome) | Não | Vazio traz todas as situações |
| Data cadastro e até | Duas datas (dd/mm/aaaa) | Não | Início e fim da faixa de datas de cadastro; vazios não filtram |
| Nome cadastro e até | Dois textos | Não | Faixa de nomes em ordem alfabética |
| Grupo Econom. | Pesquisa (lookup) de grupo econômico | Não | Vazio traz clientes de qualquer grupo econômico |
Parâmetros de classificação e localização no WRCAD089
| Parâmetro | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Área atuação e até | Duas pesquisas (lookup) de área | Não | Faixa de códigos de área |
| Ramo atividade e até | Duas pesquisas (lookup) de ramo de atividade | Não | Faixa de códigos de ramo de atividade |
| Vendedor e até | Duas pesquisas (lookup) de cadastro geral de vendedores | Não | Faixa de códigos de vendedor |
| Cep e até | Dois textos | Não | Faixa de CEP do endereço do tipo escolhido |
| UF | Pesquisa de estados com seleção múltipla (código e nome) | Não | Vazio traz todas as UFs |
| Percurso | Pesquisa de percursos com seleção múltipla | Não | Vazio traz todos os percursos |
Parâmetros de formato do WRCAD089
| Parâmetro | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Tipo de relatório | Lista (Analítico, Sintético) | Sim, na tela | Valor padrão Analítico; seleção única |
| Quebra | Lista (Área, Cidade/Uf, Percurso, Vendedor) | Sim, na tela | Valor padrão Vendedor; seleção única |
Comportamentos de tela do WRCAD089
A tela do WRCAD089 não esconde nem habilita campos conforme outros campos. Os pares de faixa ficam lado a lado, o primeiro com o início (rótulo do campo) e o segundo com o fim (rótulo “até”). Os valores iniciais são Faturamento, Analítico e Vendedor.
Configuração de parâmetro do WRCAD089
O grupo Configuração de parâmetro da tela do relatório WRCAD089 permite guardar os valores digitados nos parâmetros para reutilizá-los depois.
| Campo | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Apelido para configuração | Texto | Não | Identifica a configuração salva; não pode conter espaços em branco; é obrigatório só para salvar a configuração |
| Lista de configurações salvas | Lista | Não | Mostra as configurações já salvas do WRCAD089; o duplo clique numa configuração preenche os parâmetros na tela |
O grupo exibe 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.” e, em outra linha, “O apelido da configuração não pode conter espaços em branco.”
Barra de ferramentas do WRCAD089
A barra de ferramentas da tela do relatório WRCAD089 oferece:
- Gerar PDF (Ctrl + P): emite o relatório em PDF.
- Exportar Excel (Ctrl + E): abre a janela “Opções de exportação para Excel” com “Arquivo Excel” (padrão), “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”.
- Exportar Word (Ctrl + W): emite o relatório em Word.
- Salvar configuração (Ctrl + S) e Excluir configuração (Ctrl + Del): gravam ou apagam a configuração de parâmetros pelo apelido.
- Download (Ctrl + Y): restrito a usuários de suporte, conforme Permissões e Acesso.
- Fechar Aba (Ctrl + O).
Feedbacks ao Usuário
Feedbacks — emissão do WRCAD089
| Situação | Título | Mensagem |
|---|---|---|
| Relatório WRCAD089 sem dados para os parâmetros | Relatório não possui registros | “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.” |
| Usuário sem acesso ao recurso, ao abrir o relatório | Acesso Negado | “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD089/Acesso” |
| Usuário sem acesso ao recurso, durante a emissão | Acesso Negado | “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD089/Acesso” |
| Usuário que não é de suporte aciona Download | Acesso Negado | “Você não tem permissão para acessar este recurso.” |
| Recurso bloqueado a todos | (mensagem do sistema) | Ver T-09 |
Quando um campo obrigatório na tela está vazio, a tela do WRCAD089 não emite o relatório e marca o campo como inválido.
Feedbacks — configuração de parâmetros do WRCAD089
| Situação | Título | Mensagem |
|---|---|---|
| Salvar sem apelido | Configuração de parâmetros | “Informe um apelido para a configuração.” |
| Configuração salva | (confirmação) | “A configuração de parâmetros foi salva com sucesso.” |
| Falha ao salvar | (aviso) | “A configuração de parâmetros não foi salva com sucesso.” ou a mensagem devolvida pelo sistema |
| Configuração excluída | CONFIGURAÇÃO DE PARÂMETROS!!! | “A configuração de parâmetros foi excluída com sucesso.” |
| Falha ao excluir | CONFIGURAÇÃO DE PARÂMETROS!!! | “A configuração de parâmetros não foi excluída com sucesso.” |
Regras de Negócio
Quais cadastros entram no WRCAD089
O relatório WRCAD089 lista apenas cadastros gerais cujo tipo de cadastro conste no parâmetro pTipoCadCliente do ERP e que atendam, ao mesmo tempo, a estas condições: ter área existente, ter vendedor no cadastro de cliente e ter endereço do tipo escolhido em Tipo endereço. Cadastro que não cumpra qualquer uma das condições não aparece.
Filtro de filial do WRCAD089
O relatório WRCAD089 filtra os clientes pela filial do cadastro, no operador Em lista. Filial vazia traz todas as filiais. Não é obrigatório na tela nem no sistema.
Tipo de endereço do WRCAD089
O campo Tipo endereço (Igual) escolhe qual endereço do cliente é usado no relatório: Trabalho, Residencial, Faturamento, Cobrança ou Entrega. A tela exige o campo e traz Faturamento como padrão; o sistema não o marca como obrigatório, mas sem um tipo válido o relatório não é emitido (ver T-03). O cliente com mais de um endereço do tipo escolhido aparece uma vez por endereço (ver T-07).
Filtro de situação do WRCAD089
O relatório WRCAD089 filtra pela situação do cadastro, no operador Em lista. Vazio traz todas as situações.
Filtro de data de cadastro do WRCAD089
O relatório WRCAD089 compara a data de cadastro do cliente com Data cadastro (maior ou igual) e com o campo até (menor ou igual), no operador Entre. Uma data só filtra quando é válida e posterior a 01/01/0001; data vazia ou inválida não filtra. Os campos são opcionais.
Filtro de nome do cliente do WRCAD089
O relatório WRCAD089 compara o nome do cadastro com o primeiro campo Nome cadastro (maior ou igual) e com o campo até (menor ou igual), em ordem alfabética. Vazio não limita aquele lado da faixa.
Filtro de área de atuação do WRCAD089
O relatório WRCAD089 filtra pelo código da área do cadastro, entre Área atuação e até, em ordem alfabética dos códigos (operador Entre). Vazio não limita aquele lado da faixa.
Filtro de ramo de atividade do WRCAD089
O relatório WRCAD089 filtra pelo código do ramo de atividade do cadastro, entre Ramo atividade e até, em ordem alfabética dos códigos (operador Entre). Vazio não limita aquele lado da faixa.
Filtro de vendedor do WRCAD089
O relatório WRCAD089 filtra pelo código do cadastro geral do vendedor do cliente, entre Vendedor e até (inclusive), no operador Entre. Vazio não limita aquele lado da faixa. O cliente sem vendedor não aparece no relatório, mesmo com o filtro vazio.
Filtro de grupo econômico do WRCAD089
O relatório WRCAD089 filtra pelo grupo econômico (grupo limite) do cliente, no operador Em lista. Vazio não filtra e traz inclusive clientes sem grupo econômico; com um grupo escolhido, só aparecem clientes desse grupo.
Filtro de CEP do WRCAD089
O relatório WRCAD089 compara o CEP do endereço do tipo escolhido com Cep (maior ou igual) e com o campo até (menor ou igual), como texto, no operador Entre. Vazio não limita aquele lado da faixa.
Filtro de UF e de percurso do WRCAD089
O relatório WRCAD089 filtra pela UF registrada no cadastro do cliente (e não pela UF do endereço) e pelo percurso do cadastro, ambos no operador Em lista. Vazio não filtra.
Tipo de relatório e quebra do WRCAD089
Tipo de relatório (Analítico ou Sintético, operador Igual) e Quebra (Área, Cidade/Uf, Percurso ou Vendedor, operador Igual) são obrigatórios na tela, com padrão Analítico e Vendedor; o sistema não os marca como obrigatórios, mas sem valor válido o relatório não é emitido. O tipo de relatório é repassado ao layout em todas as linhas e só o layout define o que muda entre Analítico e Sintético. A quebra define o rótulo do grupo de cada linha: Área (código e nome), Cidade/UF do endereço, Percurso (código e nome) ou Vendedor (código e nome); sem área, percurso ou vendedor, o rótulo é “Sem Área”, “Sem Pecurso” ou “Sem Vendedor”.
Ordenação, agrupamento e totais do WRCAD089
O sistema entrega as linhas ordenadas pela quebra, pelo código do vendedor, pelo código do cadastro e pelo CPF/CNPJ. O agrupamento por quebra é entregue ao layout; os totais e a disposição do impresso ficam no layout do relatório, que não é descrito aqui.
Cabeçalho do WRCAD089
O cabeçalho do relatório WRCAD089 traz os dados da filial logada e o título “WRCAD089 – RELATÓRIO DE CLIENTES”; com o idioma diferente de português, o título é traduzido. O filtro Filial limita os clientes, mas não muda o cabeçalho.
Relatórios e Exportações
Saída do WRCAD089
O relatório WRCAD089 – Relatório de clientes sai em PDF (Gerar PDF), em Excel nas três opções (“Arquivo Excel”, “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”) e em Word. O sistema entrega uma linha por cliente e endereço com: rótulo da quebra; vendedor (código e nome); cliente (código, nome e nome fantasia); conta contábil reduzida (código e nome); inscrição estadual e RG/IE; CPF/CNPJ e tipo de pessoa; data de cadastro e data de alteração; filial; situação do cadastro; condição de pagamento (código e nome); limite de crédito; endereço (descrição, número, bairro, cidade e UF), telefone, fax, e-mail e CEP; tipo de cadastro; área (código e nome); ramo de atividade; percurso (código e nome); grupo econômico (código e nome, ou “Sem Grupo Econômico”) e o tipo de relatório escolhido. A disposição das colunas, quais campos aparecem no Analítico e no Sintético, os agrupamentos e os totais dependem do layout, que não é descrito neste manual.
Troubleshooting
Relatório WRCAD089 sem registros
Mensagem exibida: título “Relatório não possui registros”, texto “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.”
Cenário: nenhum cliente atende aos parâmetros informados.
O que fazer: esvaziar os filtros opcionais para ver todos os clientes e voltar a restringir um a um.
Relatório WRCAD089 sem registros quando os filtros não combinam
Mensagem exibida: título “Relatório não possui registros”, texto “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.”
Cenário: os filtros se somam: o cliente precisa atender ao mesmo tempo à filial, situação, datas, nomes, área, ramo, vendedor, grupo econômico, CEP, UF e percurso informados. Faixas invertidas (início maior que o fim) também não trazem nenhum cliente.
O que fazer: limpar primeiro as faixas de nome, CEP e data e conferir a ordem de início e fim em cada par.
Cliente sem endereço do tipo escolhido não aparece no WRCAD089
Mensagem exibida: nenhuma; o cliente simplesmente não consta no relatório, ou o aviso de relatório sem registros aparece se nenhum cliente tiver o endereço.
Cenário: o relatório WRCAD089 mostra só clientes que têm endereço do tipo escolhido em Tipo endereço (padrão Faturamento).
O que fazer: emitir de novo com outro Tipo endereço ou cadastrar o endereço do tipo desejado no cadastro geral.
Cliente sem vendedor ou sem área não aparece no WRCAD089
Mensagem exibida: nenhuma; o cliente não consta no relatório.
Cenário: o relatório WRCAD089 só inclui clientes que têm vendedor no cadastro de cliente e área existente no cadastro de áreas, mesmo com os filtros de Vendedor e Área atuação vazios.
O que fazer: informar o vendedor e a área no cadastro do cliente e emitir de novo.
Cadastro de outro tipo não aparece no WRCAD089
Mensagem exibida: nenhuma; o cadastro não consta no relatório.
Cenário: o relatório WRCAD089 considera só os tipos de cadastro listados no parâmetro pTipoCadCliente do ERP.
O que fazer: conferir o tipo do cadastro e, se ele deveria ser tratado como cliente, pedir ao administrador que inclua o tipo no parâmetro pTipoCadCliente.
Relatório WRCAD089 não é gerado sem o parâmetro pTipoCadCliente
Mensagem exibida: nenhuma mensagem específica do relatório; o relatório não é entregue.
Cenário: o parâmetro pTipoCadCliente do ERP não existe ou está vazio, e o sistema fica sem a lista de tipos de cadastro de cliente.
O que fazer: pedir ao administrador que cadastre o parâmetro pTipoCadCliente com os tipos de cadastro de cliente separados por vírgula; persistindo, avisar o suporte.
Cliente repetido no WRCAD089
Mensagem exibida: nenhuma; o mesmo cliente aparece em mais de uma linha.
Cenário: o cliente tem mais de um endereço do tipo escolhido em Tipo endereço, e o relatório traz uma linha para cada endereço.
O que fazer: conferir os endereços do cliente no cadastro geral e deixar um só do tipo desejado, se a duplicidade não for esperada.
Cabeçalho do WRCAD089 mostra a filial logada
Mensagem exibida: nenhuma; o cabeçalho do relatório sai com os dados da filial em que o usuário está logado.
Cenário: mesmo com Filial preenchida, o cabeçalho do relatório WRCAD089 traz sempre o nome, o CNPJ e a cidade da filial logada; o filtro só limita os clientes.
O que fazer: entrar no sistema na filial desejada antes de emitir, se o cabeçalho precisar de outra filial.
Relatório WRCAD089 bloqueado a todos os usuários
Mensagem exibida: Erro “Recurso : {relatório}* “, 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.”
Cenário: o recurso 50589 do WRCAD089 foi bloqueado a todos os usuários; só o administrador acessa.
O que fazer: pedir ao administrador do sistema que desbloqueie o recurso, se o uso do relatório for legítimo.
Acesso negado ao relatório WRCAD089
Mensagem exibida: título “Acesso Negado”, texto “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD089/Acesso” (ou, durante a emissão, “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD089/Acesso”).
Cenário: o perfil ou o usuário não tem o recurso 50589 liberado.
O que fazer: pedir ao administrador que libere o recurso 50589 para o perfil ou para o usuário.
Configuração do WRCAD089 não é salva por falta de apelido
Mensagem exibida: título “Configuração de parâmetros”, texto “Informe um apelido para a configuração.”
Cenário: o usuário acionou Salvar configuração com o campo Apelido para configuração vazio.
O que fazer: digitar um apelido sem espaços em branco e salvar de novo.
Configuração de parâmetros do WRCAD089 não foi salva ou excluída
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.” (ou a mensagem devolvida pelo sistema).
Cenário: o sistema recusou a gravação ou a exclusão da configuração.
O que fazer: conferir o apelido (sem espaços) e repetir; persistindo, avisar o suporte com o texto exibido.
Botão Download recusado no WRCAD089
Mensagem exibida: título “Acesso Negado”, texto “Você não tem permissão para acessar este recurso.”
Cenário: o usuário não é de suporte (código de usuário não começa com “@”).
O que fazer: usar Gerar PDF, Exportar Excel ou Exportar Word; o Download é exclusivo do suporte.
Casos de Uso
Caso 1 — Carteira de clientes por vendedor
O usuário abre o WRCAD089, mantém Faturamento, Analítico e Vendedor, escolhe a situação ativa e aciona Gerar PDF. Recebe os clientes agrupados por vendedor, com o endereço de faturamento, a condição de pagamento e o limite de crédito de cada um.
Caso 2 — Clientes de uma UF por cidade
O usuário escolhe a UF “PR”, muda Quebra para Cidade/Uf, Tipo de relatório para Sintético e emite em Excel. O relatório traz os clientes cadastrados no Paraná, agrupados por cidade e UF.
Caso 3 — Clientes cadastrados em um período e vendedor
O usuário informa Data cadastro 01/01/2026 e até 31/03/2026, Vendedor 215 em ambos os campos e emite em PDF. O relatório traz só os clientes do vendedor 215 cadastrados no primeiro trimestre. Para reutilizar, digita o apelido “trimestre1” em Apelido para configuração e aciona Salvar configuração.