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 sencillos pasos, podrás ver tu Demo Store, que te ofrece una visión general personalizada de cómo Clerk.io funcionará en tu tienda online, antes de configurar el resto del sistema.

1. Añadir tienda #

Después de iniciar sesión en my.clerk.io, lo primero que debes hacer es añadir tu tienda:

1. Escribe el Nombre y el Dominio de tu tienda online.

2. Elige VTEX como Plataforma y selecciona tu Moneda.

3. Haz clic en Add Store.

2. Instala y configura el módulo #

1. En la vtex cli ejecuta vtex install clerkiopartnerdk.integration-vtex. Puedes confirmar que la app se ha instalado ejecutando nuevamente vtex ls.

2. Accede a la sección de Apps en la página de administración de tu cuenta y busca el ClerkIO Integration box. Una vez lo encuentres, haz clic en la caja. Rellena los campos que se solicitan. Para sitios MultiBinding, haz clic en habilitar configuración por binding para vincular una Clerk Store a cada Binding.

3. Genera los feeds de productos, categorías y pedidos haciendo una petición POST a los siguientes endpoints (sustituyendo accountName, workspace y bindingID):

Haz una petición GET al siguiente endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

Es necesario enviar VtexIdclientAutCookie como header.

La primera llamada a 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 en generarse.

3. Sincroniza tu tienda #

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

1. Ve a my.clerk.io Data -> Configuration -> Cuando se te solicite insertar la url, introduce 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 “Start new data sync”. Esta URL de feed es exclusiva para el uso de ClerkIO.

Si quieres validar el feed de tu tienda, utiliza este endpoint: 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 importará ahora tus productos, categorías y ventas. Cuando termine, tu tienda estará conectada. ¡Buen trabajo!