Integrando com a Magento
Veja o passo a passo para realizar a integração com a Magento.
IMPORTANTE:
-
Nunca proceda com a instalação sem realizar um backup completo de toda a aplicação (arquivos e banco de dados);
-
Evite realizar a instalação em ambientes oficiais/produção sem validar previamente em um ambiente de teste.
1. Extraindo os arquivos na Magento
Acesse o diretório onde o Magento 2 está instalado e extraia os arquivos na pasta indicada abaixo. Caso ela não exista, você pode criá-la:
/app/code/
Garanta que todos os arquivos relacionados ao módulo tenham sido descompactados corretamente.
2. Instalando Modulo na Magento
No terminal SSH, execute os seguintes comandos:
php bin/magento deploy:mode:set developer; php bin/magento setup:upgrade; php bin/magento setup:static-content:deploy -f;
Observação: Caso seu servidor utilize OPCache, Redis, Varnish ou Cache DNS, lembre-se de limpar o cache desses serviços.
3. Acessando o sistema da Appmax
3.1 Acesse o Painel Administrativo Inserindo login e senha, conforme Figura 1.
Figura 1: Fazendo o login;
3.2. Clicar no menu “Integrações” e em seguida em “Nova integração”.
Figura 2: Clicando no menu “Integrações;
Figura 3: Clicando no menu “Nova integração”;
3.3 Precisa selecionar a opção “Magento” para iniciar a configuração de integração. O sistema vai abrir um pop-up para confirmar a opção selecionada na tela anterior.
Figura 4: Escolhendo a opção “Magento”;
Figura 5: Escolhendo a opção “Magento”;
3.4 O Wizard possui helpers para esclarecer o usuário em caso de dúvida sobre algum tópico na configuração de loja.
Figura 6: Visualizando o helper;
3.5 A primeira aba de “Dados Gerais” refere-se ao cadastro de informações básicas do seu site. Sendo assim, é obrigatório inserir o nome da loja, selecionar a empresa que foi criada no onboarding, página de vendas, e-mail e telefone de suporte para os clientes.
Figura 7: Inserindo as informações básicas da loja;
3.6 Na primeira etapa também é preciso selecionar o modelo de negócio.
Figura 8: Selecionando o modelo de negócio;
3.7 Na aba de “Recuperação de vendas”, os eventos de envio de SMS para a recuperação de clientes já vêm pré-selecionados, podendo o usuário desmarcar a opção que desejar. Lembrando que possui um custo por envio de R$0,08.
Figura 9: Marcando eventos para a recuperação de cliente via SMS;
3.8 Na etapa “Afiliação Appmax” precisará copiar o código token existente na tela e informar esse código na Magento.
Figura 10: Copiando token;
3.9 Para cadastrar a Appmax como afiliação de pagamento na Magento, é necessário acessar o menu lateral e localizar a opção “Apapmax” e em seguida em “Configuração”.
Figura 11: Acessando magento e clicando no ícone Appmax;
Figura 12: Clicando em “Configuração;
3.10 Também pode ser acessando acessando: Lojas-> Configuração-> Vendas -> Métodos de Pagamento-> Métodos de pagamento Appmax .
Figura 13: Clicando no menu “Lojas” e na opção “Configuração”;
Figura 14: Clicando no menu “vendas” e na opção “Métodos de Pagamento”;
3.11 Para ambas as opções será preciso clicar na opção “Outros métodos de pagamento” e localizar a opção “Métodos de pagamento Appmax”. Nessa etapa será preciso adicionar o token de acesso que foi copiado no sistema Appmax, conforme demonstrado na etapa 3.8.
Figura 15: Inserindo o token de acesso;
3.12 No menu "Métodos de Pagamento Appmax", é necessário configurar a posição dos campos de endereço de acordo com as configurações específicas da sua loja.
Figura 16: Configurando as posições dos campos de endereço que serão exibidos na loja;
3.13 Além disso, é necessário configurar o nome do status desejado para os pedidos no caso de um cancelamento de pagamento.
Figura 17: Selecionando um status para quando houver cancelamento de pagamento;
3.14 No Magento, é necessário habilitar cada forma de pagamento individualmente no menu "Métodos de Pagamento Appmax". Para isso, clique na opção Cartão de crédito e na opção "Habilitado" marque como "Sim" e adicione um título como "Appmax Cartão de crédito". Além disso, no item países aplicáveis selecione somente Brasil.
Obs.: As configurações referentes a parcelamento e juros são consultadas diretamente da sua conta na Appmax.
Figura 18: Habilitando a forma de pagamento Cartão de crédito;
3.15 Na forma de pagamento Pix, na opção "Habilitado" marque como "Sim" e adicione um título como "Appmax Pix". Além disso, inclua um tempo de expiração para a chave Pix, configurando-o para 30 minutos e na opção países aplicáveis selecione somente Brasil.
Figura 19: Habilitando a forma de pagamento Pix;
3.16 Na forma de pagamento Boleto, na opção "Habilitado" marque como "Sim" e adicione um título como "Appmax Boleto". Além disso, marque a opção pendente para status de novos pedidos e na opção países aplicáveis selecione somente Brasil.
Figura 20: Habilitando a forma de pagamento Boleto;
3.17 Após terminar de inserir as informações em todas as etapas da configuração da loja (Loja e Afiliação Appmax) é só clicar no botão “salvar” para concluir a criação da loja com a integração Magento.
Figura 21: Salvando a configuração da loja;