{"id":2116,"date":"2026-03-20T05:10:26","date_gmt":"2026-03-20T05:10:26","guid":{"rendered":"https:\/\/pulse.celcoin.com.br\/documentacao-api-emprestimo-consignado-privado\/"},"modified":"2026-04-04T09:01:39","modified_gmt":"2026-04-04T09:01:39","slug":"documentacao-api-emprestimo-consignado-privado","status":"publish","type":"post","link":"https:\/\/celcoin.com.br\/articles\/documentacao-api-emprestimo-consignado-privado\/","title":{"rendered":"Guia: documenta\u00e7\u00e3o para API de empr\u00e9stimo consignado privado"},"content":{"rendered":"

Principais li\u00e7\u00f5es deste artigo<\/h2>\n
    \n
  1. <\/span>A documenta\u00e7\u00e3o governamental para empr\u00e9stimo consignado privado est\u00e1 fragmentada em PDFs distribu\u00eddos entre MTE, Dataprev e eSocial, o que dificulta a automa\u00e7\u00e3o sem uma solu\u00e7\u00e3o full stack.<\/li>\n
  2. <\/span>A autentica\u00e7\u00e3o exige certificado digital A1, configura\u00e7\u00e3o JWT\/OAuth e registro DET no Banco Central, e erros como 401 e 403 costumam ser evitados com valida\u00e7\u00e3o pr\u00e9via de credenciais e permiss\u00f5es.<\/li>\n
  3. <\/span>Os endpoints principais incluem POST \/lotes\/recebimento e eventos S-2299 para descontos, com regras de 2026 que limitam a margem a 35% do sal\u00e1rio mais 10% adicional de FGTS e definem car\u00eancia obrigat\u00f3ria de 60 dias.<\/li>\n
  4. <\/span>A integra\u00e7\u00e3o com Celcoin simplifica o processo com SDKs, sandbox e APIs modulares, o que permite lan\u00e7amento r\u00e1pido e escalabilidade de opera\u00e7\u00f5es at\u00e9 R$ 30 bilh\u00f5es por m\u00eas sem lidar diretamente com toda a complexidade governamental.<\/li>\n
  5. <\/span>A Celcoin oferece infraestrutura completa white label com compliance, preven\u00e7\u00e3o a fraude e ecossistema de parceiros, e voc\u00ea pode acessar o sandbox gratuito.<\/a><\/li>\n<\/ol>\n

    Finalidade e integra\u00e7\u00e3o com eSocial para consignado privado<\/h2>\n

    O empr\u00e9stimo consignado privado opera por meio de especifica\u00e7\u00f5es governamentais definidas pelo MTE<\/a> e pelo Dataprev e eSocial<\/a>. Essas especifica\u00e7\u00f5es determinam o uso do evento S-1200 para folha de pagamento e do evento S-2299 para descontos consignados.<\/p>\n

    As regras de 2026 estabelecem limite de comprometimento de at\u00e9 35% do sal\u00e1rio na contrata\u00e7\u00e3o, mais 10% adicional para FGTS pela rubrica 9253<\/a>, com car\u00eancia obrigat\u00f3ria de 60 dias para in\u00edcio do desconto das parcelas.<\/p>\n

    A diferencia\u00e7\u00e3o entre empr\u00e9stimo consignado privado para trabalhadores CLT e consignado p\u00fablico para benefici\u00e1rios do INSS est\u00e1 na autonomia dos conv\u00eanios empresariais e na defini\u00e7\u00e3o da margem consign\u00e1vel. Para trabalhadores CLT, a libera\u00e7\u00e3o considera o perfil financeiro do CPF e a situa\u00e7\u00e3o da empresa empregadora<\/a>. Essa combina\u00e7\u00e3o permite taxas a partir de 1,99% ao m\u00eas com desconto direto em folha.<\/p>\n

    A tabela abaixo apresenta as principais rubricas usadas no consignado privado, com seus limites regulat\u00f3rios para 2026 e a rela\u00e7\u00e3o com os eventos do eSocial.<\/p>\n

    \n\n\n\n\n\n<\/colgroup>\n\n\n\n\n\n
    \n

    Rubrica<\/p>\n<\/td>\n

    		\n

    Descri\u00e7\u00e3o<\/p>\n<\/td>\n

    		\n

    Limite em 2026<\/p>\n<\/td>\n

    		\n

    C\u00f3digo eSocial<\/p>\n<\/td>\n<\/tr>\n

    \n

    9253<\/p>\n<\/td>\n

    		\n

    FGTS consignado<\/p>\n<\/td>\n

    		\n

    10% adicional<\/p>\n<\/td>\n

    		\n

    S-2299<\/p>\n<\/td>\n<\/tr>\n

    \n

    Sal\u00e1rio base<\/p>\n<\/td>\n

    		\n

    Margem principal<\/p>\n<\/td>\n

    		\n

    35% m\u00e1ximo<\/p>\n<\/td>\n

    		\n

    S-1200<\/p>\n<\/td>\n<\/tr>\n

    \n

    Conv\u00eanio CLT<\/p>\n<\/td>\n

    		\n

    Desconto privado<\/p>\n<\/td>\n

    		\n

    Flex\u00edvel<\/p>\n<\/td>\n

    		\n

    S-2299<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

    <\/p>\n

    O fluxo de alto n\u00edvel segue esta sequ\u00eancia: origina\u00e7\u00e3o via API, valida\u00e7\u00e3o de margem, formaliza\u00e7\u00e3o da CCB, envio ao eSocial e desconto autom\u00e1tico em folha.<\/p>\n

    Autentica\u00e7\u00e3o e certificados na API consignado<\/h2>\n

    A autentica\u00e7\u00e3o para APIs de consignado privado segue padr\u00f5es governamentais rigorosos que garantem a seguran\u00e7a das transa\u00e7\u00f5es. Esse processo cria a identidade digital da institui\u00e7\u00e3o e habilita o acesso aos sistemas oficiais.<\/p>\n

    O processo envolve tr\u00eas etapas obrigat\u00f3rias que se complementam:<\/p>\n

      \n
    1. <\/span>Gerar certificado digital A1<\/strong>, obtido junto a uma autoridade certificadora credenciada, para identificar a institui\u00e7\u00e3o perante os sistemas governamentais.<\/li>\n
    2. <\/span>Configurar autentica\u00e7\u00e3o JWT\/OAuth com a RSFN<\/strong> (Rede do Sistema Financeiro Nacional), o que estabelece o canal seguro de comunica\u00e7\u00e3o para as chamadas de API.<\/li>\n
    3. <\/span>Registrar as chaves DET<\/strong> (Declara\u00e7\u00e3o de Empr\u00e9stimos e Financiamentos) no Banco Central, o que autoriza a institui\u00e7\u00e3o a operar consignado privado.<\/li>\n<\/ol>\n

      Ap\u00f3s concluir essas etapas, a institui\u00e7\u00e3o pode realizar chamadas autenticadas. Veja um exemplo de autentica\u00e7\u00e3o com curl:<\/p>\n

      curl -X POST https:\/\/api.gov.br\/auth\/token \\ -H “Content-Type: application\/json” \\ -d ‘{ “certificate”: “base64_cert_a1”, “private_key”: “base64_private_key”, “scope”: “consignado_privado” }’<\/p>\n

      Alguns erros de autentica\u00e7\u00e3o s\u00e3o recorrentes. A tabela a seguir resume os c\u00f3digos mais comuns e as a\u00e7\u00f5es recomendadas.<\/p>\n

      \n\n\n\n\n<\/colgroup>\n\n\n\n\n\n
      \n

      C\u00f3digo de erro<\/p>\n<\/td>\n

      		\n

      Descri\u00e7\u00e3o<\/p>\n<\/td>\n

      		\n

      Solu\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n

      \n

      401<\/p>\n<\/td>\n

      		\n

      Unauthorized<\/p>\n<\/td>\n

      		\n

      Verificar a validade do certificado A1<\/p>\n<\/td>\n<\/tr>\n

      \n

      403<\/p>\n<\/td>\n

      		\n

      Forbidden<\/p>\n<\/td>\n

      		\n

      Confirmar as permiss\u00f5es DET no Banco Central<\/p>\n<\/td>\n<\/tr>\n

      \n

      422<\/p>\n<\/td>\n

      		\n

      Invalid certificate<\/p>\n<\/td>\n

      		\n

      Renovar o certificado digital<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

      Endpoints principais da API para contratos e lotes<\/h2>\n

      Com a autentica\u00e7\u00e3o configurada corretamente, a institui\u00e7\u00e3o pode acessar os endpoints governamentais para processar contratos de consignado privado. A integra\u00e7\u00e3o exige uma sequ\u00eancia espec\u00edfica de chamadas para manter a conformidade regulat\u00f3ria e garantir o processamento correto dos lotes.<\/p>\n

      Os passos principais de integra\u00e7\u00e3o s\u00e3o:<\/p>\n

        \n
      1. <\/span>POST \/lotes\/recebimento<\/strong>, para enviar o lote de contratos consignados que ser\u00e1 processado pelos sistemas governamentais.<\/li>\n
      2. <\/span>GET \/consultas\/lotes<\/strong>, para consultar o status de processamento de cada lote enviado e tratar retornos de erro ou pend\u00eancias.<\/li>\n
      3. <\/span>POST \/contratos\/consignado<\/strong>, para formalizar contratos individuais ap\u00f3s a valida\u00e7\u00e3o de margem e de dados trabalhistas.<\/li>\n<\/ol>\n

        O exemplo abaixo mostra um payload JSON t\u00edpico para envio de um lote.<\/p>\n

        curl -X POST https:\/\/api.empregabrasil.gov.br\/lotes\/recebimento \\ -H “Authorization: Bearer jwt_token” \\ -H “Content-Type: application\/json” \\ -d ‘{ “lote_id”: “LOTE_2026_001”, “contratos”: [ { “cpf_trabalhador”: “12345678901”, “cnpj_empregador”: “12345678000199”, “valor_emprestimo”: 5000.00, “margem_consignavel”: 0.35, “prazo_meses”: 24, “taxa_juros”: 0.0199 } ] }’<\/p>\n

        Esse payload inicia o fluxo completo de processamento, que segue esta ordem: origina\u00e7\u00e3o de dados, valida\u00e7\u00e3o de margem, gera\u00e7\u00e3o da CCB, envio ao eSocial com evento S-2299, confirma\u00e7\u00e3o DET e desconto autom\u00e1tico em folha. Cada etapa depende da anterior, e falhas em qualquer ponto interrompem o processo at\u00e9 corre\u00e7\u00e3o.<\/p>\n

        Elimine a complexidade de m\u00faltiplas integra\u00e7\u00f5es governamentais com a infraestrutura completa da Celcoin.<\/a><\/p>\n

        Regras de neg\u00f3cio e valida\u00e7\u00f5es para empr\u00e9stimo consignado privado<\/h2>\n

        As atualiza\u00e7\u00f5es de 2026 introduzem importa\u00e7\u00e3o autom\u00e1tica de dados trabalhistas e consultas ao programa “cr\u00e9dito do trabalhador” por meio de webhooks DET. Essas mudan\u00e7as operacionais v\u00eam acompanhadas de novos requisitos regulat\u00f3rios.<\/p>\n

        A Resolu\u00e7\u00e3o BCB n\u00ba 494 de setembro de 2025 passou a exigir autoriza\u00e7\u00e3o pr\u00e9via para institui\u00e7\u00f5es de pagamento operarem nessa modalidade<\/a>, com prazo para solicita\u00e7\u00e3o que se encerra em maio de 2026, o que torna a adequa\u00e7\u00e3o urgente.<\/p>\n

        As regras de margem e de transpar\u00eancia definem o que cada opera\u00e7\u00e3o precisa validar. As margens m\u00e1ximas de 35% do sal\u00e1rio base mais 10% adicional de FGTS, detalhadas na se\u00e7\u00e3o anterior, devem ser verificadas em cada proposta. A exig\u00eancia de transpar\u00eancia refor\u00e7ada inclui divulga\u00e7\u00e3o clara do custo total do cr\u00e9dito e impede aumentos unilaterais de limites<\/a>.<\/p>\n

        A tabela a seguir resume valida\u00e7\u00f5es comuns, as regras de 2026 associadas e os erros recorrentes em integra\u00e7\u00f5es.<\/p>\n

        \n\n\n\n\n\n<\/colgroup>\n\n\n\n\n\n
        \n

        Valida\u00e7\u00e3o<\/p>\n<\/td>\n

        		\n

        Regra em 2026<\/p>\n<\/td>\n

        		\n

        Erro comum<\/p>\n<\/td>\n

        		\n

        Resolu\u00e7\u00e3o de erros<\/p>\n<\/td>\n<\/tr>\n

        \n

        Margem salarial<\/p>\n<\/td>\n

        		\n

        M\u00e1ximo de 35% (conforme regras 2026)<\/p>\n<\/td>\n

        		\n

        Diverg\u00eancia Dataprev<\/p>\n<\/td>\n

        		\n

        Consultar folha de pagamento atualizada<\/p>\n<\/td>\n<\/tr>\n

        \n

        FGTS adicional<\/p>\n<\/td>\n

        		\n

        10% extra pela rubrica 9253<\/p>\n<\/td>\n

        		\n

        Rubrica incorreta<\/p>\n<\/td>\n

        		\n

        Usar o c\u00f3digo 9253<\/p>\n<\/td>\n<\/tr>\n

        \n

        Car\u00eancia<\/p>\n<\/td>\n

        		\n

        Conforme regra (60 dias)<\/p>\n<\/td>\n

        		\n

        Desconto antecipado<\/p>\n<\/td>\n

        		\n

        Ajustar a data de in\u00edcio do desconto<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

        Integra\u00e7\u00e3o pr\u00e1tica com APIs Celcoin para consignado privado<\/h2>\n

        As regras e valida\u00e7\u00f5es descritas exigem integra\u00e7\u00e3o com v\u00e1rios sistemas governamentais, o que aumenta a complexidade t\u00e9cnica e o risco de erros. A solu\u00e7\u00e3o de cr\u00e9dito da Celcoin reduz essa complexidade ao concentrar essas integra\u00e7\u00f5es em uma \u00fanica API e em um fluxo padronizado.<\/p>\n

        Um passo a passo t\u00edpico de implementa\u00e7\u00e3o com a solu\u00e7\u00e3o de cr\u00e9dito da Celcoin inclui:<\/p>\n

          \n
        1. <\/span>Registrar-se no sandbox da Celcoin<\/strong>, para configurar o ambiente de testes e validar o fluxo de ponta a ponta sem impacto em produ\u00e7\u00e3o.<\/li>\n
        2. <\/span>Emitir CCBs pelas APIs da Celcoin<\/strong>, utilizando os endpoints de cr\u00e9dito consignado privado para formalizar contratos.<\/li>\n
        3. <\/span>Integrar com eSocial e DET<\/strong> por meio da infraestrutura da Celcoin, que j\u00e1 encapsula as chamadas governamentais necess\u00e1rias.<\/li>\n
        4. <\/span>Gerenciar a carteira completa<\/strong> pelo painel unificado, com vis\u00e3o de contratos, liquida\u00e7\u00f5es, inadimpl\u00eancia e concilia\u00e7\u00f5es.<\/li>\n<\/ol>\n

          Veja um exemplo em Node.js para integra\u00e7\u00e3o com a solu\u00e7\u00e3o de cr\u00e9dito da Celcoin:<\/p>\n

          const celcoin = require(‘@celcoin\/sdk’); const client = new celcoin.CreditClient({ apiKey: ‘seu_api_key’, environment: ‘sandbox’ }); const contratoConsignado = await client.consignado.create({ cpf: ‘12345678901’, cnpj_empregador: ‘12345678000199’, valor: 5000.00, prazo: 24, modalidade: ‘consignado_privado’ }); console.log(‘Contrato criado:’, contratoConsignado.id);<\/p>\n

          A solu\u00e7\u00e3o de cr\u00e9dito da Celcoin mant\u00e9m neutralidade em rela\u00e7\u00e3o a SCDs e IPs, oferece parcerias com m\u00faltiplos conv\u00eanios e reduz a depend\u00eancia de solu\u00e7\u00f5es governamentais fragmentadas e de ERPs legados como TOTVS. Essa abordagem permite lan\u00e7amento mais r\u00e1pido, opera\u00e7\u00e3o em modelo white label e capacidade de escalar at\u00e9 R$ 30 bilh\u00f5es mensais, como demonstram os cases de Neon e outras fintechs parceiras.<\/p>\n

          Crit\u00e9rios de sucesso<\/h2>\n

          Uma integra\u00e7\u00e3o bem-sucedida atinge implementa\u00e7\u00e3o completa em menos de uma semana, sem erros de compliance regulat\u00f3rio e com 100% de automa\u00e7\u00e3o no processamento de lotes. Com a infraestrutura da Celcoin, empresas conseguem atingir a escala mencionada anteriormente, seguindo o exemplo de cases como Z\u00e9 Pagou e Neon.<\/p>\n

          Pr\u00f3ximos passos<\/h2>\n

          O pr\u00f3ximo est\u00e1gio de maturidade inclui integra\u00e7\u00f5es avan\u00e7adas com APIs Dataprev para uso de scores alternativos e com Open Finance para personaliza\u00e7\u00e3o de ofertas de cr\u00e9dito. Comece a testar no sandbox da Celcoin hoje mesmo e acelere seu lan\u00e7amento.<\/a><\/p>\n

          Perguntas frequentes<\/h2>\n

          Quais s\u00e3o as novas regras do consignado privado em 2026?<\/h3>\n

          As principais mudan\u00e7as incluem margem consign\u00e1vel de at\u00e9 35% do sal\u00e1rio base, mais 10% adicional para FGTS por meio da rubrica 9253, car\u00eancia obrigat\u00f3ria de 60 dias para in\u00edcio dos descontos e maior transpar\u00eancia nos custos totais do cr\u00e9dito. A Resolu\u00e7\u00e3o BCB n\u00ba 494 tamb\u00e9m passou a exigir autoriza\u00e7\u00e3o pr\u00e9via para institui\u00e7\u00f5es de pagamento operarem nessa modalidade.<\/p>\n

          Quais s\u00e3o os endpoints essenciais da API eSocial para consignado?<\/h3>\n

          Os endpoints principais s\u00e3o POST \/lotes\/recebimento para envio de contratos em lote, GET \/consultas\/lotes para verifica\u00e7\u00e3o de status de processamento e POST \/contratos\/consignado para formaliza\u00e7\u00e3o individual. Os eventos relevantes do eSocial s\u00e3o S-1200 para folha de pagamento e S-2299 para descontos consignados, integrados por meio de webhooks DET.<\/p>\n

          Como integrar com as APIs da Celcoin para consignado privado?<\/h3>\n

          A integra\u00e7\u00e3o envolve registro no sandbox, configura\u00e7\u00e3o de autentica\u00e7\u00e3o por API key, uso das APIs da Celcoin para emiss\u00e3o de CCBs em cr\u00e9dito consignado privado e integra\u00e7\u00e3o com eSocial pela infraestrutura full stack. A Celcoin disponibiliza documenta\u00e7\u00e3o completa, SDKs e suporte especializado para desenvolvedores.<\/p>\n

          Quais s\u00e3o os erros mais comuns nas APIs de lotes consignados?<\/h3>\n

          Os erros frequentes incluem c\u00f3digo 401 por certificados A1 inv\u00e1lidos, c\u00f3digo 403 por aus\u00eancia de permiss\u00f5es DET no Banco Central, c\u00f3digo 422 por certificados digitais expirados e diverg\u00eancias com dados Dataprev por folhas de pagamento desatualizadas. A solu\u00e7\u00e3o envolve valida\u00e7\u00e3o pr\u00e9via de certificados e sincroniza\u00e7\u00e3o regular com as bases governamentais.<\/p>\n

          A Celcoin mant\u00e9m neutralidade em rela\u00e7\u00e3o a gestoras de fundos?<\/h3>\n

          A Celcoin mant\u00e9m princ\u00edpio de neutralidade total e n\u00e3o favorece gestoras espec\u00edficas nem compete com parceiros. A plataforma conecta originadores e investidores de forma imparcial, oferece condi\u00e7\u00f5es de mercado equilibradas para todas as partes e incentiva concorr\u00eancia saud\u00e1vel no ecossistema de cr\u00e9dito privado.<\/p>\n","protected":false},"excerpt":{"rendered":"

          Guia completo da documenta\u00e7\u00e3o API para contratos de empr\u00e9stimo consignado privado. Integra\u00e7\u00e3o simplificada com Celcoin. Saiba mais!<\/p>\n","protected":false},"author":34,"featured_media":2107,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2116","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts\/2116","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/users\/34"}],"replies":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/comments?post=2116"}],"version-history":[{"count":1,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts\/2116\/revisions"}],"predecessor-version":[{"id":2637,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts\/2116\/revisions\/2637"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/media\/2107"}],"wp:attachment":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/media?parent=2116"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/categories?post=2116"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/tags?post=2116"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}