OndeVou Coletores — Sistema Completo de Coleta de Dados

⚡ Diferenciais Tecnológicos

Tecnologia de ponta para coleta de dados

Leitura Instantânea

Escaneie QR Codes e códigos de barras com a câmera do celular ou leitores dedicados.

Offline First

Colete dados mesmo sem internet. O sistema armazena localmente e sincroniza automaticamente.

Rastreabilidade

Histórico completo de todas as coletas realizadas, com data, hora, responsável e localização.

📊 Conceitos Fundamentais

🏷️ O que pode ser coletado?

O sistema é flexível e pode coletar diversos tipos de dados:

📦 Cilindros de gases (cheio/vazio)
📦 Produtos e estoque
🚚 Entregas e recebimentos
📍 Localizações e endereços
🔧 Equipamentos e ativos
📋 Formulários personalizados

🔄 Estados da Coleta

Toda coleta passa por estados bem definidos:

📝 Pendente (1): Coleta registrada, aguardando processamento

🔄 Processando (2): Sincronização em andamento

✅ Concluída (3): Coleta finalizada com sucesso

❌ Erro (4): Falha na coleta ou sincronização

🏗️ Arquitetura do Sistema

O coração do App Coletores: o motor de coleta universal

graph TD subgraph Arquitetura["Arquitetura do App Coletores"] A[Menu Rotina] -->|Acessa operação| B[Motor de Coleta] B --> C[Identifica tipo da operação] C --> D[Configura formulário] D --> D1[Tipo: Cilindro/Produto/Avulsa] D --> D2[Vínculo: Romaneio/Lote/Endereço] D --> D3[Validações específicas] D1 & D2 & D3 --> E[Apresenta tela de coleta] E --> F[Usuário coleta dados via QR Code] F --> G[Finalizar Coleta] G --> H[Validações automáticas] H --> I[Gravação no Banco de Dados] style B fill:#1e293b,stroke:#4CAF50 style I fill:#1e293b,stroke:#22c55e end

📌 IMPORTANTE - PREPARAÇÃO PARA ROTA: Antes de sair para a estrada, o usuário deve abrir o aplicativo com internet. Isso garante que todos os recursos, dados de clientes, produtos e formulários fiquem armazenados localmente no dispositivo, permitindo operação completa mesmo sem sinal.

🎯 COMO FUNCIONA: Cada operação de coleta (Entregar cilindro, Recolher produto, etc.) possui seu próprio formulário adaptado. O sistema carrega automaticamente as configurações corretas para cada tipo de coleta, incluindo validações específicas e campos obrigatórios.

📋 Operações de Coleta

O App Coletores suporta 19 tipos diferentes de operação

#	Operação	Descrição	Tipo
1	Avulsa	Coleta de dados genérica sem vínculo específico	📄 Avulsa
2	Carregar cilindro	Movimenta cilindro do estoque interno para a rota (caminhão)	🧪 Cilindro
3	Entregar cilindro	Entrega de cilindro cheio ao cliente, recolhendo o vazio	🧪 Cilindro
4	Recolher cilindro	Recolhe cilindro vazio do cliente de volta para a rota	🧪 Cilindro
5	Retornar cilindro	Retorna cilindro da rota para o estoque interno	🧪 Cilindro
6	Emprestar cilindro	Empréstimo de cilindro cheio para cliente sem vazio para troca	🧪 Cilindro
7	Devolver empréstimo cilindro	Devolução de cilindro emprestado	🧪 Cilindro
8	Lançar cilindro no inventário	Registra cilindro em inventário periódico	📝 Inventário
9	Vincular cilindro no lote produção	Associa cilindro a um lote de produção para rastreabilidade	🏭 Produção
10	XML notas fiscais	Coleta de dados a partir de XML de nota fiscal	📄 Fiscal
11	Vincular cilindro no endereço	Associa cilindro a um endereço específico	📍 Localização
12	Carregar produto	Movimenta produto do estoque para a rota	📦 Produto
13	Entregar produto	Entrega de produto ao cliente	📦 Produto
14	Recolher produto	Recolhe produto do cliente	📦 Produto
15	Retornar produto	Retorna produto da rota para o estoque	📦 Produto
16	Emprestar produto	Empréstimo de produto para cliente	📦 Produto
17	Devolver empréstimo produto	Devolução de produto emprestado	📦 Produto
18	Recolher cilindro do cliente para envase	Recolhe cilindro específico do cliente para reabastecimento	🧪 Cilindro
19	Entregar cilindro recolhido para envase	Entrega do cilindro reabastecido ao cliente	🧪 Cilindro

