Antecipar Recebíveis

Pré-requisitos, fluxo, e passo à passo de como simular e antecipar seus recebíveis.

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

  1. A conta iugu deve ter a função Antecipação habilitada.

  2. Deve-se atentar à disponibilidade da função:

🚧

Horários de Antecipação

Dias úteis, de 9h30 às 19h00.

Fluxo:

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

  1. Acesse a endpoint 'Criar Simulação de Recebíveis' e crie uma Simulação (POST).

  2. 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 de 30 minutos (contabilizando o tempo desde a sua solicitação).

  3. Ao checar o status de uma Simulação, os status 'processing' ou 'done' serão retornados.

  4. 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.

  5. 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').

  6. 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.