🔄 OPERAÇÃO: RECOLHIMENTO PARA ENVASE (ID 290)

Recolhimento para Envase

Detalhamento completo das 4 funcionalidades relacionadas ao recolhimento para envase do App Cilindros.
Esta operação é a coleta do cilindro vazio do cliente para ser reabastecido na fábrica.

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

🔄 Diferenças: Recolhimento para Envase (ID 290) vs Recolhimento Padrão (ID 117)

📋 Recolhimento Padrão (ID 117)

  • Finalidade: Recolher vazio do cliente (troca padrão)
  • QR Code tipo: rc
  • Ciclo: Entrega → Recolhimento → Retorno
  • Destino: Estoque interno (aguarda enchimento)
  • Contexto: Cliente devolve vazio após usar o cheio

🔄 Recolhimento para Envase (ID 290)

  • Finalidade: Recolher cilindro do cliente para reabastecimento
  • QR Code tipo: re
  • Ciclo: Recolhimento para Envase → Enchimento → Entrega Pós-Envase
  • Destino: Fábrica para envase (rastreabilidade do mesmo cilindro)
  • Contexto: Cliente quer reabastecer seu próprio cilindro

✅ O fluxo operacional é IDÊNTICO ao recolhimento padrão.
A diferença está no contexto de negócio e no QR Code gerado (tipo "re" em vez de "rc").
Consulte a documentação de Entrega de Recolhidos para Envase (ID 294) para entender a continuidade do ciclo.

🏭 Pré-requisito para realizar recolhimento para envase: Os cilindros devem estar com situação 🔴 VAZIO e localização 👥 CLIENTE.
1. Entregar cilindro CHEIO (ID 116)
2. Cilindro fica VAZIO e CLIENTE
3. Recolher para Envase (ID 290)
🔗 Consulte a documentação de Entregas ou Entrega Pós-Envase para detalhes sobre como o cilindro chegou ao cliente.
Após a entrega: Os cilindros ficam 🔴 VAZIOS e 👥 CLIENTE, prontos para o recolhimento para envase.
📊 FLUXO COMPLETO

🔄 Ciclo de Recolhimento para Envase

Visão completa do processo de recolhimento de cilindros vazios dos clientes para reabastecimento. Esta operação inicia o ciclo de envase, levando o cilindro do cliente para a fábrica.

