Central de Ajuda Quaza Provedores

Carnê (PT)

Carnê — Quaza

Carnê — geração e impressão em lote dos boletos de um cliente para o ano inteiro, entregues de uma só vez

Esta página cobre a tela Carnê do Quaza: o que é o carnê, como ligar o modo carnê, como rodar o processamento que junta os boletos de cada cliente num único PDF (o livro de boletos), como acompanhar o processamento, reimprimir, controlar quem está chegando ao fim do carnê e quem ainda não tem carnê gerado. Voltada para quem opera o financeiro do provedor de internet — atendentes, financeiro e quem está começando agora.

Nesta página:

Quando usar (e quando NÃO usar)

O carnê é o livro de boletos do cliente: em vez de mandar um boleto por mês, você imprime de uma vez todos os boletos do período (em geral o ano inteiro) e entrega ao cliente um bloco único. Cada folha do bloco é um boleto com seu próprio vencimento, que o cliente paga no banco, na lotérica ou pelo aplicativo. A tela Carnê não cria os boletos do zero — ela junta os boletos que já existem em aberto, dentro do período escolhido, e monta o PDF do livro.

Use o carnê quando…	NÃO é aqui — vá para…
Entregar ao cliente um bloco com todos os boletos do ano	—
Imprimir vários boletos juntos num PDF único por cliente	—
O cliente prefere boleto em papel e paga um por mês no banco	—
Conferir quais clientes ainda não têm o carnê do ano gerado	Verificar clientes sem carnê (na própria tela)
Reemitir a 2ª via de um único boleto	Cobrança
Mudar banco, multa, juros ou meio de pagamento	Regras de cobrança
Conectar uma maquininha/gateway que avisa o pagamento sozinho	Gateway bancário
Parcelar uma dívida já vencida do cliente	Renegociação

Carnê é boleto registrado, não cobrança avulsa. O processamento monta o livro apenas com boletos de carteiras de banco (boleto registrado). Boletos de carteira local (pagos no caixa do provedor) e cobranças de débito em conta não entram no carnê.

Passo a passo — do modo carnê ao livro impresso

Passo	Ação	Onde
1	Ligue o modo de operação Carnê. Em modo carnê, ao fechar o contrato o sistema já gera todos os boletos do ano de uma vez (em vez de um por mês).	Configurações → Financeiro
2	Tenha uma carteira de cobrança de boleto registrado. É o banco que recebe os pagamentos. Sem ela, não há boleto para juntar no carnê.	Financeiro → Carteira de cobrança
3	Os boletos do cliente já existem em aberto (gerados quando o contrato entrou em modo carnê). Confira na tela do cliente, na aba financeira.	automático ao ativar o contrato
4	Abra a tela Carnê e clique Processar carnês. Escolha a carteira, o período (data inicial e final) e, se quiser, filtre por cliente, cidade ou bairro.	Recebimento → Carnê → Processar carnês
5	Confirme o processamento em 2º plano. O sistema monta o PDF de cada cliente em segundo plano e, no fim, manda uma notificação. O processo aparece na listagem com estado Processando.	popup Processar carnês
6	Abra o processamento Concluído e baixe os arquivos: um PDF por cliente e um arquivo unificado com todos juntos, pronto para imprimir o bloco.	Recebimento → Carnê → [abrir o registro]
7	Imprima e entregue o livro ao cliente. Daí em diante o cliente paga uma folha por mês; a baixa de cada boleto pago acontece pelo retorno do banco, como qualquer boleto.	impressão / entrega manual

Filtrou por um cliente? Ao informar um cliente no popup, o sistema gera direto, sem pedir confirmação. Sem cliente, ele pergunta “Tem certeza que deseja processar todos os carnês?” antes de rodar para toda a base.

Como o carnê é montado

Como o carnê é montado e cobrado (raias: Você · Quaza · Banco/Cliente). Abaixo da linha pontilhada: o que acontece a cada mês, quando o cliente paga uma folha do bloco.

Leia o diagrama assim: o modo carnê faz o contrato gerar o ano inteiro de boletos de uma vez. O Processar carnês apenas junta esses boletos num PDF (o livro). Cada boleto continua sendo uma cobrança normal — quando o cliente paga uma folha, a baixa vem do retorno do banco, mês a mês.

Glossário

