> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/serasa-analise-de-credito.md).

# Serasa Análise de Crédito

### Visão geral

Esta integração automatiza o processo de tomada de decisão financeira no fluxo de vendas. O objetivo principal é permitir que o Consistem ERP envie os dados de um pedido de venda para a Serasa, que realiza uma análise de risco em tempo real. Com base no retorno da API da Serasa, o sistema define automaticamente se o pedido seguirá o fluxo comercial normal ou se será bloqueado para avaliação interna, mitigando riscos de inadimplência.

### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Serasa Análise de Crédito</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Comercial, Financeiro e Cadastros Gerais.<br><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>CRDS</strong> ativa junto à Consistem.</p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br><a href="https://www.serasa.com.br/">Saiba mais</a></td></tr><tr><td></td><td><strong>Contratação:</strong> Conta ativa junto à Serasa Experian com o produto Gestor de Crédito Serasa (API) habilitado.</td></tr><tr><td></td><td><strong>Credenciais:</strong> Obtenção de chaves de acesso (API Keys/Tokens) e parâmetros de autenticação fornecidos pela Serasa para consumo dos endpoints.</td></tr></tbody></table>

### Configuração da integração

**No Consistem ERP:**

1. **Configuração de Conexão e Credenciais:** A parametrização inicial de comunicação deve ser efetuada no programa [Integração com análise de crédito do Serasa - Configuração (CCCCS003)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-para-o-serasa/integracao-com-analise-de-credito-do-serasa-configuracao.md). Neste programa, o consultor de implantação deve:
   1. Inserir as URLs de Endpoints (Produção e Homologação) fornecidas pela Serasa.
   2. Cadastrar as chaves de autenticação (API Keys / Tokens / Client ID e Client Secret).
   3. Definir o tempo limite de espera (*Timeout*) da requisição para garantir que o ERP não trave a digitação do pedido caso a API da Serasa sofra alguma instabilidade momentânea.<br>

      <figure><img src="/files/8fs7PuAQGxc1rTm3qYni" alt=""><figcaption></figcaption></figure>
2. **Configuração de Permissões por Usuário:** Acesse o programa [Configuração de Permissão de Análise de Crédito (CCCCC055)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/cadastros-da-aprovacao-de-credito/configuracao-de-permissao-de-analise-de-credito.md) para determinar a governança do processo:
   1. Vincule os usuários do ERP que possuem autonomia para avaliar e realizar a liberação manual de pedidos retidos.
   2. Configure e visualize os limites de alçada e as permissões de visualização das liberações de crédito de cada operador.<br>

      <figure><img src="/files/WPDleh7qZPsO0ZjC9SDR" alt=""><figcaption></figcaption></figure>
3. **Ativação da Regra (Gestor de Crédito Serasa):** A ativação do uso da API não exige uma parametrização manual em telas de cobrança tradicionais. Ela ocorre de forma automatizada pelo sistema:
   1. Uma vez ativada e homologada a licença do módulo de integração da Serasa na chave do Consistem ERP, as rotinas e regras de verificação padrão passam a adotar automaticamente a validação externa.
   2. O motor de crédito do ERP redireciona o fluxo de análise para a regra Gestor de Crédito Serasa (API) no momento em que os pedidos passam pelo processo de validação.

**No Serasa Análise de Crédito:**

1. **Parametrização da Política no Portal:** Acesse o painel web do Gestor de Crédito Serasa Experian para:
   1. Configurar a matriz de decisão (regras de *Score*, faixas de risco aceitáveis e critérios de negação automática).
   2. Garantir que os modelos de resposta estejam alinhados para retornar exatamente os status esperados pelo ERP: *Aprovado*, *Reprovado* ou *Revisão*.

### Como a integração funciona

A integração opera de forma síncrona e automatizada via API REST utilizando o formato JSON para a troca de dados.

Quando um pedido é gerado ou liberado no Consistem ERP, o sistema faz uma chamada externa consumindo os endpoints da API da Serasa. O Consistem ERP envia as informações cadastrais do cliente (CNPJ/CPF) e os dados financeiros do pedido. A Serasa processa os dados sob a regra do *Gestor de Crédito*, devolvendo o status da análise (*Aprovado*/*Reprovado*/*Revisão*) junto com os códigos dos motivos da decisão.

### Fluxo do processo

O fluxo de integração segue as etapas abaixo, desde a digitação do pedido até a sua resolução financeira:

1. **Geração do Pedido:** O processo é iniciado pelo usuário ao cadastrar um pedido de venda no sistema. Durante a gravação ou no momento do [Confrontamento do Pedido Cadastrado no Sistema (CCCCC010)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/aprovacao-de-credito/confrontamento-do-pedido-cadastrado-no-sistema.md), o ERP aciona automaticamente a rotina de validação de crédito.
2. **Disparo da Requisição (Envio):** O Consistem ERP gera uma chamada síncrona via API REST (JSON) enviando os seguintes dados para a Serasa:
   1. **Identificação do Cliente:** CPF ou CNPJ.
   2. **Dados Financeiros:** Valor total do pedido, prazos e condições de pagamento.
3. **Processamento e Retorno:** A API da Serasa recebe a requisição, processa as informações com base nas regras do Gestor de Crédito e devolve imediatamente o status da análise (Aprovado, Reprovado ou Revisão), acompanhado dos códigos com os motivos da decisão.
4. **Decisão Automatizada no ERP:**
   1. **Se Aprovado:** O pedido é liberado de forma automática para seguir o fluxo comercial e de faturamento padrão.
   2. **Se Reprovado ou Pendente de Revisão:** O pedido é bloqueado na hora. O histórico completo desta transação fica gravado para auditoria no programa [Consulta de Pedidos Analisados Crédito Serasa (CCCCC755)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/aprovacao-de-credito/consulta-de-pedidos-analisados-credito-serasa.md).
5. **Tratamento de Bloqueios (Ação do Usuário):** Para os pedidos bloqueados, o analista de crédito deve acessar a tela [Consulta e Liberação de Pedidos Bloqueados (CCCCC720)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/aprovacao-de-credito/consulta-e-liberacao-de-pedidos-bloqueados.md). Nesta tela, o sistema exibe detalhadamente os motivos do bloqueio retornados pela API da Serasa, permitindo que o usuário tome a decisão de liberar ou manter o pedido retido com base em informações precisas.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/serasa-analise-de-credito.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
