Skip to main content

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.

6 de mayo de 2026 Actualización de documentación Revisión requerida

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

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


1
Revisa tus payloads de creación de transferencia TED.
2
Asegúrate de que purpose se envíe con InitiateTransferRequest.
3
Usa la documentación pública actualizada para nombres de campos, campos obligatorios, ejemplos de webhook y referencia de errores.
4
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.

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