⚙️ Configurações

Área administrativa do sistema: estrutura da clínica, colaboradores, convênios, serviços, usuários e parâmetros gerais.

Visão Geral

As Configurações são a fundação do sistema Rabi. Todos os outros módulos dependem dos dados cadastrados aqui. É obrigatório configurar esta área antes de utilizar qualquer outro módulo.

Acesso em produção: app.rabisistemas.com.br/portal/configuracoes

Empresas e Unidades

Define a estrutura organizacional da clínica. Uma empresa (CNPJ) pode ter múltiplas unidades físicas de atendimento.

URL: /portal/configuracoes/empresas-unidades

Como cadastrar a empresa

1. Acesse Configurações → Empresas e Unidades

   No menu lateral, clique em Configurações e depois em Empresas e Unidades.

2. Clique em "Nova Empresa"

   Botão no canto superior direito da listagem.

3. Preencha os dados obrigatórios

   Razão Social, CNPJ (apenas números) e endereço completo com CEP.

4. Adicione logo (opcional)

   Clique em "Upload de Logo" e selecione um arquivo PNG ou JPG. A logo aparecerá nos documentos impressos.

5. Salve

   Clique em "Salvar". A empresa aparece na listagem e já pode ser vinculada a colaboradores.

Campos do formulário

Locais / Salas

Ambientes físicos dentro de uma unidade onde ocorrem os atendimentos: consultórios, salas de exame, salas de procedimento, etc. Cada local pode ter uma lotação máxima e ser vinculado a um equipamento.

URL: /portal/configuracoes/empresas-unidades/locais

Como cadastrar um local

1. Acesse Configurações → Locais

   Dentro de Empresas e Unidades, clique na aba ou link "Locais".

2. Clique em "Novo Local"
3. Preencha o nome do local

   Exemplos: "Consultório 01", "Sala de Exames", "Sala de Procedimentos", "Recepção".

4. Selecione a unidade

   Vincule ao estabelecimento correto (se a clínica tem mais de uma unidade).

5. Salve

   O local aparece na lista de locais disponíveis ao criar agendamentos.

Colaboradores

Profissionais de saúde e administrativos que atuam na clínica. Cada colaborador terá sua própria agenda e acesso ao sistema conforme as permissões configuradas.

URL: /portal/configuracoes/colaboradores

Como cadastrar um colaborador

1. Acesse Configurações → Colaboradores
2. Clique em "Novo Colaborador"
3. Preencha nome e e-mail

   O e-mail é usado para acesso ao sistema. Deve ser único por colaborador.

4. Selecione a Empresa Principal

   Vincule à empresa cadastrada anteriormente. Se houver múltiplas unidades, escolha a principal deste profissional.

5. Adicione as especialidades

   Clique em "+ Adicionar Especialidade". Para cada especialidade, informe o nome (ex: Cardiologia) e o código CBOS correspondente.
   Exemplo: Cardiologia → CBOS 225105

6. Faça upload de foto (opcional)

   PNG ou JPG. Aparece no prontuário e agenda.

7. Salve

   O colaborador aparece na lista e está disponível para agendamentos.

Campos do formulário

O que é o CBOS?

O CBOS (Classificação Brasileira de Ocupações em Saúde) é um código numérico que identifica cada especialidade médica. É obrigatório para emissão de guias e faturamento de convênios.

Para outras especialidades, consulte a tabela completa do CBOS no site do Ministério da Saúde.

Especialidades

As especialidades não têm cadastro próprio — são criadas diretamente no formulário do colaborador. Cada colaborador pode ter múltiplas especialidades (ex: Cardiologia + Clínica Geral).

As especialidades disponíveis na agenda são automaticamente as especialidades dos colaboradores ativos.

Equipamentos

Aparelhos médicos que podem ser vinculados aos agendamentos para controle de disponibilidade. Exemplos: ecocardiograma, raio-X, ultrassom, eletrocardiógrafo, densitômetro.

URL: /portal/configuracoes/equipamentos

Como cadastrar um equipamento

1. Acesse Configurações → Equipamentos
2. Clique em "Novo Equipamento"
3. Informe o nome do equipamento

   Ex: "Ultrassom GE Logic 5", "Raio-X Digital".

4. Selecione a unidade

   Onde o equipamento está localizado.

5. Salve

   O equipamento fica disponível para seleção no formulário de agendamento.

Operadoras

Empresas de plano de saúde. São a base para criação dos convênios — primeiro cadastre a operadora, depois crie o convênio.

URL: /portal/configuracoes/operadoras

Como cadastrar uma operadora

