Regras de APIs para crédito consignado privado no Brasil

Última atualização: 29 de julho de 2026

Principais lições deste artigo

• A Lei 15.179/2025 centraliza todas as operações de consignado CLT na plataforma Crédito do Trabalhador e exige integração obrigatória com eSocial, DET e Dataprev.

• A autenticação das APIs deve utilizar JWT assinado com certificado ICP-Brasil conforme o perfil Open Finance Brasil.

• A margem consignável é limitada a 35% da remuneração disponível, com averbação automática validada via eSocial e CNIS.

• Lotes de eventos S-1010 devem seguir schemas XML específicos e ser enviados via webservice do eSocial, com o protocolo armazenado para consulta posterior.

• A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes. Saiba mais.

1. Contexto: o mercado de consignado CLT após a Lei 15.179/2025

O crédito consignado privado passou por uma mudança estrutural com a publicação da Lei 15.179/2025 e da Portaria MTE nº 435/2025, que instituíram o programa Crédito do Trabalhador. O modelo anterior, baseado em convênios bilaterais entre empregadores e instituições financeiras, foi substituído por uma plataforma centralizada administrada pela Dataprev. Todas as operações de consignado CLT, novas e em andamento, passaram a ser gerenciadas por esse ecossistema digital.

Instituições financeiras passaram a competir para oferecer condições a dezenas de milhões de trabalhadores formais do setor privado, com acesso a dados do eSocial e da CTPS Digital. Fintechs, ERPs e originadores que não adaptarem suas integrações ao novo modelo deixam de acessar esse mercado.

2. Conceitos fundamentais

O ecossistema do consignado privado em 2026 opera sobre uma cadeia de dependências técnicas. A Lei 15.179/2025 criou o programa Crédito do Trabalhador e transferiu a administração do consignado privado para a Dataprev, eliminando convênios individuais entre empregadores e bancos. A plataforma Crédito do Trabalhador concentra a averbação, a consulta de margem e o controle dos contratos de consignado CLT.

Essa plataforma depende de dados enviados ao eSocial, que recebe lotes de eventos trabalhistas via webservice para registrar rubricas, vínculos empregatícios e descontos de folha. A comunicação com empregadores ocorre pelo DET (Domicílio Eletrônico Trabalhista), que envia notificações sobre novos contratos e orienta o acesso ao Portal Emprega Brasil para download de arquivos de empréstimos.

A Dataprev processa de forma centralizada os dados previdenciários e trabalhistas e opera a plataforma Crédito do Trabalhador. A averbação registra formalmente o contrato na plataforma e define a competência da primeira parcela conforme a regra do dia 21 prevista na Portaria MTE nº 435/2025, art. 24. A margem de 35% limita o valor da parcela consignada sobre a remuneração bruta sujeita à contribuição previdenciária, já descontados INSS, IRRF e outros descontos obrigatórios.

3. Fluxo end-to-end: da originação à cobrança

O fluxo completo de uma operação de consignado privado conforme as regras de 2026 segue as etapas abaixo.

1. Originação: o trabalhador solicita o crédito pela interface da instituição financeira ou de um correspondente bancário. O sistema consulta a margem disponível na plataforma Crédito do Trabalhador.

2. Consulta de margem: a plataforma valida automaticamente o limite de 35% usando dados do eSocial e do CNIS. Múltiplos contratos são permitidos desde que o total não ultrapasse o limite legal.

3. Averbação automática: após aprovação, o contrato é averbado na plataforma. A competência da primeira parcela segue a regra: contratos averbados entre os dias 21 de um mês e 20 do mês seguinte têm o primeiro desconto na folha do mês subsequente.

4. Formalização com CCB: a instituição financeira emite digitalmente a Cédula de Crédito Bancário com licença SCD própria ou por meio de infraestrutura de terceiros.

5. Notificação via DET: entre os dias 21 e 25 de cada mês, o DET envia ao empregador o aviso de novos contratos. Essa notificação dispara o processo de download do arquivo de empréstimos no Portal Emprega Brasil.

6. Envio do lote S-1010 ao eSocial: o empregador registra a rubrica de desconto com natureza 9253. O snippet JSON básico do grupo de desconto segue a estrutura:

{ "S-1010": { "evtTabRubrica": { "ideRubrica": { "codRubr": "CONSIG_PRIV_001", "ideTabRubr": "1", "iniValid": "2026-01" }, "dadosRubrica": { "dscRubr": "Desconto consignado privado - Crédito do Trabalhador", "natRubr": "9253", "tpRubr": "3", "codIncFGTS": "31", "codIncCP": "00", "codIncIRRF": "9", "descFolha": { "vlrTotal": 850.00, "codInstFinanc": "341", "nrContrato": "2026000123456" } } } } }

• Cobrança via FGTS Digital: após o registro bem-sucedido da rubrica no eSocial, o fluxo avança para a etapa final de cobrança. O empregador gera a guia unificada FGTS mais consignado pelo FGTS Digital e efetua o pagamento. A Nota Técnica S-1.3 nº 06/2026 ajustou validações, leiautes e datas de implantação, com implementação escalonada entre fevereiro e abril de 2026.

Automatize esse fluxo completo com a infraestrutura de crédito da Celcoin.

4. Panorama regulatório e ecossistema em 2026

O ecossistema do consignado privado em 2026 envolve agentes específicos e marcos regulatórios que definem responsabilidades técnicas.

• Dataprev: atua como gestora central da plataforma Crédito do Trabalhador e do processamento de dados de margem.

• eSocial: funciona como canal obrigatório para registro de rubricas e envio de lotes de eventos trabalhistas.

• DET: opera como canal de notificação eletrônica aos empregadores, com acesso por estabelecimento. O CNPJ raiz não centraliza as caixas de entrada das filiais.

• Portaria MTE nº 1.115/2026: publicada em 26 de junho de 2026, permite o uso de garantias específicas nas operações, incluindo 35% das verbas rescisórias e até 10% do saldo do FGTS em casos de demissão sem justa causa.

• Open Finance Brasil: supera 154 milhões de consentimentos ativos e picos de até 4 bilhões de chamadas de API semanais em 2025-2026 e viabiliza precificação de crédito consignado com dados verificados de renda e conta.

A implementação das novas regras seguiu cronograma escalonado. Os ambientes de produção restrita e de produção do eSocial receberam as atualizações da Nota Técnica S-1.3 nº 06/2026 entre fevereiro e abril de 2026. As equipes técnicas precisam validar integrações em sandbox antes da migração para produção.

5. Autenticação JWT + ICP-Brasil e boas práticas de integração

A autenticação nas APIs do ecossistema Crédito do Trabalhador segue o perfil de segurança do Open Finance Brasil e exige configurações específicas.

• Algoritmo de assinatura JWS: deve ser compatível com certificados ICP-Brasil conforme o perfil Open Finance Brasil.

• Criptografia JWE: deve usar RSA-OAEP com A256GCM para tokens de id_token criptografados.

• Certificados: devem ser ICP-Brasil, com assinaturas RSA-SHA256 e digests SHA-256. Apenas o titular do certificado ICP-Brasil usado na transmissão pode consultar o resultado do lote enviado.

• kid no header JWT: o kid da chave JWKS deve constar no header do JWT. O uso de x5u, x5c, jku ou jkw é proibido.

• Autenticação de cliente: deve ocorrer exclusivamente via private_key_jwt, com Pushed Authorization Requests obrigatórios.

• Lifetime do access token: deve ficar entre 300 e 900 segundos. Refresh tokens não devem ser rotacionados.

• TLS: deve suportar TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 e TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384. TLS Session Resumption e TLS Renegotiation devem permanecer desabilitados.

O fluxo recomendado de integração com o eSocial segue uma sequência clara: iniciar a conexão, enviar o lote via webservice Envio de Lote de Eventos, armazenar o Protocolo de Envio retornado, aguardar o processamento assíncrono e consultar o resultado via ConsultarLoteEventos. A validação de Nível 1 ocorre na recepção, com checagem de estrutura e certificado, enquanto a validação de Nível 2 ocorre de forma distribuída nas filas de processamento.

6. Erros comuns e pontos de atenção

Integrações com o ecossistema do consignado privado apresentam padrões recorrentes de falha que podem ser evitados com ajustes simples.

• Lote enviado antes da confirmação do anterior: o eSocial não processa lotes de eventos de tabela simultaneamente. O sistema deve aguardar o recibo do lote anterior antes de enviar o próximo.

• Certificado ICP-Brasil divergente: o certificado usado na transmissão deve ser o mesmo associado à inscrição. Qualquer divergência impede a consulta do resultado do lote.

• Margem excedida sem notificação ao trabalhador: quando o desconto ultrapassa 35%, o empregador deve realizar apenas o desconto parcial até o valor disponível e exibir ao trabalhador o texto previsto na Portaria MTE nº 435/2025, art. 30, §1º.

• Uso do grupo {consigFGTS}: esse grupo não se aplica a contratos do programa Crédito do Trabalhador. Todos os valores devem fluir pela integração DET, Portal Emprega Brasil, eSocial e FGTS Digital.

