Oferta, Leilão, Devolutiva & Emissão

Envio da oferta

Cada originador participante do leilão pode enviar sua oferta com as respectivas condições do crédito.

O envio deve ser realizado via:

POST/banking/originator/workers-credit/proposal/{{ id da proposta }}

JSON de Exemplo

{
  "installment_quantity": 10,
  "installment_amount": 200,
  "available_balance": 1200,
  "amount": 1500,
  "iof": 0,
  "annual_tax": 1.2,
  "cet": 1.1,
  "interest_tax": 0.1,
  "monthly_cet": 0.1,
  "insurance_amount": 12,
  "entry_url": "https://example.com/test"
}

Parâmetros

CampoDescriçãoTipo
installment_quantityQuantidade de parcelas da ofertaInteger
installment_amountValor de cada parcelaNumber
available_balanceMargem disponível no momento da propostaNumber
amountValor total a ser liberado para o tomadorNumber
iofValor do IOF incluso na operaçãoNumber
annual_taxTaxa de juros anual (%)Number
cetCusto Efetivo Total anual (%)Number
interest_taxTaxa de juros nominal mensal (%)Number
monthly_cetCusto Efetivo Total mensal (%)Number
insurance_amountValor do seguro financiado incluso na operaçãoNumber
entry_urlURL opcional para redirecionamento do tomadorString
📘

Coleta dos dados do tomador

Ao enviar a oferta, é obrigatório informar uma URL de redirecionamento para o ambiente da instituição financeira escolhida. A cel_credit disponibiliza duas opções:

  1. Formulário do Originador (cliente)
    O originador pode utilizar seu próprio formulário, informando a entry_url no envio da proposta.
    Caso a oferta seja aceita, o tomador será redirecionado automaticamente para essa URL.

Leilão Interno

As ofertas recebidas serão avaliadas pelo sistema cel_credit, que selecionará automaticamente a melhor condição durante o tempo vigente do leilão. A oferta selecionada será encaminhada ao tomador, que poderá escolher a instituição de sua preferência.


Devolutiva do leilão

Após o envio da oferta pelo originador e o encerramento do tempo de leilão, a cel_credit envia uma resposta via Webhook para informar se a oferta foi aprovada, negada ou apresentou erro.

A devolutiva será enviada para o Webhook previamente cadastrado do originador:

POST: {webhook-cadastrado}

JSON de Exemplo

{
  "event": "WorkersCreditAuctionResult",
  "payload": {
    "id": "01d48dd3-0000-0000-eb1b-7e3a4fc63649",
    "status": "ERROR", // ou “APPROVED” ou “DENIED”
    "timestamp": "2025-06-12T15:39:13.251Z",
    "error_message": "Request failed with status code 400"
  }
}

Significado dos Status:

APPROVED: Oferta foi aprovada no leilão interno e foi submetida ao tomador.
DENIED: Oferta não foi selecionada nos parâmetros do leilão.
ERROR: Oferta foi aprovada, mas a Dataprev apresentou erro no envio para o tomador.

Parâmetros

CampoDescriçãoTipo
eventTipo do evento no webhookString
payload.idID da proposta enviadaString
statusResultado da avaliação (APPROVED, DENIED ou ERROR)String
timestampData/hora da finalização da avaliaçãoYYYY-MM-DD
error_messageDetalhe do erro (somente em caso de ERROR)String

Aceite da oferta pelo tomador

Após o envio da oferta vencedora para Dataprev, o tomador tem até 24 horas para realizar o aceite de uma das ofertas disponíveis no app da CTPS Digital.

🚨

Importante:

O aceite da oferta pelo tomador, não garante a emissão da CCB. Para que o empréstimo seja concluído com sucesso, é necessário passar pelas seguintes etapas:

  • KYC (Know Your Customer): Validação da identidade do tomador.
  • Assinatura do Contrato (CCB): Confirmação formal por parte do tomador.
  • Averbação: Confirmação da Dataprev de que a margem foi validada e reservada.
  • Envio do contrato: Confirmação da Dataprev sobre a formalização do contrato.

Emissão da CCB

A etapa inicial do leilão consiste na execução das seguintes atividades:

  • Coleta das solicitações dos trabalhadores
  • Envio das solicitações aos originadores participantes
  • Apuração da melhor proposta entre os participantes
  • Devolutiva do resultado aos originadores
  • Envio da oferta selecionada para a Dataprev

Com o objetivo de simplificar a integração, após a aceitação da proposta pelo trabalhador, o originador inicia o fluxo de emissão de CCB no modelo convencional (sem leilão).

Dessa forma, o originador permanece preparado para operar o Crédito do Trabalhador (CT) tanto no modelo com leilão quanto sem leilão, sem necessidade de adaptações adicionais no processo de emissão.

Documentação completa da emissão.