SelectwinSelectwin

Antecipação de Recebíveis - Visão Geral

Introdução

A antecipação de recebíveis traz para o seu saldo disponível, hoje, o valor de recebíveis que só liberariam na data prevista (expectedOn). O valor cai líquido da taxa de antecipação da sua conta (um percentual ao mês, cobrado proporcionalmente aos dias antecipados) e cada taxa aparece como uma linha própria no extrato.

O fluxo tem três passos: cotar (o que é elegível e quanto custa), pedir (o pedido antr_...) e, quando o pedido fica acima do teto de aprovação automática, aguardar a aprovação da Selectwin. Dentro do teto, o dinheiro cai na hora.

Estrutura do Pedido

JSON
{
  "id": "antr_01hqzvabc",
  "status": "executed",
  "grossCents": 150000,
  "feeCents": 3488,
  "netCents": 146512,
  "feePercentMonth": 2.99,
  "receivableCount": 2,
  "requestedAt": "2026-10-20T15:00:00.000Z",
  "decidedBy": "auto",
  "decidedAt": "2026-10-20T15:00:00.000Z",
  "decisionReason": null,
  "executedAt": "2026-10-20T15:00:00.000Z",
  "canceledAt": null,
  "createdAt": "2026-10-20T15:00:00.000Z",
  "items": [
    { "id": "rec_01hqzvabc", "amountCents": 100000, "expectedOn": "2026-11-19T03:00:00.000Z", "days": 30, "feeCents": 2990, "netCents": 97010, "method": "credit" }
  ]
}

Campos

CampoTipoDescrição
idstringIdentificador do pedido (antr_...)
statusstringrequested (aguardando aprovação), approved, executed (o dinheiro caiu), rejected, canceled
grossCentsintegerSoma dos recebíveis antecipados (centavos)
feeCentsintegerSoma das taxas (centavos)
netCentsintegerO que caiu (ou cairá) no saldo disponível
feePercentMonthnumberA taxa da sua conta, % ao mês
receivableCountintegerQuantos recebíveis
decidedBystring | nullauto (dentro do teto) ou staff; null enquanto aguarda
decisionReasonstring | nullO motivo de uma recusa
items[]arrayOs recebíveis (só na consulta de um pedido): days antecipados e feeCents de cada um; expectedOn é a data original

Status

StatusSignificado
requestedAcima do teto de aprovação automática; aguarda a Selectwin. Pode ser cancelado
approvedAprovado pela Selectwin; executa em seguida
executedConcluído: o líquido está no saldo disponível e cada recebível saiu como receivable.paid
rejectedRecusado (decisionReason diz por quê). Os recebíveis voltam a ser elegíveis
canceledCancelado por você enquanto aguardava

Elegibilidade

Entram os recebíveis agendados (scheduled), ainda não liberados, com expectedOn no futuro, sem disputa nem estorno em andamento e fora de outro pedido vivo. Até 500 recebíveis por pedido.

Eventos de webhook

anticipation.requested, anticipation.executed, anticipation.rejected, anticipation.canceled — com o objeto do pedido. Cada recebível antecipado também dispara receivable.paid.

Endpoints

  • Cotar — POST /v1/anticipations/quote
  • Pedir — POST /v1/anticipations
  • Listar — GET /v1/anticipations
  • Consultar — GET /v1/anticipations/{anticipationId}
  • Cancelar — POST /v1/anticipations/{anticipationId}/cancel

Atualizado em 21 de outubro de 2026

Preferências de cookies

Hoje o site usa só cookies essenciais: nenhuma ferramenta de medição ou de anúncios está ligada, e nada é compartilhado com terceiros. Se isso mudar, você decide aqui antes de qualquer coisa ser carregada.

  • Mantêm o site funcionando: segurança, a sua escolha sobre cookies e preferências como a versão da documentação. Não dependem de consentimento.

    Sempre ativos