O cadastro de um CNPJ é o primeiro passo na integração de um novo cliente que deseja utilizar a API de Consulta de Crédito da Tecnospeed.
O objetivo deste cadastro é fazer o envio das informações da empresa que irá efetuar as consultas para a SCC Check. Os demais passos da consulta (como buscar informações de negativação de um determinado CPF) só poderão ser feitos após a aprovação do CNPJ e assinatura do contrato.
O fluxo de trabalho neste ponto fica:
- Utilizar esta rota para cadastrar o CNPJ que irá disparar as consultas;
- Aguardar o contato da SCC Check, que será feito para a assinatura do contrato;
- Receber da SCC Check o "login" e a "senha" que serão fornecidos após a assinatura e liberação do contrato. Estas 2 informações serão utilizadas no momento de disparar as consultas (passo que veremos a seguir).
Para saber sobre os tipos de taxas disponíveis: clique aqui
Cadastrar um CNPJ
URL Produção:
https://api.consultanegativacao.com.br/v1/cadastro/taxa
URL Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/cadastro/taxa
- Utilize a rota de homologação para simular o valor de repasse para cada consulta
Método: POST
Headers
Nome | Descrição | Exemplo |
cnpjSh | CNPJ da Software House que possui contrato com a Tecnospeed | 01001001000113 |
tokenSh | Token da Software House que possui contrato com a Tecnospeed | CdEZhJcQJS9rRdkLnx2Kl67GhAeBx89X2hzgVQ8i |
cnpjUsuario | CNPJ do cliente que está consultando | 01001001000113 |
Body:
Exemplo de JSON:
{
"nomeFantasia": "Tecnospeed",
"razaoSocial": "Tecnospeed S/A",
"cnpj": "01001001000113",
"nomeRepresentante": "Nome",
"cpfRepresentante": "99999999999",
"telefone": "44999999999",
"email": "contato@tecnospeed.com.br",
"endereco": "Av Duque De Caxias",
"numeroEndereco": "882",
"complementoEndereco": "",
"bairro": "Zona 7",
"cep": "87020025",
"cidade": "Maringá",
"uf": "PR",
"nomeResponsavelContrato": "Nome",
"telefoneResponsavelContrato": "4499999999",
"emailResponsavelContrato": "contato@tecnospeed.com.br",
"taxas": {
"codConsulta1PF": 8.34,
"codConsulta2PF": 33.47,
"codConsulta3PF": 27.47,
"codConsulta4PF": 4.40,
"codConsulta1PJ": 9.27,
"codConsulta2PJ": 33.71,
"codConsulta3PJ": 30.41,
"codConsulta4PJ": 4.82,
"codConsultaNegativacao": 9.92
}
}
Exemplos de retornos:
- Sucesso: StatusCode 200:
{
"nomeFantasia": "Tecnospeed",
"razaoSocial": "Tecnospeed S/A",
"cnpj": "01001001000113",
"nomeRepresentante": "Nome",
"cpfRepresentante": "99999999999",
"telefone": "44999999999",
"email": "contato@tecnospeed.com.br",
"endereco": "Av Duque De Caxias",
"numeroEndereco": "882",
"complementoEndereco": "",
"bairro": "Zona 7",
"cep": "87020025",
"cidade": "Maringá",
"uf": "PR",
"nomeResponsavelContrato": "Nome",
"telefoneResponsavelContrato": "4499999999",
"emailResponsavelContrato": "contato@tecnospeed.com.br",
"status": "Cadastro Efetuado com Sucesso",
"taxas": {
"codConsulta1PF": {
"value": 8.34,
"desconto": 0,
"repasse": 1.8
},
"codConsulta2PF": {
"value": 33.47,
"desconto": 0,
"repasse": 4.82
},
"codConsulta3PF": {
"value": 27.47,
"desconto": 0,
"repasse": 3.95
},
"codConsulta4PF": {
"value": 4.40,
"desconto": 0,
"repasse": 0.5
},
"codConsulta1PJ": {
"value": 9.27,
"desconto": 0,
"repasse": 2.72
},
"codConsulta2PJ": {
"value": 33.71,
"desconto": 0,
"repasse": 6.05
},
"codConsulta3PJ": {
"value": 30.41,
"desconto": 0,
"repasse": 4.37
},
"codConsulta4PJ": {
"value": 5.03,
"desconto": 0,
"repasse": 0.54
},
"codConsultaNegativacao": {
"value": 9.92,
"desconto": 0,
"repasse": 0.4
}
}
}
- Erro: StatusCode 422:
{
"code": 422,
"message": "Unprocessable Entity",
"errors": [
{
"message": "O valor mínimo para a taxa codConsulta1PF é de R$ 5.85",
"internalCode": 4004
}
]
}
Consultado o cadastro
Esta rota pode ser utilizada para que consulte o cadastro do CPF / CNPJ, tendo a possibilidade de listar somente os dados do cliente, ou também informar as taxas cadastradas, utilizando a rota /taxa?cnpj=?
URL Produção:
https://api.consultanegativacao.com.br/v1/cadastros?cnpj=?
URL Homologação:
https://api.consultanegativacao.com.br/v1/homologacao/cadastros?cnpj=?
- Utilize a rota de homologação para simular o valor de repasse para cada consulta
Método: GET
Headers
Nome | Descrição | Exemplo |
cnpjSh | CNPJ da Software House que possui contrato com a Tecnospeed | 01001001000113 |
tokenSh | Token da Software House que possui contrato com a Tecnospeed | CdEZhJcQJS9rRdkLnx2Kl67GhAeBx89X2hzgVQ8i |
cnpjUsuario | CNPJ do cliente que está consultando | 01001001000113 |
Exemplos de retornos:
- Sucesso: StatusCode 200:
{
"nomeFantasia": "Tecnospeed",
"razaoSocial": "Tecnospeed S/A",
"cnpj": "01001001000113",
"nomeRepresentante": "Nome",
"cpfRepresentante": "99999999999",
"telefone": "44999999999",
"email": "contato@tecnospeed.com.br",
"endereco": "Av Duque De Caxias",
"numeroEndereco": "882",
"complementoEndereco": "",
"bairro": "Zona 7",
"cep": "87020025",
"cidade": "Maringá",
"uf": "PR",
"nomeResponsavelContrato": "Nome",
"telefoneResponsavelContrato": "4499999999",
"emailResponsavelContrato": "contato@tecnospeed.com.br",
"status": "Cadastro Efetuado com Sucesso",
"taxas": {
"codConsulta1PF": {
"value": 7.65,
"desconto": 0,
"repasse": 1.8
},
"codConsulta2PF": {
"value": 30.71,
"desconto": 0,
"repasse": 4.82
},
"codConsulta3PF": {
"value": 25.2,
"desconto": 0,
"repasse": 3.95
},
"codConsulta4PF": {
"value": 4.04,
"desconto": 0,
"repasse": 0.5
},
"codConsulta1PJ": {
"value": 8.51,
"desconto": 0,
"repasse": 2.72
},
"codConsulta2PJ": {
"value": 30.93,
"desconto": 0,
"repasse": 6.05
},
"codConsulta3PJ": {
"value": 27.9,
"desconto": 0,
"repasse": 4.37
},
"codConsulta4PJ": {
"value": 4.62,
"desconto": 0,
"repasse": 0.54
},
"codConsultaNegativacao": {
"value": 9.1,
"desconto": 0,
"repasse": 0.4
}
}
}
Comentários
0 comentário
Por favor, entre para comentar.