Devolução de Empréstimos
Detalhamento completo das 4 funcionalidades relacionadas às devoluções de empréstimos do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Devolução de Empréstimos
Visão completa do processo de devolução de cilindros emprestados. A devolução ocorre quando o cliente devolve o cilindro vazio que estava emprestado.
Situação: EM ROTA"] B["🔄 2. REALIZAR DEVOLUÇÃO
App Cilindros - ID 120"] 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
EMPRESTADO + VAZIO?"} I["❌ ERRO
Cilindro não pode ser devolvido"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Devolvido pelo cliente"] L["📝 3. EFEITO NO CILINDRO
Vazio → Vazio (mantém)"] M["🏢 Localização: EMPRESTADO → ROTA"] N["📊 4. STATUS FINAL
Cilindro em ROTA
Aguardando Retorno"] %% 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 M --> N %% EXCLUSÃO - PODE SER FEITA ENQUANTO COLETA ESTIVER PENDENTE E -.->|Após vincular| P["🗑️ EXCLUIR DEVOLUÇÃO
ID 131
Remove da lista"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#3b82f6,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 N fill:#1e293b,stroke:#f97316,stroke-width:2px style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444 style J fill:#1e293b,stroke:#f97316
📋 Passo a passo da devolução
O romaneio deve estar com situação 🔵 EM ROTA. É o veículo que irá recolher os cilindros emprestados.
No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros emprestados (câmera, USB, arquivo ou busca).
Valida todos os cilindros bipados. Critérios: cilindro deve estar 🤝 EMPRESTADO e 🔴 VAZIO.
Cilindro mantém situação 🔴 VAZIO e sua localização muda de 🤝 EMPRESTADO para 🚚 ROTA.
🛠️ 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á EMPRESTADO. 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 da Devolução | 🔵 EM ROTA | 🔴 VAZIO | 🤝 EMPRESTADO | Devolver |
| 2. Coleta (bipagem) | 🔵 EM ROTA | 🔴 VAZIO | 🤝 EMPRESTADO | 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 Devolução | 🔵 EM ROTA | 🔴 VAZIO | 🚚 ROTA | Retorno, Enchimento |
| 5. Após Retorno | 🟣 RETORNO | 🔴 VAZIO | 🏢 INTERNO | Enchimento |
↩️ Devoluções
🎯 O que faz
É a gaveta de cilindros devolvidos. Apresenta todos os cilindros que foram devolvidos de empréstimos, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todas as devoluções realizadas. Permite visualizar:
- 📅 Data e hora da devolução
- 🏷️ 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
- 📊 Relação com o empréstimo original
🔄 Realizar Devolução
🎯 O que faz
Registra a devolução de cilindros emprestados 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 emprestados foram devolvidos pelo cliente.
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
- ✈️ Finalizar: Valida todos os cilindros (Emprestado + Vazio) e registra a devolução.
1. Selecione o romaneio (apenas EM ROTA)
2. Bipa os QR Codes dos cilindros emprestados
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e registra a devolução
📱 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 a devolução. Critérios: cilindro deve estar 🤝 EMPRESTADO e 🔴 VAZIO. Após validar, todos são devolvidos. | |
| 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). |
| 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 devolvidos. Apenas romaneios EM ROTA aparecem na busca. |
| 👥 Cliente | ✅ Sim | Seleciona o cliente que está devolvendo os cilindros emprestados. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🗑️ Excluir Devolução
🎯 O que faz
É a gaveta de cilindros vinculados a uma devolução com opção de exclusão. Apresenta todos os cilindros de uma devolução específica, com filtros e ações, permitindo remover cilindros da devolução.
💡 Por que existe
Permite remover cilindros vinculados por engano a uma devolução.
Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).
📊 Resumo de Devolução por Cilindro
🎯 O que faz
É a tela de resumo/relatório das devoluções realizadas. 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 das devoluções. Permite:
- 📊 Visualizar total de cilindros devolvidos por produto
- 📈 Acompanhar volume devolvido em M³ e KG
- 🎯 Identificar produtos mais devolvidos
- 📅 Análise temporal das devoluções
- 👥 Análise por cliente, rota, veículo e motorista
- 🔄 Relacionar devoluções com empréstimos originais
📝 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 devolução | VAZIO (sempre vazio na devolução) |
| 📦 QTD | Quantidade de cilindros devolvidos | 1.531, 792, 467 |
| 📦 M3 | Volume total devolvido | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total devolvido | 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 devolvidos
Comparativo entre Medicinal, Industrial, Alimentício
Análise por tamanho de cilindro
Distribuição entre M3 e KG
Evolução temporal das devoluções
Distribuição por viagem
Ranking dos clientes
Distribuição geográfica
Ranking das rotas
Análise por veículo
Ranking dos motoristas
Análise por operador
📱 QR Code da Devolução
🎯 O que faz
Cada devolução registrada recebe um QR Code único (tipo "de") que permite:
- 🔍 Acesso rápido às informações da devolução
- 📊 Visualizar os cilindros devolvidos
- 📄 Gerar relatório da devolução
- 👥 Comprovante de devolução para o cliente
- 🔄 Relacionar com o empréstimo original
💡 Por que existe
Facilita a consulta e comprovação da devolução. O QR Code pode ser impresso e entregue ao cliente como comprovante.
QR Code: DE-12345 • Devolução: Hospital Regional - 24/03/26