Histórico da Página

CONTEÚDO

1. Visão Geral
2. Mapeamento das Tags do XML
3. Regra de negocio
   
4. Monitor - Alterações e Novos Recursos
5. Gerar Documento 
6. Dicionário de dados

01. VISÃO GERAL

Âncora
visao visao

A NT 2025.002, publicada no contexto da Reforma Tributária, institui as Notas de Crédito (finNFe = 5) e Notas de Débito (finNFe = 6) na NF-e/NFC-e.

Esses novos tipos de documento têm como finalidade formalizar ajustes tributários relacionados aos novos impostos IBS e CBS, permitindo registrar correções sobre operações fiscais já realizadas.

• • A Nota de Crédito (finNFe=5) representa uma redução no imposto devido, na ótica do emitente.
  • A Nota de Débito (finNFe=6) representa um acréscimo no imposto devido, na ótica do emitente.

Importante: Essas notas não substituem notas complementares ou de devolução do regime anterior (ICMS/IPI) e são exclusivas para ajustes relacionados ao IBS e à CBS.

02. Mapeamento das Tags

Âncora
mapeamento mapeamento

• finNFe

A tag finNFe recebeu duas novas opções conforme a NT 2025:

• • 5 – Crédito
  • 6 – Débito

O conteúdo dessa tag será gravado no campo já existente: DS_TIPO.

<finNFe>5</finNFe>  <!-- 5 = Crédito / 6 = Débito -->

• tpNFDebito

Para receber o conteúdo da tag tpNFDebito, foi criado o campo:
DS_TPCOMPL
(mais detalhes no tópico Dicionário de Dados).

• tpNFCredito

Assim como na tag anterior, o conteúdo de tpNFCredito também será gravado em:
DS_TPCOMPL.

<tpNFDebito>01</tpNFDebito>
<tpNFCredito>02</tpNFCredito>

      (Os tipos estão descritos na leitura obrigatória.)

• NFref

A tag NFref trará a chave da NF original, quando a referência for do documento como um todo.

<NFref>
    <refNFe>35191200000000000000000000000000000000000000</refNFe>
</NFref>

• DFeReferenciado

A tag DFeReferenciado trará a chave da NF referenciada por item, ou seja, quando a referência ocorre em nível de item da nota.

<det nItem="1">
    <DFeReferenciado>
        <chaveAcesso>35191200000000000000000000000000000000000000</chaveAcesso>
	    <nItem>1</nItem>
    </DFeReferenciado>
</det>

03. Regra de negócio

Âncora
regra regra

• Botão "Doc. Referenciado"
  

Para atender à NT 2025.002, foi implementado no documento de entrada o botão “Doc. Referenciado”, permitindo realizar o vínculo com a nota fiscal original no momento da inclusão.

Além disso, a mesma funcionalidade estará disponível pelo Monitor, facilitando ajustes pós-importação.

As informações do documento referenciado são gravadas na tabela DKN
(conforme descrito na seção Leitura Obrigatória).

• Importação via XML
  

  Ao importar uma nota de crédito ou débito, o sistema gravará automaticamente o registro correspondente na DKN, permitindo que a geração do documento pelo Monitor seja feita de forma simples e automática.

  A busca do documento original ocorrerá da seguinte forma:

  • Referência por NF (Total)
    
    

    • Quando a referência ocorrer no nível do documento:

    • A tag analisada será NFref / refNFe.

    • O sistema localizará a nota original na SF1 (cabeçalho de documento de entrada) pelo campo:

      Bloco de código
      language c#
      F1_CHVNFE

  • Referência por Item

    • Quando a referência ocorrer no nível de item, o posicionamento será feito assim:

      Bloco de código
      language xml title Cabeçalho
      F1_CHVNFE - > chaveAcesso SD1→ (D1_COD + D1_DOC +  D1_SERIE + D1_FORNECE + D1_LOJA + D1_ITXML) - >   <cProd> + F1_DOC + F1_SERIE + F1_FORNECE + F1_LOJA + <nItem>

      Bloco de código
      language xml title Itens
      SD1 → (D1_COD + D1_DOC + D1_SERIE + D1_FORNECE + D1_LOJA + D1_ITXML) = <cProd> + F1_DOC + F1_SERIE + F1_FORNECE + F1_LOJA + <nItem>

      Aviso
      title Importante
      Para referências por item, o sistema buscará utilizando o item XML original (nItem), garantindo que o vínculo seja feito exatamente com o item correto da NF de origem.

      Dica
      title Dica
      Caso MV_CSDXML esteja .F. e o Documento original tenha sido incluido sem informar o IT_XML, é possível realizar a inclusão posterior utilizando a rotina: COMA400 Desta forma o processo de importação gravará a DKN corretamente otimizando o processo.

04. Monitor - Alterações e Novos Recursos

Âncora
monitor monitor

Após a importação do XML, a visualização do documento no Monitor apresentará as seguintes alterações:

• Identificação do Tipo da Nota
  
  

  • Inclusão dos tipos 5 (Crédito) e 6 (Débito) no campo DS_TIPO.

  • Exibição automática do tipo conforme a leitura da tag finNFe.
    
    Image Added
    
    
    

• Novo Campo – DS_TPCOMPL

  • o campo DS_TPCOMPL, exibirá o tipo específico de crédito ou débito, conforme informado pelas tags:
    • tpNFDebito
    • tpNFCredito

               (Detalhes completos na seção Dicionário de Dados.)
Image Added

