Cadastro de Região de Venda
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Regiões de Venda > "Nova Região" ou ícone Editar na lista Última atualização: 20/04/2026
Para que serve
Cria e edita regiões de venda. Define uma área geográfica (conjunto de cidades) atendida por vendedores específicos, com tabela de preço e condição de pagamento padrão. Regiões sem cidades são tratadas como nacionais.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Para criar, clique em "Nova Região" na Lista de Regiões de Venda.
- Preencha o campo obrigatório: Descrição.
- Opcionalmente defina Tabela de Preço, Condição de Pagamento e % Comissão.
- Na seção "Cidades", clique em "Cidade" para adicionar municípios. Informe nome, UF e, opcionalmente, o código IBGE.
- Na seção "Vendedores", ative os usuários que atendem esta região e marque o principal.
- Clique em "Cadastrar Região". O sistema redireciona para a tela de edição.
- Na edição, clique em "Salvar Alterações". A tela permanece aberta.
Campos da tela
Seção: Dados Gerais
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Gerado automaticamente | Exibido somente na edição; sequencial por tenant |
| Situação | Não | Ativa ou Inativa | Default: Ativa |
| Descrição | Sim | Nome da região | Ex.: "Interior de SP", "Sul do Brasil" |
| Comissão (%) | Não | Percentual (0–100) com passo 0,01 | Comissão padrão para vendas nesta região |
| Tabela de Preço Padrão | Não | Tabela de preço ativa | Sugerida automaticamente ao usar esta região em pedidos |
| Condição de Pagamento Padrão | Não | Condição de pagamento ativa | Sugerida automaticamente ao usar esta região em pedidos |
| Observações | Não | Texto livre | Campo aberto |
Seção: Cidades
Tabela editável. Cada linha representa uma cidade da região.
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Cidade | Sim (para salvar a linha) | Nome da cidade | Texto livre |
| UF | Sim (para salvar a linha) | Sigla de estado (2 letras maiúsculas) | Seletor com todos os estados brasileiros |
| IBGE | Não | Código numérico IBGE | Para integração fiscal |
| Ações | — | Lixeira | Remove a cidade |
Sem cidades cadastradas a região é nacional (sem restrição geográfica).
Seção: Vendedores
Tabela com todos os usuários ativos do tenant. Para cada usuário:
| Coluna | Descrição |
|---|---|
| Selecionar | Switch para incluir/excluir o usuário desta região |
| Nome | Nome do usuário |
| E-mail do usuário | |
| Principal | Switch para marcar como vendedor principal (apenas um por vez) |
Validações e regras
- Ao salvar, somente cidades com nome e UF preenchidos são enviadas ao backend.
- Ao salvar em criação, navega para
/comercial/regioes-venda/:id/editar(replace: true). - Ao salvar em edição, o registro é recarregado da API sem fechar a tela.
- A navegação de volta pede confirmação se houver alterações não salvas.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe a descricao" | Campo Descrição vazio | Preencha o nome da região |
| "Erro ao carregar regiao" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Erro ao salvar regiao de venda" | Erro de validação ou conflito no backend | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
regioesVendaService(regioes-venda.service) - Carrega tabelas de preço via
/comercial/tabelas-preco(situação ativa) - Carrega condições de pagamento via
/comercial/condicoes-pagamento(situação ativa) - Carrega usuários via
/usuarios(situação ativo)
Dúvidas frequentes
Posso vincular o mesmo vendedor a várias regiões?
O código IBGE é obrigatório? Não. É opcional e serve para cruzamento com dados fiscais.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |