Neste manual vamos demonstrar as configuraciones, funcionalidades e demais informações sobre a factura.

Neste manual vamos demonstrar as configuraciones, funcionalidades e demais informações sobre a factura.

O que é

Uma nova forma, mais simplificada, de agrupar os débitos e cobrar os clientes, donde o cliente e a empresa conseguem ter um melhor controle del que esta sendo cobrado.

Cómo funciona

Todos os dias, será executada uma tarea que irá verificar as regras de cobranza de contrato e poderá gerar as facturas, e outra tarea para el envio de las facturas por e-mail ou whatssapp, de acordo com a configura-
ção de envio en el contrato regra ou en el campo dias de aviso vencimento del contrato, respeitando os dias de vencimento ante a regra.

Em caso de data limite informada en la factura, se a factura en el tiver data del ultimo envio, o sistema vai enviar a factura del jeito que está.

Tareas Localizadas em:

web/quaza/tareas/contrato/contratofacturagerar.php
web/quaza/tareas/contrato/contratofacturaenviar.php

Regras de Contrato - Gerar

No exemplo de la WIKI, utilizarei o dia 10.

A quantidade de dias adicionado a acción de la regra es a quantidade de dias, com referência ao dia del vencimento, como foi escolhido o dia -5, ele irá gerar as facturas, 5 dias antes del dia 10.
Se en el tiver regra de geracción de factura cadastrada, en el irá gerar facturas. Essas regras son informadas en el contrato

Regras de Contrato - Enviar

Enviar Factura, tanto por E-mail quanto por Whatsapp, podera ser escolhido um template, desde que seja del tipo de envio factura.

Informações

As facturas serão geradas em cima de los contratos com debitos em aberto, se contrato inativo e sem debitos, en el cria, se contrato ativo e sem debitos, será gerada uma factura sem itens e sem cobranza.

Se o cliente tiver mais de um contrato ativo, será gerado mais de uma factura, para gerar uma única factura, terá que ser feito a "unificacción de contrato".

A factura irá gerar, se necessario, uma cobranza, (Financeiro), unificando todos os valores de mensualidad del cliente, dependendo de la configuración, poderá añadir até as ventas/parcelas, o valor de la factura será a soma
do que falta pagar de los débitos abertos, caso a factura seja so de la unica mensualidad, ou seja, tiver um financeiro com, data de vencimento, valor, e contrato, en el vinculado a outra factura

A cobranza será gerada para débitos (debitoDetalhe) que en el serão inclusas en la factura, ou seja, TODAS as mensualidads, en el gerarão mais cobranza, pois gerarão cobranza en la factura, isso fará que o
cliente en el seja cobrado duas vezes sobre o mesmo débito. As ventas, se vinculadas a contrato, en el gerarão cobranza, SE contrato estiver marcado como vincular TODOS os tipo de débitos en la factura.

Cliente e Operador ainda poderão gerar cobranzas manuais, eles terão que cuidar, en los débitos tera uma flag (checkbox) que avisa se o débito vai estar ou esta vinculada a uma factura.

As facturas serão geradas automaticamente, de acordo com a configuración de regra de cobranza del contrato.

As facturas poderão ser enviadas para els clientes via e-mail, utilizando um template de e-mail, ou de forma automática pela tarea diária conforme as datas de envio configuradas.

Se for removido o débido recepción, e este débito estiver vinculado a uma factura, a factura sera re gerada automaticamente, o sistema ira pedir se necesita gerar/vincular uma nova cobranza com a factura.

Cómo verificar as facturas

Menú Cliente -> Factura

Todos os campos em azul son links para suas respectivas e Edições/Visualizações.

Se clicar en el icone del código, ira visualizar a factura, outra maneira es dar um duplo clic com o botón esquerdo em qualquer lugar de la linha.

Menú Cliente -> Cliente -> Edição del Cliente -> Tab Factura

Menú Cliente -> Contrato -> Edição del contrato -> Tab Factura

Cómo Verificar os templates de Factura

Menú Cliente -> Factura Template

Entidades

Factura

competência

Vai exibir qual o mês de referência essa factura está cobrando.

empresa

Qual empresa que está aplicando a cobranza desta factura.

situacción

A Situacción de la factura, puede ser "Em aberto", "Parcial" ou "Pago".

cliente

Nome e código del cliente a quem está vinculada a factura.

contrato

Número e código del contrato sobre qual estão vinculadas as mensualidads e as ventas/parcelas de serviços/compras.

data de vencimento