• Reutilização de arquivo de empréstimos de meses anteriores: o arquivo deve ser baixado mensalmente no Portal Emprega Brasil. Dados de competências anteriores não podem ser reaproveitados.

• Acesso centralizado via CNPJ raiz no DET: o DET opera por estabelecimento. Cada filial deve acessar individualmente com conta gov.br nível prata ou ouro, ou via Sistema de Procuração Eletrônica.

• Migração sandbox-produção sem validação de schemas: os schemas XML do ambiente de produção restrita devem ser validados antes da promoção. Diferenças de campos obrigatórios entre ambientes geram rejeição em produção.

7. Adaptações por perfil de empresa

Cada tipo de agente do ecossistema precisa de adaptações técnicas específicas para operar com consignado privado.

• Fintechs de crédito: precisam de licença SCD para emissão de CCB ou de acesso a infraestrutura de terceiros com licença própria. A prioridade técnica é automatizar o fluxo de averbação e gerenciar a margem em tempo real.

• ERPs: devem integrar o módulo de folha de pagamento ao webservice do eSocial para envio automatizado dos lotes S-1010 com a rubrica de natureza 9253 e processar mensalmente os arquivos CSV, XLS ou JSON do Portal Emprega Brasil.

• Originadores e correspondentes bancários: necessitam de APIs de consulta de margem e averbação conectadas à plataforma Crédito do Trabalhador, com controle de elegibilidade baseado em dados do eSocial e do CNIS.

• Gestoras de fundos: demandam infraestrutura neutra para aquisição de carteiras de consignado privado, com rastreabilidade de contratos e integração com sistemas de cessão de recebíveis.

8. A infraestrutura da Celcoin para consignado privado

Para fintechs, ERPs, originadores e correspondentes bancários que precisam entregar integrações conformes com a Lei 15.179/2025 sem construir infraestrutura própria, a solução de crédito da Celcoin cobre toda a jornada. A jornada inclui originação com avaliação de score e simulação de juros, formalização com emissão de CCB via SCD própria e cobrança. A plataforma inclui convênios para crédito consignado público e privado e opera com o princípio de neutralidade em relação às gestoras de fundos parceiras.

A tabela abaixo resume como cada funcionalidade da plataforma se traduz em benefícios operacionais e financeiros para sua empresa.

Funcionalidade da Celcoin	Benefício para sua empresa
APIs modulares	Integrações mais rápidas, com redução de custos e prazos de desenvolvimento.
Experiência e suporte ao desenvolvedor	Documentação, SDKs e sandboxes reduzem ciclos de integração e custos de engenharia.
Capacidade de lançamento rápido	Módulos pré-construídos e entrega via SaaS aceleram lançamentos e melhoram o tempo para geração de receita.
Distribuição white-label e embutida	Suporte a produtos financeiros com marca própria.
Escalabilidade com confiabilidade	Solução com alta disponibilidade e escalável na nuvem mantém serviços funcionando mesmo com altos volumes e protege a receita.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferta de pagamentos e emissão de crédito aumenta conversão, ARPU e fidelização.
Acesso a dados e personalização	Dados e análises via Open Finance permitem ofertas personalizadas e melhoram conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e aceleram ciclos de vendas.
Prevenção de fraude e controles de risco	Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória.
Força do ecossistema de parceiros da Celcoin	Parcerias e integrações com bancos, redes e fintechs ampliam cobertura e velocidade de entrada no mercado.

Veja como a Celcoin acelera sua entrada no mercado de consignado privado.

Conclusão

O crédito consignado privado no Brasil passou por uma reforma estrutural com a Lei 15.179/2025. A operação nesse mercado exige domínio técnico de autenticação via JWT e ICP-Brasil, schemas de lote do eSocial, fluxos de averbação automática e conformidade com a Portaria MTE nº 435/2025 e suas atualizações.

Equipes que estruturarem suas integrações com base neste guia ficam posicionadas para operar com escala e segurança jurídica dentro dos prazos regulatórios. Isso inclui autenticação conforme o perfil Open Finance, envio e consulta de lotes S-1010, controle da margem de 35% e migração de sandbox para produção.

Empresas que adotam infraestrutura especializada reduzem o tempo de desenvolvimento e o risco de não conformidade, e concentram esforços no produto e na experiência do cliente final.

Reduza tempo de desenvolvimento e risco regulatório com a solução de crédito da Celcoin.

FAQ

