Marcar uma transferência de entrada para processamento urgente
Sinaliza uma transferência INBOUND que está AvailableForDownload para download+processamento IMEDIATOS em vez de aguardar o próximo ciclo de sondagem. O ator é derivado da identidade validada da solicitação (nunca do payload ou da rota). O serviço valida a direção, o estado e a política de urgência habilitada por tenant e, em seguida, em UMA transação por tenant, grava um marcador durável urgent_requested_at na linha da transferência e registra o evento de auditoria de marcação urgente. Após o commit, envia um wake best-effort do Redis para que o worker sonde o tenant imediatamente; a sondagem priorizada por tenant recolhe a linha marcada PRIMEIRO (e ainda o faz no próximo tick regular se o wake for perdido), baixa o arquivo e confirma ao BACEN com REC. A urgência altera apenas o tempo.
Autorizações
Bearer token authentication (format: "Bearer {token}")
Parâmetros de caminho
Transfer UUID
Resposta
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.