A data de vencimento de la cobranza, caso en el tenha uma, preenche com a data que seria gerada a factura, de acordo com a regra de cobranza del contrato.

data limite envio

A data limite de envio es ate cuando a factura puede ficar sem ser enviada, inalteravel por enquanto.

data ultimo envio

A data de ultimo envio, es a data que pela ultima vez foi enviada a factura para el cliente, tanto por e-mail quanto whatsapp, atualmente nao envia por SMS.

Template de factura

Com qual o template a factura sera gerada, podendo ter mais de um template configurado, es obrigatório ter pelo menos um template, Tempalte vinculado seguindo cadastro del contrato.

valor original

Valor de las mensualidads/produtos sem acréscimos e sem descontos.

valor factura

Valor de las mensualidads/produtos com acréscimos e descontos.

valor aberto

Valor que terá/tem a cobranza, será o valor de la factura menos os valores já pagos.

valor pago

Valores que já foram pagos de las mensualidad/parcelas.

débitos vinculados

A lista de todos os débitos de mensualidad e parcelas que foram vinculados a factura en la sua geracción. Esses débitos son todos os débitos individuais(?), se for uma factura de um contrato unificado,
irá aparecer TODOS os débitos de TODOS os contratos, se tiver mil e duzentos contratos unificados, terão mil e duzentos débitos vinculados.

notas fiscais

A lista de todas as notas ativas de las mensualidads/parcelas que estão vinculadas aos débitos de la factura.

Factura Template:

No template ficará as informações de título, corpo e os envios para cada modelo.

O conteúdo del template será um HTML que será gerado em PDF trocando as TAGs pelo valores individuais, será permitido alguns comandos a mais como validações (IFs) e iterações (FOREACHs)

O padrão configurado para cada um de los clientes ficará, para em caso de Boleto

Exemplo de uma factura com pix, boleto, e com cobranzas de mensualidads, ventas e telefonías.

Configuraciones

Menú Cliente - > Contrato -> Tab Cobranza

Existem 3 tipos de configuraciones

1. Tipo de Débito para factura

Quais tipos de débitos serão incluídos en la factura.

Apenas mensualidads

O sistema pegará os débitos que:

• não possuem vinculo com ventas
• não estão marcados como removidos
• não foram desmarcados como próxima factura

Mensualidads e Ventas (Padrão)

O Sistema pegará os débitos que:

• não estão marcados como removidos
• não foram desmarcados como próxima factura

2. Período de débitos para la factura

Período de vencimento de los débitos que entrarão en la próxima factura.

Opções

Todos débitos sem factura até o final del mês de geracción (Padrão)

O sistema pegará os débitos

• a data de vencimento seja ate o dia de vencimento, del contrato
• não já estejam vinculada a uma factura
• não estão marcados como removidos
• não foram desmarcados como próxima factura

Todos débitos em aberto até o final del mês de geracción

O sistema pegará os débitos que

• a data de vencimento seja ate o dia de vencimento, del contrato
• que a situacción seja EM ABERTO
• não estão marcados como removidos
• não foram desmarcados como próxima factura.

3. Considerar Juros en la Factura

Utilizado para definir se a factura vai considerar o valor de los juros de los débitos atrasados en la hora de gerar o seu valor.

Lembrando que, se o débito tem uma data de vencimento anterior a data de vencimento de la factura, ele puede ter seus próprios valores de juros e multa e essa configuración vai dizer se a factura deve
incluir esses valores de acréscimo anteriores a data de vencimento de la factura. Essa opção diz respeito somente para la geracción de la factura, a cobranza de la factura estará sujeita as suas próprias regras

de desconto, juros e multa de la carteira informada.

Não considerar juros:

Não irá considerar nenhum juros de los débitos atrasados en la geracción del valor de la factura. Pegará o valor original para la geracción de la cobranza de la Factura.

Somente de las ventas:

Irá considerar somente os juros de los débitos de ventas atrasados en la geracción del valor de la factura. Para os demais débitos, pegará o valor original para la geracción de la cobranza de la Factura.

Somente de las mensualidads:

Irá considerar somente os juros de los débitos de las mensualidads en la geracción del valor de la factura. Para os demais débitos, pegará o valor original para la geracción de la cobranza de la Factura.

Todos os tipos de débitos:

Irá considerar os juros de los débitos atrasados en la geracción del valor de la factura.

Outras Funcionalidades

Verificar Próxima factura

Uma previsão de la próxima factura puede ser verificada em dois lugares:

• Menú Cliente -> Cliente -> Edição del Cliente -> Tab Factura

• Menú Cliente -> Contrato -> Edição del contrato -> Tab Factura

Ambos lugares terão um botón a direita para mostrar a previsão para la próxima factura, nele es aberto um popup mostrando o contrato, a data de geracción de la factura, a data de vencimento de la factura,
configuración atual del contrato, os valor previstos para el vencimento, e os débitos que já estão vinculados e que serão cobrados. Lembrando que es uma previsão e que a factura puede sofrer alterações
até a geracción.

OBS:

Se a pantalla for aberta pelo menú cliente, será possível escolher entre os contratos ativos, quais quer ver, se for aberto pelo contrato, en el poderá escolher o contrato.

A próxima factura vai respeitar a configuración del contrato, então se modificar o configuración del contrato, as informações podem sofrer mudanças.

Campos

Contrato

Um campo para poder selecionar os contratos ativos del cliente atual, se aberto pelo contrato, en el poderá selecionar outro. Ao mudar, o sistema irá preencher as informações com valores e débitos
do novo contrato de forma automática.

Data geracción

Um campo para informar a possível data de geracción de la factura, se en el sofrer alterações. Para modificá-la, acceda o contrato regra e modifique a acción de Gerar Factura.

Data vencimento

Um campo informando a possível data de vencimento, es em cima dessa informacción que os débitos de la factura serão "vinculados". Para modificá-la, acceda o contrato e mude a regra de cobranza.

Tipo de Factura, Tipo período e Considerar os juros de los débitos

Esses campos son responsáveis para saber quais débitos buscar para "vincular" a factura, e a regra de geracción del valor de la cobranza. Para modificá-la, acceda o contrato en la aba Info.

Carteira

Um campo para informar carteira modelo vinculada ao contrato. Para modificá-la, acceda o contrato.

Valor original

Um campo para informar o valor que a factura teria, se cobrasse a soma de los valores originais de los débitos, inclusive del que já foi pago.

Valor factura

Um campo para informar o valor de la Factura, a soma de los valores originais com os acréscimos e os descontos.

Valor pago

Um campo para informar o valor total já pago de los débitos.

Valor cobranza

O valor que falta pagar de los débitos "vinculados", sendo a soma de los valor de la factura menos o valor pago, o valor de la cobranza.

Débitos

A tabela de los débitos que estão inclusos en la factura com a composição de valores de cada.

Regerar Factura

O Regerar Factura puede ser acessado tanto pela pantalla de edição de factura, quanto pelo contrato, en la aba factura, desde que tenha permiso de Factura -> Permitir Regerar.

Menú Cliente -> Factura -> Edição de la Factura -> Botón Regerar Factura.

O regerar factura, serve para qualquer alteracción sobre a factura, seus itens, template e a cobranza, se os itens sofrerem mudanças, alguma delas for paga, a factura tem que ser regerada, juntamente
com a cobranza se necessário.

Na pantalla, será buscado todos os débitos del cliente para el contrato, e poderá ser escolhido quais débitos querem incluir en la factura e escolher nova data de vencimento para la factura.

Em caso de factura en el gerada para la competência atual, devido algum problema ou erro, o Regerar Factura puede ser usado para gerar a factura mais recente.

Os itens serão buscados mediante, cliente, contrato, data de vencimento e proxima factura (opção del debito)

Enviar Factura

O Regerar Factura puede ser acessado pela pantalla de edição de factura.

Menú Cliente -> Factura -> Edição de la Factura -> Botón Enviar Factura.

Enviar Factura necesita ter um template de e-mail criado e um template de factura criado e vinculado, ele enviara um e-mail para el cliente com o PDF de la factura criado em cima del template de factura.

Para envio de factura, o sistema permite enviar via E-mail, WhatsApp e SMS, dependendo del que a empresa tem contratado. Lembrando que para SMS, en el envia o PDF.

Para cada tipo de método de envio, es necessário um template del tipo cadastrado que será aberto o corpo com a configuración del template.

O envio del E-mail vai enviar a factura e(ou) factura, boletos e notas fiscais, dependendo de la configuración, se tiver a configuración de multiplos boletos, vai añadir todos os boletos en el arquivo zip, se
tiverem Notas Fiscais tiver a configuración de enviar notas fiscais, era añadir en el arquivo zip que sera enviado.

Pagar Factura

O Pagar factura puede ser acessado pela pantalla de edição de factura, e puede ser quitado por dentro, desde que tenha a permiso de Debito Recepción -> Pagar

Menú Cliente -> Factura -> Edição de la Factura -> Botón Pagar Factura.