1. Acesse Configurações → Operadoras
2. Clique em "Nova Operadora"
3. Informe o nome da operadora

   Ex: "Unimed Nacional", "Bradesco Saúde", "Amil", "SulAmérica", "Hapvida". Para atendimentos sem plano, crie uma operadora chamada "Particular".

4. Preencha o CNPJ (se disponível)
5. Salve

   A operadora fica disponível para criação de convênios.

Convênios

Contratos com operadoras de saúde aceitos pela clínica. Esta é a configuração mais complexa e importante — define todas as regras comerciais, prazos e tabelas de preços.

URL: /portal/configuracoes/convenios

Como cadastrar um convênio

1. Acesse Configurações → Convênios
2. Clique em "Novo Convênio"
3. Selecione a operadora

   A operadora deve estar cadastrada antes. Ex: "Unimed Nacional".

4. Informe o nome do convênio

   Ex: "Unimed Individual", "Bradesco Nacional Flex", "Particular".

5. Preencha os prazos comerciais

   Prazo de pagamento, prazo de retorno, prazo de entrega de guias, prazo de glosa. Esses valores vêm do contrato com a operadora.

6. Defina "Pagamento no ato?"

   Se Sim: paciente paga copagamento na recepção ao chegar. Se Não: faturamento é feito depois em lote.

7. Configure a tabela de preços

   Veja opções na seção abaixo.

8. Credenciamento de colaboradores (aba CBOS)

   Selecione quais colaboradores e especialidades estão credenciados neste convênio.

9. Ative o convênio e salve

   Marque "Ativo = Sim" para que o convênio apareça nos agendamentos e no cadastro de pacientes.

Campos do formulário

Tabela de preços do convênio

Cada convênio tem sua própria tabela com o valor pago por procedimento. Há quatro formas de configurar:

Painel de conversão de serviço ✅ atualizado (jun/2026)

Em /portal/configuracoes/convenios/:id/servicos, o painel de Conversão de Serviço faz o "de–para" entre os serviços internos da clínica e os códigos/serviços do convênio. Em junho/2026 esse painel foi simplificado (layout mais limpo) e recebeu ajustes visuais, deixando o cadastro do "de–para" mais rápido e claro.

Novidades de julho/2026 nos Convênios ✅ Novo — jul/2026

