Saltar al contenido principal
POST
Preview a consignado compensating adjustment

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
adjustmentAmount
string
requerido

Signed compensating entry magnitude, exact two-decimal string. Sign convention: payment_shortfall must be negative, payment_excess and every disbursement_* reason must be positive.

currency
string
requerido

ISO-4217 currency code.

Required string length: 3
justification
string
requerido

Operator's structured justification.

Required string length: 1 - 4000
numeroContrato
string
requerido

Canonical rail contract number.

Required string length: 2 - 15
reason
enum<string>
requerido

Closed reason catalog; no free-form 'other'. A disbursement_* or refinance_payoff_* reason clears a disbursement in parts or a refinance payoff: it names the divergence and moves exactly its open amount. refinance_payoff_short_settled_residual only records, on a refinance_payoff_vs_rail item, that part of the shortfall (any amount up to the item's openShortfall and residualAvailable) is the CCB residual of the same contract: it posts nothing.

Opciones disponibles:
payment_shortfall,
payment_excess,
immutable_client_correction,
internal_ccb_residual,
disbursement_excess_recovered,
disbursement_excess_loss,
disbursement_remainder_paid_off_rail,
disbursement_remainder_cancelled,
refinance_payoff_short_recovered,
refinance_payoff_short_loss,
refinance_payoff_excess_refunded,
refinance_payoff_short_settled_residual
correctionEventId
string

Landed correction event this adjustment resolves. At most one of divergenceId/correctionEventId may be set.

Maximum string length: 255
debtAmountAfter
string

CCB debt after this adjustment. Both-or-neither with debtAmountBefore.

debtAmountBefore
string

CCB debt before this adjustment. Both-or-neither with debtAmountAfter.

divergenceId
string<uuid>

Divergence this adjustment resolves. At most one of divergenceId/correctionEventId may be set.

Respuesta

OK

adjustmentAmount
string
requerido

Normalized signed amount, exact two-decimal string.

currency
string
requerido

ISO-4217 currency code.

numeroContrato
string
requerido

Canonical rail contract number.

reason
string
requerido

Closed reason catalog.

creditRole
string

above|cash|suspense: the account a disbursement_* reason credits.

debitRole
string

cash|loss|below: the account a disbursement_* reason debits.

debtAmountAfter
string

CCB debt after, when this adjustment changes the debt.

debtAmountBefore
string

CCB debt before, when this adjustment changes the debt.

principalSide
string

debit|credit: the direction the eventual posting intent moves the contract's principal (receivable) account. Always opposite suspenseSide. Absent for a disbursement_* reason.

suspenseSide
string

debit|credit: the direction the eventual posting intent moves the tenant's suspense account. Absent for a disbursement_* reason.