Lição: Configurações e Cadastros-mestre

Esta lição prepara o implantador para configurar um ambiente Rabi do zero. As Configurações são a fundação do sistema: todos os demais módulos (Agendamento, Prontuário, Faturamento, Financeiro, Estoque) dependem dos dados cadastrados aqui. Ao final você deverá saber cadastrar empresa, unidades, locais, colaboradores com CBOS, operadoras, convênios (a peça mais complexa), tabelas de preço, serviços, equipamentos, parâmetros e permissões — e na ordem correta, respeitando as dependências.

✅ Em produção. Todo o conteúdo desta lição descreve o que já está disponível em produção (app.rabisistemas.com.br), salvo quando explicitamente marcado como 🟠 planejado.

Objetivo do módulo e onde fica

O módulo administra a estrutura da clínica e os cadastros-mestre reutilizados por todo o sistema. Acesso pelo menu lateral Configurações. Rota base em produção:

/portal/configuracoes/empresas-unidades — porta de entrada do módulo

⚠️ Acesso restrito. O módulo exige o grupo de permissão CONFIGURACOES. Apenas administradores e implantadores devem ter acesso — alterações incorretas impactam toda a operação da clínica.

A ordem de configuração (a regra de ouro do implantador)

Os cadastros têm dependências entre si. Seguir a ordem errada trava a implantação (ex.: não dá para criar convênio sem operadora, nem colaborador sem empresa). Sequência oficial para clínica nova:

Empresa e Unidades — CNPJ, endereço, logo.
Locais / Salas — ambientes de atendimento dentro de cada unidade.
Operadoras — as empresas de plano de saúde.
Convênios e Tabelas — planos, regras comerciais e tabelas de preço.
Tabela de Preços Internos — valores para particular.
Tipos de Serviço e Serviços — catálogo de procedimentos.
Tipos de Atendimento — primeira consulta, retorno, urgência, etc.
Equipamentos — aparelhos vinculáveis à agenda.
Colaboradores e Especialidades — profissionais com CBOS e grade horária.
Tipos de Documento e Impressão — modelos clínicos e cabeçalhos.
Usuários e Permissões — contas de acesso e perfis.
Parâmetros do Sistema — configurações globais (com suporte Rabi).

Empresas e Unidades

Define a estrutura organizacional: uma empresa (um CNPJ) pode ter várias unidades físicas de atendimento. Clínica com uma só sede cadastra uma empresa e uma unidade. Rota: /portal/configuracoes/empresas-unidades.

Passo a passo — cadastrar a empresa

Acesse Configurações → Empresas e Unidades.
Clique em Nova Empresa (canto superior direito).
Preencha os dados obrigatórios: Razão Social, CNPJ (só números) e endereço com CEP.
Opcional: faça Upload de Logo (PNG/JPG) — aparece nos documentos impressos.
Clique em Salvar. A empresa já pode ser vinculada a colaboradores.

Campos do formulário

#	Campo	Obrig.?	Validação / Observação
1	Razão Social	Sim	Nome jurídico. Ex.: Clínica Saúde e Vida Ltda
2	Nome Fantasia	Não	Nome comercial
3	CNPJ	Sim	14 dígitos, sem pontuação. Validação de CNPJ
4	CEP	Sim	Preenche endereço automaticamente
5	Logradouro / Número	Sim	Rua/Av. e número
6	Bairro / Cidade / Estado	Sim	Preenchido pelo CEP
7	Telefone	Não	Formato BR: (00) 00000-0000
8	E-mail	Não	E-mail de contato
9	Logo	Não	PNG/JPG, aparece em impressos

