Importador de XML no Protheus, release 12.1.25

Importador de XML no Protheus

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 a baixo:

        • Quais são os pré-requisitos pra 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 pra 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!

Importador de XML no Protheus 12.1.25 (308 downloads)


 

 

Quais são os Pré-requisitos pra 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 requitios básico:

        • 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.

Pastas Importador de XML no Protheus

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.

Parametros Importador de XML no Protheus

3.Ajustar o nome da tabela CKO

Como ocorrerão modificação no teu dicionario 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 pra CKOCOL conforme imagem.

CKO tabela importador de xml no protheus

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

CKO indice importador de xml no protheus

5.Criar Scheduler

Será necessário 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

Scheduler1 importador de xml no protheus

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)

Scheduler 002 importador de xml no protheus

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

Recorrencia do Scheduler no importador de xml no protheus

6.Reiniciar o appserver da aplicação

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

Scheduler INI importador de xml no protheus

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 pro 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 pra 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 no Protheus 12.1.25 (308 downloads)


 

    • 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

menu importador de xml no protheus

        • Preenche os Parâmetros

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

Por exemplo, pode ser preenchido assim como nos prints a baixo.

filtro importação de xml no protheus

filtro2 importadoção de xml no protheus

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 critica dos XMLs. Essa criticas você vai monitorar por meio da rotina Reprocessar veja o passo seguinte.

    • Reprocessar

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

tela de reprocessar importação de xml no protheus

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 a baixo clicar em Outras ações -> Gerar Docto

tela2 gerardocto importação de xml no protheus

 

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