Agenda comercial
Separa follow-ups atrasados, previstos para hoje, próximos sete dias e oportunidades sem próxima ação.
Treinamento operacional
Central Comercial e Oportunidades
Guia público para registrar, acompanhar e governar uma negociação desde a qualificação até a apólice, preservando documentos, decisões e escopo comercial.
Pipeline ponderado
Multiplica prêmio estimado pela probabilidade de cada negócio. É previsão comercial, não receita garantida.
Filtros operacionais
Refina o quadro por pipeline, ramo, responsável, prazo e busca textual sem alterar os indicadores consolidados.
Carteira autorizada
A visibilidade pode abranger todo o tenant, somente o departamento ou apenas as oportunidades do produtor vinculado.
1
Leia a visão geral e priorize a agenda
Comece pelos follow-ups. Depois confira pipeline ponderado, oportunidades abertas, apólices, prêmio emitido e comissão esperada. Os filtros atuam no quadro operacional, não nos consolidados acima.
2
Cadastre a oportunidade sem duplicar o cliente
Clique em Nova oportunidade, selecione cliente ou prospect, ramo, categoria, produtor, pipeline e etapa. Informe estimativa e prazo somente quando houver base comercial. Neste treinamento, o formulário foi aberto sem envio.
3
Use o dashboard como leitura de coorte
O dashboard trabalha com oportunidades criadas no período selecionado. A conversão considera ganhas sobre ganhas mais perdidas; abertas e canceladas não entram no denominador.
Cadastro
O que preencher em cada campo
| Campo | Regra | Contrato | Como preencher |
|---|---|---|---|
| Cliente ou prospect | Obrigatório | customerId | Pesquise pelo cliente já cadastrado. O cliente existe antes do contrato e pode receber várias oportunidades. |
| Ramo | Obrigatório | insuranceLineId | Selecione o ramo regulatório ou produto correto; ele define as categorias permitidas para o objeto segurado. |
| Categoria do objeto segurado | Obrigatório | objectCategoryId | Classifique o objeto no catálogo vinculado ao ramo. Não use o título livre para substituir essa classificação. |
| Seguradora inicial | Opcional | providerId | Informe quando já houver uma seguradora provável; deixe em aberto durante a prospecção quando ainda não estiver definida. |
| Produtor responsável | Recomendado | producerId | Responsável comercial pela oportunidade. Perfis com visibilidade própria recebem o produtor vinculado ao usuário. |
| Pipeline comercial | Obrigatório | pipelineId | Escolha o funil adequado. O pipeline padrão é sugerido automaticamente quando está ativo. |
| Etapa inicial | Obrigatório | pipelineStageId | Comece na etapa coerente com o atendimento; normalmente Qualificação, sem pular evidências comerciais existentes. |
| Identificador adicional | Opcional | title | Detalhe o caso, bem ou referência sem repetir cliente, ramo ou categoria já estruturados. |
| Prêmio estimado | Opcional | expectedPremium | Estimativa comercial usada nos indicadores. Não substitui prêmio cotado, proposto ou emitido. |
| Probabilidade comercial | Opcional | probability | Use de 0% a 99%. Em branco, herda a probabilidade padrão da etapa; não altera preço nem comissão. |
| Previsão de fechamento | Recomendado | expectedCloseAt | Data esperada para decisão, usada na priorização por prazo e no dashboard comercial. |
| Origem | Opcional | source | Registre indicação, renovação, campanha ou outro canal de entrada de forma consistente. |
| Observações | Opcional | notes | Contexto interno útil para o atendimento, sem inserir credenciais ou dados desnecessariamente sensíveis. |
Jornada comercial
Da qualificação à apólice
1
Qualificar
Confirme cliente, ramo, categoria, responsável, origem e necessidade antes de solicitar cotações.
2
Registrar orçamento
Anexe o arquivo original ou use a análise assistida; revise prêmio, vigência, coberturas, franquias e pagamento.
3
Comparar e selecionar
Compare as opções e registre uma justificativa de decisão com pelo menos oito caracteres.
4
Criar proposta
Leve a opção selecionada para proposta, mantenha o documento e acompanhe a situação de subscrição.
5
Emitir com prévia
Revise apólice, prêmio, vigência, comissão, parcelamento e produtor antes da confirmação de emissão.
6
Acompanhar pós-emissão
A carteira continua em renovação, comissão, documentos, financeiro e eventos da apólice.
Acesso
Permissões e visibilidade
traditional_insurance.read
Consulta dashboard, oportunidades, atividades, orçamentos, propostas, documentos e apólices dentro do escopo autorizado.
traditional_insurance.manage
Cria e atualiza oportunidades, atividades, orçamentos, propostas e operações governadas de apólice.
traditional_insurance.pipeline.manage
Cria, ordena e mantém pipelines e etapas comerciais do tenant.
traditional_insurance.whatsapp.send
Autoriza envio integrado de documentos pelo provedor de WhatsApp configurado para o tenant.
O módulo exige o entitlement de seguros tradicionais. A permissão define a ação; o escopo comercial define quais registros o usuário enxerga.
Leitura gerencial
Indicadores sem ambiguidade
Pipeline em aberto
Soma dos prêmios estimados das oportunidades abertas no recorte.
Pipeline ponderado
Soma de prêmio estimado multiplicado pela probabilidade individual.
Conversão decidida
Ganhas divididas por ganhas mais perdidas; não inclui abertas ou canceladas.
Sem próximo follow-up
Oportunidades abertas que precisam receber uma atividade futura.
API
Contratos principais da rota
| Endpoint | Acesso | Responsabilidade |
|---|---|---|
| GET /traditional-insurance/dashboard | read | Indicadores e recortes do dashboard comercial. |
| GET /traditional-insurance/opportunities | read | Lista oportunidades respeitando tenant e visibilidade comercial. |
| GET /traditional-insurance/opportunities/:id | read | Detalhe, atividades, orçamentos, propostas e histórico do negócio. |
| POST /traditional-insurance/opportunities | manage | Criação de oportunidade. |
| PATCH /traditional-insurance/opportunities/:id | manage | Atualização operacional, etapa e ciclo de vida. |
| POST /traditional-insurance/opportunities/:id/activities | manage | Próxima ação e atividades do acompanhamento. |
| POST /traditional-insurance/opportunities/:id/quotes | manage | Registro de orçamento. |
| POST /traditional-insurance/quotes/:id/select | manage | Seleção justificada de orçamento. |
| POST /traditional-insurance/opportunities/:id/proposals | manage | Criação de proposta. |
| POST /traditional-insurance/proposals/:id/issue-policy | manage | Emissão governada da apólice após revisão. |
| GET /traditional-insurance/policies | read | Carteira de apólices acessível. |
Checklist operacional
Antes de avançar uma negociação
Use a agenda para que toda oportunidade aberta tenha uma próxima ação e um responsável definido.
Não interprete pipeline ponderado, prêmio estimado ou conversão como receita contabilizada.
Mantenha documentos originais de orçamento, proposta e apólice vinculados às respectivas versões.
Seleção de orçamento, emissão, renovação e mudança de ciclo de vida exigem decisão humana e registro auditável.
Na importação, analisar ou gerar prévia não cria registros de negócio; confirme somente linhas revisadas.
Em treinamento, não confirme emissão, renovação, baixa ou envio integrado em uma carteira real.
WhatsApp Web exige anexar manualmente o documento baixado; o envio integrado depende da permissão e da configuração do tenant.
Revise escopo TENANT, DEPARTMENT ou OWN antes de concluir que uma oportunidade está ausente.
Ponto de controle
Criar uma oportunidade é reversível; emitir uma apólice, confirmar uma renovação ou registrar uma baixa produz efeitos comerciais e financeiros. Sempre revise a prévia e o tenant antes da confirmação.