Lista de Perfis Fiscais
Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > Perfis Fiscais Última atualização: 20/04/2026
Para que serve
Exibe todos os perfis fiscais cadastrados no tenant. Um perfil fiscal agrupa regras de CFOP e configurações de impostos (ICMS, IPI, PIS, COFINS, IBS, CBS) para um tipo de operação específico. É referenciado pelas Naturezas de Operação, Regras Fiscais e Impostos.
Quem pode usar
Usuários com acesso ao módulo Fiscal.
Como usar (passo a passo)
- Acesse Menu > Fiscal > Perfis Fiscais.
- Use o campo de busca para filtrar por descrição.
- Clique em Limpar para remover o filtro.
- Role a página para baixo para carregar mais registros (scroll infinito, 50 por vez).
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o Cadastro de Perfil Fiscal.
- Clique em Novo Perfil para criar um novo.
- Para remover, clique no ícone de lixeira e confirme.
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Buscar por descrição | Não | Texto livre | Filtra em tempo real |
| ID | — | Exibido automaticamente | Sequencial por tenant |
| Descrição | — | Nome do perfil | — |
| Tipo Operação | — | Ex.: VENDA, COMPRA, DEVOLUÇÃO… | Tag exibida na listagem |
| Regras | — | Quantidade de regras fiscais vinculadas | Contador |
| Impostos | — | Quantidade de configurações de impostos vinculadas | Contador |
| Status | — | Ativo / Inativo | Tag verde/cinza |
Validações e regras
- A exclusão é um soft delete (perfil é desativado).
- Um perfil em uso por naturezas de operação ou regras fiscais pode ser desativado, mas a exclusão pode ser bloqueada pelo backend. ⚠️ CONFIRMAR comportamento exato da API.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar perfis fiscais" | Falha na requisição à API | Verifique a conectividade e recarregue |
| "Erro ao remover perfil fiscal" | — | Verifique dependências (regras e impostos vinculados) |
| "Perfil fiscal removido com sucesso" | — | Confirmação de remoção |
Integrações e dependências
- Referenciado por Naturezas de Operação, Regras Fiscais e Impostos.
- Depende de
fiscalPerfisService.
Dúvidas frequentes
O que significa a coluna "Regras"? Indica quantas Regras Fiscais estão vinculadas ao perfil.
E a coluna "Impostos"? Indica quantas Configurações de Impostos estão vinculadas ao perfil.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |