Cadastrando as empresas (usuários) – Central de Atendimento

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://api.consultanegativacao.com.br/v2/homologacao/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 (Necessário que o número tenha acesso ao Whatsapp para obter acesso ao contrato/termo encaminhado pela SCC)
email	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		*Consulta não disponível na V2
codConsulta1PJ	numérico
codConsulta4PJ	numérico		*Consulta não disponível na V2
codConsulta600	numérico
codConsulta601	numérico
codConsulta602	numérico
codConsulta603	numérico
codConsultaNegativacao	numérico

Exemplo de JSON de Envio

{

 "nomeFantasia": "Empresa Teste",

 "razaoSocial": "Empresa Teste LTDA",

 "cnpj": "11111111111111",

 "nomeRepresentante": "Teste Representante",

 "cpfRepresentante": "11111111111",

 "telefone": "999999999",

 "telefoneDDD": "44",

 "email": "teste@teste.com.br",

 "endereco": "Av Duque De Caxias",

 "numeroEndereco": "111",

 "complementoEndereco": "",

 "bairro": "Centro",

 "cep": "870000000",

 "cidade": "Maringá",

 "uf": "PR",

 "nomeResponsavelContrato": "Nome Teste",

 "telefoneResponsavelContrato": "4499999999",

 "emailResponsavelContrato": "teste@teste.com.br",

 "taxas": {

    "codConsulta1PF": 11.00,

    "codConsulta4PF": 12.50,

    "codConsulta1PJ": 8.90,

    "codConsulta4PJ": 12.70,

    "codConsulta600": 12.50,

    "codConsulta601": 12.90,

    "codConsulta602": 29.51,

    "codConsulta603": 35.69,

    "codConsultaNegativacao": 9.92

 }
}

Exemplo de Retorno

Status=200 - Sucesso

{

    "msg": "Cliente incluído com sucesso!",

    "logon": "*******",

    "senha": "*******"
}

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.

Obs: Se um cadastro for criado tanto em homologação quanto em produção com o mesmo CNPJ, o registro em homologação será automaticamente excluído. A partir da criação em produção, o cadastro seguirá exclusivamente o fluxo de produção, deixando de existir em homologação.

Após o recebimento do retorno indicando o sucesso no cadastro, e a recepção do "logon" e da "senha", o cliente receberá um e-mail no endereço indicado, e deverá realizar a assinatura do contrato junto à SCC.

Após a assinatura deste contrato as consultas estarão liberadas para serem utilizadas em produção.