Smart Wholesaler Feed Sync

Qué hace el módulo

MPR Feed Sync es un módulo back office de sincronización de feeds para PrestaShop. Obtiene feeds de productos de mayoristas, normaliza registros en un modelo de producto común, los relaciona con productos y combinaciones existentes, guarda diffs de dry-run y aplica cambios de catálogo solo después de que las puertas de seguridad configuradas permitan la ejecución.

El módulo puede actualizar stock, precio, disponibilidad, categoría, marca/fabricante, nombres, descripciones, imágenes, combinaciones, atributos y características. Cada área se controla con interruptores por feed, de modo que un feed puede limitarse solo a stock y precio o ampliarse a creación de productos y gestión de variantes cuando la tienda esté preparada.

Ubicación en back office

Tras la instalación, usa Sell > Feed Sync. El dashboard del módulo muestra la última ejecución, tasa de coincidencia, feeds activos, productos gestionados, alertas abiertas, etiqueta de la próxima programación, ejecuciones recientes y enlaces rápidos a Feeds, Mapper, Runs y Configuration. Al abrir la configuración del módulo se redirige al controlador mapper/preview.

Configuración global

Abre Sell > Feed Sync > Configuration para copiar la URL cron protegida por token y ajustar los límites de ejecución.

• Global apply enabled: interruptor principal del modo Apply. Apply también requiere un dry run reciente y un token de confirmación.
• Fetch timeout seconds, Fetch connect timeout seconds y Fetch max bytes: límites de transporte usados al obtener feeds.
• Sync lock TTL seconds: vida útil del bloqueo para ejecuciones de feed, de forma que las ejecuciones solapadas se omitan en lugar de escribir simultáneamente.
• Product create max count, Combination create max count y Create max percent: límites globales de creación usados por las puertas de seguridad.
• Image max count, Image max bytes, Image timeout seconds y Image connect timeout seconds: límites para la importación de imágenes.

Crear un feed

Abre Sell > Feed Sync > Feeds y añade un feed. Los campos obligatorios son el nombre del feed y la URL/ruta del feed. Elige mayorista, tipo de fuente, adaptador o perfil de mapeo, prioridad de matching, orden de prioridad, alcance de sincronización, comportamiento de categoría, umbrales de seguridad, programación y estado activo.

• Feed URL / path acepta HTTP(S), FTP, FTPS, SFTP, URL/ID de Google Sheets o una ruta local absoluta dentro del directorio de importación configurado.
• Source type admite url, ftp, ftps, sftp, file y google_sheets.
• Compression puede detectar gzip automáticamente, forzar gzip o desactivar la descompresión.
• Source settings JSON guarda opciones avanzadas como Google Sheets gid y range.
• Los campos de autenticación FTP/FTPS/SFTP guardan usuario/contraseña y ruta/passphrase opcional de clave privada SFTP. Los campos de contraseña/passphrase vacíos conservan el secreto existente al editar.

Mapear feeds

Usa Sell > Feed Sync > Mapper para sondear una fuente, muestrear registros, crear o guardar perfiles de mapeo y previsualizar elementos normalizados. Los campos canónicos incluyen ean, sku, supplier_id, name, price, stock, location_quantities, avail, category, brand, variant_group_key, variant_key, variant_attributes, features, combination_ean, combination_reference, combination_price_impact, combination_stock, combination_images, images, y attrs.

Las transformaciones disponibles incluyen trim, digits_only, decimal_normalize, lower, upper, prefix, suffix, regex_replace, split, concat, default_if_empty, y map_values. Los presets incluyen Corsan XML, Google Shopping XML genérico, Ceneo XML genérico, CSV genérico y JSON genérico.

Dry runs, Apply y rollback

Usa Dry-run en la pantalla Feeds o ejecuta el endpoint cron con action=dryrun. Un dry run obtiene el feed, lo analiza, crea un índice de productos, relaciona elementos del feed, escribe filas mprfeedsync_run y mprfeedsync_run_diff y guarda una firma de configuración en el feed.

Usa Apply solo después de revisar el resultado del dry-run. El modo Apply requiere Apply habilitado, un token de confirmación válido, una firma de dry-run reciente, tipos de cambio preparados y puertas de seguridad superadas. Apply escribe las filas planificadas y registra el estado applied/skipped/error por cada fila de diff. Las acciones rollback están disponibles desde las pantallas Feeds y Runs para ejecuciones Apply.

