Integrador TOTVS PROTHEUS x SHOPIFY
O Integrador TOTVS PROTHEUS x SHOPIFY da Intergate, também chamado de Conectorgate é um pacote de rotinas PROTHEUS ADVPL, executadas no Ambiente PROTHEUS do cliente, que de tempos em tempos sincronizam os dados de Ecommerce entre o ERP TOTVS PROTHEUS e a Plataforma SHOPIFY.
De modo automatizado todas as informações de ecommerce estarão sempre “batendo” entre o ERP PROTHEUS e o SHOPIFY.
Entre alguns diferenciais do Integrador TOTVS PROTHEUS x SHOPIFY podemos destacar o foco em Segurança, Monitoramento e Escalabilidade:
- Além dos controles de acesso aos dados e LGPD inerentes ao Integrador, sempre utilizamos para as gravações no ERP PROTHEUS o recurso PROTHEUS de “Execução Automática” (ExecAuto), o que garante o correto processamento de todas as customizações e regras específicas do cliente.
- Além disso, todos os processos do Integrador são registrados em tabelas de log no banco de dados, sendo disponibilizados através de um Portal de Monitoramento web responsivo.
- O Integrador permite facilmente incluir tratamento para campos de usuário, bem como modificar alguma regra de negócio específica caso necessário. Tudo de modo ágil, garantindo a escalabilidade do Integrador.
Instalação em Ambiente TOTVS PROTHEUS
O Integrador TOTVS PROTHEUS x SHOPIFY é uma solução fracamente acoplada, e é basicamente composto de 2 componentes instalados no Ambiente PROTHEUS do cliente: API REST customizada (instalada em APPSERVER PROTHEUS REST – agente passivo) e RPA shopifyRPA (instalado no SCHEDULE/Menu PROTHEUS – agente ativo).
Abaixo o check-list de Pré-Requisitos do Ambiente PROTHEUS do cliente:
- Configurar APPSERVER REST (usa licença TOTVS I, o server deve ser liberado para 3 IP INTERGATE)
- Instalar pacotes/patches INTERGATE (ConectorGate + salesAPI + finAPI + shopifyRPA)
- Criar campos default I_N_S_D_T_ e S_T_A_M_P_ (tabelas SA1, SB1, SB2, SC5, SF2)
- Criar 2 campos de usuário usados pelo Integrador (2x SC5)
- Configurar SCHEDULE (para execuções automáticas) e/ou MENU (para execuções manuais)
Projeto de Implantação
O Projeto de Implantação do Integrador TOTVS PROTHEUS x SHOPIFY é realizado em algumas poucas etapas, visando essencialmente validar Regras de Negócio e homologar as rotinas de carga e atualização do Integrador:
- BBP/Regras de Negócio: nesta etapa as regras de negócio do Integrados são validadas em relação à operação usual do ERP TOTVS PROTHEUS pelo cliente. Entre as principais regras a serem revisadas estão: DE-PARA de filiais e depósitos, DE-PARA de condições de pagamento, DE-PARA de transportadoras e campos de usuário no ERP e no SHOPIFY.
- Homologação: nesta etapa os processos do Integrador são validados pelo cliente. Basicamente temos a Homologação da Carga de Dados (caso necessária para produtos, preços e estoques), e a Homologação dos Testes Unitários (com validação dos processos usuais e diários realizados no PROTHEUS e no SHOPIFY, e que devem refletir no outro sistema).
- Cutover/Golive: nesta etapa, realizada após Aceite da Homologação, o ambiente TOTVS PROTHEUS de Produção é preparado, a carga de dados full entre PROTHEUS e SHOPIFY é realizada (caso necessário) e o Integrador é ativado no SCHEDULE do PROTHEUS.
Processos do Integrador
As rotinas do integrador podem ser configuradas em algum MENU PROTHEUS (para execução manual), ou podem ser configuradas no SCHEDULE PROTHEUS (para execução automática).
Basicamente podemos dividir os Processos do Integrador em 2 fluxos: PROTHEUS para SHOPIFY, e SHOPIFY para PROTHEUS.
- No fluxo do ERP para o SHOPIFY temos em geral 5 processos: Produtos, Preços e Estoques, Notas e Status (opcional).
- No fluxo do SHOPIFY para o ERP temos basicamente 1 processo: Pedidos/Clientes.
Abaixo a relação de rotinas do Integrador para inclusão em MENU PROTHEUS:
| ROTINA | DESCRIÇÃO | TIPO | TABELAS |
|---|---|---|---|
| SHPY_SIT | Envia Produtos | Função de Usuário | SB1 |
| SHPY_SPR | Envia Preços | Função de Usuário | SB1 DA1 |
| SHPY_SST | Envia Estoques | Função de Usuário | SB1 SB2 |
| SHPY_SSI | Envia Notas | Função de Usuário | SA1 SF2 SD2 SF3 |
| ??? | Envia Status/Track | Função de Usuário | SC5 |
| SHPY_GSO | Captura Pedidos | Função de Usuário | SA1 SC5 SC6 |
Abaixo a relação de rotinas do Integrador para inclusão no SCHEDULE PROTHEUS:
| ROTINA | DESCRIÇÃO | EMPRESA/FILIAL | RECORRÊNCIA |
|---|---|---|---|
| U_SHPYSSIT() | Envia Produtos | 01/01; | Cliente define |
| U_SHPYSSPR() | Envia Preços | 01/01; | Cliente define |
| U_SHPYSSST() | Envia Estoques | 01/01; | Cliente define |
| U_SHPYSSSI() | Envia Notas | 01/01; | Cliente define |
| U_???() | Envia Status/Track | 01/01; | Cliente define |
| U_SHPYSGSO() | Captura Pedidos | 01/01; | Cliente define |
Configuração do Integrador PROTHEUS x SHOPIFY
Abaixo relacionamos os principais parâmetros (SX6) relacionados com a Configuração do Integrador PROTHEUS x SHOPIFY:
- API REST:
- IG_APIPROT: API – Protocolo
- IG_APIENDP: API – Endpoint
- IG_APIUSER: API – User
- IG_APIPASS: API – Password
- APP SHOPIFY:
- IG_APPPROT: APP – Protocolo API
- IG_APPENDP: APP – Endpoint API
- IG_APPKEY: APP – Chave de acesso API (credor se for único)
- IG_APPTOKE: APP – Token de acesso API
- IG_APPUSER: PP – User de acesso API
- Operação do Integrador:
- IG_APPQTYP: Tipo de consulta utilizada pelo Integrador (full/incremental)
- IG_APPDINC: Dias para retroceder na consulta incremental (normalmente igual a 0)
- Campos de usuário:
- IG_CBACID: Campo de usuario na SC5 para id do Pedido SHOPIFY
- IG_CBCTID: Campo de usuario na SC5 para valor do Pedido SHOPIFY
Monitoramento
O Integrador PROTHEUS x SHOPIFY conta com exclusivo sistema de monitoramento, através de Portal Web responsivo com os principais indicadores e rastreamento de processos e falhas.
Além do monitoramento ativo dos processos de integração, alertas específicos podem ser implementados visando aumentar a eficiência.
Conclusões
Com o Integrador PROTHEUS x SHOPIFY todas as informações relacionadas com o Ecommerce do ERP estarão sempre automaticamente sincronizadas com o SHOPIFY, evitando intervenção humana e elevando muito a eficiência de seu processo de vendas online.
Saiba mais:
