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

CampoDescriçãoTipo
installment_quantityQuantidade de parcelas da ofertaInteger
installment_amountValor de cada parcelaNumber
available_balanceValor da margem 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_urlLink opcional de autoatendimento do clienteString

🔨 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

CampoDescriçãoTipo
eventTipo de evento enviado no webhookString
payload.idIdentificador da proposta enviada anteriormente pelo originadorString
statusResultado da avaliação da oferta no leilão (APPROVED ou DENIED)String
timestampData e hora da finalização da análise da ofertaDateTime (ISO 8601)
error_messageMotivo do erro caso apresente falha no envio para DataprevString

✅ 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

CampoDescriçãoTipo
eventTipo do eventoString
payload.idIdentificador único da solicitação de créditoString
application_idIdentificador único da aplicação de crédito criada após o aceite da
proposta pelo tomador
String
person_idIdentificador único do tomador (pessoa que realizou o aceite)String
timestampMotivo do erro caso apresente falha no envio para DataprevDateTime (ISO 8601)