Mode de livraison en point relais - GLS

Bonjour,

D'après ce que je peux voir en ligne ( gls-group.com/HR/en/ecommerce-integration/ ) GLS propose "MyGLS API", une API qui permet, entre autre, de récupérer les informations des points relais près d'une adresse.
Cette API nécessite le développement d'un plugin, similaire aux plugins Colissimo et Mondial Relay sur notre marketplace, car le plugin doit faire l'affichage des points relais sur une carte, avec une intégration avec Open Street Map, etc.

GLS propose également un "GLS Map widget". Avec ce widget, il suffit de quelques lignes de code javascript pour rajouter le widget dans le passage en caisse d'HikaShop.
Ce que je recommande c'est de faire ainsi:
- Créez un champ personnalisé de la table "commande" via Display>Custom fields, pour stocker l'information du point relai dans la commande et gérer son affichage.
- Configurer votre flux de passage en caisse dans la configuration HikaShop pour avoir les vues "address", "shipping" et "fields" sur la même étape du passage en caisse.
- Créez une méthode de livraison avec le plugin "manual shipping" et activez l'option "override shipping address" de la méthode de livraison en mode "HTML". Dans cet HTML, vous pouvez mettre le code Javascript que propose GLS pour son widget. Il faudra l'adapter un peu pour mettre l'id de votre champ personnalisé afin que le nom du point relai ( et / ou d'autres informations sur le point relai) sélectionné par l'utilisateur apparaisse dans le champ suite à la sélection.
- Une fois que cela fonctionnera, vous pourrez potentiellement rajouter un peu de CSS pour cacher la zone du champ personnalisé histoire d'avoir quelque chose de propre.

L'avantage du widget, c'est que c'est faisable assez facilement avec quasiment aucune connaissance en code si vous suive les instructions plus haut et les instructions de GLS.
L'avantage du plugin, c'est que vous pouvez faire d'autres choses, pas juste la sélection du point relai. Vous pouvez générer les étiquettes, rajouter l'information de tracking à la commande, etc. Mais cela demande un investissement important car il y en a pour plusieurs jours de développement pour un développeur chevronné.

Dans ce cas, il ne reste que le développement d'un plugin pour l'API.
Pourriez-vous confirmer avec GLS ce qu'ils proposent comme intégration à la place du widget, et récupérer un accès ?
Nous pourrons ensuite discuter de la suite via le formulaire de contact si vous le souhaitez.
www.hikashop.com/support/contact-us.html

Bonjour,

Nous avons travaillé sur un plugin pour GLS. Nous venons de le publier:
www.hikashop.com/marketplace/product/299-gls.html

Il n'utilise pas la documentation que vous fournissez. Cette documentation vient de GLS Hongrie. Je ne pense pas que cela soit une bonne idée.
Le plugin que nous avons développé utilise GLS OOH Location Finder API qui est l'API globale de GLS (et la plus récente) pour les points relais.
Le plugin fourni une carte interactive sans le widget qui avait été proposé initialement qui est une solution plus bancale.

Bonjour,

Le plugin utilise deux APIs GLS, selon l'usage :

- Pour la liste des points relais (la carte) : par défaut l'API OOH Location Finder, sur l'endpoint « by address » qui renvoie plusieurs points relais autour d'une adresse (parcel-shop-management v2, available-out-of-home-locations-by-address). Une option « API points relais » dans le module permet de basculer cette recherche sur l'API ShipIT-Farm (endpoint /rs/parcelshop/address) si vous disposez d'un accès ShipIT-Farm.

- Pour la génération des étiquettes : c'est l'API ShipIT-Farm (v1) qui est utilisée. Le module crée l'expédition (/rs/shipments) et récupère l'étiquette au format PDF, avec le suivi et l'annulation depuis la commande.

Donc pour répondre précisément à votre question :
- Si vous voulez seulement afficher les points relais : l'API OOH Location Finder (by address) suffit, c'est le mode par défaut.
- Si vous voulez aussi générer les étiquettes : il faut un accès à l'API ShipIT-Farm. ShipIT-Farm fait les deux (recherche des points relais ET étiquettes) ; l'API OOH Location Finder ne fournit que la liste des points relais, pas les étiquettes.

