Superfícies de comando e leitura
Use a API HTTP autenticada para comandos e consultas do cliente. A API separa comandos de leituras. Cada operação do cliente exige uma ação de autorização e roda no tenant de quem chama. Siga os requisitos de idempotência da operação. Novas tentativas após timeouts são normais e devem reutilizar a mesma identidade de negócio. Uma operação montada não é prova de que um deployment específico conecta seu adapter Dataprev. Uma integração de trilho indisponível retorna501 Not Implemented para essa requisição, em vez de desaparecer da API. A operação de capacidades informa quais famílias de operação o seu deployment alcança. Registrar o código de instrumento da B3 de um contrato confirmado não chama o Dataprev, por isso não depende de nenhuma chave do trilho.
O stream de comandos do Lender permanece disponível para os comandos de integração aceitos. Ele não substitui a superfície HTTP completa. Veja Eventos do Consignado.
Workers agendados
O gateway executa o trabalho em segundo plano como loops agendados. Eles compartilham execução inicial retardada, escalonamento estável por réplica, isolamento de panic e encerramento gracioso. Todos os loops, exceto a via rápida de leilões, também fazem execuções sem sobreposição com jitter positivo.
A via rápida de leilões, a limpeza de payload de lances e o testemunho de proposta leem sua cadência pelo Systemplane e entram em vigor no próximo intervalo. Os outros loops tomam sua cadência da configuração de ambiente e precisam de uma reinicialização para mudar.
A recuperação de averbação e a recuperação de comandos do trilho existem porque um comando de trilho pode deixar seu desfecho sem estabelecer: o processo morreu no meio da chamada, ou o trilho nunca respondeu. Elas convergem esse estado junto ao próprio registro do trilho, em vez de perdê-lo. A recondução de lances reenvia um lance cuja resposta do trilho se perdeu, com o número de proposta original. Cada reenvio usa o orçamento de trilho do tenant. Os três loops vêm desabilitados por padrão. Habilite os dois loops de recuperação em qualquer deploy que envie averbações ou comandos de trilho.
Quando o Dataprev recusa a documentação, a requisição responde
422 com os códigos do Dataprev em upstream, e o contrato volta para attachment_pending. Envie a documentação corrigida sob uma nova chave X-Idempotency ou exclua o contrato. Quando a chamada termina sem veredito, como um timeout, um 5xx do Dataprev ou um recibo inutilizável, a requisição responde 503 ou 504. O contrato também volta para attachment_pending: envie a mesma documentação de novo, sob a mesma chave ou uma nova. A leitura da averbação mostra em last_documentation_close a tentativa mais recente que o Dataprev não aceitou.
Um anexo de CCB interrompido no meio da chamada permanece em attachment_invoking até o attachment_invocation_deadline_at dele. Depois desse instante, a próxima documentação ou exclusão do contrato assume a chamada. Depois que o gateway registra a documentação de um contrato, a exclusão dele responde 409 EXCLUSION_DOCUMENTATION_UNDERWAY até o contrato ficar confirmed, mesmo enquanto ele mostra attachment_pending. Nesse estado, envie a mesma documentação de novo para concluí-la.
Uma vez por mês, o Dataprev fecha para a virada de competência e recusa requisições. Quatro loops pausam para esse tenant quando um deles encontra essa recusa. São eles a descoberta de leilões, a via rápida de leilões, a descoberta de portabilidade e a recondução de lances. A pausa dura 5 minutos, depois 15, depois 30 a cada nova recusa. A recuperação de averbação, a recuperação de comandos do trilho e a conciliação não aguardam essa pausa. Cada execução delas para de chamar o Dataprev na recusa e tenta de novo na próxima execução.
As requisições do cliente continuam chegando ao Dataprev e recebem a recusa dele. O relatório de jobs agendados mostra paused_until para um loop pausado. Na Lerian Cloud, o gateway publica consignado.rail.paused uma vez por virada e consignado.rail.resumed quando o Dataprev volta a responder.
Janelas do trilho
Os padrões e as restrições do trilho incluem:- uma janela de validade de 24 horas para o leilão de empréstimo, que o Dataprev fornece e o gateway não configura
- um lookback de 72 horas para a solicitação de portabilidade
- 20 dias corridos desde a exclusão de origem para registrar uma portabilidade de entrada, quando a requisição informa a data da exclusão
- 7 dias úteis para reverter um refinanciamento
- 7 dias após uma averbação para enviar sua documentação pelo anexo de CCB. Encontre as averbações que ainda aguardam com
GET /v1/consignado/averbacao-operations?status=attachment_pendinge leiadocumentation_due_atedocumentation_overdueem cada uma. Uma averbação cuja exclusão você pediu também continua emattachment_pending. A documentação dela recebe409 AVERBACAO_EXCLUDED, a menos que o Dataprev tenha rejeitado a exclusão. Antes de enviá-la, consulteGET /v1/consignado/contracts/{numero_contrato}/exclusioncom a credencial do próprio tenant. Uma credencial de fundo ou de originador não pode consultá-lo. - uma janela de 48 horas para a descoberta de leilões, com uma tolerância de clock skew de cinco minutos
Vazão e ritmo
O tráfego do Dataprev tem seu ritmo controlado por tenant. A API de vazão define a taxa do tenant, de 0 a 25 requisições por segundo, e nenhuma configuração eleva esse teto. Um tenant sem taxa armazenada opera a 3 requisições por segundo. Um valor armazenado de0 pausa o tráfego do trilho para esse tenant.
Segurança da conciliação
As leituras de escrituração e de repasse são independentes. Uma fonte com falha não deve suprimir a outra. Repasses esperados podem emitir três estados:consignado.repasse.overdue: a movimentação esperada está atrasadaconsignado.repasse.resolved: a movimentação chegou depois de um alarme de atrasoconsignado.repasse.unobserved: o gateway não consegue, no momento, comprovar presença ou ausência
fresh.
Credenciais e artefatos
Rotacione o certificado do tenant, o segredo OAuth, o código de solicitante e a URL do portal pela API de credenciais. As variáveis de arquivo de certificado local são um fallback de desenvolvimento, não um substituto para a custódia do tenant em deployments gerenciados. Quando o Dataprev recusa as credenciais de cliente OAuth do tenant, as operações que chegam ao Dataprev respondem409 DATAPREV_CREDENTIAL_REJECTED. A averbação e o anexo de CCB respondem esse código antes de reservar qualquer coisa. A exclusão não: ela responde com a operação parada em outcome_unknown. Um comando que responde códigos RAIL_COMMAND_* responde 409 e também fica parado em outcome_unknown. Uma execução de garantia de FGTS e um lance também respondem 409 e ficam parados em unknown.
Corrija as credenciais, e as leituras voltam a funcionar. Envie de novo uma averbação ou um anexo de CCB recusado sob a mesma chave. Para retomar um lance parado, envie-o de novo sob a mesma chave. Qualquer outra escrita parada não roda de novo sob a chave dela: contate a Lerian com o número do contrato. Para um tenant revogado, as operações do trilho e os envios parciais de credenciais respondem 409 DATAPREV_CREDENTIAL_REVOKED. Um envio completo de um novo certificado e de um novo cliente OAuth encerra a revogação.
Registrar uma URL base de portal do trabalhador é opcional, para o tenant e para cada originador. Veja Descubra leilões e envie propostas para a ordem em que o gateway seleciona um portal.
Artefatos de CCB e do trilho usam o armazenamento de objetos configurado. Mantenha o bucket privado e entregue o conteúdo apenas pela operação autenticada de artefatos.
A averbação não carrega nenhum documento, e um corpo de 1 MiB ou mais recebe 413. O anexo de CCB aceita uma CCB assinada e, depois de uma averbação com o bloco de contabilização, um pacote de biometria. O texto em base64 de cada um tem até 8 MiB. Uma importação de contrato que carrega esses documentos segue os mesmos limites. Uma correção de contrato aceita um recurso corrigido cujo texto em base64 tem até 8 MiB.