> 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.md). # Serasa ### Visão Geral A integração entre o Consistem ERP e o Serasa visa automatizar e centralizar a consulta de históricos cadastrais, restrições financeiras (como PEFIN) e dados de adimplência diretamente na plataforma de gestão. O principal objetivo é otimizar a tomada de decisões no processo de análise, concessão e aprovação de crédito, reduzindo o risco de inadimplência através de consultas automatizadas ou manuais. ### Requisitos
Consistem ERPSerasa

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Comercial, Financeiro (Contas a Receber) e Cadastros Gerais.

Módulo Adicional: Liberação do módulo específico de Análise de Crédito Serasa (caso opte pelo modelo de análise via API da inteligência do Serasa).

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.
Saiba mais
Credenciais: Código do cliente e Senha de acesso.
Migração de Tecnologia: Formulário de migração preenchido (obrigatório para a transição do modelo antigo de comunicação String para o modelo moderno de API, visto que o acesso String passará por desativação progressiva). Link para o formulário.
### Configuração da Integração **No Consistem ERP:** 1. Acesse o programa [Configuração para a Consulta no Serasa para o Histórico do Cliente (CCCCS025)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracoes-de-contas-a-receber/configuracao-para-a-consulta-no-serasa-para-o-historico-do-cliente.md). Esta tela permite tratar as duas tecnologias de maneira híbrida, mas apenas uma delas deve ser mantida ativa por vez para evitar conflitos de processamento nas consultas de histórico. 1. O preenchimento da parametrização varia conforme o **Tipo de Requisição** selecionado: 1. **Para o modelo String (Legado):** Informe o Código do Cliente (completando com espaços à direita) e a Senha de acesso.
2. **Para o modelo API (Novo):** É necessário preencher as credenciais de autenticação web nos campos de Identificação do Usuário (Client ID), Senha do Usuário (Client Secret) e Token de Acesso gerado.
2. Execute o programa de [Configuração do Menu de Histórico do Cliente (CCCC095)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracoes-de-contas-a-receber/configuracao-do-menu-de-historico-do-cliente.md) para parametrizar a sequência de amostragem na visualização das consultas. Certifique-se de liberar e ordenar o item **Consulta SERASA** para que ele apareça na [Consulta do Histórico do Cliente (CCCCF600)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/clientes/consulta-do-historico-do-cliente.md).
3. Acesse o programa [Configuração para a Geração das Informações do Pefin do Serasa (CCCCS200)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-pefin-do-serasa/configuracao-para-a-geracao-das-informacoes-do-pefin-do-serasa.md) para realizar as configurações corporativas e de prazos limites para a negativação de devedores.
4. No programa [Configuração para a Geração das Informações do Relato Reciprocidade do Serasa (CCCCS150)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/configuracao-para-a-geracao-das-informacoes-do-relato-reciprocidade-do-serasa.md), parametrize as regras de datas, periodicidade e leiautes de envio das informações comportamentais do Contas a Receber.
**No Serasa:** 1. **Instalação do Certificado:** Caso o ambiente utilize chamadas seguras com autenticação mútua (SSL/TLS), garanta que a cadeia de certificados do Serasa está atualizada e instalada no arquivo `serasahttp.keystore` no servidor Java corporativo. 2. **Homologação de Endpoints:** Solicite ao Serasa a liberação dos endpoints produtivos de acordo com o modelo de requisição escolhido (seja para a URL clássica HTTPS ou para a API Rest do Gestor de Crédito). ### Como a Integração Funciona A comunicação técnica e a troca eletrônica de dados ocorrem em segundo plano (M2M) de forma híbrida no sistema, dividindo-se de acordo com o modelo de serviço: **Consultas de Histórico e Crédito (Web Services / API)** * **Protocolo e Conexão:** Comunicação síncrona de tempo de execução processada sob protocolo criptografado seguro HTTPS. * **O que o Consistem Envia:** Uma requisição contendo o documento (CPF ou CNPJ) a ser pesquisado. Na transmissão via API, os parâmetros trafegam encapsulados em JSON padrão REST. * **O que o Consistem Recebe:** O servidor do Serasa processa a análise e devolve a resposta estruturada em JSON (no modelo API) contendo o Score de crédito, pendências, cadastros e restrições financeiras ativas. O barramento do ERP interpreta os dados diretamente em memória e preenche a tela de forma imediata, sem gerar ou gravar arquivos físicos locais de envio ou retorno. * **Criptografia:** O tráfego depende da autenticação mútua (SSL/TLS) validada pelo arquivo de chave de segurança `serasahttp.keystore` hospedado no servidor Java do ERP. **Geração e Leitura do PEFIN (Arquivos Posicionais)** * **Modelo de Transmissão:** Comunicação assíncrona por troca de arquivos de dados estruturados. O Consistem ERP opera sem caminhos de rede fixos no servidor, eliminando a gravação de arquivos com nomes estáticos locais. * **O que o Consistem Envia:** Arquivo posicional (texto) gerado dinamicamente que contém blocos lógicos com dados cadastrais de devedores (Razão Social, CNPJ/CPF e endereço) e informações do débito em aberto (Data de emissão, vencimento, valor nominal e número do título). * **O que o Consistem Recebe:** Arquivo de retorno posicional emitido pelo Serasa contendo a confirmação das inclusões das negativações ou a validação de inconsistências de registros. * **Leiaute Utilizado:** Padrão posicional CNAB de negativação em lote determinado pela Serasa Experian (PEFIN). **Relato de Reciprocidade (Arquivos de Dados de Pagamentos)** * **Modelo de Transmissão:** Geração sob demanda de arquivos no formato texto (`txt`). As operações de download do arquivo gerado ou upload de conciliação ocorrem dinamicamente por requisições da interface do navegador para a estação do operador. * **O que o Consistem Envia:** Dados comportamentais agregados da carteira ativa de clientes do Contas a Receber, como o histórico de títulos quitados no prazo, liquidados com atraso e os valores com vencimentos pendentes. * **O que o Consistem Recebe:** Arquivo estruturado contendo a validação e a conciliação do Serasa sobre os registros comportamentais integrados ao bureau. * **Leiaute Utilizado:** Padrão posicional de dados de comportamento de pagamento (Reciprocidade) estabelecido pela Serasa Experian. ### Fluxo do Processo As interações do operador com a integração Serasa no Consistem ERP ocorrem em momentos distintos e por meio de programas independentes no sistema: 1. **Consulta de Crédito (Rotina Diária / Comercial)**

