---
name: Cartão de Crédito e Faturas por Mês
description: Filtro de faturas por mês, campos data compra/vencimento, comissões vinculadas a contas
type: project
originSessionId: f66a0c91-ebe6-4409-a5d7-0f325b097340
---
## Cartão de Crédito - Melhorias (2026-04-14)

### Faturas filtradas por mês
- API `apiListarFaturas` agora aceita parâmetro `mes` (YYYY-MM) para filtrar faturas
- Card de contas financeiras também filtra cartão por mês via `calcularSaldoAtual($id, $mes)`
- Evita mostrar total acumulado de todos os meses (que era R$ 292k)

### Campos de data no modal Nova Compra
- **Data da Compra**: editável, data em que a compra foi feita (salva em `lancamentos_financeiros.data`)
- **Data de Vencimento**: editável, define o mês da fatura (salva em `data_competencia`, determina `mes_referencia`)
- Tabela de compras mostra ambas as colunas

### Comissões vinculadas a contas
- Pagamentos de comissão agora **obrigam** seleção de conta de saída (validação no frontend)
- Comissões antigas com `conta_financeira_id = NULL` foram vinculadas ao Bradesco (ID 15)

## Recibo PDF - Retiradas Detalhadas (2026-04-14)

### Ajustes salvos no detalhes_json
- Ao gerar pagamento de comissão, retiradas/inclusões são salvas no `detalhes_json` com motivo e valor
- `montarHTMLRecibo` exibe tabela detalhada (motivo + valor de cada retirada)
- Para lançamentos antigos: busca na tabela `retiradas_professor` pelo `lancamento_id`
- Valor líquido recalculado: `bruto - retiradas + inclusões` (não usa valor armazenado que podia estar errado)

**Why:** Valores de comissão estavam sendo descontados duas vezes e o PDF não mostrava o detalhamento.
**How to apply:** Sempre incluir ajustes no detalhes_json ao gerar pagamentos. No PDF, recalcular valor líquido quando há ajustes.