Matching y sobrescrituras

El matching usa primero los mapas existentes del módulo cuando son coherentes y después la match_priority. Las coincidencias únicas por EAN y SKU/referencia son de alta confianza; las coincidencias solo por referencia de proveedor son de baja confianza y se bloquean para escritura salvo que la política las permita. Las claves de feed duplicadas, candidatos de catálogo ambiguos, mapas ignorados y filas omitidas por inseguras no se tratan como filas escribibles.

El controlador Mappings permite a los admins congelar un mapa, descongelarlo, ignorarlo/dejar de ignorarlo, reasignarlo manualmente a otro ID de producto o definir/borrar una sobrescritura de categoría de producto. Congelar protege stock, precio, disponibilidad, nombre, descripción e imágenes para ese mapa.

Categorías y marcas

La estrategia de categoría puede ser default, manual o auto_path. Las sobrescrituras de categoría de producto ganan primero, después los mapas de categoría activos; la estrategia manual depende de esos mapas, y auto-path puede crear o resolver rutas de categoría bajo la categoría raíz configurada durante Apply.

La sincronización de marcas usa la tabla de mapas de marca. Una marca del feed puede mapearse a un fabricante de PrestaShop, o Create if missing puede crear un fabricante a partir del valor de marca del feed durante Apply. Las sobrescrituras de producto también pueden proporcionar una sobrescritura de fabricante.

Ubicaciones de stock

Cuando sync_location_stock está activado, location_quantities del feed se escriben en los libros de ubicación del módulo y la cantidad de stock de la tienda se actualiza desde la estrategia de agregación seleccionada. Las estrategias compatibles son sum, max, primary_location, y specific_location. Las ubicaciones de stock pueden ser ubicaciones virtuales gestionadas por el módulo o estar vinculadas a almacenes de Advanced Stock Management.

Moneda y precios

Si source_currency está definida y difiere de la moneda de la tienda, el módulo requiere un proveedor de tipos configurado antes de Apply. La fuente del tipo puede ser manual or nbp, con margen de tipo opcional y JSON de ajustes. Los tipos se cachean en mprfeedsync_currency_rate; los tipos requeridos ausentes u obsoletos bloquean Apply.

Reenvío de pedidos dropship

Abre Sell > Feed Sync > Dropship Orders para configurar el reenvío de pedidos por feed. Está desactivado por defecto. El adaptador predeterminado generic_export escribe un documento de pedido en disco y no contacta con un proveedor. Para enviar externamente, elige email_csv, email_xml o http_post, define el ID del estado de pedido disparador y proporciona email del proveedor, URL de endpoint, options JSON o auth JSON según sea necesario.

El módulo escucha actionValidateOrder y actionOrderStatusPostUpdate. Cuando un pedido alcanza el estado configurado, resuelve solo líneas pertenecientes al feed, crea un elemento de cola idempotente por par pedido/feed, lo despacha y conserva datos de respuesta/error. La acción cron de reintento procesa registros de reenvío vencidos en cola o fallidos hasta el límite de intentos configurado.

Endpoint cron

El front controller es /module/mprfeedsync/cron y requiere el token. Las acciones compatibles son parse, sync, dryrun, apply, status y alias de reintento de reenvío como forwarding_retry. Los parámetros opcionales incluyen id_feed, url, adapter_key, profile, id_mapping_profile, confirm or apply_token, limit y products.

Notas operativas

• El módulo es compatible con PrestaShop desde 1.7.0.0 hasta la versión instalada _PS_VERSION_ según el constructor del módulo.
• La instalación crea tablas del módulo para feeds, perfiles, mapas de producto, sobrescrituras, historial de ejecuciones, diffs, categorías, marcas, tipos de cambio, ubicaciones, reenvío de pedidos, imágenes, reglas de precio, alertas y bloqueos.
• La reconciliación del esquema runtime y las comprobaciones de hooks se realizan antes de operaciones admin y cron cuando están disponibles.
• Los bloqueos de ejecución se guardan en mprfeedsync_sync_lock e impiden ejecuciones solapadas para el mismo feed o URL ad-hoc.
• Las comprobaciones de integridad del sistema y el mantenimiento de tablas del módulo están disponibles desde el controlador integrity.