Skip to main content
POST
End one receivable's funding obligation before its term

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string
required

Canonical idempotency request ID. Required: this request extinguishes a liability, and without a key a retry cannot be told apart from a second instruction.

Path Parameters

setId
string<uuid>
required

Assignment set identifier.

Body

application/json
borrowerPayoff
string
required

What the borrower actually paid to end his own contract, decimal string. Required: it is the default the fund is offered when no amount is agreed, and a pass-through of nothing would book the whole obligation as a gain.

receivableRef
string
required

The receivable whose funding obligation ends. The obligation is carried per receivable, so one borrower prepaying ends one obligation and not the cession's others.

Maximum string length: 128
agreedAmount
string

What the fund agreed to take, decimal string. Omit it entirely to pass the borrower's payoff through; an informed amount must be above zero and never above the face of the instalments still owed.

Response

OK

assignmentSetId
string
required

The cession whose obligation was ended.

borrowerPayoff
string
required

What the borrower paid to get out, decimal string, scale 2, echoed as the third reference.

currency
string
required

ISO-4217 code the obligation is denominated in.

expense
string
required

The agreed amount ABOVE the obligation, decimal string, scale 2. Financing cost taken in the period the cession ends in.

face
string
required

Sum of the instalments still owed, decimal string, scale 2. The ceiling the agreed amount may not cross.

fromState
string
required

The cession's state before this payoff.

gain
string
required

The agreed amount BELOW the obligation, decimal string, scale 2. Desagio that stops being appropriable. Exactly one of expense and gain is ever positive.

obligation
string
required

What the liability stood at on this date (Res. CMN 4.966 art. 29 para 1), decimal string, scale 2. After the payoff it is exactly zero.

periodsEnded
integer<int64>
required

How many open periods of this receivable's ladder the payoff closed at once.

receivableRef
string
required

The receivable that ended.

settlement
string
required

What the fund is owed at once, decimal string, scale 2. Credited to what this institution owes the fund, never to cash.

toState
string
required

The cession's state after it. It reaches 'settled' only when this was its last open obligation, so a cession of many receivables usually stays where it was.