Introducción.
El proceso de migración consiste en actualizar el módulo de Yuju para PrestaShop, pasando de la versión 1.7 a la versión 1.8, procurando conservar la configuración actual y la relación existente entre los productos de Yuju y PrestaShop.
La migración se realizará de manera controlada, realizando respaldos, configuración, mapeo y pruebas antes de considerar finalizado el proceso.
Requisitos previos.
Para realizar la migración será necesario contar con los accesos correspondientes a la instalación de PrestaShop y a la cuenta de Yuju.
Se requiere:
Acceso a la base de datos de PrestaShop mediante cPanel, phpMyAdmin, MySQL, MariaDB u otro medio autorizado.
Acceso a los archivos de PrestaShop mediante FTP, SFTP, cPanel, administrador de archivos u otro mecanismo autorizado.
Acceso al panel administrativo de PrestaShop con permisos suficientes para instalar y configurar el módulo.
Acceso y autorización para realizar las configuraciones y validaciones necesarias en Yuju.
Los permisos necesarios en Yuju serán gestionados internamente por los Administradores de Yuju, con la autorización correspondiente.
Resumen del proceso.
La migración contempla:
Respaldo de la información y configuración actual.
Levantamiento de la configuración existente.
Instalación del módulo 1.8.
Configuración de la conexión entre PrestaShop y Yuju.
Migración del mapeo de campos, categorías y estados.
Mapeo de productos existentes.
Validación de productos, precios e inventario.
Validación de órdenes y estados.
Pruebas controladas.
Monitoreo posterior a la migración.
Proceso de migración.
Respaldo previo.
Antes de realizar cualquier modificación en PrestaShop se realizará un respaldo preventivo de los elementos necesarios para poder recuperar la configuración en caso de algún inconveniente.
El respaldo contempla:
Base de datos.
Archivos relacionados con el módulo.
Configuración actual.
Identificación de la tienda y cuenta de Yuju asociada.
El respaldo se conservará durante el proceso y hasta confirmar que la nueva versión funciona correctamente.
Durante la migración, el cliente no deberá realizar modificaciones sobre la instalación, salvo que sean solicitadas por el responsable de la migración.
Levantamiento de la configuración actual.
Antes de instalar el módulo 1.8 se revisará la configuración existente para identificar los elementos que deberán conservarse o configurarse nuevamente.
Se revisará principalmente:
Mapeo de campos.
Mapeo de categorías.
Mapeo de estados por canal.
Configuración de inventario.
Configuración de precios.
Configuración de órdenes.
Datos de conexión.
El objetivo es conservar el comportamiento actual de la integración y reducir posibles afectaciones durante la migración.
Instalación del módulo 1.8.
Una vez confirmados los accesos y realizado el respaldo, se procederá con la instalación de la versión 1.8 del módulo de Yuju.
Durante esta etapa se validará:
Compatibilidad con la versión de PrestaShop.
Instalación correcta del módulo.
Acceso al módulo desde el panel administrativo.
Ausencia de errores críticos en PrestaShop.
Configuración de la conexión.
Después de instalar el módulo se configurará nuevamente la comunicación entre Yuju y PrestaShop.
Se validará:
Alta de la aplicación correspondiente en Yuju.
Datos de conexión.
Credenciales.
Comunicación entre ambas plataformas.
Identificación correcta de la tienda.
Migración de configuración.
Una vez establecida la conexión, se trasladará al módulo 1.8 la configuración necesaria para mantener el funcionamiento de la integración.
Se contempla la configuración de:
Mapeo de campos.
Mapeo de categorías.
Mapeo de estados.
Configuraciones relacionadas con productos.
Configuraciones relacionadas con inventario y precios.
Configuraciones relacionadas con órdenes.
La configuración será validada antes de continuar con las pruebas de sincronización.
Mapeo de productos existentes.
Se realizará el mapeo entre los productos registrados en Yuju y los productos existentes en PrestaShop, utilizando principalmente el SKU como identificador.
El proceso contempla:
Productos simples.
Productos con variaciones.
Identificación de productos existentes.
Relación entre productos de ambas plataformas.
Prevención de productos duplicados.
Fuente principal de información: PrestaShop.
La información de los productos se sincronizará de PrestaShop hacia Yuju. Yuju no reemplazará ni modificará la información de los productos en PrestaShop.
En caso de existir diferencias, prevalecerá la información de PrestaShop de acuerdo con los campos configurados para sincronización.
Validación de la sincronización.
Una vez realizado el mapeo se realizarán pruebas controladas para verificar que la comunicación entre ambas plataformas funcione correctamente.
Se validará principalmente:
Productos
Creación.
Actualización.
Precio.
Stock.
Información configurada para sincronización.
Inventario
Actualización de existencias.
Reflejo de los cambios de inventario en Yuju.
Órdenes
Recepción de órdenes.
Productos y cantidades.
Precios.
Actualización de estados.
Información relevante de la orden.
Pruebas de migración.
Para validar el funcionamiento de la nueva versión se realizarán pruebas controladas procurando no afectar la operación habitual de la tienda.
Producto de prueba.
Se creará un producto de prueba en PrestaShop y se validará su sincronización hacia Yuju.
Se comprobará principalmente:
Nombre.
Descripción.
Precio.
Inventario.
Categoría.
Imagen.
SKU.
Actualización de producto.
Se modificará un producto existente en PrestaShop para comprobar que los cambios se actualicen correctamente en Yuju.
Órdenes recientes.
Se tomarán órdenes recibidas hasta 3 días antes de la migración y se volverán a enviar de forma controlada para validar:
Recepción de órdenes.
Productos y cantidades.
Precios.
Estados.
Estas órdenes serán notificadas al cliente para que pueda validar su implementación y confirmar que la información mostrada sea la esperada.
Validación final.
Una vez concluidas las pruebas se verificará que:
El módulo 1.8 esté instalado correctamente.
La conexión con Yuju funcione correctamente.
El mapeo de campos, categorías y estados esté configurado.
Los productos estén correctamente relacionados.
Los precios e inventario se sincronicen correctamente.
Las órdenes y sus estados funcionen correctamente.
No existan errores críticos.
Las pruebas realizadas sean satisfactorias.
Con estas validaciones se podrá considerar concluido el proceso de migración.
Monitoreo posterior.
Después de finalizar la migración se dará seguimiento al funcionamiento del módulo para identificar posibles comportamientos no detectados durante las pruebas.
Se revisará principalmente:
Sincronización de productos.
Inventario.
Precios.
Creación y actualización de productos.
Recepción de órdenes.
Cambios de estado.
Errores reportados por Yuju o PrestaShop.
El objetivo será confirmar la continuidad de la operación después de la actualización del módulo.
Reporte de incidencias.
A partir de la instalación del módulo 1.8, cualquier problema relacionado con la migración deberá ser reportado inmediatamente mediante un ticket.
Se deberán reportar, entre otros:
Productos que no sincronicen o actualicen.
Inventarios o precios incorrectos.
Problemas con categorías.
Órdenes que no lleguen o aparezcan duplicadas.
Estados que no se actualicen.
Errores de conexión o API.
Cualquier comportamiento diferente al esperado.
Para facilitar el diagnóstico será necesario proporcionar capturas de pantalla de ambas plataformas, indicando claramente la discrepancia encontrada.
No se recomienda realizar cambios manuales en la configuración, base de datos o archivos del módulo antes de reportar una incidencia, ya que esto puede dificultar su diagnóstico y solución.
Consideración final.
El proceso de migración tiene como objetivo actualizar el módulo de PrestaShop 1.7 a 1.8, conservando en la medida de lo posible la configuración y las relaciones existentes entre Yuju y PrestaShop.
La prioridad durante el proceso será mantener la integridad de los productos, evitar duplicidades y garantizar la continuidad de la sincronización de productos, inventarios, precios y órdenes.
Cualquier comportamiento inesperado deberá ser reportado inmediatamente con el KAM asignado a la cuenta de Yuju.