22 - Inclusão com Análise BMP

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirManual \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "dto": {
    "documentoCliente": "<string>",
    "documentoPromotor": "<string>",
    "documentoParceiroCorrespondente": "<string>",
    "observacoesVendedor": "<string>",
    "codigoOperacao": "<string>",
    "codigoVersaoCCB": 123,
    "vlrSolicitado": 5000000000000000,
    "prazo": 123,
    "nroDiasAcrescimo": 123,
    "formatoCalculo": 123,
    "percJurosNegociado": 5000000000000,
    "vlrPreAprovado": 5000000000000000,
    "vlrOutrasDespesas": 5000000000000000,
    "vlrOutrosServicos": 5000000000000000,
    "vlrSeguro": 5000000000000000,
    "dtPrimeiroVencto": "2023-11-07T05:31:56Z",
    "vlrProdutoBem": 5000000000000000,
    "vlrEntrada": 5000000000000000,
    "vlrEntradaTradeIn": 5000000000000000,
    "vlrEntradaParcelada": 5000000000000000,
    "vlrDespesasAF": 5000000000000000,
    "vlrCorban": 5000000000000000,
    "vlrAvaliacao": 5000000000000000,
    "vlrDespachante": 5000000000000000,
    "vlrRegistro": 5000000000000000,
    "vlrServTerceiro": 5000000000000000,
    "vlrRegistroCartorio": 5000000000000000,
    "vlrTxAdmMensal": 5000000000000000,
    "vlrSeguroMensal1": 5000000000000000,
    "vlrSeguroMensal2": 5000000000000000,
    "tipoContrato": "<string>",
    "percRetencao": 5000000000000,
    "vlrRetencao": 5000000000000000,
    "vlrTAC": 5000000000000000,
    "vlrBlindagem": 5000000000000000,
    "vlrAcessorios": 5000000000000000,
    "vlrVistoria": 5000000000000000,
    "vlrCertiDocs": 5000000000000000,
    "tipoIndiceFinan": 123,
    "percIndiceFinan": 5000000000000,
    "numeroCCB": 123,
    "propostaContaPagamentoDTO": {
      "tipoConta": 123,
      "agencia": "<string>",
      "conta": "<string>",
      "codigoBanco": 123,
      "agenciaDig": "<string>",
      "contaDig": "<string>",
      "numeroBanco": "<string>",
      "documentoFederalPagamento": "<string>",
      "nomePagamento": "<string>"
    },
    "propostaLancamentos": [
      {
        "vlrTransacao": 123,
        "dtPagamento": "2023-11-07T05:31:56Z",
        "linhaDigitavel": "<string>",
        "documentoFederal": "<string>",
        "campoID": "<string>",
        "codigoBanco": 123,
        "numeroBanco": "<string>",
        "tipoConta": 123,
        "agencia": "<string>",
        "agenciaDig": "<string>",
        "conta": "<string>",
        "contaDig": "<string>",
        "nomePagamento": "<string>",
        "documentoFederalCedente": "<string>",
        "nomeCedente": "<string>"
      }
    ]
  },
  "parametros": [
    {
      "nome": "<string>",
      "valor": "<string>"
    }
  ]
}
'

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "messageType": 1,
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ],
  "codigo": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numero": 123
}

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirManual \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "dto": {
    "documentoCliente": "<string>",
    "documentoPromotor": "<string>",
    "documentoParceiroCorrespondente": "<string>",
    "observacoesVendedor": "<string>",
    "codigoOperacao": "<string>",
    "codigoVersaoCCB": 123,
    "vlrSolicitado": 5000000000000000,
    "prazo": 123,
    "nroDiasAcrescimo": 123,
    "formatoCalculo": 123,
    "percJurosNegociado": 5000000000000,
    "vlrPreAprovado": 5000000000000000,
    "vlrOutrasDespesas": 5000000000000000,
    "vlrOutrosServicos": 5000000000000000,
    "vlrSeguro": 5000000000000000,
    "dtPrimeiroVencto": "2023-11-07T05:31:56Z",
    "vlrProdutoBem": 5000000000000000,
    "vlrEntrada": 5000000000000000,
    "vlrEntradaTradeIn": 5000000000000000,
    "vlrEntradaParcelada": 5000000000000000,
    "vlrDespesasAF": 5000000000000000,
    "vlrCorban": 5000000000000000,
    "vlrAvaliacao": 5000000000000000,
    "vlrDespachante": 5000000000000000,
    "vlrRegistro": 5000000000000000,
    "vlrServTerceiro": 5000000000000000,
    "vlrRegistroCartorio": 5000000000000000,
    "vlrTxAdmMensal": 5000000000000000,
    "vlrSeguroMensal1": 5000000000000000,
    "vlrSeguroMensal2": 5000000000000000,
    "tipoContrato": "<string>",
    "percRetencao": 5000000000000,
    "vlrRetencao": 5000000000000000,
    "vlrTAC": 5000000000000000,
    "vlrBlindagem": 5000000000000000,
    "vlrAcessorios": 5000000000000000,
    "vlrVistoria": 5000000000000000,
    "vlrCertiDocs": 5000000000000000,
    "tipoIndiceFinan": 123,
    "percIndiceFinan": 5000000000000,
    "numeroCCB": 123,
    "propostaContaPagamentoDTO": {
      "tipoConta": 123,
      "agencia": "<string>",
      "conta": "<string>",
      "codigoBanco": 123,
      "agenciaDig": "<string>",
      "contaDig": "<string>",
      "numeroBanco": "<string>",
      "documentoFederalPagamento": "<string>",
      "nomePagamento": "<string>"
    },
    "propostaLancamentos": [
      {
        "vlrTransacao": 123,
        "dtPagamento": "2023-11-07T05:31:56Z",
        "linhaDigitavel": "<string>",
        "documentoFederal": "<string>",
        "campoID": "<string>",
        "codigoBanco": 123,
        "numeroBanco": "<string>",
        "tipoConta": 123,
        "agencia": "<string>",
        "agenciaDig": "<string>",
        "conta": "<string>",
        "contaDig": "<string>",
        "nomePagamento": "<string>",
        "documentoFederalCedente": "<string>",
        "nomeCedente": "<string>"
      }
    ]
  },
  "parametros": [
    {
      "nome": "<string>",
      "valor": "<string>"
    }
  ]
}
'

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "messageType": 1,
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ],
  "codigo": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numero": 123
}

