Boletim Tcnico

Integrao do Easy Drawback Control via Mensagem nica EAI

Produto

Microsiga Protheus Easy Drawback Control (SIGAEDC) M11

Chamado

TRWDY0

Data da publicao

10/06/15

Pases

Todos

Bancos de Dados

Todos

Implementao da funcionalidade de integrao via mensagem nica - EAI - para o Easy Drawback Control (Protheus), com o
objetivo de flexibilizar a comunicao entre as solues TOTVS com a utilizao da tecnologia de WEB Services, o que ocorrer
com a troca de informaes (mensagens) no formato XML entre esses sistemas . Esto previstas nessa atualizao as seguintes
integraes: Cadastro de Produtos (recebimento), Cadastro de Unidade de Medidas (recebimento) e Cadastro da Estrutura do
Produto (recebimento).
Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.

Procedimento para Implementao

O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) deste chamado.

Procedimento para Configurao

CONFIGURAO DE WEB SERVICE PROTHEUS
1.

Em Programa Inicial, digite SRVWIZARD para acessar o Wizard.

2.

Informe o Usurio e a Senha.

3.

Acesse Mdulos WEB e clique em Incluir.

4.

Em Mdulo Web, selecione o mdulo WS Microsiga Protheus 11 Web Services; em Nome da Instncia, informe um
nome para o Web Service(exemplo: ws). Selecione o enviroment e o ambiente. Marque a opo Habilitar processos na
Inicializao do Servidor. Clique em Avanar.

5.

Ser exibida a pergunta Deseja descompactar o pacote de arquivos HTTP na pasta especificada?, clique em Sim.

6.

Em host digite o endereo 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 Avanar.

7.

Informe o nmero mnimo (Exemplo: 10) e mximo de usurios (Exemplo: 10) e clique em Finalizar.

8.

O sistema exibir um aviso sobre a instalao do Web Service e questiona se deseja iniciar tal instalao. Clique em Sim.

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

CONFIGURAO DE JOB DO SCHEDULER DO PROTHEUS

1.

Em Programa Inicial, digite SRVWIZARD para acessar o Wizard.

2.

Informe o Usurio e a Senha.

3.

Acesse Processos Comuns e clique em Incluir.

4.

Preencha os campos conforme abaixo:

Itens/Pastas

Descrio

Nome do JOB

FWSCHDMANAG

Funo ADVPL

FWSCHDMANAG

Ambiente

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

Instncias

Parmetros

(no informar parmetros)

Habilitar JOB no START

(deixe a opo marcada)

5.

Clique em finalizar.

6.

Acesse novamente Processos Comuns e clique em Incluir.

7.

Preencha os campos conforme abaixo:

Itens/Pastas

Descrio

Nome do JOB

FWSCHDQUEUE

Funo ADVPL

FWSCHDQUEUE

Ambiente

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

Instncias

Parmetros

(no informar parmetros)

Habilitar JOB no START

(deixe a opo marcada)

8.

Clique em finalizar.

9.

Depois dessa configurao, necessrio reiniciar o servio do Protheus.

CONFIGURAO DE AGENTE DO SCHEDULER PROTHEUS

1.

No Configurador (SIGACFG), acesse Ambiente/Schedule/Schedule (CFGA010).

2.

Em Agent/Cadastro, clique em Incluir.

3.

Preencha os dados na tela para criao do Agente e clique em Confirmar.

4.

Em Agent, inicie o servio criado.

5.

Em Schedule, inicie os servios: Task Manager e Queue Manager.

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

CONFIGURAO DA TAREFA DE PROCESSAMENTO DE INTEGRAES ASSINCRONAS NO SCHEDULER PROTHEUS

1.

No Configurador (SIGACFG), acesse Ambiente/Schedule/Schedule (CFGA010).

2.

Em Agendamentos/Cadastro, clique em Incluir.

3.

Preencha os dados na tela para criao da tarefa conforme abaixo:

