Procedimento para Configuração

As atualizações disponibilizadas através deste Boletim Técnico adequam o produto Easy Export Control para sua utilização na integração via Mensagem Única – EAI. Para a configuração das integrações, devem ser observadas as orientações do manual de integração com o ERP em questão.

Sobre o EAI Protheus, consulte as informações adicionais disponíveis no portal TDN:

http://tdn.totvs.com/display/framework/EAI+Protheus

http://tdn.totvs.com/pages/releaseview.action?pageId=107939550

CONFIGURAÇÃO DE PARÂMETROS

...

Obs: Necessita cadastro prévio da embalagem no ERP Protheus e que o código desta embalagem seja o disposto no parâmetro.

Obs: Necessita cadastro prévio da condição de pagamento no ERP Protheus e que o código desta condição de pagamento seja o disposto no parâmetro.

Necessita cadastro prévio da via de transporte no ERP Protheus e que o código desta via de transporte seja o disposto no parâmetro.

Necessita cadastro prévio do INCOTERM no ERP Protheus e que o código deste INCOTERM seja o disposto no parâmetro.

Informação é obtida do ERP Externo

Informação é obtida do ERP Externo

Informação é obtida do ERP Externo

CONFIGURAÇÃO DE WEB SERVICE PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Módulos WEB e clique em Incluir.
4. Em Módulo Web, selecione o módulo WS – Microsiga Protheus 11 Web Services; em Nome da Instância, informe um nome para o Web Service(exemplo: “ws”). Selecione o enviroment e o ambiente. Marque a opção “Habilitar processos na Inicialização do Servidor”. Clique em Avançar.
5. Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
6. Em host digite o endereço http do seu web service (Exemplo: “localhost:81/ws”). Selecione a Empresa/Filial e clique em “Relacionar”. O relacionamento será exibido na parte inferior da tela. Clique em Avançar.
7. Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
8. O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.
9. Após a instalação, certifique-se de que o WebService está no ar. Para tanto, digite no campo de endereço do navegador de internet o endereço do  webservice criado que deve conter: http://<ip : porta>/ <instância do webservice> / <rotina> onde a rotina utilizada para listar os serviços ativos no WebService Protheus é a rotina “wsindex.apw”. Conforme a configuração feita nos exemplos deste documento, fica da seguinte forma: http://localhost:91/ws/wsindex.apw.  O WebService irá carregar a página com a listagem dos serviços.

CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS

...

Descrição

...

Nome do JOB

...

Função ADVPL

...

FWSCHDMANAG

...

Ambiente

(preencha com o ambiente/enviroment em uso no protheus)

...

Descrição

...

Nome do JOB

...

Função ADVPL

...

FWSCHDQUEUE

...

Ambiente

(preencha com o ambiente/enviroment em uso no protheus)

...

CONFIGURAÇÃO DE AGENTE DO SCHEDULER PROTHEUS

...

...

CONFIGURAÇÃO DA TAREFA DE PROCESSAMENTO DE INTEGRAÇÕES ASSINCRONAS DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agendamentos/Cadastro, clique em Incluir.
   

3. Preencha os dados na tela para criação da tarefa conforme abaixo:

    

   Itens/Pastas	Descrição
   Usuário:	Administrador
   Rotina:	FWEAI
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Empresa/Filial:	(preencha com o empresa/filial em uso no protheus)
   Módulo:	99 – Configurador
   Habilitado:	(deixe a opção marcada)

4. Clique no botão recorrência e informe a periodicidade para processamento da tarefa de integração das mensagens assíncronas. Recomendado deixar na opção “Sempre Ativo” e “Sem data de término”.
   

5. Clique em Confirmar para fechar a tela de recorrência. Clique em confirmar para salvar a configuração da tarefa.
   
6. Recomendado reiniciar o serviço do Protheus após a configuração do agendamento.
   

CONFIGURAÇÃO DO APPSERVER DO PROTHEUS

...

CONFIGURAÇÃO DO SERVIÇO DO PROTHEUS PARA ATUALIZAÇÕES

Após as configurações de webservice e scheduler do Protheus, haverão tarefas em execução no servidor do Protheus mesmo que nenhum usuário esteja logado no sistema. Com isso as aplicações de patchs e updates que necessitam de acesso exclusivo ao sistema podem ser dificultadas pois é necessário derrubar os processos em execução. Recomenda-se fazer uma copia da instalação do serviço do Protheus (pasta “\bin\” que contem os binários do serviço do Protheus) e nessa instalação retirar a configuração da execução dos Jobs (basta remover a seção [ONSTART] no appserver.ini. É importante que todas as outras configurações sejam mantidas). Assim, quando for necessário aplicar um patch ou update, pare o serviço do Protheus que possuir as configurações dos Jobs, inicie o serviço que não possua execução de Jobs, aplique a atualização necessária, pare o serviço que não possuir execução de Jobs e inicie novamente o serviço que possuir a execução de Jobs.

Tome cuidado para executar esse processo da maneira descrita para que o Protheus possa ser atualizado e para que não fique sem a inicialização dos Jobs.

PROCEDIMENTO PARA BACK-UP DE BASE DE DADOS

Devido ao controle e configurações internas do TOTVS DBACCESS, toda criação de backup e restore de backup de base de dados, assim como replicação da base de dados para outros ambientes, deve ser feita através da importação de tabelas da ferramenta APSDU. Isso garante a integridade das tabelas e correta interpretação dos dados pelo TOTVS DBACCESS e consequentemente pelas aplicações do Protheus. Não utilize ferramentas de backup de tabelas diretamente pelo banco de dados, pois isso pode exigir a reinicialização do serviço e até mesmo a reinstação do TOTVS DBACCESS.

RELAÇÃO DE/PARA DE EMPRESAS / FILIAIS

Outros ERPs TOTVS diferentes do Protheus não possuem o conceito de Empresa/Filial como no Protheus, existindo uma ou mais empresas/filiais distintas utilizando o mesmo sistema, são todas cadastradas no ERP como empresas diferentes. Além disso os códigos de empresa do ERP são distintos dos códigos de empresa/filial do Protheus. Por isso é necessário acessar o cadastro da relação DE/PARA no módulo configurador (Ambiente/Schedule/Emp.fil Msg.Unica) para cadastrar esta relação.

Por exemplo, se tivermos a empresa 21 no ERP Logix e quisermos associar á empresa 01 filial 10 do Protheus, devemos cadastrar conforme abaixo.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Emp.fil Msg.Unica (APCFG050).

2. Clique na opção Incluir e preencha os campos conforme exemplo abaixo:

    

   Itens/Pastas	Descrição
   Referência	LOGIX (nome do ERP externo)
   Company	21 (código da empresa no ERP)
   Branch	(em branco)
   Emp.Protheus	01
   Fil.Protheus	10

3. Clique em confirmar para salvar o relacionamento empresa/filial.
   

ADEQUAÇÃO DO TAMANHO DOS CAMPOS DO PROTHEUS

O tamanho de campos de algumas tabelas do Easy precisará ser adequado para que fique compatível com o tamanho dos campos no ERP.

Campos como código de cliente, código de fornecedor e código de produto podem ficar divergentes e gerar problemas de integração caso não fiquem com o mesmo numero de caracteres que o ERP.

 Verifique o tamanho dos grupos de campos do Protheus através do módulo configurador, na opção de menu Base de dados / Dicionário / Base de dados. Selecione a empresa do lado esquerdo da tela, selecione Dicionário de dados e Grupo de campos. Veja ao lado direito todos os grupos de campo e na coluna tamanho, o tamanho atualmente em uso no Protheus.

 É recomendado rever os seguintes grupos de campos:

CONFIGURAÇÃO DE ADAPTER 

O módulo Easy Export Control e Easy Financing Control estão preparados para a realização das integrações que seguem. O uso de cada uma delas deve ser avaliado conforme escopo de integração previsto. Na realização dos cadastros, deve ser observada a definição do método (que pode ser alterada, conforme definição da necessidade), para que fiquem iguais nos ERPs que trocarão a mensagem.

O campo XSD indica com qual layout o arquivo XML da integração é validado. Este campo somente deve ser informado em caso de testes e caso o arquivo .XSD correspondente a mensagem seja fornecido pela TOTVS e armazenado no diretório indicado no parâmetro MV_EAIXSD.

Para configurar as integrações, conforme a necessidade, siga as instruções abaixo:

       1.            No Configurador (SIGACFG) acesse Schedule/Adapter E.A.I. (CFGA020).

       2.            Acesse a opção Incluir e informe os dados do adater, conforme as opções que seguem:

MENSAGENS DA FASE DE CADASTROS

MENSAGENS DA FASE DE PEDIDO

MENSAGENS DA FASE DE EMBARQUE

DESPESAS DE EXPORTAÇÃO

CÂMBIO DE EXPORTAÇÃO

...

Descrição

...

Nome do JOB

...

Função ADVPL

...

FWSCHDQUEUE

...

Ambiente

(preencha com o ambiente/enviroment em uso no protheus)

...

Procedimento para Utilização

Teste de webservices

Os webservices do Protheus e do ERP destino da integração devem estar devidamente configurados e no ar.

Verifique utilizando seu navegador de internet se o webservice do Protheus está no ar acessando o host configurado para o webservice Protheus. Procure o serviço FWWSEAI e veja se o mesmo encontra-se habilitado.

Verifique, utilizando seu navegador de internet, se o webservice do ERP destino está no ar acessando o host configurado no parâmetro MV_EAIURL2.

Integrações de cadastros

As integrações de cadastros ocorrem com origem no ERP com destino ao Easy. Algumas dessas integrações ocorrem de forma síncrona e outras de forma assíncrona.

