# Produtos, aluguéis e insumos internos

O catálogo fica em **Configurações do espaço > Produtos** (`/configuracoes-espaco?tab=products`). A tela tem as abas **Produtos**, **Histórico de vendas e aluguéis** e **Insumos internos**. Produtos podem representar itens para venda ou aluguel; insumos internos registram materiais comprados e consumidos pelo espaço. As operações podem alimentar registros financeiros e alterar estoque; confira valores e vínculo antes de confirmar.

## Antes de cadastrar

1. Confirme o espaço ativo: os produtos e saldos são daquele espaço.
2. Defina se o item será **Venda**, **Aluguel** ou **Insumo de uso interno**. Essa finalidade direciona quais informações e ações aparecem.
3. Separe nome, categoria, preço/custo, quantidade inicial e limite de estoque baixo quando aplicável.
4. Não cadastre novamente um produto apenas porque ele não aparece; use busca e filtro de categoria primeiro.

## Localize um item existente

Na aba **Produtos**, pesquise em **Buscar produto...** e filtre em **Filtrar por categoria**. Na aba **Insumos internos**, use **Buscar insumo...**. A opção **Todas as categorias** remove a restrição por categoria. A lista apresenta colunas **Produto**, **Tipo**, **Estoque / Disp.**, **Valor**, **Status** e **Ações**.

Se a busca não encontrar um item, limpe o texto e a categoria. Produtos pausados podem continuar no histórico, mas deixam de estar disponíveis para novas operações conforme o status.

## Cadastrar produto ou insumo

1. Abra a aba correta (**Produtos** ou **Insumos internos**) e selecione **Adicionar produto** ou **Adicionar insumo**.
2. Preencha **Nome do produto** (obrigatório; mínimo de dois caracteres), **Descrição** (opcional) e **Categoria** (opcional; até 80 caracteres). Em **Categoria**, selecione uma opção existente ou digite uma nova.
3. Em **Finalidade**, escolha **Venda**, **Aluguel** ou **Insumo de uso interno**.
4. Para **Aluguel**, escolha **Cobrança do aluguel**: **Por hora**, **Por dia**, **Por mês** ou **Valor fixo**.
5. Informe o campo de valor obrigatório: **Preço**, **Preço por hora/dia/mês**, **Preço fixo** ou **Custo unitário de compra**, conforme a finalidade. O valor não pode ser negativo.
6. **Preço promocional** é opcional para venda/aluguel e deve ser inferior ao preço normal. Deixe vazio quando não houver promoção.
7. Defina o estoque quando aplicável e reveja **Disponível para venda**, **Disponível para aluguel** ou **Insumo ativo**.
8. A foto é opcional; selecione ou arraste uma imagem quadrada.
9. Selecione **Cadastrar produto** ou **Cadastrar insumo**. Ao editar, o botão é **Salvar alterações**.

