Importador de XML no Protheus, release 12.1.25

Importador de XML no Protheus, release 12.1.25

Durante muitos anos, usar um importador de XML no Protheus pra notas fiscais era um processo que só era possível por customização própria ou de terceiros.

“Preciso facilitar o processo de lançamento de nota fiscal de entrada no Protheus, não dá pra puxar do XML?!”. Essa sempre foi uma necessidade dos usuários de ERP.

Até que com o lançamento da release  12.1.25, foi disponibilizado no padrão Protheus um importador de XML. E sobre essa nova funcionalidade que discorremos nesse artigo e vídeo. Focaremos em responder as perguntas abaixo:

• • • • Quais são os pré-requisitos para usar o importador de XML padrão no Protheus 12.1.25?
      • Quais são as diferenças entre Importador XML padrão e TOTVS Colaboração?
      • Como colocar para funcionar o Importador XML padrão no Protheus?
      • Como usar importador do XML padrão do Protheus?

Para Download Informe seu e-mail aqui e receba totalmente grátis!

Quais são os Pré-requisitos para usar o importador de XML padrão no Protheus?

Para que você possa iniciar a usar essa rotina, você precisa primeiro checar se a sua base atende esses requisitos básicos:

• • • • Protheus 12 está na release 12.1.25
      • Atualizar o menu do módulo Compras

Diferenças entre Importador XML padrão e o TOTVS Colaboração (Neogrid)?

De forma resumida, o importador de XML padrão não faz a importação de NFS-e. Já o TOTVS Colaboração faz a importação de NFSe.

A TOTVS catalogou bem essas diferenças. Mais detalhes no TDN clique aqui.

Como colocar pra funcionar o Importador XML padrão no Protheus?

Listei seis passos pra preparar a tua base pra utilizar essa rotina. São eles:

1.Criar pastas

Para viabilizar a utilização da importação de XML no Protheus é necessário que sejam criadas algumas pastas dentro da pasta RootPath no seu servidor Protheus.

Geralmente, a RootPath fica na pasta “Protheus_data”, mas como as instalações podem variar o caminho recomendamos que você olhe lá no teu servidor no arquivo appserver.ini qual é a tua pasta RootPath.

Pra ficar organizado, dentro da minha pasta “Protheus_data” eu criei uma pasta chamada “XMLIMPORT” e dentro dela passei as criar as pastas obrigatórias, são essas:

• • • • • • • • IN: caminho do diretório dentro do ROOTPATH do Protheus onde será lido os arquivos XML para importação
              • Lidos: caminho do diretório dentro do ROOTPATH do Protheus onde será armazenado os arquivos após lidos e processados
              • OUT: caminho do diretório dentro do ROOTPATH do Protheus onde será armazenado os arquivos a serem enviados para NeoGrid.

2.Atualizar Parâmetros

Listamos aqui os principais parâmetros que precisam ser configurados previamente pra podermos importar XML no Protheus, são eles: MV_NGINN, MV_NGLIDOS, MV_ NGOUT, MV_SPEDCOL, MV_TCNEW e MV_IMPXML.
Para o correto funcionamento da importação do CT-e, deverão ser configurados também os parâmetros MV_XMLTECT, MV_XMLCPCT e MV_XMLPFCT.

3.Ajustar o nome da tabela CKO

Como ocorrerão modificações no teu dicionário de dados e no banco, o ideal é que seja feito um backup. Orientações sobre backup clique aqui. 

Por padrão, na instalação do Protheus o nome da tabela vem como CKO010. Para que funcione corretamente a rotina de importação, você precisa modificar para CKOCOL.

Abra o arquivo SX2 da sua empresa, localize no campo X2_ARQUIVO o conteúdo CKO010, edite e modifique para CKOCOL conforme imagem.

4.Criar Índice na tabela CKO

Neste passo, você vai precisar acessar o configurador e criar um índice.

O índice a ser criado é o de ordem 5 da tabela CKO CKO_ARQXML

5.Criar Scheduler

Será necessária a criação de dois scheduler: um pra importar o XML e outro pra fazer a leitura e gravar no Protheus. Por exemplo, siga os prints conforme abaixo:

Scheduler 000001 fará a importação do XMLs e salva na tabela CKO

Depois disso, você vai precisar criar o segundo scheduler: o 000002. Ele fará a leitura dos XMLs, vai alimentar as tabelas SDS e SDT (cabeçalho e itens os XMLs importados)

Importante que a recorrência seja “Sempre ativo”, nos dois scheduler.

6.Reiniciar o appserver da aplicação

Depois disso, é importante reiniciar o serviço do Protheus. Pois nesse momento serão adicionadas as configurações no appserver.ini conforme o print abaixo.

Como usar importador do XML padrão do Protheus?

Agora que concluímos o passo a passo de implantação do importador de XML no padrão Protheus, vamos para o passo a passo de utilização. No vídeo tem bem na prática esse processo.

• • Colocar o arquivo XML na pasta IN

Um requisito para o funcionamento dessa rotina é que você já tenha acesso ao XML das notas e conhecimentos. Portanto, agora você precisa colocá-los nessa pasta pra que sejam importados.

OBS.: Você pode utilizar a rotina de MDe do Protheus pra exportar o XML, saiba como exportar XML clicando aqui. Contudo, ele será gerado compactado no formado Gzip. Preparamos um fonte UFUNZIP.prw e disponibilizamos pra você no pacote de apoio do artigo. O objetivo da rotina U_UFUNZIP é descompactar e renomear para XML todos os arquivos que tiverem na pasta informada no parâmetro MV_NGINN. Orientações de como utilizar está também dentro do pacote.

Para Download Informe seu e-mail aqui e receba totalmente grátis!

• • Importador de XML

Estando lá na pasta os XMLs que você que importar, o próximo passo é acessar o módulo de Compras e seguir o caminho no menu:

• • • • Miscelanea -> Importador de Xml -> Monitor

• • • • Preencher os Parâmetros

Os parâmetros podem ser preenchidos de forma bem aberta. Mas se tiver um grande número de notas pode ficar pesado – preencha conforme tua necessidade.

Por exemplo, pode ser preenchido assim como nos prints abaixo.

Se tiver tudo ok, ele já mostra todos os XMLs importados prontos pra virar pre-nota.

Esse “tudo ok” são as informações básicas da nota estarem coerentes, como por exemplo:

• • • • • • o cnpj de destino ser o seu cnpj da filial.
          • o fornecedor ou cliente tem que estar cadastrado
          • o produto do XML tem que estar vinculado na amarração Fornecedor X Produto

Caso contrario, terá que fazer a correção de cada crítica dos XMLs. Essa críticas você vai monitorar por meio da rotina Reprocessar. Veja o passo seguinte.

• • Reprocessar

Essa rotina é um espécie de monitor onde você vai enxergar porque ainda não apareceu na tela principal a nota lá do XML como importada.

E após identificar e fazer o cadastro necessário é nessa mesma rotina que você vai refazer a leitura ou reprocessar como é o nome da própria rotina.

• • Gerar Documento

Em conclusão, seu objetivo final é deixar o status do XML importado como vermelho documento gerado. Pois neste status sua nota em XML já virou uma pre-nota a ser classificada.

Pra fazer isso quando a nota estiver importada é só marcar o X confirme print abaixo, clicar em Outras ações -> Gerar Docto

Este é um documento vivo e está sempre em atualização. Se faltou algo, não deixe de comentar no final do artigo.