Vtex

Get Started

Connecting your Store #

The first step of installing Clerk.io, is connecting your store with your Clerk.io account.

After following these simple steps you will be able to see your Demo Store, which gives you a personal overview of how Clerk.io will work on your webshop, before setting up the rest of the system.

1. Add Store #

After logging in to my.clerk.io, the first thing you need to do is add your store:

  1. Write the Name and Domain of your webshop

  2. Choose VTEX as the Platform and choose your Currency.

  3. Click Add Store.

2. Install and configure module #

  1. On the vtex cli run vtex install clerkiopartnerdk.integration-vtex. You can confirm that the app has now been installed by running vtex ls again.

  2. Access the Apps section in your account’s admin page and look for the ClerkIO Integration box. Once you find it, click on the box. Fill in the Fields as requested. For MultiBinding Sites, click on the enable configuration by binding to match a Clerk Store to each Binding.

  1. Generate the feeds for products, categories and orders by making a POST request to the following endpoints (replacing accountName, workspace, and bindingID):

Do a GET Request to this following endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

It requires VtexIdclientAutCookie to be sent as header.

The first call to the generation of the feed will respond with an empty array. Depending on the size of your store Catalogue the feed might take some time to generate

3. Sync your store #

After configuring the module, you simply need to synchronise your store.

  1. Go to my.clerk.io System Status -> Data Sync Settings -> Once prompted to insert the url, insert the following URL format: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} and click on save in the bottom left of the page.
Vtex feed url
  1. Click on “Start new data sync”. This feed URL is exclusive for the use of ClerkIO.

If you want to validate your store’s feed use this endpoint instead: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}} this endpoint requires VTEX authentication.

Clerk.io will now import your products, categories and sales. When its done, your store is connected. Good job!