Criar Rota de Venda

Rotas

Acesse Movimentar → Rotas de venda e use o botão +. A rota define quais vendedores podem vender para quais clientes e com quais mercadorias aprovisionadas.

  1. Informe o nome da rota e, opcionalmente, data de início e data de fim.
  2. Selecione os vendedores da rota (usuários com perfil ADMIN ou SELLER) que poderão operar a rota.
  3. Defina a cobertura de clientes por UF e/ou cidade. As opções exibidas vêm dos clientes cadastrados no tenant.
  4. Defina as mercadorias por escopo: todas, por grupo, subgrupo ou marca e clique em Aplicar escopos e listar produtos.
  5. Opcionalmente, em Adicionar mercadoria específica (independente do escopo), clique no campo combinado de busca, digite para filtrar e escolha a mercadoria na lista; confirme com Adicionar mercadoria.
  6. No quadro de produtos, ajuste a coluna Qtd inicial na rota (inteiro, mínimo 1 e máximo igual ao estoque atual fora da rota).

Regras de inclusão e deduplicação: mercadorias já adicionadas na rota não aparecem novamente na busca de mercadoria específica; ao reaplicar escopos, itens já incluídos não são duplicados.

Escopo opcional: é permitido salvar rota sem filtro de mercadorias, desde que exista ao menos uma mercadoria selecionada no quadro de produtos.

Aprovisionamento de estoque: ao salvar a rota, a quantidade aprovisionada é debitada do estoque global da mercadoria. Esse saldo reservado passa a ser controlado dentro da rota. Quando o produto possuir variantes ativas preparadas, o sistema também passa a distribuir automaticamente esse aprovisionamento entre as variantes e a reservar o saldo detalhado delas para a rota.

Rotas com variantes (modelo operacional novo): quando a mercadoria possui variantes ativas, a seleção e o aprovisionamento passam a considerar a variante como item operacional principal (SKU/preço/estoque próprios). Itens simples continuam sendo operados por produto.

Migração segura do estado aberto: para rotas de venda ativas antigas (sem linhas por variante), o administrador pode executar a migração por API interna em duas etapas: primeiro simulação (dryRun=1) para validar capacidade/saldos e revisar erros; depois execução real (dryRun=0) para criar as linhas em sales_route_product_variants e reservar o saldo detalhado das variantes.

Endpoint administrativo da migração: POST /_t/{tenant}/api/variantes/migrar-estado-aberto (sessão web autenticada com permissão de edição de mercadorias). Parâmetros opcionais: dryRun e routeIds[] para restringir o processamento a rotas específicas.

No mesmo módulo

Quer usar isso na operação?

Estoque, vendas, rotas e financeiro no mesmo sistema. O teste dura 7 dias.

Ver planos