Manutenção de Cadastro Geral
Manutenção de Cadastro Geral — Cadastro Geral (ERPAtak)
A rotina Manutenção de Cadastro Geral, do módulo Cadastro Geral (menu Cadastro Geral > Manutenção de Cadastro Geral, recurso 4558, terceira opção do grupo), altera em lote dados de vários cadastros gerais de uma vez: área, ramo de atividade, status de fluxo, cooperado, vendedor, gerente de vendas, supervisor de vendas, lista de preço, consumidor final, aceita substituição tributária, perfil tributário, banco caixa, forma de cobrança, condição de pagamento, grupo econômico e percurso.
Visão Geral
A rotina Manutenção de Cadastro Geral, do módulo Cadastro Geral (menu Cadastro Geral > Manutenção de Cadastro Geral, recurso 4558, terceira opção do grupo), altera em lote dados de vários cadastros gerais de uma vez: área, ramo de atividade, status de fluxo, cooperado, vendedor, gerente de vendas, supervisor de vendas, lista de preço, consumidor final, aceita substituição tributária, perfil tributário, banco caixa, forma de cobrança, condição de pagamento, grupo econômico e percurso. Serve ao usuário supervisor que precisa, por exemplo, trocar o vendedor de uma carteira inteira de clientes sem abrir os cadastros um a um.
A tela tem duas abas. Na aba “Filtros” o usuário informa critérios e o sistema devolve os cadastros que os atendem, sem paginação. Na aba “Cadastros”, o painel superior (blocos recolhidos Cadastro Geral, Comercial, Contabilidade, Financeiro e Logística) recebe os novos valores e a grade abaixo lista os cadastros encontrados, com caixa de seleção por linha. O botão “Aplicar” copia os novos valores para as linhas selecionadas, apenas na grade; o botão “Salvar Todos” envia as linhas alteradas ao sistema, que grava os dados no cadastro, no registro de cliente e no registro de vendedor de cada um.
Esta rotina não abre as abas do Cadastro geral; para editar um cadastro individual use a rotina Cadastro geral (outro manual). A rotina Consulta de Cadastro via SEFAZ, que tem as ações de bloquear e inativar cadastros pela situação na SEFAZ, é outra tela do menu e não faz parte desta.
Pré-requisitos
- Usuário supervisor de usuário: a busca de cadastros só funciona para o usuário marcado como supervisor de usuário (campo do cadastro do usuário). Os demais recebem o aviso “Sem permissão” (T-01).
- Recurso de salvamento: o botão “Salvar Todos” exige que o grupo do usuário tenha o recurso 4667 (T-06).
- Situação do cadastro: o bloqueio automático ao salvar só alcança cadastros que ainda não estão “B – BLOQUEADO” nem “I – INATIVO” (ver Regras de Negócio).
- Tipos de cadastro configurados: a regra de bloqueio por edição depende de dois campos do tipo de cadastro (Customização > Tipo de cadastro): as exigências de validação Financeira, Contábil e Comercial e a situação padrão “BE” (bloqueia por edição).
- Nenhum parâmetro do ERP é lido por esta rotina.
Permissões e Acesso
Recursos da tela
O menu Cadastro Geral > Manutenção de Cadastro Geral é o recurso 4558. O usuário só vê a opção se o grupo dele tiver acesso ao recurso.
| Recurso | Ação protegida |
|---|---|
| 4558 | Abrir a tela (menu Manutenção de Cadastro Geral) |
| 4667 | Salvar todos os cadastros (botão “Salvar Todos”) |
| 4564 | Consta no catálogo como a ação de bloquear cadastro pela SEFAZ da Manutenção de Cadastro Geral; nenhuma ação desta tela confere esse recurso (a ação de bloquear pela SEFAZ pertence à rotina Consulta de Cadastro via SEFAZ, recurso 3578) |
Ação que não confere recurso
A busca de cadastros (botão “Buscar Cadastros”) não confere o grupo do usuário: qualquer usuário autenticado pode usá-la. O único controle dessa ação é a regra do supervisor de usuário (T-01). A busca não filtra os cadastros por tipo de cadastro nem pelo recurso Editar do tipo, como faz a listagem da rotina Cadastro geral: o sistema devolve cadastros de todos os tipos.
Ação que confere recurso
“Salvar Todos” confere o recurso 4667. Sem ele, o sistema recusa com “Você não tem permissão para acessar este recurso” (T-06). O sistema não confere, no salvamento, o recurso Editar do tipo de cadastro de cada cadastro enviado, nem a situação dele: cadastros inativos também são gravados.
“Aplicar” é só da tela: não envia nada ao sistema e não confere recurso.
Fluxo Operacional
Fluxo de busca dos cadastros
- O usuário abre Cadastro Geral > Manutenção de Cadastro Geral; a janela abre com título “Manutenção de Cadastro Geral” e a aba “Filtros” ativa.
- Preenche pelo menos um dos 16 filtros (T-02) e aciona “Buscar Cadastros” (Ctrl + Y).
- Se a grade já tem cadastros, a tela avisa que os dados listados e editados serão perdidos; em “OK” descarta as alterações pendentes e busca de novo, em “Cancelar” nada muda.
- O sistema devolve todos os cadastros que atendem aos filtros e a tela passa para a aba “Cadastros” com a grade preenchida (T-03).
Fluxo de alteração em lote
- Na aba “Cadastros”, o usuário marca as linhas que deseja alterar (caixa de seleção da primeira coluna).
- Expande os blocos do painel superior e preenche só os campos que deseja mudar; deixar um campo vazio significa “não alterar”. Não há como apagar um valor por esta tela (T-09).
- Aciona “Aplicar”; a tela copia os valores preenchidos para as linhas selecionadas e informa “Alterações aplicadas. Salve para confirmar a alteração” (T-04).
- Repete os passos 1 a 3 para outros grupos de linhas, se quiser.
- Aciona “Salvar Todos”; a tela envia as linhas alteradas em lotes de até 3600 linhas (T-05, T-06, T-08).
- Ao terminar, a tela mostra “Edição de cadastros — Cadastros Editados com sucesso” e refaz a busca com os mesmos filtros.
Interface e Comportamentos da Tela
Aba Filtros — cadastro, vendas e logística
A aba “Filtros” tem 16 campos, todos opcionais individualmente, mas ao menos um precisa estar preenchido.
| Filtro | Tipo de campo | Observação |
|---|---|---|
| Filial | Pesquisa | Não vem preenchida com a filial logada |
| Área | Pesquisa | — |
| Código Cadastro Inicial | Pesquisa de cadastro geral | Cadastros com código maior ou igual |
| Código Cadastro Final | Pesquisa de cadastro geral | Cadastros com código menor ou igual |
| Tipo de Cadastro | Pesquisa | Um só tipo |
| Ramo de Atividade | Pesquisa | — |
| Supervisor de Vendas | Pesquisa de vendedores | Dica “Pesquisa somente vendedores” |
| Vendedor | Pesquisa de vendedores | Dica “Pesquisa somente vendedores” |
Aba Filtros — gerência, tributação e financeiro
| Filtro | Tipo de campo | Observação |
|---|---|---|
| Gerente de Vendas | Pesquisa de vendedores | Dica “Pesquisa somente vendedores” |
| Lista de Preço | Pesquisa | O valor traz código e data da lista; só o código filtra |
| Percurso/Rota/Linha | Pesquisa | — |
| Perfil Tributário | Pesquisa de cadastros ativos | — |
| Forma de Cobrança | Pesquisa | — |
| Condição de Pagamento | Pesquisa | — |
| Banco Caixa | Pesquisa de cadastro de banco caixa | — |
| Grupo Econômico | Pesquisa | — |
Painel de novos valores — Cadastro Geral e Comercial
Na aba “Cadastros”, o painel superior tem cinco blocos recolhidos ao abrir, todos com campos opcionais. Expandir ou recolher um bloco reajusta a altura da grade.
| Bloco | Campo | Tipo de campo |
|---|---|---|
| Cadastro Geral | Área | Pesquisa |
| Cadastro Geral | Ramo de Atividade | Pesquisa |
| Cadastro Geral | Status fluxo | Lista Sim/Não |
| Cadastro Geral | Cooperado | Lista Sim/Não |
| Comercial | Vendedor | Pesquisa de vendedores |
| Comercial | Gerente de Vendas | Pesquisa de vendedores |
| Comercial | Supervisor de Vendas | Pesquisa de vendedores |
| Comercial | Lista de Preço | Pesquisa |
Painel de novos valores — Contabilidade, Financeiro e Logística
| Bloco | Campo | Tipo de campo |
|---|---|---|
| Contabilidade | Consumidor Final | Lista Sim/Não |
| Contabilidade | Aceita sub. Tributária | Lista Sim/Não |
| Contabilidade | Perfil Tributário | Pesquisa de cadastros ativos |
| Financeiro | Banco Caixa | Pesquisa de cadastro de banco caixa |
| Financeiro | Forma de Cobrança | Pesquisa |
| Financeiro | Condição de Pagamento | Pesquisa |
| Financeiro | Grupo Econômico | Pesquisa |
| Logística | Percurso/Rota/Linha | Pesquisa |
Grade de cadastros
A grade mostra um cadastro por linha, sem paginação, com caixa de seleção por linha (seleção múltipla) e colunas não editáveis diretamente. As linhas alteradas por “Aplicar” recebem a marca de registro alterado.
| Coluna | Conteúdo |
|---|---|
| Cod. Nome | Código e nome do cadastro (“1025 – Mercado Boa Compra Ltda”) |
| Tipo de Cadastro | Código do tipo de cadastro |
| Área | Código da área |
| Ramo de Atividades | Código do ramo |
| Status Fluxo | Status de fluxo do cadastro |
| Cooperado | “S” quando 1, “N” quando 2, vazio nos demais casos |
| Vendedor | Código do vendedor do cliente |
| Gerente de Vendas | Gerente do registro de vendedor do próprio cadastro |
| Supervisor de Vendas | Supervisor do registro de vendedor do próprio cadastro |
| Lista de Preço | Código da lista de preço do cliente |
| Consumidor final | Consumidor final do cliente |
| Aceita Sub. Tributaria | Aceita substituição tributária do cliente |
Grade de cadastros — demais colunas
| Coluna | Conteúdo |
|---|---|
| Perfil Tributário | Código do cadastro usado como perfil tributário |
| Banco Caixa | Código do banco caixa do cliente |
| Forma de Cobrança | Código da forma de cobrança do cliente |
| Cond. Pagto | Código da condição de pagamento |
| Grupo Econômico | Código do grupo econômico do cliente |
| Percurso/Rota/Linha | Código do percurso |
Há ainda duas colunas ocultas: Código (código do cadastro) e Data lista Preco (data da lista de preço).
Barra de ferramentas
A barra de ferramentas tem o título “Cadastro Geral -> Manutenção de Cadastro Geral” e os botões abaixo. “Aplicar” e “Salvar Todos” nascem desabilitados; os dois são habilitados juntos quando algum campo do painel de novos valores foi mexido e a grade tem cadastros, e voltam a ser desabilitados quando nenhum campo está alterado ou a grade está vazia.
| Botão | Atalho | Ação |
|---|---|---|
| Buscar Cadastros | Ctrl + Y | Busca pelos filtros (dica “Buscar”) |
| Aplicar | Ctrl + Y | Copia os novos valores para as linhas selecionadas (dica “Selecionar Todos os Cadastros”) |
| Salvar Todos | Ctrl + Y | Envia as alterações ao sistema (dica “Selecionar Todos os Cadastros”) |
| Video | — | Abre o vídeo da rotina |
| Fechar Aba | — | Fecha a janela |
Os três primeiros botões usam o mesmo atalho Ctrl + Y.
Comportamentos da tela
- Busca com a grade já preenchida: a janela “Buscar Cadastros” (modal) pergunta “Já existem itens listados. Os dados listados e editados serão perdidos. Deseja prosseguir?” com “OK” e “Cancelar”. Em “OK” a lista de alterações pendentes é zerada antes da busca.
- Busca sem filtros: a tela não faz a busca (T-02).
- Durante a busca a janela mostra a máscara “Buscando cadastros”; o tempo máximo de espera é de 10 minutos.
- Depois da busca a tela ativa a aba “Cadastros”, mesmo quando a lista volta vazia.
- Aplicar só considera campos do painel que têm valor; a lista de preço preenche código e data da lista. A mesma linha aplicada duas vezes continua uma só na lista de alterações.
- Aplicar sem linha selecionada avisa (T-04).
- Salvar Todos sem nenhuma alteração aplicada avisa (T-05).
- Salvamento: a janela mostra a máscara “Salvando Registros. Isso pode demorar dependendo da quantidade de registros. Por favor, aguarde.” A lista de alterações pendentes é zerada logo ao acionar o botão, antes da resposta do sistema (T-08).
Feedbacks ao Usuário
| Situação | Tipo de aviso / título | Texto exato |
|---|---|---|
| Busca sem nenhum filtro | Aviso “Não foi possivel buscar Cadastros” | “Por favor preencha pelo menos 1 filtro<br/>” |
| Busca com lista já preenchida | Janela “Buscar Cadastros” | “Já existem itens listados. Os dados listados e editados serão perdidos. Deseja prosseguir?” |
| Busca em andamento | Máscara | “Buscando cadastros” |
| Falha na busca | Aviso “Aviso” | A mensagem devolvida pelo sistema (a grade é esvaziada) |
| Aplicar sem linha selecionada | Aviso “Aviso” | “Nenhuma registro selecionado. Selecione um registro para aplicar as alterações.” |
| Aplicar concluído | Informação “Status” | “Alterações aplicadas. Salve para confirmar a alteração” |
| Salvar sem alterações aplicadas | Aviso “Aviso” | “Nenhuma alteração aplicada. Aplique as alterações antes de salvar.” |
| Salvamento em andamento | Máscara | “Salvando Registros. Isso pode demorar dependendo da quantidade de registros. Por favor, aguarde.” |
| Salvamento concluído | Informação “Edição de cadastros” | “Cadastros Editados com sucesso” |
| Falha no salvamento | Erro “Aviso” | A mensagem devolvida pelo sistema |
| Usuário não é supervisor de usuário | Aviso “Sem permissão” | Erro “Sem permissão”, Motivo “O usuário não é supervisor de usuário”, Solução “Tente novamente com um login supervisor de usuário” |
| Grupo sem o recurso 4667 | Aviso | “Você não tem permissão para acessar este recurso” |
Regras de Negócio
Regras da busca
- Filial: quando informada, só entram cadastros cuja filial é igual à informada.
- Área, Tipo de Cadastro, Ramo de Atividade, Percurso e Condição de Pagamento: igualdade exata com o código informado.
- Código Cadastro Inicial e Final: cadastros com código maior ou igual ao inicial e menor ou igual ao final; os dois juntos formam um intervalo.
- Vendedor: igualdade com o vendedor do registro de cliente do cadastro.
- Supervisor de Vendas e Gerente de Vendas: igualdade com o supervisor ou o gerente do registro de vendedor do próprio cadastro (o filtro lista, portanto, cadastros que são vendedores com aquele supervisor ou gerente, e não os clientes deles).
- Lista de Preço: usa só o código antes da barra do valor; igualdade com a lista do cliente.
- Perfil Tributário: igualdade com o cadastro usado como perfil tributário.
- Forma de Cobrança, Banco Caixa e Grupo Econômico: igualdade com o registro do cliente; cadastros sem cliente não aparecem quando um desses filtros é usado.
- Todos os filtros se combinam com “e”. Filtro vazio ou zero não filtra.
- A tela exige ao menos um filtro preenchido (T-02). A busca devolve todos os cadastros que atendem aos filtros, sem ordenação definida e sem limite de quantidade, e não exclui os cadastros do tipo do parâmetro 17.
Regras do botão Aplicar
- Cada campo do painel só atua se tiver valor; campo vazio nunca limpa o valor da linha (T-09).
- O valor aplicado vale para todas as linhas selecionadas no momento do clique; linhas não selecionadas não mudam.
- A lista de preço é aplicada com código e data; a data só viaja para a grade.
- Só as linhas em que algum campo foi aplicado entram na lista de alterações a salvar, uma única vez cada.
Regras de bloqueio ao salvar
O bloqueio de cada cadastro é decidido pela diferença entre o valor enviado e o gravado, em três dimensões, e só vale se o tipo de cadastro exige a validação daquela dimensão:
- Financeiro (exige validação financeira no tipo): diferença na condição de pagamento, ou no banco caixa, na forma de cobrança ou no grupo econômico quando o cadastro já tem esses registros.
- Contábil (exige validação contábil no tipo): diferença no perfil tributário, ou no consumidor final ou no aceita substituição tributária quando o cadastro já tem registro de cliente.
- Comercial (exige validação comercial no tipo): diferença no vendedor ou na lista de preço quando o cadastro tem registro de cliente, ou no supervisor ou no gerente quando tem registro de vendedor.
O cadastro só é de fato bloqueado se, além disso, o tipo de cadastro é do tipo “bloqueia por edição” (situação padrão “BE”) e o cadastro ainda não está “B – BLOQUEADO” nem “I – INATIVO”. Nesse caso o sistema zera o validador e a data de validação das dimensões afetadas, muda a situação para “B – BLOQUEADO”, atualiza a data de alteração e registra a data e o usuário do bloqueio, quando ainda vazios. Cadastros já bloqueados ou inativos passam sem erro e sem aviso; qualquer falha nesse bloqueio também passa sem aviso, e a gravação dos demais dados segue. Diferenças em Área, Ramo, Status fluxo, Cooperado e Percurso nunca bloqueiam.
Regras de gravação
- Se a lista enviada vem vazia, o sistema avisa “Erro ao salvar.” com o motivo “Não é possível salvar um mesmo CNAE para campos diferentes.” e a solução “Selecionar códigos CNAE diferentes.” (texto padronizado reaproveitado; a tela não envia lista vazia).
- Os campos do cadastro (área, ramo, status de fluxo, cooperado, perfil tributário e condição de pagamento) são sempre regravados com o valor da linha; os não alterados voltam como estavam. Condição de pagamento vazia vira sem condição.
- Para cadastros sem registro de vendedor, o sistema cria esse registro mesmo que o cadastro não seja de um vendedor, e grava gerente e supervisor de vendas; para os sem registro de cliente, cria o de cliente.
- No registro de cliente são gravados vendedor, banco caixa, grupo econômico, forma de cobrança, lista de preço, consumidor final e aceita substituição tributária; os demais dados de cliente (risco, limite de crédito, prazos, desconto, dados da firma, banco fixo e forma de cobrança fixa) são regravados com o mesmo valor que já tinham.
- Se o percurso enviado existe, o sistema grava o percurso no cadastro, mantendo a ordem e a distância atuais; percurso vazio ou inexistente não altera nada.
- Cadastros inativos ou de qualquer tipo são gravados; esta tela não confere o recurso Editar do tipo de cadastro nem a situação do cadastro.
- Os cadastros de um envio são confirmados juntos no fim do processamento; lotes anteriores já confirmados permanecem se um lote posterior falhar.
Envio em lotes
A tela envia no máximo 3600 cadastros por vez e só envia o lote seguinte depois de a resposta do anterior chegar com sucesso. Se um lote falha, a tela mostra o erro do sistema, não envia os lotes seguintes e não refaz a busca (T-08).
Troubleshooting
A busca recusa o usuário que não é supervisor
Mensagem exibida: Aviso “Aviso” com Erro “Sem permissão”, Motivo “O usuário não é supervisor de usuário” e Solução “Tente novamente com um login supervisor de usuário”.
O que fazer: entre com um usuário marcado como supervisor de usuário, ou peça ao administrador para marcar o usuário no cadastro de usuários.
Busca sem filtros
Mensagem exibida: “Não foi possivel buscar Cadastros” — “Por favor preencha pelo menos 1 filtro<br/>”.
O que fazer: preencha ao menos um dos 16 filtros da aba “Filtros” e busque de novo.
A grade volta vazia ou sem o cadastro esperado
Mensagem exibida: nenhuma; a tela vai para a aba “Cadastros” com a grade vazia.
O que fazer: os filtros se combinam com “e”, então relaxe um deles. Filtros de forma de cobrança, banco caixa e grupo econômico não trazem cadastros sem registro de cliente. Os filtros Supervisor de Vendas e Gerente de Vendas procuram cadastros que são vendedores, não os clientes deles. Se o problema for o vendedor do cliente, use o filtro Vendedor.
Aplicar sem linha selecionada
Mensagem exibida: “Nenhuma registro selecionado. Selecione um registro para aplicar as alterações.”
O que fazer: marque as caixas de seleção das linhas na grade e acione “Aplicar” de novo.
Salvar sem alteração aplicada
Mensagem exibida: “Nenhuma alteração aplicada. Aplique as alterações antes de salvar.”
O que fazer: selecione as linhas, preencha os novos valores no painel, acione “Aplicar” e só depois “Salvar Todos”. Preencher o painel e salvar direto não grava nada. Se o botão “Salvar Todos” estiver desabilitado, é porque nenhum campo do painel foi alterado ou a grade está vazia.
Salvar Todos recusado por falta de permissão
Mensagem exibida: “Você não tem permissão para acessar este recurso”.
O que fazer: peça ao administrador para liberar ao grupo do usuário o recurso 4667.
Cadastro ficou bloqueado depois de salvar
Mensagem exibida: nenhuma; a mudança é feita sem aviso e a situação do cadastro passa a “B – BLOQUEADO”.
O que fazer: o tipo de cadastro é do tipo “bloqueia por edição” e exige validação em alguma dimensão (Financeira, Contábil ou Comercial) que teve o valor alterado. O cadastro volta à fila das telas de aprovação do Cadastro Geral; aprove-o nelas. Se um cadastro que deveria ter sido bloqueado não foi, lembre que falhas no bloqueio não são avisadas: confira a situação dele na rotina Cadastro geral.
Erro no meio do salvamento
Mensagem exibida: Erro “Aviso” com a mensagem devolvida pelo sistema.
O que fazer: como a lista de alterações pendentes é zerada ao acionar “Salvar Todos”, depois do erro um novo “Salvar Todos” mostra “Nenhuma alteração aplicada. Aplique as alterações antes de salvar.”; refaça a busca, reaplique as alterações às linhas que ainda não foram gravadas e salve de novo. Em seleções acima de 3600 cadastros, os lotes anteriores ao que falhou já foram gravados.
Não é possível limpar um valor em lote
Mensagem exibida: nenhuma.
O que fazer: campo vazio no painel significa “não alterar”. Para remover o vendedor, a lista de preço ou outro valor de um cadastro, edite-o pela rotina Cadastro geral.
Busca ou salvamento demorados
Mensagem exibida: máscara “Buscando cadastros” ou “Salvando Registros. Isso pode demorar dependendo da quantidade de registros. Por favor, aguarde.”
O que fazer: aguarde; a tela espera até 10 minutos. Para volumes grandes, filtre por faixa de código e salve em etapas.
Casos de Uso
Caso 1 — Trocar o vendedor de uma carteira de clientes
O supervisor Paulo abre Cadastro Geral > Manutenção de Cadastro Geral e, em “Filtros”, escolhe o Vendedor 310 e o Tipo de Cadastro “Cliente”. Aciona “Buscar Cadastros” e a grade mostra 42 clientes. Na aba “Cadastros”, marca todas as linhas, expande o bloco “Comercial”, escolhe o Vendedor 455 e aciona “Aplicar”. A tela avisa “Alterações aplicadas. Salve para confirmar a alteração”. Ele aciona “Salvar Todos” e a tela confirma “Cadastros Editados com sucesso” e refaz a busca, que agora volta vazia para o vendedor 310.
Caso 2 — Corrigir a área de um intervalo de cadastros
A supervisora Marina informa Código Cadastro Inicial 2000 e Final 2099 e busca. Seleciona só 15 linhas, define Área “SUL” no bloco “Cadastro Geral” e aciona “Aplicar”. Antes de salvar, repete para outras 10 linhas com a área “NORTE”. As 25 linhas entram uma vez cada na lista e são enviadas juntas ao acionar “Salvar Todos”.
Caso 3 — Alterar a condição de pagamento de clientes que exigem validação financeira
O supervisor Paulo aplica a Condição de Pagamento “30/60” a 12 clientes. O tipo de cadastro “Cliente” exige validação financeira e bloqueia por edição. Ao salvar, os 12 cadastros ficam “B – BLOQUEADO” e voltam à fila de Aprovação Financeira (T-07). Ele avisa o financeiro para validar.
Caso 4 — Salvar sem aplicar
A analista Rosa seleciona linhas, preenche a Lista de Preço no painel e aciona “Salvar Todos” sem acionar “Aplicar”. A tela avisa “Nenhuma alteração aplicada. Aplique as alterações antes de salvar.” (T-05). Ela aciona “Aplicar” e salva em seguida.