Instalação e atualização
Magento 2.4.3
Requisito: PHP 7.4
Execute os seguintes comandos na pasta raiz da sua loja
composer require madkting/magento2-module
php bin/magento module:enable Madkting_Connect
php bin/magento setup:upgrade
Magento 2.4.5
Requisito: PHP 8.1
Execute os seguintes comandos na pasta raiz da sua loja:
composer require madkting/magento2-module:2.4.7
php bin/magento module:enable Madkting_Connect
php bin/magento setup:upgrade
Observação: é importante que o cron esteja ativo.
Configuração do módulo no Magento 2
Conexão
Acesse sua conta do Yuju e navegue até “Adicionar Produtos” → “Por API”.
Clique em “Obter seu TOKEN aqui” e copie a chave API.
No seu Magento, vá para Yuju → Configuração.
No campo Chave API, cole a chave API copiada.
Salve as alterações.
Copie a URL de notificações que aparece abaixo e cole-a no Yuju, no caminho:
Adicionar Produtos → Por API → URL de Notificações → Salvar.
Pronto! Com isso, termina a primeira parte da configuração.
Mapeamento
Mapeamento de categorias
No Magento, acesse Yuju → Mapeamento → Categorias.
Faça o mapeamento entre suas categorias do Yuju e as do Magento. (O mapeamento é apenas de nível 1).
Na primeira coluna, você verá as categorias do Yuju; na segunda, as do Magento; e na terceira, as ações.
Para adicionar um novo mapeamento:
Clique em “Novo mapeamento de categoria”
Selecione a categoria do Yuju.
Selecione uma ou várias categorias do Magento que correspondam.
Observação: se você selecionar uma categoria que já esteja mapeada, ela será ignorada.
Mapeamento de atributos
No Magento, acesse Yuju → Mapeamento → Atributos.
Modifique ou adicione atributos com o botão “Adicionar Atributo”.
Salve as alterações.
Mapeamento de opções de atributos
Acesse Yuju → Mapeamento → Opções de Atributo.
Faça o mapeamento para cada opção disponível (exemplo: cor).
Salve as alterações.
O mapeamento de tamanhos não é obrigatório.
Mapeamento de status de pedidos.
Você pode mapear os status de pedidos em:
Yuju → Mapeamento → Status do Pedido.
Lançar produtos no Yuju
⚠️ Importante: Antes de adicionar seus produtos (únicos e variações), certifique-se de que todos tenham um SKU único.
No Magento, vá para Produtos → Catálogo.
Use o botão Filtros para procurar produtos específicos, se necessário.
Selecione todos ou alguns produtos.
No menu Ações, você poderá escolher entre:
Excluir→ Exclui o produto do Magento (e do Yuju).
Alterar status→ Ativa ou desativa produtos no Magento (não afeta o Yuju).
Atualizar atributos→ Modifica as informações no Magento (isso será refletido no Yuju).
Criar no Yuju→ Envia os produtos selecionados para o Yuju
Atualizar no Yuju→ Atualiza as informações dos produtos no Yuju.
Excluir no Yuju→ Exclui os produtos do Yuju.
Após concluir o processo, seus produtos serão exibidos no Yuju, na aba Meus Produtos.
Atualização de produtos no Yuju
Quando você receber uma compra no Magento, as informações serão capturadas pelo Yuju e aparecerão tanto na plataforma quanto nos canais de venda conectados.
Qualquer alteração que você fizer nos produtos (seja por CSV ou diretamente no produto) será atualizada automaticamente no Yuju
Com isso, a integração está concluída: agora você já pode começar a vender em grande estilo!