Por meio deste endpoint o parceiro pode incluir uma proposta manualmente.

Neste endpoint, ambos os parâmetros CodigoBanco e NumeroBanco podem ser utilizados. O campo CodigoBanco refere-se ao Identificador do Sistema de Pagamentos Brasileiro (ISPB) e espera um valor em números, enquanto o campo NumeroBanco refere-se ao código bancário, que possui 3 dígitos numéricos e espera o valor como string. Exemplo: "CodigoBanco": 90400888, "NumeroBanco": "033".

Mostrar Tabela TipoContaBancaria

ID	Descrição
1	Poupança
2	Conta Corrente
3	Conta Pagamento

Authorizations

Authorization

string

header

required

Informe o token

Headers

IdempotencyKey

string

required

Body

dto

object

Mostrar atributos filhos

dto.documentoCliente

string | null

required

Número do Cadastro de Pessoa Física do Cliente

Maximum string length: 20

dto.documentoPromotor

string | null

Número do Cadastro de Pessoa Física (CPF) ou Cadastro Nacional de Pessoa Jurídica do promotor

Maximum string length: 20

dto.documentoParceiroCorrespondente

string | null

Número do Cadastro de Pessoa Física (CPF) ou Cadastro Nacional de Pessoa Jurídica do parceiro correspondente. Utilizado quando o destino de desembolso não for o emitente ou lojista/integrador.

Maximum string length: 20

dto.observacoesVendedor

string | null

