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 contra el dominio FinlddCli del BACEN y el banco del destinatario en la lista de participantes del STR. También verifica los dígitos verificadores del CPF o CNPJ del destinatario. 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) y los límites de uso, con la estimación de comisión.

3. Retener

   TED Lerian retiene el monto en la cuenta de origen, y Midaz suma a la retención la comisión que aplican tus paquetes de comisiones. 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

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 tus paquetes de comisiones 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. Si una búsqueda falla o no da una respuesta clara, la TED pasa a revisión manual.

4. Decidir

   Acredita al cliente, registra la TED sin acreditar a ningún 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.
RECORDED	La TED es para una cuenta de la institución. No se acredita a ningún cliente. Estado final.
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.

Una cuenta es de la propia institución cuando el documento de su titular en el CRM de Midaz es el CNPJ de la organización a la que está vinculado el ISPB. Una TED a esa cuenta termina en RECORDED, y incoming_transfer.recorded avisa a tu sistema.

TED Lerian devuelve una TED para una cuenta de cliente cuyo closingDate en el CRM de Midaz es hoy o anterior, en hora de Brasilia. El motivo oficial es 1 (cuenta cerrada).

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.