Skip to main content

Enviar propostas em lote

Endpoint: POST /econsigado/employee/clt-leads/proposals
Scope: econsignado.write

Até 100 leads numa chamada. Cada item repete o body de Enviar propostas: { "id", "proposals" }. O proposal_request_id não deve ser enviado. O formato de uma proposta solta no corpo raiz não vale neste endpoint.

O envio unitário POST /econsigado/employee/clt-leads/{id}/proposal continua disponível.

As regras de requires_guarantees, proposal_number e requested_guarantee são as mesmas do envio unitário, aplicadas a cada lead.

proposal_valid_until usa o formato Dataprev ddMMyyyyHHmmss, no horário de Brasília.

curl --location 'https://secureapi.onz.finance/api/v2/econsigado/employee/clt-leads/proposals' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"proposals": [
{
"proposal_number": "PROP0001",
"proposal_valid_until": "30072026235959",
"installments_count": 24,
"installment_amount": 250.00,
"released_amount": 5000.00,
"loan_amount": 5200.00,
"iof_amount": 15.00,
"annual_rate": 18.00,
"annual_cet": 21.00,
"monthly_rate": 1.50,
"monthly_cet": 1.75,
"contacts": [
{ "type": 1, "contact": "[email protected]" }
],
"has_guarantees": false
}
]
}
]
}'

Resposta​

200. O array items volta na mesma ordem do body.

CampoQuando
ok: truelead e dataprev_response daquele lead
ok: falsestatus e message. Esse lead não impede os outros
{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"ok": true,
"lead": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "PROPOSAL_SENT",
"proposal_sent_by_me": true
},
"dataprev_response": [{}]
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"ok": false,
"status": 409,
"message": "Esta conta já enviou proposta para este lead. Aguarde o desfecho ou registre-o manualmente."
}
]
}

Um lead inexistente, de outra conta, já enviado ou expirado volta em ok: false e os demais seguem. Se a Dataprev recusar o pacote, cada lead que tinha sido enviado nessa chamada volta com o erro dela e pode ser reenviado.

Erros da chamada​

Estes erros valem para o request inteiro. Nada é enviado.

HTTPSituação
400Lote vazio, acima de 100 leads, lead repetido ou conjunto de propostas inválido
403Conta não habilitada para o eConsignado

Os erros de um lead específico (404, 409, 422) vêm dentro de items, com ok: false.