Contrato Unificado — cobrança consolidada de múltiplos contratos em fatura única
Cliente empresarial com vários contratos (internet + telefonia + TV + várias filiais) pode receber UMA fatura mensal consolidada em vez de várias. Contrato Unificado é o mecanismo que agrupa débitos de múltiplos contratos em fatura única, simplificando pagamento e gestão.
📸 Telas do sistema
As telas abaixo mostram como o sistema se apresenta em cada parte do fluxo descrito.
Visão consolidada da listagem — onde nascem todas as ações sobre contrato (criar, editar, ver histórico, suspender, cancelar).
O que é Contrato Unificado
É a funcionalidade que permite que vários contratos de um mesmo cliente (ou de clientes vinculados — ex: titular + dependentes) sejam cobrados juntos:
- Uma única fatura/boleto consolidado por mês
- Único valor a pagar (soma de todos os contratos)
- Único vencimento, único registro contábil
- Pagamento único quita todos os contratos do grupo
Quando usar (e quando NÃO usar)
| Cenário |
Recomendado? |
| Cliente com 2 contratos do mesmo serviço (residência principal + casa de praia) |
✅ Sim — unifica |
| Cliente empresarial com vários estabelecimentos |
✅ Sim — unifica |
| Cliente com contratos de tipos diferentes (internet + IPTV + telefonia) |
✅ Sim — unifica se quiser fatura única |
| Cliente quer faturas separadas para reembolso (uso pessoal vs. empresarial) |
❌ Não — manter separados |
| Contratos têm regras tributárias diferentes (NFSe vs. NFCom) |
⚠️ Cuidado — pode causar problema fiscal |
| Contratos têm fidelidades e datas de vencimento muito diferentes |
⚠️ Avaliar — unificação fixa um único vencimento |
Pré-requisitos
-
Configuração liberada — Em Admin → Configurações, ativar "Permitir unificar contratos".
-
Mesmo cliente titular — todos os contratos a unificar devem ter o mesmo titular (CPF/CNPJ).
-
Mesma moeda — contratos em moedas diferentes não podem ser unificados.
-
Mesma empresa fiscal — recomendado fortemente, para evitar conflito tributário.
Como criar contratos unificados
- Acesse o contrato que será o contrato principal (geralmente o mais antigo ou de maior valor).
- Em "Contratos relacionados", adicione os outros contratos do mesmo cliente.
- Sistema valida pré-requisitos e marca os contratos como unificados.
- A partir do próximo ciclo de cobrança, todos serão consolidados em uma fatura única.
Como o sistema gera a fatura unificada
No momento da geração mensal:
- Sistema busca todos os contratos do grupo unificado.
- Soma os valores mensais de cada um.
- Cria um único débito com o valor total no contrato principal.
- Os outros contratos do grupo recebem flag "valor zerado" (não geram débito próprio).
- Gera fatura/boleto único em nome do titular.
Detalhamento na fatura: apesar do valor total único, a fatura mostra discriminado por contrato (cada linha corresponde a um contrato + serviço). Cliente vê o "porquê" do valor.
Cuidados ao alterar contratos unificados
Alterar valor de um contrato do grupo
O sistema recalcula a soma e atualiza o débito principal abertto (sem NF). Comportamento idêntico ao contrato individual.
Mudar a moeda de um contrato
O sistema propaga a mudança para todos os contratos do grupo automaticamente — eles devem ficar todos na mesma moeda.
Cancelar um contrato do grupo
Apenas aquele contrato é cancelado; os demais continuam unificados. O valor mensal recalcula a partir do próximo ciclo.
Cancelar o contrato principal
Atenção: cancelar o contrato principal de um grupo unificado pode quebrar a consolidação. O sistema tenta promover automaticamente outro contrato como principal, mas é recomendado desfazer a unificação antes de cancelar o principal.
Adicionar/remover contrato do grupo
Pode ser feito a qualquer momento. Vale a partir do próximo ciclo de cobrança. Boletos abertos não são re-emitidos.
Notas fiscais em contratos unificados
Modo "Uma nota por contrato"
Cada contrato do grupo gera sua própria NF, mas o boleto é único. O cliente recebe múltiplas NFs e um boleto. Recomendado quando há regimes tributários distintos.
Modo "Nota única consolidada"
Uma única NF agrega todos os contratos. Configurável via "Habilitar múltiplas notas por contrato" (desativando) e configuração da empresa fiscal. Cuidado: só funciona se todos os contratos têm o mesmo modelo fiscal (todos NFSe, todos NFCom, etc.).
Cobrança e pagamento
| Cenário |
O que acontece |
| Cliente paga o boleto unificado |
Todos os contratos do grupo são quitados simultaneamente. |
| Cliente paga parcial |
Sistema rateia o valor pago entre os contratos do grupo proporcionalmente. |
| Atraso supera prazo de bloqueio |
Todos os contratos do grupo são bloqueados juntos. |
| Renegociação de dívida |
Renegociação é feita no contrato principal — vale para todo o grupo. |
Desfazer unificação
Para voltar contratos a serem cobrados separadamente:
- Acesse o contrato principal do grupo.
- Em "Contratos relacionados", remova o vínculo com cada contrato secundário.
- A partir do próximo ciclo, cada contrato volta a gerar fatura própria.
-
Boletos já gerados unificados não são desfeitos — só vale para novos.
PADRÃO OPERACIONAL — FLUXO COMUM
──────────────────────────────────
1. Cadastro inicial / configuração
│
▼
2. Permissões definidas por papel
│
▼
3. Operação normal:
┌──────────────────────────────────┐
│ - input do operador / cron │
│ - validação automática │
│ - persistência no banco │
│ - log de auditoria │
│ - notificação (se aplicável) │
└──────────────┬───────────────────┘
│
▼
4. Revisão / supervisão
│
┌──────┴──────┐
▼ ▼
OK normal Desvio detectado
│ │
▼ ▼
Histórico Ação corretiva +
alerta ao supervisor
Documentos relacionados
Resumo: contrato unificado é poderoso para clientes com múltiplos contratos, mas exige atenção a regras tributárias e ao impacto em alterações. Use quando o cliente quer fatura única e os contratos têm tributação compatível.
Glossário
| Termo |
Significado |
| Quaza |
Sistema ERP/BSS pra ISP — gestão integrada de cliente, financeiro, fiscal, técnico. |
| Contrato |
Vínculo formal entre cliente e empresa, define o que está sendo prestado. |
| Fatura |
Documento de cobrança gerado a partir do contrato. |
| Auditoria |
Revisão sistemática de registros para detectar inconsistências. |
| Permissão |
Direito de acesso/edição vinculado a papel ou usuário. |
| API REST |
Interface programática que permite integração com sistemas externos. |
| Cron / crontab |
Agendador de tarefas que roda em horários definidos. |
| Webhook |
Notificação automática que sistema externo recebe quando evento ocorre. |
| Centro de custo |
Dimensão transversal — filial, projeto, setor. |
| Conciliação |
Processo de garantir que extrato bancário bate com Quaza. |
Pegadinhas frequentes
1. Falta de validação pós-configuração. Cadastro feito sem teste real = pega o erro quando vai pra produção. Sempre teste com dado dummy antes.
2. Permissões mal definidas. Operador com acesso de admin = risco. Defina papéis claros.
3. Não treinar equipe nova. Funcionário novo opera no escuro, faz besteira por desconhecimento.
4. Mudar configuração sem registrar. Quem mudou, quando, por quê — perde-se rastro.
5. Ignorar alertas/notificações. Alerta que ninguém olha não serve.
6. Operações em massa sem dry-run. Antes de aplicar a 1000 registros, teste com 5.
FAQ
Como começar a usar este módulo?
Configure os pré-requisitos listados acima, faça um teste em ambiente seguro (ou com poucos registros), valide com a equipe, e só então ative em produção.
Preciso de permissão especial pra acessar?
Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com o administrador do Quaza.
Posso integrar com sistemas externos?
Via API REST do Quaza. Webhooks notificam eventos importantes. Consulte a equipe técnica para credenciais.
O que acontece se houver erro?
Os logs ficam no painel de tarefas/auditoria. Configure alertas (email/Slack) para falhas críticas — não confie em ninguém olhar log manualmente.
Como acompanhar mudanças?
Cada registro tem histórico (timestamp, usuário, ação). Use o filtro de auditoria pra rastrear modificações suspeitas.
O módulo funciona multi-filial?
Sim — via centro de custo (filial) atribuído ao lançamento. Relatórios filtram por filial.