> ## 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.

# Cómo funciona TED Lerian

> El ciclo de vida de cada transferencia de TED Lerian, enviada, recibida y devuelta, con los estados que devuelve la API y lo que significa cada uno para tu cliente.

## Envío de una TED

***

**1. Validar**

TED Lerian verifica el formato del monto, el código de finalidad de 5 dígitos, el banco del destinatario en la lista de participantes del STR. También verifica que el documento del destinatario sea un CPF o un CNPJ. Un fallo en este punto no crea ninguna transferencia.

**2. Aplicar la política**

Verifica la ventana efectiva (el horario oficial del STR, el horario de corte de la institución y los feriados), los límites de uso y, cuando está configurada, la comisión calculada por Midaz.

**3. Retener**

TED Lerian retiene el monto más la comisión en la cuenta de origen. Estado `RESERVED`.

**4. Enviar al STR**

Lerian SPB acepta el comando y devuelve el `nuop`. Estado `SUBMITTED`. Este es el estado que suele mostrar la respuesta de creación.

**5. Liquidar**

El STR decide de forma asíncrona: liquida, rechaza o mantiene el asiento pendiente. El resultado llega como evento y en una lectura.

### Estados de una transferencia enviada

| Estado | Qué significa | Qué puedes hacer |
| - | - | - |
| `CREATED` | Registrada; todavía no hay nada retenido. En una transferencia interna también significa que la respuesta del ledger fue indeterminada, lo que el reprocesamiento resuelve. | Cancelar |
| `RESERVED` | Monto y comisión retenidos; a punto de ir al STR. | Cancelar |
| `SUBMITTED` | Enviada al STR, a la espera de su decisión. | Esperar |
| `PENDING_STR` | El STR aceptó el asiento y lo mantiene pendiente. La retención se mantiene. | Pedir al STR que cancele (`202`) |
| `SETTLED` | Liquidada; el débito es definitivo. Estado final. | Nada. Una devolución de la otra institución aparece en `returned`. |
| `REJECTED` | Rechazada por el ledger, Lerian SPB, el STR o un operador, con `rejection.code`, `reason` y `source`. La retención se libera. Estado final. | Nada |
| `CANCELLED` | Cancelada; la retención se libera. Estado final. | Nada |
| `AWAITING_RECONCILIATION` | Sin respuesta a tiempo. La retención nunca se libera por un timeout; la conciliación pide el resultado a Lerian SPB. | Un operador desbloquea con evidencia |
| `EXHAUSTED` | La conciliación automática agotó los intentos; el resultado sigue siendo desconocido. | Un operador desbloquea con evidencia |

> [!NOTE]
>
> Aceptada no es liquidada. Un `201` confirma que la TED fue aceptada y, por regla general, enviada. El dinero salió solo cuando el estado es `SETTLED`. Un rechazo del ledger o de Lerian SPB ya puede venir en la respuesta de creación (`rejection.source` `LEDGER` o `RAIL`). Un rechazo del STR o de un operador aparece solo en una lectura posterior.

## Transferencias internas

***

Cuando el banco del destinatario es el ISPB propio de la institución, TED Lerian encuentra la cuenta del destinatario en el CRM de Midaz. Liquida todo en una sola transacción de Midaz. La ventana del STR no aplica, pero los límites de uso y, cuando está configurada, la comisión sí aplican. La respuesta tiene `type=INTERNAL` y `recipient.accountId` completo. Si el destinatario no existe o pertenece a otra organización, TED Lerian rechaza la solicitud con `TED-1021` y no crea ninguna transferencia.

## Recepción de una TED

***

**1. Registrar**

Lerian SPB informa que el STR liquidó una TED para la institución. El plazo de 60 minutos empieza en `interbankSettledAt`.

**2. Enrutar**

TED Lerian encuentra la vinculación de ISPB de la institución receptora. Sin vinculación, la TED va a revisión manual.

**3. Encontrar y verificar**

TED Lerian busca la agencia, la cuenta y el documento del destinatario en el CRM de Midaz. El titular y el tipo de cuenta tienen que coincidir.

**4. Decidir**

Acredita al cliente, devuelve la TED con el motivo oficial o la envía a revisión manual.

| Estado | Qué significa |
| - | - |
| `RECEIVED` | El STR liquidó la TED y TED Lerian la registró. La decisión está en curso. |
| `CREDITED` | El monto se acreditó al cliente. |
| `RETURN_REQUESTED` | La devolución fue al STR con el motivo oficial. |
| `RETURNED` | El STR liquidó la devolución; el dinero volvió a la institución emisora. |
| `MANUAL_REVIEW` | TED Lerian no pudo terminar por su cuenta, o el STR rechazó la devolución. Un operador decide. |

Cuando Lerian SPB entrega una TED dos veces, TED Lerian la acredita solo una vez.

## Cuando otra institución devuelve tu TED

***

TED Lerian encuentra la transferencia original, registra la devolución en el bloque `returned` de la transferencia y vuelve a acreditar al remitente. La transferencia sigue en `SETTLED`, y `transfer.returned` avisa a tu sistema. De forma predeterminada, TED Lerian no reembolsa la comisión de envío. `returned.feeRefunded` indica si la reembolsó.

Si ninguna transferencia liquidada lleva todavía el número de control de la TED devuelta, TED Lerian retiene la devolución. Aplica la devolución cuando esa transferencia se liquida. Un operador lista las devoluciones retenidas con `GET /v1/reconciliation/held-returns`.

## Cancelación

***

| Estado actual | Resultado |
| - | - |
| `CREATED`, `RESERVED` | `200`, cancelada de inmediato, retención liberada. Mientras una llamada a Midaz o a Lerian SPB para la transferencia está en curso, `409 TED-0061`. |
| `PENDING_STR` | `202`, cancelación solicitada al STR. El resultado llega como `transfer.cancelled` o `transfer.settled`. Esta cancelación viene desactivada de forma predeterminada. Mientras está desactivada, la respuesta es `503 TED-1012`. |
| `CANCELLED` | `200`, sin ningún efecto nuevo. |
| `SUBMITTED`, `SETTLED`, `REJECTED` | `409 TED-0061`. Para dinero que ya salió, el camino es una devolución por parte de la otra institución. |
| `AWAITING_RECONCILIATION`, `EXHAUSTED` | `409 TED-0061`. El estado real en el STR es desconocido; en su lugar, desbloquea con evidencia. |

Las TEDs entrantes nunca se pueden cancelar.

## Conciliación y desbloqueo

***

Una transferencia sin respuesta a tiempo entra en la cola de conciliación con su antigüedad y su último estado conocido. De forma predeterminada, TED Lerian pide el resultado a Lerian SPB 15 minutos después de aceptar la transferencia e intenta hasta 8 veces. Liquidada convierte la retención en un débito, y rechazada libera la retención. Cualquier otra respuesta, incluida no encontrada, mantiene la retención hasta el siguiente intento. Cuando se agotan los intentos, la transferencia pasa a `EXHAUSTED` y un operador la desbloquea con la evidencia. Nada se revierte sin evidencia.

Una verificación periódica también busca inconsistencias entre Midaz y los estados de las transferencias, como una devolución sin nuevo crédito o una retención huérfana. Las lista para el operador.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.