🚚 OndeVou Romaneios
Sistema completo para gestão de transporte e logística. Consolida operações de cilindros e produtos em um único documento de viagem, com controle de rotas, motoristas, veículos e rastreabilidade completa.
🎯 Sobre o Módulo Romaneios
O módulo Romaneios da plataforma OndeVou é uma solução completa para gestão de transporte e logística. Consolida operações de cilindros e produtos em um único documento de viagem, com controle de rotas, motoristas, veículos e rastreabilidade completa.
Documento de Transporte
Unifica entregas, recolhimentos, empréstimos e devoluções em um único documento de viagem.
Controle de Frota
Gerencie veículos, motoristas, rotas e quilometragem com indicadores em tempo real.
Rastreabilidade
QR Code único por romaneio e por operação, garantindo rastreabilidade completa.
⚡ Diferenciais Tecnológicos
Tecnologia de ponta para gestão de transporte
Consolidação Total
Romaneio unifica operações de cilindros e produtos em um único documento de viagem.
Indicadores em Tempo Real
Gráficos e métricas por data, rota, motorista, veículo e membro.
Geolocalização
Registro de latitude/longitude inicial e final, com mapa da viagem integrado.
🔄 Fluxo de Status do Romaneio
Cada romaneio passa por uma sequência de status que controla as operações permitidas
Status: Carregamento] -->|Carregar itens| B[Carregamento Concluído] B -->|Iniciar Viagem| C[Status: Em Rota
Permite entregas, recolhimentos, empréstimos, devoluções] C -->|Finalizar Rota| D[Status: Retorno
Aguardando conferência] D -->|Enviar para análise| E[Status: Em Análise
Setor de logística] E -->|Aprovar| F[Status: Faturamento
Setor financeiro] F -->|Concluir| G[Status: Fechado
Romaneio finalizado
⚠️ BLOQUEADO] A -.->|Cancelar
APENAS antes de iniciar| H[Status: Cancelado
⚠️ BLOQUEADO] style A fill:#1e293b,stroke:#f59e0b style C fill:#1e293b,stroke:#10b981 style G fill:#1e293b,stroke:#ef4444,stroke-dasharray: 5 5 style H fill:#1e293b,stroke:#ef4444,stroke-dasharray: 5 5
🔒 Permissões por Status
| Status | Carregar | Entregar | Recolher | Retornar | Emprestar | Devolver | Alterar | Excluir |
|---|---|---|---|---|---|---|---|---|
| 🟡 Carregamento | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
| 🟢 Em Rota | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ |
| 🔵 Retorno | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
| 🔴 Em Análise | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 🟠 Faturamento | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| ✅ Fechado | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| ❌ Cancelado | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
⚠️ REGRA DE OURO - ROMANEIO FECHADO/CANCELADO:
- Após o status Fechado ou Cancelado, o romaneio fica TOTALMENTE BLOQUEADO para qualquer alteração
- Não é possível adicionar, alterar ou excluir carregamentos, entregas, recolhimentos, retornos, empréstimos ou devoluções
- Não é possível alterar o status novamente
- O cancelamento SÓ É PERMITIDO enquanto o romaneio estiver no status Carregamento (antes do início da viagem)
- Esta regra garante a integridade fiscal e operacional do documento
✅ BONS EXEMPLOS DE USO:
- Em Rota: Permite registrar entregas, recolhimentos, empréstimos e devoluções
- Retorno: Permite apenas retornar itens ao estoque (conferência do que voltou)
- Carregamento: Permite apenas carregar itens e alterar/excluir carregamentos
📌 IMPORTANTE: As operações de carregamento só podem ser feitas no status Carregamento. As operações de entrega, recolhimento, empréstimo e devolução só podem ser feitas no status Em Rota.
📝 Formulário do Romaneio
Campos e funcionalidades da capa do romaneio
📋 Identificação
- Auto ID: Gerado automaticamente
- Obrigatório Descrição do Romaneio: Texto livre para identificar a viagem
- Opcional Observação: Informações adicionais
- Opcional Romaneio ERPLINUX: Código de integração com sistemas externos
⚙️ Regras de Carregamento
- Checkbox Permitir cilindros vazios no carregamento: Sim/Não
- Checkbox Permitir cilindros vencidos no carregamento: Sim/Não
👥 Equipe e Veículo
- Obrigatório Rota: Busca em tabela auxiliar
- Opcional Vendedor: Busca em tabela auxiliar
- Obrigatório Motorista: Busca em tabela auxiliar
- Obrigatório Veículo: Busca em tabela auxiliar
📅 Status e Datas
- Obrigatório Situação: Carregamento, Em rota, Retorno, Em análise, Faturamento, Fechado, Cancelado
- Opcional Início da viagem: Data e hora
- Opcional Fim da viagem: Data e hora
- Opcional Data do acerto: Data e hora
📊 Quilometragem
- Opcional KM inicial: Quilometragem do hodômetro no início
- Opcional KM final: Quilometragem do hodômetro no final
- Automático KM rodado: Calculado pelo sistema (KM final - KM inicial)
📍 Geolocalização
- Opcional Latitude/Longitude inicial: Coordenadas de partida
- Opcional Latitude/Longitude final: Coordenadas de chegada
- Botão 📍 Pegar coordenadas: Usa mapa interativo
🎯 DICA: O formulário permite buscar outro romaneio como modelo para agilizar a criação, copiando todas as informações de rota, motorista, veículo e regras.
📝 Como Cadastrar um Romaneio
O formulário de cadastro/edição de romaneios é acessado pelo menu Romaneios e permite gerenciar todas as informações da viagem.
📋 Campos do Formulário
📌 Identificação
- Auto Id: Gerado automaticamente
- Obrigatório Descrição do romaneio: Identificação da viagem
- Opcional Observação: Informações adicionais
- Opcional Romaneio erplinux: Código de integração
⚙️ Regras de Carregamento
- Checkbox Permitir cilindros vazios: Sim/Não
- Checkbox Permitir cilindros vencidos: Sim/Não
👥 Equipe e Veículo
- Obrigatório Rota: Busca em tabela auxiliar
- Opcional Vendedor: Responsável comercial
- Obrigatório Motorista: Busca em tabela auxiliar
- Obrigatório Veículo: Busca em tabela auxiliar
📅 Status e Datas
- Obrigatório Situação: Carregamento, Em rota, Retorno, Em análise, Faturamento, Fechado, Cancelado
- Opcional Início da viagem: Data/hora
- Opcional Fim da viagem: Data/hora
- Opcional Data do acerto: Data/hora
📊 Quilometragem
- Opcional KM inicial: Hodômetro início
- Opcional KM final: Hodômetro final
- Automático KM rodado: Calculado pelo sistema
📍 Geolocalização
- Opcional Latitude/Longitude inicial: Partida
- Opcional Latitude/Longitude final: Chegada
- Botão 📍 Pegar coordenadas: Usa mapa interativo
🎯 Dica: Use o botão Copiar para duplicar um romaneio existente como modelo, agilizando novos cadastros.
📍 Sub-tabela: Destinos da Viagem
Registre as paradas e clientes visitados durante a rota:
- Obrigatório Unidade: Cliente/endereço (busca em contratos)
- Obrigatório Motivo: Entrega, Recolhimento, Visita, etc.
- Opcional Lat/Lng destino: Coordenadas do local
- Automático Distância (km): Calculada entre pontos
💡 Funcionalidades: Adicionar múltiplos destinos, copiar linha, distância calculada automaticamente entre destinos consecutivos.
🔍 Busca e Listas de Romaneios
A tela de listagem de romaneios permite buscar, filtrar e visualizar todos os documentos de transporte.
📋 Filtros de busca disponíveis
🔢 Filtros por campo
- Id: Busca pelo código único
- Romaneio: Busca pela descrição
- Situação: Filtra por status (Carregamento, Em rota, Retorno, etc.)
- Rota: Filtra por rota cadastrada
- Vendedor: Filtra por responsável comercial
- Romaneio erplinux: Busca por código de integração
- Motorista: Filtra por motorista
- Veículo: Filtra por veículo
- Membro: Filtra por usuário criador
- Data Inicial/Final: Intervalo de datas
📊 Opções de visualização
- ✅ Não limitar registros: Exibe todos os resultados
- 📋 Tabela: Visualização em lista
- 📄 Página: Visualização detalhada
- 📊 Resumo: Estatísticas consolidadas
- 📈 Gráficos: Análise visual por data, rota, veículo, motorista, membro
- 🖨️ Impressão / PDF / Excel: Exportação de dados
- 📊 Dashboard: Visão executiva
💡 Dica: Use o botão Buscar após preencher os filtros. Use Limpar para resetar todos os filtros.
📊 Colunas da Tabela de Romaneios
Informações principais
- Id: Código único
- QR Code: Identificador gráfico
- Data hora inclusão: Data de criação
- Descrição: Nome do romaneio
- Observação: Notas adicionais
- Situação: Status atual
- Rota: Rota da viagem
- Vendedor / Motorista / Veículo: Equipe responsável
Contadores de operações
- Carregamentos / Entregas / Recolhimentos / Retornos: Totais consolidados
- Empréstimos / Devoluções: Controle de itens temporários
- Versões para cilindros e produtos: Totais separados por tipo
- KM inicial/final/rodado: Quilometragem da viagem
- Início/Fim viagem: Datas da operação
📍 Destinos da Viagem
Sub-tabela que registra as paradas e clientes visitados durante a rota
📋 Campos da Sub-tabela Destinos
- Obrigatório Unidade: Cliente/endereço (busca em contratos)
- Obrigatório Motivo: Entrega, Recolhimento, Visita, etc.
- Opcional Latitude/Longitude destino: Coordenadas do local
- Automático Distância (km): Calculada entre pontos
Unidade A] A --> C[Destino 2
Unidade B] A --> D[Destino 3
Unidade C] B --> E[Distância: 0km] C --> F[Distância: 15km] D --> G[Distância: 30km]
📋 Funcionalidades
📋 Operações Consolidadas
O romaneio unifica operações de cilindros e produtos em uma única interface
Carregamentos
Lista todos os itens carregados no romaneio, podendo ser:
- 🧪 Cilindros: Cheios ou vazios (conforme regra do romaneio)
- 📦 Produtos: Itens de estoque
- 📄 Documentos: Notas fiscais, certificados
🔗 Acesso: Cada romaneio tem um link direto para a lista de carregamentos, com filtro automático pelo ID do romaneio.
Entregas
Registra todas as entregas realizadas durante a viagem:
- 🧪 Entregas de cilindros: Cheio para o cliente, recolhe vazio
- 📦 Entregas de produtos: Produtos entregues ao cliente
📌 Dica: As entregas podem ser feitas em lote ou individualmente, com registro de data, hora e localização.
Recolhimentos
Registra os itens recolhidos dos clientes:
- 🧪 Recolhimento de cilindros: Vazios do cliente
- 📦 Recolhimento de produtos: Devoluções ou trocas
- 🔄 Recolhimento para envase: Cilindros específicos para reabastecimento
📌 Importante: O status do item (cheio/vazio) é registrado no momento do recolhimento.
Retornos
Itens que retornam da viagem para o estoque interno:
- 🧪 Retorno de cilindros: Cheios não entregues ou vazios recolhidos
- 📦 Retorno de produtos: Estoque não utilizado
🎯 Objetivo: Prestação de contas da viagem - tudo que saiu deve retornar ou ser justificado.
Empréstimos
Quando o cliente não tem vazio para troca:
- 🧪 Empréstimo de cilindro: Cliente fica com o cheio
- 📦 Empréstimo de produto: Produto cedido temporariamente
📌 Regra: Empréstimos geram compromisso de devolução futura.
Devoluções de Empréstimo
Registro da devolução de itens emprestados:
- 🧪 Devolução de cilindro: Cliente devolve o vazio
- 📦 Devolução de produto: Produto retorna ao estoque
🔗 Vínculo: A devolução é vinculada ao empréstimo original para rastreabilidade completa.
🗺️ Mapa da Viagem
Visualização geográfica da rota e pontos de interesse
📍 Funcionalidades do Mapa
- Ponto de partida: Latitude/Longitude inicial
- Pontos de destino: Unidades visitadas na rota
- Ponto de chegada: Latitude/Longitude final
- Rota traçada: Caminho entre os pontos
- Distâncias parciais: Entre cada destino
- Distância total: KM rodado
Mapa interativo integrado
Clique no ícone 📍 ao lado dos campos de coordenadas para abrir o mapa e selecionar pontos🎯 Dica: O sistema calcula automaticamente a distância entre os destinos consecutivos e soma o KM rodado total.
📊 Indicadores e Gráficos
Análise de desempenho e métricas do romaneio
📈 Tipos de Análise
📅 Por Data
- Romaneios por período
- Movimentações por data
- Situação dos romaneios por data
🚛 Por Rota
- Romaneios por rota
- Movimentações por rota
- Situação por rota
🚗 Por Veículo
- Romaneios por veículo
- Movimentações por veículo
- Situação por veículo
👨✈️ Por Motorista
- Romaneios por motorista
- Movimentações por motorista
- Situação por motorista
👤 Por Membro
- Romaneios por responsável
- Movimentações por membro
- Situação por membro
📊 Por Romaneio
- Movimentações por romaneio específico
- Situação detalhada
- Comparativo entre romaneios
📊 Dados exibidos nos gráficos: Carregamentos, Entregas, Recolhimentos, Retornos, Empréstimos, Devoluções, e contagem de ocorrências por status.
🔍 Rastreabilidade e QR Code
Histórico completo de todas as ações do romaneio
📋 O que é registrado?
- 📅 Data e hora: Momento exato da ação
- 👤 Membro: Quem realizou a operação
- 📝 Ação: Carregamento, entrega, recolhimento, etc.
- 📍 Localização: GPS no momento da ação
- 🔄 Antes/Depois: Estado anterior e novo do item
🔍 Como consultar?
- 📊 Na capa do romaneio: Botão de rastreabilidade
- 📋 Na lista de romaneios: Ícone de histórico
- 🔎 Por item específico: Histórico do cilindro/produto dentro do romaneio
2026-03-01 09:30 - Carregamento - 10 cilindros cheios + 5 produtos
2026-03-01 10:00 - Status alterado: Em rota - Início da viagem
2026-03-01 11:30 - Entrega realizada - Cliente A - 5 cilindros
2026-03-01 14:00 - Recolhimento - Cliente B - 3 cilindros vazios
2026-03-01 17:00 - Status alterado: Retorno - Fim da viagem
2026-03-02 09:00 - Status alterado: Fechado - Romaneio concluído
⚙️ Ações disponíveis na Lista
Cada romaneio na lista possui ícones para ações rápidas.
info_outline Informações
Exibe detalhes completos do registro.
cloud_sync Sincronização
Salva dados no servidor e garante persistência.
edit Editar
Abre formulário para edição completa.
delete_forever Excluir
Remove o romaneio (apenas se permitido pelo status).
qr_code_2 QR Code
Gera QR Code com informações do romaneio.
launch Launch
Abre página pública do romaneio.
map Mapa
Visualiza localização no mapa.
timeline Linha do tempo
Histórico de ações do romaneio.
📋 Navegação e paginação
qr_code_scanner QR Code - Identificação do Romaneio
QR Code do Romaneio
Todo documento que possui QR Code no sistema já é gerado com o QR Code impresso automaticamente na folha. Basta imprimir o documento que o QR Code já estará lá, pronto para ser escaneado.
📋 QR Codes das Operações do Romaneio
| Operação | Prefixo | Formato | Exemplo |
|---|---|---|---|
| Romaneio | rv | ondevou_rv_{participante}_{id}Error Invalid or incomplete response |
📱 Aplicações do QR Code
- 🔍 Consulta rápida do romaneio no app
- 📦 Identificação de carregamentos
- 🚚 Conferência de entregas na rota
- 📊 Acesso aos detalhes da viagem
- 📄 Documentos já saem da impressora com o QR Code
Formato padrão: ondevou_{tipo}_{participante}_{id}
🎯 Dica: O QR Code do romaneio pode ser impresso e afixado no veículo ou nos documentos de transporte para agilizar as operações de carga e descarga. Todo documento gerado pelo sistema já sai com seu QR Code impresso automaticamente.
🏆 Propriedade Intelectual
Marca Registrada
OndeVou.com®
Propriedade Intelectual Assegurada
908765967
ONDEVOU.COM TECNOLOGIA LTDA
17.058.605/0001-36
Classe 42 - Serviços de TI