🚚 OPERAÇÃO: ENTREGA DE RECOLHIDOS PARA ENVASE (ID 294)

Entrega de Recolhidos para Envase

Detalhamento completo das 4 funcionalidades relacionadas à entrega de cilindros após envase no App Cilindros.
Esta operação é a devolução do cilindro reabastecido para o cliente que solicitou o envase.

📋 4 Funcionalidades 🏷️ QR Code tipo "ev" 📍 4 Localizações 🔄 Cheio → Vazio 🚚 Rastreabilidade 📋 Pré-requisito: Romaneio EM ROTA

🔄 Diferenças: Entrega Pós-Envase (ID 294) vs Entrega Padrão (ID 116)

📋 Entrega Padrão (ID 116)

  • Finalidade: Troca padrão (cheio por vazio)
  • QR Code tipo: en
  • Ciclo: Carregamento → Entrega → Recolhimento → Retorno
  • Cliente: Qualquer cliente com romaneio
  • Contexto: Cliente recebe cheio e devolve vazio

🔄 Entrega de Recolhidos para Envase (ID 294)

  • Finalidade: Devolução do cilindro após envase
  • QR Code tipo: ev
  • Ciclo: Recolhimento para Envase → Enchimento → Entrega Pós-Envase
  • Cliente: Específico (mesmo que entregou o cilindro para envase)
  • Contexto: Cliente recebe de volta seu próprio cilindro, agora cheio

✅ O fluxo operacional é IDÊNTICO à entrega padrão.
A diferença está no contexto de negócio e no QR Code gerado (tipo "ev" em vez de "en").
Consulte a documentação de Recolhimento para Envase (ID 290) para entender o início do ciclo.

🏭 Pré-requisito para realizar entrega pós-envase: Os cilindros devem estar com situação 🟢 CHEIO e localização 🚚 ROTA.
1. Recolhimento para Envase (ID 290)
2. Enchimento do cilindro
3. Entrega Pós-Envase (ID 294)
🔗 Consulte a documentação de Recolhimento para Envase para detalhes sobre a coleta do cilindro do cliente.
Após o enchimento: Os cilindros ficam 🟢 CHEIOS e 🚚 ROTA, prontos para a entrega ao cliente.
📊 FLUXO COMPLETO

🔄 Ciclo de Entrega Pós-Envase

Visão completa do processo de devolução de cilindros reabastecidos aos clientes. Esta operação finaliza o ciclo de envase, devolvendo o cilindro cheio ao cliente.

