Installer Wix
Configurez Wix eCommerce pour l'intégration avec Order Invoicer
Prérequis
Avant de commencer l'installation, assurez-vous que :
- Vous avez un site Wix avec Wix Stores activé
- Vous avez accès au tableau de bord Wix en tant que propriétaire ou co-propriétaire du site
- Votre site est publié
Récupérer l'ID de votre site
L'ID de site est un identifiant unique associé à votre site Wix.
Comment trouver votre Site ID
- Connectez-vous à votre tableau de bord Wix
- Sélectionnez votre site
- Dans l'URL de votre navigateur, l'ID de site est visible sous la forme :
https://manage.wix.com/dashboard/<site-id>/home - Vous pouvez également le retrouver dans Paramètres > Paramètres avancés > Site ID
Copiez cet identifiant — vous en aurez besoin lors de la configuration du connecteur.
Générer une clé API Wix
Pour connecter Order Invoicer à votre boutique Wix, vous devez créer une clé API depuis le Gestionnaire de clés API Wix.
Important : Seuls les propriétaires et co-propriétaires du compte Wix peuvent créer des clés API.
1. Accéder au Gestionnaire de clés API
- Connectez-vous à votre compte Wix
- Rendez-vous sur Manage.wix.com
- Cliquez sur votre avatar en haut à droite
- Sélectionnez Paramètres du compte
- Dans le menu latéral, cliquez sur Clés API
2. Créer une nouvelle clé API
- Cliquez sur + Générer une clé API
- Donnez un nom descriptif à votre clé (ex : "Order Invoicer - Synchronisation commandes")
- Sélectionnez l'expiration souhaitée (nous recommandons Sans expiration pour éviter les interruptions de service)
3. Configurer les permissions
Sous Autorisations, activez les permissions suivantes :
Wix eCommerce
- ✅ Lire les commandes (Read Orders)
- ✅ Gérer les commandes (Manage Orders) — optionnel, pour la mise à jour du statut
Wix Contacts & Members (optionnel)
- ✅ Lire les contacts (Read Contacts) — pour enrichir les données client
- Cliquez sur Générer la clé
4. Copier vos identifiants
Après génération, notez immédiatement :
- Clé API : la chaîne de caractères affichée (commence généralement par
IST.) - Site ID : visible dans votre tableau de bord (voir section précédente)
Sécurité : La clé API ne sera plus visible après avoir fermé cette fenêtre. Conservez-la dans un endroit sûr.
Configurer Order Invoicer
- Dans Order Invoicer, sélectionnez Wix comme plateforme e-commerce
- Renseignez votre Site ID dans le premier champ
- Collez votre Clé API dans le second champ
- Cliquez sur Suivant — Order Invoicer va vérifier vos identifiants en récupérant vos commandes
Dépannage courant
Erreur "Identifiants invalides"
- Vérifiez que vous avez copié la clé API complète (elle peut être longue)
- Assurez-vous que la clé API n'a pas expiré
- Vérifiez que les permissions Lire les commandes sont bien activées sur la clé
- Confirmez que le Site ID correspond bien au site qui contient votre boutique
Erreur "Accès refusé"
- Seuls les propriétaires et co-propriétaires peuvent créer des clés API Wix
- Vérifiez que votre site Wix a bien Wix Stores installé et activé
Le Site ID est introuvable
- Accédez à votre site dans le tableau de bord Wix
- L'URL contient votre Site ID :
manage.wix.com/dashboard/**{site-id}**/home - Vous pouvez aussi aller dans Paramètres > Paramètres avancés
Tester manuellement l'API
Vous pouvez vérifier vos identifiants avec cURL :
curl -X POST 'https://www.wixapis.com/ecom/v1/orders/search' \
-H 'Authorization: <votre-clé-api>' \
-H 'wix-site-id: <votre-site-id>' \
-H 'Content-Type: application/json' \
-d '{"cursorPaging": {"limit": 1}}'Une réponse avec "orders": [...] confirme que vos identifiants sont valides.