Integração Microsiga Protheus e VTEX via SalesOrder (EAI) - Integração Faturamento

1. RPO atualizado
2. É imprescindível  estar com a Lib atualizada:

   Versão mínima da Lib:20190131

   Data da Lib: 20190215_9053

3. É imprecindível estar com o Binário atualizado. 
   Versão mínima da Build AppServer: 7.00.131227A-20190114 NG
   
   
4. É imprescindível efetuar a configuração do Appserver e DBAccess, para suportar mensagens com até 30MB.

A ausência dessa configuração pode gerar o erro de "String size overflow"  para mensagens com muitos itens.

Arquivo Appserver.ini:

Efetue a inclusão das chaves abaixo:

[Environment]

TopMemoMega =30

[General]

MaxStringSize=30

Exemplo:

No DBAccess altere o arquivo DBAccess.ini:

Efetue a inclusão da chave abaixo:

[General]

MaxStringSize=30

Exemplo:

Para mais detalhes, acesse o link : Melhoria - Suporte a campo MEMO com mais de 1 MB

Para que o Protheus seja capaz de enviar ou  receber mensagens para VTEX é necessário que seja configurado as Rotas, informando o endereço HTTP do servidor VTEX. 

 1. Para isso utilize a rotina Cadastro de Rotas EAI no Módulo Configurador(SIGACFG) na opção Ambiente\Schedule\Cadastro de Rotas EAI.

  2. Pressione o botão Incluir para cadastrar a rota do sistema VTEX

  3. Preencha os campos da tela abaixo:

Onde:

Produto : Deve conter o nome do Produto com o qual o PROTHEUS irá ser integrado. Deve-se obrigatoriamente usar a palavra: VTEX

Aplicação : Deve ser o nome do Produto utilizado na integração (obs.: Quando recepcionamos uma mensagem da VTEX, o sistema verifica este campo que deve estar de acordo com a TAG <SourceApplication>  ) Deve-se obrigatoriamente usar a palavra: VTEX

Url : É o caminho ou endereço do servidor de destino.  A URL deve ser solicitada para VTEX                                                                                          

Client WS :  É o tipo do cliente utilizado.  Padrão: WSEAISERVICE

Metodo : É o método do utilizado para a integração. Padrão: receiveMessage

Usuário : Usuário utilizado caso o destino obrigue a ter um usuário padrão

Canal Env : Especificamos o tipo da integração  que para VTEX deve ser  2-REST

Senha : Palavra chave para a validação e liberação dos acesso no destino , caso este precise de validação

Para que o EAI Protheus seja capaz de receber mensagens da VTEX (para o envio o Protheus não faz o consumo do seu serviço Web, e sim do serviço do outro sistema) é necessário que seja habilitado o protocolo HTTP/REST no servidor e que as configurações de WebServices estejam ativas.

Para isto é necessário configurar o arquivo appserver.ini do servidor Protheus. 

Para isso é necessário configurar o REST Padrão do Protheus. Veja mais detalhes nos links abaixo:

• Configuração do serviço REST Configuração REST SERVER - Protheus.
  
• Mais detalhes sobre o conceito de um serviço REST clique aqui.
• Para mais detalhes sobre serviços REST na arquitetura Protheus clique aqui.

Exemplo de configuração Protheus REST:

1. Analisando um exemplo de REST no Appserver.ini:
   
   
   
   

2. Inicie o navegador de Internet e informe o endereço do servidor e da porta do serviço REST ex: http://127.0.0.1:8070

      Observe a apresentação da Lista serviços REST disponíveis:

      Realize o teste de uma rede externa(3G/Outra Rede fora da empresa)  para saber se o acesso externo está liberado.

   
   

   Deve aparecer a lista de serviços como no exemplo abaixo:
   

 3 - Na lista de Serviço localize o serviço EAISERVICE:

      Clique em "For more details" para exibir os detalhes do serviço: 

4 - Nos Detalhes do serviço localize o serviço do tipo POST de nome: "standardmessage/v1/transactions"

     Esse é o serviço responsável por receber as mensagens da VTEX 

5 - Será necessário enviar o Endereço do Serviço Protheus para VTEX. 

O endereço é formado pelo IP do servidor(IP Externo) e porta definido no serviço REST + totvseai/standardmessage/v1/transactions/

O caminho do serviço completo ficaria assim:    http://127.0.0.1:8070/totvseai/standardmessage/v1/transactions/

Cadastro de Adapters:

         O cadastro de adapters são rotinas responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão do adapter no Protheus.

  Pré requisitos:

• Para realizar o cadastro/configuração do adapter  é necessário ter uma ROTA cadastrada, para cadastrá-la acesse o link: Cadastro de Rotas EAI.
  
  

1. No Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i

2. Efetue a Inclusão de  uma nova rotina  para os Adapters do sistema Protheus.

   Configure a rotina do Adapter, de acordo com  a tabela abaixo que já foram pré estabelecidos  para a integração:

Mensagem única: Sim
Rotina: Nome do adapter 
Mensagem: Nome da mensagem única que o Adapter EAI  espera receber.
Descrição: Identificação da mensagem.
Envia: SIM (se envia a informação para VTEX) ou NÃO ( Se não envia nenhuma informação deste adapter para VTEX).
Recebe: SIM (se recebe a informação do VTEX) ou NÃO ( Se não recebe nenhuma informação deste adapter do VTEX).
Método: Síncrono/Assincrono
Operação: Todas
Canal de Envio: Para VTEX =  3-PAD.APP

Formato: JSON 

        Roteamento de mensagens: Informar a rota criada no cadastro de rota e se envia de acordo com a integração (ver tabela abaixo).

Exemplo de Cadastro:

Efetue a inclusão dos Adapters, conforme tabela abaixo: 

Importante 

Informar a Rota de acordo com o Cadastro de Rotas EAI.

Cadastro de De/Para de Empresas:

No EAI Protheus deve-se cadastrar um relacionamento entre a Empresa e Filial do VTEX com uma existente no Protheus. Isto se deve ao fato de que, na Mensagem Única TOTVS

os valores trafegados na mensagem são sempre do sistema que enviou a mensagem, cabendo ao sistema receptor a tradução das informações trafegadas.

1. 1. No Configurador (SIFACFG), acesse Ambientes/Schedule/Emp.Fil.Msg.Unica.
   2. Cadastre  De-Para de Empresas e Filiais e configure-os conforme os valores a seguir:

• • Referência: VTEX
  • Empresa :  Código da Empresa VTEX a integrar.
  • Filial: Código da Filial VTEX a integrar
  • Grupo Emp. Protheus: Código da Empresa no Protheus a integrar com o sistema VTEX 
  • Fil. Protheus: Código da Filial no Protheus  a integrar com o sistema  VTEX 
    
    Exemplo:
  • Referência: VTEX
  • Empresa : T3   
  • Filial: D MG 01 
  • Grupo Emp. Protheus: T3  
  • Fil. Protheus: D MG 01