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

# Glosario

> Glosario de referencia del plugin Bank Transfer: BACEN, SPB, STR, ISPB, PSTI, códigos de cuenta ISO 20022 y tipos de mensaje de JD SPB como STR0008.

Referencia rápida de los términos y siglas que usa la documentación del plugin Bank Transfer.

## Términos regulatorios y de infraestructura

***

| Término                          | Definición                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ANBIMA**                       | Asociación Brasileña de las Entidades de los Mercados Financiero y de Capitales. Fuente upstream de la tabla nacional de feriados bancarios que consume el actualizador de feriados del plugin para poblar el calendario `bacen_holidays`.                                                                                                                      |
| **BACEN**                        | Banco Central do Brasil — el Banco Central de Brasil. Regula el sistema financiero y opera el SPB.                                                                                                                                                                                                                                                              |
| **SPB**                          | Sistema de Pagamentos Brasileiro — el sistema de pagos de Brasil, la infraestructura de todas las liquidaciones interbancarias.                                                                                                                                                                                                                                 |
| **STR**                          | Sistema de Transferência de Reservas — el sistema de transferencia de reservas, el componente de liquidación en tiempo real del SPB.                                                                                                                                                                                                                            |
| **RSFN**                         | Rede do Sistema Financeiro Nacional — la red financiera nacional segura que conecta a BACEN con las instituciones financieras.                                                                                                                                                                                                                                  |
| **PSTI**                         | Provedor de Serviço de Tecnologia da Informação — un proveedor de servicios de TI autorizado por BACEN para operar infraestructura de conectividad RSFN. JD Consultores es un PSTI.                                                                                                                                                                             |
| **ISPB**                         | Identificador de Sistema de Pagamentos Brasileiro — código de 8 dígitos que identifica de forma única a cada institución financiera en el SPB.                                                                                                                                                                                                                  |
| **STR0008**                      | El formato de mensaje de BACEN para iniciar una transferencia TED. Se envía desde la institución de origen al SPB.                                                                                                                                                                                                                                              |
| **STR0008R2**                    | El mensaje de respuesta/confirmación de STR0008. Contiene el resultado de la liquidación.                                                                                                                                                                                                                                                                       |
| **STR0010R2**                    | El formato de mensaje de chargeback. Se envía cuando una TED debe devolverse al banco de origen (por ejemplo, destinatario no encontrado).                                                                                                                                                                                                                      |
| **Devolução / `devolutionCode`** | Devolución de una TED. Cuando una TED OUT enviada antes se devuelve (STR0010R2), el plugin registra una devolución como una TED IN de retorno que lleva el código de motivo de BACEN (`devolutionCode`) y un `originalTransferId` que enlaza con la TED OUT original. (Una TED entrante que no se puede acreditar se devuelve por separado al banco de origen.) |
| **JD / JD SPB**                  | JD Consultores — el PSTI que usa Lerian para enrutar mensajes TED al SPB.                                                                                                                                                                                                                                                                                       |
| **Fallo de parseo de JD**        | Mensaje entrante de JD que no se pudo parsear (XML mal formado, tipo de mensaje desconocido, esquema que no coincide). Se persiste en `jd_incoming_parse_failures` para triage manual. Es distinto de las transferencias no entregables y de la DLQ de webhooks.                                                                                                |
| **NumCabSeq**                    | Identificador secuencial de mensaje que JD SPB asigna a cada envío de STR0008. Sirve para rastrear y consultar el estado de la transferencia.                                                                                                                                                                                                                   |
| **NumCtrlSTR**                   | Número de control de compensación de BACEN que asigna el STR (el sistema de transferencia de reservas) una vez que un mensaje se acepta en el flujo de compensación del SPB. Se persiste en la transferencia como `clearing_control_number`. Es distinto de `NumCabSeq`, que es la secuencia de mensaje que asigna JD en el envío.                              |

## Códigos de tipo de cuenta (ISO 20022)

***

| Código   | Tipo de cuenta                                        |
| -------- | ----------------------------------------------------- |
| **CACC** | Cuenta corriente (conta corrente) — el tipo más común |
| **CPAY** | Cuenta de pago (conta de pagamento)                   |
| **SLRY** | Cuenta de nómina (conta salário)                      |
| **SVGS** | Cuenta de ahorro (conta poupança)                     |

## Tipos de transferencia

***

| Término     | Definición                                                                                                             |
| ----------- | ---------------------------------------------------------------------------------------------------------------------- |
| **TED OUT** | Transferencia saliente — tu cliente envía fondos a una cuenta en otro banco.                                           |
| **TED IN**  | Transferencia entrante — tu institución recibe fondos de otro banco, detectados y acreditados de forma automática.     |
| **P2P**     | Transferencia interna — entre dos cuentas de la misma institución (mismo ISPB). Más rápida y por lo general sin costo. |
| **D+0**     | Liquidación el mismo día — TED es un instrumento D+0 cuando se envía antes de las 17:00 hora de Brasília.              |

## Términos propios del plugin

***

| Término                         | Definición                                                                                                                                                                                                                                                                                       |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **PaymentInitiation**           | La entidad creada mediante `POST /v1/transfers/initiate`. Contiene el cálculo de la comisión y expira después de 24 horas.                                                                                                                                                                       |
| **initiationId**                | UUID que devuelve el endpoint de inicio. Es obligatorio para confirmar una transferencia mediante `POST /v1/transfers/process`.                                                                                                                                                                  |
| **X-Idempotency**               | Header obligatorio para reintentos seguros. El plugin cachea la respuesta bajo la clave y la reproduce durante 24 horas. El plugin rechaza una solicitud repetida que reusa la clave con un cuerpo distinto (la huella no coincide).                                                             |
| **Comisión de cashin**          | Comisión que se descuenta del monto de una TED IN recibida. Se configura por organización mediante Fees Engine.                                                                                                                                                                                  |
| **Comisión de cashout**         | Comisión que se suma al monto de una TED OUT. La cuenta del remitente se debita por monto + comisión.                                                                                                                                                                                            |
| **Conciliación**                | Proceso para cotejar las transferencias en estado desconocido (PROCESSING sin confirmación) contra los registros de JD SPB.                                                                                                                                                                      |
| **DLQ**                         | Cola dead-letter de webhooks — las notificaciones de webhook salientes que no se pueden entregar después de todos los reintentos se mueven aquí para revisión manual.                                                                                                                            |
| **Artefacto de firma**          | Payload canónico de TED OUT que se congela durante `POST /v1/transfers/signing/prepare` y se persiste en `jd_outbound_signing_artifacts`. Lo consumen integraciones externas de HSM/firmante para producir una firma separada sin que el plugin tenga la clave privada.                          |
| **Systemplane**                 | Plano de administración de configuración en runtime, expuesto mediante `/system/:namespace` y `/system/:namespace/:key`. Contiene ajustes con hot reload que surten efecto sin un nuevo despliegue. Es distinto de las variables de entorno de bootstrap, que se leen solo al arrancar.          |
| **Transferencia no entregable** | TED entrante que se parseó con éxito pero no se pudo acreditar (por ejemplo, la cuenta del destinatario no se encontró en el CRM). Se persiste en `undeliverable_incoming_transfers` y puede disparar una devolução automática. Es distinta de un fallo de parseo de JD y de la DLQ de webhooks. |
