CONTEÚDO
- Visão Geral
- Exemplo de utilização - Notas referenciadas
- Validações
- Dicionário de dados
01. VISÃO GERAL
Com a implementação da NT 2025.002, publicada no contexto da Reforma Tributária houve a necessidade de armazenar dados como unidade de medida e quantidade que constam no XML.
Essas informações, poderão ser utilizadas no envio de eventos ou na referência de documentos durante a inclusão de Notas de Crédito (finNFe = 5) e Notas de Débito (finNFe = 6).
A rotina complemento de dados do XML, permitirá o preenchimento dessas informações depois da inclusão do documento de entrada.
Os fontes e dicionários referentes a esta implementação estarão disponíveis a partir da expedição contínua de Dezembro/2025. |
02. EXEMPLO DE UTILIZAÇÃO – COMPLEMENTO DE DADOS DO XML
Procedimento no Sistema
Para atender à NT 2025.002, foi implementado uma opção no outras ações no browse do documento de entrada, que permite realizar o preenchimento dos seguintes dados:
- Item XML no qual o item do documento se refere.
- Unidade de Medida Comercial, ou seja, a que veio no XML para aquele produto.
- Quantidade que consta no XML para aquele produto.
Veja nos exemplos abaixo (GIFs) como realizar o preenchimento dessas informações em um documento:

Recursos - Outras ações
- Auto Preencher Item XML - Irá preencher automaticamente o campo Item XML (D1_ITXML) com sequencial, caso tenha dividido seu item em várias linhas, esse facilitador não poderá ser utilizado.
- Limpar Item XML - Realizará o procedimento inverso do anterior, limpando o campo Item XML(D1_ITXML) e excluindo a consolidação dos dados se houver.
- Consolidar Itens - Consolidará os itens de acordo com o preenchimento do Item XML, somando quantidades das linhas com mesmo item XML.
- Ao incluir o Documento de Entrada, dividi um único item XML em várias linhas no documento de entrada(SD1), seja por questões de controle de armazém, inclusão de lotes diferentes ou pedidos de compra, como preencho o item XML?
- O itens que foram divididos em várias linhas(SD1) deverão possuir o mesmo item XML para a consolidação. Ou seja, preencha com o mesmo item XML o mesmo produto que se encontram em linhas diferentes.
- No Exemplo abaixo recebemos um XML com uma CAIXA(CX) contendo 4 unidades do Produto X, dei entrada no meu sistema como UNIDADE(UN):
- Itens do Documento de Entrada:
- Produto X - Item XML 001 - Quantidade 1 - Unidade de Medida: UN
- Produto X - Item XML 001 - Quantidade 1 - Unidade de Medida: UN
- Produto X - Item XML 001 - Quantidade 1 - Unidade de Medida: UN
- Produto X - Item XML 001 - Quantidade 1 - Unidade de Medida: UN
- Resultado da Consolidação:
- Itens do XML:
- Produto X - Item XML 001 - Quantidade 4 - Unidade de Medida no XML: CX- Quantidade no XML: 1
|
03. VALIDAÇÕES
O sistema realiza validações automáticas para garantir a integridade das informações durante a inclusão de Notas de Crédito e Débito, conforme regras da NT 2025.002.
Falta de informações obrigatórias
Caso não estejam preenchidas as informações de Número da Nota Fiscal, Fornecedor, Loja, Série e Produto, ao clicar no botão Documento Referenciado, o sistema exibirá a mensagem de help:
"Faltam informações para buscar o Documento Referenciado. Para utilizar esta opção, deve selecionar tipo da Nota, preencher Número, Fornecedor e espécie do documento." |
Nota de Crédito/Débito sem documento de origem
Caso haja tentativa de salvar uma Nota de Crédito ou Débito (com exceção do tipo Pagamento Antecipado) sem o devido vínculo ao documento de origem, será apresentada a seguinte mensagem:
"É necessário vincular documentos de origem para Notas do tipo Débito/Credito . Utilize a opção 'Vincular origem NC/ND'." |
TES configurada para gerar duplicata
Se a TES utilizada nas Notas de Crédito/Débito estiver configurada para gerar duplicata, o sistema exibirá o help abaixo, bloqueando o processo:
Para Nota de Crédito/Débito é obrigatório selecionar uma TES configurada para não gerar duplicata. Selecione outra TES ou cadastre uma nova no cadastro de 'Tipo de entrada e saída' com o campo 'Gera Dupl = N. |
04. DICIONÁRIO DE DADOS
| 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 |
|
| |