Observações do vendedor que serão destinadas ao analista da BMP, quando esta proposta passar por aprovação manual

dto.codigoOperacao

string | null

Uso do Integrador. É o código da operação no sistema do parceiro. Esta informação é exclusiva e poderá ser utilizada para atualizar a proposta sem necessidade de guardar o código da proposta na BMP. Porém o código de propostaBMP é importante ser armazenado para uso de impressão de boletos/ Cédula de Crédito Bancária (CCB)/Nota promissória ou Protocolo.

dto.codigoVersaoCCB

integer<int64> | null

Código referente à versão da Cédula de Crédito Bancária – (CCB), informa a versão que deve ser utilizada para a proposta.

dto.vlrSolicitado

number<double>

Valor solicitado na proposta

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.prazo

integer<int32>

Prazo solicitado. Será consistido conforme a parametrizado de integração.

dto.nroDiasAcrescimo

integer<int32>

Dias de acréscimo para o primeiro pagamento além dos primeiros 30 dias.

dto.formatoCalculo

integer<int32> | null

Formato de cálculo das parcelas: 1 – Com Juros e 2 – Sem Juros. Por padrão a proposta é calculada com juros, mas a BMP oferece uma forma de geração das parcelas onde a loja absorve os custos da operação facilitandoa parcela para o cliente.

dto.percJurosNegociado

number<double> | null

Percentual de juros da proposta

Intervalo obrigatório: 0 <= x <= 10000000000000

dto.vlrPreAprovado

number<double> | null

Valor pré-aprovado para este cliente.

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrOutrasDespesas

number<double> | null

Valor de outras despesas da operação.

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrOutrosServicos

number<double> | null

Valor de outros serviços da operação.

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrSeguro

number<double> | null

Valor do seguro

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.dtPrimeiroVencto

string<date-time> | null

Data estimada do primeiro vencimento.

dto.vlrProdutoBem

number<double> | null

Valor do produto que está sendo adquirido

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrEntrada

number<double> | null

Valor de entrada

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrEntradaTradeIn

number<double> | null

Valor de entrada trade in

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrEntradaParcelada

number<double> | null

Valor de entrada parcelada

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrDespesasAF

number<double> | null

Valor de despesas de Alienação Fiduciária

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrCorban

number<double> | null

Valor de correspondente bancário

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrAvaliacao

number<double> | null

Valor da Avaliação

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrDespachante

number<double> | null

Valor do despachante

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrRegistro

number<double> | null

Valor do registro

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrServTerceiro

number<double> | null

Valor do serviço terceirizado

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrRegistroCartorio

number<double> | null

Valor do registro em cartório

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrTxAdmMensal

number<double> | null

Valor da taxa de administração mensal

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrSeguroMensal1

number<double> | null

Valor do seguro mensal

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrSeguroMensal2

number<double> | null

Valor do seguro mensal

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.tipoContrato

string | null

Sigla indicando o tipo de contrato da proposta. Exémplo: CSG -> Capital de Giro; CCG -> Capital de Giro com Garantia

Maximum string length: 5

dto.percRetencao

number<double> | null

Percentual de retenção

Intervalo obrigatório: 0 <= x <= 10000000000000

dto.vlrRetencao

number<double> | null

Percentual de retenção

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrTAC

number<double> | null

Valor da Tarifa de Cadastro. Pode ser R$ 0,00 quando não houver.

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrBlindagem

number<double> | null

Valor de blindagem

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrAcessorios

number<double> | null

Valor dos acessórios

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrVistoria

number<double> | null

Valor de vistoria

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.vlrCertiDocs

number<double> | null

Valor referente ao custo do serviço de certificação digital, que é somado no Valor Financiado (solicitado) da proposta. Tal valor fica retido para posteriormente ser repassado para a empresa responsável pelacertificação digital (CertiDocs), ou para o parceiro, dependendo da regra de operação.

Intervalo obrigatório: 0 <= x <= 10000000000000000

dto.tipoIndiceFinan

integer<int32> | null

Indica um índice financeiro.

