Baixando a negativação – Central de Atendimento

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

{

    "protocolo": "string",

    "codMotivo": "1"
}

Exemplo de Retorno

Status=200 - Sucesso

{

    "protocolo": "aaabbb",

    "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"

    }
}

Status=401 - Falta de autorização

{

    {

        "code": 401,

        "message": "Unprocessable Entity"

    }
}

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

{

    "code": 422,

    "message": "Unprocessable Entity",

    "errors": [

        {

            "message": "Negativação já foi solicitada, utilize a rota de consulta para mais informações",

            "internalCode": 40090

        }

    ]
}