Este processo é executado individualmente pelo operador no momento de avaliar um cadastro ou a liberação de um pedido de venda.

1. O operador acessa o programa [Consulta do Histórico do Cliente (CCCCF600)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/clientes/consulta-do-historico-do-cliente.md) e carrega o cadastro do cliente desejado. 2. Com o cliente na tela, o usuário acessa o menu superior do sistema e seleciona o botão **Menu** > Opção *Consulta Serasa*. 3. O sistema exibe em tempo real o score e o relatório de restrições na tela [Consulta Serasa (CCCCF606)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/clientes/consulta-serasa.md). O operador analisa as informações e decide pela liberação, bloqueio ou alteração do limite de crédito do cliente no ERP. 2. **Geração do Relato de Reciprocidade (Rotina Mensal / Financeira)**

Este processo é executado periodicamente para enviar dados comportamentais de pagamento e obter tarifas diferenciadas junto ao Serasa.

1. **Seleção da Remessa:** O operador deve acessar o programa de geração correspondente à necessidade do período de fechamento financeiro: 1. **Para a geração periódica padrão da carteira:** O usuário acessa a [Geração do Arquivo de Informações do Relato de Reciprocidade do Serasa (CCCCS175)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/geracao-do-arquivo-de-informacoes-do-relato-de-reciprocidade-do-serasa.md) para compilar o comportamento de pagamentos padrão de toda a carteira ativa de clientes. 2. **Para gerar ajustes ou correções de envios anteriores:** O usuário acessa a [Geração das Correções/Conciliações de Informações do Relato Reciprocidade do Serasa (CCCCS170)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/geracao-das-correcoes-conciliacoes-de-informacoes-do-relato-reciprocidade-do-serasa.md) caso precise retificar informações comportamentais enviadas anteriormente ou processar conciliações pontuais de divergências apontadas pelo Serasa. 3. **Ação na tela:** Em ambos os programas, o operador deve informar os parâmetros de filtro (como o período de datas) pré-estabelecidos na [Configuração para a Geração das Informações do Relato Reciprocidade do Serasa (CCCCS150)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/configuracao-para-a-geracao-das-informacoes-do-relato-reciprocidade-do-serasa.md). 2. **Geração e Download:** Dentro do programa selecionado ([Geração do Arquivo de Informações do Relato de Reciprocidade do Serasa (CCCCS175)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/geracao-do-arquivo-de-informacoes-do-relato-de-reciprocidade-do-serasa.md) ou [Geração das Correções/Conciliações de Informações do Relato Reciprocidade do Serasa (CCCCS170)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/geracao-das-correcoes-conciliacoes-de-informacoes-do-relato-reciprocidade-do-serasa.md)), o operador clica no botão **Gerar**. O sistema processará os dados e disponibilizará o botão de **Download** diretamente na tela para que o usuário salve o arquivo de remessa (`.txt`) em sua máquina. 3. **Envio ao Serasa:** O operador acessa o portal web da Serasa Experian (fora do ERP), faz o login com suas credenciais e realiza o upload do arquivo de remessa baixado. 4. **Leitura do Retorno:** Após o Serasa processar o lote de reciprocidade, o operador faz o download do arquivo de retorno/conciliação no próprio portal do Serasa. 5. **Importação no ERP:** O usuário acessa o programa correspondente para processar o retorno: 1. Para retornos de processamento padrão, utiliza a [Leitura do Arquivo de Retorno de Informações do Relato de Reciprocidade do Serasa (CCCCS180)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/leitura-do-arquivo-de-retorno-de-informacoes-do-relato-de-reciprocidade-do-serasa.md). 2. Para conciliações de divergências, utiliza a [Leitura do Arquivo e Geração da Conciliação de Informações do Relato de Reciprocidade do Serasa (CCCCS185)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-relato-reciprocidade-do-serasa/leitura-do-arquivo-e-geracao-da-conciliacao-de-informacoes-do-relato-de-reciprocidade-do-serasa.md). 3. **Ação na tela:** O operador clica no botão de **Importar Arquivo** disponível na tela, seleciona o arquivo de retorno que baixou do Serasa e o ERP atualiza a situação cadastral do lote automaticamente. 3. **Negativação de Inadimplentes (Rotina de Cobrança / PEFIN)**

