Introdução
A rotina de cadastros da API de Consulta de crédito tem como intuito a inclusão de CNPJs responsáveis por realizar as consultas.
Cada CNPJ, cliente da Software House, deve passar pelo processo de cadastro para que sejam incluídos no sistema da Tecnospeed e para que sejam cadastrados também no sistema da SCC Check.
O objetivo final deste cadastro é obter as credenciais de autenticação da SCC, que será retornada em caso de sucesso.
Definições da requisição:
Método
POST
URL da API
Homologação:
https://homologacao.consultanegativacao.com.br/v2/cadastro/taxa
Produção:
https://api.consultanegativacao.com.br/v2/cadastro/taxa
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) |
Body
O JSON enviado na solicitação deve conter os seguintes campos:
| Campo | Tipo | Descrição | Detalhe |
| nomeFantasia | string | Nome fantasia da empresa a ser cadastrada | |
| razaoSocial | string | Razão Social da empresa a ser cadastrada | |
| cnpj | string | CNPJ da empresa a ser cadastrada | |
| nomeRepresentante | string | Nome do representante legal da empresa | |
| cpfRepresentante |
string |
CPF do representante legal da empresa. Informar apenas o valor numérico, sem máscara |
|
| telefonetelefoneDDD | string |
DDD da empresa |
|
| telefone | string |
Telefone da empresa Informar apenas o valor numérico, sem máscara |
|
| string | E-mail principal da empresa a ser cadastrada | ||
| endereco | string | Endereço da empresa a ser cadastrada | |
| numeroEndereco | string | Número do endereço | |
| complementoEndereco | string | Complemento (opcional) | |
| bairro | string | Bairro da empresa a ser cadastrada | |
| cep | string | CEP da empresa a ser cadastrada. Informar apenas o valor numérico, sem máscara |
|
| cidade | string | Cidade da empresa a ser cadastrada. | |
| uf | string | Estado da empresa a ser cadastrada Informar a sigla oficial ABNT com 2 caracteres. |
|
| nomeResponsavelContrato | string | Nome do responsável pela assinatura do contrato de consulta na empresa | |
| telefoneResponsavelContrato | string |
DDD + Telefone do responsável pela assinatura do contrato de consulta na empresa Informar apenas o valor numérico, sem máscara |
|
| emailResponsavelContrato | string | E-mail do responsável pela assinatura do contrato de consulta na empresa | |
| taxas: | objeto | ||
| codConsulta1PF | numérico | Valor de venda da consulta. Consultar a tabela de valores mínimos | |
| codConsulta4PF | numérico | ||
| codConsulta1PJ | numérico | ||
| codConsulta4PJ | numérico | ||
| codConsulta600 | numérico | ||
| codConsulta601 | numérico | ||
| codConsulta602 | numérico | ||
| codConsulta603 | numérico | ||
| codConsultaNegativacao | numérico |
Exemplo de JSON de Envio
Exemplo de Retorno
Status=200 - Sucesso
Onde:
| Campo | Tipo | Descrição |
|---|---|---|
| msg | string | Mensagem informativa informando o sucesso do cadastro |
| logon | string | Credencial de acesso no sistema da SCC. O valor deve ser salvo pois fará parte da autenticação das rotas de consulta. |
| senha | string | Credencial de acesso no sistema da SCC. O valor deve ser salvo pois fará parte da autenticação das rotas de consulta. |
Comentários
0 comentário
Por favor, entre para comentar.