This e-Consignado Trabalhador auction service is an API that delivers worker-credit
leads — sourced from Caixa/Dataprev's e-Consignado Trabalhador program — to your
company, and lets you submit counter-proposals (with or without FGTS guarantee),
which we forward to Dataprev. The flow is built for high throughput (batch delivery and
batch submission) while protecting both the lead pool and the provider's rate limits.
The integration has three steps: authenticate, reserve leads, and submit
counter-proposals. Lead distribution is defined by a commercial agreement: your
company has an agreed lead volume available and an agreed validity window. When
you reserve, you receive a batch within your volume and get an exclusive window to
respond — during that period, those leads are not offered to any other partner.
How it works (operation flow)
- Authenticate —
POST /ect/authreturns a token tied to your company's project. - Reserve leads —
GET /ect/leads/reservarhands you a batch ofativoleads,
respecting your company's available volume. They become reserved to you for a TTL
of 5 minutes; no other partner can see them during this period. If you don't
submit the counter-proposals for the reserved leads within 5 minutes, the ones not
submitted are lost and returned to the pool by a sweep. Delivery is subject to a
per-minute quota (see below). - Submit counter-proposals —
POST /ect/counter-proposalsaccepts an array of
proposals (N:N), which we forward to Dataprev in batches. Each item declares
temGarantias(with/without FGTS guarantee).
Throughput controls
| Control | Where | Default | Meaning |
|---|---|---|---|
| Lead volume | reserve | commercial agreement | Number of leads available to your company, defined commercially. |
| Per-request cap | reserve | ‹TODO: 500/1000?› | Max leads returned in a single reserve call. |
| Per-minute quota | reserve | 600/min (per partner) | Max leads delivered to your company per clock-minute, summed across calls. |
| Reservation TTL | reserve | 5 min | How long leads stay exclusive to you; after that, unsubmitted ones return to the pool. |
| Dataprev rate limit | counter-proposals | internal | We throttle submissions to the provider transparently. |