Central de Ajuda Quaza Provedores

Contrato unificado — uma só fatura para vários contratos do mesmo cliente (PT)

Contrato unificado — uma só fatura para vários contratos do mesmo cliente — Quaza

Quando um mesmo cliente tem mais de um contrato (por exemplo, internet de casa e do escritório, ou várias unidades), você pode unificar a cobrança: em vez de o cliente receber uma fatura por contrato, todos os contratos passam a ser cobrados juntos em uma única fatura. Um dos contratos vira o contrato pai e agrega os débitos dos demais, os contratos filhos.

Audiência: equipe financeira e operadores de provedores que cobram seus clientes pelo Quaza. Esta wiki cobre a unificação em si — como montar, como o sistema gera a fatura única, como desfazer e os cuidados. Para a relação geral entre o contrato e a fatura (campos da aba Cobrança, débitos, regra), veja Contrato e Fatura .

Resumo de uma linha: você aponta a cobrança de um contrato para outro do mesmo cliente. A partir da data escolhida, o contrato filho deixa de gerar fatura própria e seus débitos entram na fatura do contrato pai — uma só fatura, um só boleto/PIX para o cliente.

O que é o contrato unificado

Por padrão, cada contrato gera a sua própria fatura, com seu próprio boleto/PIX. A unificação muda isso para um cliente específico: você diz que a cobrança de um contrato deve ser direcionada para outro contrato do mesmo cliente. O resultado é que o cliente passa a receber um único documento de cobrança juntando tudo.

Há três papéis possíveis para um contrato:

Papel Como se comporta na cobrança
Contrato individual Gera a sua própria fatura, agrupando apenas os seus débitos. É o comportamento padrão.
Contrato pai (recebe a unificação) Gera uma fatura que reúne os próprios débitos mais os débitos de todos os contratos filhos ligados a ele. É nele que mora a cobrança consolidada.
Contrato filho (unificado) Não gera fatura própria. Seus débitos vão para a fatura do contrato pai. Vários campos de cobrança ficam bloqueados nele.
Onde se configura. A unificação é definida no contrato filho: na aba Cobrança, o campo Cobrança unificada aponta para o contrato pai, e o campo Data de início da unificação diz a partir de quando vale. Você não mexe no contrato pai para unificar — ele apenas passa a receber os débitos.
Recurso opcional. A unificação só fica disponível se o provedor tiver ligado a opção Habilita unificação cobrança nas configurações gerais. Sem isso, o campo Cobrança unificada nem aparece no contrato.

Quando usar (e quando NÃO usar)

Use a unificação quando… NÃO use (ou não vai funcionar) quando…
O cliente tem vários contratos e quer pagar tudo num só boleto/PIX/fatura. Os contratos são de clientes diferentes — a unificação só agrupa contratos do mesmo cliente.
Você quer reduzir o número de cobranças que o cliente recebe por mês. Os contratos estão em moedas diferentes — o sistema bloqueia a unificação.
Os contratos compartilham a mesma forma de cobrar (mesma carteira/regra, mesma moeda). O contrato que você quer transformar em filho já é pai de outros (já tem contratos unificados a ele).
Faz sentido para o cliente ver uma cobrança única em vez de várias separadas. Você quer manter cobranças separadas por unidade/centro de custo do cliente — nesse caso deixe individuais.
Confirme em 5 segundos: se a sua dúvida é "como faço o cliente receber uma só fatura para os contratos dele?", esta é a wiki certa. Se é "o que cada campo da aba Cobrança faz?" ou "por que a fatura saiu vazia?", vá para Contrato e Fatura .

Glossário

Termo O que é
Contrato pai O contrato que recebe a unificação. Gera a fatura única, somando os próprios débitos aos dos contratos filhos.
Contrato filho (unificado) O contrato cuja cobrança foi direcionada para outro. Não gera fatura própria; seus débitos entram na fatura do pai.
Cobrança unificada Campo da aba Cobrança do contrato filho onde se escolhe o contrato pai. É o que liga um contrato ao outro.
Data de início da unificação Campo do contrato filho que define a partir de quando a unificação vale. Só os débitos a partir dessa data passam para o pai.
Fatura Documento que agrupa os débitos de um contrato numa competência, com vencimento e cobrança. No pai, agrupa os débitos dele e dos filhos.
Débito Cada valor a receber do cliente (mensalidade, venda, multa, juros). É o que a fatura reúne.
Cobrança O meio de pagamento gerado para a fatura (boleto, PIX, cartão). Na fatura unificada é uma só, cobrindo todos os débitos somados.
Marca "Adicionar na próxima Fatura?" Marca de cada débito que define se ele entra na próxima fatura. Vale igual para débitos do filho — sem ela, o débito não é faturado nem mesmo pelo pai.
Sufixo "(Unificado)" Texto que o sistema acrescenta ao número do contrato filho na listagem de contratos, para você identificar rapidamente quais estão unificados.

