Ce guide vous accompagne étape par étape pour connecter vos boutiques WooCommerce à GelatoConnect, afin d’automatiser le transfert des commandes de WooCommerce directement vers votre flux de production.
Prérequis
Avant de commencer à connecter une boutique WooCommerce à GelatoConnect, assurez-vous d’avoir :
Configuration du client dans GelatoConnect : Le client qui possède la boutique WooCommerce doit être créé avec l'accès aux Storefronts activé
Configuration WooCommerce compatible : WooCommerce version 2.4.8 ou supérieure avec une configuration API appropriée
Accès administrateur : Le PSP (prestataire d'impression) ou votre client doit disposer d'un accès de niveau administrateur à la boutique WooCommerce
Aperçu du processus de connexion
Le processus de connexion se déroule en quatre étapes clés :
Préparation : Assurer une configuration optimale dans GelatoConnect et WooCommerce
Connexion de la boutique : Établissement du lien entre WooCommerce et GelatoConnect
Configuration des produits : préparer vos produits pour l'impression
Test : Valider l'intégration avec des commandes d'essai
Découvrons chaque étape ensemble, en détail.
Phase 1 : Préparation dans GelatoConnect et WooCommerce
1) Configurez votre client
Allez dans la section Clients du menu de navigation à gauche de votre compte GelatoConnect.
Sélectionnez le client qui possède la boutique WooCommerce. S'il n'existe pas encore, ajoutez un nouveau client.
2) Décidez si vous souhaitez donner à votre client l'accès à l'interface Storefronts Connect
Storefronts Connect est l’interface utilisée par les PSP et vos clients pour gérer les vitrines B2C (y compris WooCommerce), les importations CSV et les boutiques manuelles.
Sans accès à l’interface Storefronts Connect :
Les PSP sont responsables de la connexion des nouveaux produits à la boutique WooCommerce.
Votre client pourrait avoir besoin de vous contacter pour obtenir des détails sur sa commande
Vous aurez besoin d'un accès administrateur à la boutique WooCommerce pour autoriser la connexion
Avec l'accès à l'interface Storefronts Connect :
Vos clients peuvent ajouter de nouveaux produits à leur boutique WooCommerce quand ils le souhaitent.
Votre client a accès à l'historique des commandes et aux détails de suivi
Vous n'aurez pas besoin d'un accès administrateur à la boutique WooCommerce, mais votre client devra l'avoir pour autoriser la connexion.
3) Accéder à l'interface Storefronts Connect
Les PSP peuvent accéder aux vitrines en utilisant leurs identifiants GelatoConnect habituels.
Pour permettre à vos clients d'accéder à Storefronts Connect :
Allez dans la section Clients de GelatoConnect
Sélectionnez le client, puis allez sur Modifier le client en haut à droite.
Activez l’option « Activer les vitrines »
Indiquez l'adresse e-mail, le prénom et le nom de votre client
Lorsque vous cliquez sur le bouton « Ajouter un administrateur », un e-mail sera envoyé à votre client avec les instructions de connexion.
4) Préparez votre catalogue des produits
Avant de connecter la boutique, assurez-vous d’avoir configuré vos produits dans GelatoConnect.
Vous devrez avoir créé des modèles de produits et des produits clients à partir de ces modèles de produits.
Au sein d'un produit client, vous pouvez définir quel client doit avoir accès à ce produit
5) Configurez votre boutique WooCommerce
Pour que votre boutique WooCommerce soit correctement configurée pour l'intégration avec GelatoConnect :
Vérifier l'accès à l'API REST WooCommerce :
Vérifiez que votre fichier
.htaccesscontient :SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
Activer l’API REST Legacy :
Depuis votre Panneau d'administration WooCommerce, accédez à WooCommerce → Paramètres → Avancé
Sélectionnez l’onglet Legacy API
Cochez la case pour \"Activer l'API REST legacy\"
Cliquez sur Enregistrer les modifications
Configurer les paramètres de permalien :
Allez dans Paramètres → Permaliens dans votre tableau de bord WordPress
Dans Paramètres courants, choisissez n'importe quelle option sauf Simple.
Cliquez sur Enregistrer les modifications
Vérifiez le bon fonctionnement de l’API en visitant
https://your-site-url-here.com/wc-api/v1/dans votre navigateur
Installez le plugin WooCommerce Legacy REST API (pour WooCommerce 9.0+):
Allez dans Extensions → Ajouter dans votre tableau de bord WordPress
Recherchez "WooCommerce Legacy REST API"
Installer et activer le plugin
Installez le plugin Gelato :
Dans votre tableau de bord WordPress, allez dans Extensions → Ajouter
Recherchez "Gelato"
Installez et activez l'extension Gelato Integration for WooCommerce
Mettre à jour le plugin Gelato pour l'utilisation en vitrine :
Dans le panneau d’administration WordPress, allez dans Extensions → Éditeur d’extension
Dans le menu déroulant en haut à droite, sélectionnez Gelato Integration for WooCommerce
Dans le panneau de droite, trouvez et ouvrez includes → Connector → GelatoConnector.php
Trouvez cette ligne de code :
const GELATO_DASHBOARD_URL = 'https://dashboard.gelato.com';Remplacez-le par :
const GELATO_DASHBOARD_URL = 'https://storefronts.gelato.com';Cliquez sur Mettre à jour le fichier pour enregistrer vos modifications
Phase 2 : connexion d’une boutique WooCommerce
Pour les marchands (vos clients)
Connectez-vous à Storefronts
Accédez à vos boutiques :
Cliquez sur l’onglet Stores dans la navigation à gauche
Cliquez sur l’icône WooCommerce pour commencer la connexion.
Saisissez l’URL de votre boutique WooCommerce
Cliquez sur « Continuer » pour autoriser la connexion :
Vous serez redirigé vers la page d'authentification de WooCommerce
Connectez-vous si cela vous est demandé
Vérifiez les autorisations demandées par Gelato
Cliquez sur Autoriser pour valider la connexion
Confirmer la connexion :
Après l'autorisation, vous serez redirigé vers le tableau de bord Storefronts Connect
Vérifiez que votre boutique apparaît dans la liste des boutiques connectées avec le statut « Connecté ».
Pour les PSP (vous)
Les étapes pour connecter une boutique WooCommerce en tant que PSP sont très similaires à la connexion d'une boutique en tant que client.
La différence principale est que vous serez également invité à sélectionner lesquelles de vos installations et lesquels de vos clients doivent être associés à la boutique WooCommerce.
Phase 3 : Mise en place des produits
Une fois que la boutique est connectée, vos produits dans GelatoConnect doivent être liés aux fiches produits sur la boutique WooCommerce. Il existe trois méthodes pour connecter les produits :
Méthode 1 : Connecter des produits WooCommerce existants
Si votre boutique propose déjà des produits à fabriquer via GelatoConnect :
Synchroniser les produits :
Dans le tableau de bord Storefronts Connect, cliquez sur la boutique WooCommerce connectée dans la liste des boutiques.
Cliquez sur le bouton Synchroniser les produits en haut à droite pour récupérer la liste actuelle des produits de la boutique.
Attendez que la synchronisation soit terminée
Associer des produits :
Après la synchronisation, tous les produits WooCommerce apparaîtront dans l’onglet Tous les produits
Pour chaque produit à fabriquer, cliquez sur le produit, puis sur le bouton Connecter.
Choisissez le produit que vous souhaitez connecter depuis le catalogue
Pour les produits nécessitant des fichiers de conception, vous serez redirigé vers le Design Editor où vous pourrez importer un fichier de conception.
Cliquez sur Connecter pour enregistrer l’association
Méthode 2 : Créer de nouveaux produits dans Storefronts Connect
Pour créer de nouveaux produits qui seront publiés sur la boutique WooCommerce :
Accédez à la boutique WooCommerce dans la liste des boutiques
Cliquez sur le bouton Ajouter un produit en haut à droite
Vous pouvez ajouter un tout nouveau produit couture fine ou en sélectionner un déjà présent dans une boutique existante.
Si vous ajoutez un nouveau produit de couture fine :
Sélectionnez un produit dans le catalogue des produits
Ajoutez un design avec le Design Editor
Configurez les détails du produit (nom, description, prix)
Ensuite, publiez le produit sur la boutique WooCommerce
Méthode 3 : Connexion de produits en masse
Pour les boutiques avec de nombreux produits, vous pouvez utiliser la fonctionnalité d'opération en masse :
Exporter la liste des produits :
Accédez à la page de la boutique dans Storefronts Connect et cliquez sur Opérations en masse en haut à droite
Sélectionnez Connecter les produits à l'aide de fichiers
Cliquez sur Exporter CSV et un fichier CSV contenant tous les produits de la boutique sera téléchargé.
Complétez le fichier CSV :
Ouvrez le fichier CSV dans un tableur
Pour chaque produit, ajoutez les éléments suivants dans les colonnes appropriées:
UID du produit : L’identifiant du produit GelatoConnect
URL du fichier de design : URL vers le fichier imprimable pour chaque produit. Cela doit être un lien direct vers le fichier
Importer les produits associés :
Retournez aux Vitrines et cliquez sur Opérations en masse
Saisissez votre adresse e-mail, cliquez sur Téléverser un fichier CSV, puis choisissez votre fichier CSV.
Cliquez sur Connecter des produits à l'aide de fichiers en haut à droite
Phase 4 : tester l’intégration
Avant de vous appuyer sur l'intégration pour les commandes de production, testez soigneusement la connexion :
Passez une commande test :
Allez sur le site web de la boutique WooCommerce
Achetez l’un des produits associés. Nous vous conseillons d’utiliser un code de réduction pour faire un essai.
Finalisez votre commande
Vérifier la réception de la commande :
Vérifiez que la commande apparaît dans Storefronts Connect
Vérifiez également qu'il apparaît dans la page de gestion des commandes de votre tableau de bord GelatoConnect.
Vérifiez que tous les détails de la commande sont corrects, y compris :
Informations client
Spécifications du produit
Fichiers de conception
Détails de livraison
Suivez la commande tout au long de la production :
Suivez la commande test tout au long de votre flux de production
Vérifiez que les mises à jour de statut s’affichent correctement dans Storefronts Connect et dans l’espace d’administration WooCommerce
Annulation de commande test (facultatif) :
Passez une nouvelle commande test
Annulez-le via WooCommerce
Vérifiez que l'annulation est correctement traitée dans GelatoConnect