Este processo é executado pelo setor de cobrança para gerenciar e negativar títulos vencidos e não quitados.

1. **Filtro de Títulos:** O operador financeiro acessa o programa [Geração do Arquivo de Informações do Pefin do Serasa (CCCCS215)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-pefin-do-serasa/geracao-do-arquivo-de-informacoes-do-pefin-do-serasa.md). Ele informa os filtros de período e carteira desejados. O ERP listará na tela todos os devedores qualificados com base nos parâmetros predefinidos no programa [Configuração para a Geração das Informações do Pefin do Serasa (CCCCS200)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-pefin-do-serasa/configuracao-para-a-geracao-das-informacoes-do-pefin-do-serasa.md). 2. **Geração e Download:** O usuário confere os títulos listados na grade e clica no botão **Gerar Arquivo**. O sistema compila o lote de negativação e o usuário realiza o **Download** do arquivo diretamente pela interface do sistema em sua estação de trabalho. 3. **Envio de Negativação:** O operador acessa o portal web da Serasa Experian, realiza o upload do arquivo de remessa para registrar oficialmente as negativações dos clientes inadimplentes no mercado. 4. **Baixar Retorno de Processamento:** Quando o Serasa conclui o registro do lote, ele disponibiliza um arquivo de retorno. O operador realiza o download desse arquivo diretamente no portal do Serasa. 5. **Importação e Baixa de Restrições:** O operador acessa o programa [Leitura do Arquivo de Retorno das Informações do Pefin do Serasa (CCCCS220)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/informacoes-do-pefin-do-serasa/leitura-do-arquivo-de-retorno-das-informacoes-do-pefin-do-serasa.md). Ele clica no botão **Importar Arquivo** do Serasa, seleciona o arquivo de retorno e o Consistem ERP atualiza automaticamente as restrições financeiras e limpa as ocorrências restritivas internas dos clientes regularizados.

Esse conteúdo foi útil?

Sim Não

--- # 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.md?ask=&goal= ``` `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.