Get Started

Collegare il tuo Negozio #

Il primo passo per installare Clerk.io è collegare il tuo negozio al tuo account Clerk.io.

Dopo aver seguito questi semplici passaggi, sarai in grado di vedere il tuo Negozio Demo, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop, prima di configurare il resto del sistema.

1. Aggiungi Negozio #

Dopo aver effettuato il login su my.clerk.io, la prima cosa da fare è aggiungere il tuo negozio:

1. Scrivi il Nome e il Dominio del tuo webshop

2. Scegli VTEX come Piattaforma e scegli la tua Valuta.

3. Clicca su Aggiungi Negozio.

2. Installa e configura il modulo #

1. Sul vtex cli esegui vtex install clerkiopartnerdk.integration-vtex. Puoi confermare che l’app è stata installata eseguendo di nuovo vtex ls.

2. Accedi alla sezione App nella pagina di amministrazione del tuo account e cerca la casella di integrazione ClerkIO. Una volta trovata, clicca sulla casella. Compila i campi come richiesto. Per i siti MultiBinding, clicca sulla configurazione di abilitazione per associare un Negozio Clerk a ciascun Binding.

3. Genera i feed per prodotti, categorie e ordini effettuando una richiesta POST ai seguenti endpoint (sostituendo accountName, workspace e bindingID):

Fai una richiesta GET a questo seguente endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

È necessario inviare VtexIdclientAutCookie come intestazione.

La prima chiamata alla generazione del feed risponderà con un array vuoto. A seconda della dimensione del Catalogo del tuo negozio, il feed potrebbe richiedere del tempo per essere generato

3. Sincronizza il tuo negozio #

Dopo aver configurato il modulo, devi semplicemente sincronizzare il tuo negozio.

1. Vai su my.clerk.io Stato del Sistema -> Impostazioni di Sincronizzazione Dati -> Una volta invitato a inserire l’url, inserisci il seguente formato URL: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} e clicca su salva in basso a sinistra della pagina.

2. Clicca su “Inizia una nuova sincronizzazione dati”. Questo URL del feed è esclusivo per l’uso di ClerkIO.

Se desideri convalidare il feed del tuo negozio, utilizza invece questo endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}} questo endpoint richiede l’autenticazione VTEX.

Clerk.io importerà ora i tuoi prodotti, categorie e vendite. Quando sarà fatto, il tuo negozio sarà connesso. Ottimo lavoro!