Processo: Importar NF-e de Débito e Crédito (Reforma Tributária)

O que é e para que serve

Este processo descreve como parametrizar o Sankhya Om e importar NF-e de Nota de Crédito (finNFe=5) e Nota de Débito (finNFe=6) emitidas sob a Reforma Tributária (LC 214/2025). O fluxo cobre duas etapas de configuração — cadastro do Tipo de Operação (TOP) com a finalidade e o subtipo corretos, e vinculação desse subtipo a uma TOP nas Preferências do Portal de Importação de XML — seguidas da importação do documento. Sem essa parametrização, o Sankhya Om bloqueia a importação de qualquer XML com finNFe=5 ou finNFe=6. Este processo não cobre a importação de NF-e com finalidades já existentes (Normal, Complementar, Ajuste e Devolução), cujo comportamento permanece inalterado.

Antes de começar

• Valide com a equipe fiscal a semântica de cada subtipo de tpNFCredito e tpNFDebito que a sua operação utiliza antes de criar as TOPs. Uma TOP configurada com o subtipo errado gera escrituração incorreta de IBS/CBS.
• Você precisará criar uma TOP separada para cada subtipo que sua operação emite ou recebe. Subtipos não cadastrados em nenhuma TOP não aparecem na grade de Preferências e bloqueiam a importação do documento correspondente.

Etapa 1 — Cadastrar a TOP com a nova finalidade e o subtipo

Acesse Comercial › Arquivo › Cadastros › Tipos de Operação - TOP e crie ou edite a TOP que será usada para o subtipo em questão.

Campos da finalidade de débito e crédito

• Finalidade da NF-e — selecione Import. Doc. Débito (Emissão Própria) para NF-e com finNFe=6, ou Import. Doc. Crédito (Emissão Própria) para NF-e com finNFe=5. Cada finalidade habilita exclusivamente o campo de subtipo correspondente.
• Tipo de Nota Fiscal de Débito — exibido quando a finalidade selecionada for "Import. Doc. Débito (Emissão Própria)". Selecione o subtipo de tpNFDebito correspondente ao documento que esta TOP cobrirá.
• Tipo de Nota Fiscal de Crédito — exibido quando a finalidade selecionada for "Import. Doc. Crédito (Emissão Própria)". Selecione o subtipo de tpNFCredito correspondente ao documento que esta TOP cobrirá.

Etapa 2 — Vincular subtipos a TOPs nas Preferências do Portal

Acesse Comercial › Rotinas › Portal de Importação de XML, abra Outras Opções › Preferências para importação de NF-e de Emissão Própria e localize a seção Notas de Débito e Crédito (Reforma Tributária).

Grade de parametrização

A grade lista automaticamente os subtipos já cadastrados nas TOPs criadas na Etapa 1, agrupados por natureza:

• Nota de Crédito — subtipos de tpNFCredito vinculados a TOPs com finalidade "Import. Doc. Crédito (Emissão Própria)".
• Nota de Débito — subtipos de tpNFDebito vinculados a TOPs com finalidade "Import. Doc. Débito (Emissão Própria)".

Para cada linha da grade, selecione a TOP correspondente na coluna Tipo de Operação. O seletor exibe apenas TOPs elegíveis para a natureza da linha: TOPs de crédito para linhas de finNFe=5 e TOPs de débito para linhas de finNFe=6.

Etapa 3 — Importar o XML no Portal

Com as etapas 1 e 2 concluídas, acesse Comercial › Rotinas › Portal de Importação de XML e importe normalmente o XML da NF-e de Débito ou Crédito.

Durante a importação, o Sankhya Om inspeciona o campo finNFe do XML. Para finNFe=5, consulta a grade com a chave (Nota de Crédito + subtipo de tpNFCredito) para resolver a TOP. Para finNFe=6, consulta com a chave (Nota de Débito + subtipo de tpNFDebito). A importação é concluída normalmente com a TOP configurada.

Pontos de atenção

• O comportamento de importação para NF-e com finNFe=1 (Normal), finNFe=2 (Complementar), finNFe=3 (Ajuste) e finNFe=4 (Devolução) permanece inalterado. Os campos fixos de Venda, Devolução de Venda, Compra, Devolução de Compra e Complemento nas Preferências também não foram alterados.
• Uma TOP com finalidade "Import. Doc. Débito (Emissão Própria)" só é elegível para seleção em linhas de finNFe=6 na grade. Uma TOP com finalidade "Import. Doc. Crédito (Emissão Própria)" só é elegível para linhas de finNFe=5. O seletor de Tipo de Operação aplica esse filtro automaticamente.
• A resolução de TOP na importação é feita por chave exata (finalidade + subtipo). Não há fallback para uma TOP genérica — cada subtipo precisa de sua própria linha configurada na grade.

Perguntas frequentes

A mensagem "Tipo de Operação não informado em Outras Opções > Preferências para importação de NF-e de Emissão Própria" continua aparecendo depois que configurei a grade. O que verifico?

Confirme que a TOP foi salva com a finalidade correta ("Import. Doc. Débito (Emissão Própria)" ou "Import. Doc. Crédito (Emissão Própria)") e com o subtipo preenchido. Em seguida, abra as Preferências e verifique se o subtipo do XML aparece na grade e se a coluna Tipo de Operação está preenchida para aquela linha. Se o subtipo não aparecer na grade, a TOP não foi salva corretamente — refaça o cadastro.

Preciso criar uma TOP para cada subtipo ou posso reutilizar a mesma TOP para vários subtipos?

Cada subtipo exige uma TOP própria. A grade vincula exatamente um subtipo a uma TOP por linha, e o campo de subtipo no cadastro de TOP aceita apenas um valor. Reutilizar a mesma TOP para subtipos diferentes não é possível pelo design da parametrização.

Um novo subtipo de tpNFDebito ou tpNFCredito foi publicado por uma NT. Preciso atualizar alguma tela?

Não. Basta cadastrar uma TOP com a nova finalidade e o novo subtipo. A grade de Preferências absorve a linha automaticamente sem necessidade de alteração de tela ou código.