Get Started

Conectando tu Tienda #

El primer paso para instalar Clerk.io es conectar tu tienda con tu cuenta de Clerk.io.

Después de seguir estos simples pasos, podrás ver tu Tienda de Demostración, que te ofrece una visión personal de cómo funcionará Clerk.io en tu tienda en línea, antes de configurar el resto del sistema.

1. Agregar Tienda #

Después de iniciar sesión en my.clerk.io, lo primero que necesitas hacer es agregar tu tienda:

1. Escribe el Nombre y Dominio de tu tienda en línea.

2. Elige VTEX como la Plataforma y selecciona tu Moneda.

3. Haz clic en Agregar Tienda.

2. Instalar y configurar el módulo #

1. En el cli de vtex, ejecuta vtex install clerkiopartnerdk.integration-vtex. Puedes confirmar que la aplicación se ha instalado ejecutando vtex ls nuevamente.

2. Accede a la sección de Apps en la página de administración de tu cuenta y busca la caja de Integración ClerkIO. Una vez que la encuentres, haz clic en la caja. Completa los campos según lo solicitado. Para sitios de MultiBinding, haz clic en habilitar la configuración vinculando para que coincida una Tienda Clerk con cada Binding.

3. Genera los feeds para productos, categorías y pedidos haciendo una solicitud POST a los siguientes endpoints (reemplazando accountName, workspace y bindingID):

Haz una solicitud GET a este siguiente endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

Requiere que VtexIdclientAutCookie se envíe como encabezado.

La primera llamada para la generación del feed responderá con un array vacío. Dependiendo del tamaño del catálogo de tu tienda, el feed puede tardar un tiempo en generarse.

3. Sincroniza tu tienda #

Después de configurar el módulo, simplemente necesitas sincronizar tu tienda.

1. Ve a my.clerk.io Estado del Sistema -> Configuración de Sincronización de Datos -> Una vez que se te pida insertar la URL, inserta el siguiente formato de URL: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} y haz clic en guardar en la parte inferior izquierda de la página.

2. Haz clic en “Iniciar nueva sincronización de datos”. Esta URL de feed es exclusiva para el uso de ClerkIO.

Si deseas validar el feed de tu tienda, utiliza este endpoint en su lugar: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}} este endpoint requiere autenticación VTEX.

Clerk.io ahora importará tus productos, categorías y ventas. Cuando termine, tu tienda estará conectada. ¡Buen trabajo!