Preguntas Frecuentes

Sincronización con HTTP Auth #

A menudo se utiliza la autenticación HTTP en sitios de staging para evitar visitantes no deseados.

Esto también bloqueará el importador de Clerk y mostrará un error 401 No autorizado en el registro de sincronización.

Puedes verificar fácilmente el importador insertando la información de autenticación en la URL de importación como se muestra a continuación, en Sincronización de Datos en my.clerk.io:

https://USER:OASS@dandomain.clerk.io/api/6155349/28

Errores comunes de sincronización #

Al importar datos con la aplicación DanDomain de Clerk.io, el servidor de la tienda en línea es responsable de enviar los datos de producto, categoría y ventas a Clerk.io.

Sin embargo, en algunos casos, la configuración del servidor puede impedir que el importador acceda, causando un error en Sincronización de Datos.

A continuación se muestra una lista de los errores más comunes y cómo solucionarlos.

Error 401 del servidor: No autorizado #

Este error ocurre si tu tienda en línea / entorno de desarrollo requiere autenticación HTTP para acceder.

Esto se soluciona simplemente insertando el Nombre de usuario y Contraseña como parte de la URL de importación:

http://USER:PASS@dandomain.clerk.io/api/6155349/28

Error 403 del servidor: Prohibido #

Este error ocurre si tu servidor bloquea el acceso del importador. En la mayoría de los casos, solo necesitas agregar a la lista blanca la dirección IP del importador para darle acceso.

La última dirección IP se puede encontrar aquí.

También verifica que tu clave pública, clave privada y URL de importación sean correctas para la tienda en la que estás operando en my.clerk.io

En algunos casos (si estás en una versión más antigua de dandomain), este error también se mostrará si estás utilizando dominios de diferentes idiomas y cada uno tiene diferentes ID. En este caso, asegúrate de que los ID de cada tienda correspondan a los que están en tu backend de dandomain.

¿Qué pasa si ya he agregado a la lista blanca pero sigue ocurriendo el mismo error?

Hay algunas instancias en las que has agregado a la lista blanca la dirección IP del importador, y el error persiste, entonces te recomendamos que revises estas partes:

• La parte de autenticación del cuerpo puede haber sido eliminada de la solicitud del servidor de la tienda.

• Límite de tasa para el servidor en relación con Cloudflare.

Error 404 del servidor: No encontrado #

Este error ocurre si el importador no pudo acceder al enlace que nos envía datos desde la tienda en línea. En la mayoría de los casos, ocurre porque la extensión está:

• No instalada en absoluto

• Un caché causa que el enlace no se inicialice

Primero asegúrate de que has instalado la aplicación correctamente.

En segundo lugar, asegúrate de vaciar el caché de tu tienda en línea antes de intentar una nueva importación.

Error 429 del servidor: Demasiadas solicitudes #

Este error ocurre si tu servidor niega el acceso al importador debido a demasiadas solicitudes entrantes.

Puedes solucionar esto aumentando el límite de solicitudes para tu servidor o configurando el Tamaño de Página a un valor más alto en el Clerk.io importador, lo que hace que el importador realice menos solicitudes, pero más grandes:

Error 500 del servidor interno #

Este error significa que tu servidor encontró un error interno y no pudo especificar qué error ocurrió.

En estos casos, puedes revisar tu Registro del Servidor para identificar qué proceso falló y por qué. En la mayoría de los casos, es simplemente debido a un producto con un atributo inválido, o una función que se llama incorrectamente en la tienda en línea. Si esto último ocurre, te sugerimos que contactes a nuestro equipo de soporte técnico para esta parte.

Error 503 del servidor: Servicio no disponible #

Este error suele ser temporal y es causado por el servidor que está demasiado ocupado para manejar la solicitud. Intenta nuevamente un poco más tarde.

Si el problema continúa ocurriendo, podría significar que el servidor está sobrecargado de procesos y está cerca de su capacidad máxima.

Verifica la carga del servidor para identificar si este es el caso.

Actualizando a Clerk.js 2 #

Clerk.js 2 es una versión más rápida y flexible de nuestra biblioteca de JavaScript que hace que instalar Clerk.io en cualquier tienda en línea sea muy fácil.

Sin embargo, dado que las dos versiones funcionan de manera ligeramente diferente, necesitas seguir estos pasos para actualizar con éxito.

Las dos principales diferencias en Clerk.js 2 son que los Diseños en my.clerk.io utilizan el Liquid lenguaje de plantillas, pero también se pueden crear fácilmente utilizando el Editor de Diseños.

Paso 1: Convertir Diseños #

Dado que Clerk.js 2 tiene un enfoque diferente para los Diseños, necesitas crear nuevos.

Puedes crear tus Diseños de Clerk.js 2 de una de dos maneras:

• 1. Usa el intuitivo Editor de Diseños para crear nuevos Diseños, como se describe en los siguientes puntos.

• 2. Convierte tus antiguos Diseños. Sigue esta guía para ver cómo hacerlo.

1.1 Comienza yendo a my.clerk.io -> Recomendaciones / Búsqueda -> Diseños y haz clic en Nuevo Diseño:

1.2 Sigue el asistente de configuración de diseño y selecciona tu tipo de diseño y dale un nombre a tu diseño (recomendamos agregar " V2" para que sea obvio que estás utilizando Clerk.js2).

1.3. En el Editor de Diseños, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc. para editarlo, o agrega nuevos elementos al Diseño para añadir más información sobre los productos.

1.4. Haz clic en Publicar Diseño cuando hayas terminado, y ve al Paso 2 en la guía.

1.5. Por último, ve a Recomendaciones / Búsqueda -> Contenido y cambia tu Clerk.io Contenido para usar tu nuevo Diseño.

1.6. Haz clic en Actualizar Contenido. Esto hará que temporalmente no aparezcan en tu tienda en línea, hasta que termines con el Paso 2. Elige el nuevo Diseño para todo el Contenido que debe ser actualizado.

1.9. ¡Listo! Ahora estás listo para cambiar a Clerk.js 2.

Paso 2: Cambiar a Clerk.js 2 en la aplicación DanDomain #

A continuación, necesitas activar Clerk.js 2 en la aplicación DanDomain Classic.

2.1. Inicia sesión en tu backend de DanDomain Classic y ve a la Aplicación Clerk.io en el menú lateral.

2.2. En General, haz clic y marca la casilla junto a Usar Clerk.js 2 y haz clic en Guardar: