Á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
  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 Com a 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 à CBSdo Consumo, os novos impostos IBS, CBS e IS serão incluídos nos documentos fiscais eletrônicos (como NFe / CTe / CTeOS e NFSe).


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


  • finNFeImposto\IS

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.

Bloco de código
languagexml
titlefinNFe
<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.
Bloco de código
languagexml
titletpNFDebito / tpNFCredito
<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.

Bloco de código
languagexml
titleNFref (referência da NF completa)
<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.

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

IS indica valores ao imposto seletivo (IS):

    • CST
    • ClassTrib
    • Base
    • Aliquota
    • Valor


  • Imposto\IBSCBS

A tag IBSCBS indica valores ao CBS e IBS:

    • IBS
      • CST (Igual para IBS/CBS)
      • ClassTrib (Igual para IBS/CBS)
      • Base (Igual para IBS/CBS)
      • Aliquota
      • Valor
      • TribRegular
        • CST
        • ClassTrib
        • Aliquota
        • Valor
      • CreditoPresumido
        • Codigo
        • Aliquota
        • Valor
    • CBS
      • CST (Igual para IBS/CBS)
      • ClassTrib (Igual para IBS/CBS)
      • Base (Igual para IBS/CBS)
      • Aliquota
      • Valor
      • TribRegular
        • CST
        • ClassTrib
        • Aliquota
        • Valor
      • CreditoPresumido
        • Codigo
        • Aliquota
        • Valor


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, garantindo:

  • rastreabilidade completa do processo;

  • consistência das informações 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 de Crédito ou Débito ao documento fiscal de origem, o sistema permite identificar claramente qual operação está sendo ajustada, 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).

Os documentos que possuirem CBS/IBS/IS, seu valores poderão ser visualizados na aba "Impostos".

  • Para CBS/IBS serão apresentados os valores que forão calculados e efetivamente tributavel (TribRegular)


  • Importação via XML

    Ao importar uma nota de crédito ou débitoum documento (NFe/CTe/CTeOS ou NFSe), 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
      languagec#
      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
      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.

  • os impostos correspondente na DKM.


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.


    • Aba "Impostos"

      • Caso documento apresente valores de CBS/IBS/IS, os mesmos serão apresentados seus valores na aba.

     

      • Image Added


    • Nova tabela – DKM

      • Tabela que contera todas informações pertinentes aos impostos CBS/IBS/IS
    Exibição automática do tipo conforme a leitura da tag finNFe.
    Image Removed
  • 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 Removed

    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 Removed

    • Demonstração (GIF)

    Verifique no GIF abaixo os ajustes citados:


    [Clique para expandir]

    ExemplosNF de Crédito (Referência por NF Completa)
    Image Removed


                         [Clique para expandir]

    NF de Débito (Referência por Item)
    Image Removed
    [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.

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

    OrdemCampoTipoTamanhoDecimalValidUsadoRelacaoComboGrupo de Campos1DKN_FILIALC80sim  332DKN_TPMOV C10Pertence("12")sim  11=Entrada;2=Saida   3DKN_DOC   C90sim  184DKN_SERIE C30sim  945DKN_CLIFORC60sim  16DKN_LOJA  C20sim  27DKN_DOCREFC90sim  188DKN_ITEMNFC40sim     9DKN_SERREFC30sim  9410DKN_PARREFC60sim  111DKN_LOJREFC20sim  212DKN_ITNFREC40sim     13DKN_CHVNFEC440sim  18314DKN_ORIGEMC100sim     

    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çãoDecimalUsado56DS_TPCOMPLC2Tipo Compl. Tipo de Complemento      0sim  

    Ajuste no indice 2 da tabela SD1:

    IndiceOrdemChaveDescriçãoSD12D1_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údoMV_COMCOL2NDCOTB56



    Aviso
    Estrutura da tabela DKM - Tributos de Documentos.
    Painel
    titleObjetivo

    Tabela que registra os impostos CBS, IBS E IS, para as rotinas importador XML

    Painel
    titleEstrutura tabela

    Índice 1 - DKM_FILIAL+DKM_DOC+DKM_SERIE+DKM_FORNEC+DKM_LOJA+DKM_ESPECI+DKM_ITEM+DKM_COD+DKM_TRIB         


    TABELAORDEMCAMPOTITULODESCRIÇÃOTIPOTAMANHODECIMALGRUPO DE CAMPOSPICTUREHelp
    DKM1DKM_FILIALFilialFilial do SistemaC80033@!Filial do Sistema.
    DKM2DKM_DOCNum DocNúmero DocumentoC90018@!Numero do Documento/Nota
    DKM3DKM_SERIESerieSerieC30094@!Série do Documento/Nota
    DKM4DKM_FORNECForn/ClienteFornecedor / ClienteC60001@!Código do Fornecedor/Cliente
    DKM5DKM_LOJALojaLojaC20002@!Loja do Fornecedor/Cliente
    DKM6DKM_TIPOTipo NotaTipo NotaC10
    @!Tipo da nota.
    DKM7DKM_ESPECIEspécieEspécieC50
    @!Espécie do Documento.
    DKM8DKM_ITEMItem NFItem NFC40
    @!Item da Nota Fiscal
    DKM9DKM_CODProdutoProdutoC300030@!Código do Produto.
    DKM10DKM_TRIBTributoTributo / ImpostoC60
    @!Sigla do tributo.
    DKM11DKM_XMLBASBase XMLBase XMLN142
    @E 99,999,999,999.99Base do tributo importado do XML
    DKM12DKM_XMLALQAlíquota XMLAlíquota XMLN52
    @E 99.99Alíquota do tributo importado do XML
    DKM13DKM_XMLVLRValor XMLValor XMLN142
    @E 99,999,999,999.99Valor do tributo importado do XML
    DKM14DKM_BASEBaseBaseN142
    @E 99,999,999,999.99Base informada do tributo
    DKM15DKM_ALIQAlíquotaAlíquotaN52
    @E 99.99Alíquota informada do tributo
    DKM16DKM_VALORValorValorN142
    @E 99,999,999,999.99Valor informado do tributo
    DKM17DKM_PDIFPerc DifPercentual DiferimentoN62
    @E 999.99Percentual Diferimento
    DKM18DKM_VDIFValor DifValor DiferimentoN142
    @E 99,999,999,999.99Valor Diferimento
    DKM19DKM_VDEVValor DevValor DevolvidoN142
    @E 99,999,999,999.99Valor Devolvido
    DKM20DKM_PREDALPerc Red Ali% Red Alíquota ClassTribN62
    @E 999.99% Redução da alíquota da Classificação Tributária
    DKM21DKM_PALIEFAliq EfetivaAlíquota EfetivaN62
    @E 999.99Alíquota Efetiva
    DKM22DKM_CSTCSTCSTC30
    @!CST
    DKM23DKM_CLASTRClass TribClassificação TributariaC60
    @!Classificação tributária
    DKM24DKM_CSTRECST RegularCST RegularC30
    @!CST Regular
    DKM25DKM_CLAREGClass T RegClass Tributaria RegularC60
    @!Classificação tributária regular
    DKM26DKM_ALQEFEAlq Efet RegAlíquota Efetiva RegularN62
    @E 999.99Alíquota efetiva regular
    DKM27DKM_VLREFEVlr Efet RegValor Efetivo RegularN142
    @E 99,999,999,999.99Valor efetivo regular
    DKM28DKM_CODCRECod Cred PreCódigo Credito PresumidoC40
    @!Código credito presumido
    DKM29DKM_ALQPREAlq Cred PreAlíquota Credito PresumidN62
    @E 999.99Alíquota credito presumido
    DKM30DKM_VLRPREVlr Cred PreValor Credito PresumidoN142
    @E 99,999,999,999.99Valor credito presumido
    DKM31DKM_VSPREVlr Susp CreVlr Suspensão Cred PresumN142
    @E 99,999,999,999.99Valor suspensão credito presumido
    DKM32DKM_ORIGEMOrigemOrigem do registroC80
    @!Origem do registro
    DKM33DKM_MSUIDCampo UIDCampo UID-FKC360


    DKM34DKM_UIDFKCampo UID-FKCampo UID-FKC360
    @!ID para vínculo com a tabela de
    tributos: F2D.
    DKM35DKM_IDTRIBId. TributosId. TributosC360
    @!ID para vínculo com a tabela de
    tributos: F2D.
    DKM36DKM_TABELATab Origem FKTab Origem FKC30
    @!Tabela Origem da FK