graph TD %% NÓS PRINCIPAIS A["📦 1. CILINDRO APÓS ENVASE
Situação: CHEIO + ROTA"] B["🚚 2. ENTREGAR CILINDRO PÓS-ENVASE
App Cilindros - ID 294"] 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 E -.->|Após vincular| P["🗑️ EXCLUIR CILINDRO
ID 295
Remove da entrega"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#14b8a6,stroke-width:2px style B fill:#1e293b,stroke:#14b8a6,stroke-width:2px style C fill:#1e293b,stroke:#14b8a6 style D fill:#1e293b,stroke:#14b8a6 style E fill:#1e293b,stroke:#14b8a6 style F fill:#1e293b,stroke:#14b8a6,stroke-width:2px style K fill:#1e293b,stroke:#14b8a6 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
🚚 App Cilindros - Entrega Pós-Envase 🔄 Transição de estado 🔵 Romaneio em Rota 🗑️ Exclusão (coleta pendente) 🛠️ Correção manual

📋 Passo a passo da entrega pós-envase

1 Cilindro após envase (ID 294)

O cilindro foi reabastecido e está com situação 🟢 CHEIO e localização 🚚 ROTA. O romaneio deve estar com situação 🔵 EM ROTA.

2 Entregar Cilindro (ID 294)

No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros reabastecidos (câmera, USB, arquivo ou busca).

3 Finalizar Coleta

Valida todos os cilindros bipados. Critérios: cilindro deve estar 🚚 ROTA e 🟢 CHEIO.

4 Efeito no Cilindro

Cilindro é marcado como 🔴 VAZIO e sua localização muda de 🚚 ROTA para 👥 CLIENTE.

🛠️ Correções e desvios

delete_forever Excluir Cilindro da Entrega (ID 295)

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.

location_on Alterar Localização (ID 688)

Corrige cilindro que não está em ROTA. Usar antes de finalizar a coleta.

radio_button_checked Alterar Situação (ID 687)

Corrige cilindro que não está CHEIO. Usar antes de finalizar a coleta.

save Gravar Coleta (ID 294)

Salva os cilindros bipados localmente. NÃO valida os cilindros - permite continuar depois sem perder dados.

Pré-requisito para entrega pós-envase: Cilindro deve estar 🟢 CHEIO e 🚚 ROTA.
🏷️ QR Code tipo "ev": Identifica que esta é uma entrega de cilindro reabastecido (pós-envase).
🗑️ Exclusão: Pode excluir um cilindro da entrega a qualquer momento enquanto a coleta estiver pendente. Após finalizar, não é mais possível.
📌 Após a entrega: O cilindro fica 🔴 VAZIO e 👥 CLIENTE.
🚫 Não é possível: Entregar cilindro que está em CLIENTE, INTERNO ou EMPRESTADO. Apenas cilindros em ROTA podem ser entregues.
💡 Dica: Utilize Gravar coleta periodicamente durante o processo para não perder dados em caso de interrupção. Use Finalizar apenas quando todos os cilindros estiverem bipados. Excluir pode ser usado a qualquer momento para corrigir erros antes de finalizar a coleta.
ID 293

📋 Entregas de Recolhidos para Envase

🎯 O que faz

É a gaveta de cilindros entregues após envase. Apresenta todos os cilindros que foram devolvidos aos clientes após o reabastecimento, com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdId entregaRomaneioNome/Razão Social CidadeUFRotaVeículo MotoristaId cilindroReferênciaMembro TipoAplicaçãoCapacidadeUnidade Data InicialData Final

📊 Taskbar - Ações disponíveis

🔍 Buscar
🧹 Abrir filtros
⏳ Atualizar
📋 Tabela
🌐 Página
📊 Resumo
📈 Gráficos
🖨️ Imprimir
📄 PDF
📊 Excel
📊 Dashboard

💡 Por que existe

É a consulta de todas as entregas pós-envase realizadas. Permite visualizar:

  • 📅 Data e hora da entrega
  • 🏷️ Romaneio de transporte
  • 👤 Cliente que recebeu o cilindro reabastecido
  • 🔢 Identificação do cilindro (ID e Referência)
  • 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
  • 🚛 Veículo e Motorista responsáveis
Pré-requisitos: Nenhum. Tela de consulta.
ID 294

🚚 Entregar cilindro pós-envase

🎯 O que faz

Registra a entrega de cilindros reabastecidos ao cliente através da leitura do QR Code do cilindro. É a tela padrão de Coleta de Dados da plataforma, com finalidade específica para envase.

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 reabastecidos foram devolvidos ao cliente. Cada cilindro é um ID único (QR Code) e mantém vínculo com o cliente que solicitou o envase.

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.
🚚 Processo de entrega pós-envase

1. Selecione o romaneio (apenas EM ROTA)
2. Bipa os QR Codes dos cilindros reabastecidos
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e registra a entrega

📱 Barra de ferramentas (Rodapé)

ÍconeFuncionalidadeDescrição
Abrir câmeraLeitura contínua de QR Codes pela câmera do celular. Permite bipar vários cilindros sequencialmente.
Fechar câmeraPara a leitura pela câmera.
Ler arquivoImporta arquivo .txt com lista de QR Codes (um por linha). Ideal para coleta offline ou pré-lista de cilindros.
BuscarAbre busca no cadastro de cilindros. Permite selecionar um cilindro para vincular.
ResumoExibe resumo dos cilindros já vinculados nesta coleta.
Gravar coletaSalva a coleta localmente (offline). NÃO valida os cilindros - apenas armazena para continuar depois. Evita perda de dados.
FinalizarValida todos os cilindros e registra a entrega. Critérios: cilindro deve estar 🚚 ROTA e 🟢 CHEIO. Após validar, todos são entregues.
Remover slideFecha a tela atual. Dados não salvos são perdidos.
Mais opçõesAbre menu auxiliar com funcionalidades extras.

➕ Menu "Mais Opções" (Auxiliar)

FuncionalidadeDescrição
Alterar situação do cilindroAbre tela para corrigir situação (CHEIO/VAZIO) de um cilindro.
Alterar localização do cilindroAbre tela para corrigir localização (INTERNO/ROTA/CLIENTE/EMPRESTADO).
Alterar situação da etiquetaPara etiquetas avulsas (cilindros não cadastrados).
Alterar localização da etiquetaPara etiquetas avulsas.
Alternar câmeraAlterna entre câmera frontal e traseira.
Explorar dadosAbre navegação para explorar dados relacionados.

📝 Campos do formulário

CampoObrigatórioObservação
🔘 Leitura QR Code✅ SimCampo com autofoco para leitura contínua. Aceita: leitor USB, câmera, digitação manual.
📊 Contador❌ LeituraMostra quantos cilindros já foram bipados nesta coleta.
📝 Descrição❌ OpcionalAnotação sobre a coleta.
👤 Participante✅ FixoUsuário logado (automático).
📊 Situação❌ FixoSempre "Pendente" enquanto a coleta está em andamento.
📅 Data❌ AutomáticoData e hora da leitura.
🔢 Quantidade✅ FixoSempre 1 (um cilindro por leitura).
🏷️ Romaneio✅ SimSeleciona o romaneio onde os cilindros serão entregues. Apenas romaneios EM ROTA aparecem na busca.
👥 Cliente✅ SimSeleciona o cliente que receberá os cilindros reabastecidos.
📦 Produto❌ LeituraCarregado automaticamente após leitura do QR Code.
Pré-requisitos: Romaneio deve estar EM ROTA. Cilindros devem estar em ROTA e CHEIOS (pós-envase).
📦Gravar coleta (💾): Salva os cilindros bipados localmente. NÃO valida se o cilindro está em ROTA e CHEIO. Permite continuar depois sem perder dados.
✈️Finalizar: Valida todos os cilindros bipados. Critérios: cilindro deve estar 🚚 ROTA e 🟢 CHEIO. Após validação, todos são entregues e o cilindro muda para VAZIO e CLIENTE.
🚫Quando NÃO usar: Se o cilindro já está VAZIO ou se o romaneio não está EM ROTA.
💡Dica: Use Gravar coleta periodicamente para não perder dados em caso de interrupção. Use Finalizar apenas quando todos os cilindros estiverem bipados.
ID 295

🗑️ Excluir cilindro da entrega

🎯 O que faz

É a gaveta de cilindros vinculados a uma entrega pós-envase 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 pós-envase.

Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).

