Omnibus Price Compliance: configuración y ayuda

Requisitos

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.

Necesitas una programación regular y un tema con los hooks admitidos de productos, listados, vista rápida y carrito. No se requiere una cuenta de un servicio externo de precios. El módulo registra precios públicos de productos; no crea un historial completo de fechas anteriores a la instalación.

Secuencia de instalación

1. Sube e instala el ZIP desde Modules > Module Manager > Upload a module.
2. Pulsa Configurar o abre Omnibus Compliance > Configuración.
3. Selecciona la tienda cuyos ajustes vas a cambiar. Revisa Historial, Visualización, Textos legales y Información, y pulsa Guardar.
4. Configura la ejecución regular de Procesar historial de precios Omnibus.
5. Abre Omnibus Compliance > Panel y Historial de precios para confirmar que se registran el trabajo inicial y las observaciones posteriores.
6. Prueba las ubicaciones activadas de la tienda con una reducción válida cuando exista suficiente historial.

La instalación crea las tablas del módulo, registra los hooks y la tarea programada, inicializa los contextos de mercado público predeterminados, inicia el procesamiento de precios específicos existentes y pone en cola las capturas iniciales. Una instalación nueva puede correctamente no mostrar ninguna indicación del precio anterior.

Pestaña "History"

Abre Omnibus Compliance > Configuración > Historial. Estos valores comienzan con los ajustes predeterminados siguientes. Los ajustes se guardan para la tienda seleccionada.

Introducir el JSON de política por país

La política inicial proporcionada es:

{
  "PL": {
    "window_days": 30,
    "progressive": false,
    "introductory_days": 30
  }
}

Usa claves de país de dos letras mayúsculas. Cada entrada necesita window_days, progressive e introductory_days. El formulario exige un período de al menos 30 días, un booleano JSON para progressive y de 1 a 30 días introductorios. La resolución en ejecución limita el período a 365 días.

Con progressive activado, una secuencia continua de reducciones admitida puede conservar el período de referencia anterior a la primera reducción. Déjalo desactivado salvo que esa sea la política que quieras aplicar. Mantén los textos traducidos coherentes con el período configurado.

Estos ajustes de política los mantiene la tienda. El módulo no proporciona una base de políticas legales actualizada automáticamente para cada país. Elige la política y el texto para las prácticas reales de la tienda antes de confiar en la información mostrada.

Programar el proceso de trabajo

La tarea incluida Procesar historial de precios Omnibus vence cada 300 segundos. Gestiona cambios pendientes, capturas, reconstrucción de la instalación y limpieza elegible de retención. La hora diaria predeterminada de las 02:00 determina cuándo vence un nuevo ciclo de capturas. Pueden ser necesarias varias ejecuciones del proceso de trabajo para completarlo.

Usa tu gestor de tareas compatible instalado o el programador del alojamiento. Cron Manager es opcional. Esta tarea no activa la alternativa de visitas del programador incluido. Las visitas a páginas no ejecutan esta tarea; configura una ejecución programada externa.

El módulo tiene un controlador frontal cron protegido por token. Un administrador del servidor puede obtener su URL real ejecutando esto en la tienda instalada y sustituyendo la ruta:

php -r 'require "/absolute/path/to/shop/config/config.inc.php"; echo Module::getInstanceByName("mpromnibus")->getCronURL(), PHP_EOL;'

Usa la URL devuelta en el programador del alojamiento, por ejemplo cada minuto. El ejecutor procesa las tareas vencidas. Mantén privado el token y actualiza las URL programadas si cambia el token cron compartido. Usa la URL realmente generada en lugar de construir una a partir de un formato supuesto de URL amigables.

Comprobar el progreso

Abre Panel en el contexto de una sola tienda. Lee Cambios en cola, Último trabajo, Elementos procesados, Errores y Última actividad. Vuelve a abrirlo tras las ejecuciones programadas para ver el progreso. Si Último trabajo no cambia, el proceso de trabajo programado no se está ejecutando.

Las capturas cubren los productos activos disponibles para pedido en los mercados públicos seguidos. Cada mercado incluye tienda, país y moneda. Cubren contextos activos recientemente y el país/la moneda predeterminados de la tienda, no todas las parejas posibles de país y moneda. Contextos prioritarios (JSON) no añade mercados en esta versión.

Pestaña "Display"

Comprueba cada ubicación activada en tu tema. Las actualizaciones de combinación del producto borran la referencia y el texto de unidad anteriores antes de solicitar el resultado de la nueva selección. Una actualización fallida deja la comparación oculta. El gráfico del historial de precios pertenece al back office y no es un gráfico para la tienda.

