Validações iniciais (pré-requisitos):

A conta iugu deve ter a função Antecipação habilitada.
Deve-se atentar à disponibilidade da função:

🚧
Horários de Antecipação
Dias úteis, de 9h05 às 18h50.

Fluxo:

Para efetuar uma Antecipação via API, siga a seguinte ordem de requisições para as Endpoints listadas:

Acesse a endpoint 'Criar Simulação de Recebíveis' e crie uma Simulação (POST).
O status da Simulação pode ser recebido via webhook, como também pode ser consultado à qualquer momento através da endpoint 'Verificar Status da Simulação' (GET).
Atenção: A simulação possui um prazo de expiração de30 minutos (contabilizando o tempo desde a sua solicitação).
Ao checar o status de uma Simulação, os status 'processing' ou 'done' serão retornados.
Para finalmente solicitar uma Antecipação através da endpoint 'Aprovar Antecipação' (POST), será necessário ter recebido o webhook informando que a simulação foi concluída, ou uma resposta com status 'done' do endpoint 'Verificar Status da Simulação'.
A Antecipação será criada a partir dos valores informados na resposta do progresso da simulação.
Para ser notificado ao finalizar a Antecipação, utilize o webhook de Status de Antecipação. Você também pode consultar o status da Antecipação (endpoint 'Verificar Status da Antecipação'), lembrando que é necessário ter aprovado uma Antecipação anteriormente (endpoint 'Aprovar Antecipação').
Para gerar uma nova Simulação, aguarde a finalização da Simulação anterior (done) e então envie uma nova simulação com o valor desejado. Apenas UMA simulação/antecipação pode ser executada por vez.

📘
Extrato Consolidado de Liquidados
Utilize também nossa endpoint de Extrato Consolidado de Liquidados, que retorna o extrato de transações liquidadas e pagamentos pendentes/efetivados, para facilitar conciliações e relatórios.
Apenas disponível para o ambiente produção.