👥 OndeVou Participantes
Sistema completo para cadastro e gestão de participantes (empresas e pessoas físicas). Cadastro único com dados públicos e privados, suporte a importação via XML, busca por CNPJ/CPF, e geolocalização automática.
⚡ Diferenciais Tecnológicos
Tecnologia de ponta para cadastro de participantes
Importação por XML
Cadastre participantes a partir de arquivos XML, aproveitando dados já existentes.
Busca Inteligente
Localize participantes por ID, CNPJ, CPF, CEP, Razão Social ou endereço parcial.
Dados Públicos + Privados
Estrutura que separa dados universais de personalizações por participante de trabalho.
📊 Conceitos Fundamentais
🏢 O que é um Participante?
Um participante é uma empresa ou pessoa física que utiliza os serviços da plataforma OndeVou.com para gerenciar seu próprio negócio.
Também pode ser um participante cujo cadastro foi efetuado por outro participante devido a relações comerciais ou outros motivos, com base em informações públicas e acessíveis.
⚙️ O que é um Participante de Trabalho?
Um participante de trabalho é um participante da plataforma OndeVou.com que utiliza produtos e serviços oferecidos pela plataforma, como:
🔄 Fluxo de Cadastro do Participante
📝 Cadastro de Participantes
Estrutura do Cadastro
📌 IMPORTANTE: O cadastro é dividido em Dados Públicos (tabela `participantes`) e Dados Privados (tabela `participantes_privado`), permitindo que um mesmo participante seja compartilhado entre múltiplos participantes de trabalho com personalizações exclusivas.
🌐 Dados Públicos
- ID: Identificador único (gerado automaticamente)
- Razão Social: Denominação oficial da empresa
- Nome Fantasia: Nome comercial
- CNPJ: Cadastro Nacional da Pessoa Jurídica
- Tema: Segmento de atuação
- Endereço completo: CEP, Rua, Número, Bairro, Cidade, UF
- Inscrições: Estadual, Municipal, Suframa
- CNAE: Código de atividade econômica
- Site e E-mails: Contato geral e NFe
- Latitude/Longitude: Coordenadas geográficas
🔒 Dados Privados
- Id ERP: Identificador no sistema ERP
- Código Cliente/Fornecedor ERP: Integração com ERPLINUX
- CPF: Para pessoas físicas
- Telefone/Whatsapp: Contato direto
- Rota: Rota do vendedor
- Vendedor/Comprador: Responsáveis
- Regime Tributário: Simples Nacional, Lucro Presumido, etc.
- Tipo de Cliente/Operação: Classificações específicas
📋 Lógica de Cadastro
🔍 Busca Inteligente
⭐ Por que buscar antes de cadastrar?
⚠️ REGRA DE OURO: Antes de cadastrar, SEMPRE busque primeiro!
Isso evita criar registros duplicados na base de dados, o que causa:
- 📊 Relatórios inconsistentes
- 💰 Notas fiscais emitidas para o CNPJ errado
- 🗺️ Rotas de entrega duplicadas
- ⏱️ Retrabalho para mesclar registros
📋 Tipos de Busca
🔍 Opções de Busca Disponíveis
- 🔢 Por ID: Busca direta pelo identificador único
- 🏢 Por CNPJ: Busca na base da Receita Federal
- 👤 Por CPF: Busca para pessoas físicas
- 📮 Por CEP: Localiza participantes por endereço
- 📝 Por Razão Social/Nome: Busca parcial ou completa
- 📍 Por Endereço: Busca por rua, bairro ou cidade
- 🔌 Código ERP: Integração com ERPLINUX
📄 Importação por XML
O sistema permite importar dados de participantes diretamente de arquivos XML, como:
- 📑 Notas Fiscais Eletrônicas (NF-e)
- 📄 XML de cadastro de fornecedores
- 📁 Arquivos de integração com sistemas ERP
🎯 Dica: A importação por XML preenche automaticamente os dados públicos, agilizando o cadastro.
💡 Como usar: Digite o valor e clique na lupa (🔍). O sistema vai buscar na plataforma e trazer os resultados!
🎯 Entendendo os resultados da busca
Após digitar o CNPJ/CPF e clicar na lupa 🔍, o sistema pode retornar 3 cenários diferentes. Entenda cada um:
Nenhum resultado
O CNPJ/CPF não existe na base OndeVou.
- 📝 Formulário fica vazio para preenchimento
- ✏️ Usuário preenche todos os dados manualmente
- 💾 Após salvar → cadastro é criado na plataforma
- 🌍 Fica disponível para futuros cadastros de outros participantes fixos
Link AZUL
Participante existe na base OndeVou, mas não pertence ao seu CNPJ.
- 📋 Dados públicos são carregados no formulário
- ⚠️ Exibe aviso: "Registro não pertence ao seu CNPJ"
- ✏️ Usuário pode alterar os dados à vontade
- 💾 Salva → cria NOVO vínculo privado
- 🔒 Não altera o cadastro original da outra empresa
Link VERDE
Participante já é seu (vínculo já existe).
- 📋 Dados carregam automaticamente
- ✏️ Usuário pode editar se necessário
- 💾 Salva → atualiza seu vínculo privado
- ✅ Fluxo direto, sem avisos
📌 Importante: Mesmo obtendo dados cadastrados por outra empresa (dados públicos), o usuário atual pode alterar à vontade pois as alterações NÃO serão gravadas sobre os dados da coleta original. Será criado um novo vínculo privado para o participante fixo atual.
📊 Fluxo Completo da Busca
Este diagrama mostra o fluxo completo desde a busca até o salvamento, incluindo os 3 cenários possíveis.
flowchart TD
A["🔍 Usuário digita CNPJ/CPF na BUSCA"] --> B["Clica na lupa 🔍"]
B --> C{"Sistema busca na base OndeVou"}
C -->|"❌ NÃO ENCONTROU"| D["🔴 Nenhum resultado"]
D --> E["📝 Formulário vazio"]
E --> F["Preencher todos os dados manualmente"]
F --> G["Validar campos obrigatórios"]
G --> H["💾 Salvar"]
H --> I["✅ Cadastro criado na plataforma"]
I --> J["🌍 Disponível para outros participantes"]
C -->|"✅ ENCONTROU"| K["Exibe lista de resultados"]
K --> L{"Qual o status do vínculo?"}
L -->|"🔵 LINK AZUL"| M["Participante existe na base OndeVou"]
M --> N["❌ NÃO pertence ao seu CNPJ atual"]
N --> O["📋 Dados públicos são carregados"]
O --> P["⚠️ Exibe aviso: 'Registro não pertence ao seu CNPJ'"]
P --> Q["✏️ Usuário pode alterar os dados"]
Q --> R["💾 Salvar"]
R --> S["✅ Cria NOVO vínculo privado"]
S --> T["🔒 Não altera o cadastro original"]
L -->|"🟢 LINK VERDE"| U["Participante já é seu"]
U --> V["📋 Dados carregam automaticamente"]
V --> W["✏️ Usuário pode editar se necessário"]
W --> X["💾 Salvar"]
X --> Y["✅ Atualiza seu vínculo privado"]
⚠️ Caso Especial: Permitir duplicar registro
Existe uma situação específica onde mesmo o CNPJ já existindo na base, pode ser necessário criar um novo cadastro.
🏢 Quando usar?
Cenário comum: Uma mesma empresa (mesmo CNPJ) possui múltiplos pontos de entrega ou filiais que:
- 📍 Possuem endereços diferentes
- 💰 Faturamento é centralizado na matriz
- 🗺️ Precisam ser mapeadas separadamente para rotas de entrega
- 📦 Cada ponto tem seu próprio estoque ou atendimento
⚠️ Atenção: Use com cuidado
- O sistema NORMALMENTE bloqueia duplicidade de CNPJ
- Marque esta opção APENAS para pontos de entrega/filiais
- Nunca use para empresas diferentes com mesmo CNPJ (erro!)
- O aviso de duplicidade será ignorado com esta opção marcada
Exemplo Real
Supermercados "Bom Preço" (CNPJ: 12.345.678/0001-90)
- 🏢 Matriz (cobra centralizado) - endereço A
- 📍 Filial 1 (ponto de entrega) - endereço B
- 📍 Filial 2 (ponto de entrega) - endereço C
Resultado: 3 cadastros com o mesmo CNPJ, mas cada um com seu endereço. A rota de entrega consegue planejar as visitas corretamente! 🗺️
💡 Dica do especialista:
Use este recurso com parcimônia. Para 99% dos casos, a regra padrão de "não duplicar CNPJ" é a correta. Só marque "Permitir duplicar registro" quando realmente precisar de múltiplos pontos para o mesmo CNPJ.
🌐 Dados Públicos
📋 Identificação
- Obrigatório Razão Social: Nome legal da empresa
- Opcional Nome Fantasia: Nome comercial
- Obrigatório CNPJ: Cadastro Nacional (validado)
- Opcional Tema: Segmento de atuação
📍 Endereço
- Obrigatório CEP: Busca automática de endereço
- Automático Rua/Bairro/Cidade/UF: Preenchidos pelo CEP
- Obrigatório Número: Se não informado, usar 0
- Opcional Complemento: Informações adicionais
📄 Documentos Fiscais
- Opcional Inscrição Estadual: IE da empresa
- Opcional Inscrição Municipal: IM da empresa
- Opcional Inscrição Suframa: Zona Franca de Manaus
- Opcional CNAE: Atividade econômica
📧 Contato
- Opcional Site: URL da empresa
- Opcional E-mail: Contato geral
- Opcional E-mail NFe: Para notas fiscais
📌 Importante: Dados públicos são compartilhados entre todos os participantes de trabalho que utilizam o mesmo participante.
🔒 Dados Privados
🔗 Integração ERP
- Id ERP: Identificador no sistema (automático)
- Código Cliente ERP: Integração com ERPLINUX
- Código Fornecedor ERP: Integração com ERPLINUX
👤 Dados Pessoais
- CPF: Para pessoas físicas
- Obrigatório Telefone: Contato direto
- Opcional Whatsapp: Contato adicional
📊 Classificações Comerciais
- Rota: Rota do vendedor para entregas
- Tipo Cliente: Novo, recorrente, etc.
- Vendedor: Responsável comercial
- Comprador: Responsável por compras
🏛️ Regime Tributário
- Regime Tributário: Simples Nacional, Lucro Presumido, Lucro Real
- Tipo de Consumidor: Classificação do consumidor
- Tipo de Operação: Natureza da operação
- Indicador IE Destinatário: Para fins fiscais
🔒 Privacidade: Dados privados são visíveis apenas para o participante de trabalho que os cadastrou.
📍 Geolocalização
Captura de Coordenadas
- Latitude: Coordenada geográfica (automática)
- Longitude: Coordenada geográfica (automática)
- Atualização Lat/Lng: Data/hora da última atualização
🎯 Como funciona:
- Preencha o endereço completo do participante
- Clique no ícone 📍 no rodapé do formulário
- O sistema calcula automaticamente latitude e longitude
- Coordenadas são salvas para uso em mapas e rotas
📌 Importante: Coordenadas precisas facilitam a localização do participante por entregadores, otimizando a logística e melhorando o atendimento.
qr_code_scanner QR Code - Identificação do Participante
QR Code do Participante
Todo participante cadastrado recebe um QR Code único que o identifica em todo o sistema.
📱 Aplicações do QR Code
- 🔍 Consulta rápida do participante no app
- 📦 Vinculação em carregamentos e entregas
- 🚚 Rastreabilidade de operações
- 📝 Registro de todas as movimentações
Formato padrão: ondevou_{tipo}_{participante}_{id}
🎯 Dica: O QR Code é responsável por registrar todas as operações do participante com rastreabilidade completa.
📝 Campos Obrigatórios
Para um cadastro completo e que permita busca por proximidade, estes campos são essenciais:
📋 Identificação
- Razão Social - Nome oficial da empresa
- CNPJ ou CPF - Documento principal
📍 Endereço
- CEP - Código postal (8 dígitos)
- Número - Se não tiver, use 0 ou S/N
🏷️ Segmento
- Tema - Segmento do negócio
📍 Geolocalização (⭐ importante)
- Latitude/Longitude - Clique no mapa 🗺️
- Por que? Permite busca por proximidade
📍 Busca por Proximidade
Diferencial da plataforma OndeVou: Com as coordenadas salvas, você pode encontrar participantes próximos à sua localização atual.
📱 Como funciona?
- Clique no ícone 📍 (map-marker) ao lado do campo de busca
- Permita que o navegador acesse sua localização
- O sistema retorna participantes cadastrados próximos a você
- Clique no resultado → dados carregam automaticamente
⚠️ ATENÇÃO: A busca por proximidade SÓ funciona se os participantes tiverem suas coordenadas salvas. Sempre clique no mapa 🗺️ ao cadastrar!
💡 Dicas Rápidas - Cadastro
📌 Preenchimento
- Preencha o CEP primeiro → endereço automático
- Clique no 🗺️ (mapa) para marcar localização
- Após preencher, clique em Salvar
🔄 Novo ou alteração?
- 🔵 ID vazio = NOVO CADASTRO
- 🟢 ID preenchido = ALTERANDO
⚡ Resumo do fluxo: 1️⃣ Busque 🔍 → 2️⃣ Entenda o resultado (❌/🔵/🟢) → 3️⃣ Preencha/Confirme 📝 → 4️⃣ Marque o mapa 🗺️ → 5️⃣ Salve 💾
📋 Geração de Listas e Relatórios
Acesse o menu Participantes para visualizar todos os participantes com os quais você tem vínculo.
🔍 Filtros de busca disponíveis
📋 Filtros rápidos
- ✅ Apenas meus vínculos - Mostra apenas participantes vinculados a você
- ✅ Apenas com CNPJ - Filtra apenas empresas
- ✅ Apenas com CPF - Filtra apenas pessoas físicas
- ✅ Apenas com movimentações - Participantes que já tiveram transações
- ✅ Apenas sem endereços confirmados - Encontra registros incompletos
💰 Filtros por vendas
- ✅ Emissão própria - Notas fiscais emitidas por você
- ✅ Emissão de terceiros - Notas de outras empresas
- ✅ Notas de saída - Vendas realizadas
- ✅ Notas de entrada - Compras recebidas
📊 O que você pode fazer com os resultados
Os dados podem ser filtrados, ordenados e exportados conforme sua necessidade.
📋 Colunas da tabela
Informações básicas
- Id - Código único
- Razão Social - Nome oficial
- Nome fantasia - Nome comercial
- CNPJ/CPF - Documento principal
- Tema - Segmento do negócio
Endereço e contato
- CEP, Rua, Número - Endereço completo
- Bairro, Cidade, UF - Localização
- Telefone, Whatsapp, E-mail - Contatos
- Latitude/Longitude - Coordenadas
📌 Clique nas colunas para ordenar os resultados.
🔒 Colunas com fundo escuro são privadas (visíveis apenas para usuários autorizados).
⚙️ Ações disponíveis
Cada participante na lista possui ícones para ações rápidas:
info_outline Informações
Exibe detalhes completos do registro, incluindo dados públicos e privados (se tiver permissão).
cloud_sync Sincronização
Salva os dados no servidor e garante que as alterações sejam mantidas.
edit Editar
Abre o formulário para edição completa dos dados do participante.
qr_code_2 QR Code
Gera um QR Code com as informações do participante para compartilhamento.
launch Launch
Abre a página pública do participante em nova janela.
map Mapa
Visualiza a localização do participante no mapa.
delete_forever Excluir
Remove o vínculo do participante (não exclui o cadastro público da plataforma).
search Buscar
Aplica os filtros e atualiza a lista de resultados.
📋 Navegação e paginação
Use os botões de navegação para percorrer grandes volumes de dados. O sistema exibe a quantidade de registros carregados e o total disponível.
🔐 Perfis de acesso
A plataforma possui diferentes níveis de acesso que controlam quais ações cada usuário pode executar.
👑 Administrador
- ✅ Acesso TOTAL ao sistema
- ✅ Incluir, alterar e excluir registros
- ✅ Gerenciar permissões de usuários
- ✅ Visualizar dados privados
👤 Usuário
- ✅ Incluir e alterar seus registros
- ✅ Consultar seus vínculos
- ❌ Excluir registros
- ❌ Ver dados privados de outros
👀 Visualizador
- ✅ Consultar e visualizar listas
- ❌ Não pode editar
- ❌ Não pode incluir ou excluir
- ❌ Acesso apenas a dados públicos
📌 Importante: O perfil de acesso é definido ao vincular um membro a um participante. Cada participante pode ter múltiplos membros com diferentes níveis de acesso.
🗂️ Estrutura de dados
Tabelas auxiliares que apoiam o cadastro e gestão do participante.
🏛️ Regime tributário
Define como a empresa é tributada:
- 1 - Simples Nacional
- 2 - Simples Nacional (excesso)
- 3 - Regime Normal
📊 Forma de apuração
Define a forma de apuração fiscal:
- 1 - Lucro Real
- 2 - Lucro Presumido
- 3 - Lucro Arbitrado
🔌 Integração ERP
Configurações de integração com ERP Linux
👥 Perfis de acesso
Administrador, Usuário e Visualizador
🔗 Vínculos e permissões
Como os membros se vinculam aos participantes.
👥 membros_participantes
Vincula membros a participantes com perfis de acesso específicos.
📌 A view view_membros_participantes consolida todos os dados de vínculo.
📋 membros_participantes_rotinas
Controla quais rotinas cada membro tem acesso dentro da plataforma.
🏆 Propriedade Intelectual
Marca Registrada
OndeVou.com®
Propriedade Intelectual Assegurada
908765967
ONDEVOU TECNOLOGIA LTDA
17.058.605/0001-36
Classe 42 - Serviços de TI