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 mínimo (configurado na aba Estoque do produto)
- 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) — os obrigatórios são Nome, Tipo de Código, Tipo Produto, Código Produto, Localização padrão, Fabricante, Apresentação, Contendo, Unidade De Medida e CD.
- Clique em Salvar. O produto aparece na lista com estoque inicial em zero.
- Depois de salvo, abra a aba Estoque do produto e informe o Estoque mínimo — é o que faz o alerta CRÍTICO funcionar (opcional, mas recomendado).
3.1 Campos do produto ✅ Corrigido — 30/09/2026
| Campo | Descrição / validação | Obrigatório? |
|---|---|---|
| Nome | Nome comercial do produto | Obrigatório |
| Tipo de Código | Tabela do código do item (ex.: Brasíndice, SIMPRO, própria) | Obrigatório |
| Tipo Produto | Categoria: Medicamento, Material, Equipamento, etc. Deve estar cadastrado antes. | Obrigatório |
| Código Produto | Código do produto na tabela escolhida. ✅ Novo — 02/10/2026 até 10 caracteres — letras, números, ponto, hífen ou barra (padrão TISS) | Obrigatório |
| Código EAN / Código NCM | Código de barras e classificação fiscal. ✅ Novo — 02/10/2026 EAN em texto com 8, 12, 13 ou 14 dígitos (o zero à esquerda é preservado); NCM com exatamente 8 dígitos (NCM antigo que perdeu o zero foi completado) | Opcional |
| Localização padrão | Onde o produto fica guardado (local do depósito) — por isso o depósito mínimo vem antes na implantação | Obrigatório |
| Princípio Ativo | Para medicamentos: substância ativa | Opcional |
| Fabricante | Fabricante do produto — cadastre os fabricantes antes (Estoque › Fabricantes) | Obrigatório |
| Fornecedores | Um ou mais fornecedores; a busca lista todos os fornecedores ativos (desde 30/09/2026) | Opcional |
| Apresentação | Embalagem (ex.: caixa, frasco) | Obrigatório |
| Contendo | Quantidade dentro da embalagem | Obrigatório |
| Preço / Data da última pesquisa | Referência de preço de compra | Opcional |
| Unidade De Medida | Unidade de controle do estoque | Obrigatório |
| CD | Campo obrigatório da tela | Obrigatório |
| Tabela 87 | Referência do código do item (terminologias unificadas da saúde) | Opcional |
| Estoque pode negativar | Permite saída sem saldo | Opcional |
| Lista da Portaria 344/98 ✅ Novo — 23/10/2026 | Bloco "Controle e receita (opcional)" da aba Dados do Produto: Não controlado, A1 … C5. É a classificação que faz o atendimento sugerir o tipo de receita (Controle Especial, Notificações). Ver Receitas e SNCR. | Opcional |
| Sujeito a retenção de receita ✅ Novo — 23/10/2026 | Sim/Não — antimicrobianos e agonistas GLP-1 (ex.: Ozempic, Mounjaro): geram a Receita de Retenção (RET). | Opcional |
| Concentração / Forma farmacêutica ✅ Novo — 23/10/2026 | Saem na receita; aproveite para preencher junto com a classificação. | Opcional |
3.1.1 Aba Estoque do produto (depois de salvar) ✅ Corrigido — 30/09/2026
Com o produto salvo, abra a aba Estoque dele. Ali ficam: Estoque mínimo, Estoque máximo, Estoque ideal, Aviso de validade, Preço de venda tabela, Fonte de Preço, Fator K/inflator/deflator e Tempo de entrega após compra (dias). Cada campo grava ao sair dele e nenhum é obrigatório.
Configure o Estoque mínimo: o Estoque mínimo (aba Estoque do produto) é fundamental para o Mapa de Estoque. Produtos com saldo abaixo dele aparecem como CRÍTICO nos relatórios e no Dashboard de Produtos. Não é obrigatório, mas configure-o na etapa de entradas de estoque.
Correção 30/09/2026 (conferido na tela em produção): versões anteriores desta lição listavam "Est. Base (mínimo)" como campo obrigatório do cadastro e traziam "Custo Unit. Compra", "Custo Total Compra" e "Margem Compra (%)/(R$)" — esses campos não existem no formulário do produto. O mínimo fica na aba Estoque (opcional) e o custo vem das entradas de estoque/aba Estoque.
Correção 30/09/2026 (conferido na tela em produção): versões anteriores desta lição listavam "Est. Base (mínimo)" como campo obrigatório do cadastro e traziam "Custo Unit. Compra", "Custo Total Compra" e "Margem Compra (%)/(R$)" — esses campos não existem no formulário do produto. O mínimo fica na aba Estoque (opcional) e o custo vem das entradas de estoque/aba Estoque.
Na API externa, POST /produtos exige nome, codigoProduto, apresentacao, contendo, depositoId, tipoProdutoId, fabricanteId, unidadeDeMedidaId e prazoDeReposicao — cadastre fabricantes e o depósito mínimo antes.
3.2 Excluir ou inativar um produto ✅ Novo — 26/09/2026
✅ Atualização 13/10: o bloqueio está em produção desde 02/10/2026 (#626). Excluir (ou inativar) um produto em Estoque › Produtos — ou uma taxa em Configurações › Taxas — que está na composição de serviço ativo: nada é excluído e abre "Não é possível excluir" ("Este produto está em uso em N serviço(s) e não pode ser excluído. Corrija a composição dos serviços abaixo (substitua por outro item ou retire-o) e tente de novo."), com a tabela Serviço / Código / Quantidade e o link para cada serviço. Serviços inativos aparecem em "Também aparece em serviços inativos (não impede a exclusão)". Corrigida a composição, a exclusão passa na hora; item sem uso exclui como antes. Na API, erro 409
ITEM_EM_USO_EM_SERVICOS. O quadro abaixo descreve como era até 01/10.
⚠️ Como era até 01/10/2026 (superado): até 01/10 a exclusão era livre — se o produto estivesse na composição de algum serviço, ele sumia da composição sem aviso e o serviço passava a ser agendado e faturado sem aquela receita — o material saía da guia e do custo (o mesmo valia para taxas). A orientação da época era conferir antes, em quais serviços o item estava — expandindo o serviço no convênio (#625) ou pela aba Farol › Itens.
✅ Novo — 02/10/2026 O bloqueio (#626) entrou em produção em 02/10: a exclusão/inativação de produto e taxa que estejam na composição de serviço ativo é recusada, com a lista de serviços e link — na tela e na API (erro 409) — ver o quadro acima.
✅ Novo — 02/10/2026 O bloqueio (#626) entrou em produção em 02/10: a exclusão/inativação de produto e taxa que estejam na composição de serviço ativo é recusada, com a lista de serviços e link — na tela e na API (erro 409) — ver o quadro acima.
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.
✅ Novo — 23/10/2026 Atalho para a receita: o princípio ativo tem as colunas "Portaria 344" e "Retenção de receita". O que ficar em branco no produto é herdado do princípio ativo — classificar a substância uma vez cobre todos os produtos dela.
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.).
✅ Novo — set/2026 🚨 Depósito mínimo vem no INÍCIO da implantação (corrigido em 24/09/2026): todo local (consultório, sala) exige um depósito padrão de saída ativo — sem ele o local não é salvo (na API, erro 422). Por isso, crie um depósito mínimo por unidade logo depois da empresa, antes dos locais, mesmo que a clínica ainda não vá usar o estoque. Os demais depósitos e as entradas de estoque continuam para depois. Um depósito inativo não serve como depósito padrão.
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 saldo atual está igual ou abaixo do Estoque mínimo configurado na aba Estoque do produto. 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).
✅ Novo — set/2026 Nos relatórios Mapa de Estoque e Quantidade de Estoque, a coluna "Estoque Base" foi RENOMEADA para "Estoque Atual" — só o nome mudou, o cálculo é o mesmo. A janela do Mapa de Estoque foi ampliada de 30 para 180 dias, e os relatórios de estoque ganharam o filtro "Tipo de Produto". No produto, o mínimo é o campo Estoque mínimo da aba Estoque (correção 30/09/2026: não existe campo "Est. Base" no cadastro). Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
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
O estoque aparece em três momentos da ordem oficial de implantação ✅ corrigida em 24/09/2026 (Empresa → Depósito mínimo → Locais → Operadoras/Fornecedores/Fabricantes → Taxas → Produtos → Equipamentos → Serviços → Colaboradores → Convênios → Farol → Financeiro/Estoque → Pacientes → Parâmetros e Permissões):
- Depósito mínimo — logo após a empresa, antes dos locais: um por unidade (o local exige depósito padrão de saída ativo).
- Fornecedores e Fabricantes — junto com as operadoras (o produto exige fabricante).
- Catálogo de produtos — antes dos serviços (serviço de medicamento aponta para o produto), respeitando os apoios: Tipos de Produto → Princípios Ativos → Produtos (com os fabricantes e o depósito mínimo já cadastrados; o Estoque mínimo, na aba Estoque, é opcional e pode ficar para a etapa de entradas).
- Depois do Farol, na etapa Financeiro/Estoque: demais depósitos, entradas de estoque (saldo inicial), custos e o Estoque mínimo de cada produto (aba Estoque).
A regra de sempre continua valendo: os cadastros de apoio vêm antes dos produtos. Ver a ordem completa na lição de Configurações.
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). ✅ Novo — 23/10/2026 Na tela redesenhada (15–16/10/2026) os níveis aparecem como Sem Permissão / Visualizar / Criar / Editar / Total, com busca.
🟢 ENTREGUE (set/2026) ✅ Novo — set/2026: as permissões granulares (#395) entraram em produção em 15/09 — permissões finas por funcionalidade/ação, além dos 4 níveis por módulo. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
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 | Estoque mínimo não configurado | Abra o produto, vá à aba Estoque e informe o Estoque mínimo |
| Fornecedor não fica disponível no produto | Cadastro do fornecedor incompleto/não salvo ou fornecedor inativo (até 29/09/2026 a busca mostrava só os 10 primeiros — corrigido) | Cadastre e salve o fornecedor com CNPJ válido e ativo; a busca lista todos os fornecedores ativos |
| Entrada feita pela NF de compra ficou sem lote, com validade estranha ou quantidade em caixa | Limitações atuais da importação de NF (#391): lote não preenchido, validade padrão, quantidade como está na nota | Corrija lote/validade no estoque e confira a unidade (caixa × unidade); as melhorias são o #629 (roadmap). ✅ Atualização 13/10: desde 09/10 a conferência antes de confirmar traz lote, validade e fator de conversão — vale para notas novas; as já confirmadas antes continuam como entraram. |
| 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 |
| Depois de excluir um produto, um serviço passou a sair sem o material na guia (e mais barato) | Hoje a exclusão é livre: o produto saiu da composição do serviço sem aviso (bloqueio = #626, roadmap) — ✅ Atualização 13/10: só até 01/10; desde 02/10 a exclusão de item em uso é bloqueada | Recoloque o produto (ou um substituto) na composição do serviço; antes de excluir, sempre confira onde o item está |
| "Não é possível excluir" ao excluir/inativar produto ou taxa ✅ Novo — 02/10/2026 | O item está na composição de serviço ativo (#626) | Abra cada serviço pelo link da lista, substitua ou retire o item e tente de novo |
| "Código EAN deve ter 8, 12, 13 ou 14 dígitos numéricos." / "Código NCM deve ter exatamente 8 dígitos numéricos." / "Código do produto deve ter até 10 caracteres…" ✅ Novo — 02/10/2026 | Código fora do padrão (#635) | Corrija o código. Valor antigo fora do padrão não trava a edição dos outros campos |
| Não consigo excluir ou inativar um fornecedor ✅ Novo — 12/10/2026 | Ele está em uso como credor de custo extra ou prestador ativo de convênio (#655) | Inative o custo extra/prestador no convênio antes |
| "Limite de 200 XMLs por importação excedido." / "O arquivo … passa de 2 MB descompactado." / "Os XMLs enviados passam de 50 MB descompactados." ✅ Novo — 15/10/2026 | ZIP de NF-e acima dos limites (desde 13/10) | Divida o ZIP em partes menores |
| Não acho onde importar os preços da referência oficial (SIMPRO/Brasíndice) ✅ Novo — 15/10/2026 | A importação por planilha foi retirada da tela em 15/10 (#662, 1ª fase) | Cadastre códigos/descrições na aba Referências oficiais do produto; para a carga de preços, fale com o time Rabi |
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.
15.1. Novidades de agosto/2026 ✅ Novo — ago/2026
Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- MÓDULO COMPRAS E PEDIDOS (#393) — ENTREGUE (1ª versão): pedidos de compra, envio ao fornecedor e permissão própria. Saiu do roadmap.
- Previsão de estoque no agendamento (#521): o sistema mostra a previsão de estoque disponível na data do agendamento, por item.
- Correções de saldo em produção (11–12/08): fragmentação de validade no saldo, saída em depósito inativo bloqueada e checagem de saldo por horário.
- Zerar estoques negativos (#575) — ENTREGUE (13/08): saldos negativos são zerados; saiu de "em andamento".
- Correção do "depósito fantasma" (#576) — 13/08: corrigido o cálculo de movimentações que considerava depósito inexistente.
- Compras: ajustes e melhorias no módulo (#589) — 21/08.
- RESERVA DE MEDICAMENTO (#363) — ENTREGUE (28/08): era o último item do estoque "em desenvolvimento"; saiu do roadmap. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Compras: mais melhorias no módulo (#590) — 26/08.
15.2. Novidades de setembro/2026 ✅ Novo — set/2026
Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- "Necessidade de Compra" com estoque REAL: o cálculo da Necessidade de Compra passou a usar o estoque real (não mais projeção) — fim das duplicidades e de itens que ficavam presos na lista mesmo fora de ruptura.
- Tela Necessidades de Compra otimizada (#610): a tela estava lenta e foi otimizada — o carregamento agora é mais rápido (fechamento da Sprint 10, 17–18/09).
- Editar pedido de compra criado: agora é possível adicionar e remover itens de um pedido de compra já criado, sem precisar cancelar e refazer o pedido.
- Aprovação de compra na Central de Notificações: as aprovações de compra passam a aparecer na Central de Notificações de quem tem alçada para aprovar.
- Pré-faturamento não baixa mais o estoque: mudança de regra — gerar o pré-faturamento deixou de sensibilizar o saldo; o estoque só se movimenta pelo consumo real (ver lição de Faturamento).
- Relatórios de estoque: coluna "Estoque Base" renomeada para "Estoque Atual" (Mapa de Estoque e Quantidade de Estoque — só nome, mesmo cálculo), novo filtro "Tipo de Produto", nova visão "Pacientes em Uso" no Consumo de Estoque — Atendimento (filtro por paciente) e janela do Mapa de Estoque ampliada para 180 dias (ver lição de Relatórios).
- NF-e de fornecedor ENTREGUE (#391): importe o XML da nota do fornecedor e, ao confirmar o recebimento, o sistema dá entrada no estoque e cria a conta a pagar — com limitações atuais (lote, validade, parcelas e total da nota) que exigem conferência. Ver seção 15.3. ✅ Atualização 13/10: as limitações foram superadas pelo #629 em 09/10.
- Correção na transferência de estoque (#595): corrigido o comportamento da transferência entre depósitos (✅ entregue na Sprint 9).
- Depósito inativo não bloqueia mais a conclusão do atendimento (correção em produção 23–24/09/2026): a conclusão do atendimento deixou de ser barrada por depósito inativo. Mesmo assim, mantenha ativo o depósito padrão de saída de cada local.
15.2.1. Correção de 29–30/09/2026 ✅ Novo — 30/09/2026
- Busca de fornecedor completa: no cadastro do produto e na entrada de estoque, a busca de fornecedor agora lista todos os fornecedores ativos — antes só os 10 primeiros apareciam.
15.3. Notas Fiscais de Entrada — importar o XML da compra (#391) ✅ Novo — 29/09/2026
Em produção desde 08/09/2026, em Compras › Notas Fiscais de Entrada (/portal/compras/nf-fornecedor). O sistema lê a nota, confere e, na confirmação, dá entrada no estoque e cria a conta a pagar.
- Abra Compras › Notas Fiscais de Entrada e importe um ou vários arquivos XML.
- Compra sem pedido no sistema: marque Compra avulsa (sem pedido de compra) e escreva a justificativa.
- Abra a nota e confira os itens. Item sem produto: busque e escolha o produto do cadastro — o sistema guarda a ligação para as próximas notas do mesmo fornecedor.
- Item com quantidade divergente, valor divergente ou não previsto no pedido precisa da aprovação de um responsável.
- Clique em Confirmar Recebimento e informe depósito, motivo e categoria de pagamento. O sistema dá entrada no estoque, cria a conta a pagar, anexa o XML e o resumo, atualiza o pedido de compra e avisa o financeiro.
Avisos: nota já importada (mostra quando e quem), assinatura digital inválida (nota recusada), nenhum fornecedor com o CNPJ (cadastre o fornecedor ou use compra avulsa com justificativa), itens sem produto mapeado, itens aguardando aprovação. Situações da nota: Recebida, Conciliada, Divergente, Confirmada e Rejeitada — e, desde 09/10 (#629), Estornada (recebimento estornado; ver abaixo).
⚠️ Limitações que valiam até 08/10/2026 (superadas pelo #629 — ver o quadro verde abaixo):
- O lote não é preenchido na entrada do estoque.
- A validade entra com uma data padrão, não a da nota — corrija no estoque.
- A conta a pagar nasce sem parcelas e sem vencimento da nota — ajuste no financeiro.
- O total da conta a pagar considera só os produtos — frete, impostos e desconto não entram.
- A quantidade entra como está na nota — produto comprado em caixa e controlado por unidade precisa de conferência.
- Não há como desfazer pela tela um recebimento já confirmado.
✅ Atualização 13/10: as melhorias (#629) estão em produção desde 09/10/2026.
- Conferência antes de confirmar: o diálogo de confirmação mostra a prévia com lote, validade e quantidade por lote (dá para adicionar/remover lote), o fator de conversão (o informado vira padrão daquele fornecedor + código), o depósito por item ("Depósito padrão da nota"), "Motivo da entrada", "Categoria de pagamento", "Forma de pagamento" ("Sugerida pelo XML") e as parcelas das duplicatas do XML, editáveis. Validade que não veio no XML aparece como "Não veio no XML — confira". Os chips Total da nota / Entradas no estoque / Parcelas ficam verdes quando fecham, e o botão "Confirmar recebimento" só libera quando os totais fecham.
- Lote e validade lidos da nota (uma entrada por lote); caixa/pacote entra como caixa; custo do item = produto + frete + seguro + outras + IPI + ST + FCP-ST + II − desconto; a conta a pagar fecha com o valor total da nota, em parcelas.
- Tudo numa transação; nota que não é venda autorizada é recusada; o destinatário precisa ser empresa cadastrada — senão aparece a opção "Conferi e a nota é desta clínica: importar mesmo assim."
- Estornar recebimento (novo status ESTORNADA): com "Motivo do estorno", exige a ação CANCELAR em NOTAS FISCAIS DE ENTRADA (ou admin); baixa as entradas e inativa a conta a pagar; bloqueado se o lote já foi consumido/transferido, há reserva de paciente ou a conta já tem pagamento.
- Situações da nota: Recebida, Conciliada, Divergente, Confirmada, Rejeitada e Estornada. A nota confirmada mostra os links da conta a pagar e das entradas por lote.
Referências oficiais de produto (#662) — SIMPRO, Brasíndice, CMED, TUSS e TGA, com aba no produto e nível 2 no Farol: Sprint 14, ainda não está em produção ✅ Atualização 15/10: 1ª fase em produção desde 15/10 — ver a seção 15.4. ✅ Novo — out/2026 Também em outubro: campos Princípio Ativo, Tabela 87, Fabricante e Data da última pesquisa podem ser limpos (antes o valor voltava); selects obrigatórios mostram "Campo obrigatório"; o Fator K carrega com vírgula (10,5 não vira 105); a Tabela de Preços Internos ganhou filtros por coluna e ordenação; se outra pessoa alterou o produto, fornecedor ou kit depois que a sua tela abriu, aparece "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." (#640).
15.4. Referências oficiais de produto (#662) — 1ª fase ✅ Novo — 15/10/2026
Em produção desde 15/10/2026 (a issue segue aberta). Três lugares:
- Estoque › "Referências oficiais" (menu novo, permissão PRODUTOS): "Códigos, descrições e preços dos produtos nas publicações oficiais (SIMPRO, BRASÍNDICE, CMED, TUSS e outras)". Abas Visão geral, Códigos dos produtos, Preços da publicação / Preços vigentes, Políticas dos convênios e Publicações (edições com vigência); filtros "Sem preço vigente" / sem código; Exportar.
- Estoque › Produtos › aba "Referências oficiais": o código do produto em cada publicação — Código na publicação, Descrição oficial, Unidade na publicação (ex.: "CX com 20 AMP"), Fator de conversão (preço unitário = preço publicado ÷ fator), principal e Atualização automática —, os preços vigentes com "Histórico de preços" e os botões "Adicionar código", "Remover código" (sai ao salvar; dá para "Desfazer remoção") e "Salvar referências". Sem permissão de alterar produto, tudo fica bloqueado.
- Convênio › Dados do convênio: a política por tipo de produto (publicação do código e do preço, tipo de preço PF/PMC, ICMS, ajuste %, tabela 87) — ver a lição de Configurações.
⚠️ O que ainda não dá para fazer: a importação (códigos, preços, políticas) e o "Baixar modelo" foram retirados da tela em 15/10 — as editoras não entregam no modelo do Rabi. O preço não se digita na aba do produto: vem só da importação. Ou seja, a carga de preços pela tela ainda está indisponível — confirme com o time Rabi antes de contar com o preço do nível 2. Não há importação automática de arquivo de editora.
Regra do nível 2 (entre o item do convênio e a política de preço/cadastro): código = item do convênio › código principal da publicação da política › cadastro; descrição = item › descrição oficial (se marcada) › cadastro; preço = valor do item › preço da edição vigente ÷ fator × (1 + ajuste %) (o Fator K do item substitui o ajuste) › política de preço › cadastro. Sem política de referência no convênio, nada muda. Vale no Farol, orçamento, autorização, atendimento, pré-faturamento, guia e XML.
✅ Novo — 15/10/2026 NF-e de fornecedor em lote (ZIP, #663 — desde 13/10): até 200 XMLs por importação, até 2 MB por XML descompactado e até 50 MB no total.
15.5. Novidades de 15–23/10/2026 ✅ Novo — 23/10/2026
- Classificação para receitas (22/10): "Lista da Portaria 344/98" e "Sujeito a retenção de receita" no produto (aba Dados do Produto) e no princípio ativo (herança). Sem classificação, o atendimento não sugere o tipo de receita controlada.
- Depósito inativo não movimenta: aparece com a linha "Inativo" e não aceita entrada nem saída.
- Movimentações do produto mostram todas as entradas.
- Dica na tela: "Última Compra (Unidade)" é o custo usado no Farol.
- NF de fornecedor importa XML sem o protocolo da SEFAZ.
- No atendimento, a quantidade do produto não volta mais ao valor antigo ao salvar.
- Relatórios › Pareto (21/10): análises Compras por produto e Consumo de estoque (Curva ABC) — ver a lição de Relatórios.
15.5.1. Movimentações de Estoque do produto com Paciente (23/10/2026) ✅ Novo — 26/10/2026
Em Estoque › Produtos › (produto) › aba Estoque › Movimentações de Estoque:
- Coluna nova Paciente — aparece nas saídas por atendimento e nos estornos.
- Paginação, filtros e ordenação feitos no servidor (a lista abre rápido mesmo com muitas movimentações).
- Filtro Data por dia; filtro Motivo passa a incluir os motivos de entrada.
- A lupa busca por responsável, motivo, lote, nota fiscal ou paciente.
- No detalhe (ícone de olho): Paciente e Atendimento ("Nº 123 — dd/mm/aaaa"), com link que abre o atendimento.
A tela Estoque › Movimentação continua com a lista completa de todos os produtos.
16. Pontos-chave
- Cadastros de apoio (tipos, fornecedores, fabricantes, princípios ativos, depósitos) vêm antes dos produtos.
- Na implantação (ordem corrigida em 24/09/2026): depósito mínimo por unidade logo após a empresa, antes dos locais (local exige depósito padrão de saída ativo) e catálogo de produtos antes dos serviços; entradas de estoque ficam para a etapa Financeiro/Estoque.
- Obrigatórios do cadastro: Nome, Tipo de Código, Tipo Produto, Código Produto, Localização padrão, Fabricante, Apresentação, Contendo, Unidade De Medida e CD. Custo e margem não são campos do cadastro.
- Status CRÍTICO = saldo abaixo do Estoque mínimo (aba Estoque do produto, opcional — sem ele o alerta não funciona).
- 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.
- ✅ Novo — 02/10/2026 Produto ou taxa em uso não é excluído (#626): na composição de serviço ativo, o sistema bloqueia e lista os serviços com link — substitua ou retire o item antes. (Até 01/10 a exclusão era livre.)
- Novidades de ago/2026: módulo Compras e Pedidos (#393) entregue em 1ª versão (com melhorias #589/#590), previsão de estoque no agendamento (#521), zerar estoques negativos (#575), correção do "depósito fantasma" (#576) e reserva de medicamento (#363) entregue em 28/08.
- Novidades de set/2026: Necessidade de Compra com estoque real (fim de duplicidades e itens presos), edição de pedido de compra criado (adicionar/remover item), aprovação de compra na Central de Notificações, pré-faturamento não baixa mais o estoque e, nos relatórios, coluna renomeada para "Estoque Atual" + filtro Tipo de Produto + visão Pacientes em Uso + janela de 180 dias. E mais: importação de NF de fornecedor (#391) ENTREGUE — o XML do fornecedor carrega estoque + contas a pagar — e correção da transferência de estoque (#595, ✅ corrigido na Sprint 9).
- ✅ Novo — 09/10/2026 NF de entrada com conferência (#629): lote, validade, fator de conversão e parcelas conferidos antes do "Confirmar recebimento" (só libera quando os totais fecham); conta a pagar com o total da nota; Estornar recebimento (status ESTORNADA). Códigos do produto: código até 10 caracteres, EAN 8/12/13/14 dígitos, NCM 8 dígitos (#635).
- ✅ Novo — 23/10/2026 Medicamento controlado: classifique em "Lista da Portaria 344/98" e "Sujeito a retenção de receita" (no produto ou no princípio ativo, que é herdado) — é isso que faz o atendimento sugerir o tipo de receita certo. Depósito inativo não movimenta.
- ✅ Novo — 26/10/2026 Movimentações de Estoque do produto (aba Estoque, 23/10): coluna Paciente nas saídas por atendimento e estornos; filtro Data por dia; Motivo com motivos de entrada; lupa por responsável, motivo, lote, nota fiscal ou paciente; detalhe com link para o atendimento.
- ✅ Novo — 15/10/2026 Referências oficiais (#662, 1ª fase, desde 15/10): menu Estoque › Referências oficiais, aba no produto (código, descrição oficial, fator de conversão) e política por tipo de produto no convênio (nível 2 da conversão). A carga de preços pela tela ainda está indisponível (importação escondida em 15/10) — confirme com o time Rabi. ZIP de NF-e: até 200 XMLs.
17. O que a prova vai cobrar
- Quais campos do produto são obrigatórios (Nome, Tipo de Código, Tipo Produto, Código Produto, Localização padrão, Fabricante, Apresentação, Contendo, Unidade De Medida e CD).
- O que define o status CRÍTICO (saldo igual ou abaixo do Estoque mínimo da aba Estoque do produto).
- A ordem correta de cadastro na implantação (apoio antes de produtos) — e que o depósito mínimo vem logo após a empresa, antes dos locais.
- 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).
- O pré-faturamento NÃO baixa mais o estoque (set/2026) — a baixa acontece no consumo do atendimento, não na geração da guia.
- A coluna "Estoque Atual" nos relatórios (renomeada em set/2026) — o mínimo do produto é o Estoque mínimo, na aba Estoque (não há campo "Est. Base" no cadastro).
- ✅ Novo — 02/10/2026 Que produto ou taxa na composição de serviço ativo não pode ser excluído nem inativado (#626) e como resolver (corrigir a composição pelos links da lista).
- O fluxo da Nota Fiscal de Entrada (importar XML → conferir/ligar itens → aprovar divergências → Confirmar Recebimento) e a conferência antes de confirmar (✅ Atualização 13/10: lote, validade, fator, depósito e parcelas; o recebimento pode ser estornado).
- ✅ Novo — 23/10/2026 Onde se classifica um medicamento para a receita (Portaria 344/98 e retenção, no produto ou no princípio ativo) e o que acontece se ficar em branco.
- ✅ Novo — 26/10/2026 Onde descobrir qual paciente consumiu um produto (aba Estoque do produto › Movimentações de Estoque › coluna Paciente / detalhe com link para o atendimento).
- ✅ Novo — 15/10/2026 O que são as referências oficiais (#662): onde ficam (menu, aba do produto, política no convênio), o fator de conversão (preço unitário = preço publicado ÷ fator), que sem política no convênio nada muda e que a carga de preços pela tela ainda não está disponível.