Termo	O que é
Carnê	O livro com vários boletos do mesmo cliente impressos juntos (em geral 12, um por mês), entregue de uma vez. Cada folha é um boleto individual com seu próprio vencimento e valor.
Boleto / parcela	Cada folha do carnê. É uma cobrança individual: tem vencimento, valor e linha digitável próprios. Em modo carnê, cada parcela é um boleto do mês.
Modo de operação Carnê	Configuração que faz o sistema gerar todos os boletos do período de uma vez quando o contrato é ativado, em vez de um por mês. O oposto é o modo Mensal.
Processamento (sequência carnê)	O registro de cada vez que você roda o “Processar carnês”. Guarda o período, os filtros usados, o estado, quantos contratos foram montados e os links dos PDFs gerados.
Arquivo por cliente	Um PDF separado com os boletos de um único cliente/contrato. Útil para enviar o carnê de um cliente específico.
Arquivo unificado	Um PDF que junta os carnês de todos os clientes do processamento, na ordem do nome. É o que você manda para a gráfica/impressora de uma vez.
Carteira de cobrança	A configuração que define o banco e o tipo de boleto. No carnê, só entram carteiras de boleto registrado em banco; carteira local e débito em conta ficam de fora.
Vencimento	A data limite de cada folha do carnê. As folhas vencem em meses seguidos (um por mês), com o mesmo dia base do contrato.
Linha digitável	A sequência de números impressa em cada boleto, que o cliente digita no banco ou no aplicativo para pagar aquela folha.
Aberto / pago	Cada boleto do carnê nasce Aberto. Quando o cliente paga, o retorno do banco dá a baixa e a folha vira Paga. O processamento só junta boletos que ainda estão Abertos no período.
Reprocessar	Mandar o sistema montar de novo o PDF de um processamento já feito (por exemplo, depois de corrigir algo). Roda outra vez em segundo plano.
Verificar clientes sem carnê	Relatório que lista os contratos ativos que ainda não têm o carnê do ano completo (menos boletos do que os meses esperados), para você gerar o que falta.

Configuração / pré-requisitos

Para gerar e imprimir um carnê, três coisas precisam estar prontas antes. Se o processamento não montar nenhum arquivo, é quase sempre porque falta um destes itens.

Modo de operação CarnêConfigurações → Financeiro

Defina o modo de operação financeiro como Carnê. Em modo carnê, ao ativar um contrato o sistema gera todos os boletos do período de uma vez (não um por mês). É esse conjunto de boletos que o “Processar carnês” depois junta no livro. No modo Mensal, o processamento de carnê só monta o que já estiver em aberto no período.

Carteira de boleto registradoFinanceiro → Carteira de cobrança

O carnê é montado a partir de boletos registrados em banco. Tenha uma carteira de cobrança de boleto habilitada (Sicredi, Sicoob, Banco do Brasil, Bradesco, Itaú e outros). Carteira local (pagamento no caixa) e débito em conta não entram no carnê. Veja Regras de cobrança .

Boletos do período já geradosCliente → aba financeira

O processamento só junta boletos que já existem em aberto dentro do período escolhido. Em modo carnê eles nascem quando o contrato é ativado. Se um cliente não tem boletos no período, ele simplesmente não entra no livro — confira pela Verificar clientes sem carnê .

Quer mandar o carnê por e-mail? O envio do carnê em PDF por e-mail usa um modelo de mensagem próprio (em Comunicação). Sem esse modelo configurado, o envio avisa que “o modelo não foi definido”.

Tela de Carnê — listagem e processamento

A tela de Carnê mostra o histórico de processamentos (cada vez que alguém rodou o “Processar carnês”) e é de onde você dispara um novo. Não há botão de adicionar manualmente: tudo nasce do botão Processar carnês.

Listagem de processamentos

Recebimento → Carnê

Lista os processamentos já feitos, do mais novo para o mais antigo. No canto superior direito fica o botão verde Processar carnês, que abre o popup para gerar um novo livro.

Tela Listar sequências carnê. No alto à direita, o botão verde Processar carnês abre o popup de geração. A lista traz as colunas Código, Estado, Cliente, Núm. de contratos, Criação, Criador e Empresa.

Coluna	O que mostra
Código	Número do processamento. Clique para abrir o detalhe e baixar os arquivos.
Estado	Processando, Concluído ou Falhado (ver Estados ).
Cliente	O cliente filtrado, quando o processamento foi feito para um cliente só. Em branco quando rodou para toda a base.
Núm. de contratos	Quantos contratos tiveram o carnê montado nesse processamento.
Criação / Criador	Quando o processamento foi disparado e por quem.
Empresa	A empresa do provedor que gerou o carnê (quando há mais de uma).

Recebimento → Carnê → Processar carnês

É onde você define o que entra no livro. Preencha os campos e clique Processar em 2º plano — o sistema monta os PDFs em segundo plano e avisa por notificação ao terminar.

Campo	O que é
Cobrança	A carteira de boleto registrado usada para montar os boletos. A lista já exclui carteiras local, débito em conta e gateway.
Empresa	Filtra os contratos de uma empresa do provedor (aparece quando há mais de uma).
Data inicial / Data final	O período do carnê (mês/ano). O sistema junta os boletos com vencimento entre o primeiro dia do mês inicial e o último dia do mês final.
Financeiro sequência	Filtra por um lote específico de geração (opcional). Deixe em zero para considerar todos.
Cidade / Bairro	Restringe a geração a clientes de uma cidade ou bairro (opcional).
Cliente	Gera o carnê de um único cliente. Quando preenchido, o sistema gera direto, sem pedir confirmação.

Só contratos ativos entram. O processamento considera apenas contratos com situação ativa (estado não-final). Contratos cancelados ou encerrados ficam de fora, mesmo que tenham boletos em aberto no período.

Estados do processamento

Estado	O que significa	Próxima ação possível
Processando	O sistema ainda está montando os PDFs em segundo plano. Em geração anual de muitos clientes, pode reiniciar sozinho em blocos para não estourar a memória.	Aguardar a notificação de término. Atualize a listagem para ver o estado mudar.
Concluído	Os PDFs foram montados. O detalhe traz os links dos arquivos por cliente e do arquivo unificado.	Abrir o detalhe e baixar os arquivos para imprimir/entregar.
Falhado	O processamento parou por erro (por exemplo, problema ao montar o boleto de um cliente). O detalhe mostra a mensagem em vermelho.	Corrigir o que o erro aponta e usar Reprocessar no detalhe.

Ações do carnê

Na listagem e no detalhe do processamento você tem poucas ações — o carnê é gerado e consultado, não editado folha a folha.

#	Botão	Onde aparece	O que faz
1	Processar carnês	Topo da listagem	Abre o popup para gerar um novo livro (escolher carteira, período e filtros).
2	Processar em 2º plano	Dentro do popup	Dispara a montagem dos PDFs em segundo plano. Ao terminar, envia uma notificação.
3	Reprocessar	Detalhe de um processamento que não está Processando	Manda montar de novo os PDFs daquele processamento, outra vez em segundo plano.

Onde estão os arquivos? Abra o registro do processamento (clicando no código): o campo Retorno lista os links para baixar o PDF de cada cliente e o(s) arquivo(s) unificado(s). O detalhe é só leitura — você não edita os boletos por aqui.

Verificar clientes sem carnê

Recebimento → Verificar clientes sem carnês

Esta tela ajuda a achar quem ficou sem carnê: lista os contratos ativos cujo número de boletos em aberto no ano é menor do que os meses esperados. É como você descobre, antes do cliente reclamar, quem precisa ter o carnê do ano gerado.

Tela Verificar clientes sem carnês: escolha o Ano e o Estado do contrato e clique Verificar. O resultado lista os contratos com carnê incompleto naquele ano. (Quando há mais de uma empresa, aparece também o filtro Empresa.)

Campo / botão	O que faz
Ano	O ano do carnê a conferir. A partir de julho, o sistema já sugere o ano seguinte.
Estado do contrato	Filtra por estado do contrato (por padrão, ativos).
Verificar	Roda a conferência e mostra a tabela de contratos com carnê incompleto.

O que conta como incompleto: o sistema espera 12 boletos no ano (um por mês). Para contratos ativados no meio do ano, ele desconta os meses já passados. Quem tem menos boletos que o esperado aparece na lista — é o sinal de que falta gerar/processar o carnê.

Tarefas automáticas

Parte do ciclo do carnê pode rodar sozinha, por tarefas que o sistema executa em horários definidos. As que tocam o carnê:

Tarefa	O que faz
Processar carnê	Monta os PDFs de um processamento em segundo plano (o mesmo que o botão “Processar carnês” dispara, manual ou automaticamente). Em geração anual, reinicia em blocos para não estourar a memória.
Envio carnê PDF	Gera o PDF do carnê de cada cliente e envia por e-mail, usando o modelo de mensagem de carnê. Útil para o carnê digital.
Alerta fim carnê	Avisa o financeiro quando um cliente em modo carnê está com apenas uma folha em aberto — ou seja, o carnê está acabando e é hora de gerar o do próximo período.

Quem liga ou desliga essas tarefas é o administrador do servidor (na agenda de tarefas do servidor, a crontab). A tela Admin → Tarefas apenas informa o status — o operador não liga/desliga por ali.

Pegadinhas frequentes

1. O carnê não cria boletos — ele junta os que existem. Se o processamento não montar nada para um cliente, é porque não há boletos em aberto dele no período. Confira o modo carnê do contrato e os boletos na tela do cliente.

2. Carteira local e débito em conta não entram. O carnê só monta boletos registrados em banco. Boleto local (caixa) e débito em conta são ignorados, mesmo se estiverem no período.

3. Só contratos ativos. Contratos cancelados ou encerrados não entram no processamento, mesmo com boletos em aberto. Reative o contrato antes, se for o caso.

4. Mudou o valor da mensalidade depois de imprimir? O papel já entregue tem o valor congelado. Os boletos seguintes precisam ser reemitidos com o novo valor; reimprima o carnê a partir dali.

5. Reprocessar não recria boleto pago. O processamento só junta boletos ainda Abertos. Folhas já pagas não voltam para o livro — o que sai é o que ainda falta o cliente pagar.

6. Vencimento em fim de semana ou feriado. Algumas folhas podem cair em dia sem expediente bancário. Confira o dia base de vencimento do contrato para evitar reclamação.

7. Processamento grande fica “Processando” por um tempo. A geração anual de muitos clientes roda em blocos e pode reiniciar sozinha. Não rode de novo achando que travou — espere a notificação de término.

8. Sem cliente no filtro, gera para todo mundo. Deixar o campo Cliente em branco processa a base inteira (com a pergunta de confirmação). Para um cliente só, informe o cliente no popup.

Perguntas frequentes

Qual a diferença entre carnê e cobrança avulsa?

A cobrança é um boleto/PIX individual. O carnê é o conjunto de vários boletos do cliente impressos juntos num PDF (o livro), entregue de uma vez. Cada folha do carnê continua sendo uma cobrança normal.

O carnê gera os boletos ou só imprime?

Ele só junta e imprime. Os boletos já existem em aberto (gerados quando o contrato entra em modo carnê). O “Processar carnês” reúne esses boletos no PDF do livro.

Quantas folhas tem um carnê?

Em geral 12 (um boleto por mês do ano). Depende do período que você escolher no popup e de quantos boletos o cliente tem em aberto nele.

Como ligo o modo carnê?

Em Configurações → Financeiro, defina o modo de operação como Carnê. A partir daí, ao ativar um contrato, o sistema gera o ano inteiro de boletos de uma vez.

Posso gerar o carnê de um cliente só?

Sim. No popup Processar carnês, informe o cliente. Aí o sistema gera direto, sem perguntar se quer rodar para todos.

Onde baixo o PDF do carnê depois de gerar?

Abra o processamento na listagem (clique no código). O campo Retorno traz os links: um PDF por cliente e o arquivo unificado com todos juntos.

O que é o arquivo unificado?

É um único PDF que junta os carnês de todos os clientes do processamento, na ordem do nome. É o ideal para mandar de uma vez para a gráfica ou impressora.

O cliente perdeu uma folha. Como reimprimo?

A folha é um boleto comum. Reemita a 2ª via dele pela tela de Cobrança , ou gere de novo o carnê do cliente pelo botão Processar carnês informando esse cliente.

O processamento ficou em “Processando” e não muda. E agora?

Geração de muitos clientes roda em blocos e reinicia sozinha. Aguarde a notificação de término e atualize a listagem. Se ficou Falhado, abra o detalhe para ver o erro e use Reprocessar.

O carnê inclui boleto pago no caixa (local)?

Não. O carnê só monta boletos registrados em banco. Boleto de carteira local e débito em conta não entram no livro.

Como sei quem ainda não tem carnê?

Use Recebimento → Verificar clientes sem carnês. Escolha o ano, clique Verificar e ele lista os contratos ativos com menos boletos do que os meses esperados.

Como o sistema me avisa que o carnê de um cliente está acabando?

Pela tarefa Alerta fim carnê: quando um cliente em modo carnê fica com só uma folha em aberto, o financeiro recebe um aviso para gerar o carnê do próximo período.

Posso enviar o carnê por e-mail em vez de imprimir?

Sim, como carnê digital. O envio do PDF por e-mail usa um modelo de mensagem próprio (em Comunicação); sem ele, o envio avisa que o modelo não foi definido.

Documentos relacionados

Cobrança — o boleto/PIX individual; cada folha do carnê é uma cobrança.
Regras de cobrança — carteiras de boleto, multa, juros e desconto que o carnê usa.
Gateway bancário — conexão com o banco para registrar e baixar os boletos.
Remessa / Retorno — como o banco confirma o pagamento de cada folha do carnê.
Renegociação — para parcelar dívidas já vencidas (não é caso de carnê).
Mensalidade — o débito recorrente que vira boleto do carnê.
Cliente — cadastro de quem recebe o carnê.