Antes de conectar seu canal do Odoo ao Yuju, é necessário instalar o módulo do Yuju no seu servidor Odoo.
Download do módulo.
O primeiro passo é baixar o módulo do Yuju para o Odoo. Para isso, clone ou baixe o repositório e descompacte o módulo madkting/odoo_module no seu computador e, em seguida, envie-o para o seu próprio repositório em uma pasta onde o Odoo possa acessá-lo. (isso dependerá da configuração que você definiu para o Odoo)
A versão do módulo depende da versão do Odoo que você tem instalada:
Baixe as dependências.
Este módulo depende do módulo component_events, que faz parte do Framework Connector.
Até a versão 18, é necessário instalar o módulo adicional correspondente. A partir da versão 19 do Odoo, essa dependência não é mais necessária.
Você deve instalar a versão do módulo correspondente à sua instalação do Odoo.
O módulo está disponível na App Store do Odoo nos seguintes links:
Para instalar o módulo component_events na sua instância do Odoo, você pode seguir uma destas duas alternativas:
Baixe o arquivo zip do component_events diretamente da loja de aplicativos do Odoo, descompacte o arquivo e, em seguida, envie-o para o seu próprio repositório em uma pasta onde o Odoo possa lê-lo (isso dependerá da configuração que você definiu para o Odoo)
Se você tiver o Odoo SH, use o botão Deploy on Odoo.sh, localizado logo após o botão Baixar na loja de aplicativos do Odoo.
Modo de desenvolvedor do Odoo.
Antes de instalar o módulo no Odoo, é necessário habilitar o modo desenvolvedor. Para habilitar o modo desenvolvedor, você deve fazer login no Odoo e acessar o menu CONFIGURAÇÕES.
Esse menu só é exibido para usuários que tenham a permissão/grupo “Configurações”.
Uma vez lá, você deve ativar o modo Desenvolvedor clicando no link a seguir, localizado na parte inferior da tela.
Instalação do módulo no Odoo.
Depois de ativar o modo desenvolvedor, acesse o menu Aplicativos e procure por Yuju na barra de pesquisa.
Se não conseguir encontrar o módulo, clique em “Atualizar lista de aplicativos” no menu superior de Aplicativos e tente novamente. Se ainda tiver problemas, verifique se o módulo foi descompactado no diretório correto para os complementos.
Depois de encontrar o módulo Yuju na lista de aplicativos, clique no botão “Instalar”.
Configuração do módulo.
Criação de usuário para o Yuju.
Quando a instalação terminar, você deve criar um usuário e definir uma senha para ele; esse usuário é de uso exclusivo do Yuju. Para criar um novo usuário, vá até a seção “CONFIGURAÇÕES” e selecione a opção Usuários e Empresas / Usuários.
Uma vez lá, você deve clicar no botão “CRIAR” e adicionar o novo usuário.
Esse usuário deve ter a permissão/grupo madkting_api atribuída.
Por fim, atribua uma senha ao usuário. Para isso, clique em SALVAR e, em seguida, selecione o menu suspenso localizado na parte superior e escolha a opção “alterar senha”.
Uma vez lá, defina a senha que o usuário terá e selecione a opção “Alterar a senha”.
Atualização do módulo.
O módulo do Yuju permite a conexão entre a plataforma Yuju e o ERP, atuando como um conector entre ambos; por isso, é necessário que o módulo esteja atualizado para funcionar corretamente. Para atualizar o módulo, basta seguir as instruções de instalação e baixar a versão mais recente do módulo.
Características do módulo do Yuju.
O módulo do Yuju adiciona um novo menu nas opções do Odoo com o nome Yuju, que exibe a lista de vendas importadas do Odoo.
Ativar opções necessárias para a conexão.
Habilitar variantes de produtos: É necessário habilitar as variantes de produtos, pois o Yuju faz o mapeamento para esse objeto dentro do Odoo. Para habilitá-lo, acesse o módulo de Armazém → Configuração → Habilitar a opção Variantes.
Habilitar a opção de Localizações de armazém: É necessário ativar esta opção para poder fazer o mapeamento de armazéns dentro do Yuju, pois assim será possível atribuir um armazém específico a cada canal dependendo do tipo de Fulfillment, e também para indicar de qual armazém será enviada a atualização de estoque para o Yuju. Para ativá-la, acesse o módulo de Armazém → Configuração → Localizações de armazém.
Conexão com o Yuju
Para se conectar ao Yuju, são solicitados os seguintes dados:
Nome de usuário (nome de usuário ou e-mail atribuído no Odoo)
Senha (Senha atribuída ao usuário no Odoo)
Banco de dados (Nome do banco de dados criado no Odoo)
Certifique-se de inserir os dados corretos para concluir a conexão.
Você pode consultar o nome do banco de dados com a equipe técnica que instalou o Odoo
Caso não saiba o nome do banco de dados, siga estas etapas:
Ative o modo de desenvolvedor no Odoo
No canto superior direito da tela, abaixo do nome de usuário, aparecerá o nome do banco de dados.
Caso o nome não apareça por completo, clique com o botão direito do mouse sobre o nome do banco de dados e selecione a opção “Inspecionar”.
Na janela que aparecerá, você poderá verificar o nome do banco de dados, por exemplo:
4. URL do Odoo (A URL deve começar com https:// até “.com” ou similar.
Exemplos de URLs corretas:
Exemplos de URLs incorretas:
https://yuju-odoo.odoo.com/odoo/action-178/87
Atualize o módulo “madkting” do Yuju (Odoo SH e Github)
Passo 1) Baixe o código do repositório do módulo do Yuju:
a) A partir do arquivo ZIP: https://bitbucket.org/madkting/odoo_module/downloads/?tab=branches
Selecione a versão correspondente ao seu Odoo e escolha a opção .ZIP
b) Clone o repositório para uma pasta no seu computador:
Esta opção requer que você tenha o Git instalado no seu computador.
Em um terminal (console), execute o seguinte comando:
git clone git@bitbucket.org:madkting/odoo_module.git
(por padrão, baixa a versão mais recente, por exemplo, 17.0)
Se você precisar de uma versão específica do Odoo, deve modificar o comando da seguinte forma, por exemplo, para baixar a versão 18.0
git clone -b 18.0 git@bitbucket.org:madkting/odoo_module.git
As versões disponíveis são da 12.0 à 18.0
Exemplo:
Isso baixará o repositório com o código para o seu computador, na pasta onde você o executou.
Passo 2) Feito isso, acesse a pasta do repositório que você acabou de obter e localize a pasta chamada “marketing”; essa é a pasta que substituirá o módulo que você tem instalado atualmente.
Passo 3) Baixe o repositório do Odoo (odoo sh). Para este passo, você deve ter permissões de acesso ao repositório do GitHub do usuário registrado.
Procure o botão “Code” e copie a URL do repositório.
Em seguida, cole-a em nosso terminal (console) junto com o comando git clone.
Depois de clonar o repositório, acesse a pasta com o código e localize a pasta chamada “madkting”; essa deve ser excluída.
Passo 4) Após excluir a pasta, você deve copiá-la novamente do repositório atualizado do Yuju e colá-la na pasta do repositório.
Passo 5) Depois de adicionar a nova pasta, volte ao terminal (console) e execute o seguinte comando:
git add . && git commit -m “<Mensagem>” && git push
E pronto, assim você atualizará o repositório.
NOTA: É importante verificar periodicamente se há atualizações no repositório para ter as últimas melhorias do módulo.
NOTA: O sucesso deste procedimento depende de o módulo do Yuju ter sido carregado diretamente como mais uma pasta no repositório.
Campos enviados do Yuju para o Odoo. (Produtos).
Campos enviados do Odoo para o Yuju.
Para qualquer dúvida e/ou esclarecimento, entre em contato com seu KAM designado ou escreva para soporte@yuju.io.