...
A rotina complemento de dados do XML, (COMA400) permitirá o preenchimento dessas informações depois da inclusão do documento de entrada.
...
Módulo de Compras(02) - Atualizações > Movimentos > Documento de Entrada > Outras Ações > Compl. dados XML
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:
...
- 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.
- Demais informações
- Os registros gravados serão excluídos caso o Documento de entrada seja excluído ou tenha a classificação estornada.
- Caso atualizado um item que já esteja referenciado em alguma nota de Crédito ou Débito, o campo DKN_ITXML do item será atualizado.
| Dica |
|---|
|
- 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 durante a inclusão de Notas de Crédito e Débito, conforme regras da NT 2025.002.
- Caso não estejam preenchidas as informações de Número da Nota Fiscal, Fornecedor, Loja, Sériee Produto, ao clicar no botão Documento Referenciado, 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:
| Aviso |
|---|
|
"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." |
|
"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" " |
Caso seja inserido um valor de item XML igual para produtos diferentes, o sistema exibirá a mensagem de helpCaso 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:
| Aviso |
|---|
|
"É necessário vincular documentos de origem para Notas do tipo Débito/Credito . Utilize a opção 'Vincular origem NC/ND'." |
|
"Há divergência no item XML "001" / Produto X - Os produtos devem ser iguais quando são parte do mesmo item XML" |
Caso seja realizada tentativa de confirmar a gravação sem a consolidação dos dados, o sistema exibirá a mensagem de helpSe a TES utilizada nas Notas de Crédito/Débito estiver configurada para gerar duplicata, o sistema exibirá o help abaixo, bloqueando o processo:
| Aviso |
|---|
| title | NCNDDUPLIC | | A400PosVld |
|---|
|
"Realize a consolidação dos itens clicando em Outras ações > Consolidar Itens" |
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:
| Aviso |
|---|
|
"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"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
| 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 |
|
| |