Assinaturas / Cobranças

Cobranças Pagas: arquivo por arquivo

Consulta e manutenção das cobranças já pagas, com anexos e sincronização de cobrança PIX.

tela principal: pagas.php tela alternativa: cobrancas_pagas.php subpasta: /sistema/painel/paginas/cobrancas_pagas/ 7 arquivos/telas auditados pagas.php funciona como a tela usada no menu; cobrancas_pagas.php mantém lógica extra de conferência de pagamentos; listar.php filtra cobranças pagas em receber; arquivos.php sobe anexo; listar_arquivos.php exibe anexos; excluir-arquivo.php remove anexo; excluir.php apaga a cobrança e a conta vinculada.

tela

/sistema/painel/paginas/pagas.php

listar

presente

salvar

não encontrado

buscar

não encontrado

excluir

presente

Navegação rápida

Visão do módulo

pagas.php funciona como a tela usada no menu; cobrancas_pagas.php mantém lógica extra de conferência de pagamentos; listar.php filtra cobranças pagas em receber; arquivos.php sobe anexo; listar_arquivos.php exibe anexos; excluir-arquivo.php remove anexo; excluir.php apaga a cobrança e a conta vinculada.

Tela principal

/sistema/painel/paginas/pagas.php

Pasta operacional

/sistema/painel/paginas/cobrancas_pagas/

Arquivos auxiliares

2 arquivos além do núcleo listar/salvar/excluir.

Padrão observado

Possui tela alternativa/documentação dupla para a entrada principal.

Leitura recomendada: abra a tela principal, depois listar.php, o endpoint de gravação principal e por fim os auxiliares que completam a regra de negócio.

É um módulo com cara de financeiro, mas com forte acoplamento a cobrança recorrente, anexos e integrações.

Tabela resumida

Arquivo Tipo Papel no módulo Entradas POST Tabelas tocadas
pagas.php
/sistema/painel/paginas/pagas.php 		tela principal Tela usada no menu de cobranças pagas, com filtros e modais de dados/anexos. — formas_pgto
cobrancas_pagas.php
/sistema/painel/paginas/cobrancas_pagas.php 		tela principal Versão da tela principal que também consulta pagamentos PIX pendentes antes de renderizar. — formas_pgtoreceber
arquivos.php
/sistema/painel/paginas/cobrancas_pagas/arquivos.php 		auxiliar Faz upload de anexo para a cobrança e grava em arquivos. id_arquivonome_arq arquivos
excluir-arquivo.php
/sistema/painel/paginas/cobrancas_pagas/excluir-arquivo.php 		auxiliar Remove anexo físico e registro da tabela arquivos. idnome arquivos
excluir.php
/sistema/painel/paginas/cobrancas_pagas/excluir.php 		excluir Exclui a cobrança e a conta em receber, com chamada opcional à API externa. id cobrancasreceber
listar.php
/sistema/painel/paginas/cobrancas_pagas/listar.php 		listar Lista cobranças pagas por período usando a tabela receber como fonte principal. p1p2 clientescobrancasreceberusuarios
listar_arquivos.php
/sistema/painel/paginas/cobrancas_pagas/listar_arquivos.php 		auxiliar Lista anexos vinculados à cobrança para o modal de arquivos. id arquivos

Arquivo por arquivo

Cada card abaixo resume o papel do arquivo, volume aproximado de código, entradas esperadas e dependências visíveis para acelerar manutenção e depuração.

pagas.php

/sistema/painel/paginas/pagas.php
tela principal

Tela usada no menu de cobranças pagas, com filtros e modais de dados/anexos.

Linhas: 490
POST: sem POST explícito detectado
Sessão: sem leitura explícita de sessão
Tabelas: formas_pgto
Includes: sem include direto detectado

cobrancas_pagas.php

/sistema/painel/paginas/cobrancas_pagas.php
tela principal

Versão da tela principal que também consulta pagamentos PIX pendentes antes de renderizar.

Linhas: 497
POST: sem POST explícito detectado
Sessão: sem leitura explícita de sessão
Tabelas: formas_pgto, receber
Includes: pagamentos/consultar_pagamento.php

arquivos.php

/sistema/painel/paginas/cobrancas_pagas/arquivos.php
auxiliar

Faz upload de anexo para a cobrança e grava em arquivos.

Linhas: 45
POST: id_arquivo, nome_arq
Sessão: id
Tabelas: arquivos
Includes: ../../../conexao.php

excluir-arquivo.php

/sistema/painel/paginas/cobrancas_pagas/excluir-arquivo.php
auxiliar

Remove anexo físico e registro da tabela arquivos.

Linhas: 20
POST: id, nome
Sessão: sem leitura explícita de sessão
Tabelas: arquivos
Includes: ../../../conexao.php

excluir.php

/sistema/painel/paginas/cobrancas_pagas/excluir.php
excluir

Exclui a cobrança e a conta em receber, com chamada opcional à API externa.

Linhas: 25
POST: id
Sessão: sem leitura explícita de sessão
Tabelas: cobrancas, receber
Includes: ../../../../ajax/api-excluir.php, ../../../conexao.php

listar.php

/sistema/painel/paginas/cobrancas_pagas/listar.php
listar

Lista cobranças pagas por período usando a tabela receber como fonte principal.

Linhas: 183
POST: p1, p2
Sessão: id, nivel
Tabelas: clientes, cobrancas, receber, usuarios
Includes: ../../../conexao.php

listar_arquivos.php

/sistema/painel/paginas/cobrancas_pagas/listar_arquivos.php
auxiliar

Lista anexos vinculados à cobrança para o modal de arquivos.

Linhas: 130
POST: id
Sessão: sem leitura explícita de sessão
Tabelas: arquivos
Includes: ../../../conexao.php

Pontos de manutenção

  • Há duas telas principais muito parecidas: pagas.php e cobrancas_pagas.php. Ao corrigir a tela, compare as duas.
  • listar.php mistura cobrança e receber; diferença de resultado entre admin e usuário comum está nesse endpoint.
  • Fluxo de anexos fica todo na subpasta do módulo, não no módulo genérico de arquivos.
  • Excluir cobrança apaga também receber e pode disparar remoção via API externa.
Atalho de depuração: quando houver bug neste módulo, siga a ordem tela principal → listar/inserir/salvar → auxiliares → conexao.php → tabela.