Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Visão Geral
  2. Mapeamento das Tags do XML
  3. Regra de negocio Validações
  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 referentes relacionados aos novos impostos IBS (Imposto sobre Bens e Serviços) e CBS (Contribuição sobre Bens e Serviços), aplicando , 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.

...

Aviso
titleImportante
  • Os fontes e dicionários referentes a esta implementação estarão disponíveis a partir da expedição contínua de   Dezembro/2025.
Aviso
titleleitura obrigatória

02. Mapeamento das Tags
Âncora
mapeamento
mapeamento


  • finNFe

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

...

Bloco de código
languagexml
titleDFeReferenciado (referência por item)
<det nItem="1">
    <DFeReferenciado>
        <chaveAcesso>35191200000000000000000000000000000000000000</chaveAcesso>
	    <nItem>1</nItem>
    </DFeReferenciado>
</det>


03. Regra de negócio

...

Âncora
regra
regra


Aviso
titleImportante

As  Notas de Crédito e Débito  devem, obrigatoriamente , referenciar o documento fiscal original  que deu origem ao ajuste.
Essa exigência foi introduzida pela  NT 2025.002 para garantir a rastreabilidade completa das operações e a , garantindo:

  • rastreabilidade completa do processo;

  • consistência das informações

fiscais 
  • nas apurações de IBS e CBS;

  • prevenção de duplicidade de fatos geradores;

  • redução de divergências fiscais entre documentos.

Ao vincular a nota Nota de crédito ou débito à nota Crédito ou Débito ao documento fiscal de origem, o sistema permite que os órgãos fiscais identifiquem de forma clara identificar claramente qual operação está sendo ajustada, evitando duplicidade de fatos geradores, inconsistências contábeis e divergências entre os documentos eletrônicos.preservando a coerência entre o documento original e o documento de ajuste.


  • 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:

...

  • Se a referencia for

    • Referência por NF

    , através da chave referenciada (refNFe) o sistema buscará os dados da nota na SF1 (Cabeçalho Documento
    • (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
        languagec#
        F1_CHVNFE
    • Referência por Item
      • Se a referencia for por Item,  posicionaremos na 

      04. TELA XXXXX

      Principais Campos e Parâmetros

      ...

      Card documentos
      InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
      TituloIMPORTANTE!

      ...

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

            Bloco de código
            languagexml
            titleCabeç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
            languagexml
            titleItens
            SD1 → (D1_COD + D1_DOC + D1_SERIE + D1_FORNECE + D1_LOJA + D1_ITXML) = <cProd> + F1_DOC + F1_SERIE + F1_FORNECE + F1_LOJA + <nItem>
            Aviso
            titleImportante

            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
            titleDica

            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
            titleA103NDNC

            É 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
            titleNCNDDUPLIC

            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]


      Aviso
      titleGeração automática de documento – Nota de Débito/Crédito

      Caso o parâmetro MV_COMCOL2 já exista na base de dados, ele não será atualizado automaticamente pelo processo de atualização, conforme previsto na documentação do Framework: Regras para atualização do dicionário SX6 - UPDDISTR e migrador de versão 
      Sendo assim, será necessário ajustar manualmente o conteúdo do parâmetro, conforme orientado no tópico 6-Dicionário de dados

      • Ajuste no conteudo Default do parametro: MV_COMCOL2

        ParametroNovo Conteúdo
        MV_COMCOL2NDCOTB56




      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  

        OrdemCampoTipoTamanhoDecimalValidUsadoRelacaoComboGrupo de Campos
        1DKN_FILIALC80
        sim  

        33
        2DKN_TPMOV C10Pertence("12")sim  11=Entrada;2=Saida   
        3DKN_DOC   C90
        sim  

        18
        4DKN_SERIE C30
        sim  

        94
        5DKN_CLIFORC60
        sim  

        1
        6DKN_LOJA  C20
        sim  

        2
        7DKN_DOCREFC90
        sim  

        18
        8DKN_ITEMNFC40
        sim  

           
        9DKN_SERREFC30
        sim  

        94
        10DKN_PARREFC60
        sim  

        1
        11DKN_LOJREFC20
        sim  

        2
        12DKN_ITNFREC40
        sim  

           
        13DKN_CHVNFEC440
        sim  

        183
        14DKN_ORIGEMC100
        sim  

           



      • Ajuste na campo DS_TIPO da tabela  SDS   

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




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

        OrdemCampoTipoTamanhoTítuloDescriçãoDecimalUsado
        56DS_TPCOMPLC2Tipo Compl. Tipo de Complemento      0sim  



      • Ajuste no indice 2 da tabela SD1:

        IndiceOrdemChaveDescrição
        SD12D1_FILIAL+D1_COD+D1_DOC+D1_SERIE+D1_FORNECE+D1_LOJA+D1_ITXML+D1_ITEMProduto + Documento + Serie + Forn/Cliente + Loja + Item XML + Item NF



      • Ajuste no conteudo Default do parametro: MV_COMCOL2

        ParametroNovo Conteúdo
        MV_COMCOL2NDCOTB56