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(COMA400) 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.
1) Preencha os valores do item XML manualmente ou utilizando a opção de "Auto Preencher Item XML"
2) Utilize a opção "Consolidar Itens" para que as quantidades sejam somadas.
3) Preencha a Unidade de Medida e Quantidade do 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
- Dei entrada exatamente igual ao XML, não dividi os produtos em linhas diferentes, como preencho o item XML?
- Neste caso, pode-se utilizar o facilitador "Auto Preencher Item XML" que replicará o valor do Item NF para o Item XML, em seguida utilize a opção "Consolidar Itens" possibilitando que preencha a Unidade de Medida e Quantidade do XML
- Meu documento foi importado pelo TOTVS Transmite / Importador XML, como preencho o item XML?
- O importador XML/Totvs Transmite já possui esses dados durante a importação do XML e já armazena essas informações de forma automática sem necessidade de intervenção manual.
- A opção não está disponível no outras ações do Documento de entrada
- A opção da rotina Complemento de Dados do XML, irá aparecer se os seguintes requisitos forem atendidos:
- Expedição contínua a partir de Dez/2025 estiver aplicada.
- Parâmetro MV_CSDXML estiver desativado.
- Campo DKA_CSDXML existir no dicionário de dados
- Tabela DKN(Documentos referenciados) existir no dicionário de dados.
|
03. VALIDAÇÕES
O sistema realiza validações automáticas para garantir a integridade das informações.
Falta de informações obrigatórias
Caso algum item fique sem a informação obrigatória do item XML e utilizado a opção de consolidar, o sistema exibirá a mensagem de help:
"Não foi possível realizar a consolidação dos dados, o item: "0001" não possui o valor correspondente ao item xml." ou "Preencher o item XML do produto/item NF "0001" " |
Valor de item XML igual para produtos diferentes.
Caso seja inserido um valor de item XML igual para produtos diferentes, o sistema exibirá a mensagem de help:
"Há divergência no item XML "001" / Produto X - Os produtos devem ser iguais quando são parte do mesmo item XML" |
Salvar sem consolidar dados
Caso seja realizada tentativa de confirmar a gravação sem a consolidação dos dados, o sistema exibirá a mensagem de help:
"Realize a consolidação dos itens clicando em Outras ações > Consolidar Itens" |
Utilização de Rotina automática sem dicionário necessário.
Caso utilize a rotina automática sem as tabelas DKN(Documentos referenciados) e o campo DKA_CSDXML no dicionário de dados, a rotina automática retornará o help:
"Há dicionário de dados ausentes e são necessários para o funcionamento da rotina, verifique a existência da tabela DKN e campo DKA_CSDXML" |
04. DICIONÁRIO DE DADOS
Novo campo:
| Ordem | Campo | Tipo | Tamanho | Decimal | Valid | Usado | Relacao | Combo | Grupo de Campos |
|---|
| 1 | DKA_CSDXML | C | 1 | 0 | Pertence(" 12") | Sim |
| 1=Sim;2=Não |
|
| 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 |
|
| |