Envio da Oferta, Leilão Interno & Devolutiva

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,
  "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
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.
  2. Formulário Digital padrão da Celcoin
    Caso a URL não seja informada, o tomador será redirecionado para o formulário padrão da Celcoin, onde preencherá os dados complementares necessários.

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.

Se o tomador optar por aceitar a oferta da Celcoin (consignatária Via Capital), a cel_credit enviará uma notificação via webhook para o originador vencedor, informando que o tomador realizou o cadastro e iniciou o processo de emissão da CCB.


🚨

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.

POST:{webhook-cadastrado}

JSON de Exemplo

{
  "event": "WorkersCreditApplicationCreated",
  "payload": {
    "id": "01d4889f-0000-0000-eb1b-7e3a4fc63649",
    "application_id": "11d4889f-0000-0000-eb1b-7e3a4fc63649",
    "person_id": "21d4889f-0000-0000-eb1b-7e3a4fc63649",
    "timestamp": "2025-05-29T22:40:01.222Z"
  }
}

Parâmetros

CampoDescriçãoTipo
eventTipo do eventoString
payload.idID da solicitação de créditoString
application_idID da aplicação de crédito gerada após o aceiteString
person_idID do tomadorString
timestampData/hora da criação da aplicaçãoYYYY-MM-DD