Submete uma proposta de crédito ao Leilão CLT para um lead.
POST https://apicorp.celcoin.com.br/leilao-clt/v1/leads/{{lead_id}}/proposals
Domínio diferente: A proposta precisa ser submetida na base_url (apicorp.celcoin.com.br), nãoplatform.flowfinance.
Headers: Authorization: Bearer {{leilao_token}} · Content-Type: application/json
Importante: O token do Leilão tem o formato
lk_<uuid>.<segredo>e é independente do token OAuth da FlowFinance. Padronize para usarAuthorization: Bearer {{leilao_token}}e evitar ambiguidade.
Path params
| Param | Descrição |
|---|---|
| lead_id | Lead do Leilão CLT que receberá a proposta |
Body
| Campo | Tipo | Descrição |
|---|---|---|
| originator_id | string (UUID) | Originador que submete a proposta |
| installment_quantity | int | Número de parcelas |
| disbursement_amount | number | Valor desembolsado |
| financed_amount | number | Valor financiado |
| installment_amount | number | Valor da parcela |
| total_amount_owed | number | Total devido |
| available_limit | number | Limite/margem disponível |
| iof | number | IOF |
| monthly_interest_rate_pct | number | Taxa de juros mensal |
| annual_interest_rate_pct | number | Taxa de juros anual |
| monthly_effective_interest_rate | number | Taxa efetiva mensal |
| annual_effective_interest_rate | number | Taxa efetiva anual |
| data_validade_proposta | string (ISO 8601) | Validade da proposta |
| contacts | array | Lista de { type: int, value: string } |
Exemplo (cURL)
curl -X POST "https://apicorp.celcoin.com.br/leilao-clt/v1/leads/UUID/proposals" \
-H "Authorization: Bearer {{leilao_token}}" \
-H "Content-Type: application/json" \
-d '{
"originator_id": "UUID",
"installment_quantity": 36,
"disbursement_amount": 2000,
"financed_amount": 2010,
"installment_amount": 56.89,
"total_amount_owed": 2048.04,
"available_limit": 854.16,
"iof": 10,
"monthly_interest_rate_pct": 0.100000,
"annual_interest_rate_pct": 1.206700,
"monthly_effective_interest_rate": 0.104969,
"annual_effective_interest_rate": 1.266900,
"data_validade_proposta": "2026-07-01T11:30:00Z",
"contacts": [
{ "type": 0, "value": "https://originador.com.br/atendimento" }
]
}'3.1 Submeter Propostas em Batch
Novo — complemento. Rota para enviar várias propostas do mesmo lead em uma única chamada (até 8 propostas por lead, dentro da janela de coleta). O corpo é um objeto com o array
proposals, cada item no mesmo schema da proposta individual.
POST https://apicorp.celcoin.com.br/leilao-clt/v1/leads/{{lead_id}}/proposals/batch
Headers: Authorization: Bearer {{leilao_token}} · Content-Type: application/json
Body
| Campo | Tipo | Descrição |
|---|---|---|
| proposals | array | Lista de objetos de proposta (mesmo schema do item 3, acima) |
Exemplo (cURL)
curl -X POST "https://apicorp.celcoin.com.br/leilao-clt/v1/leads/UUID/proposals/batch" \
-H "Authorization: Bearer {{leilao_token}}" \
-H "Content-Type: application/json" \
-d '{
"proposals": [
{
"originator_id": "UUID",
"external_id": "sim-12x",
"installment_quantity": 12,
"disbursement_amount": 12000,
"financed_amount": 12350,
"installment_amount": 450.2,
"total_amount_owed": 5402.4,
"available_limit": 854.16,
"iof": 350,
"monthly_interest_rate_pct": 1.79,
"annual_interest_rate_pct": 23.75,
"monthly_effective_interest_rate": 1.85,
"annual_effective_interest_rate": 24.57,
"data_validade_proposta": "2026-07-01T10:30:00Z",
"contacts": [
{ "type": 0, "value": "https://parceiro.com.br/proposta/149261812" },
{ "type": 3, "value": "[email protected]" }
]
},
{
"originator_id": "UUID",
"external_id": "sim-24x",
"installment_quantity": 24,
"disbursement_amount": 12000,
"financed_amount": 12350,
"installment_amount": 248.9,
"total_amount_owed": 5973.6,
"available_limit": 854.16,
"iof": 350,
"monthly_interest_rate_pct": 1.82,
"annual_interest_rate_pct": 23.75,
"monthly_effective_interest_rate": 1.85,
"annual_effective_interest_rate": 24.57,
"data_validade_proposta": "2026-07-01T10:30:00Z",
"contacts": [
{ "type": 0, "value": "https://parceiro.com.br/proposta/149261812" },
{ "type": 3, "value": "[email protected]" }
]
},
{
"originator_id": "UUID",
"external_id": "sim-36x",
"installment_quantity": 36,
"disbursement_amount": 12000,
"financed_amount": 12350,
"installment_amount": 183.1,
"total_amount_owed": 6591.6,
"available_limit": 854.16,
"iof": 350,
"monthly_interest_rate_pct": 1.85,
"annual_interest_rate_pct": 23.75,
"monthly_effective_interest_rate": 1.85,
"annual_effective_interest_rate": 24.57,
"data_validade_proposta": "2026-07-01T10:30:00Z",
"contacts": [
{ "type": 0, "value": "https://parceiro.com.br/proposta/149261812" },
{ "type": 3, "value": "[email protected]" }
]
}
]
}'Resposta 200 (batch)
{
"results": [
{ "index": 0, "status": "accepted", "proposal_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7" },
{ "index": 1, "status": "accepted", "proposal_id": "0b4e4d9e-b2e1-7c5d-8f01-2345a3f7c821" },
{ "index": 2, "status": "rejected", "error_code": "ERR_MARGEM_INSUFICIENTE", "message": "installment_amount exceeds available_limit" }
]
}Nota: Cada item do batch é validado de forma independente — é possível ter propostas aceitas e rejeitadas na mesma resposta (modo parcial). O
indexreferencia a posição no arrayproposalsenviado.