Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Programas fontes envolvidos :

  1. O ambiente Protheus ( RPO ) deve possuir esses programas com datas iguais ou superiores :

LJRETAILWIZ.PRW -  
LJRETAILAPP   


Sistema Operacionais:

Windows®/Linux®
Banco de dados:Todos Relacionais
Servidor:É recomendável um serviço ( appserver.ini ) separado para o RetailApp.
Capacidade máxima da String

Conforme documentação: http://www.tdn.totvs.com/display/tec/MaxStringSize, é necessário alterar o tamanho da capacidade da string no appserver.ini conforme exemplo:

[general]
maxStringSize=500

Incluir a chave TopMemoMega conforme documentação: http://tdn.totvs.com/display/tec/TOPMemoMega

Certificado Digital:

A configuração do certificado digital é obrigatória para utilizar o protocolo seguro (HTTPS) , os detalhes da configuração que deve ser realizado no server do Protheus ( appserver.ini )
está no link
( clique aqui )


Antes de realizar a configuração é necessário verificar se o certificado está convertido:

Conversão de certificados ‘PFX’ para ‘PEM’ – Windows

Esse procedimento destina-se, exclusivamente, aos usuários do Sistema operacional Windows.

Análise da cadeia de certificação

Ao receber um certificado digital do tipo A1, antes da conversão para o formato PEM, recomenda-se a análise de alguns pontos importantes, para que não haja problemas com a conexão SSL3 e com a Secretaria de Fazenda.

Primeiramente, é necessário instalar o certificado para visualizá-lo. O procedimento é feito da seguinte forma:

  1. Faça um duplo clique no arquivo PFX para acessar a tela do Assistente de Instalação.
  2. Clique em Avançar e, posteriormente, em Arquivo a ser Importado.
  3. Selecione o arquivo que deseja importar e clique em Avançar.
  4. Assinale uma das três opções disponíveis: Formato Apache (.pem); Formato PFX (.pfx ou .p12) ou HSM.
  5. Clique em Avançar. O Sistema operacional armazena o certificado automaticamente.
  6. Clique em Concluir para efetivar a instalação do certificado.
  7. Abra uma página de Internet e acesse as opções Ferramentas / Opções da Internet / Conteúdo / Certificados.
  8. Selecione o certificado digital instalado.
  9. Clique em Exibir e em Caminho de Certificação, Verifique a existência de todos os certificados apresentados no Caminho de Certificação. Caso negativo, é necessário contatar o fornecedor do certificado digital para realizar a instalação.
  10. Se o certificado estiver instalado, clique em Exibir Certificado.

Algumas Secretarias de Fazenda exigem toda a cadeia da certificação para permitir a conexão SSL3. Caso o certificado seja instalado sem todos os certificados contidos na cadeia de certificação, o acesso é feito apenas em algumas Secretarias da Fazenda.

Se isso ocorrer, siga os procedimentos já descritos a fim de solucionar o problema de conexão.

Exportação do certificado digital

Após concluir a análise do certificado digital, é necessário exportá-lo juntamente com a chave privada.

  1. Clique Exportar. Um Wizard é apresentado. Siga o procedimento prescrito.
  2. Assinale a opção que permite exportar a chave privada ou particular.
  3. Assinale a opção que inclua todos os certificados no caminho de certificação e todas as propriedades estendidas.
  4. Informe a senha do certificado.
  5. Conclua a operação informando o arquivo de destino.
  6. Clique em Remover. Esta tarefa é fundamental para a segurança do certificado digital.



Conversão de certificados ‘PFX’ para ‘PEM’ – Linux

Este procedimento destina-se aos usuários do Sistema operacional Linux.

Para converter o certificado digital de ‘PFX’ para ‘PEM’ é necessário o utilitário ‘OpenSSL’. Acesse http://www.openssl.org/source/.

Após instalar o utilitário ‘OpenSSL‘, execute os seguintes comandos:

  • Para obter o CertificadoClient: openssl pkcs12 -in <nome do certificado de origem> -out <nome do certificado de destino>_cer.pem
  • Para obter o KeyClient: openssl pkcs12 -in <nome do certificado de origem>  -nocerts -out <nome do certificado de destino>_key.pem ->KeyClient

Um exemplo de configuração no appserver.ini utilizado :

[SSLConfigure]

TRYPROTOCOLS=1

HSM=0
SSL2=0
SSL3=0
TLS1=1
TLS1_0=1
TLS1_1=1
TLS1_2=1
BUGS=1

CertificateClient=C:\Protheus\Protheus_data\certificado\000002_all.pem

KeyClient=C:\Protheus\Protheus_data\certificado\000002_key.pem
PassPhrase=( senha de acesso a chave privada ou certificado )

