Intégrer les lockers easybox Sameday au checkout Shopify : comment poser la carte

Vous voulez qu'au moment de payer, votre client ouvre une carte, trouve le locker easybox Sameday le plus proche et le choisisse en un clic. Sur WooCommerce, c'est presque trivial. Sur Shopify, c'est une autre histoire : la page de checkout est bien plus verrouillée, et si vous essayez simplement d'y injecter du code de carte, vous vous heurtez à un mur.

La bonne nouvelle, c'est que c'est faisable — mais cela dépend de votre forfait Shopify et, surtout, de l'endroit où vous placez la carte. Dans ce guide, je vous montre les trois options réelles, comment fonctionne vraiment la carte des lockers Sameday, et la partie que beaucoup oublient : comment faire pour que le locker choisi par le client arrive réellement sur le bon de transport. Sans promesse de « plug and play parfait ».

Pourquoi le checkout Shopify ne se comporte pas comme WooCommerce

C'est là le cœur du problème. L'ancien fichier checkout.liquid, dans lequel vous pouviez glisser n'importe quel code, a été retiré. Sur les forfaits Shopify standard, la page de checkout native est pratiquement blindée : vous ne pouvez pas y injecter librement du JavaScript ou une carte.

Le seul moyen d'y placer de vrais composants, ce sont les Checkout UI Extensions — et elles ne sont disponibles que sur Shopify Plus. Les pages Merci et Statut de la commande acceptent des extensions sur tous les forfaits, mais là il est déjà trop tard : le client a payé et ne choisit plus de mode de livraison.

La conclusion pratique : pour la plupart des boutiques qui ne sont pas sur Plus, la carte des lockers ne se trouve PAS dans la page de checkout native. Elle se trouve avant, ou via une application dédiée.

Les trois vrais endroits où placer la carte

Il existe trois approches qui fonctionnent réellement en production :

• Sur la page panier ou fiche produit (la plus utilisée) : un widget avec carte où le client choisit son easybox avant d'entrer dans le checkout. Fonctionne sur tous les forfaits Shopify.
• Dans la page de checkout, mais uniquement sur Shopify Plus : une Checkout UI Extension qui affiche un bouton « Choisir un easybox » et ouvre la carte dans une fenêtre.
• Via une application de l'App Store qui ajoute l'easybox comme point de retrait, en utilisant le mécanisme natif de points de retrait de Shopify.

Pour une boutique qui n'est pas sur Plus, la recommandation honnête est l'approche panier : le client choisit le locker, et vous bloquez l'accès au checkout tant que la sélection n'est pas faite. C'est l'option la plus robuste et la moins coûteuse à maintenir.

À quoi ressemble la carte Sameday et d'où viennent les lockers

Sameday propose à la fois un widget/plugin de lockers avec carte interactive et son API (la même que celle utilisée pour générer les bons de transport). Vous avez deux voies : utiliser leur widget prêt à l'emploi, ou construire votre propre carte.

Si vous partez sur du sur-mesure, les étapes sont :

• Authentification par jeton : récupérez vos identifiants d'API depuis votre compte transporteur et demandez un jeton.
• Récupérez la liste des lockers easybox depuis le point d'accès de géolocalisation. Chaque locker arrive avec un id, un nom, une adresse, une ville et des coordonnées.
• Placez les points sur une carte (Leaflet ou Google Maps) ou laissez le widget Sameday le faire.

Deux détails importants : assurez-vous de récupérer aussi les lockers next-gen (les nouveaux), et mettez la liste en cache — elle change rarement, inutile de la demander à chaque chargement de page.

La partie oubliée : amener le locker sur le bon de transport

La carte n'est que la moitié du travail. Si le locker choisi par votre client n'arrive jamais au transporteur, vous avez fait un joli widget inutile.

Le mécanisme sur Shopify :

• Quand le client choisit un locker, vous enregistrez son id, son nom et son adresse.
• Sur la page panier, vous les stockez comme attributs de panier via l'appel /cart/update.js (par exemple easybox_id, easybox_name), ou comme propriété de ligne.
• Ainsi ils apparaissent sur la commande et vous les voyez dans l'admin, pour chaque commande.
• À l'expédition, la génération du bon Sameday envoie le code du locker comme point de livraison, sur le service easybox.

Les connecteurs de transport pour la Roumanie — Innoship, EasySales, ShippyPro et d'autres — lisent cet attribut automatiquement et créent le bon. Sans cette étape, le locker choisi reste du simple texte sur la commande et ne dit rien au transporteur.

Application prête à l'emploi ou solution sur-mesure

Il n'y a pas de réponse unique — cela dépend de la boutique.

• Application de l'App Store : vous démarrez vite, payez un abonnement mensuel, mais avez moins de contrôle sur le design de la carte et vous dépendez d'un fournisseur.
• Solution sur-mesure (widget + API) : contrôle total, parfaitement intégrée à votre identité, mais elle demande du développement et de la maintenance (jetons, mises à jour d'API, synchronisation des lockers).

Pour beaucoup de boutiques, la combinaison gagnante est simple : une application de transport roumaine (Innoship ou EasySales) pour les bons, plus un widget de lockers sur la page panier. Méfiez-vous de toute promesse « ça s'installe en cinq minutes et ça marche parfaitement » — testez toujours avec de vraies commandes avant de lâcher vos clients dessus.

Chez MPO Web Studio, nous réalisons exactement ce type d'intégration, à distance, pour des boutiques dans tout le pays. Nous pouvons préparer une démo gratuite sur votre propre flux, pour que vous voyiez la carte fonctionner avant de décider quoi que ce soit. Un message WhatsApp et on organise ça.