Entregas e Base de Troca
Detalhamento completo das 4 funcionalidades relacionadas às entregas do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Entrega dos Cilindros
Visão completa do processo de entrega de cilindros em romaneios. As operações integram o App Romaneios (veículo em rota) e o App Cilindros (registro da entrega).
Situação: EM ROTA"] B["🚚 2. ENTREGAR CILINDRO
App Cilindros - ID 116"] 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 + CHEIO?"} I["❌ ERRO
Cilindro não pode ser entregue"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Entregue ao cliente"] L["📝 3. EFEITO NO CILINDRO
Cheio → Vazio"] M["🏢 Localização: ROTA → CLIENTE"] %% 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 127
Remove da entrega"] 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:#3b82f6,stroke-width:2px style C fill:#1e293b,stroke:#3b82f6 style D fill:#1e293b,stroke:#3b82f6 style E fill:#1e293b,stroke:#3b82f6 style F fill:#1e293b,stroke:#3b82f6,stroke-width:2px style K fill:#1e293b,stroke:#3b82f6 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 da entrega
O romaneio deve estar com situação 🔵 EM ROTA. Os cilindros estão marcados como 🚚 ROTA.
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 🚚 ROTA e 🟢 CHEIO.
Cilindro é marcado como 🔴 VAZIO e sua localização muda de 🚚 ROTA para 👥 CLIENTE.
🛠️ 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.
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. Antes da Entrega | 🔵 EM ROTA | 🟢 CHEIO | 🚚 ROTA | Carregar, Entregar |
| 2. Coleta (bipagem) | 🔵 EM ROTA | 🟢 CHEIO | 🚚 ROTA | 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 Entrega | 🔵 EM ROTA | 🔴 VAZIO | 👥 CLIENTE | Recolhimento, Retorno |
| 5. Após Recolhimento | 🟣 RETORNO | 🔴 VAZIO | 🏢 INTERNO | Enchimento |
📋 Entregas
🎯 O que faz
É a gaveta de cilindros entregues. Apresenta todos os cilindros que foram entregues a clientes, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todas as entregas realizadas. Permite visualizar:
- 📅 Data e hora da entrega
- 🏷️ Romaneio de transporte
- 👤 Cliente que recebeu o cilindro
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- 🚛 Veículo e Motorista responsáveis
🚚 Entregar cilindro ao cliente
🎯 O que faz
Registra a entrega de cilindros para o cliente 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 foram entregues ao 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 (Rota + Cheio) e registra a entrega.
1. Selecione o romaneio (apenas EM ROTA)
2. Bipa os QR Codes dos cilindros
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e registra a entrega
📱 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 entrega. Critérios: cilindro deve estar 🚚 ROTA e 🟢 CHEIO. Após validar, todos são entregues. | |
| 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 entregues. Apenas romaneios EM ROTA aparecem na busca. |
| 👥 Cliente | ✅ Sim | Seleciona o cliente que receberá os cilindros. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🗑️ Excluir cilindro da entrega
🎯 O que faz
É a gaveta de cilindros vinculados a uma entrega com opção de exclusão. Apresenta todos os cilindros de uma entrega específica, com filtros e ações, permitindo remover cilindros da entrega.
💡 Por que existe
Permite remover cilindros vinculados por engano a uma entrega.
Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).
📊 Resumo de entrega por cilindro
🎯 O que faz
É a tela de resumo/relatório das entregas 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 entregas. Permite:
- 📊 Visualizar total de cilindros entregues por produto
- 📈 Acompanhar volume entregue em M³ e KG
- 🎯 Identificar produtos mais entregues
- 📅 Análise temporal das entregas
- 👥 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 entrega | VAZIO (ou CHEIO se permitido) |
| 📦 QTD | Quantidade de cilindros entregues | 1.531, 792, 467 |
| 📦 M3 | Volume total entregue | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total entregue | 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 entregues
Comparativo entre Medicinal, Industrial, Alimentício
Evolução temporal das entregas
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
📊 Situações do Romaneio
Romaneio em andamento
Pode vincular/excluir cilindros.
Romaneio em viagem
Cilindros estão em ROTA. É aqui que as entregas acontecem.
Romaneio retornando
Cilindros vazios sendo recolhidos.
Romaneio concluído
Não pode mais ser alterado.
📱 QR Code da Entrega
🎯 O que faz
Cada entrega registrada recebe um QR Code único (tipo "en") que permite:
- 🔍 Acesso rápido às informações da entrega
- 📊 Visualizar os cilindros entregues
- 📄 Gerar relatório da entrega
- 👥 Comprovante de entrega para o cliente
💡 Por que existe
Facilita a consulta e comprovação da entrega. O QR Code pode ser impresso e entregue ao cliente como comprovante.
QR Code: EN-12345 • Entrega: Hospital Regional - 24/03/26