Para venda e aluguel, **Controlar quantidade em estoque**/**Controlar disponibilidade de equipamentos** abre os campos **Quantidade atual em estoque** ou **Total de aparelhos no espaço**, e **Avisar quando restar**. Quantidades e limite de alerta aceitam inteiros não negativos. Em uso interno, o estoque é controlado e começa em zero; registre uma compra após o cadastro para adicionar unidades.

### Exemplo de cadastro

Para um equipamento de aluguel por dia, cadastre um nome que identifique o equipamento, selecione **Aluguel**, escolha **Por dia**, informe o preço e o **Total de aparelhos no espaço**. Em seguida, registre o número de série em **Observações da Operação** ao fazer o aluguel, se isso ajudar a distinguir a unidade.

## Registrar venda ou aluguel

Na lista de produtos, use a ação de venda/aluguel para abrir **Registrar venda** ou **Registrar aluguel**.

1. Selecione **Produto**.
2. Selecione **Paciente** (obrigatório). Aguarde a lista de pacientes terminar de carregar.
3. Informe **Quantidade** (mínimo 1) e **Valor Unitário Cobrado**.
4. Para aluguel por hora/dia/mês, informe também a quantidade de horas, dias ou meses apresentada pelo formulário.
5. Confira o **Total a Cobrar** calculado.
6. Selecione **Forma de Pagamento**: PIX, Cartão de Crédito, Cartão de Débito, Dinheiro, Transferência ou Outro.
7. Defina **Status da Cobrança** como **Pago agora** ou **A receber / pendente** conforme a operação real.
8. Para aluguel, **Previsão de Devolução (Opcional)** pode registrar uma data estimada. Use **Observações da Operação (Opcional)** para detalhe pertinente, por exemplo número de série.
9. Selecione **Registrar venda** ou **Registrar aluguel** e confira a mensagem de conclusão.

O sistema verifica disponibilidade do estoque. Quantidade acima do saldo não deve ser registrada; diminua a quantidade ou confira o estoque. Em aluguéis, unidades em uso ficam indisponíveis até a devolução ser registrada. Uma previsão de devolução não devolve o item automaticamente.

## Registrar compra ou utilização de insumo

Na aba **Insumos internos**, abra as ações do item:

- **Registrar compra** adiciona ao estoque e registra a saída correspondente como já paga no financeiro do espaço. Informe **Quantidade** (inteiro de 1 a 1.000.000), **Custo unitário de compra**, **Forma de pagamento** (Pix, Dinheiro, Cartão de crédito, Cartão de débito, Transferência ou Outro) e **Observações** (até 2.000 caracteres, opcional). Revise o total antes de **Registrar**.
- **Registrar utilização** reduz o estoque. Informe **Quantidade** e, se necessário, **Observações**. O custo já é atribuído à compra segundo o texto do formulário; a utilização não cria uma nova saída financeira.

Exemplo: uma caixa de luvas comprada com 10 unidades e utilizada em 2 fica com saldo menor após registrar **Quantidade** `2` em utilização. O registro da compra é separado e inclui o custo unitário e meio de pagamento efetivos.

## Devolver equipamento alugado

1. Abra **Histórico de vendas e aluguéis**.
2. Localize a linha de aluguel ainda em uso.
3. Use a ação de retorno/devolução apresentada para aquele item.
4. Confira o item e confirme **Registrar devolução**.

O histórico mostra estados do item e pagamento; a ação de devolução atualiza a disponibilidade do equipamento. Se o equipamento ainda não voltou fisicamente, não registre a devolução antecipadamente.

## Pausar, reativar ou excluir

Use as ações do catálogo para pausar ou reativar o item. **Pausado para vendas** mantém o cadastro para consulta/histórico, mas impede novas vendas conforme o fluxo. Excluir um produto sem histórico pode removê-lo; quando há histórico de movimentos, a tela informa que o registro passa a inativo para preservar os dados anteriores. Revise antes de confirmar.

## Estoque baixo e indicadores

O saldo disponível compara-se com o **low stock threshold** configurado (o padrão de apresentação pode ser três unidades quando nenhum limite específico existir). O dashboard pode apresentar **Produtos com estoque baixo** e abrir o catálogo. Em aluguel, a tela distingue quantidade total, itens em uso e unidades disponíveis; em venda, apresenta unidades disponíveis.

Não interprete uma unidade marcada como indisponível em aluguel como perda definitiva: ela pode estar em uso. Confira o histórico e registre a devolução quando o equipamento retornar.

## Perguntas frequentes e solução de problemas

### “Produto esgotado” aparece, mas eu tenho o item

Confira o saldo do espaço ativo. Para aluguel, verifique também os equipamentos **Em uso** e se devoluções anteriores foram registradas. Não tente contornar o bloqueio criando um saldo artificial.

### O insumo não aparece na aba Produtos

Insumos internos ficam na aba **Insumos internos**. Limpe busca e categoria e confirme o espaço.

### Posso alterar o preço ao registrar uma operação?

O formulário apresenta **Valor Unitário Cobrado** e calcula o total. Confira o valor da operação antes de salvar; para mudar o preço padrão, edite o produto no catálogo.

### O que ocorre ao selecionar “A receber / pendente”?

O registro mantém a cobrança com esse status e pode aparecer nas áreas financeiras aplicáveis. Para conferir, conciliar ou dar baixa no recebimento, siga o guia financeiro.

### A previsão de devolução expirou. O equipamento ficou disponível?

Não por causa da previsão. Registre a devolução depois do retorno real.

### Por que não consigo remover um produto?

Se houver vendas, aluguéis, compras ou outras movimentações, o histórico pode exigir que o item seja desativado em vez de apagado. Use **Pausar para vendas** se esse for o objetivo.

### Uma compra foi registrada incorretamente. Posso apagar o histórico?

Não use exclusão do catálogo para corrigir uma movimentação. Revise o registro na área financeira/estoque autorizada ou peça ajuda ao suporte e informe o produto, a data e o que precisa ser corrigido.

## Veja na tela

### Catálogo de produtos

![Produtos fictícios do espaço demonstrativo.](https://sysfisio-central-ajuda.vercel.app/ajuda/imagens/produtos-catalogo.anotada.svg)

1. Use Adicionar produto para abrir o cadastro; as abas separam produtos, histórico de vendas e insumos internos.
2. Filtre por categoria ou pesquise pelo nome para localizar itens rapidamente.
3. Confira a lista com tipo, valor e status; use o menu de ações ou Vender para registrar movimentações.

### Cadastro de produto

![Formulário vazio, fechado sem salvar um produto.](https://sysfisio-central-ajuda.vercel.app/ajuda/imagens/produtos-cadastro.anotada.svg)

1. Preencha a identificação do produto, incluindo foto opcional, nome e descrição.
2. Defina categoria, finalidade (Venda, Aluguel ou Insumo) e o preço correspondente.
3. Ative o controle de quantidade em estoque para acompanhar saldos e receber alertas de reposição.
4. Selecione Cadastrar produto para salvar o item no catálogo do espaço.
