Relatórios
A pílula Relatório — na lista de cartões ou na tela de um cartão — abre Gerar relatório com dois tipos: IOF pago e Previsto × realizado. Aberto pela tela de um cartão, ele já vem com esse cartão no filtro e no tipo da aba em que você estava.
| Passo | Opções |
|---|---|
| Tipo | IOF pago ou Previsto × realizado |
| Detalhamento | Sintético (os grupos) ou Analítico (os grupos e, embaixo de cada um, os lançamentos) |
| Agrupar por | Só no IOF: Mês, Cartão, Categoria ou Fornecedor |
| Período | Obrigatório. No IOF, pela data da compra; no previsto × realizado, pelo mês da cobrança |
| Filtros | Cartões, Categoria e Fornecedor (opcionais) |
Incluir gráfico acrescenta o gráfico acima da tabela. Gerar relatório abre o relatório numa página própria, pronta para imprimir.

IOF pago
O IOF das compras internacionais tratado como imposto: para cada grupo, o Valor da compra (em reais, sem o IOF), o IOF, a Alíquota e a quantidade de compras, com o total no fim.
- Entram só lançamentos realizados ou conciliados com IOF. Um previsto ainda não pagou imposto nenhum.
- Um estorno com IOF devolvido abate do grupo.
- Por categoria, uma compra rateada entre categorias reparte o IOF na mesma proporção. Filtrando por categoria, conta só a parte da compra nas categorias escolhidas.
- No Analítico, cada compra mostra a moeda, o valor na moeda, a cotação, o valor da compra, a alíquota gravada nela e o IOF.
A alíquota do grupo é a efetiva: o IOF dividido pelo valor da compra. Como o IOF de cada compra é arredondado ao centavo, ela pode sair como 3,4999% num grupo de compras a 3,5%. A de cada compra, no analítico, é a alíquota gravada nela.
Previsto × realizado
Para cada recorrência, mês a mês: o Previsto (o valor esperado), o Realizado (o que foi confirmado; não cobrado conta zero), a Diferença e a Diferença (%), sempre em reais e sem IOF — a mesma conta da coluna Variação da aba Recorrências.
Um mês ainda previsto entra no previsto e fica sem realizado nem diferença. A coluna Meses mostra quantos já foram confirmados: "6 (2 a confirmar)". "A diferença compara só os meses já confirmados; o previsto soma todos."
Exportar em CSV ou XLSX
Na página do relatório, Exportar para Excel abre a exportação com a escolha do Formato: CSV ou XLSX. As colunas são as mesmas da tela, nos dois formatos:
- CSV no padrão brasileiro (ponto e vírgula, vírgula decimal), como os outros relatórios do sistema;
- XLSX com valores numéricos de verdade — moeda, porcentagem e data formatadas, cabeçalho congelado —, pronto para somar e filtrar na planilha.
Pela API e pelo MCP
Os mesmos números saem de GET /card-transactions/aggregates, agrupando por card, statement, category, person ou month, com sum_iof_amount e sum_base_amount em cada grupo, e da ferramenta finance_card_transactions_aggregates do servidor MCP.