Documentação Fornecedor Hayamax Premium para Opencart

# Documentação Integração Hayamax Premium para Opencart Nessa Documentação, vamos ensinar a configurar o módulo de Integração da Hayamax Premium, criado pela nossa equipe da Code Market, para você poder importar todo o estoque da Hayamax de forma automatizada e rápida em sua loja. A Hayamax tem mais de 5 mil produtos, o módulo importa os Produtos, Fabricantes (marcas), Categorias e Imagens, além de fazer a atualização do Preço, Quantidade e outras funções. [Ir para a página do módulo Integração Fornecedor Hayamax Premium - Importação de Produtos para Opencart](https://www.codemarket.com.br/produto/integracao-fornecedor-hayamax-premium-importacao-de-produtos-para-opencart) ## Instalação A instalação desse módulo é feita por nossa equipe da Code Market, já entregamos o mesmo pronto para ser usado na loja e já com os Produtos, Fabricantes, Categorias e Imagens dos Produtos adicionados. O prazo médio da instalação é de 2-3 dias úteis, após informar os dados pedidos por E-mail. O módulo adiciona apenas poucos arquivos na loja, foi feito de forma para ter alto desempenho e qualidade. ## Suporte Para pedir suporte, envie um e-mail para contato@codemarket.com.br , lembrando que o prazo de suporte é de 3 meses da data do Pedido. Caso deseje renovar o suporte, pode fazer a renovação em Minhas Licenças, clicando em Renovar. Já a licença de um uso é válida para sempre, não está relacionada ao prazo do Suporte ou ao da Atualização/Download. ## Passos da Configuração ### Configuração (Tab Inicial) Nesta etapa, vamos ensinar a configuração inicial, a primeira tela vista no Painel do módulo. **Vamos a explicação de cada campo:** * **Endereço XML Hayamax:** Informe o endereço do xml gerado para a sua Loja pela Hayamax, ele que vai conter os Produtos a serem adicionados * **Limite importação:** Informe a quantidade de Produtos que deseja importar no máximo, se definir 0, vai ser importado até o máximo de Produtos da Hayamax Se informar por exemplo 100, só vai ser importado até 100 Produtos * **Quantidade mínima em Estoque (1 até 10):** Informe a quantidade mínima em Estoque na Hayamax que deseja adicionar o Produto em sua loja, recomendamos deixar **10** * **Tempo limite para rodar em segundos:** Informe o tempo máximo em segundos para rodar o código de importação e outros, o sistema vai tentar parar antes de chegar nesse limite. Recomendo deixar entre 40 e 80 segundos, caso sua hospedagem seja compartilhada ou configurada para um número baixo de tempo para rodar scripts PHP, então deixe um número entre 20 e 30s * **Token de Segurança:** Informe um token de segurança para proteger as funções que são rodadas pelo navegador, pode por qualquer texto aceito pela URL, vai ser usado na hora de chamar algumas funções * **Habilitar:** Informe se deseja Habilitar ou não o módulo Se marcar Sim, vai habilitar e não vai desabilitar ele ### Configuração Produtos Nesta etapa, vamos ensinar a configuração relacionada aos Produtos a serem adicionados em sua loja. **Vamos a explicação de cada campo:** * **Porcentagem Preço (aumento):** Informe a Porcentagem que deseja para o aumento no preço. Use apenas número inteiro, exemplo 40, se deseja 40% de aumento no preço informado pela Hayamax e com isso 40% de lucro bruto * **ID do Status sem estoque:** Informe a quantidade mínima em Estoque na Hayamax que deseja adicionar o Produto em sua loja, recomendamos deixar **10** * **Ativar o Produto:** Informe se deseja que o produto seja ativado na Loja, só vai ser ativado se tiver imagem, estoque, dimensões, peso e nome Sim se deseja ativar e não para deixar desativado os Produtos * **Sem descrição:** Informe se deseja ficar sem a descrição nos produtos ou que sejam inseridas Se marcar Sim, os produtos vão vir sem descrição e não vai ser adicionado a descrição e dados técnicos no produto ## Cron Job - Automatização Vamos agora ensinar a configurar o Cron Job para automatizar os processos. Abra o Cpanel ou o Painel usado em sua Hospedagem e vá até a parte do Cron Job ou Agendamento de tarefas para adicionar os Cron Jobs. ### Comando usado ``` wget -q -O - https://www.seusite.com.br/index.php?route=code/codemarket_hayamax/cache&token=seutoken >/dev/null 2>&1 ``` Trocar **https://www.seusite.com.br** para o **endereço do seu site** Trocar **seutoken** pelo **Token de Segurança** informado no Painel ### Gerar Cache Serve para atualizar o XML baixado da Hayamax, eles atualizam 3x ao dia, logo recomendado rodar no máximo 3 vezes ao dia, a cada 8h ou mais. #### Cron Job ``` wget -q -O - https://www.seusite.com.br/index.php?route=code/codemarket_hayamax/cache&token=seutoken >/dev/null 2>&1 ``` ### Importar Produtos Serve para importar/atualizar os Produtos com base no Cache gerado do XML da Hayamax. Recomendado rodar depois do Gerar Cache, para ter os dados mais atualizados, logo se colocou o acima para rodar a cada 8h, recomendo por esse com intervalo maior. #### Cron Job ``` wget -q -O - https://www.seusite.com.br/index.php?route=code/codemarket_hayamax/ìmportar_produtos&token=seutoken >/dev/null 2>&1 ``` ### Verificar Produtos Serve para baixar as imagens dos Produtos novos, marcar no banco, verificar as imagens adicionadas e ativar os Produtos com imagens verificadas e com estoque Fundamental rodar ele após Importar os Produtos, caso deseje adicionar na loja, caso contrário fica como desativados e sem imagem os produtos novos. Recomendado rodar depois do Importar Produtos, logo se o Importar Produtos colocou a cada 10h, então esse colocar alguns minutos depois, recomendo um intervalo de pelo menos 1 minuto entre eles para garantir que o Importar Produtos já rodou. #### Cron Job ``` wget -q -O - https://www.seusite.com.br/index.php?route=code/codemarket_hayamax/verificar_produtos&token=seutoken >/dev/null 2>&1 ``` ### Atualizar Preços Serve para atualizar os Preços conforme configurado no Porcentagem Preço (aumento), usa com base o preço de custo da Hayamax. Não precisa por para rodar no Cron Job, pode rodar direto no botão do Painel, após alguma alteração na configuração da Porcentagem Preço (aumento). #### Cron Job ``` wget -q -O - https://www.seusite.com.br/index.php?route=code/codemarket_hayamax/atualizar_precos&token=seutoken >/dev/null 2>&1 ``` ## Simulação Nessa simulação rápida, mostramos os três passos principais, que é Gerar Cache do XML, Importar Produtos e Verificar Produtos ![Simulação Hayamax Premium para Opencart](https://www.codemarket.com.br/image/data/felipo/HayamaxImportarGif.gif) 1. A loja está vazia sem produtos, o XML da Hayamax já está em Cache no Banco de Dados da Loja 2. Rodamos o Importar Produtos que adiconou os produtos, categorias e fabricantes (marcas) na Loja 3. Rodamos o Verificar Produtos que adicionou as imagens dos Produtos, verificou elas para confirmar que realmente baixou e ativou os Produtos e Categorias