FAQ
¿Tienes problemas con tu integración de Dandomain Classic? Este FAQ cubre los problemas más comunes y sus soluciones, desde la autenticación HTTP hasta errores de sincronización.
Autenticación HTTP #
La autenticación HTTP se utiliza a menudo en sitios de pruebas para evitar visitantes no deseados.
Esto bloqueará el importador de Clerk y mostrará un error 401 Unauthorized en el registro de sincronización.
Puedes solucionar esto insertando la información de autenticación en la URL de importación.
En my.clerk.io > Data > Configuration, actualiza tu URL de importación así:
https://USER:PASS@dandomain.clerk.io/api/6155349/28
Errores comunes de sincronización #
Al importar datos con la App Dandomain de Clerk, el servidor de tu tienda online es responsable de enviar los datos de productos, categorías y ventas a Clerk.
Sin embargo, en algunos casos, la configuración del servidor puede bloquear la importación de acceder a los datos, causando un error en Data Sync.
A continuación, se muestra una lista de los errores más comunes y cómo solucionarlos.
401 Unauthorized #
Este error sucede si tu tienda online o entorno de desarrollo requiere HTTP authentication para acceder.
Esto se resuelve insertando el Username y Password como parte de la URL de importación:
http://USER:PASS@dandomain.clerk.io/api/6155349/28
403 Forbidden #
Este error ocurre si tu servidor bloquea al importador para que no acceda.
En la mayoría de los casos, simplemente necesitas poner en la lista blanca la dirección IP del importador para darle acceso.
La última dirección IP puede encontrarse aquí.
También verifica que tu public key, private key y import URL sean correctos para la tienda en la que estás operando dentro de my.clerk.io.
En algunos casos (si tienes una versión antigua de Dandomain), este error también se mostrará si usas distintos dominios por idioma y cada uno tiene un ID diferente.
En este caso, asegúrate de que los ID de cada tienda correspondan con los del backend de Dandomain.
¿Qué pasa si ya he puesto en la lista blanca pero el mismo error sigue ocurriendo?
Hay algunos casos en los que has puesto la dirección IP del importador en la lista blanca, y el error persiste.
En estos casos, te recomendamos revisar estos puntos:
- La parte de autenticación del cuerpo puede estar siendo eliminada de la solicitud por el servidor de la tienda.
- Límite de tasa para el servidor en relación con Cloudflare.
404 Not Found #
Este error ocurre si el importador no pudo acceder al enlace que envía datos desde la tienda online.
En la mayoría de los casos, sucede porque la app:
- No está instalada
- Una caché hace que el enlace no se inicialice
Primero, asegúrate de haber instalado la app correctamente.
Segundo, vacía la caché de tu tienda online antes de intentar una nueva importación.
429 Too Many Requests #
Este error ocurre si tu servidor niega el acceso al importador debido a demasiadas solicitudes entrantes.
Puedes solucionarlo subiendo el request limit de tu servidor o configurando el Page Size a un valor mayor en my.clerk.io > Data > Configuration, haciendo que el importador realice menos solicitudes pero más grandes:
500 Internal Server Error #
Este error significa que tu server encontró un internal error y no pudo especificar qué error ocurrió.
En estos casos, revisa tu Server Log para identificar qué proceso falló y por qué.
En la mayoría de los casos, se debe simplemente a un producto con un atributo inválido o a una función que se llama incorrectamente en la tienda online.
Si ocurre esto último, te sugerimos contactar a nuestro equipo de soporte técnico para esta parte.
503 Service Unavailable #
Este error suele ser temporal y es causado porque el servidor está demasiado ocupado y no puede manejar la solicitud.
Intenta de nuevo más tarde.
Si el problema continúa, podría significar que el servidor tiene demasiados procesos y está cercano a su capacidad máxima.
Verifica la carga del servidor para identificar si este es el caso.
Actualiza a Clerk.js 2 #
Clerk.js 2 es una versión más rápida y flexible de nuestra librería JavaScript.
Hace que instalar Clerk en cualquier tienda online sea más sencillo.
Sin embargo, ya que las dos versiones funcionan de manera ligeramente diferente, debes seguir estos pasos para actualizar correctamente.
Las dos diferencias principales en Clerk.js 2 son que los Diseños en my.clerk.io usan el lenguaje de plantillas Liquid, pero también pueden crearse fácilmente usando el Editor de Diseños.
Crear diseños #
Dado que Clerk.js 2 tiene un enfoque diferente para los Diseños, necesitas crear unos nuevos.
Puedes crear tus Diseños de Clerk.js 2 de dos maneras:
- Utiliza el Design Editor intuitivo para crear nuevos Diseños, como se describe a continuación.
- Convierte tus antiguos Diseños. Sigue esta guía para ver cómo hacerlo.
Opción del Design Editor #
- Ve a my.clerk.io > Recommendations/Search > Designs > New Design.
Sigue el asistente de configuración de diseño y selecciona el type de tu diseño y asígnale un name (recomendamos agregar “V2” para que sea obvio que estás usando Clerk.js 2).
En el Design Editor, haz clic en cualquiera de los elementos existentes como nombre, imagen, botón, etc., para editarlo, o agrega nuevos elementos al Diseño para añadir más información sobre los productos.
Haz clic en Publish Design cuando termines, y ve al Paso 2 en la guía.
Dirígete a Recommendations/Search > Content y cambia tu Clerk Content para usar tu nuevo Diseño.
Haz clic en Update Content. Esto hará que temporalmente no se muestren en tu tienda online, hasta que termines el Paso 2. Elige el nuevo Diseño para todo el Content que debe actualizarse.
Ahora ya puedes cambiar a Clerk.js 2.
Activar Clerk.js 2 #
Después necesitas activar Clerk.js 2 en la app Dandomain Classic.
Inicia sesión en el backend de Dandomain Classic y accede a la Clerk App en el menú lateral.
En General, haz clic y marca la casilla junto a Brug Clerk.js 2 y haz clic en Save:
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.