Skip to main content
Cada fatura na Aira segue um ciclo de vida com transições claras. Cada status determina quais ações estão disponíveis e o que acontece em seguida.

​
Status da fatura

​
Aberta

Fatura recém-criada pelo ciclo de cobrança. Pode ser editada livremente — itens de linha, descontos, valores. Ações: editar, aplicar descontos, adicionar/remover itens, emitir para revisão, cancelar.

​
Em Revisão

Fatura aguardando aprovação interna antes de ser emitida ao cliente. Ações: aprovar (emitir), devolver para edição, cancelar.

​
Emitida

Fatura finalizada e enviada ao cliente pela régua de cobrança. O PDF é gerado e a cobrança é registrada. O documento fiscal (NFSe) é sincronizado via ERP, se a integração estiver configurada. Ações: registrar pagamento, marcar como atrasada, sincronizar com ERP, cancelar (com restrições).

​
Sincronizada

Fatura sincronizada com o ERP externo (Omie). Os dados financeiros estão alinhados entre a Aira e o sistema contábil. Ações: registrar pagamento, marcar como atrasada.

​
Pendente

Aguardando processamento de pagamento via gateway (Celcash ou Omie). Ações: acompanhar status do pagamento.

​
Paga

Pagamento confirmado. A fatura está liquidada. Ações: consultar detalhes do pagamento, exportar.

​
Atrasada

Fatura não paga após a data de vencimento. A régua de cobrança continua disparando os lembretes de vencimento enquanto a fatura estiver atrasada. Ações: registrar pagamento manual, reenviar cobrança, cancelar.

​
Cancelada

Fatura cancelada. Não gera cobrança. O motivo do cancelamento é registrado para auditoria.

​
Falha

Erro no processamento da fatura (geração de PDF, emissão fiscal ou sincronização). Requer intervenção manual. O motivo da falha mais recente fica registrado na fatura — na API, o campo failureReason (texto livre; null quando não há falha ativa). Ações: identificar e corrigir o erro, reprocessar.

​
Fluxo típico

1

Aberta

Fatura criada pelo ciclo de cobrança. Pode ser editada.
2

Em Revisão

Aguardando aprovação interna.
3

Emitida

Finalizada, PDF gerado e enviada ao cliente.
4

Sincronizada

Dados financeiros alinhados com o ERP.
5

Paga ou Atrasada

Pagamento confirmado, ou prazo expirado. Faturas atrasadas ainda podem ser pagas posteriormente.
Faturas podem ser reabertas para correção em alguns cenários, mas faturas já emitidas com documentos fiscais gerados devem ser tratadas via cancelamento e substituição.

​
Recálculo

Faturas abertas são recalculadas automaticamente toda madrugada com os eventos recebidos durante o dia. Após o fechamento (emissão), o recálculo só ocorre por ação manual.

​
Recalcular um período via API

POST /v1/invoices/recalculate enfileira o recálculo de todas as faturas recalculáveis cuja data de fatura cai no período informado. O período não pode passar de um mês.
A resposta é 202 com total (quantas faturas foram enfileiradas) e capped (quando o período casou com mais faturas do que o limite de 10.000 por requisição, e só as primeiras foram enfileiradas). Faturas canceladas, travadas e avulsas ficam de fora, e faturas que compartilham um grupo de alocação são enfileiradas uma única vez. Use GET /v1/invoices com o mesmo filtro invoiceDate para conferir a seleção antes de disparar.

​
Próximos passos