> ## 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. # Reanudar Poller de TED IN > Utilice este endpoint para limpiar el latch de recepción "at-most-once" fail-closed y re-armar un poller de TED IN latched o muerto sin reiniciar el pod. Este es un endpoint de operador con mayor privilegio que `/ted-in/poll` porque vuelve a abrir el consumo de lectura destructiva de JD. Recúrralo solo cuando la auto-recuperación no pueda revivir el poller — un hijo multi-tenant en panic o un poller de un solo tenant que superó el hard-cap de panic. La reanudación nunca omite la barrera de brechas duraderas de la money-path. Cuando el latch live receive-state-unknown está activado, la fila de brecha de reconciliación del latch actual debe estar durable antes de que el poller se reanude; de lo contrario, la solicitud se rechaza con `409` y el poller permanece muerto. Verifique la brecha pendiente con [Listar Brechas de Reconciliación de TED IN](/es/reference/midaz/plugins/ted/list-ted-in-reconciliation-gaps) antes de llamar a resume. El cuerpo opcional `{acknowledge, note}` adicionalmente marca la brecha de reconciliación del latch actual como resuelta y estampa una anotación de operador sobre ella. `acknowledge` por defecto es `false`, dejando la brecha OPEN para que permanezca visible para revisión. Un poller sano y not-latched devuelve `200` con `resumed: false` y `reason: "not_latched"` — la llamada es un no-op idempotente seguro. Los reintentos con la misma key reproducen la respuesta cacheada. La ruta es independiente de la organización y no requiere el header `X-Organization-Id` — el tenant se resuelve desde el contexto autenticado. En despliegues multi-tenant, un tenant inactivo se rechaza con `503`. ## OpenAPI ````yaml es/openapi/v3-current/ted.yaml post /v1/transfers/ted-in/resume openapi: 3.0.3 info: title: API del Plugin de Transferencia Bancaria (TED) description: >- API completa para transferencias bancarias brasileñas (TED OUT, TED IN, P2P) a través de la plataforma Lerian, incluyendo iniciación de transferencias, procesamiento, seguimiento de estado y cancelación. version: 1.1.9 servers: - url: https://ted.sandbox.lerian.net description: Sandbox (marcador de posición — aún no disponible para acceso público) security: - BearerAuth: [] - OAuth2ClientCredentials: - api - OAuth2Password: - api tags: - name: Transfers API description: Endpoints para iniciar, procesar, rastrear y cancelar transferencias. - name: Webhooks description: >- Endpoints para registrar y gestionar suscripciones de webhooks con alcance al tenant para eventos de transferencia. - name: Webhook DLQ description: >- Endpoints para inspeccionar y reintentar mensajes de la dead-letter queue de webhooks. paths: /v1/transfers/ted-in/resume: post: tags: - Transfers API summary: Reanudar Poller de TED IN description: >- Utilice este endpoint para limpiar el latch de recepción "at-most-once" fail-closed y re-armar un poller de TED IN latched o muerto sin reiniciar el pod. Este es un endpoint de operador con mayor privilegio que `/ted-in/poll` porque vuelve a abrir el consumo de lectura destructiva de JD. Recúrralo solo cuando la auto-recuperación no pueda revivir el poller — un hijo multi-tenant en panic o un poller de un solo tenant que superó el hard-cap de panic. La reanudación nunca omite la barrera de brechas duraderas de la money-path. Cuando el latch live receive-state-unknown está activado, la fila de brecha de reconciliación del latch actual debe estar durable antes de que el poller se reanude; de lo contrario, la solicitud se rechaza con `409` y el poller permanece muerto. Verifique la brecha pendiente con [Listar Brechas de Reconciliación de TED IN](/es/reference/midaz/plugins/ted/list-ted-in-reconciliation-gaps) antes de llamar a resume. El cuerpo opcional `{acknowledge, note}` adicionalmente marca la brecha de reconciliación del latch actual como resuelta y estampa una anotación de operador sobre ella. `acknowledge` por defecto es `false`, dejando la brecha OPEN para que permanezca visible para revisión. Un poller sano y not-latched devuelve `200` con `resumed: false` y `reason: "not_latched"` — la llamada es un no-op idempotente seguro. Los reintentos con la misma key reproducen la respuesta cacheada. La ruta es independiente de la organización y no requiere el header `X-Organization-Id` — el tenant se resuelve desde el contexto autenticado. En despliegues multi-tenant, un tenant inactivo se rechaza con `503`. operationId: resumeTEDInPoller parameters: - $ref: '#/components/parameters/XIdempotencyKey' requestBody: required: false description: >- Opciones opcionales de reanudación. Un cuerpo vacío re-arma el poller y deja la brecha de reconciliación abierta. content: application/json: schema: $ref: '#/components/schemas/TEDInResumeRequest' examples: rearmOnly: summary: Re-armar el poller, dejar la brecha abierta value: {} acknowledgeGap: summary: Re-armar y marcar la brecha actual como resuelta value: acknowledge: true note: verified against the JD cabine; no inbound message lost responses: '200': description: >- Indica que el intento de reanudación se completó. `resumed` es `true` cuando un poller latched o muerto fue re-armado y `false` para el no-op saludable. `gapResolved` es `true` solo cuando se solicitó `acknowledge` Y la fila de brecha fue marcada correctamente como resuelta. `reason` es el estado desde el que se reanudó (`receive_state_unknown`, `panic`, `auth_failure`) o `not_latched` para el no-op. content: application/json: schema: $ref: '#/components/schemas/TEDInResumeResponse' examples: resumed: summary: Poller latched re-armado value: resumed: true gapResolved: false reason: receive_state_unknown tenantId: 11111111-1111-1111-1111-111111111111 notLatched: summary: No-op saludable value: resumed: false gapResolved: false reason: not_latched '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': description: >- Reanudación rechazada. El latch receive-state-unknown aún no tiene una brecha de reconciliación durable, por lo que el poller permanece muerto. Reintente después de que la fila de brecha esté persistida. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': $ref: '#/components/responses/RateLimitExceeded' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' '504': $ref: '#/components/responses/GatewayTimeout' components: parameters: XIdempotencyKey: name: X-Idempotency in: header required: true description: >- Clave de idempotencia requerida para reintentos seguros. Utilice un UUID v4 o un identificador de negocio único. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta almacenada en caché. Consulte [Reintentos e idempotencia](/es/reference/retries-idempotency) para más detalles. schema: type: string maxLength: 255 example: 019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b schemas: TEDInResumeRequest: type: object description: >- Cuerpo opcional para una reanudación del poller de TED IN. Todos los campos son opcionales; un cuerpo vacío re-arma el poller y deja la brecha de reconciliación abierta. properties: acknowledge: type: boolean default: false description: >- Cuando es `true`, marca la brecha de reconciliación del latch actual como resuelta después de que el poller sea re-armado. Por defecto es `false` para que la brecha permanezca OPEN y siga visible para revisión. example: false note: type: string maxLength: 500 description: >- Anotación de operador estampada sobre la brecha resuelta cuando `acknowledge` es `true`. Ignorada en caso contrario. example: verified against the JD cabine; no inbound message lost TEDInResumeResponse: type: object required: - resumed - gapResolved - reason properties: resumed: type: boolean description: >- `true` cuando un poller latched o muerto fue re-armado; `false` para el no-op saludable. example: true gapResolved: type: boolean description: >- `true` solo cuando se solicitó `acknowledge` Y la fila de brecha fue marcada correctamente como resuelta. example: false reason: type: string enum: - receive_state_unknown - panic - auth_failure - not_latched description: >- El estado del poller desde el que se reanudó. `not_latched` indica el no-op idempotente. example: receive_state_unknown tenantId: type: string format: uuid description: >- Identificador del tenant resuelto. Omitido en despliegues de un solo tenant. example: 11111111-1111-1111-1111-111111111111 ErrorResponse: type: object required: - error properties: error: type: object required: - code - service - category - message - requestId properties: code: type: string description: >- El código de error estable. Los errores del plugin usan el formato `BTF-XXXX`; los rechazos de negocio/autenticación de JD SPB transmiten el código del proveedor sin modificar (p. ej. `AAC90`, `ACE95`, `DVE01`), y los fallos de JD a nivel de transporte muestran los marcadores sintéticos `TRANSPORT` o `JD_MISSING_CODE`. Haga la coincidencia sobre este valor en lugar del estado HTTP. example: BTF-0010 service: type: string description: El servicio o dominio que produjo el error. example: plugin category: type: string description: >- Categoría de error legible por máquina utilizada para las decisiones de reintento. enum: - deterministic - transient - rate_limit - plugin example: deterministic message: type: string description: Un resumen del error legible por humanos. example: >- Transfers can only be initiated Monday-Friday between 06:30 and 17:00 Brasília time requestId: type: string description: >- El ID de correlación de la solicitud. Presente incluso cuando está vacío. example: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f fields: type: object additionalProperties: true description: >- Metadatos estructurados de validación o reintento cuando están disponibles. Los detalles de validación a nivel de campo, encabezado, ruta y consulta se devuelven todos aquí. example: currentTime: '2026-02-01T18:30:00-03:00' operatingHours: Mon-Fri 06:30-17:00 UTC-3 responses: BadRequest: description: >- Indica que la solicitud contiene datos de entrada inválidos. Verifique los detalles del campo para errores de validación específicos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidInput: summary: Validation error value: error: code: BTF-0001 service: plugin category: deterministic message: >- The request contains invalid fields. Check the field details below. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f fields: recipientIspb: must be 8 digits amount: must be positive Unauthorized: description: Indica que la solicitud no tiene un token de autenticación válido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: Missing authorization value: error: code: BTF-0401 service: plugin category: deterministic message: Missing or invalid authentication token requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f Forbidden: description: >- Indica que el llamador está autenticado pero carece de permiso para esta operación, o el tenant no está licenciado para este endpoint. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: notLicensed: summary: Tenant not licensed value: error: code: BTF-0403 service: plugin category: deterministic message: Tenant is not licensed to use this endpoint requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f permissionDenied: summary: Caller lacks permission value: error: code: BTF-0405 service: plugin category: deterministic message: Caller lacks permission for this resource requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f RateLimitExceeded: description: >- Indica que se ha excedido el límite de solicitudes. Reintente después del número de segundos especificado en el encabezado Retry-After. headers: Retry-After: description: Segundos hasta que se restablezca el límite de solicitudes schema: type: integer example: 60 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimitExceeded: summary: Too many requests value: error: code: BTF-0429 service: plugin category: rate_limit message: >- Too many requests. Retry after the interval indicated by the `Retry-After` header. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f description: > Las respuestas de límite de tasa usan el código dedicado `BTF-0429` con la categoría `rate_limit`. Los clientes deben aplicar backoff usando el estado HTTP `429` y el encabezado `Retry-After`. InternalServerError: description: Indica que ocurrió un error interno inesperado. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internalError: summary: Internal error value: error: code: BTF-9000 service: plugin category: plugin message: Unexpected error while processing the request requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f ServiceUnavailable: description: >- Indica que un servicio externo (CRM, JD SPB, Midaz o Fees) no está disponible temporalmente. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: crmUnavailable: summary: CRM service down value: error: code: BTF-0502 service: crm category: transient message: >- Unable to validate account. The CRM service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f jdUnavailable: summary: JD SPB unavailable value: error: code: TRANSPORT service: jd_spb category: transient message: >- Unable to submit transfer. The JD SPB service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f midazUnavailable: summary: Midaz ledger unavailable value: error: code: BTF-2000 service: midaz category: transient message: >- Unable to process transfer. The Midaz ledger service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f feeServiceUnavailable: summary: Fee service unavailable (fail-closed mode) value: error: code: BTF-3000 service: fees category: transient message: >- Unable to calculate fee. The fee service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f dlqInspectorUnavailable: summary: DLQ inspector not configured value: error: code: BTF-9005 service: plugin category: deterministic message: DLQ inspector is not configured requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f GatewayTimeout: description: >- Indica que la operación upstream no se completó antes del deadline de la solicitud. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: timeout: summary: Drain exceeded deadline value: error: code: BTF-9000 service: plugin category: plugin message: 'trigger ted in poller: request timed out' requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Autenticación mediante token JWT Bearer. El tenantId se deriva del token bearer o del contexto autenticado de la solicitud y no se proporciona a través de X-Organization-Id. OAuth2ClientCredentials: type: oauth2 flows: clientCredentials: tokenUrl: /v1/login/oauth/access_token scopes: api: Acceso a la API de transferencias TED OAuth2Password: type: oauth2 flows: password: tokenUrl: /v1/login/oauth/access_token scopes: api: Acceso a la API de transferencias TED ````