Introdução
A baixa da negativação é o processo onde é possível solicitar à remoção do pedido de negativação, outrora enviado e aceito pela Serasa.
O pedido de baixa da negativação pode ocorrer por diversos motivos, e geralmente, está relacionado à quitação da dívida que motivou o pedido de negativação.
Se trata da primeira etapa de um processo assíncrono, onde o sistema integrado com nossa API poderá realizar o pedido de negativação e obterá um protocolo em caso de sucesso. Este protocolo deverá ser consultado na segunda etapa do processo de consulta, para que se tenha acesso ao resultado da consulta desejado.
Definições da requisição:
Método
POST
URL da API
Produção:
https://api.consultanegativacao.com.br/v1/negativacao/remover
Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/negativacao/remover
Headers
Os headers necessários para a autenticação da requisição são:
| Header | Descrição |
| cnpjsh | CNPJ da Software House que possui contrato com a Tecnospeed |
| tokensh | Token de autenticação da Software House (obtido através deste processo) |
| cnpjUsuario |
CNPJ do usuário responsável pela consulta. O CNPJ deve, obrigatoriamente, ter sido cadastrado pela rota de cadastro de empresas, descrito neste link. |
| login |
Login de acesso disponibilizado pela SCC. O login será disponibilizado após a realização do cadastro da empresa, descrito neste link. |
| password |
Senha de acesso disponibilizada pela SCC. A senha será disponibilizada após a realização do cadastro da empresa, descrito neste link. |
Body
O JSON enviado na solicitação deve conter os seguintes campos:
| Campo | Tipo | Descrição | Obrigatório | Observações |
| protocolo | string | Protocolo retornado ao usuário no momento da inclusão da negativação | Sim | |
| codMotivo | string |
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 |
Exemplo de JSON de Envio
Exemplo de Retorno
Status=200 - Sucesso
Status=401 - Falta de autorização
Onde:
| Campo | Tipo | Descrição |
|---|---|---|
| code | numérico | Código de erro que identifica a falha na autorização da requisição |
| message | string | Mensagem de erro que orienta quanto ao problema. Neste caso, recomenda-se a validação das credenciais de autenticação da rota |
Status=422 - Falha de processamento - Autenticação
Onde:
| Campo | Tipo | Descrição |
|---|---|---|
| code | numérico | Código de erro que identifica a falha na autorização da requisição |
| message | string | Mensagem de erro que orienta quanto ao problema. Neste caso, recomenda-se a validação das credenciais de autenticação da rota |
| errors | Objeto | Lista de erros identificadas e que impossibilitaram o processamento da requisição |
| internalCode | numérico |
Código de erro interno Obs.: Lista de erros em criação pela Tecnospeed |
| message | string | Mensagem de erro que orienta quanto ao problema. |
Obs.: O processo de negativação é realizado utilizando os serviços de consulta oferecidos pela SCC Check, parceira da Tecnospeed nas consultas.
Comentários
0 comentário
Por favor, entre para comentar.