Contas a pagar e conformidade
Como o ERP sabe se uma conta pode ser paga agora, pela regra de conformidade documental do Afflux.
Em resumo
- Cada conta a pagar traz
pagamento.liberado: pode pagar agora ou não. - Quando não pode,
motivodiz por quê — e, se for documentação,pendenciaslista o que falta. ?pagavel=truedevolve só a fila do que pode ser pago agora.- A situação é calculada na hora e não muda
atualizadoEm: consulte a conta imediatamente antes de pagar.
A conta
GET /contas-pagar · GET /contas-pagar/{id} — permissão financeiro.ler
| Filtro | Valores |
|---|---|
status | aberta, emaprovacao, aprovada, agendada, paga, cancelada |
fornecedorId | id do fornecedor |
pagavel | true ou false |
vencimentoDe, vencimentoAte | Datas AAAA-MM-DD |
Campos principais: descricao, status, valor (o valor líquido do documento — as retenções já saíram), vencimento, competencia, vencida, fornecedor, contrato, documentoFaturamento, classificacao (centro de custo, projeto e departamento, com codigo), contaBancariaId e pagamento.
A situação de pagamento
"pagamento": {
"liberado": false,
"motivo": "conformidade",
"pendencias": [
{ "tipo": "Certidão negativa de débitos", "identificacao": null, "situacao": "vencido" }
],
"alertas": []
}motivo | O que significa | O que o ERP faz |
|---|---|---|
null | Liberada: aprovada, fora de lote e sem pendência que trave | Pode pagar |
conformidade | Há documentação pendente que a empresa configurou para travar o pagamento | Não paga; a equipe resolve no Afflux (enviar o documento ou liberar com motivo) |
lote | A conta está num lote de pagamento do Afflux (Asaas) | Não paga pelo ERP: o lote cuida dela |
paga | Já paga | Nada |
status | Ainda não aprovada, ou cancelada | Aguarda |
alertas lista pendências que a empresa configurou só para avisar: elas não impedem o pagamento, mas vale mostrá-las a quem paga.
A situação depende de documentos que vencem com o tempo e de liberações feitas por pessoas no Afflux — por isso ela não move a data de atualização da conta, e a sincronização incremental não a "avisa". Monte a remessa com ?pagavel=true e confirme cada conta com GET /contas-pagar/{id} logo antes de pagar.
A fila do que pode ser pago
curl "https://app.afflux.com.br/api/v1/contas-pagar?pagavel=true&vencimentoAte=2026-10-31&limite=100" \
-H "Authorization: Bearer $AFFLUX_CHAVE"E depois de pagar?
Nesta versão a API só lê: a baixa continua sendo registrada no Afflux, pela tela de pagamentos. O registro do pagamento informado pelo ERP — com conferência no Afflux antes de virar baixa — é o próximo passo da API.