Lição: Estoque e Produtos

Esta lição prepara você para operar e configurar o módulo Estoque do Sistema Rabi do zero. Ao final, você saberá cadastrar produtos e seus cadastros de apoio (tipos, fornecedores, fabricantes, princípios ativos, depósitos), entender o alerta de estoque mínimo (status CRÍTICO), ler o Mapa de Estoque e reconhecer como a movimentação de estoque se conecta ao prontuário e ao financeiro. Tudo aqui é o que existe em produção hoje.

1. Objetivo do módulo e onde fica

O módulo de Estoque permite à clínica controlar materiais, insumos e medicamentos: do cadastro básico de produtos ao controle de depósitos, movimentação e alertas de estoque mínimo.

🟢 Em produção: produto, fornecedor, fabricante, princípio ativo, depósito, kit de produtos, movimentação de estoque e posição de estoque (Mapa de Estoque).

Quando usar: mais relevante para clínicas que consomem insumos, medicamentos ou materiais em procedimentos (infusão, oncologia, dermatologia estética, fisioterapia, etc.). Consultórios simples podem não precisar deste módulo.

Onde fica: menu principal → Estoque. Rotas em produção (sob /portal/):

Função	Rota
Lista de produtos	`/portal/estoque/produtos`
Novo produto	`/portal/estoque/produtos/criar`
Tipos de produto	`/portal/estoque/produtos/tipos-produtos`
Fornecedores	`/portal/estoque/fornecedores`
Fabricantes	`/portal/estoque/fabricantes`
Princípios ativos	`/portal/estoque/principios-ativos`
Depósitos	`/portal/estoque/depositos`

Grupo de permissão: ESTOQUE.

2. Lista de Produtos

A tela principal (/portal/estoque/produtos) lista todos os produtos cadastrados com seus saldos atuais. Colunas disponíveis:

Nome do produto
Tipo de produto
Fornecedor
Fabricante
Estoque atual
Estoque Base (mínimo)
Status (Normal / CRÍTICO)
Ações: Editar, Visualizar

3. Cadastrar Produto (passo a passo)

Acesse Estoque → Produtos e clique em "+ Novo" (/portal/estoque/produtos/criar).
Preencha os dados do produto (ver tabela de campos abaixo).
Defina o Estoque Base (mínimo) — é o que faz o alerta CRÍTICO funcionar.
Clique em Salvar. O produto aparece na lista com estoque inicial em zero.

3.1 Campos do produto

Campo	Descrição / validação	Obrigatório?
Nome	Nome comercial do produto	Obrigatório
Tipo de Produto	Categoria: Medicamento, Material, Equipamento, etc. Deve estar cadastrado antes.	Obrigatório
Fornecedor	Empresa fornecedora do produto	Opcional
Fabricante	Fabricante do produto	Opcional
Princípio Ativo	Para medicamentos: substância ativa	Opcional
Custo Unit. Compra	Custo de aquisição por unidade, em R$ 1.234,56	Opcional
Custo Total Compra	Custo total do lote adquirido	Opcional
Margem Compra (%)	Percentual de margem aplicado	Opcional
Margem Compra (R$)	Valor de margem em reais	Opcional
Est. Base (mínimo)	Quantidade mínima em estoque; abaixo dela o produto fica em status CRÍTICO	Obrigatório

Configure o Estoque Base: o campo Est. Base é fundamental para o Mapa de Estoque. Produtos com estoque abaixo dele aparecem como CRÍTICO nos relatórios e no Dashboard de Produtos.

4. Tipos de Produto

Categorias para classificar os produtos (/portal/estoque/produtos/tipos-produtos). Devem ser cadastradas antes dos produtos. Exemplos: Medicamento, Material de Consumo, EPI, Material de Escritório, Equipamento, Insumo para Procedimento.

5. Fornecedores

Cadastro das empresas fornecedoras (/portal/estoque/fornecedores). Passo a passo:

Acesse Estoque → Fornecedores e clique em "+ Novo".
Preencha Nome/Razão Social, CNPJ (validado), endereço com CEP, telefone, e-mail e pessoa de contato.
Salve. O fornecedor fica disponível para seleção no cadastro de produtos.

6. Fabricantes

Cadastro dos fabricantes dos produtos utilizados na clínica (/portal/estoque/fabricantes).

7. Princípios Ativos

Substâncias ativas de medicamentos (/portal/estoque/principios-ativos). Permitem identificar um medicamento pela substância mesmo quando os nomes comerciais são diferentes.

8. Depósitos

Locais físicos de armazenamento (/portal/estoque/depositos). Uma clínica pode ter vários depósitos (farmácia, almoxarifado, sala de procedimentos, etc.).

9. Movimentação de Estoque

Registra entradas, saídas, transferências e ajustes de produtos. Toda movimentação grava timestamp, responsável e motivo (rastreabilidade). A saída em atendimento pode dar baixa automática no estoque.