Pré-requisitos: Coleta pendente. Cilindro deve estar vinculado à entrega.
🔒Restrições: Não é possível excluir cilindro se a entrega já foi finalizada.
🚫Quando NÃO usar: Para corrigir dados do cilindro → use rotinas de cadastro. Esta rotina é apenas para desvincular da entrega.
ID 296

📊 Resumo de entrega por cilindro

🎯 O que faz

É a tela de resumo/relatório das entregas pós-envase realizadas. Apresenta os dados agrupados por produto (Tipo + Aplicação + Capacidade + Unidade), com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdId entregaRomaneioNome/Razão Social CidadeUFRotaVeículo MotoristaId cilindroReferênciaMembro TipoAplicaçãoCapacidadeUnidade Data InicialData Final

📊 Taskbar - Ações disponíveis

🔍 Buscar
🧹 Abrir filtros
⏳ Atualizar
📋 Tabela
🌐 Página
📊 Resumo
📈 Gráficos
🖨️ Imprimir
📄 PDF
📊 Excel
📊 Dashboard

💡 Por que existe

É a visão consolidada das entregas pós-envase. Permite:

  • 📊 Visualizar total de cilindros entregues por produto (pós-envase)
  • 📈 Acompanhar volume entregue em M³ e KG
  • 🎯 Identificar produtos mais devolvidos após envase
  • 📅 Análise temporal das entregas pós-envase
  • 👥 Análise por cliente, rota, veículo e motorista
Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Possui gráficos interativos, dashboard com resumo executivo e opções de exportação.
Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Possui filtros por período, tipo de gás, aplicação, capacidade, rota, veículo, motorista, cliente e opções de exportação (PDF, Excel).
💡Dica: Utilize o Dashboard para uma visão executiva das entregas pós-envase. Os gráficos podem ser filtrados e exportados.
🚫Quando NÃO usar: Esta tela é para consulta e relatórios. Para registrar entregas pós-envase, use "Entregar cilindro pós-envase" (294).
Situações

📊 Situações do Romaneio

🟠 CARREGAMENTO

Romaneio em andamento
Pode vincular/excluir cilindros.

🔵 EM ROTA

Romaneio em viagem
Cilindros estão em ROTA. É aqui que as entregas pós-envase acontecem.

🟣 RETORNO

Romaneio retornando
Cilindros vazios sendo recolhidos.

🟢 FECHADO

Romaneio concluído
Não pode mais ser alterado.

🔄Fluxo normal: Carregamento → Em rota → Retorno → Fechado.
🔒Importante: Ao iniciar a viagem (Em rota), todos os cilindros vinculados são marcados como ROTA no sistema.
📌Após iniciar a viagem: Não é mais possível excluir cilindros do romaneio.
QR Code

📱 QR Code da Entrega Pós-Envase

🎯 O que faz

Cada entrega pós-envase registrada recebe um QR Code único (tipo "ev") que permite:

  • 🔍 Acesso rápido às informações da entrega
  • 📊 Visualizar os cilindros entregues (reabastecidos)
  • 📄 Gerar relatório da entrega
  • 👥 Comprovante de devolução do cilindro reabastecido

💡 Por que existe

Facilita a consulta e comprovação da devolução do cilindro reabastecido. O QR Code pode ser impresso e entregue ao cliente como comprovante.

🏷️Tipo "ev": Identifica que esta é uma entrega de cilindro reabastecido (pós-envase).
qr_code_2
QR Code: EV-12345 • Entrega Pós-Envase: Hospital Regional - 24/03/26