Módulo de Cobranças
O módulo de Cobranças é o centro de emissão de faturas da plataforma. Ele permite criar cobranças individuais ou em grupo, associadas a clientes, com suporte a múltiplos métodos de pagamento.
Acesso: Menu lateral → Cobranças (/cobrancas)
Listagem de Cobranças
A tela principal exibe todas as cobranças com as colunas:
| Coluna | Descrição |
|---|---|
| Código | Identificador único da cobrança |
| Cliente | Nome do cliente vinculado |
| Valor | Valor original da cobrança |
| Vencimento | Data de vencimento |
| Método | Pix, Boleto ou Cartão |
| Status | Pendente, Pago, Falhou, Estornado |
| Ações | Ver, Editar, Deletar, Notificar |
Filtros e Busca
Utilize os filtros disponíveis na barra superior:
- Status: Pendente, Pago, Falhou, Estornado, Contestado
- Método de pagamento: Pix, Boleto, Cartão
- Período: Data de criação ou vencimento
- Cliente: Busca por nome, CPF ou CNPJ
- Valor: Intervalo mínimo e máximo
Criar Nova Cobrança
Acesse /cobrancas/novo ou clique em Nova Cobrança:
Campos do Formulário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Cliente | ✅ Sim | Selecione um cliente cadastrado |
| Valor | ✅ Sim | Valor em reais (ex: 150,00) |
| Vencimento | ✅ Sim | Data limite para pagamento |
| Descrição | Não | Detalhamento da cobrança |
| Método de Pagamento | ✅ Sim | Pix, Boleto, Cartão ou múltiplos |
| Enviar por e-mail | Não | Envia notificação automática ao cliente |
| Plano de Parcelamento | Não | Quando habilitado, parcelamento via Cartão |
Métodos de Pagamento Disponíveis
| Método | Liquidação | Observação |
|---|---|---|
| Pix | D+0 (instantâneo) | Gera QR Code e código Copia e Cola |
| Boleto Bancário | D+1 | Gera PDF e linha digitável |
| Cartão de Crédito | D+30 | Requer integração com gateway |
Detalhes de uma Cobrança
Clique em qualquer cobrança para acessar /cobranca/:code/detalhes:
- Informações gerais — Valor, vencimento, método, status
- Dados do cliente — Nome, documento, e-mail
- Link de pagamento — URL pública da cobrança (
/cob/:code) - QR Code Pix — Imagem para pagamento direto
- Código de barras — Para cobranças via Boleto
- Histórico de eventos — Timeline de status (gerado, visualizado, pago)
- Ações disponíveis — Editar, Excluir, Notificar cliente
Notificar o Cliente
Para reenviar a cobrança ao cliente:
- Na listagem ou nos detalhes, clique em Notificar.
- O sistema enviará um e-mail com o link de pagamento para o e-mail cadastrado do cliente.
- Cobranças Pix incluem o QR Code diretamente no e-mail.
A notificação pode ser enviada manualmente a qualquer momento enquanto a cobrança estiver Pendente.
Editar uma Cobrança
É possível editar cobranças no status Pendente:
- Valor — Alteração do valor gera um novo QR Code/boleto.
- Vencimento — Pode ser prorrogado.
- Descrição — Texto de referência da cobrança.
Cobranças Pagas ou Estornadas não podem ser editadas.
Excluir uma Cobrança
- Na listagem, clique no ícone de exclusão (lixeira) ou acesse os detalhes e clique em Excluir.
- Confirme a ação no modal de confirmação.
Apenas cobranças no status Pendente podem ser excluídas. Cobranças pagas devem ser estornadas, não excluídas.
Grupos de Cobranças
O portal permite criar Grupos de Cobranças para organizar faturas recorrentes ou em lote:
- Acesse
/invoices_groupsvia API ou a seção dedicada no backoffice. - Grupos permitem vencer cobranças em massa e gerar relatórios consolidados por grupo.
Status das Cobranças
| Status | Descrição | Ação Recomendada |
|---|---|---|
| Pendente | Aguardando pagamento | Enviar lembrete ao cliente |
| Pago | Pagamento confirmado | Liberar produto/serviço |
| Falhou | Expirado ou recusado | Gerar nova cobrança |
| Estornado | Valor devolvido ao cliente | Verificar motivo |
| Contestado | Chargeback iniciado pelo banco | Contatar suporte FastGivr |
Exportar Cobranças
- Aplique os filtros desejados.
- Clique em Exportar → Selecione CSV ou PDF.
- O arquivo será gerado e disponibilizado para download.
O CSV inclui todas as colunas visíveis e pode ser importado em sistemas contábeis ou ERPs.
Regras de Negócio
- Toda cobrança deve ser associada a um cliente cadastrado.
- Cobranças com vencimento expirado passam automaticamente para status Falhou no dia seguinte.
- O link público (
/cob/:code) pode ser acessado sem login e exibe as opções de pagamento disponíveis. - Múltiplos métodos de pagamento podem ser habilitados para a mesma cobrança — o cliente escolhe na página pública.