E-commerce≈ 15 min

VTConnecter VTEX à Copernic

Permet à votre assistant de retrouver une commande à partir de son numéro et de l’e-mail du client, puis d’indiquer son statut, son contenu et son suivi de livraison.

Avant de commencer

Un accès à l’admin VTEX avec le rôle User Administrator - RESTRICTED, plus un rôle qui inclut déjà les produits OMS et Dynamic Storage (par exemple Owner (Admin Super)).

Ce que vous allez nous transmettre

À la fin de ce guide, vous aurez ces informations en main.

Information	À quoi ça correspond	Exemple de format
Account Name	Le nom de votre compte VTEX : la partie avant `.myvtex.com` dans l’adresse de votre admin.	`maboutique`
App Key	L’identifiant de la clé d’API que vous allez créer. Il commence par `vtexappkey-`.	`vtexappkey-maboutique-ABCDEF`
App TokenConfidentiel	Le secret associé à cette clé. Il donne accès à vos commandes : ne le partagez qu’avec Copernic.	`XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`
EnvironmentFacultatif	L’adresse technique utilisée pour joindre VTEX. Laissez vide : Copernic utilise `vtexcommercestable`, la valeur standard. Indiquez `myvtex` seulement si votre intégrateur VTEX vous le demande.	`vtexcommercestable`

Autorisations à cocher

Cochez uniquement celles-ci : votre assistant n’a pas besoin de plus.

Autorisation	Pourquoi
`OMS › OMS access › View order`	Lire une commande (statut, articles, adresse, suivi) et retrouver les commandes passées en un seul paiement. Lecture seule.
`Dynamic Storage › Dynamic storage generic resources › Read only documents`	Lire l’e-mail du client dans Master Data quand VTEX le masque dans la commande. Il sert à vérifier l’identité de la personne qui demande. Lecture seule.

Pas à pas

Étape 1
Noter le nom de votre compte
Connectez-vous à l’admin VTEX et regardez l’adresse dans votre navigateur, de la forme https://maboutique.myvtex.com/admin. Le mot avant .myvtex.com est votre Account Name.
Étape 2
Créer un rôle en lecture seule
Un rôle définit ce que la clé a le droit de faire. Créez-en un qui permet seulement de lire les commandes.
1. Cliquez sur l’avatar de votre profil en haut, puis sur Account settings > User roles.
2. Cliquez sur + Create Role, puis dans Choose role, choisissez Custom.
3. Dans Choose a product, choisissez OMS et cochez uniquement View order.
4. Cliquez sur Configure Another Product, choisissez Dynamic Storage et cochez uniquement Read only documents.
5. Dans Role name, saisissez Copernic - lecture commandes, puis cliquez sur Save. Inutile d’ajouter des utilisateurs.
Astuce
Si l’admin est en portugais, les menus s’appellent Configurações da conta > Perfis de acesso. Les noms des ressources (View order, Read only documents) restent en anglais.
Attention
Si OMS ou Dynamic Storage n’apparaissent pas dans la liste, votre propre utilisateur n’a pas accès à ces produits. Demandez à un administrateur principal de faire cette étape.
Étape 3
Générer la clé d’API
1. Cliquez sur l’avatar de votre profil, puis sur Account settings > API Keys.
2. Vérifiez que vous êtes sur l’onglet Generated, puis cliquez sur + Generate Key.
3. Dans Key identification, saisissez Copernic.
4. Sélectionnez uniquement le rôle créé à l’étape précédente, puis cliquez sur Generate.
Attention
N’associez pas de rôle plus large (comme Owner (Admin Super)) : la clé pourrait alors modifier votre boutique.
Étape 4
Récupérer l’App Token
VTEX n’affiche pas le secret directement : il vous donne un lien à usage unique pour le voir.
1. Cliquez sur Copy pour copier le lien, puis sur Close.
2. Collez le lien dans votre navigateur. Il doit commencer par https://share.vtex.com/credentials/.
3. Cliquez sur Copy pour copier le token et gardez-le dans un endroit sûr.
Attention
Le lien ne s’ouvre qu’une seule fois et expire après 24 heures. Si vous le perdez, renouvelez le token depuis la ligne de la clé (menu ⋮).
Étape 5
Copier l’App Key
De retour sur l’onglet Generated, repérez la ligne Copernic. La valeur affichée dans la colonne Key/Name, qui commence par vtexappkey-, est votre App Key.
Astuce
VTEX recommande de renouveler le token tous les 3 mois. Si vous le renouvelez, envoyez le nouveau à Copernic, sinon l’assistant perd l’accès.
Étape 6
Transmettre les informations à Copernic
Envoyez à votre contact Copernic l’Account Name, l’App Key et l’App Token. Nous activons la connexion et vous confirmons quand l’assistant y a accès.
Astuce
Vous pouvez aussi saisir ces informations vous-même : dans votre espace Copernic, ouvrez l’onglet Mon entreprise, remplissez la carte VTEX, puis cliquez sur Enregistrer. Cette carte apparaît dès que Copernic a activé le connecteur pour votre entreprise.

Vos clés sont confidentielles

Transmettez-les uniquement à votre contact Copernic, par un canal privé — jamais sur un forum, un ticket public ou un réseau social. Vous pouvez couper l’accès à tout moment en supprimant la clé (ou l’application) dans votre outil.