Pestaña "Legal text"

Edita todos los idiomas de la tienda y pulsa Guardar. Los campos de texto proporcionados requieren valores no vacíos.

El formateador acepta {lowest_price}, {current_price}, {discount_percent}, {window_days}, {window_start} y {window_end}. Conserva los tokens que necesites. Si configuras un período distinto de 30 días, cambia las menciones fijas de 30 días en todos los idiomas.

Crear una política de producto o combinación

Abre Omnibus Compliance > Políticas de producto con una tienda seleccionada. El panel es Base legal y unitaria específica del producto.

1. Selecciona un Producto.
2. Establece ID de combinación en 0 para el valor predeterminado de todo el producto o introduce una combinación válida perteneciente al producto.
3. Elige Modo de historial: Regla estándar de 30 días / productos nuevos o Perecederos: precio antes de la primera reducción.
4. Deja Sustitución de la fecha de oferta vacío para usar la información de oferta disponible, o introduce la fecha y hora reales de oferta cuando la creación en el catálogo no las describa. La hora guardada es el valor local de la tienda.
5. Establece los campos de precio unitario como se describe a continuación.
6. Pulsa Guardar política. Se requiere permiso de edición.

Una política específica de combinación tiene prioridad sobre una de todo el producto. Una política explícita guardada también tiene prioridad sobre el tratamiento para perecederos derivado de categorías. Guardar la política invalida la caché de datos de salida de la tienda.

Seleccionar un modo de precio unitario

Una política nueva empieza con historial estándar, anulación de la fecha de oferta vacía, precio unitario automático, cantidad de base 1 y campos de cantidad/unidad/motivo vacíos. Los datos de cantidad inválidos o incompatibles no producen ninguna indicación de precio unitario.

Para un paquete de 500 g comparado por 100 g, selecciona Contenido y base manuales, introduce cantidad de contenido 500, código de contenido g, cantidad de base 100 y código de base g. Con un precio actual del paquete de 10, el precio calculado por 100 g es 2 en la misma moneda. Es un cálculo ilustrativo, no un registro del catálogo. Comprueba el resultado en la tienda y el redondeo.

Pestaña "Disclosures"

Los cuatro interruptores de información empiezan desactivados. Actívalos solo después de proporcionar un texto que describa tu tienda.

Parámetros de clasificación de búsquedas (Etiqueta|Nota por línea) y Parámetros de clasificación de categorías (Etiqueta|Nota por línea) empiezan vacíos. Usa una línea como:

Relevance|How closely the result matches the search terms

Los demás campos de declaración tienen textos traducidos proporcionados. El texto inicial del procesamiento de reseñas indica que la tienda no comprueba si las reseñas proceden de compradores reales. Sustitúyelo solo si tu proceso es distinto. La mayoría de los campos de declaración traducidos requieren un valor en cada idioma instalado; las listas de parámetros de clasificación pueden quedar vacías.

Estos ajustes publican explicaciones. No inspeccionan algoritmos de clasificación, no verifican la autoría de las reseñas ni establecen si un precio mostrado se eligió mediante decisiones automatizadas.

Ámbito de precios públicos

El historial registra el precio público efectivo para una cantidad de uno del producto o combinación, tienda, país y moneda correspondientes. Conserva precios con y sin impuestos. La comparación de la tienda se refiere al precio público con impuestos correspondiente. Los precios específicos del cliente, precios mayoristas/de grupo, tramos de cantidad y descuentos de carrito quedan fuera de este historial público.

Los cambios nativos admitidos de productos, combinaciones, precios específicos y reglas de precios del catálogo crean trabajo de registro. Las herramientas de precios compatibles pueden notificar modificaciones confirmadas mediante el hook de integración del módulo. Confirma la compatibilidad de tu importador o herramienta de precios concretos. Los cambios directos en la base de datos que evitan los hooks necesitan especial atención.

La instalación examina los precios específicos existentes. Registra las observaciones actuales elegibles y puede conservar proyecciones anteriores para inspección. Las proyecciones históricas se marcan como no elegibles para resolver referencias porque no se demuestran su prioridad ganadora histórica, sus impuestos ni su precio mostrado. No aportan un registro anterior de 30 días que falte.

Selección de referencia

Para la política estándar, el módulo selecciona el precio público elegible más bajo del período aplicable anterior al inicio de una reducción admitida. El período predeterminado es de 30 días. Una oferta anterior dentro de ese período puede convertirse, por tanto, en la referencia.

