Preguntas frecuentes

Utiliza estas comprobaciones cuando la configuración estándar de ideal.shop importe datos incompletos o se comporte de manera diferente al escaparate nativo.

Feeds Incompletos #

Verifica la respuesta real del feed antes de considerar una sincronización exitosa de Clerk.io como completa. Por defecto, cada tipo de dato está limitado a 50 registros.

Configura products y categories lo suficientemente alto para cubrir todo el catálogo y orders lo suficientemente alto para la importación histórica deseada. Verifica si hay parámetros duplicados o un segundo ?, luego compara la fuente, el feed y los conteos importados.

Un conteo exactamente igual al límite sugiere truncamiento. Si el feed contiene el registro faltante pero Clerk.io no, inspecciona los registros de sincronización y la configuración de datos. Si está ausente en el feed, investiga la exportación de la plataforma o las reglas de visibilidad.

Para una exportación grande que expira por tiempo, reduce la cantidad de pedidos históricos solicitados para establecer una base exitosa, luego acuerda un método de exportación completo con ideal.shop. Una respuesta exitosa más pequeña no es evidencia de historial completo.

Fodmagasinet reportó un HTTP 524 al solicitar 100,000 pedidos. Este es un ejemplo de un tiempo de espera de exportación, no un máximo universal recomendado.

No asumas que el endpoint admite paginación, offsets, cursores o filtrado por fecha. Pregunta al desarrollador de la plataforma qué opciones se admiten y cómo detectar el final de la exportación. Verifica que el importador de Clerk.io pueda consumir ese método antes de usarlo.

Consulta importaciones en curso para restaurar la ventana de pedidos predeterminada sin desactivar las importaciones. Después de una interrupción, aumenta temporalmente la cobertura de pedidos y verifica si hay brechas.

Categorías Ocultas #

Compara las categorías ocultas o no publicadas con sus registros importados y los IDs de categoría referenciados por los productos.

Corrige las reglas de visibilidad en la exportación o el mapeo de importación, y vuelve a sincronizar. Verifica tanto los registros de categorías como las referencias de productos después. Ocultar una categoría en un Search Design no repara datos importados inconsistentes.

Precios Incorrectos #

Compara un producto simple, un producto con descuento y un producto variante con la tienda web nativa, incluyendo impuestos y moneda.

Si un padre se importa con price: 0 mientras las variantes tienen precios pagados, corrige la fuente o el mapeo de importación. Una etiqueta From que muestre el precio mínimo de variante importado puede mejorar la tarjeta, pero la ordenación sigue usando el precio importado configurado para ese orden.

Utiliza un único campo de precio verificado para los cálculos de descuento y precios tachados. No asumas que existen list_price o retail_price porque una plantilla genérica los usa.

Imágenes Borrosas #

Inspecciona las dimensiones cargadas de la imagen frente a su tamaño real en la tarjeta renderizada y la densidad de pantalla. Una caja CSS grande no puede añadir detalle a una imagen fuente pequeña.

Fodmagasinet utilizó un cambio en la URL de su imagen para solicitar una imagen más grande, con un segmento de tamaño /450-0/ y un tamaño de imagen cargado de 450 píxeles verificado durante la configuración. Esto fue específico de su servicio de imágenes; no es una transformación que deba aplicarse a todas las URLs de imágenes de ideal.shop.

Antes de cambiar URLs, verifica los tamaños compatibles del servicio de imágenes y la imagen devuelta, la relación de aspecto y el comportamiento de carga. Prefiere un campo de imagen fuente correcto u opción del servicio de imágenes antes que un reemplazo de cadena no verificado.

Compra de Variantes #

Utiliza el flujo nativo para productos simples y abre la página del producto cuando no se han seleccionado las opciones requeridas.

El adaptador personalizado de Fodmagasinet envió un ID de padre a través de las funciones nativas de compra y redirigió solo en caso de un rechazo específico de variantes activas. Ese adaptador depende del mensaje de respuesta de la plataforma y puede fallar si este cambia.

No lo instales como solución universal de variantes. Reutiliza metadatos de variantes verificados, un flujo de selección nativo compatible o mantén un enlace a la página del producto. Otros errores deben conservar su gestión nativa.

Conflictos de Search #

Si aparecen dos paneles de resultados, inspecciona tanto el desplegable nativo como el panel de búsqueda móvil. Verifica sus handlers de abrir/cerrar y la visibilidad computada mientras Search de Clerk.io está abierto.

Restringe cualquier supresión al componente Search relevante o al estado de apertura. Prueba nuevamente escribir, teclas de flechas, Enter tanto en keydown como en keyup, envío de formulario, Escape, acceso a basket y reabrir Search.

Si Close o Escape cambia la página o la URL inesperadamente, inspecciona la gestión de historial del panel nativo. Cerrar una superposición no debe depender de navegar Atrás a una entrada histórica asumida.

Fallos de Navegación #

Cuando los resultados desaparecen después de la navegación, compara una carga de página fresca con una transición de enlace nativo y Atrás/Adelante.

Revisa Settings > Features > SPA Auto Detect Changes, los IDs de página actuales, si el objetivo de inyección aún existe y si el Element realiza una nueva solicitud cuando su contexto cambia.

Si a un producto le faltan pestañas de descripción, corrige el objetivo de ubicación o agrega un fallback verificado. Si el objetivo existe pero el Element sigue faltando o obsoleto, recopila las URLs afectadas, los pasos de navegación, errores de consola y evidencia de solicitud para investigar.

Fodmagasinet utilizó un script temporal de limpieza de instancia separada durante la investigación de Preview. Depende de los internals de Clerk.io y no debe convertirse en el método de instalación por defecto. Documenta cualquier solución similar aparte, con su alcance y plan de eliminación, y haz pruebas nuevamente tras la solución soportada.

Elementos Duplicados #

Verifica si el mismo Element está instalado a través de bloques nativos de ideal.shop, inyección y código embebido manualmente al mismo tiempo.

Mantén una única instalación prevista por ubicación. Inspecciona el DOM y el panel de Red después de varias navegaciones; distingue las solicitudes legítimas de Elements separados de las solicitudes repetidas para una sola ubicación.

Si las recomendaciones nativas también son visibles, desactiva su visualización sin eliminar relaciones manuales de producto. Revisa que el reemplazo de Clerk.io funcione antes de quitar la visualización nativa.