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 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 da Yuju e as do Magento. (O mapeamento é apenas de nível 1).
Na primeira coluna, você verá as categorias da 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 na 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 da Yuju).
Alterar status→ Ativa ou desativa produtos no Magento (não afeta a Yuju).
Atualizar atributos→ Modifica as informações no Magento (isso será refletido na Yuju).
Criar na Yuju→ Envia os produtos selecionados para a Yuju
Atualizar na Yuju→ Atualiza as informações dos produtos na Yuju.
Excluir na Yuju→ Exclui os produtos da Yuju.
Após concluir o processo, seus produtos serão exibidos na Yuju, na aba Meus Produtos.
Atualização de produtos na Yuju
Quando você receber uma compra no Magento, as informações serão capturadas pela 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 na Yuju
Com isso, a integração está concluída: agora você já pode começar a vender em grande estilo!