Neste manual vamos explicar todas as configurações necessárias para utilização da Retenção Fiscal Em quais casos é utilizada a retenção fiscal: - Prefeituras; - Algumas empresas.
Neste manual vamos explicar todas as configurações necessárias para utilização da Retenção Fiscal
Em quais casos é utilizada a retenção fiscal:
- Prefeituras;
- Algumas empresas.
Configurações necessárias para utilização da Retenção Fiscal
1º. Verificar é se a natureza de operação necessária está cadastrada no sistema:
Acesse MENU > FISCAL > NATUREZA DE OPERAÇÃO, conforme segue a imagem
Você pode procurar através da pesquisa rápida (no campo superior direito, conforme sinalizado na imagem acima)
Se não houver a natureza necessária, será necessário cadastrar uma nova (clique em "Adicionar natureza de operação"), segue a imagem abaixo da tela de cadastro:
Conforme a imagem acima, as seguintes informações devem ser preenchidas:
Descrição - uma descrição para essa natureza;
Tipo - qual será o tipo da natureza (Entrada ou Saída);
Operação - qual operação essa natureza irá fazer (essa será a descrição da operação nas notas 55);
Configurações de CFOP - deve ser escolhido qual CFOP será para cada cada tipo de nota (Venda -> NFE 55 | SCM -> NFE 21/22 | SVA -> NFE SVA | ST -> NFE 55 com substituto tributário), em caso de dúvidas, verifique com seu consultor fiscal para ver quais são os CFOPs corretos.
2º. Cadastrar uma Categoria Fiscal ou verificar se alguma que já existe para o que você precisa, para isso vá em FISCAL->CATEGORIA FISCAL, conforme a imagem:
As categorias fiscais vão servir para você colocar nos produtos (exemplo: no produto "Provimento de acesso à internet" será colocado a categoria Teste), essas categorias indicam qual situação tributária irá ser aplicada para esse produto. Em resumo cada produto pode ter uma categoria fiscal, na qual vai indicar qual a situação tributária será aplicada para esse produto (se não estiver nenhuma categoria específica para algum produto, esse produto irá utilizar as situações padrões para tributação).
3º. Devemos configurar a situação tributária ou utilizar uma já existente, para isso vá em FISCAL-> SITUAÇÃO TRIBUTÁRIA, conforme a imagem:
Verifique se já há uma situação que corresponde ao que você precisa, se não houver você pode adicionar novas situações clicando em "Adicionar situação tributária".
Segue a imagem abaixo da tela de cadastro:
Aqui devem ser preenchidas as informações que constam na tela (muda de acordo com cada tipo de tributação), dando um foco principal:
Descrição - coloque uma descrição para fácil entendimento;
Tipo da tributação - podendo ser Icms, Pis/Cofins ou Ipi;
Situação Tributária (CST) - deve ser informado qual a situação tributária;
Aliquota Iss (pIss) [NO CASO DE Pis/Cofins] - aqui deve ser preenchido a porcentagem da aliquota Iss (ex: 4,8 será 4,8%).
Filtros: é onde você configura em quais situações será aplicada a situação tributária configurada acima (lembrando que há três situações tributárias padrões no sistema, onde não podem ser modificadas)
Cliente - informa se essa situação tributária irá pertencer a somente um cliente em específico;
Produto - informa se essa situação tributária irá pertencer a somente um produto em específico;
Tipo de pessoa - informa se essa situação tributária irá pertencer a somente um tipo de pessoa (física ou jurídica) em específico;
Contribuinte - informa se essa situação tributária irá pertencer a somente clientes/fornecedores que pertencem a um tipo de contribuinte (se contribui ou não) em específico;
Tipo de atividade - informa se essa situação tributária irá pertencer a somente clientes/fornecedores de um tipo de atividade em específico (caso for produtor rural, será possível informar a Inscrição Estadual no cadastro);
Categoria do produto - informa se essa situação tributária irá pertencer a somente um tipo de categoria de produto em específico;
Tipo de nota - informa se essa situação tributária irá pertencer a somente um tipo de nota em específico;
Série fiscal - informa se essa situação tributária irá pertencer a somente uma série fiscal em específico;
CFOP - informa se essa situação tributária irá pertencer a somente um CFOP em específico;
UF - informa se essa situação tributária irá pertencer a somente uma Unidade Federativa em específico;
Categoria fiscal - informa se essa situação tributária irá pertencer a somente um tipo de categoria fiscal em específico.
Destaca-se a Categoria fiscal, onde podemos colocar isso para todos os produtos com tal categoria terem uma determinada situação tributária (não sendo necessário sempre informar Pis/cofins, Icms e Ipi em cada produto que tem a mesma situação tributária);
4º. Utilização da Retenção Fiscal, verificar o cadastro do cliente:
Aqui temos algumas informações muito importantes:
Contribuinte - se o cliente/fornecedor é contribuinte (sim ou não);
Tipo de atividade - qual atividade o cliente/fornecedor;
Natureza da operação aplicável - qual será a natureza padrão para esse cliente/fornecedor (podendo ser alterado se for uma venda, por exemplo);
Retém ISS - informa se o cliente/fornecedor retém ou não o ISS. (Determina se este cliente vai ter ou não a Retenção Fiscal, ou seja o valor do ISS será retido na fonte ou o provedor que irá fazer o repasse)
Em caso de dúvidas ou problemas, não hesite em contatar nosso suporte. Estamos aqui para ajudar!
Agradecemos por utilizar nossa documentação!
Glossário
| Termo |
Significado |
| Quaza |
Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico. |
| Provedor |
Empresa que opera o sistema Quaza. |
| Cliente |
Assinante final do serviço de internet/telefonia/TV. |
| Contrato |
Vínculo formal entre cliente e provedor. |
| Operador |
Funcionário que opera o sistema. |
| Permissão |
Direito de acesso vinculado a papel. |
| Auditoria |
Registro de quem fez o quê e quando. |
| API REST |
Interface programática para integração externa. |
| Webhook |
Notificação automática para sistemas externos. |
| Cron / crontab |
Tarefa agendada que roda automaticamente. |
Pegadinhas frequentes
1. Permissões mal configuradas. Operador sem acesso ao módulo não consegue executar a ação descrita.
2. Dados faltando em pré-requisito. Esta tela depende de cadastros anteriores estarem completos.
3. Cache do navegador. Após mudança, force refresh (Ctrl+F5) se a tela não atualizar.
4. Operação irreversível. Algumas ações não podem ser desfeitas — confira antes de salvar.
5. Filtros ativos. Listas filtradas escondem registros — limpe filtros se faltar dado.
FAQ
Quem pode acessar essa funcionalidade?
Depende da permissão do usuário. Confira com o administrador do Quaza se você não vê a opção.
O que fazer se aparecer um erro?
Anote a mensagem completa, screenshot, e abra um chamado no suporte do Quaza com esses dados.
Esta funcionalidade tem versão para cliente final?
Algumas funcionalidades têm Portal do Cliente. Verifique no módulo Portal
.
Posso integrar via API?
Sim — a maioria das funcionalidades do Quaza expõe endpoints REST. Consulte a documentação técnica.
Quaza tem treinamento oficial?
Sim — equipe de suporte oferece sessões de onboarding sob agendamento.
Ciclo completo da operação
CICLO COMPLETO DE OPERAÇÃO QUAZA
─────────────────────────────────
┌──────────────────────────────────────────┐
│ 1. PREPARAÇÃO │
│ ───────────── │
│ - usuário com permissão correta │
│ - cadastros pré-requisitos prontos │
│ - integrações configuradas │
│ - equipe treinada nas operações │
└──────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────┐
│ 2. EXECUÇÃO │
│ ──────────── │
│ - input do operador, API ou cron │
│ - validação 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 do registro atualizado │
└──────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────┐
│ 4. ACOMPANHAMENTO │
│ ───────────────── │
│ - revisão periódica (semanal/mensal) │
│ - identificação de desvios e exceções │
│ - ajustes finos de configuração │
│ - treinamento contínuo da equipe │
└──────────────────────────────────────────┘
Boas práticas operacionais
Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que provedores experientes adotam para evitar erros recorrentes e maximizar valor extraído do Quaza.
Antes de operar
-
Confirme permissão de acesso: nem todo operador tem permissão para todas as funcionalidades. Verifique com o administrador do Quaza se algo não aparece como esperado. Permissões são 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 você precisa ter o cliente cadastrado, plano de vendas configurado, e regras de cobrança definidas.
-
Treine pelo menos 2 operadores: redundância previne paralisação por ausência. Funcionário pode sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
-
Documente procedimentos internos: crie checklist próprio para operações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.
Durante a operação
-
Documente decisões não óbvias: se você ajustou algo de forma diferente do default, anote o porquê. Próximo operador agradece e evita refazer análise.
-
Operações 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 pode não ser possível em todas as ações. Em dúvida, faça export ou imprima tela antes.
-
Comunique alterações: mudanças que impactam outras equipes (atendimento, 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 da operação. Acompanhe tendências, não só valores absolutos. Variação maior que 20% merece investigação.
-
Auditoria mensal: revise sample de operações do mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
-
Compare com período anterior: "Vendi R$ 100k" — é bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.
Resolução de problemas
-
Anote a mensagem de erro completa: copie o texto exato. Captura de tela 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 suporte. Isso acelera resolução.
-
Procure no 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 suporte do Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.
Indicadores típicos a acompanhar
Cada provedor define seus próprios indicadores, mas alguns são quase universais para qualquer operação no Quaza:
- Volume mensal processado (registros/transações/eventos)
- Taxa de erro (% de operações que falharam)
- Tempo médio de processamento
- Cobertura (% da carteira atendida pela funcionalidade)
- Satisfação operacional (feedback da equipe que usa)
Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.
Recursos relacionados no Quaza
Este recurso se conecta com outros módulos do sistema. Conhecer essas conexões ajuda no troubleshooting e em decisões operacionais:
-
Cadastro de cliente — base de tudo no Quaza. Cliente bem cadastrado evita problemas downstream.
-
Plano de Contas — onde o impacto financeiro é classificado contabilmente.
-
Logs de auditoria — histórico de quem fez o quê e quando, essencial para diagnóstico.
-
Permissões e papéis — definem quem pode operar o quê.
-
Tarefas crontab — automações que tocam neste recurso periodicamente.
Referência rápida
Atalhos e shortcuts para operação eficiente:
-
Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão pode esconder registros antigos.
-
Exportação: a maioria das listas exporta para CSV/Excel. Útil para análise externa ou backup pré-mudança.
-
Histórico: cada registro tem timeline de modificações. Acesse via botão "Histórico" ou aba lateral.
-
Atalhos de teclado: Ctrl+F (busca), Ctrl+S (salvar), Esc (cancelar) na maioria das telas.
-
Permissão restrita: se botão estiver cinza, é falta de permissão — não bug.