Central de Ajuda Quaza Provedores

O que es a factura e como configurar — Quaza (ES-PY)

O que es a factura e como configurar — Quaza — Quaza

O que es a Factura e como configurar O que es a Factura A factura es o documento que agrupa todos os débitos de um contrato del cliente em uma única cobranza.

O que es a Factura e como configurar

O que es a Factura

A factura es o documento que agrupa todos os débitos de um contrato del cliente em uma única cobranza. Pense nela como a cuenta mensal que o cliente recebe, reunindo mensualidads, ventas e parcelas em um só lugar.

A factura não puede ser criada manualmente. Ella es gerada automaticamente pelo sistema com base en las regras de cobranza configuradas en el contrato.


Dónde encontrar

Menú: Cliente > Contrato > Factura

Na listagem usted visualiza:

  • Código — Identificador único de la factura
  • Competência — Mês/ano de referência (ex: “Março de 2026”)
  • Cliente — Nome del cliente (clic para labrir o cadastro)
  • Contrato — Número del contrato (clic para labrir)
  • Valor Factura — Valor total
  • Data envio — Cuándo a factura foi enviada pela última vez
  • Data limite de envio — Data máxima para envio automático
  • Situacción — Estado atual de la factura

Situações de la Factura

Situacción O que significa
Em aberto O cliente ainda en el realizou nenhum pago.
Pago parcial O cliente pagou parte del valor de la factura.
Pago Todos os débitos foram quitados. Factura finalizada.
Sem cobranza A factura foi gerada mas en el possui débitos vinculados.

Pantalla de Edição de la Factura

Ao clicar em uma factura en la listagem, usted acessa a pantalla de edição. Todos os campos son somente leitura.

Campo Descrição
Competência Mês/ano de referência de la factura
Empresa Empresa responsável
Situacción Estado atual (Em aberto, Parcial, Pago, Sem cobranza)
Cliente Cliente vinculado
Contrato Contrato vinculado
Vencimento Data de vencimento de la cobranza
Data limite de envio Data máxima para envio automático
Data último envio Cuándo foi enviada pela última vez
Template de factura Template usado para gerar o PDF
Valor Original Soma de los débitos antes de pagos e descontos
Valor Factura Valor total calculado de la factura
Valor Desconto Total de descontos aplicados
Valor Aberto Quanto falta pagar (Original - Pago - Desconto)
Valor Pago Quanto já foi pago

Aba “Cobranza”

Aparece somente cuando a factura possui cobranza vinculada (boleto, PIX, etc).

Campo Descrição
Forma de pago Carteira/modelo utilizado (ex: Boleto Sicredi, PIX)
Situacción de la cobranza Estado del boleto/PIX en el financeiro
Número Número de la cobranza
Nosso Número Identificacción bancária
Vencimento Data de vencimento de la cobranza
Valor Valor original de la cobranza
Data de pago Cuándo foi pago (se aplicável)
Valor pago Quanto foi pago
Código de barras Código de barras del boleto
Linha digitável Linha digitável del boleto
PIX QR Code para pago via PIX

Itens de la Factura

Abaixo de los valores, aparece a grade de itens mostrando cada débito que compõe a factura, e também as notas fiscais vinculadas.


Acciones disponíveis

Os botões de acción ficam en la lateral de la pantalla de edição. Alguns só aparecem dependendo de la situacción de la factura e de las suas permissões.

Enviar factura

Ícone: Envelope
O que faz: Envia a factura para el cliente pelo canal escolhido.
Canais:
  • E-mail — Envia com PDF de la factura em anexo. Pode incluir notas fiscais se configurado.
  • WhatsApp — Envia via integracción automática com WhatsApp.
  • WhatsApp Web — Abre o WhatsApp Web en el navegador para envio manual.
Requisito: O contrato necesita ter um template de factura configurado.