Configuração / pré-requisitos

Antes de unificar dois contratos, confira:

Recurso de unificação ligadoConfigurações → Configurações gerais

A opção Habilita unificação cobrança precisa estar ativada. Enquanto desligada, o campo Cobrança unificada não aparece no contrato e qualquer tentativa de unificar é recusada. A ativação é global (vale para todo o sistema).

Os dois contratos são do mesmo clienteCliente → Contrato

A unificação só agrupa contratos do mesmo cliente. Na hora de escolher o contrato pai, a lista já mostra apenas contratos ativos daquele cliente.

Mesma moeda nos dois contratosCliente → Contrato → aba Cobrança

O contrato filho e o contrato pai precisam estar na mesma moeda. Se forem diferentes, o sistema bloqueia ao salvar com uma mensagem de erro. (Se depois você mudar a moeda do pai, os filhos acompanham automaticamente.)

O contrato pai não pode ser, ele mesmo, um filhoCliente → Contrato

Você não pode encadear unificações: um contrato que já está unificado a outro não pode receber filhos. Da mesma forma, um contrato que já é pai não pode virar filho de um terceiro. A cadeia é sempre de um nível só (pai → filhos).

Passo a passo — criar a unificação

Roteiro mínimo para unificar a cobrança de dois contratos do mesmo cliente. Você sempre opera no contrato que vai virar filho.

Passo Ação Onde
1 Confirme que o recurso está ligado. Se o campo Cobrança unificada não aparecer no contrato, peça para o provedor ativar a opção Habilita unificação cobrança nas configurações gerais. Configurações → Configurações gerais
2 Abra o cliente e localize os dois contratos. Decida qual será o pai (o que vai concentrar a cobrança) e qual será o filho. Cliente → aba Contrato
3 Abra o contrato filho e vá até a aba Cobrança. Cliente → Contrato → aba Cobrança
4 Preencha o campo Cobrança unificada escolhendo o contrato pai. A lista traz só contratos ativos do mesmo cliente que ainda não são filhos. Aba Cobrança
5 Confira a Data de início da unificação. O sistema preenche com a data de hoje ao escolher o pai; ajuste se a unificação deve valer a partir de outra data. Aba Cobrança
6 Salve o contrato. O sistema valida (mesmo cliente, mesma moeda, não é o próprio contrato, recurso ligado) e, dando tudo certo, grava a unificação. Aba Cobrança
7 Confira. Ao reabrir o filho, vários campos de cobrança aparecem desabilitados, com um aviso indicando o contrato pai. Na listagem, o número do filho ganha o sufixo (Unificado). Cliente → Contrato
Pronto. A partir da data de início, a próxima fatura do contrato pai já vem com os débitos do filho somados. Não é preciso configurar nada no contrato pai — ele apenas passa a receber.

Fluxo geral — como a fatura única é gerada

Operador Quaza Cliente 1 Unifica no contrato filhoaponta o contrato pai + data 2 Tarefa diária rodae pula os contratos filhos 3 Processa o contrato paireúne débitos do pai + filhos 4 Fatura única criadacom todos os débitos somados 5 Uma só cobrançaboleto / PIX da fatura 6 Cliente recebe e pagauma fatura, um pagamento Ajuste manual (a qualquer momento): Desfazer a unificação Regerar a fatura do pai

Da unificação à fatura única: você liga o filho ao pai no contrato filho; a tarefa diária pula os filhos e processa o contrato pai, que reúne os débitos de todos e gera uma fatura única com uma só cobrança; o cliente recebe e paga uma vez. Desfazer e regerar são ações manuais.

Como o sistema monta a fatura unificada

A fatura única não é montada à mão. Ela é gerada pela mesma tarefa diária que gera as faturas dos demais contratos — só que, no caso de uma família de contratos unificados, ela trabalha assim:

Etapa O que o sistema faz
1. Pula os filhos A tarefa de geração ignora os contratos filhos (unificados). Eles não geram fatura própria.
2. Processa o pai Ao gerar a fatura do contrato pai, o sistema busca os débitos do próprio pai e de todos os contratos filhos ligados a ele.
3. Aplica os mesmos filtros Entram apenas os débitos marcados com Adicionar na próxima Fatura? e que batem com o tipo, o período e a data configurados no contrato pai (é a configuração do pai que manda).
4. Soma tudo numa fatura Todos os débitos qualificados (pai + filhos) viram itens da mesma fatura, com um valor total somado.
5. Gera uma cobrança única A fatura recebe um único boleto/PIX, cujo valor é a soma de todos os débitos. O cliente paga uma vez só.
Quem manda na fatura é o contrato pai. Tipo de débito (mensalidade ou mensalidade + vendas), período, consideração de juros e template são lidos da aba Cobrança do pai. Por isso esses campos ficam bloqueados no filho — ajustar lá não teria efeito.
Manual ou automático. A fatura única é gerada pela tarefa diária (automático) ou na hora, abrindo o contrato pai e usando Regerar fatura (manual). A geração manual segue exatamente as mesmas regras: reúne os débitos do pai e dos filhos. Veja o passo a passo de regerar em Fatura .

