Incluir Cliente
Você deve fazer uma requisição tipo POST para o endpoint {{ BASE_API_URL }}/v1/cliente/consulta-spc
enviando um objeto ClienteDTO com o CPF preenchido.
Essa chamada irá verificar se já existe o cliente na base da Crédiario Prático.
Caso exista, retorna o objeto CLienteDTO com os dados preenchidos. Caso não exista na base, efetua a consulta no SPC e retorna o objeto ClienteDTO com os dados mínimos preenchidos e os limites de crédito do cliente já calculados.
Para carregar os dados em tela, utilize como modelo para a confecção do formulário de cadastramento do cliente, as instruções contidas no Abrir Detalhe Cliente
Exemplo de payload com dados mínimos para inclusão
{
"assuntoObs": null,
"autorizaCompra": true,
"cargo": null,
"celular": "(48) 98855 - 8855",
"cpf": "081.759.489-22",
"dataCadastro": null,
"dataEmissao": "2020-01-01",
"dataFinal": null,
"dataInicial": null,
"dataNascimento": "1990-10-21",
"dependentes": 0,
"descricao": null,
"email": "seu@email.com",
"empregoCBO": 2669,
"empresa": "APOSENTADO",
"empresaId": 398,
"endereco": {
"cep": "88062-201",
"logradouro": "Rua Laurindo Januário da Silveira",
"numero": "4645",
"complemento": null,
"bairro": "Lagoa da Conceição",
"estado": "SC",
"cidadeIbge": 4205407,
"cidadeNome": "Florianópolis"
},
"enderecoAlternativo": {
"id": null,
"mensagem": null,
"permissao": null,
"logradouro": null,
"numero": null,
"bairro": null,
"cep": null
},
"enderecoSecundario": false,
"escolaridade": "SUPERIOR_COMPLETO",
"estadoCivil": "S",
"exibirAte": null,
"exibirMsg": null,
"exibirNaLojaObs": null,
"flagAutorizacao": false,
"grupo": "C",
"id": null,
"identidade": "123456",
"jaTemCadastroNaLoja": false,
"limiteCompartilhado": null,
"limitesPreAprovado": {
"id": null,
"mensagem": null,
"permissao": null,
"faixaInicial1": 600,
"faixaFinal1": 600,
"peEntrada1": 0
},
"lojaId": 441,
"mensagem": null,
"mensagemErro": null,
"naturalCidade": 4200556,
"naturalEstado": "SC",
"negativadoSpc": false,
"nome": "NOME DO CLIENTE",
"nomeMae": "NOME DA MÃE",
"nomePai": "",
"nomeRef1": "teste",
"nomeRef2": "teste dois",
"nomeRef3": null,
"nomeRef4": null,
"observacao": null,
"observacoes": [],
"orgaoEmissor": "ssp",
"outrasRendas": "0,00",
"outroProvedor": null,
"permissao": null,
"permitirEnvioSPC": true,
"provedor": null,
"ramal": null,
"redeId": 201,
"relacaoRef1": "A",
"relacaoRef2": "C",
"relacaoRef3": null,
"relacaoRef4": null,
"rendaPrincipal": "5.000,00",
"resideDesde": "06/2000",
"score": 673,
"segmentacao": null,,
"sexo": "M",
"status": null,
"telComercial": "(48) 3209 - 5961",
"telRef1": "(48) 98832 - 8779",
"telRef2": "(48) 99858 - 1509",
"telRef3": null,
"telRef4": null,
"telResidencial": "(48) 3205 - 9999",
"tempoEmpregoAnos": null,
"tempoEmpregoMeses": null,
"tempoResidenciaAnos": null,
"tempoResidenciaMeses": null,
"tipoClienteScore": "NAO_RESTRITO",
"tipoDocumento": "RG",
"tipoResidencia": "M",
"trabalhaNessaEmpresaDesde": "01/2000",
"uf": "SC",
"valorAluguel": null,
}
Exemplo de response de inclusão de cliente
{
"id": 343593,
"mensagem": null,
"permissao": null,
"dataInicial": null,
"dataFinal": null,
"dataCadastro": "2023-11-06",
"lojaId": 441,
"redeId": 201,
"empresaId": 398,
"nome": "FELIPE PEREIRA MACHADO",
"cpf": "08175948922",
"segmentacao": null,
"tipoDocumento": "RG",
"identidade": "123456",
"orgaoEmissor": "ssp",
"dataEmissao": "2020-01-01",
"uf": "SC",
"grupo": "C",
"dataNascimento": "1990-10-21",
"naturalEstado": "SC",
"naturalCidade": 4200556,
"sexo": "M",
"estadoCivil": "S",
"dependentes": 0,
"nomePai": "",
"nomeMae": "DENIZALDA ALICE MACHADO",
"telResidencial": "(48) 3205 - 9999",
"celular": "(48) 98855 - 8855",
"email": "feelipe@email.com",
"escolaridade": "SUPERIOR_COMPLETO",
"rendaPrincipal": 5000.00,
"enderecoAlternativo": null,
"endereco": {
"cep": "88062-201",
"logradouro": "Rua Laurindo Januário da Silveira",
"numero": "4645",
"complemento": null,
"bairro": "Lagoa da Conceição",
"estado": "SC",
"cidadeIbge": 4205407,
"cidadeNome": "Florianópolis"
},
"tipoResidencia": "M",
"tempoResidenciaAnos": null,
"tempoResidenciaMeses": null,
"resideDesde": "06/2000",
"empresa": "APOSENTADO",
"cargo": "APOSENTADO",
"tempoEmpregoAnos": null,
"tempoEmpregoMeses": null,
"telComercial": "(48) 3209 - 5961",
"ramal": null,
"nomeRef1": "teste",
"relacaoRef1": "A",
"telRef1": "(48) 98832 - 8779",
"nomeRef2": "teste dois",
"relacaoRef2": "C",
"telRef2": "(48) 99858 - 1509",
"nomeRef3": null,
"relacaoRef3": null,
"telRef3": null,
"nomeRef4": null,
"relacaoRef4": null,
"telRef4": null,
"status": "NORMAL",
"trabalhaNessaEmpresaDesde": "01/2000",
"permitirEnvioSPC": true,
"jaTemCadastroNaLoja": false,
"negativadoSpc": false,
"provedor": null,
"outroProvedor": null,
"flagAutorizacao": null,
"autorizaCompra": null,
"enderecoSecundario": false,
"outrasRendas": 0.00,
"limiteCompartilhado": 600.00,
"tipoClienteScore": "NAO_RESTRITO",
"observacoes": null,
"descricao": null,
"observacao": null,
"assuntoObs": null,
"exibirNaLojaObs": null,
"exibirAte": null,
"exibirMsg": null,
"mensagemErro": null,
"limitesPreAprovado": null,
"valorAluguel": null,
"empregoCBO": 2669,
"score": 673
}
O objeto ClienteDTO com os dados atualizados, conforme os exemplos acima, deve ser enviado para o endpoint {{ BASE_API_URL }}/v1/cliente
para efetuar a inclusão do cliente na base da Crédiario Prático.
Após esta etapa, você já pode gerar a proposta do cliente para impressão através do endpoint {{ BASE_REPORT_API_URL }}/v1/relatório/proposta-adesao
, passando um objeto FiltroRelatorioDTO, conforme exemplo abaixo:
Exemplo de payload para geração de proposta de adesão
{
"clienteId": 343593,
"lojaId": 441,
"operacao": "cadastro"
}
Acesse abaixo a documentação completa para endpoint de relatório de proposta de adesão:
Swagger - Endpoint gerar proposta de adesão
Carregar Documentos Digitalizados
Para concluir o cadastro do cliente, você precisa fazer o upload dos documentos digitalizados. Para isso, utilize o endpoint abaixo:
{{ BASE_API_URL }}/v1/cliente/{id}/anexos/{lojaId}