Cadastro de Natureza de Operação
Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > Naturezas de Operação > "Nova Natureza" ou ícone Editar na linha Última atualização: 20/04/2026
Para que serve
Cria ou edita uma natureza de operação. A natureza define o texto do campo natOp da NF-e e controla o comportamento do documento no ERP: qual CFOP usar por padrão, se movimenta estoque, se gera financeiro, qual perfil fiscal associar e qual texto sugerir nas observações da nota.
Quem pode usar
Usuários com acesso ao módulo Fiscal.
Como usar (passo a passo)
Criação
- Na Lista de Naturezas de Operação, clique em Nova Natureza.
- Preencha os campos da aba Geral (descrição e tipo são obrigatórios).
- Na aba Comportamento, configure as opções de estoque, financeiro e CFOPs padrão.
- Na aba Fiscal, associe um perfil fiscal sugerido e, opcionalmente, observações padrão.
- Clique em Cadastrar Natureza.
- Após salvar, o sistema navega automaticamente para a tela de edição do registro recém-criado (URL com o ID).
Edição
- Na lista, clique no ícone Editar (lápis) na linha da natureza.
- Altere os campos desejados em qualquer aba.
- Clique em Salvar Alterações.
- O sistema recarrega os dados da API e mantém o usuário na tela.
Campos da tela
Aba Geral
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Exibido automaticamente (somente edição) | Sequencial por tenant, não editável |
| Código | — | Exibido automaticamente (somente edição) | Gerado automaticamente como NAT<id_interno> se vazio no cadastro |
| Status | Não | Ativo / Inativo | Padrão: Ativo |
| Descrição (natOp) | Sim | Texto da natureza de operação | Máximo 60 caracteres (limite SEFAZ); vai literalmente no XML da NF-e |
| Tipo | Sim | Saída / Entrada | Padrão: Saída |
| Finalidade NF-e | Sim | Normal / Complementar / Ajuste / Devolução | Padrão: Normal |
| Modelo de documento | Sim | Ambos (NF-e e NFC-e) / NF-e (modelo 55) / NFC-e (modelo 65) | Padrão: Ambos |
| Consumidor final (padrão) | Não | Sim / Não / Não definir | Deixe em branco para permitir override no pedido |
| Presença do comprador | Não | 0 a 9 conforme tabela SEFAZ | Não definir deixa o sistema herdar do pedido |
Aba Comportamento
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Movimenta estoque | Não | Sim / Não | Padrão: Sim |
| Sentido do estoque | Não | Saída do estoque / Entrada no estoque / Sem movimentação | Padrão: Saída |
| Gera financeiro | Não | Sim / Não | Padrão: Sim |
| Gera duplicata | Não | Sim / Não | Padrão: Sim |
| Atualiza custo do produto | Não | Sim / Não | Padrão: Não |
| CFOP dentro da UF | Não | 4 dígitos | Ex.: 5102. Usado como fallback quando nenhuma regra fiscal casar |
| CFOP fora da UF | Não | 4 dígitos | Ex.: 6102 |
| CFOP exterior | Não | 4 dígitos | Ex.: 7102 |
Aba Fiscal
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Perfil fiscal sugerido | Não | Selecione um Perfil Fiscal | Perfil padrão usado pelo motor de cálculo de impostos quando esta natureza for selecionada |
| Observações padrão | Não | Texto livre | Sugerido no campo infCpl da NF-e |
Validações e regras
- Descrição é obrigatória e limitada a 60 caracteres pela SEFAZ.
- CFOP aceita apenas 4 dígitos numéricos.
- Ao criar, o campo código é gerado automaticamente pelo backend com o prefixo
NAT+id_internose não informado. - Se houver alterações não salvas e o usuário tentar sair, o sistema exibe alerta de confirmação (hook
useUnsavedChanges). - Ao salvar uma edição, o sistema recarrega os dados da API (para refletir valores calculados pelo backend) sem redirecionar o usuário.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe a descrição" | Campo descrição vazio ao salvar | Preencha a descrição |
| "Máximo 60 caracteres (limite SEFAZ)" | Descrição com mais de 60 caracteres | Reduza o texto |
| "4 dígitos" | CFOP informado com formato inválido | Informe exatamente 4 dígitos numéricos |
| "Selecione o tipo" | Campo Tipo vazio | Selecione Saída ou Entrada |
| "Natureza de operação atualizada com sucesso" | — | Confirmação de edição |
| "Natureza de operação criada com sucesso" | — | Confirmação de criação |
| "Erro ao carregar natureza de operação" | Falha ao buscar registro na API | Verifique a conectividade |
| "Erro ao salvar natureza de operação" | — | Verifique os dados e tente novamente |
Integrações e dependências
- Carrega a lista de Perfis Fiscais ativos para o campo "Perfil fiscal sugerido".
- Depende de
naturezasOperacaoServiceefiscalPerfisService.
Dúvidas frequentes
O que acontece se eu deixar o código em branco? O backend gera automaticamente no formato NAT<id_interno> (ex.: NAT12) no momento da criação.
O que é o CFOP de fallback? É o CFOP aplicado pelo motor fiscal quando nenhuma regra fiscal casar com a operação. Para vendas dentro do estado, use o CFOP "dentro da UF"; para interestaduais, use o "fora da UF".
Posso usar a mesma natureza para NF-e e NFC-e? Sim, selecionando "Ambos" no campo Modelo de documento.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |