Skip to main content
6 de mayo de 2026 Actualización de documentación Revisión requerida

​
Afecta a

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 de la API en runtime.
El portal de documentación pública es la referencia de cara al cliente. No se recomienda tratar los archivos fuente del repositorio como artefactos de integración ni como especificaciones de API descargadas para uso del cliente.

​
Qué cambió

​
Referencia de API

La referencia de la 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 FinlddCli de SPB de BACEN 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 en la lista de campos obligatorios.
  • TransferList y TransferSummary alineados con los DTO de respuesta de Go.
  • ReadinessResponse.checks aclarado para incluir la verificación auth.
  • Códigos de error fantasma eliminados del catálogo público de errores.
  • Códigos de proveedor de JD aclarados, incluidos 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 para desarrolladores.
  • Ejemplos del envelope de webhook corregidos.
  • Semántica del 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 la documentación pública más precisa, en especial para los equipos que implementan la creación de transferencias. La señal de integración importante es purpose: si creas solicitudes de transferencia TED, tu payload debe incluir este campo.

​
Qué debes hacer

1
Revisa tus payloads de creación de transferencias TED.
2
Confirma que purpose se envía con InitiateTransferRequest.
3
Usa la documentación pública actualizada para los nombres de campos, los campos obligatorios, los ejemplos de webhook y la referencia de errores.
4
No trates los archivos fuente del repositorio como artefactos de integración de cliente. Usa el portal de documentación como la referencia de cara al cliente.

​
Plazo

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

​
Por qué

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

​
Recursos