carriers.read
Visualiza a lista de operadoras e seguradoras do catálogo local e global.
Rota /insurance-carriers
Cadastro de Operadoras & Seguradoras.
O catálogo de operadoras e seguradoras gerencia as entidades responsáveis pelos planos de benefícios. Ele combina registros globais (padronizados pelo sistema) e customizações ou cadastros locais feitos por cada corretora.
carriers.manage
Cria, personaliza, edita e exclui cadastros de operadoras associadas ao tenant.
contracts.manage
Associa contratos ativos às operadoras e seguradoras do catálogo.
Fluxos operacionais
Ciclo de vida e personalização
1. Novo Cadastro
Cria uma operadora local exclusiva para o tenant atual. Informe nome, CNPJ, tipo e códigos regulatórios.
2. Personalizar Catálogo Global
Itens globais pré-cadastrados (sem tenantId) podem ser personalizados. Ao editar, o sistema duplica o registro criando uma cópia customizável local para o tenant.
3. Vincular Ramos de Seguro
Associe as linhas de negócios ativas (Saúde, Odonto, Vida, etc.) que a operadora está autorizada a comercializar.
Campos principais
Dados estruturais da entidade
| Campo | API / DB | Uso Operacional |
|---|---|---|
| Nome / Razão Social | name | Obrigatorio. Nome de identificação da operadora ou seguradora. |
| Tipo de Entidade | type | Obrigatorio. SEGURADORA, OPERADORA, ADMINISTRADORA, DENTAL ou AUTOGESTAO. |
| CNPJ | document | Opcional. CNPJ da entidade para emissão de faturamento ou identificação legal. |
| Código ANS | ansCode | Obrigatório / Recomendado para Operadoras de saúde (registro ANS). |
| Código SUSEP | susepCode | Obrigatório / Recomendado para Seguradoras (registro SUSEP). |
| Logotipo | logoUrl | Opcional. Imagem em formato Base64 para exibição visual nos contratos e relatórios. |
| Descrição | description | Opcional. Breve texto descritivo sobre a rede de atendimento ou operadora. |
Regras de validação
Requisitos de integridade do sistema
Bloqueio de Exclusão
Não é permitido excluir operadoras que possuam contratos ativos vinculados. Desative o status para inativar.
Catálogos Globais Protegidos
Operadoras globais padrão da plataforma não podem ser deletadas pelos tenants, apenas personalizadas.
Restrição de Logotipo
O upload de imagens de logo é limitado a 350 KB para garantir a performance de carregamento e evitar sobrecarga do banco de dados.
Checklist Operacional
Revisão antes de liberar para contratos
O tipo de entidade (Operadora, Seguradora, etc.) foi selecionado de forma correta.
O CNPJ e os registros regulatórios (ANS/SUSEP) foram conferidos com a base da operadora.
As linhas de negócios (Ramos de Seguro) foram associadas para permitir a criação dos planos de benefícios.
O logotipo carregado foi recortado e não ultrapassa os limites de tamanho permitidos (350KB).
O status foi alterado para ACTIVE para disponibilizar a operadora nas telas de criação de novos contratos.