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

# Eventos do TED Lerian

> Os eventos de ciclo de vida que o TED Lerian publica para TEDs enviadas, TEDs recebidas e devoluções, como são entregues e como eliminar duplicatas.

O TED Lerian publica um evento a cada etapa do ciclo de vida das transferências enviadas, das TEDs recebidas e das devoluções, no barramento de eventos da plataforma. O Streaming Hub os entrega aos sistemas da sua instituição.

## Como a entrega funciona

***

* **Pelo menos uma vez.** Um evento pode chegar mais de uma vez. Depois que o TED Lerian registra a mudança de status, ele nunca perde o evento.
* **Apenas depois do commit da mudança.** O TED Lerian grava o evento na mesma transação do status. Nenhum evento descreve um status que depois desaparece.
* **Elimine duplicatas por `ce-id`.** O identificador é determinístico: a mesma transição sempre produz o mesmo `ce-id`.
* **Não dependa da ordem de chegada.** Ordene os eventos pelo ciclo de vida e pelos timestamps dentro de cada evento.
* **CloudEvents 1.0.** O tipo é `studio.lerian.br-ted.<resource>.<event>`. `ce-subject` é o id da transferência, da TED recebida ou da devolução.
* Valores monetários vêm como string (`"1500.00"`). Os timestamps estão em UTC.

## Catálogo

***

| Evento | Quando acontece |
| - | - |
| `transfer.created` | Uma TED ou transferência interna foi aceita e registrada; nada foi reservado nem enviado ainda. O único evento que traz `clientReference`. |
| `transfer.reserved` | O valor mais a tarifa está reservado na conta de origem; a TED está prestes a ir para o STR. |
| `transfer.submitted` | A TED foi enviada ao STR; a reserva continua enquanto o STR decide. |
| `transfer.pending_str` | O STR confirmou o recebimento da TED e ainda não a liquidou; a reserva continua. |
| `transfer.settled` | O STR liquidou a TED, ou o Midaz liquidou uma transferência interna. Status final. |
| `transfer.rejected` | Recusada pelo ledger, pelo Lerian SPB, pelo STR ou por um operador. Status final. |
| `transfer.cancelled` | O cancelamento teve efeito antes de o dinheiro sair. Status final. O TED Lerian libera a reserva depois deste evento. |
| `transfer.awaiting_reconciliation` | O resultado de uma chamada ao Midaz ou ao Lerian SPB é desconhecido. A reserva continua, e a conciliação automática pede o resultado ao Lerian SPB. |
| `transfer.exhausted` | A conciliação automática desistiu; a transferência aguarda a decisão de um operador. |
| `transfer.returned` | A instituição recebedora devolveu uma TED liquidada. O status da transferência não muda. O TED Lerian credita o valor de volta ao remetente depois deste evento. |
| `incoming_transfer.received` | Uma TED liquidada no STR foi recebida e registrada; ainda não foi creditada. |
| `incoming_transfer.credited` | O valor foi creditado na conta do recebedor. |
| `incoming_transfer.manual_review` | Uma TED recebida não pôde ser concluída sozinha; nada é creditado até o operador decidir. |
| `incoming_return.requested` | Uma devolução de TED recebida foi aceita e está indo para o STR com o motivo oficial. |
| `incoming_return.returned` | O STR liquidou a devolução; o dinheiro voltou para a instituição remetente. |
| `incoming_return.failed` | A devolução não foi concluída: o STR a recusou ou ela parou à espera de um operador. A TED recebida vai para revisão manual. |

> [!TIP]
>
> "Conciliada" não tem evento próprio. É um `transfer.settled` ou `transfer.rejected` cujo `previousStatus` é `AWAITING_RECONCILIATION` ou `EXHAUSTED`. Um consumidor inscrito em `transfer.settled` também recebe as liquidações resolvidas pela conciliação ou por um operador.


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