Como resolver erros de validação de Nível 2 no processamento assíncrono de lotes eSocial?

Erros de Nível 2 indicam problemas de consistência de dados ou de regras de negócio após a aceitação inicial do lote. Os casos mais comuns incluem divergências entre CPF e matrícula no CNIS, rubricas duplicadas para o mesmo período de validade e valores de desconto que excedem a margem calculada. A equipe técnica deve consultar o retorno detalhado via ConsultarLoteEventos usando o protocolo armazenado no envio original e ajustar os campos apontados na mensagem de erro.

Uma boa prática é registrar logs estruturados com o conteúdo do lote, o protocolo de envio e o retorno de Nível 2. Esse registro permite reproduzir o cenário em ambiente de testes, revisar os schemas XML e validar regras de cálculo de margem antes de reenviar o lote corrigido.

O que muda para os empregadores com a Lei 15.179/2025?

A Lei 15.179/2025 eliminou os convênios bilaterais entre empregadores e instituições financeiras. Todas as operações de consignado CLT passaram a ser gerenciadas pela plataforma Crédito do Trabalhador, administrada pela Dataprev. O empregador passou a receber notificações de novos contratos via DET entre os dias 21 e 25 de cada mês, baixar o arquivo de empréstimos no Portal Emprega Brasil e registrar as rubricas de desconto no eSocial via lote S-1010 com natureza 9253.

O acesso ao DET ocorre por estabelecimento. Cada filial deve acessar individualmente com conta gov.br nível prata ou ouro, ou por meio do Sistema de Procuração Eletrônica. O CNPJ raiz não centraliza as caixas de entrada das filiais.

Como é calculada a margem consignável de 35%?

A margem consignável é calculada sobre a remuneração bruta sujeita à contribuição previdenciária, já descontados INSS, IRRF e outros descontos obrigatórios. O limite total de 35% se aplica ao conjunto de contratos ativos do trabalhador, não a cada contrato individualmente. A plataforma Crédito do Trabalhador valida automaticamente esse limite usando dados do eSocial e do CNIS no momento da consulta de margem.

Quando o desconto de um contrato ultrapassa o valor disponível, o empregador deve realizar apenas o desconto parcial até o limite e exibir ao trabalhador o texto previsto na Portaria MTE nº 435/2025, art. 30, §1º.

Como funciona a regra do dia 21 para a competência da primeira parcela?

A Portaria MTE nº 435/2025 define que contratos averbados entre o dia 21 de um mês e o dia 20 do mês seguinte têm o primeiro desconto na folha do mês subsequente ao período de averbação. Por exemplo, um contrato averbado no dia 10 de agosto tem a primeira parcela descontada na folha de agosto. Um contrato averbado no dia 25 de agosto tem a primeira parcela descontada na folha de setembro.

Essa regra impacta diretamente o planejamento de liquidez da instituição financeira e deve ser considerada na modelagem do fluxo de caixa das operações.

O que é o arquivo de empréstimos do Portal Emprega Brasil e como ele deve ser processado?

O arquivo de empréstimos é gerado mensalmente pela plataforma Crédito do Trabalhador e disponibilizado no Portal Emprega Brasil após a notificação via DET. Ele contém os dados dos contratos ativos que devem ser descontados na folha do mês corrente, nos formatos CSV, XLS ou JSON.

O arquivo deve ser baixado mensalmente. Dados de competências anteriores não podem ser reaproveitados. O ERP ou sistema de folha de pagamento deve processar o arquivo e enviar os lotes S-1010 correspondentes ao eSocial com a rubrica de natureza 9253 antes do fechamento da folha.

Quais são os requisitos para uma fintech oferecer crédito consignado privado?

Para emitir a Cédula de Crédito Bancário (CCB) diretamente, a fintech precisa de licença SCD (Sociedade de Crédito Direto) concedida pelo Banco Central. Sem essa licença, a alternativa é acessar infraestrutura de terceiros que possua SCD própria e opere como parceira tecnológica.

Além da licença, a fintech deve integrar suas APIs à plataforma Crédito do Trabalhador para consulta de margem e averbação, implementar autenticação via JWT com certificado ICP-Brasil conforme o perfil Open Finance Brasil e manter controles de KYC e AML compatíveis com as exigências regulatórias.

A Celcoin oferece empréstimos diretamente para trabalhadores?

Não. A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes. Fintechs, ERPs, originadores e correspondentes bancários usam a solução de crédito da Celcoin para construir e operar seus próprios produtos de consignado privado, com cobertura de toda a jornada: originação, formalização com emissão de CCB via SCD própria e cobrança.