graph TD %% NÓS PRINCIPAIS A["📦 1. ROMANEIO EM ROTA
Situação: EM ROTA"] B["🔄 2. RECOLHER PARA ENVASE
App Cilindros - ID 290"] 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
CLIENTE + VAZIO?"} I["❌ ERRO
Cilindro não pode ser recolhido"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Recolhido para envase"] L["📝 3. EFEITO NO CILINDRO
Vazio → Vazio"] M["🏢 Localização: CLIENTE → INTERNO"] N["🔄 Aguarda Enchimento"] %% 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 CILINDRO
ID 291
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:#ec4899,stroke-width:2px style C fill:#1e293b,stroke:#ec4899 style D fill:#1e293b,stroke:#ec4899 style E fill:#1e293b,stroke:#ec4899 style F fill:#1e293b,stroke:#ec4899,stroke-width:2px style K fill:#1e293b,stroke:#ec4899 style L fill:#1e293b,stroke:#22c55e,stroke-width:2px style M fill:#1e293b,stroke:#3b82f6 style N fill:#1e293b,stroke:#ec4899,stroke-width:2px style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444 style J fill:#1e293b,stroke:#f97316
🔄 App Cilindros - Recolhimento para Envase 🔄 Transição de estado 🟠 Romaneio em Rota 🗑️ Exclusão (coleta pendente) 🛠️ Correção manual

📋 Passo a passo do recolhimento para envase

1 Romaneio em Rota (ID 171)

O romaneio deve estar com situação 🔵 EM ROTA. Os cilindros estão marcados como 👥 CLIENTE.

2 Recolher para Envase (ID 290)

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

3 Finalizar Coleta

Valida todos os cilindros bipados. Critérios: cilindro deve estar 👥 CLIENTE e 🔴 VAZIO.

4 Efeito no Cilindro

Cilindro permanece 🔴 VAZIO e sua localização muda de 👥 CLIENTE para 🏢 INTERNO, aguardando envase.

🛠️ Correções e desvios

delete_forever Excluir Cilindro do Recolhimento (ID 291)

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 CLIENTE. Usar antes de finalizar a coleta.

radio_button_checked Alterar Situação (ID 687)

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

save Gravar Coleta (ID 290)

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

📊 Estados do Cilindro durante o processo

\n
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 Aguardando envase
5. Após Envase 🟣 RETORNO 🟢 CHEIO 🏢 INTERNO Entrega Pós-Envase (ID 294)
Pré-requisito para recolhimento para envase: Cilindro deve estar 🔴 VAZIO e 👥 CLIENTE.
🏷️ QR Code tipo "re": Identifica que este é um recolhimento para envase (cilindro será reabastecido).
🗑️ Exclusão: Pode excluir um cilindro do recolhimento a qualquer momento enquanto a coleta estiver pendente. Após finalizar, não é mais possível.
📌 Após o recolhimento: O cilindro permanece 🔴 VAZIO e muda para 🏢 INTERNO, aguardando envase.
🚫 Não é possível: Recolher cilindro que está em INTERNO, ROTA ou EMPRESTADO. Apenas cilindros em CLIENTE podem ser recolhidos para envase.
💡 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 289

📋 Recolhimentos para Envase

🎯 O que faz

É a gaveta de cilindros recolhidos para envase. Apresenta todos os cilindros que foram recolhidos dos clientes para reabastecimento, com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdId recolhimentoRomaneioNome/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 todos os recolhimentos para envase realizados. Permite visualizar:

  • 📅 Data e hora do recolhimento
  • 🏷️ Romaneio de transporte
  • 👤 Cliente que devolveu o cilindro para envase
  • 🔢 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 290

🔄 Recolher cilindro para envase

🎯 O que faz

Registra o recolhimento de cilindros vazios dos clientes para reabastecimento 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 vazios foram recolhidos para serem reabastecidos. Cada cilindro mantém seu QR Code original e vínculo com o cliente.

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 para envase.
🔄 Processo de recolhimento para envase

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

Pré-requisitos: Romaneio deve estar EM ROTA. Cilindros devem estar em CLIENTE e VAZIOS.
📦Gravar coleta (💾): Salva os cilindros bipados localmente. NÃO valida se o cilindro está em CLIENTE e VAZIO. Permite continuar depois sem perder dados.
✈️Finalizar: Valida todos os cilindros bipados. Critérios: cilindro deve estar 👥 CLIENTE e 🔴 VAZIO. Após validação, todos são recolhidos e o cilindro muda para INTERNO (permanece VAZIO), aguardando envase.
🚫Quando NÃO usar: Se o cilindro já está CHEIO 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 291

🗑️ Excluir cilindro do recolhimento

🎯 O que faz

É a gaveta de cilindros vinculados a um recolhimento para envase 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 para envase.

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

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

📊 Resumo de recolhimento por cilindro

🎯 O que faz

É a tela de resumo/relatório dos recolhimentos para envase realizados. Apresenta os dados agrupados por produto (Tipo + Aplicação + Capacidade + Unidade), com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdId recolhimentoRomaneioNome/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 dos recolhimentos para envase. Permite:

  • 📊 Visualizar total de cilindros recolhidos para envase por produto
  • 📈 Acompanhar volume recolhido em M³ e KG
  • 🎯 Identificar produtos mais solicitados para envase
  • 📅 Análise temporal dos recolhimentos para 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 dos recolhimentos para envase. Os gráficos podem ser filtrados e exportados.
🚫Quando NÃO usar: Esta tela é para consulta e relatórios. Para registrar recolhimentos para envase, use "Recolher cilindro para envase" (290).
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 os recolhimentos para envase acontecem.

🟣 RETORNO

Romaneio retornando
Cilindros vazios sendo retornados para estoque.

🟢 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 do Recolhimento para Envase

🎯 O que faz

Cada recolhimento para envase registrado recebe um QR Code único (tipo "re") que permite:

  • 🔍 Acesso rápido às informações do recolhimento
  • 📊 Visualizar os cilindros recolhidos para envase
  • 📄 Gerar relatório do recolhimento
  • 👥 Comprovante de coleta para reabastecimento

💡 Por que existe

Facilita a consulta e comprovação do recolhimento para envase. O QR Code pode ser impresso e entregue ao cliente como comprovante de coleta do cilindro para reabastecimento.

🏷️Tipo "re": Identifica que este é um recolhimento para envase (cilindro será reabastecido).
qr_code_2
QR Code: RE-12345 • Recolhimento para Envase: Hospital Regional - 24/03/26