Bonjour,

Quelques précisions sur le comportement que vous observez.

Le module utilise exactement le même schéma d'hôte pour les trois appels GLS : OAuth, OOH Location Finder et ShipIT-Farm. En sandbox il appelle api-sandbox.gls-group.net pour tout, et en production il bascule sur api.gls-group.net pour tout, simplement en remplaçant le préfixe. Si l'OAuth et ShipIT-Farm fonctionnent en production chez vous, c'est que cette bascule d'hôte atteint bien GLS. Le fait que seul OOH échoue en production n'est donc pas un problème d'URL côté module.

L'explication est en fait du côté de GLS : pour l'API OOH Location Finder, l'accès à l'environnement de production n'est pas activé automatiquement quand vous créez votre application sur le portail, contrairement aux autres API. GLS demande de leur en faire la demande explicite par email à International Product Management (This email address is being protected from spambots. You need JavaScript enabled to view it.). Tant que cette demande n'a pas été traitée, l'appel OAuth réussit (l'authentification ne dépend pas de l'API), mais l'appel OOH en production renvoie un 401 ou 403, ce qui correspond au comportement que vous observez. Le module enregistre déjà le code HTTP et le corps de la réponse en cas d'échec OOH, donc si vous nous transmettez les lignes "GLS API" du fichier Payment log file de la page de configuration d'HikaShop obtenues pendant un test en production, on pourra confirmer que c'est bien ce cas.

Deux chemins possibles à partir de là :

1. Si vous tenez à utiliser OOH en production, faites la demande d'activation à GLS à l'adresse ci-dessus, en précisant votre identifiant d'application de production. Une fois l'accès accordé côté GLS, le module fonctionnera tel quel, sans modification de configuration.

2. La recommandation de GLS de privilégier ShipIT-Farm est cohérente et le module la couvre déjà sans modification : dans la configuration de votre méthode de livraison en point relais, le paramètre "API points relais" permet de basculer la recherche de points relais de OOH vers ShipIT-Farm. ShipIT-Farm fait alors les deux opérations (recherche des points relais et génération des étiquettes), avec des identifiants de points relais cohérents entre les deux étapes. Côté client, l'expérience de sélection sur la carte est identique. Il me semble que l'accès à ShipIT-Farm demandera aussi une discussion avec GLS.

Bonjour,

Tout se passe directement dans HikaShop, vous n'avez pas besoin d'aller sur votre accès web GLS pour imprimer l'étiquette.

Une précision d'abord sur le Contact ID : c'est l'identifiant de l'expéditeur, c'est à dire votre compte GLS, pas celui du client final. Il est envoyé dans le champ Shipper.ContactID de la demande d'expédition.

Le déroulé concret est le suivant :

1. Sur la fiche de la commande dans le back office HikaShop, un bouton "Créer l'expédition" apparaît. Quand vous cliquez dessus, HikaShop construit la demande et l'envoie à l'API ShipIT-Farm (endpoint /rs/shipments).

2. Dans cette demande, HikaShop transmet l'adresse du destinataire (le client, reprise depuis la commande), le poids, le point relais sélectionné le cas échéant, et votre Contact ID comme expéditeur.

3. GLS crée l'expédition et renvoie dans la même réponse le numéro de suivi (TrackID), le numéro de colis, et surtout l'étiquette au format PDF. HikaShop enregistre tout cela sur la commande.

4. Un bouton "Télécharger l'étiquette" apparaît alors sur la commande. Il vous sert le PDF directement depuis HikaShop, prêt à imprimer. Le suivi et l'annulation de l'expédition se font également depuis la commande.

Donc en résumé : c'est HikaShop qui génère l'étiquette via l'API et vous la met à disposition en PDF sur la commande. Vous n'avez pas à aller la chercher sur le site GLS, et le client final n'a rien à imprimer de son côté.