📦 Novo produto

Cadastra o produto com tipo, código, fabricante e, depois de salvar, custo, preço e estoque mínimo na aba Estoque.

Dúvidas comuns desta tela — toque numa pergunta e a Helô responde:

Cadastrar produto

Do manual: abrir esta parte no manual completo ›

Para adicionar um novo produto ao estoque:

  1. Acessar

    Menu → Estoque → Produtos → "+ Novo"
    URL: http://app.rabisistemas.com.br/portal/estoque/produtos/criar

  2. Preencher os dados do produto
    CampoDescriçãoObrig.?
    NomeNome comercial do produtoObrigatório
    Tipo de CódigoTabela do código do item (ex.: Brasíndice, SIMPRO, própria) — ver Tabela 87 abaixoObrigatório
    Tipo ProdutoCategoria: Medicamento, Material, etc. — cadastre os tipos antesObrigatório
    Código ProdutoCódigo do produto na tabela escolhida — até 10 caracteres: letras, números, ponto, hífen ou barra (padrão TISS)Obrigatório
    Código EAN / Código NCMCódigo de barras (EAN com 8, 12, 13 ou 14 dígitos) e classificação fiscal (NCM com exatamente 8 dígitos) — ver Códigos do produtoOpcional
    Localização padrãoOnde o produto fica guardado (local do depósito) — por isso o depósito mínimo vem antes na implantaçãoObrigatório
    Princípio AtivoPara medicamentos: substância ativaOpcional
    FabricanteFabricante do produto — cadastre os fabricantes antes (Estoque › Fabricantes)Obrigatório
    FornecedoresUm ou mais fornecedores. A busca lista todos os fornecedores ativos (corrigido em 30/09/2026 — antes só apareciam os 10 primeiros)Opcional
    ApresentaçãoEmbalagem (ex.: caixa, frasco)Obrigatório
    ContendoQuantidade dentro da embalagemObrigatório
    Preço / Data da última pesquisaReferência de preço de compraOpcional
    Unidade De MedidaUnidade de controle do estoqueObrigatório
    CDCampo obrigatório da telaObrigatório
    Tabela 87Relação das terminologias unificadas da saúde (referência do código do item)Opcional
    Estoque pode negativarPermite saída sem saldoOpcional
  3. Salvar

    Clique em Salvar. O produto aparece na lista com estoque inicial em zero. Depois, na aba Estoque do produto, configure Estoque mínimo, Estoque máximo, Estoque ideal, Aviso de validade, Preço de venda tabela, Fonte de Preço, Fator K e Tempo de entrega (cada campo grava ao sair dele; nenhum é obrigatório).

ℹ️ Obrigatórios reais do produto ✅ Corrigido — 24/09/2026

Correção 30/09/2026 (conferido na tela em produção): a tabela acima traz os campos reais do formulário; o antigo "Est. Base (mínimo)" não é campo do cadastro — o mínimo fica na aba Estoque do produto (Estoque mínimo) e é opcional; custos e margens também não fazem parte do cadastro. O produto exige Tipo de Produto, Fabricante e a Localização padrão (do depósito) — por isso fabricantes e o depósito mínimo vêm antes dos produtos na implantação (o manual antigo marcava Fabricante como opcional e não citava o depósito). Pela API externa, POST /produtos exige: nome, codigoProduto, apresentacao, contendo (quantidade na embalagem), depositoId, tipoProdutoId, fabricanteId, unidadeDeMedidaId e prazoDeReposicao (em dias). O Estoque mínimo não é exigido nem pela tela nem pela API e pode ser ajustado depois.

Códigos do produto: Código, EAN e NCM ✅ Novo — 02/10/2026

