Central de Relatórios
O que é?
A Central de Relatórios (/admin/reports) é o ponto de acesso unificado para todos os relatórios exportáveis do sistema. Acesse pelo card "Relatórios" no dashboard.
💡 Os botões de exportação nas telas de Faturas e Créditos continuam funcionando como atalhos contextuais — a Central é uma entrada alternativa, útil quando você quer um relatório sem navegar por outra tela.
Relatórios disponíveis
Faturamento
| Relatório | Filtros necessários | Formatos |
|---|---|---|
| Recebimentos do mês | Ano + Mês | CSV |
| Receita por Imóvel | Ano + Mês (opcional) | CSV |
| Informe de Rendimentos | Ano | |
| Inadimplência atual | Nenhum | PDF, CSV |
| Fatura e histórico de pagamentos | Inquilino + Ano + Mês → Fatura | PDF da fatura, PDF histórico, CSV histórico |
| Despesas do Período | Ano + Mês (opcional) | PDF, CSV |
| A Receber no Período | Ano + Mês (opcional) | PDF, CSV |
Imóveis
| Relatório | Filtros necessários | Formatos |
|---|---|---|
| DRE Simplificado | Imóvel + Ano + Mês (opcional) | PDF, CSV |
| Vacância | Nenhum | PDF, CSV |
Parceiros
| Relatório | Filtros necessários | Formatos |
|---|---|---|
| Extrato de Partilha | Parceiro + Ano + Mês (opcional) | PDF, CSV |
Inquilinos
| Relatório | Filtros necessários | Formatos |
|---|---|---|
| Extrato Completo do Inquilino | Inquilino + Ano (opcional) | PDF, CSV |
| Depósitos Ativos | Nenhum | PDF, CSV |
| Extrato de crédito/dívida | Inquilino | PDF, CSV |
Como usar
- Acesse Dashboard → Relatórios
- Localize o relatório desejado
- Preencha os filtros (quando exigidos)
- Clique no botão de formato desejado — o download inicia automaticamente
Seleção de fatura (Fatura e histórico)
Para relatórios de fatura específica, a seleção é em cascata:
- Escolha o Inquilino
- Informe Ano e Mês
- O sistema carrega automaticamente as faturas disponíveis
- Selecione a fatura e clique no botão desejado
Receita por Imóvel
CSV com o total faturado e recebido por imóvel. O mês é opcional:
- Com mês: exibe um resultado por imóvel para aquela competência
- Sem mês: exibe todos os meses do ano com movimentação, um por linha
Colunas: Imóvel, Endereço, Competência, Total Faturado, Total Recebido, Nº Faturas
💡 Dica: Faturas Em edição e Canceladas são excluídas. Um imóvel pode ter mais de uma fatura no mesmo mês se houve troca de inquilino.
Informe de Rendimentos
Gera um PDF com todos os aluguéis recebidos no exercício, agrupados por inquilino — pronto para uso na declaração do Imposto de Renda do locador.
Estrutura do documento:
- Cabeçalho: nome e CPF/CNPJ do locador (dados da licença)
- Por inquilino: nome, CPF/CNPJ, imóvel e endereço
- Tabela mensal: Janeiro a Dezembro com valor recebido em cada mês
- Total anual por inquilino
💡 Dica: Apenas faturas com status Pago ou Parcialmente pago entram no relatório. Meses sem recebimento aparecem com R$ 0,00.
DRE Simplificado
Demonstrativo de Resultado por imóvel — cruza receitas (aluguel) com despesas (condomínio, IPTU, outras contas de despesa) para o período selecionado.
Receitas:
- Aluguel faturado — soma de
totaldas faturas do período (base competência) - Aluguel recebido — soma de
paidAmountdas faturas do período (base caixa)
Despesas:
- Agrupadas por tipo de despesa (Condomínio, IPTU, etc.)
- Incluem: contas de despesa confirmadas (
ApportionmentRule.calculatedAmount) + parcelas de imposto (TaxInstallment.amount) - Faturas Em edição e Canceladas são excluídas; contas de despesa Em edição e Canceladas são excluídas
Resultado:
- Resultado Apurado = Faturado − Despesas
- Resultado Caixa = Recebido − Despesas (positivo = lucro, negativo = prejuízo)
💡 Dica: Mês opcional — sem mês, consolida o exercício anual completo.
Extrato de Partilha
PDF e CSV com o detalhamento da partilha de aluguel por parceiro em um período.
Por linha: Imóvel, Competência, % Efetiva, Partilha Apurada (sobre o total faturado), Partilha Recebida (proporcional ao que o inquilino efetivamente pagou).
Resumo: Total Apurado × Total Recebido — diferença indica aluguel ainda pendente.
💡 Dica: Linhas com partilha excluída (quando o admin é o próprio ocupante do imóvel) aparecem no PDF em cor muted com indicação "(excluído)" e não entram nos totais. No CSV, a coluna "Excluído" e o "Motivo Exclusão" ficam preenchidos.
A Receber no Período
PDF (paisagem) e CSV com todas as faturas em aberto do período — status Aguardando pagamento ou Parcialmente pago.
Colunas: Inquilino, Imóvel, Competência, Vencimento, Total, Pago, Saldo, Status.
Rodapé com total geral do saldo a receber. Útil para gestão de fluxo de caixa e cobrança.
💡 Dica: Faturas Em edição e Canceladas são excluídas. Mês é opcional — sem mês, exibe todas as faturas pendentes do ano.
Relatório de Vacância
PDF e CSV com todos os imóveis que não possuem inquilino ativo no momento da geração.
Colunas: Imóvel, Endereço, Tipo, Status, Último Inquilino, Data de Saída, Dias Vago.
Dias acima de 30 aparecem em vermelho no PDF. Útil para acompanhar taxa de ocupação da carteira.
⚠️ O relatório reflete o estado atual — não tem filtro de período.
Extrato Completo do Inquilino
Histórico de todas as cobranças do inquilino, com multa, juros e saldo por competência. O ano é opcional — sem ano, exibe todo o histórico desde o início do contrato.
Colunas: Competência, Vencimento, Total, Pago, Multa, Juros, Saldo, Status.
Rodapé com totais de faturado, pago e saldo geral.
💡 Dica: Faturas Em edição são excluídas. Diferente do "Extrato de crédito/dívida", este relatório cobre cobranças de aluguel (não movimentações de crédito/débito manual).
Depósitos Ativos
PDF e CSV com todos os depósitos de garantia que possuem saldo pendente de devolução (valor depositado > valor devolvido).
Colunas: Inquilino, Imóvel, Depositado em, Valor Depositado, Devolvido, Saldo, Observações.
Rodapé com total de saldo em custódia. Depósitos com devolução integral não aparecem no relatório.
Despesas do Período
PDF em modo paisagem e CSV com todas as despesas confirmadas do período — cruza contas de despesa (ApportionmentRule) com parcelas de imposto (TaxInstallment).
Colunas:
- Tipo — categoria da despesa (Condomínio, IPTU, etc.)
- Imóvel — nome da unidade
- Descrição — nome da conta de despesa ou identificador do imposto
- Competência — mês/ano de referência
- Vencimento — data de vencimento
- Valor — valor confirmado
- Status Pagamento — Em aberto / Parcialmente pago / Pago
No CSV, a coluna extra Origem indica se a linha vem de uma "Conta de Despesa" ou "Imposto".
O rodapé do PDF exibe o total geral do período.
💡 Dica: Apenas registros com status Confirmada ou Aplicada são incluídos — rascunhos e cancelamentos são excluídos. Mês é opcional — sem mês, consolida todas as despesas do ano.
Relatório de Inadimplência
Mostra todas as faturas com status Aguardando pagamento ou Parcialmente pago cujo vencimento já passou.
PDF — tabela em modo paisagem com: Inquilino, Imóvel, Competência, Vencimento, Dias de Atraso (em vermelho quando > 30 dias), Total Devido. Rodapé com total geral inadimplente.
CSV — 9 colunas: Inquilino, Imóvel, Competência, Vencimento, Dias de Atraso, Total Original, Multa, Juros, Total Devido.
⚠️ O relatório reflete o estado atual da carteira — não tem filtro de período, pois mostra inadimplência ativa no momento da geração.