Criar transferência de liquidez da Conta-PI
Pré-requisito: o rail deve estar pronto antes de um envio: um certificado ativo (ver rotateCertificate, activateCertificate), um relatório de prontidão READY (ver getReadiness) e um teste de conectividade aprovado (ver createConnectivityTest). Aceita uma transferência de liquidez LPI da Conta-PI através da API centrada em operações: a direção aporte financia a Conta PI da IF a partir de seu RB/CL (a plataforma DERIVA o código de rede LPI0001), resgate recolhe fundos (LPI0003); a plataforma nunca compõe o código de rede. Persiste uma projeção de transferência de liquidez PENDING e retorna o id de operação, o status PENDING e o código de rede derivado. Isso significa que o despacho foi aceito, não uma confirmação de liquidação do BACEN; a liquidação chega de forma assíncrona na R-leg de entrada do STR e é lida via getLiquidityTransfer. Um aporte fora da janela é rejeitado (RLPI0007). O Lerian SPB EMITE o fato de movimento e projeta o saldo da Conta-PI de forma literal; nunca calcula uma posição. Idempotente: reenviar a mesma chave X-Idempotency com o mesmo corpo retorna a resposta em cache.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Bearer JWT token.
Idempotency key (canonical; legacy alias X-Idempotency-Key).
Idempotency key (legacy alias).
Idempotency key TTL in seconds.
Corpo
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
Resposta
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"