Quando o cadastro possuir a integração de forma síncrona, o ERP irá aguardar o Easy processar a integração, e então exibirá para o usuário se tudo ocorreu com sucesso ou se houve rejeição por parte do Easy. Quando as rejeições das integrações ocorrem, o ERP não irá efetivar a operação realizada.

Quando o cadastro possuir integração de forma assincrona, o ERP não irá aguardar o Easy processar a integração e irá efetivar a operação independentemente do processo de integração. A mensagem de integração entra em uma fila no ERP para ser enviada ao Easy. Quando a integração ocorrer, a mensagem será recebida pelo Protheus e armazenada em uma fila para posterior processamento, retornando ao ERP apenas o aviso de recebimento da mensagem. O processamento da integração ocorre no Easy conforme a execução da tarefa FWEAI configurada no Scheduler do Protheus. Essa tarefa irá verificar todas as mensagens pendentes na fila do EAI e irá processá-las. Após o processamento, será enviada a mensagem ao ERP com o resultado da integração. Em caso de rejeição na integração, o EAI pode tentar processar novamente a mensagem antes de retornar uma rejeição ao ERP.

Pré-requisitos cadastrais

Cadastro de Produtos:

Para o cadastro de produtos do módulo Easy Import Control (Atualizações / Cadastros / Produtos – MATA011) é necessário cadastrar previamente às integrações deste cadastro, cadastrar um Local Padrão para o campo Armazem Pad. (B1_LOCPAD) com o valor “.” visto eu tal campo tornou-se obrigatório nas últimas versões do produto.

Condição de pagamento:

O cadastro da condição de pagamento do módulo Easy Import Control (Atualizações / Tabelas / Condição de Pag. – EICA060) deve ser relacionado ao cadastro de condição de pagamento do ERP; desta forma, acessando o cadastro o usuário deverá alterá-lo e informar a correspondência no campo Cod. ERP(Y6_CODERP), pasta Outros.

Moedas:

O cadastro de moedas do Easy Import Control (Atualizações / Cadastros / Moedas – EICA150) deve ser relacionado ao cadastro de moedas do ERP. Para isso o usuário deverá acessar o registro da moeda em modo de alteração e informar nos campos: Cod.C.ERP (YF_CODCERP) o código da moeda de compra correspondente; Cod.V.ERP (YF_CODVERP) o código da moeda de venda correspondente e Cod.F.ERP (YF_CODFERP) o código da moeda fiscal correspondente.

Eventos Contábeis:

Para realizar a integração com o Financeiro do ERP, o Easy Import Control precisará saber qual o tipo de documento deve ser gerado. Para isso será necessário que os eventos contábeis associados às integrações/ tipos de movimento financeiro sejam configurados.

Através do menu Atualizações / Tabelas / Eventos Contábeis (ECOA002), os eventos abaixo, do tipo IMPORT, devem ser acessados em modo de alteração e ter os campos informados conforme orientação que segue:

...

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

...

Obs: Necessita cadastro prévio da embalagem no ERP Protheus e que o código desta embalagem seja o disposto no parâmetro.

Obs: Necessita cadastro prévio da condição de pagamento no ERP Protheus e que o código desta condição de pagamento seja o disposto no parâmetro.

Necessita cadastro prévio da via de transporte no ERP Protheus e que o código desta via de transporte seja o disposto no parâmetro.

Necessita cadastro prévio do INCOTERM no ERP Protheus e que o código deste INCOTERM seja o disposto no parâmetro.

Informação é obtida do ERP Externo

Informação é obtida do ERP Externo

Informação é obtida do ERP Externo

CONFIGURAÇÃO DE WEB SERVICE PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Módulos WEB e clique em Incluir.
4. Em Módulo Web, selecione o módulo WS – Microsiga Protheus 11 Web Services; em Nome da Instância, informe um nome para o Web Service(exemplo: “ws”). Selecione o enviroment e o ambiente. Marque a opção “Habilitar processos na Inicialização do Servidor”. Clique em Avançar.
5. Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
6. Em host digite o endereço http do seu web service (Exemplo: “localhost:81/ws”). Selecione a Empresa/Filial e clique em “Relacionar”. O relacionamento será exibido na parte inferior da tela. Clique em Avançar.
7. Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
8. O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.
9. Após a instalação, certifique-se de que o WebService está no ar. Para tanto, digite no campo de endereço do navegador de internet o endereço do  webservice criado que deve conter: http://<ip : porta>/ <instância do webservice> / <rotina> onde a rotina utilizada para listar os serviços ativos no WebService Protheus é a rotina “wsindex.apw”. Conforme a configuração feita nos exemplos deste documento, fica da seguinte forma: http://localhost:91/ws/wsindex.apw.  O WebService irá carregar a página com a listagem dos serviços.

CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Processos Comuns e clique em Incluir.
4. Preencha os campos conforme abaixo:

...

Descrição

...

Nome do JOB

...

Função ADVPL

...

Capturar diretamente do sistema.

...

Ambiente

Disponibilizado pelo Marketing.

...

...