Objectif : Cet article vous guidera sur le moyen de mettre en place les points relais avec une intégration à partir de l'API Sendcloud.
Qu'est ce qu'un point relais ?
Certains transporteurs proposent des méthodes d'expéditions avec livraison en points relais à proximité de l'adresse de livraison. Votre destinataire sera alors informé de la disponibilité de son colis, et il pourra le récupérer en fonction des horaires d'ouverture du point relais. Sendcloud propose via son API dédiée l'intégration de la carte des points relais disponibles, directement sur votre boutique en ligne.
Comment ça marche ?
Avec cet article vous serez en mesure d'ajouter une méthode de livraison en points relais afin d'offrir la meilleure expérience possible à vos clients.
Cet article s'adresse aux développeurs et/ou e-commerçants ayant intégrés leur site internet de vente en ligne grâce à l'API Sendcloud sans plugin supplémentaire de notre part, retrouvez la documentation ici.
Historique des versions :
Version: 1.0.0
Date: 2017-01-11
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js
Liens vers les sources appropriées :
SendCloud API Documentation
https://docs.sendcloud.sc/api/v2/index.html
Exemple d'intégration des Points Relais
https://sendcloud.github.io/spp-integration-example/
L'intégration des points relais : références
https://github.com/SendCloud/spp-integration-example/
Étape 1 : Activer les points relais dans votre intégration
Pour proposer les points relais via l'API Sendcloud, vous devez tout d'abord avoir effectué l'intégration de votre boutique, toute la documentation pour le faire à retrouver ici.
Une fois l'API Intégrée et fonctionnelle, rendez-vous sur votre interface Sendcloud dans vos Réglages / Boutiques connectées. Recherchez l'API Sendcloud et cliquez sur "Éditer".
Ensuite, cochez les points relais et les transporteurs que vous souhaitez proposer à vos clients sur votre boutique en ligne.
N'oubliez pas d'enregistrer vos modifications.
Étape 2 : Paramétrer l'intégration pour les points relais
- Copiez le code 'Embed JavaScript' fourni dans vos paramètres d'intégration
- Collez le code sur votre page dédiée au checkout
- Vous trouverez ici plus d'informations sur ce point
Étape 3 : Guide étape par étape
Voici un guide étape par étape pour mieux vous aider à intégrer votre code JavaScript à votre backend de site :
- Vous devez appeler sendcloud.servicePoints.open et fournir avec un 'config object', un 'success callback' et un 'failure callback' (voir exemple)
- une fois votre Point Relais sélectionné, notre bibliothèque connectera votre fera appel à votre fonction et l'associera à un Objet Point Relais. L'information majeure que vous recherchez est le "Service Point ID" ainsi que l'ensemble des propriétés reliées aux adresses comprises dans celles-ci. Vous devez garder une trace de cet ID car ce dernier sera utilisé lors de la création d'un nouvel envoi dans votre API.
- Une fois l'envoi créé dans votre API, vous devez vous assurez que l'ensemble des informations concernant les adresses est renseigné dans les champs requis et rempli avec la mention suivante : "to_service_point" parametré avec le "Service Point ID".
Une fois l'ensemble des étapes ci-dessus réalisées, vous devriez être en mesure d'avoir une API qui fonctionne correctement.
Bonne intégration.