> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar operaciones atascadas (dashboard del operador) > Devuelve la página de dashboard del operador, transversal a los rails, de operaciones que requieren atención, conformada al vocabulario de recuperación compartido. Cada fila lleva solo los verbos que SPB realmente puede ejecutar sobre ella (un verbo que SPB no puede ejecutar está ausente) y la disposición ('qué pasa si no hago nada'). Los casos de conciliación se muestran con sus affordances; las filas de salida atascadas previas a un caso que el barrido de despacho está reintentando se muestran de forma informativa, sin affordances. No se devuelven campos monetarios ni de posición. ## OpenAPI ````yaml es/openapi/v3-current/spb.yaml get /v1/str/stuck-operations openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian Studio url: https://lerian.studio description: >- Interfaz OpenAPI 3.1 de Lerian SPB, la integración directa entre la institución y el Sistema de Pagos Brasileño (SPB) sobre la Red del Sistema Financiero Nacional (RSFN). Cubre el Sistema de Transferencia de Reservas (STR): registro de mensajes y catálogo de capacidades, ciclo de vida de las operaciones (transferencias bancarias, repasses IBS, transferencias de liquidez, devoluciones y cancelaciones), consultas de cuenta de reservas y de horarios, gobernanza de alçada, conciliación y entrega de eventos. license: name: Lerian Studio General License title: Lerian SPB API version: 1.0.0 servers: - url: https://spb.sandbox.lerian.net security: [] tags: - description: >- Rastros inmutables de registros de auditoría para operaciones STR y eventos de ciclo de vida. name: Audit - description: >- Catálogo de capacidades STR que describe los tipos de mensaje admitidos y sus restricciones. name: Capabilities - description: >- Inventario de certificados ICP-Brasil con rotación y activación recargables en caliente. name: Certificates - description: >- Cola de aprobación maker-checker para emisiones retenidas por encima de su banda de alçada: listar pendientes, firmar (aprobar) y denegar. name: EmissionApprovals - description: >- Registros de entrega de eventos por webhook con control de reintentos para despachos fallidos. name: EventDeliveries - description: >- Catálogo de eventos de operación que enumera los tipos de evento de dominio emitidos. name: Events - description: >- Registro de avisos entrantes de la familia GEN (GEN0001 eco de conectividad, GEN0004 error de transmisión, GEN0005 aviso administrativo). name: GenNotices - description: >- Gobernanza de alçada del SPB: la tabla de bandas de valor y los requisitos de firma por tipo de mensaje, recargados en caliente en tiempo de ejecución. name: Governance - description: >- Estado crudo de los mensajes STR: listar los mensajes y leer un mensaje individual por NUOp. name: Messages - description: Resúmenes y métricas operativas agregadas de las operaciones STR. name: OperationalIntelligence - description: >- Ciclo de vida de las operaciones STR para transferencias bancarias y repasses IBS, incluyendo devoluciones y cancelaciones. name: Operations - description: >- Estado de disponibilidad del servicio que abarca las autopruebas de arranque y la salud de las dependencias. name: Readiness - description: >- Casos de conciliación y las acciones que resuelven las discrepancias de operación. name: Reconciliation - description: >- Suite de reportes STR: reportes agregados síncronos por rango de fechas (movimiento financiero, transacciones rechazadas, volumetria) sobre el propio registro de transmisión de Lerian SPB. name: Reports - description: >- Consultas de saldo de cuenta de reservas STR0013 y de extrato STR0014 (modo mensaje) y sus resultados asíncronos. name: ReserveQueries - description: >- Lista de responsáveis del participante GEN0019: actualizaciones de reemplazo total anunciadas a BACEN. name: Responsibles - description: >- Programación de ventanas de operación del STR que rige cuándo pueden enviarse las operaciones. name: Schedule - description: >- Consultas de horarios STR0001 de parte única (consulta de horários do STR) y sus resultados de grilla STR0001R1 asíncronos. name: ScheduleQueries - description: >- Ajustes de configuración del SPB en tiempo de ejecución para la integración STR. name: Settings - description: Registro y gestión de endpoints de webhook para la entrega de eventos. name: Webhooks - description: >- Flujo (orden obligatorio): certificado → disponibilidad → prueba-de-conectividad → envío. Activa un certificado, confirma que el rail reporta listo, pasa una prueba de conectividad y luego envía una operación. Cada paso es su propio recurso; no debes intentar un envío antes de que la disponibilidad pase. name: onboarding - description: >- Flujo (orden obligatorio): operación padre SETTLED → devolución/cancelación. Una devolución o cancelación es un sub-recurso de una operación padre liquidada; el segmento de ruta {operationId}/{endToEndID} impone el padre estructuralmente. name: lifecycle paths: /v1/str/stuck-operations: get: tags: - Operations summary: Listar operaciones atascadas (dashboard del operador) description: >- Devuelve la página de dashboard del operador, transversal a los rails, de operaciones que requieren atención, conformada al vocabulario de recuperación compartido. Cada fila lleva solo los verbos que SPB realmente puede ejecutar sobre ella (un verbo que SPB no puede ejecutar está ausente) y la disposición ('qué pasa si no hago nada'). Los casos de conciliación se muestran con sus affordances; las filas de salida atascadas previas a un caso que el barrido de despacho está reintentando se muestran de forma informativa, sin affordances. No se devuelven campos monetarios ni de posición. operationId: listStuckOperations parameters: - description: >- Attention reason filter (e.g. STUCK_OUTBOUND, AWAITING_RAIL_RESPONSE, RETRY_FAILED, REQUIRES_OPERATOR_ACTION) explode: false in: query name: reason schema: description: >- Attention reason filter (e.g. STUCK_OUTBOUND, AWAITING_RAIL_RESPONSE, RETRY_FAILED, REQUIRES_OPERATOR_ACTION) type: string - description: Age bucket filter (OVER_5_MIN, OVER_15_MIN, OVER_1_HOUR, OVER_1_DAY) explode: false in: query name: age schema: description: >- Age bucket filter (OVER_5_MIN, OVER_15_MIN, OVER_1_HOUR, OVER_1_DAY) type: string - description: >- Canonical operation state filter (e.g. AWAITING_RESPONSE, REQUIRES_OPERATOR_ACTION, RECOVERY_IN_PROGRESS) explode: false in: query name: state schema: description: >- Canonical operation state filter (e.g. AWAITING_RESPONSE, REQUIRES_OPERATOR_ACTION, RECOVERY_IN_PROGRESS) type: string - description: Page size (default 50, max 100) explode: false in: query name: limit schema: default: 50 description: Page size (default 50, max 100) format: int64 maximum: 100 minimum: 1 type: integer - description: Opaque pagination cursor explode: false in: query name: cursor schema: description: Opaque pagination cursor type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/StuckPageResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: StuckPageResponse: additionalProperties: false properties: capabilities: $ref: '#/components/schemas/RailCapabilitiesResponse' description: >- Rail-level honest capability manifest (returned inline to save a round trip). correlationId: description: >- Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace. type: string items: description: Stuck-operation rows needing operator attention. items: $ref: '#/components/schemas/StuckOperationViewResponse' type: - array - 'null' limit: description: Page size applied to this response (max items returned). format: int64 type: integer nextCursor: description: >- Opaque cursor for the next page; absent when exhausted. Presence signals more results, absence signals end-of-list. type: string required: - items - capabilities - limit - correlationId type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object RailCapabilitiesResponse: additionalProperties: false properties: hasBudgetReArm: description: True when a RESOLVE-class verb re-arms an automatic dispatch budget. type: boolean hasCrashWindowRecovery: description: True only for SPB (evidence-first crash-window recovery). type: boolean hasDeadlineExpiry: description: >- True when the rail detects and surfaces operations past a deadline (detection-only; an operator terminalizes them, the rail never auto-mutates). type: boolean hasDeadlineSweep: description: True when a background sweep re-attempts/ages stuck rows. type: boolean hasDlqReplay: description: True when the rail exposes an operator DLQ list/replay surface. type: boolean hasInboundStuckDetection: description: True when the rail detects inbound messages stuck mid-processing. type: boolean rail: description: Rail this manifest describes. examples: - spb type: string replayNowWired: description: True when an operator REPLAY actually re-sends stored bytes. type: boolean supportedVerbs: description: Closed set of verbs this rail can ever offer on any row. items: type: string type: - array - 'null' required: - rail - supportedVerbs - hasCrashWindowRecovery - hasDeadlineSweep - hasBudgetReArm - hasDlqReplay - hasInboundStuckDetection - hasDeadlineExpiry - replayNowWired type: object StuckOperationViewResponse: additionalProperties: false properties: affordances: description: >- The ONLY source of operator buttons for this row; a verb the rail cannot perform is absent. items: $ref: '#/components/schemas/OperatorAffordanceResp' type: - array - 'null' age: description: Normalized staleness bucket. examples: - OVER_15_MIN type: string correlation: $ref: '#/components/schemas/CorrelationResponse' description: Protocol identity the row is keyed on (no monetary fields). detail: additionalProperties: {} description: >- Render-only per-rail drill-down blob; shown for display only, never used to branch logic. type: object disposition: description: What happens if the operator does nothing. examples: - SYSTEM_RETRYING type: string rail: description: Rail that owns the row (spb or spi). examples: - spb type: string reason: description: Normalized cause the row needs attention. examples: - STUCK_OUTBOUND type: string state: description: Canonical operation lifecycle state. examples: - AWAITING_RESPONSE type: string required: - rail - state - correlation - reason - disposition - affordances type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object OperatorAffordanceResp: additionalProperties: false properties: reasonCode: description: Stable machine code for display + telemetry only. type: string requirement: description: 'Gating tier: DIRECT, APPROVAL_REQUIRED, or ADVISORY.' examples: - DIRECT type: string semanticsNote: description: Display-only note clarifying what the verb does on this row. type: string verb: description: Operator intent this affordance authorizes on the row. examples: - RESOLVE type: string required: - verb - requirement type: object CorrelationResponse: additionalProperties: false properties: messageType: description: Catalogue message type. examples: - STR0008 type: string operationRef: description: Operation identity the row is keyed on. type: string protocolRef: description: Rail protocol control number / reference. type: string required: - operationRef type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````