Itens/Pastas

Descrio

Usurio

Administrador

Rotina

FWEAI

Ambiente

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

Empresa/Filial

(preencha com o empresa/filial em uso no Protheus)

Mdulo

99 Configurador

Habilitada

(deixe a opo marcada)

4.

Clique no boto recorrncia e informe a periodicidade para processamento da tarefa de integrao das mensagens
assncronas. Recomendado deixar na opo Sempre Ativo e Sem data de trmino.

5.

Clique em Confirmar para fechar a tela de recorrncia. Clique em confirmar para salvar a configurao da tarefa.

6.

Recomendado reiniciar o servio do Protheus aps a configurao do agendamento.

CONFIGURAO DO APPSERVER.INI DO PROTHEUS

1.

Localize o arquivo appserver.ini, no diretrio \bin, onde se encontra a instalao dos binrios do servio do Protheus.

2.

Com um editor de texto, abra o arquivo, e localize a seo [GENERAL].

3.

Nesta seo, caso no existam as configuraes abaixo, adicione ou caso exista, altere para que fiquem conforme
abaixo. No modifique outras configuraes que possam existir nessa seo.
[GENERAL]
DATEZERO=ADVPL
MemoMega=1
ConsoleLog=1

4.

Salve as alteraes no arquivo, feche-o, e reinicie o servio do Protheus.

CONFIGURAO DO SERVIO DO PROTHEUS PARA ATUALIZAES

Depois das configuraes de webservice e scheduler do Protheus, havero tarefas em execuo no servidor do Protheus
mesmo que nenhum usurio esteja logado no sistema. Com isso as aplicaes de patchs e updates que necessitam de
acesso exclusivo ao sistema podem ser dificultadas pois necessrio derrubar os processos em execuo. Recomenda-se
fazer uma copia da instalao do servio do Protheus (pasta \bin\ que contem os binrios do servio do Protheus) e nessa
instalao retirar a configurao da execuo dos Jobs (basta remover a seo [ONSTART] no appserver.ini. importante
SIGAEDC - Integrao do Easy Drawback Control via
Mensagem nica EAI

Boletim Tcnico

que todas as outras configuraes sejam mantidas). Assim, quando for necessrio aplicar um patch ou update, pare o servio
do Protheus que possuir as configuraes dos Jobs, inicie o servio que no possua execuo de Jobs, aplique a atualizao
necessria, pare o servio que no possuir execuo de Jobs e inicie novamente o servio que possuir a execuo de Jobs.
Tome cuidado para executar esse processo da maneira descrita para que o Protheus possa ser atualizado e para que no
fique sem a inicializao dos Jobs.
PROCEDIMENTO PARA BACK-UP DE BASE DE DADOS
Devido ao controle e configuraes internas do TOTVS DBACCESS, toda criao de backup e restore de backup de base de
dados, assim como replicao da base de dados para outros ambientes, deve ser feita atravs da importao de tabelas da
ferramenta APSDU. Isso garante a integridade das tabelas e correta interpretao dos dados pelo TOTVS DBACCESS e
consequentemente pelas aplicaes do Protheus. No utilize ferramentas de backup de tabelas diretamente pelo banco de
dados, pois isso pode exigir a reinicializao do servio e at mesmo a reinstalao do TOTVS DBACCESS.
RELAO DE/ PARA DE EMPRESAS / FILIAIS
Outros ERPs TOTVS diferentes do Protheus no possuem o conceito de Empresa/Filial como no Protheus, existindo uma ou
mais empresas/filiais distintas utilizando o mesmo sistema, so todas cadastradas no ERP como empresas diferentes. Alm
disso os cdigos de empresa do ERP so distintos dos cdigos de empresa/filial do Protheus. Por isso necessrio acessar o
cadastro da relao DE/PARA no mdulo configurador (Ambiente/Schedule/Emp.fil Msg.Unica) para cadastrar esta relao.
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 opo Incluir e preencha os campos conforme exemplo abaixo:
Itens/Pastas