Passo a passo:

  1. Abra a factura desejada
  2. Clic en el botón “Enviar factura”
  3. Escolha o canal de envio (E-mail, WhatsApp ou WhatsApp Web)
  4. Confirme o envio
  5. O sistema registra a data de envio en el histórico de la factura

Regerar factura

Ícone: Factura (file-invoice-dollar)
O que faz: Recalcula a factura del zero: atualiza valores, refaz os itens e gera nova cobranza se necessário.
Cuándo usar:
  • Um débito foi adicionado ou removido después a geracción de la factura
  • O valor de algum débito mudou
  • Precisa gerar nova cobranza com valor atualizado
Requisitos: Factura não puede estar paga. Precisa de la permiso “Permitir regerar factura”.
[SCREENSHOT]
Print del popup de regeracción de factura
Atenção: Ao regerar, as cobranzas anteriores que tiverem valor ou vencimento diferente serão removidas e substituídas por novas. Certifique-se de que o cliente en el já pagou a cobranza antiga antes de regerar.

Receber factura (dar baixa)

Ícone: Dinheiro (money-bill-wave) — botón verde
O que faz: Registra o pago de la factura. Liquida as cobranzas e marca a factura como Pago.
Requisitos: Factura não puede estar paga. Precisa de la permiso “Pagar” en el módulo financeiro.
[SCREENSHOT]
Print del popup de pago mostrando os campos “Valor pago” e “Data de pago”.

Passo a passo:

  1. Abra a factura desejada
  2. Clic en el botón “Receber factura” (verde)
  3. Informe o valor pago
  4. Informe a data del pago
  5. Confirme
  6. O sistema liquida as cobranzas e atualiza a situacción para “Pago”

Gerar cobranza

Ícone: Código de barras (barcode) — botón vermelho
O que faz: Gera um novo boleto/cobranza para la factura. Útil cuando a cobranza anterior expirou ou foi cancelada.
Requisitos: Factura não puede estar paga. Precisa de la permiso “Añadir” en el módulo financeiro.

Verificar gateway

Ícone: Sync — botón vermelho
O que faz: Consulta o gateway de pago (banco/operadora) para verificar se houve pago ainda en el registrado en el sistema.
Cuándo usar: O cliente diz que pagou, mas a factura ainda aparece “Em aberto”.
Requisitos: A cobranza necesita ter integracción com gateway configurada en la carteira modelo.

Imprimir factura

Ícone: Impressora (print)
O que faz: Gera o PDF de la factura usando o template configurado e abre en el navegador. Usted puede guardar ou imprimir.
Requisitos: Sempre disponível.

Acessar portal del cliente

Ícone: Check
O que faz: Abre o portal del cliente em uma nova aba, en la visão del cliente. Útil para dar soporte.
Requisitos: O portal del cliente necesita estar habilitado en las configuraciones del sistema.

Links rápidos

Botón Abre
Ver Contrato O contrato vinculado à factura (nova aba)
Ver Cliente O cadastro del cliente (nova aba)
Ver Cobranza A cobranza financeira vinculada (nova aba)
Ver Template de Factura O template usado para gerar o PDF (nova aba)

Geracción automática de facturas

O sistema executa uma tarea agendada diária que gera as facturas automaticamente. Nenhuma acción manual es necessária se as regras estiverem configuradas corretamente.

Cómo funciona

  1. O sistema verifica todas as Regras de Cobranza que possuem a acción “Gerar Factura”
  2. Para cada regra, calcula se hoje es o dia correto para gerar, com base en el dia de referência
  3. Busca os contratos elegíveis:
    • Contrato usa essa regra de cobranza
    • Contrato não hace parte de cobranza unificada
    • Contrato não possui factura en la competência atual
    • Contrato possui pelo menos 1 débito marcado para próxima factura
  4. Para cada contrato, o sistema:
    • Junta os débitos pendentes
    • Calcula o valor total de la factura
    • Cria a factura com competência e vencimento
    • Gera a cobranza (boleto/PIX) automaticamente
Dica: O vencimento respeita dias úteis e feriados cuando a configuración de vencimento está definida como “Dia de la Semana”. Vencimentos que caem em feriados ou finais de semana son automaticamente movidos para el próximo dia útil.

Regras importantes sobre a geracción

  • Facturas son geradas por contrato. Sem contrato ativo, en el há geracción.
  • Se o contrato estiver ativo mas sem débitos, a factura en el es gerada.
  • Clientes com múltiplos contratos geram múltiplas facturas. Para unificar, configure a cobranza unificada en los contratos.
  • A factura gera uma cobranza (boleto) que unifica os valores de mensualidad, podendo incluir ventas e parcelas conforme configuración.
  • O valor es a soma del que falta pagar de los débitos em aberto.
  • Débitos já vinculados a outras cobranzas não geram cobranza duplicada.
  • Ventas vinculadas ao contrato não geram cobranza separada se o contrato estiver configurado para vincular todos os tipos de débitos en la factura.
[SCREENSHOT]
Print de la pantalla de Regra de Cobranza mostrando a acción “Gerar Factura” configurada com o dia de referência.

Envio automático de facturas

Outra tarea agendada diária cuida del envio automático de las facturas para els clientes.

Canais de envio

Canal Configuración en la Regra O que envia
E-mail Acción “Enviar Factura por E-mail” E-mail com PDF de la factura + notas fiscais (se configurado)
WhatsApp Acción “Enviar Factura por WhatsApp” Mensaje via WhatsApp com dados de la cobranza

Cómo funciona o envio

  1. O sistema verifica as regras de cobranza com acción de envio configurada
  2. Calcula se hoje es o dia correto com base en los dias antes del vencimento
  3. Busca as facturas de la competência correspdondente
  4. Envia pelo canal configurado
Envio de segurança: Se uma factura atingir a data limite de envio e nunca tiver sido enviada, o sistema tenta enviar automaticamente por todos os canais disponíveis como fallback.
Dias personalizados por contrato: É possível configurar dias de envio específicos en el próprio contrato (campos “Dias e-mail vencimento” e “Dias WhatsApp vencimento”), sobrescrevendo a regra geral. Aceita múltiplos dias separados por vírgula (ex: 5,3,1 para enviar 5, 3 e 1 dia antes del vencimento).
[SCREENSHOT]
Print de la pantalla de Regra de Cobranza mostrando as ações de envio por E-mail e WhatsApp configuradas.

Configuraciones del sistema

Configuración O que faz
Módulo de Facturas Habilita ou desabilita o módulo inteiro. Se desabilitado, nenhuma factura es gerada ou enviada.
Múltiplas cobranzas Permite que uma factura tenha mais de uma cobranza vinculada.
Vencimento em dia útil Move vencimentos que caem em fins de semana ou feriados para el próximo dia útil.
Enviar facturas pagas Se ativado, envia facturas mesmo que já estejam com status “Pago” ou “Sem cobranza”.
Portal del cliente Habilita o acesso del cliente ao portal donde puede ver suas facturas.

Permissões necessárias

Para acceder todas as funcionalidades de la factura, o grupo de usuário necesita ter as seguintes permissões:

Permiso Dónde configurar O que libera
Permitir regerar factura Contrato > Factura Botón “Regerar factura”
Pagar Financeiro > Débito Recepción Botón “Receber factura”
Añadir Financeiro Botón “Gerar cobranza”

Política de juros

Ao configurar o contrato, usted define como os juros de los débitos son considerados en la factura:

Opção Comportamento
Não considerar juros A factura es gerada sem juros, independente de atraso.
Somente de las ventas Calcula juros apenas sobre débitos del tipo “venda”.
Somente de las mensualidads Calcula juros apenas sobre débitos del tipo “mensualidad”.
Todos os tipos de débito Calcula juros sobre todos os débitos de la factura.

Tipo de período

Define quais débitos entram en la factura:

