Antes de conectar tu canal de Odoo a Yuju, es necesario instalar el módulo de Yuju dentro de tu servidor de Odoo.
Descarga del módulo.
El primer paso es descargar el módulo de Yuju para Odoo, para ello clona o descarga el repositorio y descomprime el módulo madkting / odoo_module en tu computadora y después súbelo a tu propio repositorio en una carpeta donde Odoo pueda leerlo. (esto dependerá de la configuración que hayas definido para Odoo)
La versión del módulo depende de la versión de Odoo que tengas instalada:
Descarga dependencias.
Este módulo depende del módulo component_events que forman parte del Framework Connector.
Hasta la versión 18, es necesario instalar el módulo adicional correspondiente. A partir de Odoo versión 19, esta dependencia ya no es necesaria.
Debe instalar la versión del módulo que corresponda a su instalación de Odoo.
El módulo se encuentra disponible en la App Store de Odoo en los siguientes enlaces:
Para instalar el módulo de component_events en tu instancia de Odoo puedes realizar una de estas dos alternativas:
Descarga el archivo zip de component_events directamente desde la tienda de aplicaciones de Odoo, descomprime el archivo y después súbelo a tu propio repositorio en una carpeta donde Odoo pueda leerlo (esto dependerá de la configuración que hayas definido para Odoo)
Si tienes odoo SH, usa el botón Deploy on Odoo.sh que se encuentra justo después del botón Descargar en la tienda de aplicaciones de Odoo.
Modo desarrollador Odoo.
Antes de instalar el módulo en Odoo, es necesario habilitar el modo desarrollador. Para habilitar el modo desarrollador debes iniciar sesión en Odoo e ir al menú de AJUSTES.
Este menú solo se visualiza para usuarios que tengan el permiso/grupo “Ajustes/Configuración”.
Una vez ahí, debes habilitar el modo Desarrollador, dando clic en la siguiente liga, la cual se encuentra en la parte inferior de la pantalla.
Instalación del módulo en Odoo.
Una vez habilitado el modo desarrollador activado, ve al menú Aplicaciones y busca Yuju en la barra de búsqueda.
Si no se puede encontrar el módulo, haz clic en "Actualizar lista de aplicaciones" en el menú superior de Aplicaciones y vuelve a intentarlo. Si aún tienes problemas, comprueba que descomprima el módulo en el directorio correcto para los complementos.
Una vez que hayas encontrado el módulo yuju en la lista de aplicaciones, haz clic en el botón "Instalar".
Configuración del módulo.
Creación de Usuario para Yuju.
Cuando finaliza la instalación, debes crear un usuario y definir una contraseña para él, este usuario es para uso exclusivo de Yuju. Para crear un usuario nuevo, debes ir a la sección de “AJUSTES” y seleccionar la opción Usuarios y Compañías / Usuarios.
Una vez ahí, debes presionar el botón de “CREAR” y agregar el nuevo usuario.
Este usuario debe tener asignado el Permiso/Grupo de madkting_api.
Por último asigna una contraseña al usuario, para ello da clic en GUARDAR y posteriormente selecciona el botón desplegable que se encuentra en la parte superior y selecciona la opción cambiar contraseña.
Una vez ahí asigna la contraseña que va a tener el usuario y selecciona la opción de “cambiar la contraseña”.
Actualización del módulo.
El módulo de Yuju permite la conexión entre la plataforma Yuju y el ERP sirviendo como conector entre ambas, por lo que es necesario que el modulo este actualizado para su correcto funcionamiento, para actualizar el módulo basta con seguir las instrucciones para su instalación, descargando la última versión del módulo.
Características del módulo de Yuju.
El módulo de Yuju agrega un nuevo menú en las opciones de Odoo con el nombre de Yuju, el cual muestra el listado de ventas que han sido importadas de Odoo.
Activar opciones necesarias para la conexión.
Habilitar variantes de productos: Es necesario habilitar las variantes de productos ya que Yuju hace el mapeo hacia este objeto dentro de Odoo. Para habilitarlo hay que ir al módulo de Almacén → Configuración → Habilitar la opción de Variantes.
Habilitar la opción de Ubicaciones de almacén: Es necesario activar esta opción para poder hacer el mapeo de almacenes dentro de Yuju, ya que así será posible asignar un almacén específico a cada canal dependiendo del tipo de Fulfillment, también para poder indicar de qué almacén se enviará la actualización de stock hacía Yuju. Para habilitarlo hay que ir al módulo de Almacén -> Configuración -> Ubicaciones de almacén.
Conexión con Yuju
Para conectar con Yuju se solicitan los siguientes datos:
Username (Nombre usuario o email asignado en odoo)
Password (Contraseña asignada para el usuario en Odoo)
Base de datos (Nombre de la base de datos que crearon en Odoo)
Asegúrate de ingresar los datos correctos para completar la conexión.
El nombre de la base de datos lo puedes consultar con el área técnica que instalar Odoo
En caso de no saber el nombre de la base de datos seguir estos pasos:
Activar modo desarrollador en odoo
En la parte superior derecha de la pantalla, debajo del nombre de usuario aparecerá el nombre de la base de datos.
En caso de que el nombre no aparezca completo, dar clic derecho sobre el nombre de la base de datos y seleccionar la opción que dice “inspeccionar”.
Dentro de la ventana que aparece podremos revisar el nombre de la base de datos, ejemplo:
4. URL de Odoo (La URL debe comenzar con https:// hasta “.com” o similar.
Ejemplo de URLS correctas:
Ejemplo de URLS incorrectas:
https://yuju-odoo.odoo.com/odoo/action-178/87
Actualiza el módulo “madkting” de Yuju (Odoo SH y Github)
Paso 1) Descarga el código del repositorio del módulo de Yuju:
a) Desde archivo comprimido ZIP: https://bitbucket.org/madkting/odoo_module/downloads/?tab=branches
Selecciona la versión que corresponda a tu Odoo y elige la opción .ZIP
b) Clona el repositorio a una carpeta en tu equipo:
Esta opción requiere que tengas instalado Git en tu equipo de cómputo.
En una terminal (consola) ejecuta el siguiente comando:
git clone git@bitbucket.org:madkting/odoo_module.git
(por defecto descarga la última versión ej. 17.0)
Si requieres una versión de Odoo específica, debes modificar el comando por el siguiente, por ejemplo para descargar la versión 18.0
git clone -b 18.0 git@bitbucket.org:madkting/odoo_module.git
Las versiones disponibles son de la 12.0 - 18.0
Ejemplo:
Esto descargará el repositorio con el código en tu equipo en la carpeta donde lo hayas ejecutado.
Paso 2) Una vez hecho esto, debes acceder a la carpeta del repositorio que acabas de obtener y ubica la carpeta llamada “madkting”, esta es la carpeta que sustituirá el módulo que tienes instalado actualmente.
Paso 3) Descarga el repositorio de Odoo (odoo sh), para este paso se debes tener permisos de acceso al repositorio de Github del usuario registrado.
Busca el botón que dice “Code” y copia la URL del repositorio.
Después lo pegas en nuestra terminal (consola) junto con el comando git clone.
Una vez clonado el repositorio debes acceder a la carpeta con el código y ubica la carpeta que se llama “madkting” esa la debes eliminar.
Paso 4) Una vez eliminada la carpeta, debes copiarla nuevamente del repositorio actualizado de Yuju y la pegas en la carpeta del repositorio.
Paso 5) Una vez agregues la carpeta nueva, regresa a la terminal (consola) y ejecuta el siguiente comando:
git add . && git commit -m “<Mensaje>” && git push
Y listo, de esta manera actualizarás el repositorio.
NOTA: Es importante validar cada cierto tiempo si hay actualizaciones en el repositorio para tener las últimas mejoras del módulo.
NOTA: El éxito de este procedimiento depende de si el módulo de Yuju se ha subido directamente como una carpeta más al repositorio.
Campos que se envían de Yuju a Odoo. (Productos).
Campos que se envía de Odoo a Yuju.
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.