Glosario - Lerian

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
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, el 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.
STR0008R1	El resultado de la liquidación de un STR0008 que envió el plugin.
STR0008R2	Una TED entrante. El plugin acredita una TED IN a partir de ella. Otros siete mensajes STR llevan créditos al cliente, cada uno con su propio tipo de transferencia.
STR0010 / STR0010R2	STR0010 devuelve una TED recibida al banco de origen, automáticamente o a tu solicitud. STR0010R2 es un retorno que recibe el plugin: para una TED OUT es una devolución; para una TED IN es un chargeback.
Devolução / `devolutionCode`	Devolución de una TED. Cuando una TED OUT enviada antes se devuelve (STR0010R2), el plugin registra un nuevo reembolso TED IN que lleva el código de motivo de BACEN (`devolutionCode`) y un `originalTransferId` que enlaza con la TED OUT original.
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 el plugin no pudo parsear (XML mal formado o esquema que no coincide). El plugin lo guarda para que un operador lo revise. 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. 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), en la misma organización y el mismo ledger de Midaz. El P2P entre dos ledgers viene desactivado por defecto.
TED entre cores	Transferencia entre dos cuentas del mismo ISPB que tienen dos cores de tu institución. Pasa por el relay de JD Courier, no por el STR. Consulta Transferencias entre cores.
D+0	Liquidación el mismo día. El plugin acepta TED OUT solo dentro de la ventana de operación, de 06:30 a 17:00 hora de Brasília por defecto.

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. Expira después de 24 horas o, en la TED OUT, al cierre de la ventana de operación de ese día.
initiationId	UUID que devuelve el endpoint de inicio. Es obligatorio para confirmar una transferencia mediante `POST /v1/transfers/process`.
X-Idempotency	Header obligatorio en las escrituras de transferencia. El plugin guarda una respuesta exitosa bajo la clave y la reproduce durante 7 días. El plugin rechaza una solicitud repetida que reusa la clave con un cuerpo distinto (`422 BTF-0017`).
Comisión de cashin	Comisión sobre una TED IN recibida. Se configura por organización mediante Fees Engine. Consulta Comisión de recepción.
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 llegan aquí para revisión manual.
Artefacto de firma	Payload canónico de TED OUT que se congela durante `POST /v1/transfers/signing/prepare`. 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 el plugin parseó pero no pudo acreditar. El plugin la devuelve al banco de origen. Cuando no encuentra al destinatario y las devoluciones automáticas están desactivadas, el plugin la retiene para un operador. Es distinta de un fallo de parseo de JD y de la DLQ de webhooks.