Romaneios e Carregamento
Detalhamento completo das 5 funcionalidades relacionadas ao carregamento do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Carregamento dos Cilindros
Visão completa do processo de carregamento de cilindros em romaneios. As operações integram o App Romaneios (criação do romaneio) e o App Cilindros (vinculação dos cilindros).
App Romaneios - ID 32"] B["🟠 Romaneio ABERTO
Situação: CARREGAMENTO"] C["🚚 2. CARREGAR CILINDROS
App Cilindros - ID 115"] D["📷 Leitura QR Code
Câmera / USB / Arquivo / Busca"] E["📊 Cilindro adicionado
Contador +1"] F["💾 GRAVAR COLETA
Salva offline
NÃO valida"] G["✈️ FINALIZAR COLETA
Validar todos os cilindros"] H{"✅ Validação
INTERNO + CHEIO?"} I["❌ ERRO
Cilindro não pode ser carregado"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Vinculado ao romaneio"] L["🔒 3. INICIAR VIAGEM"] M["🔵 Romaneio EM ROTA
Situação: EM ROTA"] N["📍 4. EFEITO NO CILINDRO
Interno → Rota"] O["🚚 Cilindro pronto para
Entrega"] %% FLUXO PRINCIPAL A --> B B --> C C --> D D --> E E --> F F --> G G --> H H -->|Sim| K H -->|Não| I I --> J J --> G K --> L L --> M M --> N N --> O %% EXCLUSÃO - PODE SER FEITA ENQUANTO ROMANEIO ESTIVER EM CARREGAMENTO E -.->|Após vincular| P["🗑️ EXCLUIR CILINDRO
ID 126
Remove do romaneio"] K -.->|Após finalizar| P P -.->|Romaneio ainda em CARREGAMENTO| C %% ESTILOS style A fill:#1e293b,stroke:#8b5cf6,stroke-width:2px style B fill:#1e293b,stroke:#f97316,stroke-width:2px style C fill:#1e293b,stroke:#f97316,stroke-width:2px style D fill:#1e293b,stroke:#f97316 style E fill:#1e293b,stroke:#f97316 style F fill:#1e293b,stroke:#f97316 style G fill:#1e293b,stroke:#f97316,stroke-width:2px style K fill:#1e293b,stroke:#f97316 style L fill:#1e293b,stroke:#3b82f6,stroke-width:2px style M fill:#1e293b,stroke:#3b82f6 style N fill:#1e293b,stroke:#f97316,stroke-width:2px style O fill:#1e293b,stroke:#f97316 style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444 style J fill:#1e293b,stroke:#f97316
📋 Passo a passo do carregamento
Cria a "capa" do romaneio no App Romaneios. Define rota, veículo, motorista e situação inicial 🟠 CARREGAMENTO.
No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros (câmera, USB, arquivo ou busca).
Valida todos os cilindros bipados. Critérios: cilindro deve estar 🏢 INTERNO e 🟢 CHEIO.
Altera a situação do romaneio para 🔵 EM ROTA. Todos os cilindros carregados são marcados como 🚚 ROTA.
🛠️ Correções e desvios
Remove um cilindro bipado por engano. Pode ser feito a qualquer momento enquanto o romaneio estiver em CARREGAMENTO - tanto antes quanto depois de finalizar a coleta.
Corrige cilindro que não está INTERNO. Usar antes de finalizar a coleta.
Corrige cilindro que não está CHEIO. Usar antes de finalizar a coleta.
Salva os cilindros bipados localmente. NÃO valida os cilindros - permite continuar depois sem perder dados.
📊 Estados do Cilindro durante o processo
| Etapa | Situação do Romaneio | Situação do Cilindro | Localização | Ações Permitidas |
|---|---|---|---|---|
| 1. Criação do Romaneio | 🟠 CARREGAMENTO | 🟢 CHEIO | 🏢 INTERNO | Criar, Alterar Romaneio |
| 2. Carregamento | 🟠 CARREGAMENTO | 🟢 CHEIO | 🏢 INTERNO | Carregar, Gravar coleta, Excluir (a qualquer momento) |
| 3. Validação (Finalizar) | 🟠 CARREGAMENTO | Verificação | Verificação | Corrigir erros (ID 687/688), Excluir (a qualquer momento) |
| 4. Após Validação | 🟠 CARREGAMENTO | 🟢 CHEIO | 🏢 INTERNO | Excluir (ainda pode remover), Iniciar Viagem |
| 5. Início da Viagem | 🔵 EM ROTA | 🟢 CHEIO | 🚚 ROTA | Entrega, Recolhimento, Retorno |
| 6. Entrega | 🔵 EM ROTA | 🔴 VAZIO | 👥 CLIENTE | Recolhimento |
➕ Incluir Romaneio
Esta funcionalidade não faz parte do App Cilindros, mas é apresentada aqui para entendimento do fluxo completo. O romaneio é a "capa" que agrupa os cilindros que serão transportados.
🎯 O que faz
Cria um novo romaneio de viagem. Após criar o romaneio, é possível vincular os cilindros que serão carregados.
Possui busca inteligente (getdata) para selecionar valores de listas pré-cadastradas:
- 🔍 Rota (origem/destino)
- 🔍 Vendedor
- 🔍 Motorista
- 🔍 Veículo
- 🔍 Membro (responsável)
- 🔍 Situação (Carregamento, Em rota, Retorno, Fechado)
💡 Por que existe
Todo carregamento precisa de um romaneio para agrupar os cilindros e rastrear o transporte. É o registro do evento de carregamento.
Sem o romaneio, os cilindros não podem ser marcados como "Rota" no sistema.
Assim como uma ordem de transporte no setor logístico, o romaneio agrupa todos os cilindros que serão entregues em uma mesma viagem.
📝 Campos do formulário
| Campo | Obrigatório | Observação |
|---|---|---|
| 🔢 Id | ❌ Não | Gerado automaticamente após salvar. QR Code é gerado. |
| 👤 Participante | ✅ Sim | Fixado automaticamente com o usuário logado. |
| 📅 Data hora inclusão | ❌ Não | Automático. |
| 📝 Descrição do romaneio | ✅ Sim | Nome do romaneio. |
| 📄 Observação | ❌ Opcional | Informações adicionais. |
| ✅ Permitir cilindros vazios | ❌ Opcional | Checkbox. Se marcado, permite carregar VAZIOS. |
| ✅ Permitir cilindros vencidos | ❌ Opcional | Checkbox. Se marcado, permite carregar cilindros com validade vencida. |
| 📊 Situação | ✅ Sim | Padrão: Carregamento. Pode ser alterado conforme fluxo. |
| 📍 Rota | ✅ Sim | Rota de entrega. Busca em lista pré-cadastrada. |
| 👔 Vendedor | ❌ Opcional | Vendedor responsável. |
| 🔢 Romaneio ERP Linux | ❌ Opcional | Código de integração com ERP. |
| 🚚 Motorista | ✅ Sim | Motorista responsável pela entrega. |
| 🚛 Veículo | ✅ Sim | Veículo utilizado no transporte. |
| 👤 Membro | ❌ Opcional | Responsável pelo romaneio. |
| 📅 Início da viagem | ❌ Opcional | Data/hora de saída. |
| 📅 Fim da viagem | ❌ Opcional | Data/hora de retorno. |
| 📅 Data do acerto | ❌ Opcional | Data de acerto financeiro. |
| 📏 KM inicial | ❌ Opcional | Quilometragem de saída. |
| 📏 KM final | ❌ Opcional | Quilometragem de retorno. |
📋 Carregamentos
🎯 O que faz
É a gaveta de cilindros carregados. Apresenta todos os cilindros que foram vinculados a romaneios, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todos os carregamentos realizados. Permite visualizar:
- 📅 Data e hora do carregamento
- 🏷️ Romaneio de transporte
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- 👤 Membro que realizou o carregamento
- 🚛 Veículo e Motorista responsáveis
🚚 Carregar cilindro para romaneio
🎯 O que faz
Vincula cilindros a um romaneio através da leitura do QR Code do cilindro. É a tela padrão de Coleta de Dados da plataforma.
Múltiplas formas de entrada:
- 📷 Leitura por câmera (contínua)
- 🔘 Leitura por leitor USB (bipar QR Code)
- 📄 Importação de arquivo .txt com lista de QR Codes
- 🔍 Busca direta no cadastro de cilindros
- ✏️ Digitação manual do QR Code
💡 Por que existe
Registra quais cilindros serão transportados neste romaneio. Cada cilindro é um ID único (QR Code).
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
- ✈️ Finalizar: Valida todos os cilindros (Interno + Cheio) e vincula ao romaneio.
1. Selecione o romaneio (apenas em CARREGAMENTO)
2. Bipa os QR Codes dos cilindros (câmera contínua)
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e vincula ao romaneio
📱 Barra de ferramentas (Rodapé)
| Ícone | Funcionalidade | Descrição |
|---|---|---|
| Abrir câmera | Leitura contínua de QR Codes pela câmera do celular. Permite bipar vários cilindros sequencialmente. | |
| Fechar câmera | Para a leitura pela câmera. | |
| Ler arquivo | Importa arquivo .txt com lista de QR Codes (um por linha). Ideal para coleta offline ou pré-lista de cilindros. | |
| Buscar | Abre busca no cadastro de cilindros. Permite selecionar um cilindro para vincular. | |
| Resumo | Exibe resumo dos cilindros já vinculados nesta coleta. | |
| Gravar coleta | Salva a coleta localmente (offline). NÃO valida os cilindros - apenas armazena para continuar depois. Evita perda de dados. | |
| Finalizar | Valida todos os cilindros e vincula ao romaneio. Critérios: cilindro deve estar 🏢 INTERNO e 🟢 CHEIO. Após validar, todos são vinculados ao romaneio. | |
| Remover slide | Fecha a tela atual. Dados não salvos são perdidos. | |
| Mais opções | Abre menu auxiliar com funcionalidades extras (ver tabela abaixo). |
➕ Menu "Mais Opções" (Auxiliar)
| Funcionalidade | Descrição |
|---|---|
| Alterar situação do cilindro | Abre tela para corrigir situação (CHEIO/VAZIO) de um cilindro. |
| Alterar localização do cilindro | Abre tela para corrigir localização (INTERNO/ROTA/CLIENTE/EMPRESTADO). |
| Alterar situação da etiqueta | Para etiquetas avulsas (cilindros não cadastrados). |
| Alterar localização da etiqueta | Para etiquetas avulsas. |
| Alternar câmera | Alterna entre câmera frontal e traseira. |
| Explorar dados | Abre navegação para explorar dados relacionados. |
📝 Campos do formulário
| Campo | Obrigatório | Observação | |
|---|---|---|---|
| 🔘 | Leitura QR Code | ✅ Sim | Campo com autofoco para leitura contínua. Aceita: leitor USB, câmera, digitação manual. |
| 📊 | Contador | ❌ Leitura | Mostra quantos cilindros já foram bipados nesta coleta. |
| 📝 | Descrição | ❌ Opcional | Anotação sobre a coleta. |
| 👤 | Participante | ✅ Fixo | Usuário logado (automático). |
| 📊 | Situação | ❌ Fixo | Sempre "Pendente" enquanto o romaneio está em CARREGAMENTO. |
| 📅 | Data | ❌ Automático | Data e hora da leitura. |
| 🔢 | Quantidade | ✅ Fixo | Sempre 1 (um cilindro por leitura). |
| 🏷️ | Romaneio | ✅ Sim | Seleciona o romaneio onde os cilindros serão carregados. Apenas romaneios em CARREGAMENTO aparecem na busca. |
| 📦 | Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🗑️ Excluir cilindro do carregamento
🎯 O que faz
É a gaveta de cilindros vinculados a um romaneio com opção de exclusão. Apresenta todos os cilindros de um romaneio específico, com filtros e ações, permitindo remover cilindros do carregamento.
💡 Por que existe
Permite remover cilindros vinculados por engano a um romaneio.
Importante: Só é possível excluir enquanto o romaneio estiver em CARREGAMENTO.
📊 Resumo de carregamento por cilindro
🎯 O que faz
É a tela de resumo/relatório dos carregamentos realizados. Apresenta os dados agrupados por produto (Tipo + Aplicação + Capacidade + Unidade), com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a visão consolidada do transporte. Permite:
- 📊 Visualizar total de cilindros carregados por produto
- 📈 Acompanhar volume transportado em M³ e KG
- 🎯 Identificar produtos mais transportados
- 📅 Análise temporal dos carregamentos
- 🚛 Análise por rota, veículo e motorista
📝 Campos da tabela de resumo
| Campo | Descrição | Exemplo | inea|
|---|---|---|---|
| 🔢 | Id | Ordenação do resumo (agrupamento sequencial) | 1, 2, 3... |
| 🧪 | Tipo | Tipo de gás | Oxigênio, Nitrogênio, CO2, Acetileno, Ar comprimido |
| 🎯 | Aplicação | Uso do gás | Medicinal, Industrial, Alimentício, Medicinal SAMU |
| 📏 | Capacidade | Tamanho do cilindro | 01, 03, 04, 05, 06, 07, 09, 10, 18, 23, 25, 2.5 |
| ⚖️ | Unidade | Unidade de medida | M3, KG |
| ⚪ | Situação | Status do cilindro após carregamento | CHEIO (ou VAZIO se permitido) |
| 📦 | QTD | Quantidade de cilindros carregados | 1.531, 792, 467, 652 |
| 📦 | M3 | Volume total transportado | 10.717, 5.544, 6.520, 820 |
| ⚖️ | KG | Peso total transportado | 350, 75, 45, 40 |
📊 Gráficos disponíveis
Gráfico de barras com quantidade, KG e M³ por produto completo (Tipo + Aplicação + Capacidade + Unidade)
Análise detalhada excluindo a unidade
Análise excluindo a capacidade
Visão consolidada por tipo de gás e aplicação
Ranking dos gases mais transportados
Comparativo entre Medicinal, Industrial, Alimentício
Distribuição por tamanho de cilindro
Análise por M3, KG
Ranking das rotas mais movimentadas
Análise de carga por veículo
Ranking dos motoristas mais ativos
Carregamentos por mês (quantidade, KG e M³)
📊 Dashboard - Resumo Executivo
📊 Situações do Romaneio
Romaneio em andamento
Pode vincular/excluir cilindros.
Romaneio em viagem
Cilindros estão em ROTA.
Romaneio retornando
Cilindros vazios sendo recolhidos.
Romaneio concluído
Não pode mais ser alterado.
📱 QR Code do Romaneio
🎯 O que faz
Cada romaneio recebe um QR Code único (tipo "rv") que permite:
- 🔍 Acesso rápido às informações do romaneio
- 📊 Visualizar os cilindros carregados
- 📄 Gerar relatório do romaneio
- 🚚 Acompanhar status da viagem
💡 Por que existe
Facilita a consulta do romaneio no ambiente operacional. O QR Code pode ser impresso e fixado no veículo ou no manifesto de carga.
QR Code: RV-12345 • Romaneio: Rota João Pessoa - 24/03/26