Árvore de páginas

Versões comparadas

Chave

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

...

A rotina complemento de dados do XML, (COMA400) permitirá o preenchimento dessas informações depois da inclusão do documento de entrada.

...

  • Onde acessar?

    Módulo de Compras(02) - Atualizações > Movimentos > Documento de Entrada > Outras Ações > Compl. dados XML


  • Exemplo de Utilização

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.

  • 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
titleFAQ
  • 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
Âncora
valid
valid

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ériee Produto, ao clicar no botão Documento Referenciadoalgum 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
titleA103DOCREF

"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

A400PosVld/A400CONSIT

"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 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
titleA103NDNC

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

A400PosVld

"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 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
titleNCNDDUPLIC A400PosVld

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

Aviso
titleA400PosVld

"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
Âncora
dic
dic

    • Novo campo: 

      OrdemCampoTipoTamanhoDecimalValidUsadoRelacaoComboGrupo de Campos
      1DKA_CSDXMLC10Pertence(" 12")Sim
      1=Sim;2=Não
    • Nova tabela: 

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