📄 Avulsa 🧪 Cilindro 📦 Produto 📝 Especial

🔄 Fluxo de Coleta de Dados

graph TD A[Iniciar Coleta] --> B{Qual dispositivo?} B -->|Celular| C[Abrir Câmera] B -->|Computador| D[Abrir Formulário] C --> E[Escanear QR Code] D --> F[Digitar código ou usar leitor USB] E --> G{Dados válidos?} F --> G G -->|Sim| H[Adicionar item à lista] G -->|Não| I[Exibir erro] I --> B H --> J{Tem internet?} J -->|Sim| K[Salvar no servidor] J -->|Não| L[Salvar no dispositivo] K --> M[Finalizar Coleta] L --> N[Coleta Pendente] N --> O[Quando voltar internet] O --> K

🟢 Sucesso 🟠 Pendente 🔴 Erro

📱 Coleta Mobile (App Nativo)

📷

Coleta com Câmera Nativa

No aplicativo Android, a coleta é feita de forma nativa, utilizando a câmera do dispositivo para escanear QR Codes de forma rápida e precisa.

✅ Vantagens

⚡ Leitura instantânea

🎯 Alta precisão

📴 Funciona offline

🔒 Segurança nativa

📋 Como funciona

1️⃣ Toque em "Coletar dados celular"

2️⃣ O app abre a câmera automaticamente

3️⃣ Aponte para o QR Code

4️⃣ Leitura automática e retorno à tela

📌 DICA PARA MOTORISTAS E ENTREGADORES: Antes de sair para a rota, abra o aplicativo com internet. O sistema baixa todos os dados necessários (clientes, produtos, roteiros) e os armazena no seu celular. Mesmo em áreas sem sinal, você consegue realizar todas as coletas normalmente.

🎯 Dica: A coleta mobile é mais rápida e didática para usuários em campo, como caminhoneiros e entregadores.

💻 Coleta Desktop

🖥️

Coleta via Formulário Web

No desktop, a coleta é feita através de formulário web, permitindo digitação manual ou uso de leitores de código de barras USB.

✅ Vantagens

🔧 Compatível com leitores USB

📝 Permite correção manual

🖱️ Interface amigável

📊 Ideal para escritório e estoque

📋 Como funciona

1️⃣ Abra o formulário de coleta

2️⃣ Digite ou escaneie o código

3️⃣ Preencha dados complementares

4️⃣ Salve a coleta

📴 Modo Offline

graph TD A[Coleta realizada sem internet] --> B[Dados salvos no dispositivo] B --> C[Gerado arquivo local de segurança] C --> D[Sistema marca como pendente] D --> E[Usuário continua trabalhando normalmente] E --> F[Quando detecta internet] F --> G[Envio automático ao servidor] G --> H[Arquivo local é removido] H --> I[Coleta confirmada no sistema]

📌 COMO FUNCIONA NA PRÁTICA:

✓ O usuário faz a coleta normalmente, como se tivesse internet
✓ O sistema salva todos os dados localmente no celular ou computador
✓ Uma mensagem indica que a coleta está pendente de sincronização
✓ Quando o dispositivo volta a ter internet, o envio é automático
✓ Após a confirmação, a coleta é removida do dispositivo

🔒 Garantia de dados: Mesmo sem internet, nenhuma coleta é perdida. O sistema armazena localmente até a sincronização.

📦 Estrutura do arquivo offline: Cada coleta offline gera um arquivo contendo cabeçalho (data, responsável, localização GPS, tipo de operação) e a lista de itens coletados. Tudo é criptografado e seguro.

☁️ Sincronização

🔄 Como funciona a sincronização

1️⃣ Coleta salva localmente no dispositivo (sempre)

2️⃣ Sistema verifica conexão com internet

3️⃣ Envia dados para o servidor de forma segura

4️⃣ Remove do dispositivo após confirmação

5️⃣ Atualiza status da coleta para "concluída"

🎯 Importante: A sincronização é automática e transparente para o usuário. Ele não precisa fazer nada além de coletar os dados.

📱 Estrutura do App Coletores

O App Coletores organiza o sistema em 5 seções principais

