Reconcile an operation against the counterpart's settlement status
Consults Núclea for the AUTHORITATIVE SLC0908 settlement status of one operation and synchronises the local record under NUCLEA_RECONCILED, leaving an operation_state_log row whose trigger separates a machine synchronisation from an operator’s override. Admin-only (operations:admin). The reason is mandatory and enforced by the domain (400 MISSING_OVERRIDE_JUSTIFICATION); the reconciling subject is taken from the validated request identity, never from the payload. WHY THIS PATH EXISTS ALONGSIDE THE DRAINS: the /v1/connectivity/* recovery verbs (dispatch, forward, repoll, status-relay, reprocess, unpark) re-drive OUR OWN internal transport and never consult the counterpart, so they cannot report what Núclea believes — this operation asks Núclea and records the answer. Disjoint capabilities, not substitutes. Only FORWARDED->CONFIRMED and CONFIRMED->SETTLED are driveable: a counterpart state further away is refused rather than walked (409 INVALID_STATE_TRANSITION), because walking it would fabricate an intermediate transition nobody observed. An operation carrying no NUliquid has no key to run the consulta with and answers 409 SLC-0119 with the state-specific remediation. A counterpart status outside the mapped vocabulary answers 409 SLC-0121 and writes nothing.
Autorizaciones
JWT bearer token issued by the identity provider.
Parámetros de ruta
Operation id (UUID).
"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"
Cuerpo
ISPB (8 characters) the SLC0908 consulta is run on behalf of. A resource selector for the counterpart node, not an identity claim.
"12345678"
Audit justification (mandatory; enforced by the domain). At most 1024 characters. This verb takes no evidence — the counterpart's answer is the evidence.
1024"operation stuck at FORWARDED after the ASLC023 window closed"
Respuesta
OK
Outcome class: IN_SYNC (the two ledgers already agreed, nothing written) or SYNCHRONIZED (the local record was advanced).
IN_SYNC, SYNCHRONIZED "SYNCHRONIZED"
The counterpart's RAW SLC0908 settlement status, echoed verbatim rather than re-rendered through this service's vocabulary.
"CONFIRMED"
Local state after the reconcile.
"CONFIRMED"
Operation id (UUID) that was reconciled.
"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"
Local state before the reconcile. Equal to localState on an IN_SYNC run.
"FORWARDED"
Authenticated subject who requested the reconcile, taken from the validated request identity and never from the payload.
"ops@acquirer.com"
Counterpart control number correlating the operation, when the answer carried one.
"CTRL-0042"
Transition trigger (always NUCLEA_RECONCILED). Absent on an IN_SYNC run, where no transition was persisted.
"NUCLEA_RECONCILED"

