Compradores Família Produtos
Compradores Família Produtos — Suprimentos (ERPAtak)
A rotina Compradores Família Produtos, do módulo Suprimentos (menu Cadastros), é o cadastro que diz qual comprador responde por cada item, em cada filial.
Visão Geral
A rotina Compradores Família Produtos, do módulo Suprimentos (menu Cadastros), é o cadastro que diz qual comprador responde por cada item, em cada filial. A listagem mostra uma linha por comprador, com o código, o nome e o total de itens cadastrados. Ao abrir um comprador, o usuário mantém a lista de vínculos dele: cada linha liga uma filial a um item (produto e referência) e tem um status, “1 – Ativo” ou “2 – Inativo”. Esse cadastro define o que cada comprador enxerga e pode tratar nas rotinas de cotação e de pré-aprovação de orçamentos.
Pré-requisitos
- Cadastro geral de funcionário: o comprador é escolhido entre os cadastros gerais cujo tipo de cadastro está entre os tipos de funcionário configurados.
- Filiais cadastradas: cada vínculo precisa de uma filial.
- Itens cadastrados e ativos: a pesquisa de item só traz referências que não estejam inativas.
Permissões e Acesso
Recursos de menu e de ação da Compradores Família Produtos
A rotina aparece no menu Suprimentos > Cadastros como recurso 986 (“Compradores Família Produtos”), com ordem 2 no grupo. O usuário só vê a opção se o seu grupo tiver acesso a esse recurso.
| Recurso | Ação protegida |
|---|---|
| 986 | Abrir a tela de listagem |
| 1012 | Gravar um comprador novo com seus vínculos |
| 983 | Gravar a edição dos vínculos de um comprador |
| 984 | Excluir todos os vínculos de um comprador |
| 985 | Exportar a listagem |
Quando o grupo do usuário não tem acesso a uma ação protegida, o sistema responde “Você não tem permissão para acessar este recurso”.
Ações da Compradores Família Produtos sem verificação de recurso
Listar os compradores, abrir um comprador, listar os vínculos de um comprador e a consulta da listagem dinâmica não têm conferência de grupo nem de recurso do usuário: qualquer usuário conectado pode executá-las.
Fluxo Operacional
Fluxo de cadastro dos itens de um comprador
- O usuário abre Suprimentos > Cadastros > Compradores Família Produtos; a tela abre “Lista de Produtos e Compradores”.
- Para um comprador novo, aciona “Novo” e escolhe o “Comprador” na janela “Novo comprador”. Para um comprador já cadastrado, dá duplo clique na linha; a tela abre “Editar comprador : {código}”.
- Aciona “Novo item”, escolhe a “Filial” e o “Item” na linha e confere o “Status” (“1 – Ativo” por padrão).
- Repete para cada filial e item e confirma cada linha.
- Aciona “Salvar” ou “Salvar e fechar”.
Fluxo de retirada ou inativação de itens
- O usuário abre o comprador.
- Para inativar, edita a linha e troca o “Status” para “2 – Inativo”. Para retirar, seleciona a linha, aciona “Excluir item” e confirma.
- Aciona “Salvar” ou “Salvar e fechar”.
Interface e Comportamentos da Tela
Listagem de compradores
A tela “Lista de Produtos e Compradores” tem a barra de ferramentas “Suprimentos -> Compradores”, a pesquisa livre e a grade com paginação. A barra da listagem não tem o botão “Excluir”; a exclusão de um comprador é feita dentro da edição. Cada linha é um comprador que tem ao menos um vínculo cadastrado.
| Coluna | Conteúdo |
|---|---|
| Comprador | Código do cadastro geral do comprador |
| Nome | Nome do cadastro geral |
| Total | Quantidade de vínculos cadastrados do comprador, ativos e inativos |
O duplo clique numa linha abre a edição do comprador.
Janela de edição do comprador
A janela “Novo comprador” (ou “Editar comprador : {código}”) tem o grupo “Comprador”, com o campo “Comprador” (pesquisa de cadastro geral de funcionários, obrigatória), e abaixo a grade de vínculos. Na edição, o campo “Comprador” fica protegido e não pode ser trocado. A barra de ferramentas da edição tem “Salvar”, “Salvar e fechar”, “Salvar e novo”, “Cancelar”, “Excluir”, “Novo item”, “Editar item”, “Excluir item” e “Fechar Aba”; a barra do cadastro novo não tem “Excluir”.
Grade de itens do comprador
A grade é editável por linha, com paginação, e lista os vínculos do comprador.
| Coluna | Edição | Observação |
|---|---|---|
| Filial | Sim | Pesquisa de filial, obrigatória; a grade mostra código e nome da filial |
| Item | Sim | Pesquisa de produto com preço de custo, obrigatória (“Campo obrigatório”); a grade mostra código e nome do item |
| Status | Sim | Lista “1 – Ativo” e “2 – Inativo”; inicia em “1 – Ativo” |
Exclusão de item na grade
O botão “Excluir item” pede a confirmação “Deseja excluir o item selecionado?”. Ao confirmar, a linha some da grade e fica marcada para exclusão, que só vale depois de “Salvar” ou “Salvar e fechar”. Sem linha selecionada, a tela avisa “É necessário selecionar um item para poder excluí-lo.”.
Troca de página da grade
Quando há linhas incluídas, alteradas ou removidas na grade, a troca de página aciona o botão “Salvar” antes de carregar a nova página. Sem alterações, apenas troca de página. Ao gravar, a tela recarrega a listagem.
Pesquisas da janela de edição
A pesquisa de “Comprador” lista os cadastros gerais dos tipos de cadastro de funcionário configurados. A pesquisa de “Item” lista as referências de item que não estão inativas, com o código, o nome e a referência (grade).
Feedbacks ao Usuário
Feedbacks — manutenção dos itens do comprador
| Situação | Feedback | Texto exato |
|---|---|---|
| Confirmação de exclusão de item | Confirmação “Confirmação” | “Deseja excluir o item selecionado?” |
| Exclusão sem item selecionado | Erro “Atenção” | “É necessário selecionar um item para poder excluí-lo.” |
| Item sem preenchimento | Destaque do campo | “Campo obrigatório” |
Mensagens da gravação
| Situação | Título | Texto exato |
|---|---|---|
| Comprador novo gravado | “Comprador” | “Comprador inserida(o) com sucesso.” |
| Comprador editado | “Editar Comprador” | “Comprador editada(o) com sucesso.” |
| Comprador excluído | “Excluir Comprador” | “Comprador excluída(o) com sucesso” |
As validações da gravação aparecem como mensagem padronizada com três partes, Erro, Motivo e Solução. O texto está em Troubleshooting.
Regras de Negócio
Vínculo de comprador com filial e item
Cada vínculo guarda o comprador (cadastro geral), a filial, o produto, a referência e o status (“1 – Ativo” ou “2 – Inativo”). O vínculo é único pela combinação de comprador, filial, produto e referência.
Gravação de comprador novo
O comprador novo só grava com pelo menos um item na grade.
Gravação da edição
- Vínculo existente: o sistema atualiza status, item, referência e filial.
- Vínculo novo: o sistema cria o vínculo com o comprador, a filial, o item e o status informado.
- Linha excluída: o sistema exclui o vínculo da linha marcada para exclusão.
- Grade vazia na edição: quando a edição é gravada sem nenhuma linha, o sistema exclui todos os vínculos do comprador, sem mensagem, e o comprador deixa de aparecer na listagem.
- Só vale o que está na grade carregada: a gravação considera as linhas que estão na grade da tela (a página atual, mais as páginas que o usuário já gravou ao trocar de página).
Exclusão do comprador
O botão “Excluir” apaga todos os vínculos do comprador. O cadastro geral e os itens não são alterados.
Status do vínculo
Só vínculos “1 – Ativo” valem como responsabilidade do comprador nas rotinas de cotação e de pré-aprovação. Vínculos “2 – Inativo” permanecem cadastrados e aparecem no “Total” da listagem, mas o comprador deixa de enxergar os itens deles nessas rotinas.
Pesquisa livre da listagem
Na listagem de compradores, um texto numérico filtra pelo código do comprador; qualquer outro texto filtra pelos compradores cujo nome contenha o texto. Na grade de itens, um texto numérico filtra os vínculos cujo código do item ou da referência contenha o número, ou cuja filial seja igual ao número; qualquer outro texto filtra por filial (código ou apelido), código ou nome do item e referência.
Ordenação
A listagem vem pelo código do comprador, do menor para o maior; o clique no título de “Comprador”, “Nome” ou “Total” ordena pela coluna. A grade de itens vem na ordem de criação dos vínculos.
Uso do cadastro nas cotações e pré-aprovações
As rotinas Gerar cotações, Cotações de compra e Pré-aprovação de orçamentos só mostram ao comprador logado os itens (ou as famílias de itens) para os quais o cadastro geral dele está como comprador ativo, na filial do documento.
Relatórios e Exportações
Exportação da listagem de compradores
Os botões de exportação geram Excel, Word, PDF e HTML da listagem (comprador, nome e total), no máximo 1000 registros e sem a pesquisa livre da tela, sob o recurso 985.
Integrações
Cotações e pré-aprovação de orçamentos
O cadastro de compradores é a base da visibilidade de itens nas rotinas Gerar cotações, Cotações de compra e Pré-aprovação de orçamentos.
Troubleshooting
Gravação recusada: comprador sem itens
Mensagem exibida: Erro “Não foi possível cadastrar Comprador”, Motivo “Não é possível cadastrar um comprador sem produtos”, Solução “Favor informe um novo produto para realizar operação”
O que fazer: incluir ao menos uma linha com filial e item na grade antes de gravar o comprador novo.
Comprador sumiu da listagem depois de editar
Sintoma: depois de gravar a edição, o comprador não aparece mais na listagem.
O que fazer: a edição gravada com a grade vazia exclui todos os vínculos do comprador. Cadastrar o comprador de novo com os itens.
Comprador não enxerga os itens nas cotações
Sintoma: o comprador não vê itens ou cotações que esperava nas rotinas de cotação e pré-aprovação.
O que fazer: conferir se existe vínculo do cadastro geral dele com o item (ou a família) na filial do documento e se o status do vínculo é “1 – Ativo”.
Item não aparece na pesquisa
Sintoma: o item esperado não aparece ao incluir a linha.
O que fazer: a pesquisa só traz referências que não estejam inativas; reativar o item ou pesquisar pelo código.
Casos de Uso
Caso 1 — Cadastro de um comprador novo
O gerente de compras cadastra a funcionária Marina como compradora. Aciona “Novo”, escolhe Marina, inclui duas linhas (filial 001 com o item “Parafuso 10mm” e filial 001 com o item “Porca 10mm”), deixa o status “1 – Ativo” e aciona “Salvar e fechar”. Marina passa a aparecer na lista com “Total” igual a 2.
Caso 2 — Inativação de um item de um comprador
O comprador Paulo deixou de cuidar do item “Porca 10mm” na filial 001. O gerente abre o cadastro dele, edita a linha, troca o “Status” para “2 – Inativo” e grava. O “Total” não muda, mas Paulo deixa de ver esse item nas cotações.
Caso 3 — Retirada de um item
O gerente abre o cadastro de Paulo, seleciona a linha do item “Parafuso 10mm”, aciona “Excluir item”, confirma com “Sim” e grava. O “Total” diminui em 1.
Caso 4 — Exclusão do cadastro de um comprador
Marina deixou o setor. O gerente abre o cadastro dela e aciona “Excluir”. Todos os vínculos são apagados e ela deixa de aparecer na listagem.