Cuidados ao alterar contratos unificados

Depois que um contrato vira filho, várias configurações dele deixam de ter efeito próprio e aparecem desabilitadas na tela, com um aviso indicando o contrato pai. Isso evita que você configure algo no filho achando que vale, quando na verdade quem comanda é o pai.

O que fica bloqueado no contrato filho. A regra de cobrança, a carteira/forma de cobrança, a moeda, as competências, os dados de débito em conta, a geração e o envio de nota fiscal, e os avisos de vencimento (e-mail, SMS, WhatsApp). Tudo isso passa a ser comandado pelo contrato pai. O aviso na tela do filho traz um atalho para abrir o contrato pai.
Quero mudar… Onde mexer
A forma de cobrar, a regra, o template, os juros ou o tipo de débito da fatura No contrato pai (a configuração dele vale para a família toda)
O valor/serviços de um contrato específico No próprio contrato (pai ou filho) — o valor de cada um continua sendo o dele; o que muda é só onde a cobrança cai
Quais débitos entram na próxima fatura Na aba Débito de cada contrato (a marca Adicionar na próxima Fatura? continua valendo por débito)
A relação de unificação (pai, data ou desfazer) No contrato filho, na aba Cobrança
O valor de cada contrato continua separado. Unificar não junta os planos nem os valores num só contrato. Cada contrato mantém seus serviços e seu valor; a unificação só faz a cobrança cair junto na fatura do pai.

Notas fiscais em contratos unificados

A unificação concentra a cobrança no contrato pai. As notas fiscais acompanham essa concentração:

  • A emissão e o envio de notas fiscais ficam desabilitados no contrato filho — a configuração de nota fiscal é comandada pelo contrato pai.
  • As tarefas automáticas de geração de nota fiscal pulam os contratos filhos, do mesmo modo que a geração de fatura.
  • A nota fiscal segue a fatura/cobrança consolidada do contrato pai, conforme as regras fiscais do provedor.
Confira a configuração fiscal no pai. Como a nota acompanha a cobrança do contrato pai, é nele que você revisa observações fiscais, modo de tributação e geração automática de nota. Ajustar isso no filho não tem efeito enquanto ele estiver unificado. Para entender a emissão por país, veja a wiki do documento fiscal correspondente.

Cobrança e pagamento

O ponto da unificação para o cliente é simples: uma fatura, um pagamento.

  • A fatura do contrato pai gera uma só cobrança (boleto, PIX ou cartão), com o valor somado de todos os débitos — do pai e dos filhos.
  • O cliente recebe e paga um único documento, em vez de um por contrato.
  • Os avisos de vencimento (e-mail, SMS, WhatsApp) também saem pelo contrato pai; as tarefas de aviso pulam os contratos filhos.
Onde acompanhar. Abra o contrato pai e vá até a aba Fatura: ela lista as faturas geradas, já com os débitos dos filhos incluídos. As ações da fatura (regerar, receber, enviar, imprimir) estão na wiki de Fatura . Para o boleto/PIX em si, veja Cobrança .
Procurando a fatura no contrato filho? Ela não está lá. O contrato filho não gera fatura própria — tudo aparece na aba Fatura do contrato pai.

Como desfazer a unificação

Para voltar atrás e fazer um contrato gerar a sua própria fatura de novo, basta remover o vínculo no contrato filho:

Passo Ação Onde
1 Abra o contrato filho e vá até a aba Cobrança. Cliente → Contrato → aba Cobrança
2 Limpe o campo Cobrança unificada (remova o contrato pai selecionado). Aba Cobrança
3 Salve. O contrato deixa de ser filho: os campos de cobrança voltam a ser editáveis e ele passa a gerar a própria fatura de novo. Aba Cobrança
Não dá para desfazer pelo lado do pai diretamente. A unificação é controlada no contrato filho. Se você abrir o contrato pai, vê o aviso de que ele tem filhos unificados (com um atalho para listá-los), mas a remoção do vínculo é feita em cada filho. Enquanto um contrato tiver filhos, o campo de unificação dele fica bloqueado (ele não pode virar filho de outro).
O que acontece com as faturas já geradas. Desfazer a unificação só muda a cobrança daqui para frente. As faturas já criadas com os débitos somados continuam como estão — para refazê-las, use Regerar fatura no contrato apropriado.

Pegadinhas frequentes