Em produção desde 02/10/2026 (#635):

CampoRegraMensagem se estiver fora
Código ProdutoAté 10 caracteres: letras, números, ponto, hífen ou barra (padrão TISS)"Código do produto deve ter até 10 caracteres (letras, números, ponto, hífen ou barra)."
Código EANTexto com 8, 12, 13 ou 14 dígitos — o zero à esquerda é preservado"Código EAN deve ter 8, 12, 13 ou 14 dígitos numéricos."
Código NCMExatamente 8 dígitos (NCM antigo que tinha perdido o zero foi completado)"Código NCM deve ter exatamente 8 dígitos numéricos."
Data da última pesquisaData válida (pode ser apagada)"Data da última pesquisa inválida."
⚠️ Configure o Estoque mínimo

O Estoque mínimo (aba Estoque do produto) é fundamental para o Mapa de Estoque e a Necessidade de Compra funcionarem bem: produtos no mínimo ou abaixo dele aparecem como CRÍTICO nos relatórios e no Dashboard. Não é obrigatório, mas configure na fase de entradas de estoque.

💰 Como o Rabi chega ao preço? O valor cadastrado aqui na aba Estoque é o preço "de casa" do produto — a cadeia completa de preço do produto (com Fator K e a conversão por convênio) está no Guia do Implantador da nova área Preços e Conversão de Valores.

Referências oficiais de produto (SIMPRO, Brasíndice, CMED, TUSS…) — 1ª fase ✅ Novo — 15/10/2026

Em produção desde 15/10/2026 (#662, issue ainda aberta). Guarda o código, a descrição oficial e o preço de cada produto nas publicações oficiais, e deixa o convênio usar essas referências — é o nível 2 da conversão de valores, entre o item do convênio e a política de preço/cadastro (ver Preços e Conversão de Valores).

⚠️ 1ª fase — carga de preços pela tela ainda indisponível

A importação por planilha (códigos, preços, políticas) e o "Baixar modelo" foram retirados da tela em 15/10, porque as editoras não entregam no modelo do Rabi; voltam quando existir a leitura do arquivo de cada editora. Como o preço não se digita na aba do produto, hoje não há como carregar o preço do nível 2 pela tela — confirme com o time Rabi antes de contar com ele. Códigos e descrições oficiais por produto e a política por convênio já podem ser cadastrados. Sem política de referência no convênio, nada muda no cálculo.

O queOrdem de prioridade (o primeiro que existir vale)
CódigoItem do convênio › código principal da publicação da política › fonte de preço/cadastro
DescriçãoItem do convênio › descrição oficial (se marcado na política) › cadastro
PreçoValor do item/fonte própria 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. Arredondado ao centavo.

O nível 2 vale no Farol, no orçamento, na autorização, no atendimento, no pré-faturamento, na guia e no XML. Atenção: o XML descarta itens das tabelas 05 e 12 — na política, use a Tabela 87 20 (medicamentos) ou 19 (materiais).

Excluir ou inativar produto em uso — bloqueado ✅ Novo — 02/10/2026

🔒 Produto e taxa em uso por serviço não podem ser excluídos (#626)

Desde 02/10/2026, ao excluir ou inativar um produto em Estoque › Produtos (ou uma taxa em Configurações › Taxas) que está na composição de algum serviço ativo, nada é excluído: 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 (abre em nova aba).

  • 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. Produto sem uso é excluído como antes.
  • Pela API externa, a mesma trava responde 409 ITEM_EM_USO_EM_SERVICOS com a lista; há a consulta GET /produtos/{id}/uso-em-servicos.

Até 01/10/2026 a exclusão era livre e o item sumia da composição sem aviso. Se algum produto foi excluído antes disso, confira os serviços em que ele estava (Expandir serviço no convênio ou Farol › Itens).

Lição: campos do produto

Do manual: abrir esta parte no manual completo ›

CampoDescrição / validaçãoObrigatório?
NomeNome comercial do produtoObrigatório
Tipo de CódigoTabela do código do item (ex.: Brasíndice, SIMPRO, própria)Obrigatório
Tipo ProdutoCategoria: Medicamento, Material, Equipamento, etc. Deve estar cadastrado antes.Obrigatório
Código ProdutoCó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 NCMCó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ãoOnde o produto fica guardado (local do depósito) — por isso o depósito mínimo vem antes na implantaçãoObrigatório
Princípio AtivoPara medicamentos: substância ativaOpcional
FabricanteFabricante do produto — cadastre os fabricantes antes (Estoque › Fabricantes)Obrigatório
FornecedoresUm ou mais fornecedores; a busca lista todos os fornecedores ativos (desde 30/09/2026)Opcional
ApresentaçãoEmbalagem (ex.: caixa, frasco)Obrigatório
ContendoQuantidade dentro da embalagemObrigatório
Preço / Data da última pesquisaReferência de preço de compraOpcional
Unidade De MedidaUnidade de controle do estoqueObrigatório
CDCampo obrigatório da telaObrigatório
Tabela 87Referência do código do item (terminologias unificadas da saúde)Opcional
Estoque pode negativarPermite saída sem saldoOpcional
Lista da Portaria 344/98 ✅ Novo — 23/10/2026Bloco "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/2026Sim/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/2026Saem na receita; aproveite para preencher junto com a classificação.Opcional

Movimentações do produto (com o paciente)

Do manual: abrir esta parte no manual completo ›

Desde 23/10/2026, em Estoque › Produtos › abra o produto › aba Estoque › Movimentações de Estoque:

A tela Estoque › Movimentação continua com a lista completa de todos os produtos.

Lição: aba Estoque do produto

Do manual: abrir esta parte no manual completo ›

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.

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.

Códigos do produto: código, EAN e NCM

Do manual: abrir esta parte no manual completo ›

Em produção desde 02/10/2026 (#635):

CampoRegraMensagem se estiver fora
Código ProdutoAté 10 caracteres: letras, números, ponto, hífen ou barra (padrão TISS)"Código do produto deve ter até 10 caracteres (letras, números, ponto, hífen ou barra)."
Código EANTexto com 8, 12, 13 ou 14 dígitos — o zero à esquerda é preservado"Código EAN deve ter 8, 12, 13 ou 14 dígitos numéricos."
Código NCMExatamente 8 dígitos (NCM antigo que tinha perdido o zero foi completado)"Código NCM deve ter exatamente 8 dígitos numéricos."
Data da última pesquisaData válida (pode ser apagada)"Data da última pesquisa inválida."
⚠️ Configure o Estoque mínimo

O Estoque mínimo (aba Estoque do produto) é fundamental para o Mapa de Estoque e a Necessidade de Compra funcionarem bem: produtos no mínimo ou abaixo dele aparecem como CRÍTICO nos relatórios e no Dashboard. Não é obrigatório, mas configure na fase de entradas de estoque.

💰 Como o Rabi chega ao preço? O valor cadastrado aqui na aba Estoque é o preço "de casa" do produto — a cadeia completa de preço do produto (com Fator K e a conversão por convênio) está no Guia do Implantador da nova área Preços e Conversão de Valores.

Produto (tipo de item de preço)

Do manual: abrir esta parte no manual completo ›

Em Estoque › Produtos, o preço do produto fica na aba Estoque:

CampoPara que serve
Preço de venda tabelaO preço de venda "da casa"
Fonte de PreçoDe onde vem o preço: uma tabela de preços, o preço fixo, a última compra, o preço médio ou a última pesquisa
Fator K/inflator/deflatorUm percentual para cima ou para baixo. 20 = +20% · -10 = −10% · 0 = não mexe
Última Compra / Padrão CalcularO custo do produto. Marcado = o sistema usa a última compra do estoque. Desmarcado = você digita o custo.
💡 O custo é tão importante quanto o preço: sem custo, o Farol fica roxo ("erro de preço/resultado").
Não achou o que precisava?
Pergunte à Helô com as suas palavras, veja a Central de Ajuda ou escreva para o suporte: contato@rabisistemas.com.br.