Recebimento de Ofertas, Proposta & Leilão Interno
📤 Recebimento da oferta do originador
Após o recebimento da solicitação de crédito via Webhook, cada originador participante do leilão poderá
enviar sua proposta com as respectivas condições da oferta de crédito.
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 proposta selecionada será encaminhada ao tomador, que
poderá escolher a instituição de sua preferência.
Originadores que optarem por utilizar seu próprio formulário para a coleta de dados complementares do
tomador devem informar a URL de redirecionamento. Caso a oferta seja aceita, o tomador será
automaticamente direcionado para essa URL.
Se o originador desejar utilizar o formulário web padrão da Celcoin, basta não informar nenhuma URL no
momento do envio da proposta.
O envio da oferta deve ser realizado por meio do seguinte endpoint, utilizando o id da solicitação recebida
anteriormente:
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 | Valor da 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 | Link opcional de autoatendimento do cliente | String |
🔨 Leilão interno de propostas
As propostas inseridas pelos originadores serão submetidas a um processo de apuração para definir qual
a melhor proposta para representar a consignatária junto ao órgão gestor das propostas.
🖐 Regras Gerais de Apuração e Escolha da Melhor Oferta
● Cada originador pode submeter apenas uma proposta por solicitação.
● Existe uma janela limite para recebimento das propostas que é gerida pela plataforma de crédito..
● O sistema avalia todas as propostas recebidas e seleciona a melhor oferta com base em critérios
definidos: valor liberado, valor da parcela e quantidade de parcelas. Depois de selecionar as
melhores propostas com base nesses critérios, é eleita a oferta que possui a menor taxa de juros.
● A proposta escolhida é, então, submetida ao órgão gestor para que seja disponibilizada ao
tomador via CTPS Digital. A partir dali, o tomador fará a escolha e seguirá para o fluxo de
contrataçã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"//”APPROVED” // “DENIED”
"timestamp": "2025-06-12T15:39:13.251Z",
"error_message": "Request failed with status code 400"
}
}
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 de evento enviado no webhook | String |
payload.id | Identificador da proposta enviada anteriormente pelo originador | String |
status | Resultado da avaliação da oferta no leilão (APPROVED ou DENIED) | String |
timestamp | Data e hora da finalização da análise da oferta | DateTime (ISO 8601) |
error_message | Motivo do erro caso apresente falha no envio para Dataprev | String |
✅ Aceite da oferta pelo tomador
Após o término do leilão, o tomador tem até 24 horas para realizar o aceite de uma das propostas
disponíveis no app da CTPS Digital.
Se o tomador optar por aceitar a proposta da 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 do tomador não garante a emissão da CCB. Para que o empréstimo seja
concluído com sucesso, é necessário passar pelas seguintes etapa:
● KYC (Know Your Customer) – Validação da identidade do tomador.
● Assinatura do Contrato (CCB) – Confirmação formal por parte do tomador.
● Averbação da Dataprev – Confirmação do desconto em folha.
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 | Identificador único da solicitação de crédito | String |
application_id | Identificador único da aplicação de crédito criada após o aceite da proposta pelo tomador | String |
person_id | Identificador único do tomador (pessoa que realizou o aceite) | String |
timestamp | Motivo do erro caso apresente falha no envio para Dataprev | DateTime (ISO 8601) |
Updated 3 days ago