📷 1. Coletar Dados

Cards para acesso rápido às rotinas de coleta:

📱 Coletar dados celular
💻 Coletar dados desktop
📷 Câmera / Leitor QR Code

As rotinas são ordenadas por prioridade definida pelo administrador

📋 2. Minhas Coletas Offline

Exibe coletas armazenadas localmente no dispositivo:

📄 Tabela com dados offline pendentes
🔄 Botão para sincronizar manualmente
📊 Indicador de quantidade de coletas

💾 3. Minhas Coletas Pendentes

Coletas salvas no banco de dados aguardando finalização:

📋 Lista de coletas com situação pendente
🔍 Filtro por participante e usuário
✏️ Opção de continuar ou finalizar coleta

📄 4. Listas de Coletas

Acesso a páginas completas com filtros e histórico:

📊 Coletas realizadas (histórico completo)
📴 Coletas offline (gestão local)

⚙️ 5. Configurações

Rotinas de manutenção e ajustes:

✏️ Alterar coleta de dados
🏷️ Alterar situação da coleta
✅ Finalizar coleta

📊 Fluxo de Navegação do App

graph LR A[Abertura do App] --> B[Carrega estrutura] B --> C[Seção 1: Coletar Dados] B --> D[Seção 2: Offline] B --> E[Seção 3: Pendentes] B --> F[Seção 4: Listas] B --> G[Seção 5: Configurações] D --> H[Carrega coletas do dispositivo] E --> I[Busca coletas no servidor]

QR Code - Todos os Formatos Suportados

+50 Tipos de QR Code Suportados

A plataforma OndeVou reconhece dezenas de formatos diferentes de QR Code, permitindo coleta de dados para os mais diversos tipos de entidades

50+

Tipos de QR Code

6

Categorias

19

Operações de Coleta

📍 Categoria 1: Localização Geográfica

🌍ondevou_pais_{id} - Países

🗺️ondevou_regiao_{id} - Regiões

📍ondevou_uf_{id} - Estados (UF)

📊ondevou_mesorregiao_{id} - Mesorregiões

📈ondevou_microrregiao_{id} - Microrregiões

🏙️ondevou_cidade_{id} - Cidades

🏘️ondevou_bairro_{id} - Bairros

🛣️ondevou_rua_{id} - Ruas/Logradouros

📮ondevou_cep_{id} - CEP

🧪 Categoria 2: Cilindros e Etiquetas

📦ondevou_cl_{participante}_{id} - Cilindros

🏷️ondevou_ea_{participante}_{id} - Etiqueta Avulsa

🔘ondevou_tcl_{participante}_{id} - Tipo de Cilindro

🏭ondevou_lp_{participante}_{id} - Lote Produção

📝ondevou_in_{participante}_{id} - Inventário

🚚 Categoria 3: Romaneios e Transporte

📋ondevou_rv_{participante}_{id} - Romaneio de Vendas

🚛ondevou_rvcar_{participante}_{id} - Romaneio Carregamento

🚚ondevou_rvent_{participante}_{id} - Romaneio Entrega

📥ondevou_rvrec_{participante}_{id} - Romaneio Recolhimento

↩️ondevou_rvret_{participante}_{id} - Romaneio Retorno

🤝ondevou_rvemp_{participante}_{id} - Romaneio Empréstimo

🔄ondevou_rvdev_{participante}_{id} - Romaneio Devolução

🗺️ondevou_rota_{id} - Rotas

📦 Categoria 4: Produtos e Comércio

🏷️ondevou_pr_{participante}_{id} - Produtos

📊ondevou_pro_{participante}_{id} - Produto (alias)

🏪ondevou_loja_{id} - Lojas

🛒ondevou_lj_ped_{id} - Pedido de Loja

📦ondevou_cx_{id} - Caixas

🏷️ondevou_bf_{id} - Banner/Anúncio

🚗 Categoria 5: Veículos e Frotas

🚛ondevou_ve_{id} - Veículos

🚚ondevou_vei_{id} - Veículo (detalhado)

🚛ondevou_veiaba_{id} - Abastecimento

🔧ondevou_veilic_{id} - Licenciamento

✅ondevou_veiche_{id} - Check-list

🔧ondevou_veiman_{id} - Manutenção

💰ondevou_veimulta_{id} - Multas

📄ondevou_veiipva_{id} - IPVA

🛣️ondevou_veitac_{id} - Tacógrafo

