Após ser realizado o processo de Solicitação de Negativação, processo visto na etapa anterior, você irá receber um protocolo referente a consulta.
Primeiramente, você utilizou uma rota POST para realizar a solicitação, e recebeu um protocolo referente a este pedido, neste artigo iremos ver sobre o método da realização da consulta do protocolo.
Em posse de seu protocolo, você utiliza uma rota GET para fazer a consulta.
Definição da Requisição
A solicitação é feita através de uma requisição GET. A rota chamada deve ter a seguinte URL:
QueryString
Produção:
https://api.consultanegativacao.com.br/v1/negativacao?protocolo=[protocolo obtido na requisição anterior]
Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/negativacao?protocolo=[protocolo obtido na requisição anterior]
Headers
| Nome | Descrição | Exemplo |
| cnpjSH | CNPJ da Software House que possui contrato com a Tecnospeed | 01001001000113 |
| tokenSH | Token da Software House que possui contrato com a Tecnospeed | f22b97c0c9a3d41ac0a3875aba69e5aa |
| cnpjUsuario | CNPJ do cliente que irá disparar as consultas | 01001001000113 |
| login | Login disponibilizado pela SCC Check após a assinatura do contrato | Ex.: Usuário01 |
| password |
Senha disponibilizada pela SCC Check após a assinatura do contrato |
Ex.: 123@mudar |
Retornos
Conferir o status da negativação
Para identificar o status que seu pedido de negativação se encontra, no json de consulta existirá o campo "situacao", que trará um dos seguintes status:
| Nome | Descrição | Observações |
NEGATIVACAO_PROCESSANDO |
O pedido de negativação ainda está em processamento na SCC. Repetir a consulta (GET) em alguns segundos | |
NEGATIVACAO_ENVIADO |
O pedido de negativação foi enviado para a SCC, e aguardaremos os trâmites legais para sua aplicação | Após o envio, a Serasa entrará em contato com o cliente para informar sobre a dívida e prazo para regularização. |
NEGATIVACAO_ACEITA |
A negativação foi aceita pela Serasa, e o responsável pela dívida receberá o contato da Serasa para que possa quitar a dívida | |
NEGATIVACAO_AGUARDANDO_CORRECAO |
O pedido de negativação foi entregue à SCC, mas não enviado à Serasa por problemas nas informações preenchias (*) | No JSON de resposta, observar o campo "motivo" com a descrição da pendência. |
NEGATIVACAO_REJEITADA |
O pedido de negativação não foi aceito. |
No JSON de resposta, observar o campo "motivo" com a descrição da rejeição. |
NEGATIVACAO_BAIXA_ENVIADA |
O pedido de baixa de uma negativação ativa foi enviado à Serasa |
|
NEGATIVACAO_BAIXADA |
A negativação foi baixada e confirmada pela Serasa |
(*) Caso a consulta retorne "NEGATIVACAO_AGUARDANDO_CORRECAO" existem 2 formas de providenciar o ajuste:
1. Identificar a causa do erro no campo "motivo" do json, e em seguida, fazer a baixa da negativação e reenvia-la com as informações ajustadas;
2. Efetuar o login no sistema da SCC Check e efetuar a correção da negativação que aguarda o ajuste.
Exemplos de retorno:
Em caso de sucesso:
- Status code 200:
{
"protocolo": "string",
"motivo": "string",
"cnpjCredor": "string",
"nome": "string",
"situacao": "string",
"documento": "string",
"endereco": "string",
"enderecoComplemento": "string",
"bairro": "string",
"municipio": "string",
"uf": "string",
"cep": "string",
"valor": "string",
"divida": {
"nossoNumero": "string",
"especieTitulo": "string",
"numDocumento": "string",
"dataEmissao": "string",
"dataVencimento": "string",
"valorTitulo": 0,
"numAgencia": "string",
"numConta": "string",
"codBanco": "string",
"numCheque": "string",
"codEndosso": "string",
"codAlinea": "string",
"codAceite": "string"
},
"historico": [
{
"valor": 0,
"tipoHistorico": "string",
"usuario": "string"
}
]
}
Em caso de erro:
- StatusCode: 422
{
"code": 422,
"message": "Unprocessable Entity",
"errors": [
{
"message": "string",
"internalCode": 0
}
]
}
- StatusCode: 401
{
{
"code": 401,
"message": "Unprocessable Entity"
}
}
Nos retornos acima, o objeto "errors" trará a listagem de erros que poderão ter ocorrido na solicitação da consulta. E o campo "message" trará uma mensagem informando o motivo do erro.
Feito com amor pela Comunicação
Comentários
0 comentário
Por favor, entre para comentar.