Módulo Estoque — Solicitações
As solicitações são o fluxo reverso de abastecimento: quando o estoque não está onde o técnico precisa, ele pede — e o material chega até ele por um caminho com análise e registro.
O fluxo completo
- Técnico solicita — pede o material/equipamento (o pedido já indica o veículo de destino, se ele tem frota);
- Prestadora analisa — aprova ou rejeita o pedido;
- Super Administrador abastece — registra a entrada do material (origem: estoque global ou da prestadora);
- Prestadora repassa ao técnico — a transferência do material para o veículo do técnico; ou, quando a prestadora já tem o material, ela pode entregar direto do estoque dela (sem depender do super-admin).
A prestadora também solicita
A prestadora também pode criar solicitações ao Super Administrador (ex.: pedir reposição do próprio estoque). Nesse caso, o pedido já nasce Aprovada (a análise é da própria prestadora) e termina no abastecimento — sem a etapa de repasse.
Status de uma solicitação
| Status | Significado |
|---|---|
| Pendente | Aguardando análise da prestadora |
| Aprovada | Análise aprovada — pode ser abastecida |
| Rejeitada | Análise negada |
| Abastecida | Super-admin registrou a entrada do material |
| Repassada | Material transferido/entregue ao técnico — concluída |
| Cancelada | Cancelada pelo solicitante enquanto pendente |
Criar uma solicitação
Menu Estoque → Solicitações → botão "Nova solicitação". O modal é dividido em:
Adicionar item (catálogo)
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
| Produto | Seleção com busca | Sim | Busque no catálogo de materiais (nome ou SKU). O subtítulo indica com serial ou por quantidade |
| Número de série (produto com serial) | Seleção com busca | Sim | O equipamento específico solicitado. Aparece apenas para produtos com serial |
| Quantidade (produto sem serial) | Número (≥ 1) | Sim | A quantidade solicitada. Aparece apenas para produtos por quantidade |
| Adicionar item | Botão | — | Acrescenta o item à lista da solicitação. Você pode adicionar vários itens e remover qualquer um antes de enviar |
Veículo de destino
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
| Frota / veículo de destino | Seleção | Condicional | Técnico com frota vinculada: escolhe o veículo que receberá o material (o primeiro veículo vem pré-selecionado — veja Frota). Após o abastecimento, a prestadora repassa o material para essa frota |
Observações
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
| Observações | Texto (multilinha, máx. 1000) | Não | Detalhes do que está sendo solicitado |
Botão "Enviar solicitação" cria o pedido (nasce como Pendente). O técnico também pode solicitar pelo bot do Telegram (comando "📦 Solicitar material" — veja o módulo Telegram).
O técnico adiciona os itens do catálogo e define o veículo de destino.
Acompanhar e agir
Na listagem de Solicitações, cada linha mostra protocolo, status, solicitante e quantidade de itens, com filtro por status e busca.
Solicitações: protocolo, status e ações disponíveis conforme o perfil e a etapa.
O técnico vê apenas as próprias solicitações — do pedido ao repasse para o veículo dele.
O detalhe reúne itens solicitados, movimentações geradas e histórico de status.
As ações aparecem conforme o perfil e o status:
| Ação | Quem | Quando |
|---|---|---|
| Aprovar / Rejeitar | Prestadora (e super-admin) | Solicitação de técnico pendente |
| Abastecer | Super Administrador | Solicitação aprovada |
| Entregar do meu estoque | Prestadora | Solicitação de técnico pendente ou aprovada — entrega direto do estoque dela (com resumo de disponibilidade por item: Tem / Parcial / Sem estoque + localizações sugeridas) |
| Solicitar reposição | Prestadora | No fluxo de entrega, quando não há estoque: gera automaticamente uma nova solicitação ao super-admin com os mesmos itens |
| Repassar ao técnico | Prestadora | Solicitação abastecida de técnico |
| Cancelar | Solicitante | Própria solicitação pendente |
| Ver detalhes | Todos | Sempre disponível — abre o detalhe completo com itens, histórico de status, movimentações geradas e disponibilidade |
Notificações
Cada mudança de status notifica as pessoas certas (no sino do sistema e, quando configurado, push): a prestadora quando o técnico solicita, o solicitante quando aprova/rejeita/abastece/repassa, e os super-admins quando a prestadora pede reposição. Clicar na notificação abre a solicitação correspondente.
Regras de negócio
- O técnico só vê e age nas próprias solicitações;
- O repasse é exclusivo de solicitações de técnico (a prestadora não repassa para si mesma);
- Abastecer registra a entrada real de estoque; repassar/entregar registra a transferência real — tudo vira movimentação no histórico;
- Se o equipamento já está no veículo de destino, o sistema conclui a solicitação sem movimentação redundante.