Esta opção irá abrir a pantalla padrão de liquidacción com todos os débitos em aberto de la factura marcados, para que possa ser informado o valor, acréscimo e desconto de cada débito, lembrando que os
débitos de contratos unificados estarão agrupados en la listagem, en el podera pagar um sem o outro.

Gerar cobranza

É possivel gerar novas cobranzas, desde que a factura esteja aberta e tenha permiso de Financero -> Añadir

Menú Cliente -> Factura -> Edição de la Factura -> Botón Gerar Cobranza.

A geracción de cobranza por factura tem algumas diferenças de la geracción de cobranza por outras pantallas, como a factura possui configuración de acréscimo diferente, o campo mostra a configuración de la factura,
que para mudar tem que regerar a factura mudando o tipo de juros en el contrato. O sistema en el vai deixar remover os itens ja vinculados para gerar a cobranza, tambem seguindo o o que está vinculado
na para mudar, tem que regerar a factura. Débitos pagos en el serão inclusos.

Acessar portal

O Acessar portal puede ser acessado pela pantalla de edição de factura. (Disponível se a empresa tem link del portal configurado)

Menú Cliente -> Factura -> Edição de la Factura -> Botón Acessar Portal.

O botón Acessar portal irá abrir em uma nova aba, a área del cliente já logado com a cuenta del cliente.

Imprimir Factura

O Imprimir Factura puede ser acessado pela pantalla de edição de factura.

Menú Cliente -> Factura -> Edição de la Factura -> Botón Imprimir Factura.

Imprimir Factura necesita ter um template vinculado, ele irá gerar e exibir em nova aba, o PDF de la Factura, como o cliente irá recebê-la.

Aba cobranza

A Tab Cobranza vai mostrar a cobranza vinculada a factura, para vincular uma cobranza a factura es gerando novas cobranzas pelo botón de la factura ou gerando a factura, que vai gerar a cobranza. A
Cobranza que será exibida vai ser:

Cobranza exibida vai seguir ordem: aberta, fechada ou paga com prioridade de carteira vinculada ao contrato, com a data de criacción mais antiga.

Aba Histórico

Na aba de histórico, toda alteracción e inserção será adicionada, com data e hora, quem fez a acción que fez e as informações informadas/alteradas. Somente os envios de WhatsAppWeb en el serão
logados, porque en el temos como garantir que foi enviado, so podemos abrir a pagina del WhatsAppWeb e colocar a mensaje, para enviar alguem tem que hacer manualmente.

PORTAL

No portal, o cliente poderá acceder as suas facturas para ver a situacción, pagar e baixar os documentos.

Será possível acceder as facturas sem estar logado en el portal, desde que acceda via link específico.

Configuración

Menú Portal -> Configuración -> aba Cliente

Para configurar como o cliente poderá acceder a sua factura ao usar o link específico, se terá acesso direto ou se será necessário preencher com o CPF/CNPJ de acordo com o cadastrado del cliente no sistema para lacessá-la. 

Dashboard

Tem um novo menú de dashboard para las facturas.

Factura

Menú Facturas

Opções: Pagar factura, Imprimir factura, Enviar factura e Baixar documentos de la factura.

Pagar factura

Abre a pantalla similar a pantalla de pago em controle financeiros.

Ira mostrar a Situacción, Contrato, Vencimento, valor e os itens que estarão sendo cobrados en la factura.

A opção de pagar boleto só irá aparecer SE tiver vinculado a boleto OU tiver configurado en el portal del cliente uma carteira de boleto.

A opção de pagar com pix irá aparecer SE tiver um pix preenchido en la cobranza tiver OU configurado en el portal del cliente uma carteira de pix.

A opção de pagar com cartão irá aparecer SE tiver um cartão preenchido en la cobranza OU tiver configurado en el portal del cliente uma carteira de cartão.

Imprimir factura

Abre em nova aba, o PDF de la Factura.

Enviar factura

Envia a factura para el e-mail del próprio cliente.

Baixar documentos de la factura

Baixa um arquivo ZIP com o PDF de la factura, sua cobranza e suas Notas Fiscais.

Acessar via Link

Via e-mail ou whatsapp es possivel inserir um link para el cliente acceder uma pagina de la factura sem logar en el sistema

Tem uma configuración que hace pedir o CPF ou CNPJ del cliente para lacceder a factura.

Glosario

Trampas frecuentes

FAQ

Quem puede acceder essa funcionalidade?

