Antecipação de Recebíveis - Cotar
POST /v1/anticipations/quote
Diz o que é elegível, a taxa de cada recebível, os totais e a decisão que o pedido teria (auto = cai na hora;
staff = aguarda a Selectwin) — ou por que seria recusado. Não escreve nada: cote quantas vezes quiser.
Requisição
Shell
curl -X POST "https://api.selectwin.io/v1/anticipations/quote" \
-H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
-H "Content-Type: application/json" \
-d '{ "all": true }'Corpo da Requisição
Um dos três, obrigatoriamente:
| Campo | Tipo | Descrição |
|---|---|---|
receivableIds | string[] | Recebíveis específicos (rec_..., até 500) |
untilExpectedOn | string | Tudo o que libera até este instante (ISO 8601) |
all | boolean | Tudo o que é elegível (até 500) |
Resposta 200 OK
JSON
{
"items": [
{ "id": "rec_01hqzvabc", "amountCents": 100000, "expectedOn": "2026-11-19T03:00:00.000Z", "days": 30, "feeCents": 2990, "netCents": 97010, "method": "credit" },
{ "id": "rec_01hqzvabd", "amountCents": 50000, "expectedOn": "2026-10-30T03:00:00.000Z", "days": 10, "feeCents": 498, "netCents": 49502, "method": "pix" }
],
"skipped": [{ "id": "rec_01hqzvabe", "reason": "notInFuture" }],
"grossCents": 150000,
"feeCents": 3488,
"netCents": 146512,
"feePercentMonth": 2.99,
"decision": "auto",
"blocked": null
}| Campo | Descrição |
|---|---|
items[].days | Dias de calendário antecipados — a taxa é amountCents × feePercentMonth% × days / 30, ao centavo |
skipped[] | O que não entra: notInFuture = libera hoje ou já passou (a liberação normal cuida) |
decision | auto (dentro do teto: executa na hora) ou staff (aguarda a Selectwin); null quando barrado |
blocked | O código do motivo pelo qual o pedido seria recusado (o mesmo do erro 422); null quando pode ir |
Códigos de blocked
| Código | Significado |
|---|---|
anticipationDisabled | A antecipação está desligada na plataforma |
anticipationNotEnabledForCompany | Não está habilitada para a sua empresa — fale com o suporte |
payoutsFrozen / withdrawalCompanyNotActive / payoutHeldForRiskReview | Os mesmos bloqueios do saque |
anticipationNoAcquirerEvidence | Ainda não há histórico suficiente de liquidação das suas vendas de cartão para antecipá-las (Pix e boleto podem ser cotados à parte) |
anticipationExposureCapExceeded | O pedido ultrapassaria o teto de exposição da plataforma — tente um valor menor |
Atualizado em 21 de outubro de 2026