Cartões & Faturas
Controle completo de cartões de crédito, limites disponíveis, fechamento de faturas, parcelamentos e conciliação de compras.
✨ Engine RESTful PHP 8.2+ • CodeIgniter 4
Gateway de Serviços & API de Controle Financeiro
Infraestrutura central de alta performance para conciliação de faturas de cartões, gestão de fluxo de caixa mensal, listas de compras inteligentes com cotação de preços e controle de aluguéis.
Arquitetura de Serviços
Módulos Integrados da Aplicação
Módulos desacoplados construídos para garantir escalabilidade, integridade de dados financeiros e alta velocidade de resposta.
Fluxo Mensal & Despesas
Gestão de despesas fixas, variáveis, receitas, saldos acumulados e categorização por tipos de recursos e contas bancárias.
Compras & Cotações
Listas inteligentes com comparador de preços em múltiplos supermercados e seleção automatizada da cotação mais vantajosa.
Inquilinos & Aluguéis
Monitoramento de contratos de locação, controle de vencimentos, recebimento de pagamentos e histórico financeiro de imóveis.
Autenticação & JWT
Tokens de sessão seguros com padrão JSON Web Token (JWT), controle de ciclo de vida, expiração e isolamento multi-tenant por usuário.
Estoque & Metas
Módulos complementares para inventário patrimonial, planejamento de metas financeiras de curto/longo prazo e relatórios analíticos.
Referência Técnica
Explorador Interativo de Endpoints
Consulte as rotas disponíveis, payloads esperados e exemplos de integração prontos para uso.
POST
/login
Autentica credenciais e gera o Token JWT
Request Headers & Payload (JSON)
{
"email": "usuario@exemplo.com",
"password": "sua_senha_secreta"
}
Exemplo de Resposta (200 OK)
{
"status": 200,
"error": null,
"messages": { "success": "Autenticado com sucesso" },
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": { "id": "1", "nome": "Raul Brito", "email": "usuario@exemplo.com" }
}
GET
/api/mensal
Lista todos os meses de referência cadastrados
Header de Autorização Obrigatório
Authorization: Bearer {SEU_TOKEN_JWT}
Exemplo de Resposta (200 OK)
[
{
"id_mensal": "12",
"mes_mensal": "09",
"ano_mensal": "2026",
"status_mensal": "A",
"descricao_mensal": "Setembro / 2026"
}
]
POST
/api/itensmes/create
Cria novo lançamento de despesa ou receita
Payload da Despesa / Receita
{
"id_mensal": "12",
"descricao_itens_mes": "Assinatura Servidor Cloud",
"valor_itens_mes": "149.90",
"status_pag_itens_mes": "S",
"data_pag_itens_mes": "2026-09-03",
"tipo_itens_mes": "D",
"id_tipo_item_mes": "4"
}
GET
/api/cartao
Retorna a lista de cartões de crédito do usuário
Exemplo de Resposta
[
{
"id_cartao": "1",
"nome_cartao": "Nubank Ultravioleta",
"dia_fechamento_cartao": "25",
"dia_vencimento_cartao": "05",
"limite_cartao": "15000.00"
}
]
GET
/api/compras/listas
Obtém listas de compras com status e totais cotados
Exemplo de Resposta
[
{
"id_lista": "8",
"titulo": "Compras do Mês - Supermercado",
"status": "aberta",
"total_itens": 14,
"total_cotado": 428.50,
"created_at": "2026-09-01 10:00:00"
}
]
PUT
/api/compras/cotacoes/selecionar
Seleciona a melhor cotação de menor preço para o item
Payload
{
"id_item": "42",
"id_cotacao": "108"
}
GET
/api/inquilino
Listagem de inquilinos e contratos de aluguéis
Exemplo de Resposta
[
{
"id_inquilino": "3",
"nome_inquilino": "Carlos Eduardo Silva",
"valor_aluguel": "1850.00",
"dia_vencimento": "10",
"status_contrato": "ativo"
}
]
Infraestrutura Multi-Ambiente
Servidores & Ambientes Disponíveis
O backend detecta dinamicamente a origem da requisição e conecta ao banco de dados isolado correspondente.
🟢 Produção (PRD)
Ambiente Oficial
Banco de dados principal com alta redundância e segurança.
https://novocontrolefinanceiro.com.br/financas/
🟡 Homologação (HML)
Ambiente de Staging
Ambiente pré-produção para validações de novos módulos.
https://novocontrolefinanceiro.com.br/financas_hml/
🔵 Desenvolvimento (TST)
Testes & Localhost
Sandbox de desenvolvimento para novas features e testes unitários.
https://dev.bolsocontrolado.com.br/
🩺 Diagnóstico & Saúde do Gateway
Verifique o tempo de resposta do servidor em tempo real diretamente pelo seu navegador.
🟢 Resposta: 200 OK (28ms)