dto.percIndiceFinan

number<double> | null

Indica o percentual referente ao tipo de índice financeiro.

Intervalo obrigatório: 0 <= x <= 10000000000000

dto.numeroCCB

integer<int64>

Número Reservado para vincular proposta.

dto.propostaContaPagamentoDTO

object

Mostrar atributos filhos

dto.propostaContaPagamentoDTO.tipoConta

integer<int32> | null

required

Tipo de conta

dto.propostaContaPagamentoDTO.agencia

string | null

required

Agência

Maximum string length: 4

dto.propostaContaPagamentoDTO.conta

string | null

required

Conta bancária

Maximum string length: 20

dto.propostaContaPagamentoDTO.codigoBanco

integer<int32> | null

Código do banco

dto.propostaContaPagamentoDTO.agenciaDig

string | null

Dígito da agência

Maximum string length: 1

dto.propostaContaPagamentoDTO.contaDig

string | null

Dígito da conta

Maximum string length: 1

dto.propostaContaPagamentoDTO.numeroBanco

string | null

Número do banco

dto.propostaContaPagamentoDTO.documentoFederalPagamento

string | null

Numero do Cadastro de Pessoa Física (CPF) ou do Cadastro Nacional de Pessoa Física (CNPJ) indicado para pagamento (quando difere do Titular)

Maximum string length: 20

dto.propostaContaPagamentoDTO.nomePagamento

string | null

Nome da pessoa para pagamento (quando difere do Titular)

Maximum string length: 60

dto.propostaLancamentos

object[] | null

Mostrar atributos filhos

dto.propostaLancamentos.vlrTransacao

number<double> | null

required

Valor de transação.

dto.propostaLancamentos.dtPagamento

string<date-time> | null

required

Data da liquidação, se não informado será considerada a data do dia.

dto.propostaLancamentos.linhaDigitavel

string | null

required

String contendo informações do boleto, como dados do banco, destinatário etc.

Maximum string length: 60

dto.propostaLancamentos.documentoFederal

string | null

required

Documento federal do cliente

Maximum string length: 20

dto.propostaLancamentos.campoID

string | null

Identifica o tipo de lançamento.

dto.propostaLancamentos.codigoBanco

integer<int32> | null

Código do banco

dto.propostaLancamentos.numeroBanco

string | null

Número do banco

dto.propostaLancamentos.tipoConta

integer<int32> | null

Tipo de conta.

dto.propostaLancamentos.agencia

string | null

Agencia bancária

Maximum string length: 4

dto.propostaLancamentos.agenciaDig

string | null

Dígito da Agência

Maximum string length: 1

dto.propostaLancamentos.conta

string | null

Conta bancária

Maximum string length: 20

dto.propostaLancamentos.contaDig

string | null

Dígito da conta

Maximum string length: 1

dto.propostaLancamentos.nomePagamento

string | null

Nome da pessoa para pagamento (quando difere do Titular)

Maximum string length: 60

dto.propostaLancamentos.documentoFederalCedente

string | null

Documento federal do cedente

Maximum string length: 20

dto.propostaLancamentos.nomeCedente

string | null

Nome do cedente

Maximum string length: 60

parametros

object[] | null

Mostrar atributos filhos

parametros.nome

string | null

Refere-se ao nome do parâmetro.

parametros.valor

string | null

Refere-se ao valor do parâmetro.

Response

msg

string | null

hasError

boolean

messages

object[] | null

Mostrar atributos filhos

messages.messageType

enum<integer>

Opções disponíveis:

1,

2,

3

messages.code

string | null

messages.context

string | null

messages.description

string | null

messages.field

string | null

codigo

string<uuid>

numero

integer<int64>

21 - Incluir Avalistas 24 - Incluir Manual Simplificado Price

⌘I

Guia Inicial

Métodos de Assinaturas

Guia do Desenvolvedor

Referencias de API

Guias e Casos de Uso

22 - Inclusão com Análise BMP

Authorizations

Headers

Body

Response