Produto técnico
O ramo representa o produto técnico ou regulatório, não a seguradora que o comercializa.
Voltar para a documentação
Treinamento administrativo
Ramos e Categorias de Seguro
Consulte o catálogo técnico e, quando autorizado, configure os padrões usados por contratos, seguradoras, oportunidades, apólices e conciliações.
Categorias do objeto
Cada ramo exige ao menos uma categoria funcional para oportunidades e relatórios.
Catálogo global
A estrutura é compartilhada; as contagens de vínculos exibidas respeitam o tenant atual.
Histórico protegido
Vínculos bloqueiam mudanças estruturais e exclusões que reinterpretariam dados existentes.
1
Leia os indicadores do catálogo
Os cartões mostram total de ramos, ativos, grupos e vínculos. Ramos e grupos são globais; as contagens de seguradoras e contratos são limitadas ao tenant consultado.
2
Encontre o ramo correto
Pesquise por nome, código, grupo, controle ou prefixo SUSEP. Combine grupo e status; a tabela informa perfil operacional, vínculos, categorias e disponibilidade.
3
Defina o perfil antes do uso
Ao criar, informe nome, modelo operacional, objeto conciliado, base financeira, estratégia de conciliação, código, grupo, controle, célula, status e categorias.
4
Modele categorias funcionais
Use uma categoria por linha. Elas devem representar tipos do objeto segurado. Ao remover uma categoria existente, ela fica inativa para preservar referências históricas.
Tabela
O que aparece em cada linha
Código
Código SUSEP quando aplicável; ramos internos podem não possuir código.
Ramo
Nome, identificador técnico e perfil operacional usado pelos consumidores.
Grupo
Família de mercado usada para classificação e filtro.
Controle
SUSEP, ANS, interno, Open Insurance ou legado.
Vínculos
Seguradoras, contratos, categorias ativas e situação do ramo.
Ações
Editar ou excluir, somente para quem possui permissão administrativa.
Cadastro
Campos estruturais
Modelo operacional
Contrato coletivo, oportunidade e apólice, garantia ou fluxo personalizado.
Objeto conciliado
Pessoa, veículo, imóvel, carga, obrigação, equipamento ou outro objeto.
Base financeira
Referência padrão para novos itens quando não houver regra mais específica.
Conciliação
Classificação por competência, parcela, evento, endosso ou vigência.
Código e grupo
Identificação regulatória e família de mercado do ramo.
Célula operacional
Área responsável, como Benefícios, Patrimonial ou Corporate.
Status
Ativo disponibiliza o ramo; inativo preserva o histórico sem uso futuro.
Categorias
Lista ordenada de tipos do objeto segurado, uma categoria por linha.
Governança
Mudanças que exigem cuidado
Estrutura bloqueada
Um ramo com uso operacional não aceita troca de modelo, objeto, base financeira ou estratégia. Inative-o e crie uma nova configuração.
Exclusão protegida
Qualquer vínculo operacional impede a exclusão. A inativação mantém contratos, apólices e histórico financeiro íntegros.
Concorrência segura
A edição envia a versão carregada. Se o cadastro mudou no intervalo, o sistema exige recarga e nova revisão.
Permissões e API
Contratos principais
contracts.read, traditional_insurance.read ou platform.provider_catalog.read
GET /insurance-carriers/lines
Consulta o catálogo, categorias e contagens visíveis para o tenant.
platform.provider_catalog.manage
POST /insurance-carriers/lines
Cria um ramo global com ao menos uma categoria ativa.
platform.provider_catalog.manage
PATCH /insurance-carriers/lines/:id
Atualiza somente os campos alterados e protege versões concorrentes.
platform.provider_catalog.manage
DELETE /insurance-carriers/lines/:id
Exclui apenas cadastros sem qualquer vínculo operacional.
Checklist
Antes de liberar o ramo
Confirme se o item é realmente um ramo, e não uma seguradora, cobertura ou atributo do segurado.
Use o código e o tipo de controle compatíveis com a origem regulatória.
Escolha modelo operacional, objeto, base financeira e conciliação antes do primeiro vínculo.
Cadastre categorias funcionais do objeto, sem misturar coberturas ou características comerciais.
Prefira inativar um ramo usado; não tente excluir para apagar histórico.
Se outro usuário alterou o cadastro, recarregue e revise antes de salvar novamente.
Ponto de controle
Salvar a base financeira ou a estratégia de conciliação define um padrão para novos processamentos quando não há configuração mais específica. A ação não reprocessa nem altera automaticamente o histórico já registrado.