Disparar Poller de TED IN

Utilice este endpoint para forzar un ciclo inmediato de polling JD entrante para el tenant actual. Este es un endpoint operacional destinado a acelerar la recepción de mensajes de retorno de JD sin esperar el intervalo de polling programado. No requiere el header X-Organization-Id — el tenant se deriva del contexto autenticado.

Las reentregas con la misma clave reproducen la respuesta en caché en lugar de drenar JD nuevamente. Una duplicación en vuelo es rechazada con 409 por el middleware de idempotencia a nivel de ruta.

POST /v1/transfers/ted-in/poll

Disparar Poller de TED IN

cURL

curl --request POST \
  --url https://plugin-br-bank-transfer.sandbox.lerian.net/v1/transfers/ted-in/poll \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Idempotency: <x-idempotency>'

200

success

{
  "tenantId": "11111111-1111-1111-1111-111111111111",
  "outcome": "success",
  "processed": 3
}

Autorizaciones

Authorization · string · header · requerido

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.

Encabezados

X-Idempotency · string · requerido

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 para más detalles.

Maximum string length: 255

Respuesta

200

application/json

Indica que el ciclo de polling se completó. El campo outcome reporta el resultado del ciclo: success, empty, skipped_outside_window, skipped_busy, cancelled o error.

outcome · enum<string> · requerido

Etiqueta del resultado del ciclo. success y empty son rutas felices terminales; skipped_* indica que el ciclo no se ejecutó; cancelled y error indican trabajo abortado.

Opciones disponibles: success, empty, skipped_outside_window, skipped_busy, cancelled, error

Ejemplo:

"success"

processed · integer · requerido

Número de mensajes entrantes drenados y procesados durante este ciclo.

Rango requerido: x >= 0

Ejemplo:

3

tenantId · string<uuid>

El tenant para el cual se ejecutó el ciclo de polling, cuando esté disponible.

Ejemplo:

"11111111-1111-1111-1111-111111111111"