Simulação - Renegociação em Lote BNPL

Resumo

Antes de criar uma proposta de renegociação, é possível simular os valores da renegociação em lote para operações BNPL. A simulação permite visualizar as parcelas afetadas, valores de desconto e o montante final a ser pago para múltiplas operações simultaneamente.

Com amortization_type igual a present_amount, envie em cada parcela de operations[].installments[] os campos paid_amount, discount_amount e installment_key, como na proposta em lote.

Atenção

A renegociação em lote só pode ser criada com operações de um mesmo emitente e mesma chave de integração. Há um limite de 50 operações para cada renegociação em lote.

Request

ENDPOINT

/renegotiation/batch_proposal_simulation

MÉTODO

POST

Atenção

Os campos discount_amount e discount_percentage NÃO podem ser enviados juntos no mesmo payload (nível raiz).

Nota

Na raiz, discount_amount e discount_percentage são alternativas para desconto global. Os campos paid_amount e discount_amount em operations[].installments[] são usados com present_amount por parcela e não substituem a regra da raiz.

Request Body

{
    "amortization_type": "present_amount",
    "reference_date": "2026-04-08",
    "discount_percentage": 0.0,
    "operations": [
        {
            "debt_key": "1baea8a0-0fca-4f7c-8857-a227d4da72f8",
            "installments": [
                {
                    "installment_key": "ca5741c7-99a2-42e7-92a1-9328a36e4e88",
                    "paid_amount": 500,
                    "discount_amount": 50
                }
            ]
        },
        {
            "debt_key": "2cbfb9b1-1fdb-5f8d-9967-b338e5eb83f9",
            "installments": [
                {
                    "installment_key": "2ef25ed8-7124-44f5-9e3d-1d1a7196166e",
                    "paid_amount": 150,
                    "discount_amount": 10
                }
            ]
        }
    ]
}

Body Params

Campo	Tipo	Descrição	Caracteres
amortization_type*	string	Tipo de amortização	Enumeradores Amortization Type
reference_date*	string	Data de referência para cálculo do valor presente (precisa ser D+1)	10
discount_percentage	float	Percentual de desconto sobre o valor presente ((1 - percentual) * Valor Presente)	10
discount_amount	float	Valor de desconto aplicado sobre o valor presente	10
operations*	array	Lista de operações a serem renegociadas	Objeto Operations

Objeto Operations

Campo	Tipo	Descrição	Caracteres
debt_key*	string	Chave única da operação de crédito (DEBT-KEY)	UUID
installments*	array	Parcelas a serem renegociadas	Objeto Installments

Objeto Installments

Campo	Tipo	Descrição	Caracteres
installment_key*	string	Chave da parcela a ser renegociada	UUID
paid_amount	float	Valor pago (ou alocado) na parcela, em reais (R$). Obrigatório quando amortization_type é present_amount.	15,2
discount_amount	float	Valor de desconto em reais (R$) na parcela. Obrigatório quando amortization_type é present_amount (use 0 se não houver desconto). Opcional nos demais tipos.	15,2

Enumeradores Amortization Type

Campo	Descrição
present_amount	Simulação com valor presente por parcela. Em cada installments[] é obrigatório installment_key, paid_amount e discount_amount.
installment_payment	Renegociação para pagamento de parcelas específicas enviadas no payload. Requer installment_key de cada parcela.
overdue_installment_payment	Renegociação direcionada para pagamento de parcelas em atraso. Requer installment_key de cada parcela.

Response

STATUS

200

Response Body

{
    "batch_proposal_key": "7423c701-3578-4733-8f30-81ab60afdb6d",
    "discount_percentage": 0,
    "discount_amount": 0,
    "amortization_type": "present_amount",
    "payment_amount": 517.88,
    "requester_name": "Dante Ltda",
    "requester_key": "78287247-947d-4730-9bd1-7efb068175b6",
    "issuer_name": "Dante Ferrarini",
    "reference_date": "2026-04-08",
    "issuer_document_number": "31057466093",
    "operations": [
        {
            "requester_key": "78287247-947d-4730-9bd1-7efb068175b6",
            "contract_number": "DWF1761222116",
            "payment_amount": 517.88,
            "discount_amount": 0,
            "origin_key": null,
            "affected_installments": [
                {
                    "installment_key": "1dea396f-beb1-4df3-9822-35800b4c095a",
                    "due_date": "2026-05-07",
                    "principal_amount": 491.4903841,
                    "interest_amount": 52.3996159,
                    "fine_amount": 0,
                    "total_amount": 543.89,
                    "present_amount": 517.88,
                    "paid_amount": 517.88,
                    "principal_amortization_payment_amount": 491.49,
                    "prefixed_interest_payment_amount": 26.39,
                    "fine_payment_amount": 0,
                    "discount_amount": 0
                }
            ],
            "remaining_installments": [
                {
                    "installment_key": "370e73d1-55d8-431e-9b22-d08fb8297999",
                    "due_date": "2026-06-07",
                    "principal_amount": 516.1296159,
                    "interest_amount": 27.7603841,
                    "fine_amount": 0,
                    "total_amount": 543.89
                }
            ],
            "debt_key": "72760166-4ddf-41fb-8a8c-605f8f4fc35c"
        }
    ]
}

Campos de Desconto

Desconto percentual

{
    "discount_percentage": 0.5
}

Desconto absoluto

{
    "discount_amount": 200
}