Marcar una transferencia entrante para procesamiento urgente
Marca una transferencia INBOUND que está AvailableForDownload para descarga+procesamiento INMEDIATOS en lugar de esperar al siguiente ciclo de sondeo. El actor se deriva de la identidad validada de la solicitud (nunca del payload ni de la ruta). El servicio valida la dirección, el estado y la política de urgencia habilitada por tenant, y luego, en UNA transacción por tenant, estampa un marcador durable urgent_requested_at en la fila de la transferencia y registra el evento de auditoría de marcado urgente. Tras el commit envía un wake best-effort de Redis para que el worker sondee el tenant de inmediato; el sondeo priorizado por tenant recoge la fila marcada PRIMERO (y aún lo hace en el siguiente tick regular si el wake se pierde), descarga el archivo y confirma a BACEN con REC. La urgencia solo cambia el momento.
Autorizaciones
Bearer token authentication (format: "Bearer {token}")
Parámetros de ruta
Transfer UUID
Respuesta
OK
DownloadAttempts is the legacy aggregate counter; for inbound transfers, see hashMismatchAttempts + transmissionAttempts.
ExpiresAt / SecondsRemaining / Expired project the 44h BACEN protocol TTL directly onto the read view (the dedicated GET /:id/expiry endpoint was folded in here). ExpiresAt is nil — and SecondsRemaining 0, Expired false — until the transfer is assigned a protocol number (ProtocolGeneratedAt nil). Once assigned, ExpiresAt is ProtocolGeneratedAt + TTL; SecondsRemaining counts down to it at the handler clock and clamps to 0, at which point Expired flips true.
HashMismatchAttempts is the inbound-only counter that drives the StateInconsistent terminal budget (HASH_MISMATCH). Always 0 for outbound transfers.
TransmissionAttempts is the inbound-only counter that drives the StateCanceled / DOWNLOAD_FAILED terminal budget. Always 0 for outbound transfers.
UrgentRequestedAt is the UTC timestamp at which an operator flagged this inbound transfer for urgent processing (mark-urgent). Nil (and omitted) for transfers that were never marked urgent.

