O processo de baixa da negativação é realizado por uma rota POST, onde você irá utilizar o protocolo retornado no momento da inclusão, e juntamente com o protocolo você irá informar o Código do Motivo, que seria o motivo da baixa do devedor.
É esta rotina que você deverá utilizar para remover a negativação de um CNPJ que esteja negativado junto à Serasa.
Definição da Requisição
A solicitação é feita através de uma requisição POST. A rota chamada deve ter a seguinte URL:
Produção:
https://api.consultanegativacao.com.br/v1/negativacao/remover
Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/negativacao/remover
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 |
Body
Este é o json que deve ser enviado no body da requisição (como application/json)
{ "protocolo": "string", "codMotivo": "1" }
Definição dos campos do body da requisição:
Campo | Descrição | Obrigatório/Observação |
protocolo | Protocolo retornado ao usuário no momento da inclusão. | Sim. |
codMotivo |
Código do motivo da baixa do devedor. 1- Pagamento da dívida. 2- Renegociação da dívida. 3- Por solicitação do cliente. 4- Ordem Judicial. 22- Correção de dados. |
Sim. |
Retornos
Em caso de sucesso:
- Status code 200:
"protocolo": "2",
"cnpjCredor": "00000000000000",
"nome": "TESTE",
"situacao": "NEGATIVACAO_BAIXA_ENVIADA",
"documento": "50520000000000",
"endereco": "Teste",
"bairro": "JD TESTES",
"municipio": "MARINGA",
"uf": "PR",
"cep": "87045430",
"valor": "0",
"divida": {
"nossoNumero": "10",
"especieTitulo": "3",
"numDocumento": "123",
"dataEmissao": "2019-01-01",
"dataVencimento": "2019-05-18",
"valorTitulo": 0.1,
"codEndosso": "1",
"codAceite": "1"
}
}
Em caso de erro:
- StatusCode: 422
"code": 422,
"message": "Unprocessable Entity",
"errors": [
{
"message": "Negativação já foi solicitada, utilize a rota de consulta para mais informações",
"internalCode": 40090
}
]
}
- StatusCode: 401
Nos retornos acima, o objeto "errors" trará a listagem de erros que poderão ter ocorrido na solicitação de baixa da negativação. E o campo "message" trará uma mensagem informando o motivo do erro.
Comentários
0 comentário
Por favor, entre para comentar.