El tratamiento introductorio usa el período de oferta documentado según la política configurada. El tratamiento para perecederos usa información de precios documentada anterior a la primera reducción. El tratamiento progresivo necesita un episodio continuo de reducciones admitido. El mecanismo de resolución comprueba el inicio de la reducción y la cobertura del historial antes de mostrar una comparación.

Por ejemplo, si un período de 30 días completamente documentado contiene tanto el precio habitual como un precio de oferta anterior inferior, el precio de oferta anterior es la referencia estándar. No sustituyas ese resultado por un precio habitual superior solo porque el precio anterior fuera promocional.

Cuándo se suprime la visualización

Una referencia permanece oculta cuando el período del historial, el inicio de la reducción o la cobertura aceptada son insuficientes. También se suprime cuando la oferta mostrada difiere del precio público o queda fuera de la comparación pública por otro motivo. Las visualizaciones sin impuestos en la tienda no reciben esa referencia pública.

Las reglas de carrito, regalos, precios de línea desconocidos y precios de línea distintos del precio público esperado suprimen la referencia del carrito. La visualización del precio unitario necesita además su propio interruptor activado y una base de cantidad válida.

Inspeccionar un producto y un mercado

Abre Omnibus Compliance > Historial de precios. Selecciona el producto, la combinación y el contexto de mercado registrado. Revisa Cronología del precio efectivo y la marca de inicio de la reducción. La tabla incluye Precio aplicado, Moneda, Anunciado, Elegible para resolución, Confianza, Precisión temporal, Fuente, Aplicado desde y Aplicado hasta.

Lee estas columnas en conjunto. Una fila solo cuenta para el precio de referencia cuando lo indica Elegible para resolución. La visualización del inicio de la reducción muestra si la fecha de inicio se proporcionó, se dedujo o no se puede determinar. Comprueba la combinación exacta y el mercado antes de compararlos con la tienda.

Sin referencia después de la instalación

Comprueba si hay suficientes registros de precios anteriores. El módulo registra los precios desde la instalación y no puede crear registros pasados. Las estimaciones históricas reconstruidas no se usan para el precio de referencia. Si el período requerido no está cubierto, el precio de referencia queda oculto; es lo esperado.

Observaciones antiguas o incompletas

Comprueba Activar módulo, Activar capturas diarias, Activar proceso de precios modificados, la ejecución del programador, Última actividad y Errores. Confirma que el mercado esté seguido y activo. Aumentar el hueco aceptado no puede reconstruir el período faltante. Reanuda el registro regular e investiga la integración de modificaciones de la herramienta de precios.

Falta la referencia solo en una ubicación

Comprueba su interruptor en Visualización, los hooks del tema y el comportamiento de actualización del producto. En un carrito, comprueba reglas, regalos y coincidencia de precios de línea. Compara un contexto de cliente público con impuestos con el mercado registrado correspondiente. Los temas personalizados y los módulos de checkout necesitan una prueba funcional.

Los ajustes no se guardan

Mantén el JSON válido. Incluye el Perfil de jurisdicción seleccionado en el objeto de política. Usa ID de categoría positivos, intervalos numéricos válidos, una URL de clasificación válida y los textos requeridos en todos los idiomas instalados. En Políticas de producto, selecciona una tienda, un producto/una combinación válidos, cantidades manuales positivas y un motivo de exención cuando sea necesario.

Conservar los registros de precios

El proceso de trabajo programado elimina los registros de precios caducados según Días de conservación del historial, con límites de seguridad internos. La limpieza avanza en pequeños lotes y puede requerir varias ejecuciones. Mantén copias de seguridad o exportaciones separadas de los registros que debas conservar más tiempo.

El registro de precios del catálogo excluye observaciones personalizadas. Sin embargo, el endpoint de resolución almacena una huella calculada con una sal criptográfica a partir de la dirección de conexión del visitante para limitar las peticiones. No describas todo el módulo como si no tratara ninguna información relacionada con visitantes.

Desactivar o desinstalar

Para detener temporalmente el procesamiento de esta tienda, desactiva Activar módulo y guarda. Las observaciones existentes permanecen hasta la limpieza o eliminación.

Antes de desinstalar, haz una copia de seguridad o exporta los registros de precios y los datos de políticas que necesites. La desinstalación elimina el historial registrado del módulo, las tablas del módulo, los ajustes, el menú y el registro de la tarea, así que el historial de cumplimiento conservado se borra. Reinstalar no lo restaura sin una copia de seguridad independiente.