Lista de Regiões de Venda
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Regiões de Venda Última atualização: 20/04/2026
Para que serve
Exibe todas as regiões de venda cadastradas no tenant. Regiões de venda agrupam cidades e vendedores para aplicar tabelas de preço, condições de pagamento e comissões diferenciadas por área geográfica.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Acesse Menu > Comercial > Regiões de Venda.
- Use o campo de busca para filtrar por descrição.
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro de edição.
- Clique em "Nova Região" para criar uma nova região.
- Clique no ícone de lixeira para remover (confirmação obrigatória).
- A lista carrega mais registros ao rolar até o fim (scroll infinito, lotes de 50).
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Descrição | Filtra em tempo real |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| ID | Identificador interno sequencial |
| Descrição | Nome da região de venda |
| Cidades | Quantidade de cidades cadastradas na região |
| Vendedores | Quantidade de vendedores vinculados à região |
| Comissão | Percentual de comissão padrão ou "—" |
| Situação | Tag: Ativa (verde) ou Inativa (cinza) |
| Ações | Lixeira para remover |
Validações e regras
- A remoção usa confirmação antes de excluir.
- Regiões sem cidades cadastradas são consideradas nacionais (sem restrição geográfica).
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar regioes de venda" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
| "Regiao de venda removida com sucesso" | Remoção bem-sucedida | — |
| "Erro ao remover regiao de venda" | Região em uso ou erro na API | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
regioesVendaService(regioes-venda.service) - Regiões são usadas nos Pedidos de Venda e Orçamentos
Dúvidas frequentes
Uma região sem cidades vale para qualquer lugar? Sim. Região sem cidades é tratada como nacional, sem restrição geográfica.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |