Cadastro de Perfil Fiscal
Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > Perfis Fiscais > "Novo Perfil" ou ícone Editar na linha Última atualização: 20/04/2026
Para que serve
Cria ou edita um perfil fiscal. O perfil é o agrupador principal da configuração tributária: a ele se vinculam Regras Fiscais (CFOP por cenário) e Configurações de Impostos (ICMS, IPI, PIS, COFINS, IBS, CBS). Uma Natureza de Operação pode indicar um perfil sugerido para o motor de cálculo fiscal.
Quem pode usar
Usuários com acesso ao módulo Fiscal.
Como usar (passo a passo)
Criação
- Na Lista de Perfis Fiscais, clique em Novo Perfil.
- Preencha descrição e tipo de operação (obrigatórios).
- Se necessário, informe as datas de vigência e observações.
- Clique em Cadastrar Perfil.
- O sistema navega para a tela de edição do registro recém-criado.
Edição
- Na lista, clique no ícone Editar (lápis) na linha do perfil.
- Altere os campos desejados.
- Clique em Salvar Alterações.
- O sistema recarrega os dados sem redirecionar.
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Exibido automaticamente (somente edição) | Sequencial por tenant, não editável |
| Status | Não | Ativo / Inativo | Padrão: Ativo |
| Descrição | Sim | Nome do perfil | Ex.: "Venda Simples Nacional SP" |
| Tipo Operação | Sim | VENDA / COMPRA / DEVOLUÇÃO / TRANSFERÊNCIA / REMESSA / RETORNO / IMPORTAÇÃO / EXPORTAÇÃO | Define a classificação do perfil |
| Vigência Início | Não | Data no formato DD/MM/AAAA | Data a partir da qual o perfil é válido |
| Vigência Fim | Não | Data no formato DD/MM/AAAA | Data até a qual o perfil é válido |
| Observações | Não | Texto livre | Anotação interna |
Validações e regras
- Descrição e Tipo Operação são obrigatórios.
- Datas de vigência são opcionais; quando informadas, permitem controle temporal da regra.
- Se houver alterações não salvas e o usuário tentar sair, o sistema exibe alerta de confirmação.
- Após salvar edição, os dados são recarregados da API sem redirecionar.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe a descrição" | Campo descrição vazio | Preencha a descrição |
| "Selecione o tipo" | Campo Tipo Operação vazio | Selecione um tipo |
| "Perfil fiscal atualizado com sucesso" | — | Confirmação de edição |
| "Perfil fiscal criado com sucesso" | — | Confirmação de criação |
| "Erro ao carregar perfil fiscal" | Falha ao buscar registro | Verifique a conectividade |
| "Erro ao salvar perfil fiscal" | — | Verifique os dados e tente novamente |
Integrações e dependências
- Após criar o perfil, vincule Regras Fiscais e Configurações de Impostos a ele.
- Pode ser associado a uma Natureza de Operação como perfil sugerido.
Dúvidas frequentes
Qual a diferença entre Perfil, Regra e Imposto? O Perfil é o container. A Regra define qual CFOP aplicar conforme o cenário (UF, tipo de cliente, NCM). O Imposto define as alíquotas de cada tributo. O motor de cálculo usa os três em conjunto.
Posso ter mais de um perfil para o mesmo tipo de operação? Sim. É comum ter perfis diferentes por regime tributário (ex.: Simples Nacional, Lucro Presumido) ou por UF de destino.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |