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