Entregas do ciclo de julho/2026 (issues fechadas no GitLab). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Valor por conversão visível na linha (#473 — 24/07): a lista passa a mostrar, na própria linha, o valor por conversão de serviço, produto e taxa.
• Desativar convênio com colaboradores vinculados (#455 — 20/07): agora é permitido desativar um convênio mesmo quando há colaboradores vinculados a ele.
• Sub-aba Colaboradores mais limpa (#429 — 01/07): a sub-aba Colaboradores do convênio passa a listar somente quem tem consulta.
• Farol de % de gastos do convênio (#339 — 22/07): indicador em cores do percentual de gastos do convênio.
• Farol por parâmetros em convênios e serviços (#505/#506/#507 — 20–22/07, e #434 — 22/07): exibição do farol em cores (🟢 verde / 🟡 amarelo / 🔴 vermelho) com o índice do parâmetro nos serviços e bloqueio quando o farol está vermelho. Faz parte da entrega do Farol de Margem Receita/Custo (#390), concluída em julho/2026.

Credenciamento de colaboradores (aba CBOS)

Dentro de cada convênio, na aba CBOS, você define quais especialidades e colaboradores estão credenciados para atender por aquele plano. Somente os credenciados aparecem como opção ao criar um agendamento com este convênio.

Tabela de Preços Internos

Preços dos procedimentos para atendimentos particulares (sem convênio). Esta é a tabela "padrão" da clínica para pacientes que pagam por conta própria.

URL: /portal/configuracoes/tabela-precos-internos

Como configurar

1. Acesse Configurações → Tabela de Preços Internos
2. Localize o serviço

   Os serviços cadastrados em "Serviços e Procedimentos" aparecem aqui.

3. Informe o valor

   Ex: Consulta Cardiologia = R$ 280,00.

4. Salve

   O valor aparece automaticamente ao criar agendamentos particulares.

Serviços e Procedimentos

Catálogo de todos os procedimentos realizados pela clínica. São usados no agendamento, no prontuário e em todas as tabelas de preços.

URL: /portal/configuracoes/servicos

Como cadastrar um serviço

1. Primeiro, cadastre os Tipos de Serviço

   Acesse /portal/configuracoes/servicos/tipos e crie as categorias: Consulta, Exame, Cirurgia, Terapia, Procedimento.

2. Acesse Configurações → Serviços
3. Clique em "Novo Serviço"
4. Preencha os dados

   Nome (ex: "Consulta Cardiológica"), Tipo de serviço (ex: Consulta), Código TUSS ou código próprio se aplicável.

5. Salve

   O serviço aparece nas tabelas de preços e no agendamento.

Tipos de Atendimento

Classificações das consultas realizadas. Usadas no agendamento para indicar a natureza da visita.

URL: /portal/configuracoes/tipo-atendimento

Como cadastrar

1. Acesse Configurações → Tipos de Atendimento
2. Clique em "Novo Tipo"
3. Informe o nome

   Ex: "Primeira Consulta", "Retorno 30 dias", "Urgência".

4. Salve

Parâmetros do Sistema

Configurações globais que controlam o comportamento do sistema para toda a clínica. Cada parâmetro afeta como o sistema funciona para todos os usuários.

URL: /portal/configuracoes/parametros

Tipos de Pagamento e Categorias

Define como os pacientes pagam (tipo) e para que os lançamentos financeiros são categorizados (categoria).

• Tipos de Pagamento: /portal/configuracoes/tipos-de-pagamento
• Categorias de Pagamento: /portal/configuracoes/categorias-de-pagamento

Como configurar tipos de pagamento

1. Acesse Configurações → Tipos de Pagamento
2. Clique em "Novo Tipo"
3. Informe o nome

   Ex: "PIX", "Cartão de Crédito Visa".

4. Salve

   Aparece no dropdown ao registrar um lançamento financeiro.

Usuários e Permissões

O acesso de cada usuário ao sistema é controlado por grupos de permissão com diferentes níveis de ação.

Grupos de permissão disponíveis

Níveis de ação por grupo

Perfis recomendados por função

Tipos de Documento de Atendimento

Modelos de documentos clínicos que o profissional pode emitir durante o atendimento no prontuário. Cada tipo define o nome e o modelo do documento.

URL: /portal/configuracoes/tiposDocumentoAtendimento

Como cadastrar um tipo de documento

1. Acesse Configurações → Tipos de Documento de Atendimento
2. Clique em "Novo Tipo de Documento"
3. Informe o nome

   Ex: "Atestado Médico Padrão".

4. Configure o modelo (template)

   Insira o conteúdo padrão do documento. Os campos do paciente e médico são preenchidos automaticamente no prontuário.

5. Salve

   O documento fica disponível no prontuário do paciente durante o atendimento.

Tipos de Impressão

Modelos de cabeçalho e rodapé para documentos impressos pela clínica — receitas, atestados, laudos. Permite personalizar o layout com logo, dados da clínica e dados do profissional.

URL: /portal/configuracoes/tipo-impressao

Tipos de Código

Padrões de codificação usados no faturamento de convênios. Definem como os procedimentos são identificados nas guias.

URL: /portal/configuracoes/tipos-de-codigo

Taxas e Tipos de Taxas

Encargos administrativos ou taxas cobradas em serviços específicos (ex: taxa de sala, taxa de materiais, taxa de guia).

• Tipos de Taxas: /portal/configuracoes/taxas/tipos — categorias (ex: Taxa Hospitalar, Taxa de Material)
• Taxas: /portal/configuracoes/taxas — valores específicos por tipo

Ordem de Configuração para Clínica Nova

Esta é a sequência correta de configuração para uma clínica nova. Respeite a ordem pois há dependências entre os cadastros:

1. Empresa e Unidades

   Cadastrar a empresa (CNPJ, endereço, logo) e suas unidades físicas.

2. Locais / Salas

   Cadastrar os ambientes de atendimento dentro de cada unidade.

3. Operadoras

   Cadastrar as empresas de saúde antes de criar os convênios.

4. Convênios e Tabelas

   Criar os convênios, planos, regras e importar as tabelas de preços.

5. Tabela de Preços Internos

   Definir valores para atendimentos particulares.

6. Tipos de Serviço e Serviços

   Cadastrar os procedimentos realizados pela clínica.

7. Tipos de Atendimento

   Definir categorias de consulta (primeira consulta, retorno, etc.).

8. Equipamentos

   Cadastrar aparelhos médicos que serão vinculados aos agendamentos.

9. Colaboradores e Especialidades

   Cadastrar todos os profissionais com suas especialidades e CBOS.

10. Tipos de Documento e Impressão

    Configurar modelos de documentos clínicos e templates de impressão.

11. Usuários e Permissões

    Criar contas de acesso e configurar permissões por perfil.

12. Parâmetros do Sistema

    Configurar parâmetros gerais com suporte da equipe Rabi.

Capturas de Tela

Imagens de referência das telas do módulo com indicação numerada dos elementos principais.