Configurar la transferencia automática 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). Declara la política de transferencia automática del STR por clase de cuenta (la plataforma emite el código de red LPI0005): para CADA clase (RB/CL y CCME) establece exactamente UNO de ; un valor de ‘0’/‘0.00’ desactiva la transferencia automática para esa clase. ‘Gana el último mensaje’: una nueva configuración reemplaza por completo la anterior. Persiste la última trama de configuración enviada y devuelve el código de red derivado, el estado de envío y el NUOp. Esto significa que el despacho fue aceptado, no una confirmación de BACEN; el STR reconoce de forma asíncrona (LPI0005R1) y más tarde reporta cada transferencia automática que realiza (LPI0006). Lerian SPB reenvía los valores de configuración de forma literal; NO realiza ninguna aritmética. 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
CCME class: percentage of the CCME balance to auto-transfer. Set exactly one of ccmePercent or ccmeValue. '0' disables auto-transfer for this class.
"25"
CCME class: fixed decimal-reais amount to auto-transfer. Set exactly one of ccmePercent or ccmeValue. '0.00' disables auto-transfer for this class.
"300.00"
RB/CL class: percentage of the reserve/settlement balance to auto-transfer. Set exactly one of rbClPercent or rbClValue. '0' disables auto-transfer for this class.
"50"
RB/CL class: fixed decimal-reais amount to auto-transfer. Set exactly one of rbClPercent or rbClValue. '0.00' disables auto-transfer for this class.
"1500.25"
Respuesta
Accepted
Submit status: dispatch was accepted (the STR ACK arrives asynchronously as LPI0005R1).
"SUBMITTED"
LPI wire code of the auto-transfer config-set (always LPI0005).
"LPI0005"
SFN operation number stamped on the transmitted LPI0005 frame; the LPI0005R1 ACK correlates back to it.
"12345678202606190000005"

