Guia de Integração | Connect Serasa

Integração Connect Serasa

Guia de Configuração, Consultas e Processos de Negativação.

1. Configuração do Gateway

Para iniciar, acesse o menu Sistema → Gateways → Gateway de Proteção de Crédito.

Clique em Adicionar Gateway - Proteção de Crédito e selecione a integração Connect Serasa no campo correspondente.

Detalhamento dos Campos

Nome	Connect Serasa *
Descrição	Texto livre *
Usuário	Login Serasa *
Senha	Senha Consulta *
Parâmetros JSON	Configs. técnicas *

* Indica campo obrigatório.

Parâmetros JSON (Padrão):

{
   "consulta":{
      "servico":"PLANO_USADO",
      "senha":"PASSWORD"
   },
   "negativacao":{
      "sms":false,
      "cpf":"CPF_DO_RESPONSAVEL_PELO_SERVICO",
      "inclusao":{
         "senha":"PASSWORD"
      },
      "baixa":{
         "senha":"PASSWORD"
      }
   }
}

2. Realizando Consultas

Para realizar uma consulta manual de CPF ou CNPJ, siga o caminho abaixo:

Passo a Passo: Acesse o menu Clientes → Cadastrar → Pessoa Física ou Clientes → Cadastrar → Pessoa Jurídica para ter acesso à ferramenta de consulta integrada.

Ao acessar o menu de Cadastro de Clientes, basta clicar no ícone da Lupa ao lado do campo CPF ou CNPJ.

3. Processo de Negativação

Para negativar um débito, o registro deve ser iniciado a partir do financeiro do cliente:

Como solicitar: Acesse o menu Financeiro do cliente → na guia de Títulos localize a fatura em atraso → selecione o título desejado → clique em Outras Opções e selecione Criar Cadastro Negativo.

Atenção: Após o pré-cadastro no título, é obrigatório acessar a aba Cadastro Negativo no financeiro do cliente para efetivar o envio clicando em Registrar.

Botão Registrar: Realiza o envio oficial do débito para a negativação na base da Serasa.

Botão Deletar: Remove apenas a intenção de negativação do sistema local.

4. Relatórios e Gestão

Para auditar e gerenciar todas as inclusões, acesse o menu Relatórios → Contrato → Cadastro Negativo.

Este painel permite acompanhar o status de cada envio e filtrar por período ou unidade.

Filtros Disponíveis

Mostrar	50, 100, 300, 1000 registros
Status Contrato	Ativo, Inativo, Suspenso, etc.
Pops	Filtragem por unidade
Status Cad. Neg.	Gerado, Registrado, Rejeitado, etc.

5. Informações Adicionais

Tipos de serviços disponibilizados pelo Connect Serasa:
CREDNET_PEFIN, CREDNET_LIGHT, INFOBUSCA, RELATO, BASICA e FLAG_NEGATIVOS.

Observação de Custos: Os serviços INFOBUSCA e RELATO possuem tarifa maior; normalmente a própria ConnectaSA direciona para utilizar CREDNET_LIGHT ou CREDNET_PEFIN.
Campo SMS: No JSON, o campo de SMS em caso de ser marcado como True irá enviar um SMS informando o cliente da negativação.
APIKEY: Só é informada caso seja diferente do padrão. O SGP já envia nas requisições um padrão.
Campo CPF: O CPF informado no JSON de negativação será usado para representar quem efetuou a negativação.

Exemplo de JSON para adicionar agregados (Score):
Para adicionar os agregados, é necessário inserir o parâmetro "adicionais": [ "agregado_score"] no djson da gateway como no exemplo abaixo:

{
   "consulta":{
      "servico":"PLANO_USADO",
      "senha":"SENHA_SERVICO"
   },
   "adicionais":[
      "agregado_score"
   ],
   "negativacao":{
      "sms":false,
      "cpf":"CPF_QUE_SERA_USADO",
      "inclusao":{
         "senha":"SENHA_SERVICO"
      },
      "baixa":{
         "senha":"SENHA_SERVICO"
      }
   }
}