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
Campo | Descrição | Tipo |
---|---|---|
installment_quantity | Quantidade de parcelas da oferta | Integer |
installment_amount | Valor de cada parcela | Number |
available_balance | Margem disponível no momento da proposta | Number |
amount | Valor total a ser liberado para o tomador | Number |
iof | Valor do IOF incluso na operação | Number |
annual_tax | Taxa de juros anual (%) | Number |
cet | Custo Efetivo Total anual (%) | Number |
interest_tax | Taxa de juros nominal mensal (%) | Number |
monthly_cet | Custo Efetivo Total mensal (%) | Number |
entry_url | URL opcional para redirecionamento do tomador | String |
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:
- 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.- 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
Campo | Descrição | Tipo |
---|---|---|
event | Tipo do evento no webhook | String |
payload.id | ID da proposta enviada | String |
status | Resultado da avaliação (APPROVED, DENIED ou ERROR) | String |
timestamp | Data/hora da finalização da avaliação | YYYY-MM-DD |
error_message | Detalhe 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
Campo | Descrição | Tipo |
---|---|---|
event | Tipo do evento | String |
payload.id | ID da solicitação de crédito | String |
application_id | ID da aplicação de crédito gerada após o aceite | String |
person_id | ID do tomador | String |
timestamp | Data/hora da criação da aplicação | YYYY-MM-DD |
Updated 5 days ago