Crear transferencia de liquidez de la Conta-PI
Prerrequisito: el rail debe estar listo antes de un envío: un certificado activo (ver rotateCertificate, activateCertificate), un reporte de disponibilidad READY (ver getReadiness) y una prueba de conectividad aprobada (ver createConnectivityTest). Acepta una transferencia de liquidez LPI de la Conta-PI a través de la API centrada en operaciones: la dirección aporte fondea la Conta PI de la IF desde su RB/CL (la plataforma DERIVA el código de red LPI0001), resgate retira fondos (LPI0003); la plataforma nunca compone el código de red. Persiste una proyección de transferencia de liquidez PENDING y devuelve el id de operación, el estado PENDING y el código de red derivado. Esto significa que el despacho fue aceptado, no una confirmación de liquidación de BACEN; la liquidación llega de forma asíncrona en la R-leg de entrada del STR y se lee mediante getLiquidityTransfer. Un aporte fuera de ventana se rechaza (RLPI0007). Lerian SPB EMITE el hecho de movimiento y proyecta el saldo de la Conta-PI de forma literal; nunca calcula una posición. Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Bearer JWT token.
Idempotency key (canonical; legacy alias X-Idempotency-Key).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Cuerpo
Movement amount as a decimal-reais string, forwarded verbatim into the LPI submit — Lerian SPB performs NO arithmetic on it.
^[0-9]+(\.[0-9]+)?$"1500.25"
Operator-facing movement direction: aporte funds the FI's Conta PI; resgate recalls funds from Conta PI.
"aporte"
Counterparty account type. RB_CL = Reservas Bancárias / Conta de Liquidação ((aporte,RB_CL)->LPI0001, (resgate,RB_CL)->LPI0003); CCME = Conta Correspondente a Moeda Eletrônica, own-account only ((aporte,CCME)->LPI0002, (resgate,CCME)->LPI0004). Empty defaults to RB_CL.
"RB_CL"
Optional Conta-PI owner ISPB (8 digits). Empty means the FI's OWN Conta PI (own-account path); a value differing from the issuer ISPB is the liquidante-funded path (RB_CL only). For CCME it must be empty or equal the issuer ISPB — CCME is own-account only.
^[0-9]{8}$38166
Respuesta
Accepted
Server-assigned operation UUID to poll on GET /v1/str/operations/liquidity-transfers/{operationId}.
"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"
Projection lifecycle status; PENDING on accept (awaiting the STR R-leg settlement confirmation).
"PENDING"
LPI wire code derived server-side from (direction, accountType): (aporte,RB_CL)=LPI0001, (aporte,CCME)=LPI0002, (resgate,RB_CL)=LPI0003, (resgate,CCME)=LPI0004.
"LPI0001"

