Central de Ajuda Quaza Provedores

Cross-module — como Financeiro, Fiscal e Estoque conversam (integração transversal)

📸 Telas do sistema

As telas abaixo mostram como o sistema se apresenta em cada parte do fluxo descrito.

🔄 Os 4 Modos de Tributação — quando a nota é gerada

Esta é talvez a configuração cross-module mais importante. Define em que momento o sistema gera nota fiscal a partir de um débito do contrato:

Cada modo é executado por uma tarefa automática diferente:

↩️ Estorno de Pagamento — efeito cascata

Quando você estorna um pagamento (cliente pagou mas houve algum problema, devolveu, etc.), o sistema executa automaticamente:

1. Marca o débito de volta como "Em aberto".
2. Se o débito fazia parte de uma renegociação, reabre os débitos originais que tinham sido fechados pela renegociação.
3. Em modo "Por Recebimento", a nota fiscal já emitida pode ser cancelada (com Nota de Crédito) — depende da configuração.
4. O movimento bancário é estornado (entrada vira saída no caixa).
5. Histórico financeiro do cliente registra a operação.

🔁 Renegociação de Dívida — efeitos cross-module

Renegociar dívida é um processo que toca pelo menos 3 módulos:

🔧 Equipamento × Login Radius × Contrato — vinculação 3-way

Quando um cliente recebe um equipamento (ONU, modem, ATA), há vinculações em 3 módulos simultaneamente:

1. Estoque — equipamento sai do almoxarifado e fica vinculado ao cliente em modo Comodato.
2. Cliente/Contrato — o equipamento é referenciado no contrato (rastreável depois).
3. Rede (Radius) — o equipamento (com seu MAC) pode ser vinculado ao login Radius do cliente, controlando autorização de banda.

Esta vinculação é feita via cadastro Login → Equipamento na tela do contrato.

🛒 Venda + Estoque + NF — fluxo de uma venda com produto físico

Quando você vende um equipamento (não só serviço), a sequência cross-module é:

1. Operador cria venda com produto físico + valor.
2. Sistema gera débito financeiro a receber.
3. Conforme a categoria do produto, sistema gera nota fiscal apropriada (NFe modelo 55 para produto, NFSe pra serviço).
4. Se a venda está vinculada a uma Ordem de Serviço, o estoque só baixa quando a OS for fechada. Se não tem OS, baixa imediata na venda.
5. Se o produto é equipamento rastreável, o item específico (com serial) fica vinculado ao cliente.
6. Cliente paga → débito liquidado → caixa atualizado.

Em qualquer ponto, você pode consultar o histórico em: Histórico Financeiro , Estoque (Consolidado Individual), NFe .

📥 NF de Recebimento + Compra + Estoque + Pagamento — fluxo de entrada

Quando você recebe mercadoria de um fornecedor, o caminho é:

1. Operador cadastra NF de Recebimento (ou importa o XML).
2. Vincula a uma Compra (ou cria nova).
3. Marca a compra como "movimentada" → sistema dá entrada no estoque dos produtos.
4. Se há equipamentos rastreáveis, gera item individual com serial pra cada.
5. Sistema gera débito a pagar ao fornecedor (financeiro).
6. Quando você paga o fornecedor, o débito é liquidado e o caixa atualizado.

🔓 Reabrir débito ou cancelar nota — efeitos

Operações de "desfazer" são sempre delicadas. Como funciona:

🔀 Múltiplas Empresas Fiscais — cuidados

Algumas empresas operam com múltiplas pessoas jurídicas (matriz/filial) ou com modalidades distintas (NFCom para internet + NFSe pra serviços). Configurações importantes:

• Empresa fiscal padrão por tipo de nota (NFe, NFSe, SVA).
• Empresa fiscal por tipo de contrato — até 5 contratos diferentes podem ter empresas distintas.
• Categoria de produto aponta para empresa específica — útil quando produtos diferentes vão pra empresas diferentes.
• Mudar empresa fiscal de um contrato — não cancela NFs já emitidas com a empresa antiga; só vale para novas.

⏰ Tarefas crontab cross-module — quem dispara o quê

📋 Resumo das integrações importantes

📚 Documentos relacionados

• Fiscal — Visão Geral — modelos de nota disponíveis
• Configurações Fiscais — Cadastros Base — categoria, série, tributação
• Geração de Cobrança — fluxo financeiro
• Geração de Mensalidade — recorrência
• Vendas — cobrança avulsa
• Renegociação — fluxo de acordo
• Histórico Financeiro — auditoria
• NF Recebimento — fluxo de compra
• Estoque — Inventário e Movimentação
• Contrato — Núcleo — onde tudo começa

Glossário

Pegadinhas frequentes

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.