Central de Ajuda Quaza Provedores

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

É a visão de "como tudo se encaixa": faturar gera lançamento financeiro (Recebimento) + emite documento fiscal (NFCom/NFe) + dá baixa em estoque (quando há equipamento). Leitura essencial pra entender o sistema como um todo.

📸 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

Glossário

Pegadinhas frequentes

FAQ

📚 Documentos relacionados

• 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