Opção Comportamento
Todos débitos sem factura até o mês de geracción Inclui todos os débitos que ainda en el foram vinculados a nenhuma factura.
Todos débitos em aberto até o mês de geracción Inclui todos os débitos em aberto, mesmo que já tenham sido facturados anteriormente.

Perguntas frequentes

Posso criar uma factura manualmente?
Não. A factura es gerada automaticamente pela regra de cobranza. Para forçar uma nova factura, configure os débitos e aguarde a tarea ou use “Regerar” em uma factura existente.

O cliente pagou mas a factura ainda aparece “Em aberto”. O que faço?
Clic em “Verificar gateway” para consultar o banco. Se o pago for confirmado, o sistema atualiza automaticamente. Caso contrário, use “Receber factura” para registrar a baixa manualmente.

Preciso mudar o valor de la factura. Como?
Ajuste os débitos en el contrato del cliente e depois clic em “Regerar factura”. O sistema recalcula tudo automaticamente.

A factura en el foi enviada para el cliente. Por quê?
Verifique:

  1. O contrato tem um template de factura configurado?
  2. A regra de cobranza tem acción de envio configurada?
  3. O cliente tem e-mail ou telefone WhatsApp cadastrado?
  4. A tarea de envio está rodando? Verifique en el log de tareas.

A factura apareceu com valor errado. O que aconteceu?
O valor de la factura es calculado com base en los débitos abertos del contrato. Verifique se todos os débitos estão corretos e, se necessário, regere a factura.

Posso enviar a factura mais de uma vez?
Sim. Abra a factura e clic em “Enviar factura” quantas vezes precisar. Cada envio es registrado en el histórico.

O que es a “competência”?
É o mês/ano de referência de la factura. Exemplo: uma factura com competência “Março de 2026” se refere aos débitos del mês de março. A competência puede ser adiantada conforme a configuración de “competência utilizada” del contrato.

Glosario

Término Significado
Quaza Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico.
Proveedor Empresa que opera o sistema Quaza.
Cliente Assinante final del serviço de internet/telefonía/TV.
Contrato Vínculo formal entre cliente e proveedor.
Operador Funcionário que opera o sistema.
Permiso Direito de acesso vinculado a papel.
Auditoría Registro de quem fez o quê e cuando.
API REST Interface programática para integracción externa.
Webhook Notificación automática para sistemas externos.
Cron / crontab Tarea agendada que roda automaticamente.

Trampas frecuentes

1. Permissões mal configuradas. Operador sem acesso ao módulo en el consegue executar a acción descrita.
2. Dados faltando em pré-requisito. Esta pantalla depende de cadastros anteriores estarem completos.
3. Cache del navegador. Después mudança, force refresh (Ctrl+F5) se a pantalla en el atualizar.
4. Operacción irreversível. Algumas ações en el podem ser desfeitas — confira antes de guardar.
5. Filtros ativos. Listas filtradas escdondem registros — limpe filtros se faltar dado.

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

CICLO COMPLETO DE OPERAÇÃO QUAZA ───────────────────────────────── ┌──────────────────────────────────────────┐ │ 1. PREPARAÇÃO │ │ ───────────── │ │ - usuário com permiso correta │ │ - cadastros pré-requisitos prontos │ │ - integrações configuradas │ │ - equipe treinada en las operações │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 2. EXECUÇÃO │ │ ──────────── │ │ - input del operador, API ou cron │ │ - validacción automática de dados │ │ - persistência transacional │ │ - log de auditoria com timestamp/user │ │ - notificações por email/Slack/webhook │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 3. EFEITOS COLATERAIS │ │ ────────────────────── │ │ - dashboards atualizados em tempo real │ │ - relatórios refletem nova mudança │ │ - webhook dispara sistemas externos │ │ - histórico del registro atualizado │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 4. ACOMPANHAMENTO │ │ ───────────────── │ │ - revisão periódica (semanal/mensal) │ │ - identificacción de desvios e exceções │ │ - ajustes finos de configuración │ │ - treinamento contínuo de la equipe │ └──────────────────────────────────────────┘

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.