Introdução
A solicitação da negativação é o método pelo qual o pedido efetivamente feito à SCC/Serasa.
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
Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/negativacao
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 |
| nome | string | Nome completo do devedor, sem abreviações. | Sim | |
| documento | string | Numeração do documento do devedor. | Sim | RG ou CPF |
| endereco | Endereço (correto) completo do devedor, contendo o número. | Sim | ||
|
enderecoComplemento |
Complemento do endereço do devedor, quando existir | Não | ||
| bairro | Bairro do devedor | Sim | ||
| municipio | Município do devedor. | Sim | ||
| uf | string | Sigla da unidade federativa do devedor. | Sim | 2 caracteres |
| cep | string | CEP do endereço do devedor. | Sim | |
| nossoNumero | Número de identificação da dívida | Sim | ||
| especieTitulo | string |
Código do tipo de documento da dívida. Códigos e Descrição: 1: Diversos quando não enquadrar na relação. |
Sim | |
| numDocumento | Número do documento que foi emitido e que se caracteriza como título vencido. | Sim | ||
| dataEmissao | Data em que o documento que caracteriza o débito foi emitido. | Sim | O formato da data deverá ser Ano-Mês-Dia. Exemplo: 2024-12-31 | |
|
dataVencimento |
string | Data de vencimento do documento. | Sim |
O documento deve estar vencido no mínimo a 5 dias e no máximo a 5 anos. O formato da data deverá ser Ano-Mês-Dia. Exemplo: 2018-12-31. |
| valorTitulo | numérico | Valor exato do documento. | Sim | Valor original, sem multa e sem juros. |
| numAgencia | string | Número da agência do cheque. | Não |
brigatório apenas quando o código do tipo do documento da dívida for igual a 2. Informar somente números. |
| numConta | string | Número da conta do cheque. | Não |
Obrigatório apenas quando o código do tipo do documento da dívida for igual a 2. Informar somente números. |
| codBanco | string | Código do banco do cheque. | Não |
Obrigatório apenas quando o código do tipo do documento da dívida for igual a 2. Informar somente números. |
| numCheque | string | Número do cheque | Não | Obrigatório apenas quando o código do tipo do documento da dívida for igual a 2. |
| codAlinea | string |
Código da Alínea. Se trata do "problema", o motivo da devolução do cheque. Códigos e Descrição: 12: Insuficiência de fundos - 2ª apresentação. |
Não | Obrigatório apenas quando o "especieTitulo" for igual a 2 (Cheque). Informar somente números. |
| codEndosso | string |
Código do tipo do Endosso. Utilizado quando existe um avalista na dívida. Códigos e Descrição: 1: Mandato. |
Sim | |
|
codAceite |
string |
Código do Aceite. Códigos e Descrição: 1: Aceitos. |
Sim |
Exemplo de JSON de Envio
Exemplo de Retorno
Status=200 - Sucesso
Onde:
Ao receber um statusCode 200 na requisição, é de extrema importância que o protocolo retornado seja salvo, pois o acompanhamento do processo de negativação depende inteiramente da consulta deste protocolo.
Cada pedido de negativação realizado com sucesso (ou seja, com geração de um protocolo) gera uma cobrança automática, creditando o valor negociado com nosso setor comercial. Mensalmente tais valores são somados e constarão na fatura do cliente. Por conta disso, a Tecnospeed recomenda que o uso das consultas seja realizado sob controle do ERP e não nos responsabilizamos por consultas indevidas realizadas em nossos sistemas.
Obs.: A confirmação de uma negativação, feita pela Serasa, leva cerca de 15 dias. No próximo post, onde detalharemos a rota de consulta, você verá com mais detalhes como acompanhar este processo.
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.