Glosario - Lerian

Referencia rápida de términos y siglas utilizados en la documentación del plugin Bank Transfer.

Términos regulatorios y de infraestructura

Término	Definición
ANBIMA	Asociación Brasileña de Mercados Financieros y de Capitales. Fuente upstream de la tabla nacional de feriados bancarios consumida por el refresher de feriados del plugin para poblar el calendario `bacen_holidays`.
BACEN	Banco Central do Brasil — regula el sistema financiero y opera el SPB.
SPB	Sistema de Pagamentos Brasileiro — infraestructura para todas las liquidaciones interbancarias en Brasil.
STR	Sistema de Transferência de Reservas — componente de liquidación en tiempo real del SPB.
RSFN	Rede do Sistema Financeiro Nacional — red segura que conecta al BACEN con las instituciones financieras.
PSTI	Provedor de Serviço de Tecnologia da Informação — proveedor autorizado por el BACEN para operar la infraestructura de conectividad con la RSFN. JD Consultores es un PSTI.
ISPB	Identificador de Sistema de Pagamentos Brasileiro — código de 8 dígitos que identifica a cada institución financiera en el SPB.
STR0008	Formato de mensaje BACEN para iniciar una transferencia TED. Enviado por la institución de origen al SPB.
STR0008R2	Mensaje de respuesta/confirmación del STR0008. Contiene el resultado de la liquidación.
STR0010R2	Formato de mensaje de devolución. Enviado cuando un TED debe ser devuelto al banco de origen (p. ej., destinatario no encontrado).
Devolução / `devolutionCode`	Devolución de un TED. Cuando un TED OUT enviado previamente es devuelto (STR0010R2), el plugin registra una devolución como un TED IN de retorno que lleva el código de motivo de BACEN (`devolutionCode`) y un `originalTransferId` que enlaza de vuelta al TED OUT original. (Un TED entrante que no puede acreditarse se devuelve por separado al banco de origen.)
JD / JD SPB	JD Consultores — el PSTI utilizado por Lerian para enrutar mensajes TED al SPB.
JD parse failure	Mensaje JD entrante que no pudo ser parseado (XML mal formado, tipo de mensaje desconocido, divergencia de schema). Persistido en `jd_incoming_parse_failures` para triaje manual. Distinto de transferencias no entregables y de la DLQ de webhooks.
NumCabSeq	Identificador secuencial asignado por JD SPB a cada envío de STR0008. Se utiliza para rastrear y consultar el estado de la transferencia.
NumCtrlSTR	Número de control de compensación BACEN asignado por STR (Sistema de Transferência de Reservas) cuando un mensaje es aceptado en el flujo de compensación del SPB. Persistido en la transferencia como `clearing_control_number`. Distinto de `NumCabSeq`, que es la secuencia de mensaje asignada por JD en el envío.

Tipos de cuenta (ISO 20022)

Código	Tipo de Cuenta
CACC	Cuenta corriente — tipo más común
CPAY	Cuenta de pago
SLRY	Cuenta salario
SVGS	Cuenta de ahorros

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 automáticamente.
P2P	Transferencia interna — entre dos cuentas de la misma institución (mismo ISPB). Más rápida y generalmente sin tarifa.
D+0	Liquidación el mismo día — el TED es un instrumento D+0 cuando se envía antes de las 17:00, hora de Brasilia.

Términos específicos del plugin

Término	Definición
PaymentInitiation	Entidad creada por `POST /v1/transfers/initiate`. Contiene el cálculo de tarifas y vence a las 24 horas.
initiationId	UUID devuelto por el endpoint de iniciación. Necesario para confirmar una transferencia mediante `POST /v1/transfers/process`.
X-Idempotency	Header obligatorio para reintentos seguros. El plugin guarda en caché la respuesta bajo la clave y la reproduce durante 24 horas. El plugin rechaza una solicitud repetida que reutiliza la clave con un cuerpo distinto (divergencia de fingerprint).
Tarifa cashin	Tarifa deducida del importe recibido en un TED IN. Se configura por organización mediante el Fees Engine.
Tarifa cashout	Tarifa añadida al importe de un TED OUT. La cuenta del remitente es debitada por el importe + tarifa.
Reconciliación	Proceso para identificar transferencias en estado desconocido (PROCESSING sin confirmación) y cotejarlas con los registros de JD SPB.
DLQ	Cola de mensajes muertos de webhooks (dead-letter queue) — las notificaciones de webhook salientes que no pudieron entregarse tras todos los reintentos se mueven aquí para revisión manual.
Signing artifact	Payload canónico de TED OUT congelado durante `POST /v1/transfers/signing/prepare` y persistido en `jd_outbound_signing_artifacts`. Consumido por integraciones externas de HSM/firmador para producir una firma desacoplada sin que el plugin retenga la clave privada.
Systemplane	Plano administrativo de configuración en runtime expuesto vía `/system/:namespace` y `/system/:namespace/:key`. Mantiene ajustes con hot-reload que entran en vigor sin redeploy. Distinto de las variables de entorno de bootstrap, que se leen solo al inicio.
Undeliverable transfer	TED entrante que fue parseado correctamente pero no pudo ser acreditado (p. ej., cuenta del destinatario no encontrada en el CRM). Persistido en `undeliverable_incoming_transfers` y puede disparar una devolución automática. Distinto de un JD parse failure y de la DLQ de webhooks.

Buenas prácticas