Consignado Crédito Trabalhador

Este módulo tem como objetivo auxiliar no entendimento da integração para utilização do produto.

Trata-se de uma modalidade de empréstimo consignado privado, destinado a trabalhadores com vínculo formal em carteira. O crédito é descontado diretamente em folha de pagamento, por meio de um sistema digital e padronizado, simplificando o processo.

Voltado para trabalhadores do Regime Geral da Previdência Social (RGPS), o produto automatiza o cálculo da margem consignável e permite que as instituições financeiras ofereçam crédito de forma segura, transparente e integrada aos sistemas governamentais.


🔄 Etapas do Processo

  • Solicitação de Propostas: O tomador solicita as propostas de crédito através da CTPS digital.
  • Leilão de Propostas: O sistema realiza o leilão das propostas enviadas pelos originadores.
  • Complementação do Cadastro: O tomador preenche as informações faltantes no cadastro.
  • Emissão da CCB: O Contrato de Crédito Bancário (CCB) é gerado.
  • Averbação: O crédito é averbado no sistema de crédito do trabalhador.
  • Assinatura da CCB: O tomador assina digitalmente o contrato.
  • Desembolso: O valor acordo do empréstimo é enviado para o tomador.



🔍 Consulta de Margem

Antes de qualquer operação de crédito, é necessário consultar a margem consignável, ou seja, o valor máximo disponível para descontos mensais do servidor.

Requisito para consulta:
CPF do tomador de crédito (Exemplo: 123.456.789-11)


Endpoint

https://openfinance.api.celcoin.com.br/originator/guarantee/get-balance


Exemplo Request

curl --location '{{api_host}}/banking/originator/guarantee/get-balance?document=20477553877' \
--header 'Authorization: Bearer {{originator_access_token}}' \
--data ''

Respostas esperadas da consulta de margem


|👤 Dados do servidor

Nome: LUCIANO DOS SANTOS AGGUM CAPETTINI

Matrícula SIAPE: 2730365

CPF (document): 8563053752


| 🏢 Dados do Órgão

Nome: UNIVERSIDADE FEDERAL DE MINAS GERAIS

CNPJ: 17217985000104

Código do Órgão: 0

UF: MG

Código da Unidade Pagadora: 26238000000083


💳 Produtos Disponíveis

Tipo de produto: Cartão Benefício (CARD_BENEFICIARY)

Rubrica: 35044 - AMORT CARTAO CREDITO - CELCOIN

Saldo de margem disponível: R$ 125,34

Autorizado para desconto: Sim

Validade da autorização: até 23/04/2025

ID de verificação de margem: 346547d3-5467-4b82-a69d-877e8dfbf5b1

Código do convênio: 703742


⚙️ Configurações do Crédito

Taxa de juros máxima permitida: 1.8% ao mês

Quantidade máxima de parcelas: 96



📊 Simulação do Crédito

Com a margem validada, é possível simular o crédito para o tomador. A simulação retorna os valores de parcela, taxa, CET e prazo com base nos parâmetros informados.

Parâmetros da simulação:

  • Valor solicitado
  • Prazo (número de parcelas)
  • Taxa de juros
  • Margem disponível

URL

https://developers.celcoin.com.br/reference/post_banking-originator-applications-preview




📝 Contratação do Crédito

Após aceite da simulação, inicia-se a formalização e averbação do contrato com as seguintes etapas:

  • Análise do KYC
  • Geração do contrato (CCB)
  • Assinatura digital do tomador
  • Envio do contrato para averbação via SIAPE (realizado pela Celcoin)
  • Retorno de aceite ou rejeição da averbação

URL

https://developers.celcoin.com.br/reference/post_banking-originator-applications




🔄 Desaverbação

É possível realizar a desaverbação (cancelamento) do crédito consignado caso seja necessário, respeitando as regras e prazos definidos pelos convênios e pelo sistema SIAPE.

📌 Quando a desaverbação pode ser solicitada?

  • Liquidação antecipada
  • Desistência pelo tomador
  • Cancelamento da CCB

URL

https://developers.celcoin.com.br/reference/post_banking-originator-applications-application-id-cancel