> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Antecipação avulsa
> Antecipe seus recebíveis futuros sob demanda na Malga. Consulte os recebíveis disponíveis, simule o valor que vai receber e confirme a antecipação.
A **antecipação avulsa** e os endpoints relacionados estão em **Beta**. A funcionalidade já está disponível para clientes habilitados, mas detalhes da API e do fluxo podem evoluir nas próximas versões.
A **antecipação avulsa** permite que você receba antes da data prevista os recebíveis das suas vendas processadas pela Malga, pagando uma taxa proporcional ao tempo antecipado. É "avulsa" porque é solicitada sob demanda — você decide quando e quais recebíveis quer antecipar.
## Como funciona
A antecipação é solicitada **por data de recebimento**. Você informa uma ou mais datas para as quais quer antecipar o dinheiro, e a Malga **agrupa todos os recebíveis previstos para cada data informada** numa única simulação, calculando o valor líquido que você vai receber.
Após confirmar a simulação, o pagamento é feito via transferência para a conta cadastrada.
## Pré-requisitos
Antes de começar, sua conta precisa atender a estes dois requisitos:
1. **Transacionar pelo provedor de pagamento Malga.** A antecipação avulsa cobre apenas os recebíveis gerados em transações processadas pelo provedor Malga. Transações feitas por outros provedores conectados à plataforma (como Cielo, Rede, Adyen, etc.) não entram na antecipação.
2. **Estar habilitada para antecipar recebíveis com a Malga.** Para solicitar a habilitação, entre em contato com o nosso suporte pelo e-mail [suporte@malga.io](mailto:suporte@malga.io). A solicitação passa por uma análise antes de ser aprovada.
Se a sua conta ainda não está habilitada, qualquer chamada à API de antecipação retornará um erro com status `403 Forbidden`.
## Fluxo de uso
Use o endpoint [Consultar recebíveis disponíveis](/api-reference/prepayment/consultar-recebiveis-disponiveis-para-antecipacao) para listar os recebíveis elegíveis para antecipação e ver o valor total disponível.
```bash theme={null}
curl --location 'https://api.malga.io/v1/subacquirer/prepayment/receivables' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY'
```
A resposta traz um `summary` com o valor total disponível e a quantidade de recebíveis, além da lista de recebíveis com a data prevista de recebimento de cada um.
Escolha uma ou mais datas e crie uma simulação com o endpoint [Simular antecipação](/api-reference/prepayment/simular-antecipacao). A Malga agrupa todos os recebíveis previstos para cada data informada e devolve o valor líquido que você vai receber.
```bash theme={null}
curl --location 'https://api.malga.io/v1/subacquirer/prepayment' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"requestedDates": ["2026-06-15", "2026-06-20"]
}'
```
A resposta traz o `id` da simulação (que você usa no aceite), o valor bruto, o valor líquido, o desconto, a taxa efetiva e o `expiresAt` (até quando a simulação pode ser aceita).
Para efetivar a antecipação, faça o aceite chamando o endpoint [Confirmar antecipação](/api-reference/prepayment/confirmar-antecipacao).
```bash theme={null}
curl --location --request POST 'https://api.malga.io/v1/subacquirer/prepayment/{id}/commit' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY'
```
Após o aceite, a antecipação passa para o status `committed` e segue para pagamento.
## Como o valor antecipado é calculado
Cada recebível tem um valor bruto e uma data prevista de recebimento. Quanto **mais distante** essa data, **maior o desconto** aplicado, porque você está antecipando mais dias.
A resposta da simulação devolve:
* `grossAmount`: soma do valor original dos recebíveis (em centavos).
* `netAmount`: valor líquido que você vai receber (em centavos).
* `feeAmount` e `markupAmount`: componentes do desconto aplicado (em centavos).
* `effectiveRate`: taxa efetiva total da antecipação sobre o valor bruto.
A regra que vale em todo recebível e no total da simulação é:
```
grossAmount = netAmount + feeAmount + markupAmount
```
## Prazos — horário de corte das 15h (horário de Brasília)
A Malga sempre opera em **horário de Brasília**. O campo `expiresAt` é retornado em formato ISO 8601, mas representa esse horário.
Para receber a antecipação **amanhã (D+1)**, a simulação precisa ser **criada e aceita até as 15h (horário de Brasília)** do mesmo dia.
Após as 15h, qualquer simulação criada (ou aceite ainda não realizado) é tratada como se tivesse sido feita no dia seguinte, e o pagamento passa para **D+2**.
O campo `expiresAt` no response indica esse limite — sempre 15h (horário de Brasília) do dia em que a simulação foi criada.
## Antecipação para recebedores
Se você opera com [split de pagamentos](/documentations/split/intro), pode antecipar os recebíveis de um recebedor específico. Para isso, informe o `sellerId` no parâmetro da consulta e no corpo da simulação. Quando o `sellerId` não é informado, a operação é feita sobre os recebíveis da sua conta principal.
## Status da antecipação
| Status | O que significa |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pending` | Simulação criada, ainda não aceita. |
| `committed` | Aceite confirmado. A antecipação está em processamento. |
| `paid` | Pagamento da antecipação realizado. |
| `expired` | Simulação expirou (passou de 15h sem aceite) ou o aceite foi recusado porque o conjunto de recebíveis mudou desde a simulação. Basta simular novamente. |
## Próximos passos
Liste os recebíveis disponíveis para antecipação e o valor total disponível.
Crie uma simulação informando as datas que quer antecipar.
Consulte o status e os detalhes de uma simulação ou antecipação.
Faça o aceite da simulação para efetivar a antecipação.