Gerar proposta

Método usado para geração de proposta, envio de e-mail para cliente e requisição ao webhook do varejista.

Deverá ser feita uma requisição do tipo POST à URL para o tipo de ambiente desejado:

• Homologação: https://hmlapi.bancosemear.com.br/ddc/v1/credito/proposta
• Produção: https://api.bancosemear.com.br/ddc/v1/credito/proposta

Request #

/**
* Interface de Proposta.
*/
interface Proposta {
    /// Valor da prestação/PMT.
    prestacao: number;
    
    /// Plano da simulação.
    plano: number;
    
    /// Cliente da Proposta.
    cliente: ClienteProposta;
    
    /// Banco do Cliente.
    banco?: BancoModel;
}

Os parâmetros de dados bancários são utilizados para operação de Empréstimo Pessoal do tipo Depósito, na qual o cliente recebe o valor financiado em sua conta bancária.

interface ClienteProposta {
    /// Estado Civil do cliente:
    /// SO – Solteiro
    /// CA – Casado
    /// DE – Desquitado
    /// DI – Divorciado
    /// VI – Viúvo
    /// OU – Outros
    estCivil: string;

    /// Nível de Escolaridade do cliente:
    /// S – Sem instrução
    /// 1G – Primeiro grau
    /// 2G – Segundo grau
    /// SI – Superior incompleto
    /// SC – Superior completo
    /// PO – Pós-graduação
    /// ME – Mestrado
    /// DR – Doutorado
    /// OU – Outros
    escolaridade: string;

    /// Logradouro da residência do cliente.
    logradouro: string;

    /// Número da residência do cliente.
    numero: string;

    /// Complemento da residência do cliente.
    complemento: string;

    /// Bairro da residência do cliente.
    bairro: string;

    /// Localidade da residência do cliente.
    localidade: string;

    /// UF da residência do cliente.
    uf: string;

    /// CEP da residência do cliente.
    cep?: string;

    /// DDD do Telefone celular do cliente.
    dddCel1?: number;

    /// Telefone celular do cliente.
    foneCel1?: number;
}

interface Banco {
    /// Banco da conta do cliente.
    codigoBanco?: number;

    /// Agência da conta do cliente.
    codigoAgencia?: number;

    /// Dígito da agência da conta do cliente.
    digitoAgencia?: string;

    /// Conta do cliente.
    numeroConta?: number;

    /// Dígito da conta do cliente.
    digitoConta?: number;
}

Response #

interface PropostaRetorno {
    /// Código da filial.

    codLoja: string;
    /// Número da proposta no Banco Semear.
    numProp: string;

    /// Número da proposta no lojista.
    numPropLoj: string;

    /// Indica o status da proposta:
    /// AGA – Proposta aguardando aprovação
    /// PEN – Proposta com pendência
    /// NEG – Proposta negada
    /// APR – Proposta aprovada
    /// BOR – Proposta com borderô gerado
    /// FOR – Proposta formalizada
    /// CAN – Proposta cancelada
    /// DEV – Proposta devolvida
    /// ERR – Erro ocorrido ao executar o processo.
    status: string;

    /// Mensagem de retorno.
    retorno: string;

    /// Código de autorização.
    /// Enviado somente quando a proposta estiver aprovada.
    codAutorizador?: number;

    /// Data de autorização (yyyy-mm-dd).
    dtAutorizador?: Date;

    /// Número do borderô no Banco Semear.
    numBord?: number;

    /// Data da geração do borderô (yyyy-mm-dd).
    dtBord?: Date;

    /// Indica o status do borderô:
    /// AGC – Aguardando conferência
    /// AGR – Aguardando regularização
    /// CON – Conferido
    /// ERR – Erro Formalização
    /// FOR – Formalizado
    /// LIB – OP Liberada.
    flagSitBord: string;

    /// Valor do crédito liberado.
    vrLib?: number;

    /// Data da liberação do crédito (yyyy-mm-dd).
    dtLib?: Date;

    /// Plano (quantidade de parcelas).
    plano: number;

    /// Valor financiado.
    vrFinanciado: number;

    /// Valor financiado.
    vrParcela: number;

    /// Data de autorização (yyyy-mm-dd).
    dtPrimeiroVencimento?: Date;

    /// Valor do CET (3.35940).
    cet: number;

    /// Valor dos juros totais.
    jurosTotal: number;

    /// Documentos.
    documento: Documento[];

    /// Último histórico de análise.
    ultimoHistoricoAnalise: string;

    /// URL da Capa do Borderô.
    url: string;

    /// Dados do Cliente.
    cliente: ClienteRetorno;

    /// Boletos da proposta.
    boleto: Boleto[];
}

interface Documento {
    /// Tipo de Documento.
    doc: string;

    /// Descrição do Documento.
    desc: string;

    /// URL do Documento.
    url: string;
}

interface ClienteRetorno {
    /// CPF ou CNPJ do cliente. Somente números, sem máscara. Deve conter exatamente 11 ou 14 posições.
    cpfCnpj: string;

    /// Nome ou Razão Social do cliente.
    nome: string;
}

interface Boleto {
    /// Data de vencimento do boleto (yyyy-mm-dd).
    dtVenc?: Date;

    /// Valor do boleto (9.99).
    valor?: number;

    /// Linha digitável do boleto.
    linDig: string;
}

Após a validação da identidade do cliente no celular, o webhook parametrizado será chamado. Caso o webhook não seja utilizado, pode ser consultado o status das propostas via GET à API, conforme documentação enviada previamente.