16 - Calculate Grid Installments

cURL

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "valorSolicitado": 123,
  "valorTabela": 123,
  "comJuros": true,
  "nroDiasAcrescimo": 123,
  "tipoPessoa": 1
}
'

import requests

url = "https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas"

payload = {
    "valorSolicitado": 123,
    "valorTabela": 123,
    "comJuros": True,
    "nroDiasAcrescimo": 123,
    "tipoPessoa": 1
}
headers = {
    "IdempotencyKey": "<idempotencykey>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    IdempotencyKey: '<idempotencykey>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    valorSolicitado: 123,
    valorTabela: 123,
    comJuros: true,
    nroDiasAcrescimo: 123,
    tipoPessoa: 1
  })
};

fetch('https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'valorSolicitado' => 123,
    'valorTabela' => 123,
    'comJuros' => true,
    'nroDiasAcrescimo' => 123,
    'tipoPessoa' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "IdempotencyKey: <idempotencykey>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas"

	payload := strings.NewReader("{\n  \"valorSolicitado\": 123,\n  \"valorTabela\": 123,\n  \"comJuros\": true,\n  \"nroDiasAcrescimo\": 123,\n  \"tipoPessoa\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("IdempotencyKey", "<idempotencykey>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas")
  .header("IdempotencyKey", "<idempotencykey>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"valorSolicitado\": 123,\n  \"valorTabela\": 123,\n  \"comJuros\": true,\n  \"nroDiasAcrescimo\": 123,\n  \"tipoPessoa\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["IdempotencyKey"] = '<idempotencykey>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"valorSolicitado\": 123,\n  \"valorTabela\": 123,\n  \"comJuros\": true,\n  \"nroDiasAcrescimo\": 123,\n  \"tipoPessoa\": 1\n}"

response = http.request(request)
puts response.read_body

200

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ],
  "parcelas": [
    {
      "prazo": 123,
      "vlrParcela": 123,
      "vlrCliente": 123,
      "vlrLoja": 123,
      "percDesconto": 123,
      "dataPrimeiroPagamento": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ]
}

Through this endpoint, the partner simulates the values of the proposal before even finalizing it in the system. This method allows the override of some values originally captured from the initial store network configuration.

Show Messaging - Calculate Grid Installments

Category	Operation	Action	Code	Detailed Code	Message
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0013	V0001	Produto não configurado para esta integração
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0195	V0001	O número de dias de acréscimo não pode ser negativo
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0001	O valor solicitado não é válido
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0002	Formato de cálculo inválido
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0003	É necessário o produto
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0004	Prazo inválido ou não localizado para este Produto x Rede
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0005	Não é possível aprovar a proposta. Produto x Rede x Parcela não possui juros configurado
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0006	Configuração deve ser enviada para proposta HotMoney
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0007	Produto Rotativo e HotMoney aceitam apenas formato de cálculo com juros
Proposta	CalculaGridParcelas	CalcularGridParcelas	C0196	V0008	Formato de Cálculo não informado

Authorizations

Authorization · string · header · required

Informe o token

Headers

IdempotencyKey · string · required

Body

application/jsontext/jsonapplication/*+json

valorSolicitado · number<double>

Valor solicitado para financiamento

valorTabela · number<double>

Valor de tabela do produto. Quando o valor é diferente do solicitado a BMP determina o percentual de desconto que está sendo aplicado na operação

comJuros · boolean

Indica se as parcelas devem ser calculadas aplicando porcentagem de juros ou de desconto. Caso verdadeiro, atribui às parcelas os valores calculados com base na % de juros, caso contrário, atribui os valores calculados com base na % de desconto

nroDiasAcrescimo · integer<int32>

Dias de acréscimo para o primeiro pagamento além dos primeiros 30 dias. O valor padrão é zero

tipoPessoa · integer<int32>

Indica o tipo de pessoa se Física ou Jurídica para cálculo do Imposto sobre Operações Financeiras (IOF). 1-PF (Pessoa Física) e 2-PJ (Pessoa Júridica)

Required range: 1 <= x <= 2

Response

200

text/plain

OK

msg · string | null

hasError · boolean

messages · object[] | null

Show child attributes

parcelas · object[] | null

Show child attributes