Skip to main content
POST
Create a consignado compensating adjustment

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string
required

Canonical idempotency request ID (lib-commons enforcer reads this). Reusing the same key on a retry returns the SAME durably accepted operation, never a duplicate.

Body

application/json
adjustmentAmount
string
required

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

currency
string
required

ISO-4217 currency code.

Required string length: 3
justification
string
required

Operator's structured justification.

Required string length: 1 - 4000
numeroContrato
string
required

Canonical rail contract number.

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

Closed reason catalog; no free-form 'other'.

Available options:
payment_shortfall,
payment_excess,
immutable_client_correction,
internal_ccb_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.

Response

Accepted

adjustmentAmount
string
required

Signed compensating entry magnitude, exact two-decimal string.

createdAt
string
required

RFC3339 UTC.

createdBy
string
required

Validated actor identity that created this operation.

currency
string
required

ISO-4217 currency code.

existing
boolean
required

True when this call replayed an already-committed operation for the same idempotency key, never a duplicate.

id
string
required

Compensating adjustment operation identifier.

idempotencyKey
string
required

Idempotency key this operation was created (or replayed) under.

justification
string
required

Operator's structured justification.

numeroContrato
string
required

Canonical rail contract number.

reason
string
required

Closed reason catalog.

correctionEventId
string

Landed correction event this adjustment resolves, when set.

debtAmountAfter
string

CCB debt after, when this adjustment changes the debt.

debtAmountBefore
string

CCB debt before, when this adjustment changes the debt.

divergenceId
string

Divergence this adjustment resolves, when set.

resolvedGlAccount
string

Suspense GL account this operation was authorized against. Empty when the currency had no configured suspense account at create time — the posting intent could not be recorded yet.