Retorno de Cilindros ao Estoque
Detalhamento completo das 4 funcionalidades relacionadas ao retorno de cilindros do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
↩️ Ciclo de Retorno dos Cilindros
Visão completa do processo de retorno de cilindros ao estoque interno. O retorno é a operação que finaliza o ciclo de viagem, trazendo todos os cilindros (cheios e vazios) de volta para a base.
Situação: EM ROTA ou RETORNO"] B["↩️ 2. RETORNAR CILINDRO
App Cilindros - ID 118"] 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?"} I["❌ ERRO
Cilindro não pode ser retornado"] J["🛠️ CORRIGIR
Alterar Localização (688)"] K["✅ Cilindro APROVADO
Retornado ao estoque"] L["📝 3. EFEITO NO CILINDRO
Mantém situação atual"] M["🏢 Localização: ROTA → 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 129
Remove da coleta"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#964B00,stroke-width:2px style B fill:#1e293b,stroke:#964B00,stroke-width:2px style C fill:#1e293b,stroke:#964B00 style D fill:#1e293b,stroke:#964B00 style E fill:#1e293b,stroke:#964B00 style F fill:#1e293b,stroke:#964B00,stroke-width:2px style K fill:#1e293b,stroke:#964B00 style L fill:#1e293b,stroke:#22c55e,stroke-width:2px style M fill:#1e293b,stroke:#3b82f6 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 retorno
O romaneio deve estar com situação 🔵 EM ROTA ou 🟣 RETORNO. Os cilindros estão marcados como 🚚 ROTA.
No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros que retornam ao estoque.
Valida todos os cilindros bipados. Critérios: cilindro deve estar 🚚 ROTA.
Cilindro mantém sua situação (cheio/vazio) e sua localização muda de 🚚 ROTA 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 ROTA. Usar antes de finalizar a coleta.
Salva os cilindros bipados localmente. NÃO valida os cilindros - permite continuar depois sem perder dados.
Após o retorno de todos os cilindros, o romaneio pode ser finalizado, mudando para situação FECHADO.
📊 Estados do Cilindro durante o processo
| Etapa | Situação do Romaneio | Situação do Cilindro | Localização | Ações Permitidas |
|---|---|---|---|---|
| 1. Durante a viagem (Entregas/Recolhimentos) | 🔵 EM ROTA | Cheio ou Vazio | 🚚 ROTA | Entregar, Recolher |
| 2. Preparação para retorno | 🔵 EM ROTA | Cheio ou Vazio | 🚚 ROTA | Alterar romaneio para RETORNO |
| 3. Retorno (coleta/bipagem) | 🟣 RETORNO | Cheio ou Vazio | 🚚 ROTA | Gravar coleta, Excluir (a qualquer momento) |
| 4. Validação (Finalizar) | 🟣 RETORNO | Verificação | Verificação (deve estar ROTA) | Corrigir erros (ID 688), Excluir (a qualquer momento) |
| 5. Após Retorno | 🟣 RETORNO | Mantém a situação | 🏢 INTERNO | Enchimento (se vazio), Carregamento (se cheio) |
| 6. Romaneio Fechado | 🟢 FECHADO | Mantém a situação | 🏢 INTERNO | Novo ciclo |
📋 Retornos
🎯 O que faz
É a gaveta de cilindros retornados. Apresenta todos os cilindros que foram retornados ao estoque, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todos os retornos realizados. Permite visualizar:
- 📅 Data e hora do retorno
- 🏷️ Romaneio de transporte
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- 🚛 Veículo e Motorista responsáveis
- 👤 Membro que registrou o retorno
↩️ Retornar cilindro ao estoque
🎯 O que faz
Registra o retorno de cilindros ao estoque interno através da leitura do QR Code do cilindro. É a tela padrão de Coleta de Dados da plataforma, com finalidade específica para retorno.
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 retornaram ao estoque após a viagem. É a prestação de contas do romaneio.
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
- ✈️ Finalizar: Valida todos os cilindros (Rota) e registra o retorno.
1. Selecione o romaneio (apenas EM ROTA ou RETORNO)
2. Bipa os QR Codes dos cilindros que retornam
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e registra o retorno
📱 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 retorno. Critérios: cilindro deve estar 🚚 ROTA. Após validar, todos são retornados. | |
| 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 que está retornando. Apenas romaneios EM ROTA ou RETORNO aparecem na busca. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🗑️ Excluir cilindro do retorno
🎯 O que faz
É a gaveta de cilindros vinculados a um retorno com opção de exclusão. Apresenta todos os cilindros de um retorno específico, com filtros e ações, permitindo remover cilindros do retorno.
💡 Por que existe
Permite remover cilindros vinculados por engano a um retorno.
Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).
📊 Resumo de retorno por cilindro
🎯 O que faz
É a tela de resumo/relatório dos retornos 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 retornos. Permite:
- 📊 Visualizar total de cilindros retornados por produto
- 📈 Acompanhar volume retornado em M³ e KG
- 🎯 Identificar produtos mais retornados
- 📅 Análise temporal dos retornos
- 👥 Análise por 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 |
| 🎯 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 retorno | Cheio ou Vazio (mantém) |
| 📦 QTD | Quantidade de cilindros retornados | 1.531, 792, 467 |
| 📦 M3 | Volume total retornado | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total retornado | 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 retornados
Comparativo entre Medicinal, Industrial, Alimentício
Distribuição por viagem
Ranking das rotas
Análise por veículo
Ranking dos motoristas
Evolução temporal dos retornos
📊 Situações do Romaneio
Romaneio em andamento
Pode vincular/excluir cilindros.
Romaneio em viagem
Cilindros estão em ROTA. É aqui que entregas e recolhimentos acontecem.
Romaneio retornando
Cilindros voltando para estoque. É aqui que o retorno é registrado.
Romaneio concluído
Não pode mais ser alterado.
📱 QR Code do Retorno
🎯 O que faz
Cada retorno registrado recebe um QR Code único (tipo "rt") que permite:
- 🔍 Acesso rápido às informações do retorno
- 📊 Visualizar os cilindros retornados
- 📄 Gerar relatório do retorno
- 📋 Comprovante de prestação de contas
💡 Por que existe
Facilita a consulta e comprovação do retorno. O QR Code pode ser usado para auditoria e prestação de contas da viagem.
QR Code: RT-12345 • Retorno: Rota Centro - 24/03/26