Ligação com o Financeiro: a compra de produtos é detalhada item-a-item pelo Registro Financeiro, que atualiza a Posição de Estoque automaticamente — entrada (RECEBIMENTO) soma quantidade; saída (PAGAMENTO/consumo) subtrai.

10. Mapa de Estoque e status CRÍTICO

O Mapa de Estoque é um relatório que mostra todos os produtos com seus saldos atuais e destaca os itens em situação crítica.

🚨 Status CRÍTICO: um produto fica CRÍTICO quando o estoque atual está abaixo do Estoque Base (mínimo) configurado. Produtos críticos devem ser repostos o quanto antes para não interromper atendimentos.

Onde encontrar o Mapa de Estoque:

Relatórios: Menu → Relatórios → Mapa de Estoque (/portal/relatorios).
Dashboard de Produtos: Dashboard → aba Produtos (/dashboard/produtos).

11. Integrações do Estoque

Integração	Descrição
📋 Prontuário → Estoque	Insumos usados em procedimentos podem dar baixa automática no estoque
💰 Financeiro → Estoque	Registro Financeiro de compra/consumo atualiza a posição de estoque
📦 Estoque → 📈 Relatórios	Mapa de Estoque: saldo atual vs. mínimo, produtos críticos
📦 Estoque → 📊 Dashboard	Dashboard de Produtos: resumo de itens abaixo do mínimo
⚙️ Configurações → 📦 Estoque	Tipos de produto, fornecedores e fabricantes ficam disponíveis no Estoque

12. Ordem de configuração na implantação

Para clínicas que usarão o estoque, siga esta ordem — os cadastros de apoio vêm antes dos produtos:

Tipos de Produto — as categorias.
Fornecedores — empresas fornecedoras.
Fabricantes — fabricantes dos produtos.
Princípios Ativos — para clínicas com medicamentos.
Depósitos — locais de armazenamento.
Produtos — cadastrar com estoque inicial e Estoque Base mínimo.

13. Permissões

Modelo atual: papel (Role) + 4 ações fixas — VIEW, CREATE, UPDATE, DELETE — no grupo ESTOQUE (produtos, fornecedores, fabricantes, depósitos, princípios ativos, movimentação).

🟠 Planejado (roadmap): permissões granulares / refactor de RBAC (#395) ainda não estão em produção. Hoje o acesso é por papel + as 4 ações fixas.

14. Erros comuns e como resolver

Situação	Causa provável	Solução
Não consigo escolher o Tipo de Produto	Tipos ainda não cadastrados	Cadastre os Tipos de Produto antes de criar o produto
Produto não aparece como CRÍTICO mesmo com pouco saldo	Est. Base (mínimo) não configurado	Edite o produto e informe o Estoque Base
Fornecedor não fica disponível no produto	Cadastro do fornecedor incompleto/não salvo	Cadastre e salve o fornecedor com CNPJ válido
Saldo de estoque não bate após compra	Movimentação/Registro Financeiro não lançado	Confirme o lançamento da entrada; ela soma na posição de estoque
Produto novo com estoque zerado	Comportamento esperado	Registre a entrada inicial via movimentação de estoque

15. Novidades de julho/2026 ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Saída de estoque vinculada ao atendimento (#406): a saída do produto passa a ser vinculada ao atendimento que a consumiu.
Saldo real / posição do item (#480): exibição do saldo real (posição) do item.
Paginações (#478/#479): paginação nas listas do módulo.
Correção da flag "Padrão Calcular" (#510): fix no comportamento da flag.

🟠 Segue roadmap (não está em produção): módulo de Compras (#393 — em desenvolvimento, Sprint 3), NF-e de fornecedor (#391 — Sprint 7) e reserva de medicamento (#363 — em desenvolvimento).

16. Pontos-chave

Cadastros de apoio (tipos, fornecedores, fabricantes, princípios ativos, depósitos) vêm antes dos produtos.
Nome, Tipo de Produto e Est. Base (mínimo) são obrigatórios; os campos de custo/margem são opcionais.
Status CRÍTICO = estoque atual abaixo do Estoque Base.
Produto novo nasce com estoque zero; o saldo sobe pela movimentação de entrada.
Entrada soma e saída subtrai na Posição de Estoque; consumo em procedimento pode dar baixa automática.
Mapa de Estoque fica em Relatórios e no Dashboard de Produtos.

17. O que a prova vai cobrar

Quais campos do produto são obrigatórios (Nome, Tipo de Produto, Est. Base).
O que define o status CRÍTICO (estoque atual abaixo do Estoque Base).
A ordem correta de cadastro na implantação (apoio antes de produtos).
Onde encontrar o Mapa de Estoque (Relatórios e Dashboard de Produtos).
Como a movimentação/Registro Financeiro atualiza a posição de estoque (entrada soma, saída subtrai).