Cadastro de Canal de Venda
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Canais de Venda > "Novo Canal" ou ícone Editar na lista Última atualização: 20/04/2026
Para que serve
Cria e edita canais de venda. Define o meio de comercialização (ex.: balcão, representante, e-commerce) com sua tabela de preço e condição de pagamento padrão e percentual de comissão. Ao selecionar o canal em um pedido, esses valores são sugeridos automaticamente.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Para criar, clique em "Novo Canal" na Lista de Canais de Venda.
- Preencha os campos obrigatórios: Descrição e Tipo.
- Opcionalmente vincule uma Tabela de Preço e uma Condição de Pagamento padrão.
- Clique em "Cadastrar Canal". 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 do Canal
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Gerado automaticamente | Exibido somente na edição; sequencial por tenant |
| Situação | Não | Ativo ou Inativo | Default: Ativo |
| Descrição | Sim | Nome do canal | Ex.: "Representante Sul" |
| Tipo | Sim | Balcão, Representante, Televendas, E-commerce, Marketplace, Distribuidor, Exportação ou Outros | Determina a categoria do canal |
| Comissão (%) | Não | Percentual (0–100) com passo 0,01 | Percentual de comissão padrão dos vendedores neste canal |
| Tabela de Preço Padrão | Não | Tabela de preço ativa | Sugerida automaticamente ao usar este canal em pedidos e orçamentos |
| Condição de Pagamento Padrão | Não | Condição de pagamento ativa | Sugerida automaticamente ao usar este canal em pedidos e orçamentos |
| Observações | Não | Texto livre | Campo aberto |
Validações e regras
- Ao salvar em criação, navega para
/comercial/canais-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.
- Somente tabelas com situação "ativa" e condições com situação "ativa" aparecem nos seletores.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe a descricao" | Campo Descrição vazio | Preencha o nome do canal |
| "Selecione o tipo" | Tipo não selecionado | Escolha um tipo na lista |
| "Erro ao carregar canal de venda" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Erro ao salvar canal de venda" | Erro de validação ou conflito no backend | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
canaisVendaService(canais-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)
Dúvidas frequentes
Preciso vincular tabela de preço e condição de pagamento? Não. Esses campos são opcionais. Quando preenchidos, apenas sugerem os valores padrão ao abrir um pedido — o usuário pode substituí-los.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |