> For the complete documentation index, see [llms.txt](https://docs.fomenti.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fomenti.com.br/cred-analise.md).
# Cred Análise
Perfil financeiro do Cedente ou Sacado com score de risco por Inteligência Artificial
O Cred Análise reúne, num único painel, o perfil financeiro do Cedente ou Sacado: volume operado, receita gerada, limite disponível, risco atual, performance de pagamento, inadimplência e um score de risco calculado por Inteligência Artificial. É acessado pelas abas Perfil Financeiro como Cedente e Perfil Financeiro como Sacado, dentro do menu Cred Análise.
#### O Cred Análise pode ser acessado por:
* **Menu lateral Cred Análise:**
* **Cadastro** de **Cedente/Sacado** clicando na aba **Cred Análise**:
* Em **Operação/Empréstimo** clicando no botão **Cred análise**:
* **Cadastro de Título:**
{% hint style="info" %}
Para cadastrar um título em avulso, vá em **movimentos** > **títulos**, **+Adicionar Novo Título**, [clique aqui](/movimentos/titulos.md) para saber mais.
{% endhint %}
### Configurações
Exibir o Score de Risco e o Resumo do Cliente depende de uma configuração da empresa, em Configurações > categoria **Cred Análise**:
* **Exibir os blocos de análise por IA no Cred Análise (score de risco, resumo do cliente e estrutura da carteira)**: quando desmarcada, os quadros "Score de Risco" e "Resumo do Cliente" não aparecem na ficha do Cedente/Sacado; o restante do Cred Análise continua funcionando normalmente.
### Score de Risco por Inteligência Artificial
O quadro Score de Risco mostra uma pontuação de 0 a 1000, calculada a partir do histórico do Cedente ou Sacado (pontualidade, severidade do atraso, inadimplência, recompra, prorrogação, concentração por sacado, utilização do limite, saldo financeiro, tempo de relacionamento, recência da última operação, **devoluções e protestos** e **qualidade das baixas**). A pontuação é sempre calculada pelo sistema, de forma determinística — a mesma extração de dados produz sempre o mesmo score. À Inteligência Artificial cabe apenas redigir o resumo e os pontos de atenção.
#### Faixas de classificação
* **850 a 1000**: Muito bom (verde)
* **700 a 849**: Bom (azul)
* **500 a 699**: Regular (amarelo)
* **300 a 499**: Ruim (laranja)
* **Abaixo de 300**: Muito ruim (vermelho)
#### Cedente ou Sacado sem dados suficientes
Um Cedente ou Sacado está sem dados suficientes quando não tem nenhuma operação, nenhum título pago em dia, nenhum título pago em atraso e nenhum título em aberto — as quatro condições ao mesmo tempo. Nesse caso, a ficha do Cred Análise exibe:
* **Score de Risco**: sem medidor, pontuação ou classificação, apenas a mensagem "Este cedente ainda não possui histórico suficiente para calcular o score. São necessários títulos operados, pagos ou em aberto."
* **Consultar Score**: o botão não é exibido, nem o custo e o saldo de créditos — não há consumo de crédito.
* **Resumo do Cedente**: a mensagem "A análise por inteligência artificial não está disponível: não há dados suficientes para este cedente."
* **Histórico de Score**: continua disponível, pois podem existir consultas antigas da entidade.
#### Consultando o score
Ao clicar em **Consultar Score**, o sistema solicita confirmação informando o consumo de 1 crédito e o saldo atual. Ao confirmar, a análise é realizada de forma síncrona, exibindo o carregamento.
Ao concluir, são exibidos o **Score de Risco**, a **classificação**, o **resumo gerado pela IA**, até **5 pontos de atenção**, a **data/hora da consulta** e a **versão da análise**. O saldo de créditos é atualizado imediatamente.
Quando a entidade tem 2 ou mais consultas anteriores, o resumo ganha uma frase de tendência comparando o score atual com a consulta anterior e com a mais antiga das últimas 10, citando os valores e há quantos dias foi cada uma: **melhora** (atual acima do anterior em mais de 25 pontos), **piora** (abaixo em mais de 25 pontos) ou **estável** (variação de até 25 pontos). Se a consulta anterior foi calculada por outra versão do cálculo, o resumo informa que o critério mudou e a comparação é aproximada. A tendência não altera a pontuação, a classificação nem os pontos de atenção.
Caso exista uma análise válida da mesma entidade, dentro do prazo configurado (padrão de **30 dias**) e sem alteração dos dados, o resultado é reutilizado automaticamente, exibindo **“Reaproveitado de análise anterior”**, sem nova chamada à IA e sem consumo de créditos.
#### Devoluções e protestos e Qualidade das baixas
Desde a versão 2.0.0 do cálculo, o score considera duas dimensões que penalizam devoluções, protestos e baixas com perda. O total continua em 1000 pontos: os pesos de Pontualidade, Severidade do atraso, Inadimplência atual, Tempo de relacionamento e Recência da última operação foram reduzidos para acomodar as novas dimensões.
* **Devoluções e protestos** (até 80 pontos): percentual do valor devolvido e protestado no histórico sobre o Volume Operado — o mesmo número da linha "Sobre o volume operado" do quadro Devoluções e Protestos.
* **0%**: 80 pontos (Positivo)
* **Até 1%**: 55 pontos (Atenção)
* **Até 3%**: 30 pontos (Atenção)
* **Até 6%**: 10 pontos (Negativo)
* **Acima de 6%**: 0 pontos (Negativo)
* **Sem Volume Operado**: 40 pontos, neutro (não aparece nos pontos de atenção)
* **Qualidade das baixas** (até 60 pontos): percentual do valor baixado com tipo negativo sobre o total baixado considerado.
* **Tipos negativos**: Baixa por perda, Baixa do protesto, Liquidado em cartório e Baixado por renegociação.
* **Tipos positivos**: Baixado, Pago em mãos e Baixado por antecipação.
* **Fora do cálculo**: Baixa por recompra, Baixa por substituição, Baixa por instrução, Baixa por custódia e Baixa por repasse de cheque.
* **0%**: 60 pontos (Positivo)
* **Até 2%**: 40 pontos (Atenção)
* **Até 5%**: 20 pontos (Atenção)
* **Acima de 5%**: 0 pontos (Negativo)
* **Nenhuma baixa considerada**: 30 pontos, neutro
A IA pode citar essas dimensões no resumo e nos pontos de atenção, com valores em reais e quantidade de títulos.
#### Evolução do Score
Abaixo do medidor, o quadro Score de Risco exibe o gráfico **Evolução do Score** com as consultas do Histórico de Score da entidade na empresa (as 20 mais recentes com sucesso), da mais antiga (esquerda) para a mais recente (direita). Ao lado do título, é exibida a variação de pontos desde a primeira consulta do gráfico.
Ao passar o mouse sobre um ponto, é exibida a data/hora, a pontuação e a classificação da consulta; a cor do ponto é a da classificação. Ao clicar em um ponto, abre a mesma consulta anterior do botão **Ver** do Histórico de Score — se os dados daquela consulta não estiverem mais disponíveis, o ponto não abre e a dica informa "Dados não disponíveis".
O gráfico só aparece a partir de 2 consultas; antes disso, exibe "Evolução disponível a partir da 2ª análise por IA.". O gráfico não consome créditos e não aparece na consulta anterior.
#### Avaliando a análise
No rodapé do quadro Resumo do Cedente, sempre que há uma análise por IA exibida (nova ou reaproveitada), aparece a pergunta **Esta análise foi útil?** com os botões **Sim** e **Não**.
Ao clicar em **Sim**, a avaliação é gravada imediatamente. Ao clicar em **Não**, abre o campo "Conte o que não ficou bom (opcional)", com até 500 caracteres; para concluir, clique em **Enviar**. Após gravar, o rodapé passa a exibir "Análise avaliada como útil" ou "Análise avaliada como não útil".
Cada usuário avalia uma única vez cada análise, e a avaliação não pode ser alterada depois de enviada. A avaliação não consome créditos, não altera a análise e não aparece na consulta anterior.
#### Histórico de Score
A ação Histórico de Score abre uma modal com as 20 últimas consultas bem-sucedidas, da mais recente à mais antiga, mostrando **data/hora**, **score/classificação**, **Versão do cálculo** e **Versão da análise**. Quando a consulta foi avaliada, o ícone de feedback aparece ao lado (polegar para cima verde ou polegar para baixo vermelho). A consulta não consome créditos. Sem histórico, é exibida uma mensagem informativa.
Ao clicar em **Ver**, o sistema abre a **Cred Análise no estado da data da consulta**, em modo somente leitura, sem as ações **Consultar Score** e **Histórico de Score**. O botão **Cancelar** retorna ao histórico.
Consultas gravadas antes da criação de um quadro exibem nele "Dados não disponíveis nesta consulta.".
Caso os dados originais da análise não estejam mais disponíveis, o botão **Ver** fica desabilitado.
### Dados exibidos no dashboard
Cada painel tem um ícone de ajuda (**?**) ao lado do título: ao passar o mouse, é exibida uma dica explicando o que o painel mede e qual população considera. A mesma dica aparece na consulta anterior do Histórico de Score.
#### Indicadores financeiros
* **Volume Operado**: soma do valor dos títulos de operações pagas ao longo de todo o relacionamento.
* **Receita Gerada**: receita apurada nas operações pagas ao longo do relacionamento.
* **Limite Disponível**: limite de crédito cadastrado menos o Risco Atual; fica negativo quando a exposição supera o limite.
* **Risco Atual**: valor em aberto dos títulos de operações pagas que ainda não foram baixados, cancelados ou prorrogados.
* **Utilização do Limite**: percentual do limite ocupado pelo Risco Atual, com o detalhamento de Limite Total, Risco Atual e Disponível. A barra fica amarela a partir de 60% e vermelha a partir de 85%.
* **Saldo Financeiro**: saldo da conta corrente do Cedente na empresa; negativo indica valor devido. Ao clicar no quadro, abre o extrato.
* **Operações**: data da 1ª operação, data da última operação, prazo médio dos títulos e quantidade de operações pagas.
#### Performance de pagamento e inadimplência
* **Performance de Pagamento**: valor, quantidade e percentual pago em dia e pago em atraso, por faixa (últimos 30, 31 a 60, 61 a 90 e 91 a 120 dias) e total histórico.
* **Inadimplência**: total em atraso, com o percentual por quantidade, o percentual por valor e a média de dias em atraso. Ao clicar no quadro, abre a lista dos títulos.
#### Títulos a Vencer e Títulos Vencidos
{% hint style="warning" %}
*Títulos com vencimento no **Final de semana** e **Feriado** serão contabilizados no **próximo dia útil**.*
{% endhint %}
* **Títulos a Vencer**: valor, quantidade e percentual por faixa de vencimento (próximos 30, 31 a 60, 61 a 90 e acima de 91 dias), com a linha **Total** da carteira a vencer.
* **Títulos Vencidos**: valor, quantidade e percentual por faixa de atraso (até 7, 8 a 15, 16 a 30 e acima de 30 dias), com a linha **Total** da carteira vencida.
Ao clicar em uma faixa ou na linha **Total** de Títulos a Vencer e Títulos Vencidos, abre a lista dos títulos correspondentes, ordenada pela data de vencimento.
#### Devoluções e Protestos e Confirmações de Sacado
**Devoluções e Protestos**: quadro exibido logo abaixo de Títulos a Vencer, nos perfis Cedente e Sacado:
* **Devolvidos (histórico)**: quantidade e valor de face dos títulos que tiveram ao menos uma devolução em qualquer momento do relacionamento, mesmo que hoje estejam baixados (cada título conta uma única vez).
* **Protestados (histórico)**: quantidade e valor de face dos títulos com protesto registrado sem estorno posterior, mesmo que hoje estejam baixados.
* **Devolvidos em aberto**: quantidade e valor em aberto dos títulos com situação atual Devolvido.
* **Protestados em aberto**: quantidade e valor em aberto dos títulos com situação atual Protestado.
* **Sobre o volume operado**: percentual do valor devolvido e protestado no histórico sobre o Volume Operado.
Ao clicar em **Devolvidos em aberto** ou **Protestados em aberto**, abre a lista dos títulos. As linhas de histórico e "Sobre o volume operado" não são clicáveis. Sem ocorrências, é exibida a mensagem "Nenhuma devolução ou protesto registrado para este cedente.".
**Confirmações de Sacado**: quadro exibido ao lado de Devoluções e Protestos. Considera os títulos em aberto de operações pagas (a mesma base do Risco Atual), com valor, quantidade e percentual sobre o Risco Atual:
* **Confirmados**: valor confirmado igual ou maior que o valor do título.
* **Confirmados parcialmente**: valor confirmado maior que zero e menor que o valor do título.
* **Não confirmados**: nenhuma confirmação registrada.
* **Total**: igual ao Risco Atual.
Ao clicar em Confirmados, Confirmados parcialmente ou Não confirmados, abre a lista dos títulos daquela situação. Sem títulos em aberto, é exibida a mensagem "Nenhum título em aberto para confirmar.".
#### Recompra e Prorrogação
* **Recompra**: valor, quantidade e percentual dos títulos recomprados, por faixa (últimos 30, 31 a 60, 61 a 90 e acima de 91 dias).
* **Prorrogação**: valor, quantidade e percentual dos títulos prorrogados, nas mesmas faixas da Recompra.
#### Concentração por Sacado e Distribuição das Prorrogações
**Concentração por Sacado**: exibida à esquerda da Distribuição das Prorrogações. Lista os cinco maiores sacados por valor em aberto, com valor, quantidade de títulos e percentual de cada um sobre o Risco Atual — útil para identificar dependência excessiva de um único sacado. Acima de 70% no primeiro sacado, o quadro exibe alerta de alta concentração. No perfil Sacado, o quadro se chama **Concentração por Cedente** e lista os cinco maiores cedentes que descontaram títulos contra o sacado.
**Distribuição das Prorrogações**: exibida à direita da Concentração, com valor, quantidade e percentual das prorrogações por faixa de dias (até 7, 8 a 15, 16 a 30 e acima de 30 dias).
#### Dados da Carteira
* **Valor médio dos títulos** e **Taxa média dos títulos**.
* **Valor médio do fomento à produção** e **Prazo médio de liquidação do fomento à produção**.
* **Valor médio das operações** e **Prazo médio das operações**.
* **Valor médio dos empréstimos** e **Prazo médio dos empréstimos**.
No rodapé da ficha, são exibidos a data/hora em que o painel foi gerado e a **Versão dos dados** usada.
## Lista Negra
A "Lista Negra" funciona como uma **ferramenta de consulta interna** para identificar **Sacados** ou parceiros **Cedente**s que já tiveram **ocorrências negativas**, como devolução de títulos, inadimplência ou descumprimento de acordos.
Ao registrar uma pessoa ou empresa na Lista Negra, ela **não é automaticamente enviada a órgãos de proteção ao crédito** (como Serasa ou SPC), mas fica **disponível para consulta pelos usuários do sistema**.
Dessa forma, ao cadastrar um novo título ou realizar uma venda, a equipe pode verificar rapidamente se o cliente possui histórico de problemas, **reduzindo riscos financeiros**.
Para cadastrar clique em **+Adicionar Lista Negra.**
Em seguida preencha os seguintes campos:
* **Cedente**: Quem emitiu o título (credor ou fiador do título, **campo obrigatório**).
* **Sacado**: Quem deve pagar o título (devedor, **campo obrigatório**).
* **Número documento**: Identificação do documento relacionado à dívida.
* **Motivo devolução**: Razão pela qual o título está sendo devolvido ou incluído na lista negra (para cadastrar devolução acesse [Motivos Devolução](/cadastros/motivos-devolucao.md)).
* **Observação**: Espaço para inserir comentários adicionais.
* **Valor**: Valor da dívida (**campo obrigatório**).
* **Data acerto**: Data do acordo ou tentativa de resolução. Caso deixar o campo em branco a **Situação** do registro ficará como **Não pago**. Para alterar para **Pago** basta clicar em **Acertar**, ou para lançar como **Pago** basta preencher o campo **Data acerto.**
Irá abrir uma nova tela para informar a data de acerto e em seguida clique em **Acertar**.
E a situação do lançamento mudará para **Pago**.
Botões:
* **Salvar** (botão verde): Para confirmar e salvar as informações (**habilitado após preencher os campos obrigatórios**).
* **Cancelar**: Para fechar o formulário sem salvar.
O registro cadastrado poderá ser consultado na aba **Lista Negra**.
