Colisweb Docs

plugins Prestashop & Magento

Pré-requis

  • Une boutique en ligne tournant sous Magento 1.4.2 minimum
  • Avoir récupéré le plugin auprès de colisweb (support@colisweb.com)

Installation

L'arborescence du plugin respecte celle de Magento.
Il suffit donc de copier les dossiers “app” et “skin” du plugin Colisweb dans le répertoire de Magento sur votre serveur.

Allez maintenant dans l’interface d’administration de votre magasin, dans l’onglet :

System > Configuration > Advanced > Advanced 


Vous devriez maintenant voir le module Colisweb_ShippingService présent dans la liste des modules installés.



Si ce n’est pas le cas, veuillez vous déconnecter (Log out) de l’interface administrateur puis vous y reconnecter.
Si ce n’est toujours pas le cas, n’hésitez pas à nous contacter.

Paramétrages


Attributs produits : package dimension


Le service Colisweb a besoin de connaître les dimensions des produits emballés afin de choisir le moyen de transport le plus adapté.
Le paramétrage des dimensions Colisweb s’effectue dans l’onglet :

System > Configuration > Shipping Method > Colisweb
Il existe 2 options de paramétrage :

1. Les dimensions par articles sont déjà renseignées dans votre boutique Magento

Dans ce cas, il vous suffit de :
1) Mettre la valeur “Yes” dans le champ “Attribut dimension packagé éclaté en 3”

2) Renseigner les noms des attributs (“attribute code”) correspondant à la Longueur / Profondeur / Hauteur des produits de votre magasin dans les champs correspondants. (Voir screenshot ci-dessous)



3) Sauvegarder.

2. Les dimensions par article n’existent pas dans votre boutique Magento.

Dans ce cas, il vous faut donc ajouter un attribut “dimension packagé” au catalogue produit.

Normalement, à l’installation du plugin Colisweb, cet attribut a été créé pour vous. Il s’appelle “dimension_pkg” et il est déjà configuré dans les options du plugin Colisweb.

Pour vérifier que cet attribut a bien été créé, rendez vous dans l’onglet :

Catalog > Attributes > Manage Attributes

Si cet attribut n’a pas été créé par l’installation de Colisweb, il vous faut la créer manuellement.
Voici une vidéo officielle de Magento sur youtubequi présente la manière de créer et de gérer les attributs sous Magento.

Pour utiliser cet attribut dans le plugin Colisweb, rendez-vous dans l’onglet :
System > Configuration > shipping Method > Colisweb
Puis :
1) Mettre la valeur “No” dans le champ “Attribut dimension packagé éclaté en 3”
2) Si ce n’est pas déjà le cas, dans le champ “Code de l'attribut dimension packagé”, mettre “dimension_pkg”. (Voir screenshot ci-dessous)
3) Sauvegarder.



Remarques par rapport à l’attribut “dimension_pkg” :
  • La valeur de cet attribut doit être définis de la façon suivante : profondeur*hauteur*longueur (en centimètre)
    Attention, le séparateur entre chaque dimension doit être le signe multiplication (*).
    (Exemple de configuration d’une valeur par défaut pour cet attribut disponible dans le screenshot ci-dessous.)

  • Il est conseillé de rendre cet attribut obligatoire lors de la création d’un nouveau produit :
    Dans la configuration de l’attribut, mettre la valeur “Values Required” à “Yes”. (Voir screenshot ci-dessous)



Gestion du prix du service


Le paramétrage du prix du service Colisweb affiché dans le tunnel d’achat s’effectue dans l’onglet :

System > Configuration > Shipping Method > Colisweb
via les champs “Seuil minimum du panier avant offre sur la livraison” et “Offre tarifaire passé ce seuil”.

La valeur du champ “Seuil minimum du panier avant offre sur la livraison” déterminera à partir de quel prix, en euro, la valeur du champ “Offre tarifaire passé ce seuil” sera utilisée comme prix pour la livraison Colisweb.

Par exemple, si dans le champ “Seuil minimum du panier avant offre sur la livraison”, vous mettez la valeur “0” et dans le “Offre tarifaire passé ce seuil”, la valeur “10”. Alors vous facturerez toutes les livraisons Colisweb au prix de 10 euro à vos clients.

Second exemple, si dans le premier champ, vous mettez la valeur “80” et dans le second, la valeur “5”. Alors toutes les livraisons Colisweb dont le prix du panier est supérieur ou égal à 80€ seront proposées à vos clients au prix de 5 euro.