📊ondevou_veitacope_{id} - Operação Tacógrafo

🔄ondevou_veicherea_{id} - Check-list Reabastecimento

🏍️ondevou_mot_{id} - Motocicletas

👥 Categoria 6: Participantes e Usuários

🏢ondevou_pa_{id} / ondevou_participante_{id} - Participantes

👤ondevou_membro_{id} - Membros

📧ondevou_cont_{id} - Contatos

🔑ondevou_ven_{id} - Vendedores

💼ondevou_com_{id} - Comissões

📄 Categoria 7: Documentos e Requisições

📋ondevou_req_{id} - Requisições

⚙️ondevou_reqati_{id} - Requisições de Ativos

🔧ondevou_fo_{id} - Ordem de Serviço

🔧 Categoria 8: Outros Formatos

🎨ondevou_tema_{id} - Temas

🗺️ondevou_explorar_{id} - Pontos de Interesse

📝ondevou_post_{id} - Posts/Blog

📌 Exemplos práticos de QR Codes:

ondevou_cl_662691_12345

ondevou_pr_662691_98765

ondevou_rv_662691_55555

ondevou_vei_123456

ondevou_cidade_3550308

ondevou_lp_662691_99999

🎯 Como funciona: O formato segue o padrão ondevou_{tipo}_{identificador}. O sistema interpreta automaticamente o tipo e busca os dados correspondentes no banco. A lista completa inclui mais de 50 tipos diferentes de QR Code, cobrindo desde localizações geográficas até veículos, produtos e documentos.

✅ Validações na Finalização

Ao finalizar uma coleta, o sistema executa diversas validações para garantir a integridade dos dados:

🔍 Validações de Cilindros

⚠️ Duplicidade - mesmo cilindro não pode ser coletado duas vezes

📅 Validade vencida - bloqueia a operação

📍 Situação inválida para a operação (ex: entregar cilindro já vazio)

🏢 Localização inválida para a operação

📋 Validações de Estoque

📦 Cilindro deve estar no estoque para entrega

🔄 Para devolução, cilindro deve ter sido entregue primeiro

📊 Controle de saldo no romaneio

🔗 Vínculo deve estar em situação válida

📌 O que acontece se falhar? O sistema exibe uma mensagem clara informando o problema, e a coleta não é finalizada até que seja corrigido.

🏆 Propriedade Intelectual

Marca Registrada

OndeVou.com®

Propriedade Intelectual Assegurada

Processo INPI:
908765967

Titular:
ONDEVOU TECNOLOGIA LTDA

CNPJ:
17.058.605/0001-36

Classificação:
Classe 42 - Serviços de TI

🏆

10+

anos de proteção

📦 OndeVou Coletores

⚡ Diferenciais Tecnológicos

Leitura Instantânea

Offline First

Rastreabilidade

📊 Conceitos Fundamentais

🏷️ O que pode ser coletado?

🔄 Estados da Coleta

🏗️ Arquitetura do Sistema

📋 Operações de Coleta

🔄 Fluxo de Coleta de Dados

📱 Coleta Mobile (App Nativo)

Coleta com Câmera Nativa

✅ Vantagens

📋 Como funciona

💻 Coleta Desktop

Coleta via Formulário Web

✅ Vantagens

📋 Como funciona

📴 Modo Offline

☁️ Sincronização

🔄 Como funciona a sincronização

📱 Estrutura do App Coletores

📷 1. Coletar Dados

📋 2. Minhas Coletas Offline

💾 3. Minhas Coletas Pendentes

📄 4. Listas de Coletas

⚙️ 5. Configurações

📊 Fluxo de Navegação do App

qr_code_scanner QR Code - Todos os Formatos Suportados

+50 Tipos de QR Code Suportados

📍 Categoria 1: Localização Geográfica

🧪 Categoria 2: Cilindros e Etiquetas

🚚 Categoria 3: Romaneios e Transporte

📦 Categoria 4: Produtos e Comércio

🚗 Categoria 5: Veículos e Frotas

👥 Categoria 6: Participantes e Usuários

📄 Categoria 7: Documentos e Requisições

🔧 Categoria 8: Outros Formatos

✅ Validações na Finalização

🔍 Validações de Cilindros

📋 Validações de Estoque

🏆 Propriedade Intelectual

OndeVou.com®

QR Code - Todos os Formatos Suportados