Rotinas no Menu:

  1.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013)
  2.  Informe as novas opções de menu do Controle de Lojas ( SIGALOJA), conforme instruções a seguir:
 Menu Miscelânea

Submenu

Integração RetailAPP

Nome da Rotina

Setup Inicial

Programa

LJRETAILSI

Módulo

Controle de Lojas
Menu  Miscelânea

Submenu

Integração RetailAPP

Nome da Rotina

Carga Dados

Programa

LJRETAILDF

Módulo

Controle de Lojas

 Nesse link você encontra o passo a passo para incluir uma rotina no configurador (apenas exemplo) ( clique aqui )

Parâmetros:

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017).
  2. Crie os parâmetros a seguir: 

Itens/Pastas

Descrição

Nome

MV_LJRAPP0

Tipo:

Caracter

Cont. Por

Deixar em branco, pois serão preenchidos automaticamente na rotina de carga inicial

Descrição

Esse parâmetro contém as informações sobres os caminhos ( URLs ) de integração com a RetailApp™ , as informações são separadas pela barra vertical pipe ( | ), na

seguinte sequência : URL de login | URL dos dados | URL de cálculo , conforme exemplo abaixo default abaixo 

https://woolton-backend.azurewebsites.net/api/login|https://woolton-backend.azurewebsites.net/api/data 

Itens/Pastas

Descrição

Nome

MV_LJRAPP1

Tipo:

Caracter

Cont. Por

Deixar em branco, pois serão preenchidos automaticamente na rotina de carga inicial.

Descrição

Esse parâmetro contém as informações de setup da integração , as informações são separadas pela barra vertical pipe ( | ) ,

na seguinte sequência : usuário (email) de conexão com o App | senha de conexão | quantidade de dias para o processamento | códigos das TES | minutos de intervalo

para a execução do job de carga ,exemplo de conteúdo default : teste@teste.com.br|teste123|7|501,502|15.

Habilitar Campos

Para realizar a integração, necessário habilitar os campos reservados: F2_MSEXP.

  1. No Configurador ( SIGACFG) acesse Base de Dados /Dicionário /Base de Dados.
  2. Selecione a opção Dicionario de Dados.
  3. Selecione a tabela correspondente ( SF2) 
  4. Ao entrar no cadastro através da função, clique em editar.
  5. Selecione a opção Campos.
  6. Na barra superior,(6) clique no botão Campos reservados.
  7. Selecione a opção Ident. Exp. Dados.

8. Salvar a alteração.

9. Atualizar o dicionário.

Para conferir o envio das informações para RetailApp, é necessário habilitar os campos reservados das tabelas SF1 (NF. Entrada), SA3 ( Vendedor), SB1 ( Produto e Estoque) e SE1 (Título a Reber - )

  1. No Configurador ( SIGACFG) acesse Base de Dados /Dicionário /Base de Dados.
  2. Selecione a opção Dicionario de Dados.
  3. Selecione a tabela correspondente (SF1) 
  4. Ao entrar no cadastro através da função, clique em editar.
  5. Selecione a opção Campos.
  6. Na barra superior,(6) clique no botão Campos reservados.
  7. Selecione a opção Ident. Exp. Dados.
  8. Salvar a alteração.

  9. Atualizar o dicionário.

  1. No Configurador ( SIGACFG) acesse Base de Dados /Dicionário /Base de Dados.
  2. Selecione a opção Dicionario de Dados.
  3. Selecione a tabela correspondente (SA3) 
  4. Ao entrar no cadastro através da função, clique em editar.
  5. Selecione a opção Campos.
  6. Na barra superior,(6) clique no botão Campos reservados.
  7. Selecione a opção Ident. Exp. Dados.
  8. Salvar a alteração.

  9. Atualizar o dicionário.

  1. No Configurador ( SIGACFG) acesse Base de Dados /Dicionário /Base de Dados.
  2. Selecione a opção Dicionario de Dados.
  3. Selecione a tabela correspondente (SB1) 
  4. Ao entrar no cadastro através da função, clique em editar.
  5. Selecione a opção Campos.
  6. Na barra superior,(6) clique no botão Campos reservados.
  7. Selecione a opção Ident. Exp. Dados.
  8. Salvar a alteração.
  9. Atualizar o dicionário.

  10. No Configurador ( SIGACFG) acesse Base de Dados /Dicionário /Base de Dados.
  11. Selecione a opção Dicionario de Dados.
  12. Selecione a tabela correspondente (SE1) 
  13. Ao entrar no cadastro através da função, clique em editar.
  14. Selecione a opção Campos.
  15. Na barra superior,(6) clique no botão Campos reservados.
  16. Selecione a opção Ident. Exp. Dados.
  17. Salvar a alteração.
  18. Atualizar o dicionário.



...