✅ Novo — jul/2026 Logo/customização por clínica (#503): a logo e a customização passam a ser configuráveis por clínica. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

⚠️ Etapa 1 — faça primeiro. Sem a empresa não é possível cadastrar colaboradores nem convênios.

Locais / Salas

Ambientes físicos dentro de uma unidade onde ocorrem atendimentos: consultórios, salas de exame, de procedimento, recepção. Cada local é vinculado a uma unidade. Rota: /portal/configuracoes/empresas-unidades/locais.

Passo a passo

Em Empresas e Unidades, clique em Locais.
Clique em Novo Local.
Informe o nome (ex.: "Consultório 01", "Sala de Exames").
Selecione a unidade correta.
Salve. O local passa a aparecer no campo "Local do Agendamento".

🔗 Integração. Se um local não aparece na agenda, confira se foi salvo e vinculado à unidade correta.

Operadoras

Empresas de plano de saúde — a base para os convênios. Primeiro a operadora, depois o convênio. Rota: /portal/configuracoes/operadoras.

Passo a passo

Acesse Configurações → Operadoras.
Clique em Nova Operadora.
Informe o nome (ex.: Unimed Nacional, Bradesco Saúde, Amil). Para atendimentos sem plano, crie uma operadora "Particular".
Preencha o CNPJ, se disponível.
Salve.

⚠️ Operadora ≠ Convênio. Operadora é a empresa (Unimed, Bradesco). Convênio é o plano específico (Unimed Individual). Uma operadora tem vários convênios. Não é possível criar convênio sem operadora.

Convênios — o cadastro mais crítico

Contratos com operadoras aceitos pela clínica. É a configuração mais complexa: define regras comerciais, prazos, credenciamento e tabelas de preço. Rota: /portal/configuracoes/convenios.

Passo a passo — cadastrar um convênio

Acesse Configurações → Convênios e clique em Novo Convênio.
Selecione a operadora (já cadastrada).
Informe o nome do convênio (ex.: Unimed Individual).
Preencha os prazos comerciais (pagamento, retorno, entrega de guias, glosa) — vêm do contrato com a operadora.
Defina "Pagamento no ato?": Sim = copagamento na recepção; Não = faturado depois em lote.
Configure a tabela de preços (ver métodos abaixo).
Na aba CBOS, selecione os colaboradores/especialidades credenciados.
Marque Ativo = Sim e salve.

Campos do formulário

#	Campo	Obrig.?	Descrição
1	Operadora	Sim	Cadastrada antes
2	Nome do Convênio	Sim	Ex.: Unimed Individual Ambulatorial
3	Credenciado	Sim	Sim = clínica credenciada; Não = atende mas não fatura
4	Ativo	Sim	Sim = disponível em agendamentos
5	Prazo de pagamento (dias)	Não	Prazo da operadora para pagar lotes
6	Prazo de retorno (dias)	Não	Janela de retorno sem nova cobrança
7	Prazo de reajuste	Não	Periodicidade de reajuste da tabela
8	Prazo entrega de guias (dias)	Não	Máximo para enviar guias após atendimento
9	Limite recurso de glosa	Não	Prazo para contestar glosa recebida
10	Prazo pagamento glosa (dias)	Não	Prazo da operadora responder ao recurso
11	Pagamento no ato?	Sim	Sim = copagamento na chegada; Não = lote
12	Fator K / Inflator (%)	Não	Percentual de ajuste dos valores da tabela

Tabela de preços do convênio (4 métodos)

Cada convênio tem tabela própria com o valor pago por procedimento. Formas de configurar:

Método	Quando usar	Como fazer
Importar Excel	Muitos procedimentos de uma vez	Baixe o template → preencha → botão "Importar Excel"
Cadastrar manualmente	Poucos itens / ajustes pontuais	Botão "+ Procedimento", um a um
Copiar de outro convênio	Tabelas parecidas	Botão "Copiar de convênio" → selecione origem
Exportar Excel	Revisão / backup	Botão "Exportar Excel"

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 e recebeu ajustes visuais, tornando o cadastro do "de–para" mais rápido e claro.

Novidades de julho/2026 no convênio ✅ Novo — jul/2026

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

Valor por conversão na linha (#473): o valor por conversão passa a ser informado direto na linha do serviço.
Desativar convênio com vinculados (#455): agora é possível desativar um convênio mesmo com colaboradores vinculados.
Sub-aba Colaboradores (#429): a sub-aba passa a listar apenas os colaboradores que têm consulta.
Farol de resultado 🟢🟡🔴 (#390/#434/#339): farol por convênio/serviço/produto, com cores + índice, parametrizado no convênio. Bloqueia no vermelho (liberação por nível superior).

🟠 Ainda em desenvolvimento (Sprint 3): a visão geral/lista de cruzamentos do farol (#435) ainda não foi entregue.

Credenciamento (aba CBOS)

Na aba CBOS do convênio você define quais especialidades e colaboradores estão credenciados para atender por aquele plano. Somente os credenciados aparecem como opção ao agendar com o convênio.

⚠️ Profissional não aparece no agendamento com convênio? Verifique se ele está na aba CBOS do convênio com a especialidade marcada como credenciada.

Tabela de Preços Internos

Preços dos procedimentos para atendimentos particulares (sem convênio). É a tabela padrão da clínica. Rota: /portal/configuracoes/tabela-precos-internos.

Acesse Configurações → Tabela de Preços Internos.
Localize o serviço (vindo de "Serviços e Procedimentos").
Informe o valor (ex.: Consulta Cardiologia = R$ 280,00).
Salve. O valor aparece automaticamente em agendamentos particulares.

✅ Novo — jul/2026 A Tabela de Preços Internos ganhou filtros (#475). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

🟠 Roadmap. Os filtros padrão em todas as telas (#396) seguem planejados para a Sprint 8 — ainda não estão em produção.

Serviços e Procedimentos

Catálogo de tudo que a clínica realiza. Usados no agendamento, no prontuário e em todas as tabelas de preço. Rota: /portal/configuracoes/servicos.

ℹ️ Ordem de cadastro. Cadastre primeiro os Tipos de Serviço (Consulta, Exame, Cirurgia, Terapia, Procedimento) em /portal/configuracoes/servicos/tipos, pois cada serviço precisa estar vinculado a um tipo.

Cadastre os Tipos de Serviço.
Acesse Configurações → Serviços e clique em Novo Serviço.
Preencha nome (ex.: "Consulta Cardiológica"), tipo (ex.: Consulta) e código TUSS/próprio se aplicável.
Salve. O serviço aparece nas tabelas de preço e no agendamento.

Tipos de Atendimento

Classificam a natureza da visita, usados no agendamento. Rota: /portal/configuracoes/tipo-atendimento. Exemplos: Primeira Consulta, Retorno (usa o prazo de retorno do convênio), Urgência, Telemedicina, Domiciliar.

Colaboradores e Especialidades (CBOS)

Profissionais de saúde e administrativos. Cada colaborador terá agenda própria e acesso ao sistema conforme as permissões. Rota: /portal/configuracoes/colaboradores.

Passo a passo

Acesse Configurações → Colaboradores e clique em Novo Colaborador.
Preencha Nome e E-mail (o e-mail é usado no acesso e deve ser único).
Selecione a Empresa Principal.
Clique em + Adicionar Especialidade e informe nome + código CBOS (ex.: Cardiologia → 225105).
Opcional: foto (PNG/JPG). Salve.

Campos do formulário

#	Campo	Obrig.?	Descrição
1	Nome	Sim	Nome completo
2	Foto	Não	PNG/JPG
3	E-mail	Sim	Acesso ao sistema. Único
4	Empresa Principal	Sim	Onde atua principalmente
5	Especialidades	Sim	Uma ou mais, cada uma com CBOS
6	Pessoa de Contato	Não	Contato alternativo

✅ Novo — jul/2026 A tela do colaborador ganhou o campo Conselho (conselho profissional) (#513). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

O que é o CBOS

O CBOS (Classificação Brasileira de Ocupações em Saúde) é um código numérico que identifica cada especialidade. É obrigatório para emissão de guias e faturamento de convênios. Exemplos: Clínica Geral 225125, Cardiologia 225105, Pediatria 225135, Ginecologia/Obstetrícia 225120, Fisioterapia 223605, Psicologia 251510, Nutrição 223710, Odontologia 223204.

⚠️ Colaborador não aparece na agenda? Verifique: (1) se foi salvo; (2) se tem ao menos uma especialidade; (3) se a empresa vinculada é a mesma do agendamento.

Grade horária: colaboradores (e equipamentos) possuem grade horária configurável, que define os horários disponíveis para agendamento.

Equipamentos

Aparelhos médicos vinculáveis aos agendamentos para controle de disponibilidade (ecocardiograma, raio-X, ultrassom, etc.). Também possuem grade horária. Rota: /portal/configuracoes/equipamentos.

Acesse Configurações → Equipamentos e clique em Novo Equipamento.
Informe o nome (ex.: "Ultrassom GE Logic 5").
Selecione a unidade e salve.

🔗 Reserva na agenda. No agendamento, o campo "Equipamentos" vincula um ou mais aparelhos ao horário, evitando conflitos de uso.

Tipos de Documento, Impressão, Código, Taxas e Anexos

Tipos de Documento de Atendimento

Modelos de documentos clínicos emitidos no prontuário (atestado, receita simples, receita controlada — Portaria 344, encaminhamento, solicitação de exames, laudo, relatório). Rota: /portal/configuracoes/tiposDocumentoAtendimento. Cadastre nome + modelo (template); os dados de paciente/médico são preenchidos automaticamente.

Tipos de Impressão

Modelos de cabeçalho/rodapé para impressos (receitas, atestados, laudos) com logo e dados da clínica/profissional. Rota: /portal/configuracoes/tipo-impressao.

Tipos de Código

Padrões de codificação no faturamento: TUSS (Terminologia Unificada da Saúde Suplementar — maioria dos convênios ANS), CBHPM (convênios médicos tradicionais) e código próprio da operadora. Rota: /portal/configuracoes/tipos-de-codigo.

Taxas e Tipos de Taxa

Encargos administrativos cobrados em serviços (taxa de sala, de material, de guia). Tipos em /portal/configuracoes/taxas/tipos e valores em /portal/configuracoes/taxas.

Tipos de Anexos

Categorias de anexos usadas em pacientes/atendimentos. Cadastro auxiliar de configuração.

Tipos de Pagamento e Categorias

Define como o paciente paga (Tipo: PIX, Dinheiro, Cartão de Crédito/Débito, Transferência, Cheque) e para que os lançamentos são classificados (Categoria: Consulta, Exame, Material, Salário, Aluguel). Rotas: /portal/configuracoes/tipos-de-pagamento e /portal/configuracoes/categorias-de-pagamento. Ambos alimentam os dropdowns dos registros financeiros.

Parâmetros do Sistema e Tokens de API

Configurações globais que controlam o comportamento do sistema para toda a clínica (horário de funcionamento, duração padrão de consulta, notificações, integrações). Rota: /portal/configuracoes/parametros. O módulo também permite gerenciar tokens de API para integrações.

⚠️ Configuração sensível. Parâmetros afetam toda a aplicação. Altere apenas como administrador e, de preferência, com suporte da equipe Rabi durante a implantação.

Usuários e Permissões

O acesso é controlado por grupos de permissão (módulos) com níveis de ação. Modelo em produção: papel (Role) + 4 ações fixas por módulo.

Níveis de ação

Nível	O que permite
NONE	Sem acesso — não vê nem acessa o módulo
VIEW	Apenas visualizar
CREATE	VIEW + criar registros
UPDATE	VIEW + CREATE + editar
DELETE	VIEW + CREATE + UPDATE + excluir

Ordem: NONE < VIEW < CREATE < UPDATE < DELETE. Grupos: AGENDAMENTO, ATENDIMENTO, PACIENTES, FINANCEIRO, FATURAMENTO, CONFIGURACOES, ESTOQUE, RELATORIOS, DASHBOARD.

Perfis recomendados

Função	Grupos	Nível
Administrador	Todos	DELETE (total)
Recepcionista	AGENDAMENTO, PACIENTES, DASHBOARD	UPDATE
Médico	ATENDIMENTO, AGENDAMENTO, PACIENTES	ATENDIMENTO: CREATE; demais VIEW
Financeiro	FINANCEIRO, FATURAMENTO, RELATORIOS, DASHBOARD	UPDATE / VIEW
Gestor	Todos exceto CONFIGURACOES	VIEW

🟠 Planejado (roadmap — GitLab #395, Sprint 9, 04–11/set). Um refactor para permissões granulares (múltiplos perfis por usuário, ações configuráveis além das 4 fixas, grupos, tela admin e sincronização com Keycloak) está planejado, mas ainda NÃO está em produção. Hoje vale o modelo Role + 4 ações fixas descrito acima.

Erros comuns e como resolver

Sintoma	Causa provável	Solução
Não consigo criar convênio	Operadora não cadastrada	Cadastre a operadora antes
Colaborador não aparece na agenda	Sem especialidade / empresa divergente	Adicione especialidade e confira a empresa
Profissional some ao escolher o convênio	Não credenciado na aba CBOS	Marque credenciado na aba CBOS do convênio
Local não aparece no agendamento	Não vinculado à unidade / não salvo	Verifique unidade e salve o local
Serviço não pode ser criado	Tipo de Serviço inexistente	Cadastre o Tipo de Serviço antes
Valor não aparece no agendamento particular	Preço não definido na Tabela Interna	Cadastre o valor do serviço na tabela interna

Pontos-chave

Configurações são a fundação: sem elas, nenhum módulo funciona.
Respeite a ordem: Empresa → Locais → Operadoras → Convênios → Preços → Serviços → Equipamentos → Colaboradores → Documentos → Permissões → Parâmetros.
Operadora ≠ Convênio: operadora é a empresa; convênio é o plano.
O CBOS é obrigatório para faturamento; só credenciados na aba CBOS aparecem no agendamento com convênio.
A tabela de preço do convênio tem 4 métodos (importar/manual/copiar/exportar Excel).
Permissões em produção = Role + 4 ações fixas (VIEW/CREATE/UPDATE/DELETE); granular é roadmap (#395, Sprint 9).
Ciclo de julho/2026 entregou: farol de resultado no convênio (#390/#434/#339), valor por conversão na linha (#473), desativar convênio com vinculados (#455), sub-aba Colaboradores (#429), campo Conselho do colaborador (#513), logo por clínica (#503) e filtros na Tabela de Preços Internos (#475).

O que a prova vai cobrar

A ordem correta de configuração e por que operadora vem antes de convênio.
Diferença entre operadora e convênio, e o papel da aba CBOS no credenciamento.
Métodos de montar a tabela de preços do convênio e a tabela de preços internos (particular).
Onde o CBOS é obrigatório e o efeito de faltar especialidade no colaborador.
O modelo de permissões em produção (Role + 4 ações) versus o granular (roadmap).