Recolhimentos e Retorno de Vazios
Detalhamento completo das 4 funcionalidades relacionadas aos recolhimentos do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Recolhimento dos Cilindros
Visão completa do processo de recolhimento de cilindros vazios dos clientes. As operações integram o App Romaneios (veículo em rota) e o App Cilindros (registro do recolhimento).
Situação: EM ROTA"] B["🔄 2. RECOLHER CILINDRO
App Cilindros - ID 117"] C["📷 Leitura QR Code
Câmera / USB / Arquivo / Busca"] D["📊 Cilindro selecionado
Verificação de dados"] E["💾 GRAVAR COLETA
Salva offline
NÃO valida"] F["✈️ FINALIZAR COLETA
Validar todos os cilindros"] H{"✅ Validação
ROTA + VAZIO?"} I["❌ ERRO
Cilindro não pode ser recolhido"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Recolhido do cliente"] L["📝 3. EFEITO NO CILINDRO
Vazio → Vazio"] M["🏢 Localização: CLIENTE → INTERNO"] %% FLUXO PRINCIPAL A --> B B --> C C --> D D --> E E --> F F --> H H -->|Sim| K H -->|Não| I I --> J J --> F K --> L L --> M %% EXCLUSÃO - PODE SER FEITA ENQUANTO COLETA ESTIVER PENDENTE E -.->|Após vincular| P["🗑️ EXCLUIR CILINDRO
ID 128
Remove da coleta"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#f59e0b,stroke-width:2px style B fill:#1e293b,stroke:#f59e0b,stroke-width:2px style C fill:#1e293b,stroke:#f59e0b style D fill:#1e293b,stroke:#f59e0b style E fill:#1e293b,stroke:#f59e0b style F fill:#1e293b,stroke:#f59e0b,stroke-width:2px style K fill:#1e293b,stroke:#f59e0b style L fill:#1e293b,stroke:#22c55e,stroke-width:2px style M 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 recolhimento
O romaneio deve estar com situação 🔵 EM ROTA. Os cilindros estão marcados como 🚚 ROTA ou 👥 CLIENTE.
No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros vazios (câmera, USB, arquivo ou busca).
Valida todos os cilindros bipados. Critérios: cilindro deve estar 👥 CLIENTE e 🔴 VAZIO.
Cilindro permanece 🔴 VAZIO e sua localização muda de 👥 CLIENTE para 🏢 INTERNO.
🛠️ Correções e desvios
Remove um cilindro bipado por engano. Pode ser feito a qualquer momento enquanto a coleta estiver pendente - tanto antes quanto depois de finalizar a coleta.
Corrige cilindro que não está em CLIENTE. Usar antes de finalizar a coleta.
Corrige cilindro que não está VAZIO. 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. Antes do Recolhimento | 🔵 EM ROTA | 🔴 VAZIO | 👥 CLIENTE | Recolher |
| 2. Coleta (bipagem) | 🔵 EM ROTA | 🔴 VAZIO | 👥 CLIENTE | Gravar coleta, Excluir (a qualquer momento) |
| 3. Validação (Finalizar) | 🔵 EM ROTA | Verificação | Verificação | Corrigir erros (ID 687/688), Excluir (a qualquer momento) |
| 4. Após Recolhimento | 🔵 EM ROTA | 🔴 VAZIO | 🏢 INTERNO | Enchimento |
| 5. Após Retorno | 🟣 RETORNO | 🔴 VAZIO | 🏢 INTERNO | Enchimento |
📋 Recolhimentos
🎯 O que faz
É a gaveta de cilindros recolhidos. Apresenta todos os cilindros que foram recolhidos dos clientes, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todos os recolhimentos realizados. Permite visualizar:
- 📅 Data e hora do recolhimento
- 🏷️ Romaneio de transporte
- 👤 Cliente que devolveu o cilindro
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- 🚛 Veículo e Motorista responsáveis
🔄 Recolher cilindro do cliente
🎯 O que faz
Registra o recolhimento de cilindros vazios dos clientes através da leitura do QR Code do cilindro. É a tela padrão de Coleta de Dados da plataforma, com finalidade específica para recolhimento.
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 foram recolhidos do cliente. 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 (Cliente + Vazio) e registra o recolhimento.
1. Selecione o romaneio (apenas EM ROTA)
2. Bipa os QR Codes dos cilindros vazios
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e registra o recolhimento
📱 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 registra o recolhimento. Critérios: cilindro deve estar 👥 CLIENTE e 🔴 VAZIO. Após validar, todos são recolhidos. | |
| Remover slide | Fecha a tela atual. Dados não salvos são perdidos. | |
| Mais opções | Abre menu auxiliar com funcionalidades extras. |
➕ 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 a coleta está em andamento. |
| 📅 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 recolhidos. Apenas romaneios EM ROTA aparecem na busca. |
| 👥 Cliente | ✅ Sim | Seleciona o cliente que está devolvendo os cilindros. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🗑️ Excluir cilindro do recolhimento
🎯 O que faz
É a gaveta de cilindros vinculados a um recolhimento com opção de exclusão. Apresenta todos os cilindros de um recolhimento específico, com filtros e ações, permitindo remover cilindros do recolhimento.
💡 Por que existe
Permite remover cilindros vinculados por engano a um recolhimento.
Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).
📊 Resumo de recolhimento por cilindro
🎯 O que faz
É a tela de resumo/relatório dos recolhimentos 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 dos recolhimentos. Permite:
- 📊 Visualizar total de cilindros recolhidos por produto
- 📈 Acompanhar volume recolhido em M³ e KG
- 🎯 Identificar produtos mais recolhidos
- 📅 Análise temporal dos recolhimentos
- 👥 Análise por cliente, rota, veículo e motorista
📝 Campos da tabela de resumo
| Campo | Descrição | Exemplo |
|---|---|---|
| 🔢 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 |
| 📏 Capacidade | Tamanho do cilindro | 01, 04, 07, 09, 10, 18, 23, 25 |
| ⚖️ Unidade | Unidade de medida | M3, KG |
| ⚪ Situação | Status após recolhimento | VAZIO (ou CHEIO se permitido) |
| 📦 QTD | Quantidade de cilindros recolhidos | 1.531, 792, 467 |
| 📦 M3 | Volume total recolhido | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total recolhido | 350, 75, 45 |
📊 Gráficos disponíveis
Gráfico de barras com quantidade, KG e M³ por produto completo
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 recolhidos
Comparativo entre Medicinal, Industrial, Alimentício
Distribuição por tamanho de cilindro
Análise entre M3 e KG
📊 Situações do Romaneio
Romaneio em andamento
Pode vincular/excluir cilindros.
Romaneio em viagem
Cilindros estão em ROTA. É aqui que os recolhimentos acontecem.
Romaneio retornando
Cilindros vazios sendo retornados para estoque.
Romaneio concluído
Não pode mais ser alterado.
📱 QR Code do Recolhimento
🎯 O que faz
Cada recolhimento registrado recebe um QR Code único (tipo "rc") que permite:
- 🔍 Acesso rápido às informações do recolhimento
- 📊 Visualizar os cilindros recolhidos
- 📄 Gerar relatório do recolhimento
- 👥 Comprovante de recolhimento para o cliente
💡 Por que existe
Facilita a consulta e comprovação do recolhimento. O QR Code pode ser impresso e entregue ao cliente como comprovante de devolução dos cilindros vazios.
QR Code: RC-12345 • Recolhimento: Hospital Regional - 24/03/26