Manuel d'installation du module So Colissimo pour Magento

version 1.0.2

Ralisation par

Manuel d'installation du module So Colissimo pour Magento

Objectif
Ce document explique comment installer et utiliser le module So Colissimo de La Poste sur votre site Magento.

Compatibilit et pr-requis
Ce module a t test et valid sur les versions suivantes de Magento : CE 1.4.1.1 ; PE 1.8 ; EE 1.8 ; EE 1.9. Ce module ncessite au pralable une souscription l'offre So Colissimo La Poste ColiPoste. Pour louverture de votre compte So Colissimo, veuillez contacter votre interlocuteur commercial La Poste habituel ou le 3634. Le Back Office ColiPoste doit avoir t paramtr (voir documentation Paramtrage dans le Back Office ColiPoste ) en indiquant notamment les urls de retours suivant : Url de validation : http://www.siteecommerce.fr/socolissimosimplicite/form/failure/ Url d'chec : http://www.siteecommerce.fr/socolissimosimplicite/form/success/ (www.siteecommerce.fr tant l'url de base de Magento) Ce module n'est actuellement pas compatible avec l'option multi-shipping .

Installation et configuration
1. Installer le module depuis MagentoConnect (http://www.magentocommerce.com/magentoconnect) ou copier directement les fichiers de l'archive dans le rpertoire de votre Magento. 2. Vider le cache Magento 3. Se connecter au Back Office de Magento et aller dans Systme > Configuration.

v1.0.2

Page 2/8

24/09/2010

Manuel d'installation du module So Colissimo pour Magento

4. Aller dans l'onglet Ventes > Modes de livraison :

Un nouveau mode de livraison est affich : So Colissimo . (Si ce n'est pas le cas, vider les caches, se dconnecter du Back Office puis se reconnecter.) 5. Cliquer sur l'onglet pour le drouler :

v1.0.2

Page 3/8

24/09/2010

Manuel d'installation du module So Colissimo pour Magento

6. Configurer les diffrents champs : v1.0.2 Page 4/8 24/09/2010

Manuel d'installation du module So Colissimo pour Magento Activ Activer / dsactiver le mode de livraison So Colissimo. Doit tre oui pour que le mode de livraison So Colissimo soit propos. Nom du transporteur tel que prsent au client Nom du mode de livraison tel que prsent au client Message informatif apparaissant lorsque le client slectionne ce mode de livraison

Nom du transporteur Nom du mode de livraison Message lors de la slection du mode de livraison

Message lors de la redirection vers So Colissimo Message affich lors de la redirection automatique vers la page So Colissimo Identifiant FO Identifiant FO renseign dans votre Back Office ColiPoste aprs souscription au service So Colissimo Format : 14 caractres numriques Cl de cryptage renseigne dans votre Back Office ColiPoste aprs souscription au service So Colissimo Format : 12 caractres numriques Url du service So Colissimo : http://ws.colissimo.fr/pudo-fo/storeCall.do ou https://ws.colissimo.fr/pudo-fo/storeCall.do Indiquer la mthode de calcul des frais de livraison : - tarif unique - tarif selon poids Si le champ Type des frais de livraison est valoris tarif unique : saisir un montant TTC sans devise ex : 5 Si le champ Type des frais de livraison est valoris tarif selon poids : saisir pour chaque palier de poids un montant TTC sans devise suivant le format {"poids en kg":"tarif1","poids en kg":"tarif2",...} ex : {"0":"2.90","0.5":"4.50","5":"8","10":"14"} Le tarif est appliqu pour un poids suprieur ou gal au poids correspondant. Dans l'exemple : 2.90 euros pour un poids infrieur 0,5 kg, 4,50 euro pour un poids infrieur 5 kg, 8 euros pour un poids infrieur 10 kg, 14 euros au del. Livraison offerte partir de (en ) v1.0.2 Indiquer le montant TTC partir duquel vous Page 5/8 24/09/2010

Cl de cryptage

URL de passerelle

Type des frais de livraison

Calcul des frais de livraison

Manuel d'installation du module So Colissimo pour Magento offrez les frais de livraison ex : 200 (Laisser vide pour ne pas offrir les frais de livraison) Activer la vrification de la disponibilit de la plateforme So Colissimo Oui : une vrification de la disponibilit de la plateforme So Colissimo sera effectue avant de diriger l'internaute (Recommand) Non : aucune vrification Url permettant de vrifier si la plateforme So Colissimo est oprationnelle. Ex : http://ws.colissimo.fr/supervisionpudo/supervision.jsp Message affich dans le cas o la plateforme So Colissimo est indisponible (doit indiquer que mode de livraison domicile est slectionn par dfaut)

Adresse de vrification

Message en cas d'indisponibilit de la plateforme

7. Aprs modification, sauvegarde les informations en cliquant sur Sauvegarder la configuration 8. Aller sur le front-office et passer une commande pour vrifier le rsultat. 1. A l'tape du choix du mode de livraison, le mode So Colissimo doit tre propos.

2. Slectionner le mode et cliquer sur poursuivre . Le navigateur doit rediriger vers la page So Colissimo du choix du mode de livraison.

v1.0.2

Page 6/8

24/09/2010

Manuel d'installation du module So Colissimo pour Magento

3. Slectionner un mode de livraison, cliquer sur valider. Le navigateur doit rediriger vers la prochaine tape du tunnel de commande : le mode de paiement. 4. La commande doit ensuite se terminer normalement.

Instruction supplmentaire pour la version Enterprise de Magento

Par dfaut, le module installe les layouts et template dans le package default . Pour la version Enterprise de Magento, il faut dplacer les lments suivants : 1. le fichier /app/design/frontend/default/default/layout/socolissimosimplicite.xml dans /app/design/frontend/enterprise/default/layout/socolissimosimplicite.xml 2. le dossier /app/design/frontend/default/default/template/socolissimosimplicite/ dans /app/design/frontend/enterprise/default/template/socolissimosimplicite/

Instruction supplmentaire pour la version Professional de Magento

Par dfaut, le module installe les layouts et template dans le package default . Pour la version Professionnal de Magento, il faut dplacer les lments suivants : 3. le fichier /app/design/frontend/default/default/layout/socolissimosimplicite.xml dans /app/design/frontend/pro/default/layout/socolissimosimplicite.xml 4. le dossier /app/design/frontend/default/default/template/socolissimosimplicite/ dans v1.0.2 Page 7/8 24/09/2010

Manuel d'installation du module So Colissimo pour Magento /app/design/frontend/pro/default/template/socolissimosimplicite/

Remarques
1. Les poids des produits doivent tre renseigns en kilogramme dans les fiches produits du Back Office Magento afin que la rgle de calcul des frais de livraison selon le poids soit correcte. 2. Si la saisie d'une civilit est demande au client lors de la cration d'une adresse, il est possible de faire correspondre les libells des civilits de Magento avec ceux de la plateforme So Colissimo afin d'viter au client de devoir la slectionner une nouvelle fois. Le mappage se fait dans le fichier config.xml du module (champ mapprefix ).

v1.0.2

Page 8/8

24/09/2010