Ainsi, vous pouvez paramétrer le tarif du service Colisweb à partir d’un certain montant du panier



Dimensions et poids maximums


Vous pouvez configurer les dimensions maximales et le poids maximum que Colisweb accepte de livrer dans l’onglet :

System > Configuration > Shipping Method > Colisweb
Via les champs “Profondeur maximum du packet”, “Hauteur maximum du packet”, “Longeur maximum du packet” et “Poids maximum du packet”.

Ces dimensions et poids maximums vous aurons normalement été transmises en même temps que le plugin.
Vous devrez obligatoirement les configurer au moins une première fois avant de lancer le service Colisweb sur votre magasin.

Si vous ne le faites pas, vos clients ne seront pas correctement informés de la disponibilité du service Colisweb sur les produits qu’ils achètent.

Si ces données ne vous ont pas été transmises, n’hésitez pas à nous les demander.
En attendant, vous pouvez mettre les valeurs suivantes par défaut :
  • Profondeur maximum du packet : 100
  • Hauteur maximum du packet : 100
  • Longeur maximum du packet : 150
  • Poids maximum du packet : 30



Activer / Désactiver le service Colisweb


Vous pouvez activer / désactiver le service Colisweb sur votre magasin à tout moment.

Pour cela, dans l’onglet :

System > Configuration > Shipping Method > Colisweb
Modifiez la valeur du champ “Enabled”.

De plus, un attribut nommé “cw_delivrable” a été créé dans votre Magento à l’installation du plugin.
Celui-ci permet une gestion plus fine de l’activation ou de la désactivation du service Colisweb pour votre magasin et plus particulièrement pour vos produits.

Le plus simple est que, par défaut, cet attribut ait la valeur “Yes”.
Ainsi, tous les produits de votre magasin seront éligibles à l’offre Colisweb. Et ainsi, si vous souhaitez que certains produits ne soient pas livrables par Colisweb, alors dans les configurations spécifiques de ces produits, il vous faudra mettre le champs “Activate shipping with Colisweb” à la valeur “No”.

Également, nous pouvons très bien imaginé la situation inverse où vous souhaitez que, uniquement certains produits soient livrables par Colisweb. Ainsi, la valeur par défaut de cet attribut devra être “No”. Puis spécifiquement pour chaque produit que vous souhaitez voir livrable par Colisweb, vous devrez mettre la valeur “Yes” dans le champs “Activate shipping with Colisweb”.


Fonctionnalités


Géolocalisation


Pour connaître la localisation de l’internaute lorsque celui-ci n’est pas logué, le plugin géolocalise l’internaute soit par HTML5 (si vous l’avez activé), soit à partir de son adresse IP

Pour activer la géolocalisation HTML5, rendez-vous dans l’onglet :

System > Configuration > Colisweb
puis, mettez la valeur du champ “Enable HTML5 geolocalisation” à “Yes”.
Sauvegardez

Dans le cas de l’activation de la géolocalisation HTML5, il est préférable de modifier la balise doctype de votre template par : <!DOCTYPE html>

Le plugin utilise :
  • Google API loader, qui permet de récupérer la localisation d’un client à partir de son adresse IP. Cette API ne nécessite plus de clé.
  • Afin de récupérer l’adresse complète du client, le plugin interroge également l’API Google Maps (geocoding).
    Remarque : Celle-ci est gratuite dans la limite de 25 000 requêtes / jour.


Choix livraison dans le processus de commande


Dans le tunnel d’achat, le choix de la méthode de livraison Colisweb est affiché en fonction de l’adresse de livraison saisie par l’internaute et des produits présents dans la commande.

Les produits de la commande doivent tous être en stock et ne doivent pas être en dessous du quota minimal paramétré. Ces informations seront souvent pluggées à votre ERP de gestion des stocks (dans le cas d’un modèle multi-boutiques), ou directement connectées à une solution de Click&Collect existante.

Suite à l’appel de l’API Colisweb, la méthode de livraison sous 2 heures et / ou sur rendez-vous s’affiche. (Voir screenshot ci-dessous)



Dans le cas de l’offre flexible seulement, le client choisira la date et le créneau horaire de livraison.
L’offre instantané ne nécessite aucune saisie supplémentaire pour le client.

Lors de la validation de la commande (paiement), toutes les informations nécessaires pour la livraison Colisweb sont transmises à l’API via webservices REST sécurisés.

Pour plus d’informations sur les échanges webservices entre le plugin et l’API Colisweb, vous pouvez consulter notre documentation technique d’API : http://docs.colisweb.apiary.io/#ecommercecheckoutflow