A fatura está no pai, não no filho. O erro mais comum é procurar a fatura do contrato unificado nele mesmo. O contrato filho não gera fatura própria — tudo cai na fatura do contrato pai.
Configurou no filho e não teve efeito? Regra de cobrança, juros, tipo de débito, template, moeda, competências, nota fiscal e avisos de vencimento são comandados pelo contrato pai. Esses campos ficam bloqueados no filho justamente porque mexer lá não muda nada.
Moedas diferentes não unificam. Se o contrato filho e o pai estiverem em moedas diferentes, o sistema recusa ao salvar. Acerte a moeda antes de unificar.
Não é o mesmo cliente? A unificação só agrupa contratos do mesmo cliente. Contratos de clientes diferentes não podem ser unificados.
Não dá para encadear. Um contrato que já é pai (tem filhos) não pode virar filho de outro, e um filho não pode receber filhos. A estrutura é sempre de um nível (pai → filhos).
O campo Cobrança unificada não aparece? O recurso vem desligado. Peça para o provedor ativar Habilita unificação cobrança nas configurações gerais.
Data de início no futuro. Os débitos do filho só passam para a fatura do pai a partir da Data de início da unificação. Se você definir uma data futura, antes dela a cobrança ainda segue separada.
Débito sem a marca não entra — nem no pai. A marca Adicionar na próxima Fatura? continua valendo por débito. Um débito do filho sem essa marca não aparece na fatura do pai.
Unificar não junta os planos. Cada contrato mantém seu valor e seus serviços. A unificação só faz a cobrança cair junto — não cria um contrato único.

Perguntas frequentes

O que é um contrato unificado?

É um contrato cuja cobrança foi direcionada para outro contrato do mesmo cliente (o contrato pai). Ele não gera fatura própria; seus débitos entram na fatura do pai, formando uma cobrança única.

Onde eu configuro a unificação?

No contrato filho, na aba Cobrança. O campo Cobrança unificada aponta o contrato pai e a Data de início da unificação diz a partir de quando vale. Você não mexe no contrato pai para unificar.

Posso unificar contratos de clientes diferentes?

Não. A unificação só agrupa contratos do mesmo cliente. A própria lista de seleção do contrato pai já mostra apenas contratos daquele cliente.

Os contratos precisam estar na mesma moeda?

Sim. O sistema bloqueia a unificação de contratos em moedas diferentes. Se você mudar a moeda do contrato pai depois, os filhos acompanham automaticamente.

Onde encontro a fatura de um contrato unificado?

Na aba Fatura do contrato pai. O contrato filho não gera fatura própria, então não adianta procurar nele.

Por que vários campos do contrato filho estão desabilitados?

Porque quem comanda a cobrança da família é o contrato pai. Regra de cobrança, carteira, moeda, competências, débito em conta, nota fiscal e avisos de vencimento são lidos do pai — por isso ficam bloqueados no filho, com um aviso e um atalho para o pai.

Como o cliente paga uma fatura unificada?

Com um único pagamento. A fatura do contrato pai gera uma só cobrança (boleto, PIX ou cartão) com o valor somado de todos os débitos — do pai e dos filhos.

Como desfaço a unificação?

Abra o contrato filho, vá à aba Cobrança, limpe o campo Cobrança unificada e salve. Ele volta a gerar a própria fatura. As faturas já geradas não mudam — só a cobrança daqui para frente.

Posso unificar mais de dois contratos?

Sim. Vários contratos filhos podem apontar para o mesmo contrato pai. O que não dá é encadear níveis: um pai não pode virar filho de outro, e um filho não pode ter filhos.

Como sei rápido quais contratos estão unificados?

Na listagem de contratos, o número do contrato filho aparece com o sufixo (Unificado) a partir da data de início. No contrato pai, há um aviso de que ele possui contratos unificados, com um atalho para listá-los.

A nota fiscal é emitida pelo filho ou pelo pai?

Pelo pai. A emissão e o envio de nota ficam desabilitados no filho, e as tarefas automáticas de nota pulam os contratos filhos. A nota acompanha a cobrança consolidada do contrato pai.

A unificação vale para faturas que já saíram?

Não retroage sozinha. A unificação passa a valer a partir da Data de início, para as próximas faturas. Para refazer uma fatura já gerada com os débitos consolidados, use Regerar fatura no contrato pai.

Documentos relacionados

  • Contrato e Fatura — como o contrato define a fatura (campos da aba Cobrança, débitos, regra). Base para entender o que cada contrato manda para a fatura.
  • Fatura — a tela da fatura: listagem, regerar, receber, enviar e template. É onde você acompanha a fatura única do contrato pai.
  • Cobrança — o boleto/PIX/cartão que a fatura unificada gera e que o cliente paga.
  • Regras de cobrança — quando o sistema gera e envia a fatura do contrato pai.
  • Mensalidade — o serviço recorrente que vira débito e entra na fatura.