Logística - Linha Protheus - TMS - Cadastros para importação de XML via Importação de Notas Fiscais - TMSAE80

 Tempo aproximado para leitura: 00:10:00 min

Dúvida
Quais os cadastros necessários para que o Sistema efetue a importação do XML de Nota Fiscal via Importação de Notas Fiscais - TMSAE80?

Ambiente
TOTVS Logística - TOTVS TMS (Linha Protheus) - Gestão de Transportes (TMS) -  Todas as versões.

Solução
Os dados da transportadora, emitente, destinatário e produtos do XML para serem importados na leitura do XML devem estar cadastrados no TMS da seguinte forma:

• O CNPJ da Transportadora do XML, referente a tag transporta, deve ser o mesmo do SIGAMAT - Filial em uso. No exemplo, utilizamos CNPJ: 22372432000166 e IE: 574114556.

• Parâmetro MV_CGCTRAN preenchido. Caso ele esteja em branco, o Sistema não importará o XML para as tabelas do TMS. Este parâmetro é utilizado para importar notas fiscais cujo XML não possui a tag <transporta> preenchida, então, deve-se habilitar ou desabilitar conforme necessidade. 
  
  
• Cadastrar o emitente do XML, referente a tag emit, como Cliente - MATA030.

• Cadastrar o destinatário do XML, referente a tag dest, como Cliente - MATA030.

• Mas, não é necessário incluir os cadastros de emitente e destinatário, o Sistema pode inclui-los de forma automática, para isso, para importar automaticamente o emitente do XML, basta habilitar o parâmetro MV_IMPEMIT.
  Para que o emitente e destinatário do XML sejam cadastrados automaticamente como Cliente - MATA030, o código do município informado na tag cMun deve estar cadastrado no Grupo de Região - TMSA115, campo DUY_CODMUN, e, no dicionário de dados, os campos Código - A1_COD e Loja - A1_LOJA devem possuir inicializador padrão conforme exemplo abaixo. 

• Para que o produto do XML seja lido e incluído no campo Código do Produto - DE5_CODPRO, então, cadastrar o código do produto do XML, tag cProd e sua unidade de medida na rotina Produtos - MATA010.

• Mas, não é necessário realizar o cadastro deste produto do XML, basta utilizar um produto genérico na importação do XML, para isso, cadastre um produto no MATA010 e informe o código deste produto genérico no parâmetro MV_PROGEN, desta forma, o produto deste parâmetro será gravado no campo DE5_CODPRO.

• Caso o XML possua mais de um produto informado, então, para que seja importado somente um produto, basta desabilitar o parâmetro MV_PRDDIV, desta forma, o Sistema utilizará o produto do parâmetro MV_PROGEN para preencher o campo DE5_CODPRO. Caso deseje importar todos os produtos do XML, onde o valor total da nota será a soma do valor dos produtos, então, habilite o parâmetro MV_PRDDIV.
  
  
• Com o parâmetro MV_PRDDIV habilitado, podemos associar os produtos do XML relacionado a tag cProd com produto cadastrado no MATA010, para isso, podemos utilizar os cadastros de Produtos x Embarcadora - TMSAE40 ou Produto x Cliente - MATA370.
  
  
• Com o parâmetro MV_PRDDIV habilitado, no cadastro de Produtos x Embarcadora - TMSAE40, informe o cliente emitente, o Código do Produto relacionado ao cadastro do MATA010, e, no campo Produto Embarcado informe o código referente a tag cProd.
  

Exemplo de nota importada

• Com o parâmetro MV_PRDDIV habilitado, no cadastro de Produto x Cliente - MATA370, informe o cliente emitente, o Código do Produto relacionado ao cadastro do MATA010, e, no campo Código Produto Cliente informe o código referente a tag cProd.

Exemplo de nota importada

• Caso o Sistema não encontre os cadastros de Produtos x Embarcadora - TMSAE40 ou Produto x Cliente - MATA370, ou se MV_PRDDIV desabilitado, então, o campo DE5_CODPRO será gravado com o conteúdo do parâmetro MV_PROGEN.
  
  
• Cadastrar a unidade de medida relacionado a tag uCom do XML na tabela genérica MG no SIGACFG.

• Cadastrar o emitente do XML como Solicitante - TMSA440.

• Cadastrar o Contrato de Cliente - TECA250 para o emitente. No campo EDI TMS - DDA_EDITMS do serviço que será utilizado na importação do XML, informar Sim. Podemos cadastrar o contrato para o cliente genérico informado no parâmetro MV_CLIGEN. Este parâmetro deve ser configurado com filial em branco, ou seja, compartilhado entre as filiais. 

• Cadastrar o Perfil do Cliente - TMSA480 para o cliente tomador de serviço. Dica: somente o Contrato do Cliente é possível utilizar com cliente genérico.

• Necessário preencher a aba EDI da seguinte maneira.

• Caso deseje habilitar a busca da nota pela Inscrição Estadual do EDI, habilite o parâmetro MV_INSCEDI.
  
  
• Para considerar o valor total da nota fiscal na importação do XML, habilite o parâmetro MV_PRDITEM.
  
  Processamento do TMSAE80
• Incluir o XML da NFe na pasta NEW.

• Caso deseje, pode-se observar no AppServer a execução do Schedule.

• Após a execução do EDI, o XML será movido para a pasta OLD se a importação ocorreu com sucesso e então, o registro será gravado na tabela DE5.
  
  

• Caso não seja importado por algum erro, então, o XML será movido para a pasta ERR e o registro gravado na tabela DEV. Se o XML foi movido para a pasta ERR, basta verificar o movido do erro na rotina Atualizações/ EDI/ NFEs Não importadas - TMSAE85.
  
  

• Para esta nota que foi importada com erros, então, após os devidos ajustes, basta selecionar a nota desejada e clicar em Reprocessar.

Saiba mais
Para mais informações acesse: Logística - Linha Protheus - TMS - TMSAE80 Importação de Notas Fiscais - XML.

Glossário
CNPJ - Cadastro Nacional da Pessoa Jurídica
ERR - Pasta que contém os XML não importados por erro
IE - Inscrição Estadual
NEW - Pasta para adicionar os XML a ser importados
NFe - Nota Fiscal Eletrônica
OLD - Pasta que contém os XML já importados
XML - Extensible Markup Language