Crear acción de conciliación
Registra una acción de recuperación del operador sobre un caso de conciliación. Las acciones válidas son ACKNOWLEDGE, RESOLVE, DISMISS, INVESTIGATE. Los casos terminales (RESOLVED / DISMISSED) rechazan acciones adicionales con SPB-3007 / HTTP 409.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds (overrides the configured default).
Parámetros de ruta
Reconciliation case UUID.
Cuerpo
Recovery action to record: ACKNOWLEDGE, RESOLVE, DISMISS, or INVESTIGATE.
"ACKNOWLEDGE"
Operator-supplied human-readable rationale for the action (max 512 chars).
"investigating with bank"
Optional sanitized JSON object with additional action context (no PII).
Respuesta
OK
UUID of the newly recorded reconciliation action.
"b4e8f1a2-6c3d-4f57-9a10-1e1234567893"
UUID of the audit record linked to the action; empty when audit emission was disabled or failed (best-effort).
"c5f9a2b3-7d4e-4068-ab21-1e1234567894"
The reconciliation case after the action transition was applied.
Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.
Resulting case status after the action: OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.
"IN_PROGRESS"

