Tutorial de Agentes Intermediadores

Bem-vindo ao Tutorial de Agentes Intermediadores!

Nesta seção, você aprenderá como cadastrar, pesquisar, editar e gerenciar agentes de viagens e intermediadores no sistema ChipWeb-VoyAGE. Os agentes intermediadores são parceiros essenciais que vendem pacotes e serviços turísticos através da plataforma.

💡 O que você vai aprender:

Como registrar novos agentes intermediadores no sistema
Como diferenciar entre Promotores e Agências
Como preencher dados gerais e de localização
Como configurar informações de contato e financeiras
Como gerenciar comissões e pagamentos
Como pesquisar e filtrar agentes
Como editar informações de agentes
Como deletar registros de agentes

Como Registrar um Novo Agente Intermediador

Dados Gerais

📌 Numerador

Número automático gerado pelo sistema. Não é necessário preenchê-lo manualmente.

Exemplo: 13918, 13917, 13916...

🏷️ Tipo

Tipo de agente intermediador. Define o papel e as permissões no sistema.

⭕ Promotor(a) - Pessoa física que promove e vende pacotes

⭕ Agência - Empresa de viagens que comercializa pacotes

🔢 CNPJ

CNPJ ou CPF do agente intermediador. Campo obrigatório e único.

Formato: 00.000.000/0000-00 (CNPJ) ou 000.000.000-00 (CPF)

Exemplo: 46.770.444/0001-07

🏢 Razão Social

Nome oficial/razão social do agente. Campo obrigatório.

Exemplo: T2 Tour Viagens e Passeios

Exemplo: Atria Viagens e Turismo Ltda

🏷️ Nome Fantasia

Nome comercial ou fantasia do agente. Como é conhecido no mercado.

Exemplo: T2Tour viagens

Exemplo: Atria Viagens

Logradouro (Endereço)

📮 CEP

Código de Endereçamento Postal do agente.

Formato: 00000-000

Exemplo: 01310-100

🛣️ Endereço

Rua, avenida ou logradouro do agente.

Exemplo: Avenida Paulista

🏘️ Bairro

Bairro onde o agente está localizado.

Exemplo: Centro

🏙️ Cidade

Cidade onde o agente está localizado.

Exemplo: São Paulo

Exemplo: Salvador

🗺️ Estado

Estado/Província onde o agente está localizado.

Exemplo: SP (São Paulo)

Exemplo: BA (Bahia)

🌍 País

País onde o agente está localizado.

Exemplo: Brasil

Identificação

✈️ Embratur

Número de registro na Embratur (se aplicável). Campo opcional.

Exemplo: 123456

👥 Grupo/Franquia

Grupo ou franquia a qual o agente pertence. Campo opcional.

Exemplo: Grupo Viagens Brasil

Exemplo: Franquia CVC

Formas de Contato

☎️ Telefone

Número de telefone comercial do agente.

Exemplo: (11) 3021-0789

📱 Celular

Número de celular para contato rápido.

Exemplo: (11) 99999-8888

👤 Nome do Contato

Nome da pessoa de contato no agente.

Exemplo: João Silva

✉️ Email

Email de contato do agente.

Exemplo: contato@agente.com.br

🔐 Senha (WebApp)

Senha de acesso ao portal/aplicativo do agente.

Exemplo: ******* (criptografada)

Dados Bancários

🏦 Dados Bancários

Informações bancárias do agente para pagamento de comissões.

Colunas:

• Tipo: Conta-Corrente, Poupança, etc

• Favorecido: Nome do titular

• Banco: Nome do banco

• Agência: Número da agência

• Conta: Número da conta

• Chave PIX: Chave PIX para transferências

Dados Complementares

💰 Comissões

Informações sobre comissões e percentuais pagos ao agente.

Exemplo: 10% sobre vendas

Exemplo: 5% fixo + 2% variável

📝 Observações

Campo livre para anotações gerais sobre o agente.

Exemplo: Agente confiável, ótimo relacionamento

💼 CRM

Paleta de opções para gerenciamento de relacionamento com o agente.

Exemplo: Selecionar opções de interesse

📌 Ocorrências

Registro de ocorrências/incidentes com o agente.

Exemplo: Atraso em pagamento, Reclamação de cliente

Tela de inserção de novos agentes intermediadores com todos os campos

Passo a Passo para Registrar um Agente Intermediador:

1

Acesse a Tela de Agentes Intermediadores

No menu lateral, clique em "Rotinas" → "Agentes Intermediadores"
2

Clique em "Novo" ou "Incluir"

Procure pelo botão para criar um novo agente
3

Preencha os Dados Gerais

Tipo, CNPJ, Razão Social e Nome Fantasia
4

Preencha o Logradouro

CEP, Endereço, Bairro, Cidade, Estado e País
5

Preencha a Identificação

Embratur e Grupo/Franquia (se aplicável)
6

Adicione Formas de Contato

Telefone, Celular, Email, Nome do Contato e Senha
7

Adicione Dados Bancários

Informações de contas bancárias para pagamento de comissões
8

Preencha Dados Complementares

Comissões, Observações, CRM e Ocorrências
9

Revise as Informações

Verifique se todos os dados estão corretos
10

Clique em Salvar

Pressione o botão verde "Salvar" para confirmar

💡 Dicas Úteis

