• Permite cadastrar uma lista de vendedores no painel administrativo e exibir um seletor no checkout para o cliente indicar quem realizou a venda.
• Resolve o problema de saber qual vendedor participou de cada pedido — útil para lojas com equipe de vendas, comissionamento ou atendimento presencial.
• O vendedor escolhido fica gravado no pedido, aparece no painel e pode ser incluído no e-mail de confirmação.
• Disponível para lojas Magento 2.

#Passo a Passo por Escrito

#1. Cadastre os vendedores da sua loja

Acesse o menu Vendas → Operações → Vendedores e clique em Adicionar Vendedor.

Preencha os dados de cada vendedor:

1. Nome — nome que aparecerá no checkout e no pedido (obrigatório).
2. E-mail e Telefone — dados de contato do vendedor (opcionais).
3. Ordem — número que define a posição do vendedor no seletor do checkout. O menor número aparece primeiro.
4. Ativo — deixe como Sim para que o vendedor apareça no checkout.

Clique em Salvar Vendedor e repita para cada vendedor da equipe.

#2. Acesse as configurações do módulo

Vá em Lojas → Configurações → Vendas → Vendedores.

#3. Habilite o seletor no checkout

No grupo Geral, defina o campo Habilitar seletor no checkout como Sim.

#4. Personalize o bloco do checkout

Ainda na tela de configuração, ajuste o grupo Checkout:

1. Título do bloco — texto exibido acima do seletor. Exemplo: Algum vendedor realizou sua venda?
2. Texto do dropdown (placeholder) — opção padrão mostrada antes de o cliente escolher. Exemplo: Selecione um vendedor
3. Exibir dropdown de vendedor — mantenha Sim para mostrar a lista de vendedores. Deixe Não se quiser usar apenas os campos de observação (passo 5).
4. Vendedor obrigatório — defina Sim para exigir que o cliente escolha um vendedor antes de finalizar o pedido.

#5. Habilite campos de observação (opcional)

No grupo Campos de observação, você pode ligar até dois campos de texto livre, exibidos junto ao seletor no checkout. Eles são independentes entre si.

Para cada campo:

1. Defina Habilitar campo 1 (ou Habilitar campo 2) como Sim.
2. Rótulo do campo — nome que aparece acima do campo. Exemplo: Observação
3. Placeholder do campo — texto de ajuda dentro do campo.
4. Limite de caracteres do campo — quantidade máxima de caracteres permitida (padrão 255).

#6. Inclua o vendedor no e-mail do pedido (opcional)

No grupo E-mail do pedido, defina Incluir vendedor no e-mail do pedido como Sim.

Para que o vendedor apareça no e-mail, é preciso inserir um pequeno trecho no template do e-mail. A forma mais simples, sem depender do time técnico, é pelo próprio painel:

1. Acesse Marketing → Comunicações → Modelos de E-mail e clique em Adicionar Novo Modelo.
2. No campo Modelo, selecione New Order Confirmation e clique em Carregar Modelo (Load Template).
3. No corpo do e-mail, cole o trecho abaixo no ponto onde deseja que o vendedor apareça:

{{block class="MageShop\Seller\Block\Email\Seller" order_id=$order_id}}

4. Clique em Salvar Modelo.
5. Aponte esse modelo em Lojas → Configurações → Vendas → E-mails de Vendas → Novo Pedido (New Order Confirmation).

#7. Salve a configuração

Clique em Salvar Configuração no topo da tela.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Seletor aparece no checkout

Ação: com pelo menos um vendedor ativo cadastrado e o seletor habilitado, adicione um produto ao carrinho e vá até o checkout. Observe o resumo do pedido (na lateral, no mesmo estilo do campo de cupom).

Teste 2 — Vendedor é gravado no pedido

Ação: finalize um pedido de teste escolhendo um vendedor. Depois, no painel, abra Vendas → Pedidos e clique no pedido recém-criado.

Teste 3 — Vendedor obrigatório bloqueia a finalização

Ação: com Vendedor obrigatório ligado, tente finalizar um pedido sem escolher nenhum vendedor.

Teste 4 — Vendedor no e-mail do pedido

Ação: com o e-mail habilitado e o trecho colado no template, abra um pedido que tenha vendedor em Vendas → Pedidos → #... e clique em Enviar E-mail para reenviar a confirmação. Confira a mensagem recebida.

Se não funcionar, verifique:

• Se o campo Habilitar seletor no checkout está como Sim e a configuração foi salva.
• Se existe pelo menos um vendedor com o campo Ativo = Sim — sem nenhum vendedor ativo, o dropdown não aparece.
• Se o cache da loja foi limpo após salvar as configurações.
• Para o e-mail: se Incluir vendedor no e-mail do pedido está como Sim, se o trecho foi colado no template correto e se o pedido de teste realmente tem vendedor ou observação.

#Observações Importantes

• Escopo da configuração: as configurações podem ser definidas por Site ou por Visão de Loja. Assim, você pode habilitar o seletor apenas em determinadas lojas do seu ambiente, se tiver mais de uma.
• Ordem dos vendedores: o campo Ordem de cada vendedor controla a sequência no seletor do checkout — o menor número aparece primeiro. Vendedores com a mesma ordem são exibidos em ordem alfabética.
• Modo "só observação": desligando o dropdown e habilitando apenas os campos de observação, o bloco do checkout passa a coletar somente texto livre, sem lista de vendedores.
• Vendedor obrigatório sem vendedores ativos: ligar a obrigatoriedade sem nenhum vendedor ativo cadastrado não trava o checkout — a exigência só passa a valer quando há vendedores disponíveis para escolher.
• Compatível com checkout customizado: o bloco funciona no checkout padrão do Magento 2 e no full checkout O2TI, aparecendo no resumo do pedido no estilo do campo de cupom.

#Referências e Relacionados

• Configuração de e-mails de vendas: para exibir o vendedor no e-mail de confirmação, é preciso ajustar o modelo de e-mail de novo pedido — esta doc cobre como gerenciar os modelos de e-mail transacionais.
• Gerenciamento de cache da loja: após alterar as configurações do módulo, é necessário limpar o cache para que as mudanças apareçam no checkout.
• Permissões e usuários: para controlar quem pode cadastrar, editar ou excluir vendedores no painel, configure as permissões das funções de usuário.
• Gerenciamento de pedidos: depois que o vendedor é registrado no pedido, o acompanhamento segue pelo fluxo normal de pedidos — esta doc cobre os próximos passos.