Descrio

Referencia

LOGIX (nome do ERP externo)

Company

21 (cdigo da empresa no ERP)

Branch

(em branco)

Emp.Protheus

01

Fil.Protheus

10

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

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

ADEQUAO DO TAMANHO DOS CAMPOS DO PROTHEUS

O tamanho de campos de algumas tabelas do Easy precisar ser adequado para que fique compatvel com o tamanho
dos campos no ERP.
Campos como cdigo de cliente, cdigo de fornecedor e cdigo de produto podem ficar divergentes e gerar problemas de
integrao caso no fiquem com o mesmo numero de caracteres que o ERP.
Verifique o tamanho dos grupos de campos do Protheus atravs do mdulo configurador, na opo de menu Base de
dados / Dicionrio / Base de dados. Selecione a empresa do lado esquerdo da tela, selecione Dicionrio 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:
Grupo

Descrio

001

Cdigo de Cliente/Fornecedor

018

Documento de entrada/sada

030

Tamanho do Produto

083

Num. Solicitao de Importao

084

Unidade Requisitante

089

Cdigo de empresa / despachante

No caso de integrao com ERP Logix, possvel utilizar um facilitador para ajuste de tamanhos de campos do Protheus
para o tamanho de campo padro do Logix. Basta executar o compatibilizador U_UELOGIX, conforme as instrues
abaixo:
1. Em Microsiga Protheus TOTVS Smart Client (se verso 10) ou ByYou Smart Client (se verso 11), digite
U_UELOGIX no campo Programa Inicial.
Importante
Para a correta atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja igual ou superior a
03/10/2014.
2.

Clique em OK para continuar.

3.

Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado.

4.

Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.

5.

Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos.
apresentada uma mensagem explicativa na tela.

6.

Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas.
Nesse log de atualizao so apresentados somente os campos atualizados pelo programa. O compatibilizador cria
os campos que ainda no existem no dicionrio de dados.

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

7.

Clique em Gravar para salvar o histrico (log) apresentado.

8.

Clique em OK para encerrar o processamento

CONFIGURAO DO ADAPTER
O mdulo Easy Import Control est preparado para a realizao das integraes que seguem. Para configurar as integraes,
conforme a necessidade, siga as instrues abaixo:
1.

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

2.

Acesse a opo Incluir e informe os dados do adater, conforme as opes que seguem:
Itens/Pastas

Descrio

Rotina

EECAC120

Mensagem

ITEM

Descrio

PRODUTO

Envia

NO

Recebe

SIM

Mtodo

ASSNCRONO

Operao

TODAS

Canal de Envio

EAI

Verso

3.001

Itens/Pastas

Descrio

Rotina

EECAS125

Mensagem

UNITOFMEASURE

Descrio

UNIDADE DE MEDIDA

Envia

NO

Recebe

SIM

Mtodo

ASSNCRONO

Operao

TODAS

Canal de Envio

EAI

Verso

1.000

Itens/Pastas

Descrio

Rotina

EDCES400

Mensagem

ITEMSTRUCTURE

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

Descrio

ESTRUTURA DO PRODUTO

Envia

NO

Recebe

SIM

Mtodo

ASSNCRONO

Operao

TODAS

Canal de Envio

EAI

Verso

1.000

Procedimento para Utilizao

Integraes de cadastros
As integraes de cadastros ocorrem com origem no ERP com destino ao Easy. Algumas dessas integraes ocorrem de
forma sncrona e outras de forma assncrona.
Quando o cadastro possuir a integrao de forma sncrona, o ERP ir aguardar o Easy processar a integrao, e ento
exibir para o usurio se tudo ocorreu com sucesso ou se houve rejeio por parte do Easy. Quando as rejeies das
integraes ocorrem, o ERP no ir efetivar a operao realizada.
Quando o cadastro possuir integrao de forma assncrona, o ERP no ir aguardar o Easy processar a integrao e ir
efetivar a operao independentemente do processo de integrao. A mensagem de integrao entra em uma fila no
ERP para ser enviada ao Easy. Quando a integrao 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 integrao ocorre no Easy conforme a execuo da tarefa FWEAI configurada no Scheduler do
Protheus. Essa tarefa ir verificar todas as mensagens pendentes na fila do EAI e ir process-las. Aps o
processamento, ser enviada a mensagem ao ERP com o resultado da integrao. Em caso de rejeio na integrao, o
EAI pode tentar processar novamente a mensagem antes de retornar uma rejeio ao ERP.
Sequncia 1 Unidade de medida
1.

No mdulo Easy Drawback Control, acesse o menu Atualizaes \ Tabelas \ Unidades de Medida (EICUN100). Essa
tabela inicializada pelo sistema com uma carga padro.

2.

Para o uso desse cadastro quando integrado com o ERP via mensagem nica, ser realizada a atualizao dos dados de
desse cadastro, possibilitando sua associao ao cadastro correspondente no ERP de origem. A integrao ocorrer
atravs da mensagem UnitOfMeasure, adapter EECAS125, possibilitando o recebimento dos dados enviados pelo ERP.

3.

Acessando a opo Visualizar, certifique que o campo Cod. ERP (AH_CODERP) foi atualizado. A integrao tambm
atualizar o contedo do campo Descr.Portug (AH_DESCPO).

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI

Boletim Tcnico

4.

Caso seja identificado que a integrao no ocorreu, deve ser verificado no ERP de origem as mensagens e validaes
reportadas pela integrao.

5.

Importante: o cdigo da unidade de medida no mdulo Easy Import Control possui tamanho 2 (dois). Se no ERP de
origem o tamanho dessa informao for superior a 2 (dois), dever ser feito o relacionamento entre estas informaes. O
relacionamento entre estes cadastros realizado manualmente no mdulo Easy Import Control, cadastro de unidade de
medidas (Atualizaes \ Tabelas Siscomex \ Unidades de Medida), atravs do campo Cod. ERP (AH_CODERP).

Sequncia 2 Cadastro de Produtos

1.

Acessando o menu Atualizaes \ Tabelas \ Produtos Export (EECAC120) ou Itens Importao (MATA010) ser possvel
verificar se os cadastros dos produtos foram integrados. Essa integrao ocorrer atravs da mensagem ITEM, adapter
EECAC120, recebida do ERP com o qual o Easy Drawback Control est integrado.

2.

Caso seja identificado que a integrao no ocorreu, deve ser verificado no ERP de origem as mensagens e validaes
reportadas pela integrao.

Sequncia 3 Cadastro de Estrutura do Produto

1.

Acessando o menu Atualizaes \ Tabelas \ Estruturas (EDCES400) ser possvel verificar se os cadastros de estruturas
dos produtos foram integrados. Essa integrao ocorrer atravs da mensagem ITEMSTRUCTURE, adapter EDCES400,
recebida do ERP com o qual o Easy Drawback Control est integrado.

2.

Caso seja identificado que a integrao no ocorreu, deve ser verificado no ERP de origem as mensagens e validaes
reportadas pela integrao.

3.

Uma vez integradas as estruturas dos produtos, o cadastro estar pronto para ser usado na criao de um processo de
ato concessrio.

Informaes Tcnicas
Tabelas Utilizadas

Tabela SB1 Descrio Genrica do Produto.

Tabela SAH Unidades de Medida.
Tabela SG1 Estrutura dos Produtos.

Rotinas Envolvidas

EECAC120 Cadastro de Produtos.

EECAS125 Unidades de Medida.
EDCES400 Estruturas.

Sistemas Operacionais

Windows/Linux

SIGAEDC - Integrao do Easy Drawback Control via

Mensagem nica EAI