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

# TED: documentación alineada con v2.4.0

> La documentación pública de TED ahora refleja la versión 2.4.0, incluyendo campos de transferencia, webhooks, configuración y referencias de error.

<Badge stroke icon="calendar-days" iconType="regular">6 de mayo de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Revisión requerida</Badge>

## Afecta

***

Equipos que usan la documentación pública de TED para construir o revisar integraciones con `plugin-br-bank-transfer`.

Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento del API en tiempo de ejecución.

<Note>
  El portal de documentación pública es la referencia orientada al cliente. Los archivos fuente del repositorio no deben tratarse como artefactos de integración ni como especificaciones API descargadas para uso de clientes.
</Note>

## Qué cambió

***

### Referencia API

La referencia API de TED ahora identifica la versión documentada como `2.4.0` y se actualizó donde la documentación pública se había desviado del comportamiento del plugin.

La corrección principal es el modelo de solicitud de transferencia: `InitiateTransferRequest` ahora documenta el campo obligatorio `purpose`, que se mapea a BACEN SPB `FinlddCli` y acepta un código numérico de 1 a 4 dígitos.

Otras actualizaciones de la referencia incluyen:

* Metadatos de versión corregidos a `2.4.0`.
* `amount` restaurado a la lista de campos obligatorios.
* `TransferList` y `TransferSummary` alineados con los DTOs de respuesta de Go.
* `ReadinessResponse.checks` aclarado para incluir el check `auth`.
* Códigos de error fantasma eliminados del catálogo público de errores.
* Códigos del vendor JD aclarados, incluyendo `AAC90` y `ALN01`.

### Guías y detalles operativos

Las guías de TED también se limpiaron para que el portal de documentación coincida con el comportamiento actual del plugin:

* Variables de configuración corregidas.
* `X-Organization-Id` documentado en la guía de desarrollador.
* Ejemplos de envelope de webhook corregidos.
* Semántica de jitter de reintentos actualizada para coincidir con la implementación.
* Las páginas de TED IN, TED OUT, mejores prácticas, modelo de datos, glosario y resumen recibieron correcciones menores.

## Impacto

***

Esta es una actualización de documentación. Hace más precisa la documentación pública, especialmente para equipos que implementan la creación de transferencias.

La señal importante de integración es `purpose`: si creas solicitudes de transferencia TED, tu payload debe incluir este campo.

## Qué necesitas hacer

***

<Steps>
  <Step>
    Revisa tus payloads de creación de transferencia TED.
  </Step>

  <Step>
    Asegúrate de que `purpose` se envíe con `InitiateTransferRequest`.
  </Step>

  <Step>
    Usa la documentación pública actualizada para nombres de campos, campos obligatorios, ejemplos de webhook y referencia de errores.
  </Step>

  <Step>
    No trates los archivos fuente del repositorio como artefactos de integración del cliente. Usa el portal de documentación como referencia orientada al cliente.
  </Step>
</Steps>

### Plazo

Antes de crear o actualizar una integración de transferencia TED.

### Por qué

La documentación anterior mezclaba el comportamiento correcto del producto con detalles de referencia obsoletos y metadatos de versión incorrectos. Esta actualización elimina esa ambigüedad y mantiene la documentación pública enfocada en lo que los clientes necesitan para implementar correctamente.

## Recursos

***

* [Configuración de TED](/es/midaz/plugins/ted/ted-configuration)
* [Guía de desarrollador de TED](/es/midaz/plugins/ted/ted-developer-guide)
* [Webhooks de TED](/es/midaz/plugins/ted/ted-webhooks)
* [Lista de errores de TED](/es/reference/midaz/plugins/ted/ted-error-list)