> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Operando o Lerian SLC > Operando o Lerian SLC: o catálogo de participantes e o teste de conectividade, as janelas da grade horária da Núclea, certificados e custódia ICP-Brasil, endpoints de contingência e recuperação, e conciliação. O Lerian SLC opera sob duas restrições da SLC da Núclea: janelas de liquidação diárias rígidas e credenciais ICP-Brasil regulamentadas. O trilho aplica as janelas, assina por meio de um backend de custódia e oferece aos operadores endpoints para recuperar e conciliar operações. ## Catálogo de participantes *** O Lerian SLC mantém um catálogo dos participantes com os quais o tenant trabalha. O teste de conectividade e a leitura do status operacional retornam `404` para um participante fora do catálogo. O Lerian SLC ignora uma posição de compensação de um participante fora do catálogo. * **Participantes.** `POST /v1/participants` registra um participante. O tipo dele é `ACQUIRER`, `SUBCREDITOR`, `DOMICILE_IF`, `SETTLEMENT_IF` ou `BRAND`. * **Arranjos.** `POST /v1/participants/{id}/arrangements` registra um código de esquema de cartões sob o qual o participante opera. Ele também registra o papel do participante nesse esquema: `ACQUIRER`, `ISSUER`, `BRAND`, `DOMICILE_IF` ou `SETTLEMENT_IF`. Um segundo arranjo com o mesmo código e papel retorna `409`. * **Teste de conectividade.** `POST /v1/participants/{participantIspb}/test-connectivity` envia uma sonda de conectividade à Núclea pelo canal REST. O caminho recebe o ISPB do participante, não o seu ID. A sonda é **AGEN001** para um participante `DOMICILE_IF` e **AGEN999** para os outros tipos. A resposta informa se a Núclea devolveu o eco da sonda intacto, e a latência de ida e volta. ## Janelas de liquidação e grade horária *** A SLC da Núclea liquida em janelas diárias rígidas definidas pela sua grade horária. O Lerian SLC avalia cada janela como **OPEN**, **PRE\_CUTOFF** ou **CLOSED**, e condiciona o envio ao resultado. O trilho retém uma operação **QUEUED** fora da sua janela e a envia quando a janela abre. Isso evita a rejeição da Núclea por estar fora da janela (**ESLC0029**). O Lerian SLC emite `schedule.cutoff_approaching` quando uma janela se aproxima do seu corte, 30 minutos antes por padrão. Use `GET /v1/schedule` para ler as janelas e a janela de envio de crédito que o trilho aplica. * **Enfileiramento e retransmissão.** Uma operação permanece em **CREATED** até que um operador a reenfileire na fila de envio. Uma retransmissão submete de novo uma operação **QUEUED**. O trilho também retém o envio e o encaminhamento de uma operação enquanto o status **PAG0101** mais recente do seu credor for **SUSPENDED** ou **SPECIAL\_REGIME**. Use `GET /v1/participants/{id}/operational-status` para ler esse status e se a retenção se aplica. ## Certificados e custódia *** O Lerian SLC delega a assinatura a um backend de custódia: uma chave de software, um **PKCS#11 HSM** ou o **AWS KMS**. A credencial de assinatura é um certificado **ICP-Brasil** com uma chave RSA de pelo menos 2048 bits. * **Deploys SaaS** travam a custódia no AWS KMS. O trilho importa o material de chave encapsulado do cliente e nunca recebe a chave privada de assinatura em texto claro. * **Validade.** O Lerian SLC se recusa a assinar com um certificado fora da sua janela de validade. * **Rotação.** O Lerian SLC lê o certificado de assinatura ativo em cada assinatura, então uma rotação tem efeito na próxima. O certificado de cliente mTLS é carregado na inicialização, então sua rotação exige uma reinicialização. * **Alertas de vencimento** escalam em 30, 15, 7 e 1 dia antes do vencimento, como eventos `certificate.expiring`, quando `SCHEDULE_CERT_EXPIRY_ENABLED` é `true`. ## Contingência e recuperação *** * **Filas de dead-letter.** O trilho coloca em espera uma mensagem de entrada da RSFN ou do Lerian SILOC que não consegue processar. Uma mensagem em espera permanece na fila por 30 dias. `GET /admin/dlq/{queue}` lista as mensagens em espera, e uma reexecução reprocessa uma delas. A reexecução de uma mensagem já processada não altera nada. * **Drenagens de recuperação.** Os endpoints de envio, encaminhamento, nova consulta, repasse de status e reprocessamento reexecutam o próprio trabalho de saída e de retorno do trilho sem esperar a próxima execução do agendador. * **Nova tentativa.** Uma nova tentativa submete de novo uma operação **REJECTED** como uma nova operação vinculada à original. Uma operação que a IF Domicílio recusou em D+1, depois de liquidada, não aceita nova tentativa. * **Operações em espera.** Quando recusas consecutivas da contraparte esgotam o orçamento de tentativas de transmissão de uma operação de saída, o trilho coloca a operação em espera e emite um alerta em vez de tentar novamente para sempre. O endpoint de retomada a devolve ao backlog elegível, para que a próxima execução do agendador a reprocesse. Ele reinicia o contador de tentativas, então uma operação recuperada recebe um orçamento completo. Sem uma correção para a causa, ela volta a ficar em espera depois que esse orçamento se esgota. * **Repasses de cancelamento.** Quando o trilho não consegue determinar se um repasse de cancelamento à credenciadora chegou à Núclea, ele mantém o repasse bloqueado. Depois que você estabelece o resultado, o endpoint de resolução o registra: `CONFIRMED` mantém o repasse bloqueado, e `ABANDONED` permite repassá-lo de novo. * **Depósitos com falha.** `GET /v1/funding/acks?result=FAILED` lista os depósitos cuja falha a instituição informou. ## Conciliação *** * **Por operação.** O trilho rastreia cada operação pelo seu NUliquid. Uma consulta por NUliquid lê o registro local. Se esse registro não existe, a consulta pergunta à Núclea. Isso exige o ISPB do participante e um NUliquid com no máximo 30 dias. * **Com a Núclea.** O endpoint de conciliação pede à Núclea o status de liquidação de uma operação (**SLC0908**) e registra a resposta. Ele move uma operação apenas de **FORWARDED** para **CONFIRMED**, e exige um motivo. * **Por ciclo de compensação.** O trilho rastreia a posição de compensação por ciclo e informa uma divergência bilateral. Ele sinaliza uma confirmação D+1 que também informa uma divergência no valor liquidado. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.