Para realizar uma integração com um sistema nativo do nosso Ecossistema são necessárias 5 etapas, sendo elas:
1ª Identificar qual dos dois sistemas envolvidos será o sistema que mandará a informação desejada para o outro sistema.
2ª Na área administrativa do sistema que mandará a informação, criar uma chave de integração em Integrações >> Terceiros >> Adicionar e preencher os seguintes campos:
Nome da Integração → Nome do módulo ao qual irá se integrar
URI - Domínio → URI limpa do sistema ao qual irá se integrar, sem https, pontos ou barras. Ex.: “loja.dominio.com.br”
URI - Hook → URI do sistema ao qual irá se integrar, pode ser com ou sem o S do HTTP, depende se os sistemas estão ou não no mesmo servidor. Caso estejam no mesmo servidor, será “HTTPS”, caso estejam em servidores diferentes, será “HTTP”
Data de Expiração → Data de validade das chaves que serão geradas.
Assim que clicar em salvar, serão disponibilizadas duas chaves diferentes que serão usadas nas próximas etapas: App Key e Secret Key.
3ª Ir para o ambiente do sistema que receberá as informações e colocar as chaves geradas em terceiros. Para isso basta acessar Integrações >> Módulos >> Adicionar, preencher o campo de “Descrição” com o nome do sistema ao qual irá se integrar e selecionar qual o tipo de módulo está se integrando.
4ª Clicando em salvar, será aberta uma nova aba de “Definições”, onde será necessário preencher os seguintes campos:
URL API → URL do sistema ao qual irá se integrar, pode ser com ou sem o S do HTTP, depende se os sistemas estão ou não no mesmo servidor. Caso estejam no mesmo servidor, será “HTTP”, caso estejam em servidores diferentes, será “HTTPS” e em ambos os cenários, colocar o /api no final. Ex.: “http://loja.dominio.com.br/api”
AppKey → Chave de AppKey gerada no sistema terceiro na 2ª etapa.
SecretKey → Chave de SecretKey gerada no sistema terceiro na 2ª etapa.
5ª Ao clicar em salvar, sua integração terá sido realizada com sucesso!
Obs: Todas as informações necessárias sobre os ambientes e servidores serão passadas ao Gestor Master da empresa, para que assim, as integração sejam efetuadas com êxito.