Manuais by You Entenda como configurar a integração entre o by You e o ERP Protheus Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 1/20
Manuais by You
Entenda como configurar a integração
entre o by You e o ERP Protheus
Janeiro/2013 – v1.0
Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 2/20
Este manual tem o objetivo de explicar como utilizar os aplicativos
Protheus na rede corporativa do by You.
Para que a funcionalidade seja habilitada, é necessário realizar o
procedimento abaixo:
• Configurar no Protheus os dados da Integração
• Cadastrar o servidor do Protheus no by You
• Cadastrar o ambiente do Protheus no by You
Após realizar as configurações acima, os usuários do by You poderão
adicionar os aplicativos do Protheus à sua área de aplicativos.
Manuais by You Integração Protheus
Pré-requisitos
• Ser administrador do tenante no by You
• Ser administrador do Protheus
• Ter conhecimentos do funcionamento de WebServices dentro do Protheus
• Ter um certificado SSL que será utilizado no Protheus
• Utilizar a versão 11 do Protheus
• Aplicar o pacote de LIB contendo os fontes: APLIB260.PRW com data igual
ou superior a 08/03/2013 e FWGETWIDGET.PRW com data igual ou superior
a 26/02/2013;
• Versão do SmartClient HTML:
2.0.12 (para build 7.00.120420A) e 2.1.2 (para build 7.00.121227P)
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 3/20
Configure no Protheus os dadosda integração
Para configurar o Protheus, siga os passos abaixo:
1) Configuração de HTTPS e WebService
1.1) Acesse o Programa Inicial “ApWebWizard”:
1.2) Acesse as configurações HTTPS através do menu “Servidor Internet
(HTTP/FTP)”! “HTTPS”;
1.2.1) Habilite o protocolo HTTPS, preencher o PATH de arquivos
com uma pasta válida e uma porta desejada para o serviço:
Manuais by You Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 4/20
1.3) Acesse as configurações SSL através do menu “Conexão (Server/
Remote)”! “SSLCONFIGURE”
1.3.1) Coloque o caminho completo de onde estão os arquivos do
certificado SSL e a senha do certificado:
Manuais by You Integração Protheus
1.4) Adicione WebService através do menu Módulos Web:
1.4.1) Habilite o serviço de webservices no Protheus, se não estiver
habilitado. Para mais informações sobre esse ponto, consulte o
manual do Protheus.
1.4.2) Selecione o módulo “WS”, coloque o nome da instancia que
deseja, e selecione o “Enviromment”:
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 5/20
1.4.3) Coloque o caminho completo de onde estão os arquivos do
certificado SSL e a senha do certificado:
Autenticação -> IP:Porta(HTTPS)/(ambiente)/oauth/1 e relacionar a uma empresa (qualquer
empresa, não influencia na integração com o by You):
Manuais by You Integração Protheus
1.4.4) Defina a expectativa de usuários e finalize o cadastro:
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 6/20
2) Cadastro do aplicativo no Protheus
2.1) Acesse o Configurador do Protheus (SIGACFG )
2.2) Acesse o menu: Usuário! Senhas! Política
2.3) Acesse a aba “Client ByYou”
2.3.1) Preencha os campos: Endereço IP e Porta do serviço HTTPS
(Configurado no passo anterior), IP e porta do SmartClient HTML.2.3.2) Clique no botão Gerar Chaves, e pressione o botão “Sim” para
confirmar a geração.
2.3.3) Clique no botão Confirmar para salvar os dados, será
apresentada uma tela perguntando se deseja enviar as informações
do cadastro por e-mail. Estas informações são utilizadas para o
cadastro do Protheus no by You.
Manuais by You Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 7/20
Cadastre o servidor do Protheusno by You
1) Acesse o painel administrativo, e escolha a opção do menu
Aplicativo → Cadastrar servidores ERP
Manuais by You Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 8/20
2) Clique no botão Criar servidor e insira as informações do servidor
Protheus
Manuais by You Integração Protheus
Código: Identifica o servidor (informação definida pelo usuário)Descrição: Descrição do servidor (informação definida pelo usuário)IP: Obter essa informação no Protheus
Porta: Obter essa informação no Protheus
Ambiente: Obter essa informação no Protheus Obs: Os dados do Protheus são obtidos no passo 2.3.3 da Configuração do Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 9/20
Cadastre o ambiente do Protheusno by You
1) Acesse o painel administrativo, e escolha a opção do menu
Aplicativo → Cadastrar ambiente ERP e escolha o servidor que deseja
associar o ambiente
Manuais by You Integração Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 10/20
2) Clique no botão Criar ambiente e insira as informações do ambiente
Protheus e do SmartClient
Manuais by You Integração Protheus
Código: Identifica o ambiente (informação definida pelo usuário)Descrição: Descrição do ambiente (informação definida pelo usuário)Chave Pública: Obter essa informação no Protheus
Chave Privada: Obter essa informação no ProtheusComunicação: Definição do protocolo de comunicação com o SmartClient. O Valor padrão é “TCP”.
Ambiente: Obter essa informação no Protheus
Idioma: Configuração do idioma
URL SmartClient HTML: IP e porta de acesso ao SmartClientWebServices comunicação produto: WebServices que realizará a comunicação entre o by You e
Protheus. Essa informação se encontra na Lista de Serviços Ativos (wsindex.apw) do Protheus. Procurarpelo nome de serviço “FWWSPROTHEUSWIDGET” e copiar o valor do campo “URL da Descrição do
Serviço (WSDL)”
Obs: Os dados do Protheus são obtidos no passo 2.3.3 da Configuração do Protheus
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 11/20
Incluir aplicativo do usuário
Finalizada a configuração do servidor e do ambiente, o usuário poderá
adicionar os aplicativos do Protheus em sua área de Aplicativos,
seguindo os passos abaixo:
Manuais by You Integração Protheus
1) No perfil corporativo, acesse a opção de menu Aplicativos.
Anexo 1
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 12/20
Manuais by You Integração Protheus
2) Ao abrir a página de aplicativos, clique no botão Incluir aplicativo e
selecione o servidor e o ambiente. Feito isso, clique no botão Buscar
Aplicativos.
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 13/20
Manuais by You Integração Protheus
3) No primeiro acesso irá abrir a tela de login do Protheus.
Obs.: Verificar o bloqueador de Popups, pois neste momento uma nova janela iráabrir no navegador.
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 14/20
Manuais by You Integração Protheus
4) Após realizar o login, o menu é carregado na tela. Navegue nas
categorias até selecionar o aplicativo.
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 15/20
Manuais by You Integração Protheus
5) Ao selecionar o aplicativo aparecerá uma janela com algumas
informações sobre o aplicativo que podem ser alteradas.
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 16/20
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 17/20
Manuais by You Integração Protheus
7) Para alterar ou remover o aplicativo clique nos botões que aparecem
à direita do aplicativo quando selecionado.
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 18/20
Remoção de servidor ERP no by You
Caso seja necessário remover o servidor, clique no “X” ao lado do código
do servidor na listagem dos servidores cadastrados.
Irá aparecer uma caixa de diálogo com a opção para remover todos os
ambientes e aplicativos associados a este servidor. Caso seja esta a
intenção, selecione o checkbox e todas as informações associadas
também serão removidas.
Manuais by You Integração Protheus
Anexo 2
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 19/20
Remoção de ambiente ERP no by You
Caso seja necessário remover o ambiente, clique no “X” ao lado do
código do ambiente na listagem dos ambientes cadastrados.
Irá aparecer uma caixa de diálogo com a opção para remover todos os
aplicativos associados ao ambiente. Caso seja esta a intenção, selecionar
o checkbox e todas as informações associadas também serão removidas.
Manuais by You Integração Protheus
Anexo 3
8/13/2019 Byyou Protheus
http://slidepdf.com/reader/full/byyou-protheus 20/20
Por dentro do by You
Acesse a comunidade Por dentro do by You, no
ambiente pessoal do by You, para saber de todos os
detalhes de releases, melhorias e novidades da rede.
by You nas redes sociais
Fale conosco
Siga o by You nas redes sociais e fique por dentro das novidades:
Youtube: www.youtube.com/byYouSocial
Facebook: www.facebook.com/byYouSocial
Twitter: www.twitter.com/byYouSocial
LinkedIn: www.linkedin.com/company/by-you
Interessado no by You? Fale com a nossa equipe:
8 882 9191social.byyou.com
Até mais!
Manuais by You Integração Protheus