Les options de livraisons
Contexte
Les options de livraisons sont des services de livraison que le client peut choisir lors de la création de son annonce (manutention...). Elles sont facultatives et ne sont pas obligatoires pour créer une annonce. Également elles peuvent être payantes ou gratuites.
Leur utilisation est facultative mais fortement recommandée car nous pensons que cela représente un réel avantage pour vos clients.
Voici quelques exemples d'options de livraisons :
- Manutention
- ... (d'autres à venir)
Mise en place
Lors du choix de livraison cocolis sur votre site, vous devez lister les options disponibles que renvoient le can_match. Une fois cela fait, l'utilisateur peut sélectionner parmi ces options et vous devez alors les sauvegarder quelque part (généralement sur le panier) afin de nous les envoyer lors de la création de l'annonce.
C'est à vous que revient le développement de la logique de sauvegarde des options de livraisons afin de les envoyer lors de la création de l'annonce concernée
Principes
Lors de l'appel du can_match nous allons renvoyer les options disponibles pour votre annonce sous la forme :
Format :
"available_options": {
"catégorie": {
"title": "Titre de la catégorie",
"description": "Description de la catégorie
"options": [
{
"option_id": 1,
"label": "Label de l'option gratuite par défaut",
"price": 0.0,
"is_default": true,
"description": "La description de l'option gratuite"
},
{
"option_id": 2,
"label": "Label de l'option payante",
"price": 2900.0,
"is_default": false,
"description": "La description de l'option payante"
}
]
}
}
Exemple :
"available_options": {
"handling": {
"title": "",
"description": "",
"options": [
{
"option_id": 1,
"label": "Au pied du véhicule",
"price": 0.0,
"is_default": false,
"description": "Aucune aide du transporteur pour porter le bien."
},
{
"option_id": 2,
"label": "Dans la pièce de mon choix - avec 1 personne",
"price": 2900.0,
"is_default": false,
"description": "Une personne est nécessaire pour porter le bien dans la pièce de votre choix"
},
{
"option_id": 3,
"label": "Dans la pièce de mon choix - avec 2 personnes",
"price": 5900.0,
"is_default": false,
"description": "Deux personnes sont nécessaires pour porter le bien dans la pièce de votre choix."
}
]
}
}
Le prix de l'annonce sera automatiquement majoré du prix des options choisies par le client. La valeur du champ price lors de la création d'une annonce ne comprend donc seulement que la partie transport, dans la majorité des cas, c'est le prix renvoyé par l'appel au can_match
Affichage et prise en compte des options
La structure des données qui vous sont renvoyées a été pensée pour afficher les options par groupe de radio boutons.
La sélection des options coté front ne seront prises en compte seulement si vous les renvoyez au moment de la création de l'annonce. Il faut donc les sauvegarder sur le panier/commande pour les renvoyer ultérieurement.
Un exemple basique d'intégration : 