• Doc. Referenciado

  • Ao visualizar ou alterar o documento no Monitor, será exibido o botão: “Doc. Referenciado”. Esse botão permite:
    

    • Visualizar o documento fiscal de origem

    • Consultar vínculos por NF completa ou por item

    • Confirmar se o vínculo foi gravado corretamente na tabela DKN

Image Added

• Demonstração (GIF)

Verifique no GIF abaixo os ajustes citados:

Image Added
[Clique para expandir]

• Exemplos
  • NF de Crédito (Referência por NF Completa)
    
    Image Added

                     [Clique para expandir]

• • NF de Débito (Referência por Item)
    
    Image Added
    [Clique para expandir]
    

05. Gerar Documento

Âncora
doc doc

A geração do documento permanece igual ao funcionamento atual, exceto pelas novas validações descritas abaixo:

• Documento Classificado
  
  

  • Documento sem referência 

    • 
      

      Caso o sistema não localize o documento referenciado (NF completa ou item), ao tentar gerar um documento classificado será exibido o erro:

      Aviso
      title A103NDNC
      É necessário vincular documentos de origem para Notas do tipo Débito/Credito . "Utilize a opção 'Doc. Referenciado'.

  • TES inválida para Nota de Crédito/Débito

    • Caso seja informada uma TES que gere duplicata ou atualize estoque e o documento seja classificado, será apresentada a mensagem:

      Aviso
      title NCNDDUPLIC
      Para Nota de Crédito/Débito, é obrigatório selecionar uma TES configurada para não gerar duplicata e atualizar estoque." "Selecione outra TES ou cadastre uma nova - no cadastro de 'Tipo de entrada e saída' - com o campo 'Gera Dupl = N.' e 'Atualiza Estoque = N'

• Pré-Nota

  
  
  • O sistema realizará as mesmas validações acima no momento da classificação da pré-nota.
    Só será permitido ajustar o documento referenciado no momento da classificação caso:

    • a nota referenciada (DKN) não tenha sido gravada, ou

    • a nota referenciada seja inválida (ex.: item não localizado no documento referenciado).

    
     

• Documento gerado com sucesso

Caso o documento seja gerado sem inconsistências, será possível visualizá-lo normalmente no Documento de Entrada, incluindo a Nota Referenciada vinculada.
Image Added

• [Clique para expandir]

06. Dicionário de Dados

Âncora
dic dic

• Tabela DKN
  

  DKN - Documentos Referenciados
  INDICES:  1 = DKN_FILIAL+DKN_DOC+DKN_SERIE+DKN_CLIFOR+DKN_LOJA+DKN_DOCREF+DKN_SERREF+DKN_PARREF+DKN_LOJREF+DKN_ITNFRE+DKN_TPMOV  2 = DKN_FILIAL+DKN_DOC+DKN_SERIE+DKN_CLIFOR+DKN_LOJA+DKN_ITEMNF+DKN_TPMOV                                                                                            3 = DKN_FILIAL+DKN_DOC+DKN_SERIE+DKN_CLIFOR+DKN_LOJA+DKN_ORIGEM
  X2_UNICO:  DKN_FILIAL+DKN_DOC+DKN_SERIE+DKN_CLIFOR+DKN_LOJA+DKN_DOCREF+DKN_SERREF+DKN_PARREF+DKN_LOJREF+DKN_ITNFRE+DKN_TPMOV+DKN_ORIGEM
  Ordem	Campo	Tipo	Tamanho	Decimal	Valid	Usado	Relacao	Combo	Grupo de Campos
  1	DKN_FILIAL	C	8	0		sim			33
  2	DKN_TPMOV	C	1	0	Pertence("12")	sim	1	1=Entrada;2=Saida
  3	DKN_DOC	C	9	0		sim			18
  4	DKN_SERIE	C	3	0		sim			94
  5	DKN_CLIFOR	C	6	0		sim			1
  6	DKN_LOJA	C	2	0		sim			2
  7	DKN_DOCREF	C	9	0		sim			18
  8	DKN_ITEMNF	C	4	0		sim
  9	DKN_SERREF	C	3	0		sim			94
  10	DKN_PARREF	C	6	0		sim			1
  11	DKN_LOJREF	C	2	0		sim			2
  12	DKN_ITNFRE	C	4	0		sim
  13	DKN_CHVNFE	C	44	0		sim			183
  14	DKN_ORIGEM	C	10	0		sim

  
  
  

• Ajuste na campo DS_TIPO da tabela  SDS   
  

  X3_CBOX	N=Normal;O=Bonificação;D=Devolução;B=Beneficiamento;C=Complemento;T=Transporte;5=Credito;6=Debito
  X3_VALID	Pertence("NODBCT56")

  
  
  
  

• Criação do novo campo: DS_TPCOMPL, na tabela SDS. 
  

  Ordem	Campo	Tipo	Tamanho	Título	Descrição	Decimal	Usado
  56	DS_TPCOMPL	C	2	Tipo Compl.	Tipo de Complemento	0	sim

  
  
  

• Ajuste no indice 2 da tabela SD1:

  Indice	Ordem	Chave	Descrição
  SD1	2	D1_FILIAL+D1_COD+D1_DOC+D1_SERIE+D1_FORNECE+D1_LOJA+D1_ITXML+D1_ITEM	Produto + Documento + Serie + Forn/Cliente + Loja + Item XML + Item NF

  
  

  
  

• Ajuste no conteudo Default do parametro: MV_COMCOL2

  Parametro	Novo Conteúdo
  MV_COMCOL2	NDCOTB56