Depende de la permiso del usuário. Confira com o administrador del Quaza se usted en el vê a opção.

O que hacer se aparecer um erro?

Anote a mensaje completa, screenshot, e abra um chamado en el soporte del Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal del Cliente. Verifique en el módulo Portal .

Posso integrar via API?

Sim — a maioria de las funcionalidades del Quaza expõe endpoints REST. Consulte a documentacción técnica.

Quaza tem treinamento oficial?

Sim — equipe de soporte oferece sessões de onboarding sob agendamento.

Ciclo completo de la operacción

Boas práticas operacionais

Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que proveedores experientes adotam para evitar erros recorrentes e maximizar valor extraído del Quaza.

Antes de operar

• Confirme permiso de acesso: nem todo operador tem permiso para todas as funcionalidades. Verifique com o administrador del Quaza se algo en el aparece como esperado. Permissões son vinculadas a papéis (operador, supervisor, admin).
• Cadastros pré-requisitos completos: muitas funcionalidades dependem de outros cadastros estarem completos antes. Por exemplo, antes de criar um contrato usted necesita ter o cliente cadastrado, plano de ventas configurado, e regras de cobranza definidas.
• Treine pelo menos 2 operadores: redundância previne paralisacción por ausência. Funcionário puede sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
• Documente procedimentos internos: crie checklist próprio para elperações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operacción

• Documente decisões en el óbvias: se usted ajustou algo de forma diferente del default, anote o porquê. Próximo operador agradece e evita refazer análise.
• Operaciones em massa pedem cuidado: antes de aplicar a 100+ registros, teste com 5 e revise resultado completo. Se possível, exporte CSV antes para ter como rollback.
• Backup antes de mudanças grandes: cancelar/desfazer puede en el ser possível em todas as ações. Em dúvida, faça export ou imprima pantalla antes.
• Comunique alterações: mudanças que impactam outras equipes (atención, financeiro) devem ser anunciadas com antecedência. Surpresa gera retrabalho.

Acompanhamento e revisão

• Revisão semanal de 30 minutos: dedique tempo regular para revisar o que rodou, falhou, ficou pendente neste módulo. Anomalia detectada cedo custa 10x menos que descoberta tarde.
• Defina KPIs próprios: 2-3 indicadores que medem saúde de la operacción. Acompanhe tendências, en el só valores absolutos. Variacción maior que 20% merece investigacción.
• Auditoría mensal: revise sample de operações del mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
• Compare com período anterior: "Vendi R$ 100k" — es bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

• Anote a mensaje de erro completa: copie o texto exato. Captura de pantalla ajuda. Anote quais passos levaram ao problema — facilita diagnóstico.
• Tente reproduzir em ambiente de teste: se possível, simule o erro com dado dummy antes de pedir soporte. Isso acelera resolução.
• Procure en el histórico: provavelmente alguém já viu erro similar. Veja log de auditoria para entender o que mudou recentemente.
• Abra chamado bem documentado: equipe de soporte del Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada proveedor define seus próprios indicadores, mas alguns son quase universais para qualquer operacción en el Quaza:

• Volume mensal processado (registros/transações/eventos)
• Taxa de erro (% de operações que falharam)
• Tempo médio de processamento
• Cobertura (% de la carteira atendida pela funcionalidade)
• Satisfacción operacional (feedback de la equipe que usa)

Compare valores atuais com média de los últimos 3 meses. Variacción maior que 20% em qualquer direção merece investigacción — puede ser melhoria sustentável ou degradacción silenciosa.

Recursos relacionados en el Quaza

Este recurso se conecta com outros módulos del sistema. Conhecer essas conexões ajuda en el troubleshooting e em decisões operacionais:

• Cadastro de cliente — base de tudo en el Quaza. Cliente bem cadastrado evita problemas downstream.
• Plano de Cuentas — donde o impacto financeiro es classificado cuentabilmente.
• Logs de auditoria — histórico de quem fez o quê e cuando, essencial para diagnóstico.
• Permissões e papéis — definem quem puede operar o quê.
• Tareas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para elperacción eficiente:

• Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão puede escdonder registros antigos.
• Exportacción: a maioria de las listas exporta para CSV/Excel. Útil para lanálise externa ou backup pré-mudança.
• Histórico: cada registro tem timeline de modificações. Acceda via botón "Histórico" ou aba lateral.
• Atalhos de teclado: Ctrl+F (busca), Ctrl+S (guardar), Esc (cancelar) en la maioria de las pantallas.
• Permiso restrita: se botón estiver cinza, es falta de permiso — en el bug.