Crie um ajuste compensatório do consignado
Confirma de forma atômica uma nova operação de ajuste compensatório, sua entrada inicial do histórico e, quando a moeda tem uma conta de suspense configurada, o evento durável de intenção de contabilização no outbox. Uma resposta 202 significa aceito de forma durável, nunca contabilizado: o relay do ledger faz a contabilização separadamente. A operação é idempotente por meio do cabeçalho X-Idempotency aplicado pelo middleware da plataforma.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
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.
Corpo
Signed compensating entry magnitude, exact two-decimal string. Sign convention: payment_shortfall must be negative, payment_excess must be positive.
ISO-4217 currency code.
3Operator's structured justification.
1 - 4000Canonical rail contract number.
2 - 15Closed reason catalog; no free-form 'other'.
payment_shortfall, payment_excess, immutable_client_correction, internal_ccb_residual Landed correction event this adjustment resolves. At most one of divergenceId/correctionEventId may be set.
255CCB debt after this adjustment. Both-or-neither with debtAmountBefore.
CCB debt before this adjustment. Both-or-neither with debtAmountAfter.
Divergence this adjustment resolves. At most one of divergenceId/correctionEventId may be set.
Resposta
Accepted
Signed compensating entry magnitude, exact two-decimal string.
RFC3339 UTC.
Validated actor identity that created this operation.
ISO-4217 currency code.
True when this call replayed an already-committed operation for the same idempotency key, never a duplicate.
Compensating adjustment operation identifier.
Idempotency key this operation was created (or replayed) under.
Operator's structured justification.
Canonical rail contract number.
Closed reason catalog.
Landed correction event this adjustment resolves, when set.
CCB debt after, when this adjustment changes the debt.
CCB debt before, when this adjustment changes the debt.
Divergence this adjustment resolves, when set.
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.