✅ Sempre preencha Razão Social e Nome Fantasia para fácil identificação
✅ Registre o CNPJ/CPF com cuidado - deve ser único no sistema
✅ Defina corretamente o Tipo (Promotor vs Agência) para permissões corretas
✅ Mantenha dados bancários atualizados para pagamento de comissões
✅ Registre informações de comissão de forma clara
✅ Use o campo de observações para informações importantes
✅ Registre contato de emergência sempre que possível
✅ Revise dados antes de salvar para evitar erros

Como Pesquisar Agentes Intermediadores

A tela de pesquisa permite visualizar todos os agentes intermediadores cadastrados no sistema com suas informações principais.

📋 Colunas Disponíveis:

Numerador: ID único do agente
Razão Social/Nome Completo: Nome oficial do agente
Fantasia/Nome Social: Nome comercial
Cidade: Localização do agente
Estado: Estado/Província
CNPJ/CPF: Número de identificação
Telefone: Número de telefone
Email: Endereço de email
Ações: Botões para editar e deletar

🔍 Filtros de Pesquisa

Você pode filtrar os resultados por:

• Termo aproximado (busca por nome, cidade, CNPJ)

• Quantidade de registros por página (25, 50, 100)

🎯 Dicas de Busca

Para encontrar agentes rapidamente:

• Busque pelo nome fantasia para resultados rápidos

• Use a cidade para encontrar agentes locais

• Procure pelo CNPJ para validar agentes

• Use o email para localizar contatos específicos

Tela de pesquisa com lista completa de agentes intermediadores

Passo a Passo para Pesquisar:

1

Acesse a Aba "Pesquisas/Impressão"

Clique na aba "Pesquisas/Impressão" na tela de Agentes
2

Digite o Termo (Opcional)

No campo "Pesquisar Por", digite um termo aproximado (nome, cidade ou CNPJ)
3

Escolha Registros por Página

Selecione quantos registros deseja visualizar por página
4

Visualize os Resultados

A lista será exibida com todos os agentes que correspondem aos critérios
5

Use a Paginação

Clique em "Anterior" ou "Próximo" para navegar entre as páginas

💡 Dicas Úteis

✅ Use a busca por termo aproximado para encontrar agentes rapidamente
✅ Busque pelo nome fantasia para resultados mais rápidos
✅ Use a cidade para encontrar agentes locais
✅ Aumente o número de registros por página para ver mais agentes
✅ Clique nas colunas para ordenar os resultados (se disponível)

Editar e Deletar Agentes Intermediadores

✏️

Editar Agente

Modifique as informações de um agente existente.

1

Localize o Agente

Na aba "Pesquisas", encontre o agente que deseja editar
2

Clique no Ícone de Editar

Procure pelo ícone de lápis (✏️) na coluna "Ações"
3

Modifique os Dados

Altere os campos que deseja atualizar
4

Salve as Alterações

Clique em "Salvar" para confirmar as mudanças

🗑️

Deletar Agente

Remova um agente do sistema. Esta ação é irreversível.

1

Localize o Agente

Na aba "Pesquisas", encontre o agente que deseja deletar
2

Clique no Ícone de Deletar

Procure pelo ícone de lixeira (🗑️) na coluna "Ações"
3

Confirme a Exclusão

Uma janela de confirmação aparecerá. Clique "Sim" para confirmar
4

Conclusão

O agente será removido do sistema permanentemente

⚠️ Atenção Importante

⚠️ A exclusão de um agente é permanente e não pode ser desfeita
⚠️ Antes de deletar, verifique se o agente não tem vendas ativas
⚠️ Agentes com comissões pendentes não devem ser deletados
⚠️ Agentes deletados não podem ser recuperados
⚠️ Apenas administradores podem deletar agentes
⚠️ Sempre faça backup antes de realizar operações em massa

💡 Quando Editar vs Deletar:

Editar: Use quando há informações incorretas ou que precisam ser atualizadas
Deletar: Use apenas quando o agente foi registrado por erro ou duplicado

❓ Perguntas Frequentes

Qual é a diferença entre Promotor e Agência? +

Promotor(a) é uma pessoa física que promove e vende pacotes individualmente. Agência é uma empresa de viagens que comercializa pacotes. A diferença afeta permissões e funcionalidades no sistema.

Como registrar comissões? +

No campo "Comissões", descreva o percentual ou valor fixo que o agente recebe. Exemplo: "10% sobre vendas" ou "5% fixo + 2% variável".

O CNPJ/CPF é obrigatório? +

Sim, o CNPJ ou CPF é obrigatório e deve ser único no sistema. Isso garante a identificação correta do agente.

Como gerenciar dados bancários? +

Na seção "Dados Bancários", registre as informações de contas para pagamento de comissões. Você pode adicionar múltiplas contas se necessário.

O que é Embratur? +

Embratur é a Empresa Brasileira de Turismo. O número de registro é obrigatório para agências de turismo que operam legalmente no Brasil.

Como registrar Grupo/Franquia? +

No campo "Grupo/Franquia", indique se o agente pertence a um grupo ou franquia. Exemplo: "Grupo Viagens Brasil" ou "Franquia CVC".

Posso ter múltiplos agentes com o mesmo CNPJ? +

Não é recomendado. Cada agente deve ter um CNPJ/CPF único para evitar confusões e erros no sistema.

Como registrar ocorrências? +

O campo "Ocorrências" é para registrar incidentes, atrasos em pagamento ou problemas com o agente. Isso ajuda a manter um histórico completo.