Modules ICI relais & EXAPAQ Predict v4.0

Documentation technique Modules ICI relais & EXAPAQ Predict v4.0 Magento 1.4 1.8

Sommaire Sommaire 1. Introduction... 3 2. Installation des modules... 4 3. Configuration des modules... 5 3.1. Gestion des frais de port... 6 4. Utilisation en front-office... 7 4.1. ICI relais par EXAPAQ... 7 4.2. Predict par EXAPAQ... 8 5. Utilisation en back-office... 9 5.1 Export des commandes... 9 5.2 Suivi des commandes... 10 6. Désinstallation des modules... 11 7. Dépannage... 11 2

Introduction 1. Introduction Ce document explique comment installer, configurer et utiliser les modules «ICI relais» et «EXAPAQ Predict» sur votre site e-commerce basé sur Magento. Compatibilité et pré requis : Magento version 1.4.x à 1.8.x. L extension PHP SOAP pour pouvoir se connecter au web service Exapaq de récupération des points ICI relais. Une station d étiquetage EXA-Print ou ICI-Print paramétrée auprès d IMTECH (Tél : 03.88.79.79.50) Un répertoire créé à votre convenance sur le poste afin de réceptionner les fichiers d export de commandes. Ce pack contient 2 modules : Exapaq_Relaypoint : un module de transport proposant la livraison en espace ICI relais en front-office, ainsi qu un espace de gestion des commandes afin d automatiser l édition des étiquettes transport ICI relais, l envoi des mails aux destinataires de messages contenant un lien permettant la traçabilité de leur colis en ligne, et la mise à jour en masse des statuts des commandes traitées. Exapaq_Predict : un module de transport proposant la livraison Predict en front-office, expliquant son déroulement et demandant aux destinataires de saisir leur n de téléphone portable afin de recevoir les SMS relatifs à leur livraison. De la même manière qu ICI relais, un espace de gestion des commandes est disponible. 3

Installation des modules 2. Installation des modules Vous pouvez installer ces modules directement par le back-office, par l onglet Système > Magento Connect > Magento Connect Manager. 1 2 1. Rendez-vous à la section «Direct package file upload», cliquez sur «Choisissez un fichier» et parcourez vos répertoires pour indiquer les packages «Exapaq_Relaypoint» et «Exapaq_Predict» au format.tgz. 2. Cliquez sur «Upload». Magento installe le module et vous informe de la réussite de l'installation, ou d'éventuelles erreurs (fichiers déjà présents, extension PHP_SOAP manquante). 3. Vous devez à présent procéder à la configuration des modules. Retournez dans le back-office et rendez-vous maintenant dans le menu Système -> Configuration. 4. Dans le menu de gauche «Ventes», choisissez «Modes de livraison». 4

Configuration des modules 3. Configuration des modules Deux nouveaux modes de livraison apparaissent alors dans la liste des modes de livraison installés sur votre plateforme Magento : «ICI relais par EXAPAQ» et «Predict par EXAPAQ». Cliquez sur l onglet pour le dérouler et accéder à la configuration du module : La plupart des champs sont pré-remplis, à titre d information voici la configuration par défaut du module : Activé Titre Sous-titre Activer/désactiver le transporteur Titre du transporteur affiché en front-office Sous-titre du transporteur affiché en front-office URL MyPudo (ICI relais uniquement) URL du webservice ICI relais, par défaut : http://mypudo.pickup-services.com/mypudo/mypudo.asmx?wsdl ID Marchand (ICI relais uniquement) Clé de sécurité (ICI relais uniquement) EXA deecd7bc81b71fcc0e292b53e826c48f Votre n d agence EXAPAQ Le code agence de rattachement (ex : 013) Votre n de contrat N de contrat expéditeur ICI relais ou EXAPAQ Predict (ex : 12345) N'hésitez pas à contacter votre interlocuteur commercial EXAPAQ pour obtenir ces données Gestion des frais de port Ordre de tri Cf. section 3.1 ci-après Permet d'ordonner la liste de transporteurs en front-office par ordre croissant Sauvegardez la configuration en utilisant le bouton situé en haut à droite. 5

Configuration des modules 3.1. Gestion des frais de port Notre module base sa méthode de calcul des frais de port sur le module Owebia Shipping 2.2.8. Voici un descriptif rapide des principales fonctions disponibles pour créer votre grille de frais de port : «label» est l intitulé de la règle de calcul. Ceci apparaitra en front-office accolé au titre du transporteur «code» est le code unique de cette règle de calcul. Ceci permet d identifier les commandes par leur règle de calcul. Facultatif, mais s'il est spécifié il doit être unique. «destination» contient les codes ISO des pays à traiter. Pour exclure un département, la syntaxe est : «CodeISO-(Dpt1, Dpt2)» «conditions» : conditions d'activation pour lesquelles le tarif sera appliqué. Par exemple : "{cart.weight}<=20.0" pour appliquer un tarif jusqu'à 20 kg "{cart.price_including_tax}>=89.00" pour appliquer un franco de port à partir de 89 TTC. "{cart.price_excluding_tax}>=100.00" pour appliquer un franco de port à partir de 100 HT. "{count products where product.attribute.objet_largeur>100}<1" pour exclure le transporteur si le panier contient un produit avec l attribut «objet_largeur» supérieur à 100. "'{cart.coupon}'=='promo1234'" pour appliquer une règle si le coupon promotionnel «PROMO1324» est saisi «fees» permet de définir les tarifs appliqués au client. Par exemple : 0.00 = frais de port offerts 5.95 = frais de port à 5.95 fixes "{table {cart.weight} in 0.5:5.30,1.0:6.50}" = frais de port en fonction du poids: jusqu à 500g: 5.30, 1kg: 6.50. Exemples de configurations : # Franco de port à 89 { label: "Livraison offerte!", destination: "FR-(2A,2B)", conditions: "{cart.price_including_tax}>=89", fees: 0.00,} # Frais de port en fonction du poids { label: "France métropolitaine", destination: "FR-(2A,2B)", fees: "{table {cart.weight} in 0.5:5.30,1.0:6.50,2.0:7.40,3.0:8.30,5.0:10.10,10.0:12.50,20.0:15.00}", } # Frais de port en fonction du poids en Corse { label: "Livraison en Corse", destination: "FR(2A,2B)", fees: "{table {cart.weight} in 0.5:18.30,1.0:19.50,2.0:20.40,3.0:21.30,5.0:23.10,10.0:25.50,20.0:28.00}",} 6

Utilisation en front-office 4. Utilisation en front-office Note : Il est impératif de tester les modules au sein d une commande avant de passer en production. Connectez-vous à votre boutique en ligne Magento. Lors du passage de commande, les transporteurs «ICI relais par EXAPAQ» et «Predict par EXAPAQ» seront disponibles. Ces transporteurs affichent des informations supplémentaires lors de leur sélection. 4.1. ICI relais par EXAPAQ Sélectionner ICI relais fait apparaître un formulaire de saisie d une adresse, pré-rempli avec l adresse de livraison préalablement saisie à l'étape 2. Un clic sur le bouton «OK» lance la recherche des points relais autour de l adresse saisie. La liste des 5 espaces ICI relais les plus proches s'affiche dessous, avec leur notion de distance et la possibilité d'accéder aux détails. Un bouton permet de sélectionner l'espace ICI relais de destination. Un clic sur «Plus de détails» ouvre une popin présentant les détails du point relais (carte de géolocalisation, coordonnées, repères, distance en kilomètres, Code du point, horaires d ouverture ) 7

Utilisation en front-office Après sélection d un espace ICI relais et validation de l étape 3, l adresse de l espace ICI relais remplace l adresse de livraison initialement saisie. La commande se déroule ensuite normalement. 4.2. Predict par EXAPAQ A la sélection de ce transporteur, un bloc de présentation du service Predict par EXAPAQ sera affiché dessous. Ce bloc a pour objectif de présenter le service aux destinataires, et leur demander de saisir leur n de téléphone portable. Une vidéo de présentation du service est également disponible en cliquant sur l icone prévue. Une fonction vérifie le n de téléphone saisi et informe l internaute d une erreur avant de passer à l étape suivante. 8

Utilisation en back-office 5. Utilisation en back-office 5.1 Export des commandes Cette partie décrit le fonctionnement de l export des commandes vers la station d étiquetage (EXA-Print ou ICI- Print) afin d automatiser l édition des étiquettes transport. Accédez à l onglet «Ventes» puis le sous-onglet correspondant au transporteur «ICI relais» ou «EXAPAQ Predict» afin de visualiser vos commandes en cours (hors statuts Livré, Annulé). Un bandeau «News» vous permet d'obtenir les actualités d EXAPAQ via un flux RSS. Sélection Action s Les informations de commande, destination, poids, montant, statut sont visibles et filtrables. 1. Sélectionnez les commandes à traiter avec la case de gauche 2. Choisissez l'action à mener par le menu déroulant à droite du tableau : Exporter vers EXA-Print - Assurance intégrée Exporter vers EXA-Print - Assurance Ad Valorem Permettent de générer un fichier d interface au format EXA-Print. Ce fichier est lisible par le logiciel EXA-Print (ou ICI-Print) configuré en mode auto ou semi-auto auprès d IMTECH (Tél : 03.88.79.79.50). L assurance intégrée vous indemnisera à hauteur de 23 / kg transporté, alors que l assurance Ad Valorem (payante) vous indemnisera à hauteur de la valeur d achat de la marchandise. Pour de plus amples informations prenez contact avec votre interlocuteur commercial Exapaq. Traiter les commandes expédiées Permet de : o o Créer une expédition + lien de suivi en fonction du n de commande Magento qui seront intégrés dans le bon de commande (en back-office et en front-office) Envoyer un e-mail aux destinataires contenant un lien pour suivre leur colis sur www.icirelais.com ou www.exapaq.com o Mettre automatiquement à jour les statuts des commandes vers «En cours de préparation». Le module vous confirme les actions menées sur les commandes. 9

Utilisation en back-office 5.2 Suivi des commandes Une fois les commandes mises à jour par le module, les expéditions auront été rajoutées aux commandes et vous pourrez suivre la livraison du colis en cliquant sur «Suivre la commande» sous l adresse de livraison du client. Suivi Le client pourra également suivre la livraison depuis son espace client en front-office. 10

Désinstallation des modules 6. Désinstallation des modules Vous pouvez désinstaller ces modules directement par le back-office, par l onglet Système > Magento Connect > Magento Connect Manager. 1. Rendez-vous à la ligne correspondante aux modules «Exapaq_Relaypoint» et «Exapaq_Predict» 2. Dans la liste déroulante des actions disponibles, sélectionnez «Uninstall» 3. Au bas de la page, cliquez sur «Commit Changes» Si vous avez installé le module par FTP, ou si vous préférez supprimer manuellement le module : 1. Supprimez les fichiers suivants du serveur FTP : Exapaq_Relaypoint ( ICI relais par EXAPAQ ) Exapaq_Predict ( Predict par EXAPAQ ) app\code\community\exapaq\relaypoint (dossier) app\code\community\exapaq\predict (dossier) app\design\frontend\default\default\layout\relaypoint.xml app\design\frontend\default\default\layout\predict.xml app\design\frontend\default\default\template\relaypoint (dossier) app\design\frontend\default\default\template\predict (dossier) app\etc\modules\exapaq_relaypoint.xml app\etc\modules\exapaq_predict.xml app\locale\en_us\exapaq_relaypoint.csv app\locale\en_us\exapaq_ Predict.csv app\locale\fr_fr\exapaq_relaypoint.csv app\locale\fr_fr\exapaq_ Predict.csv media\icirelais (dossier) media\predict (dossier) skin\frontend\default\default\css\icirelais.css skin\frontend\default\default\css\predict.css skin\frontend\default\default\images\icirelais (dossier) skin\frontend\default\default\images\predict (dossier) skin\frontend\default\default\js\icirelais.js skin\frontend\default\default\js\ predict.js 2. Exécutez les requêtes SQL suivante sur votre base de données : DELETE FROM `core_config_data` WHERE `path` LIKE '%relaypoint%' DELETE FROM `core_config_data` WHERE `path` LIKE '%predict%' 3. Purgez le cache de Magento. 7. Dépannage En front-office, le transporteur «ICI relais par EXAPAQ» ou «Predict par EXAPAQ» n'apparaît pas Vérifiez que votre configuration de tarifs soit correctement établie. Vous pouvez forcer l affichage des transporteurs même quand ceux-ci ne sont pas disponibles via le paramétrage des modules en back-office. En front-office, le transporteur «ICI relais par EXAPAQ» apparaît, mais pas le choix de point relais ou En front-office, le transporteur «Predict par EXAPAQ» apparaît, mais pas le bloc de présentation Si vous utilisez un template autre que default, veillez à intégrer les fichiers présents dans /app/design/frontend et /skin/frontend/default/ dans le répertoire de votre template. Si vous utilisez un module transporteur (So Colissimo, TNT, Mondial Relay), ceux-ci peuvent modifier le template du checkout : veillez à copier coller les blocs de lignes afférents à ICI relais et EXAPAQ Predict depuis /app/design/fronntend/default/default/relaypoint/checkout/onepage/shipping_method/available.phtml vers le fichier template concerné (socolissimosimplicite/onepage/... par exemple) En front-office, la liste de point relais ne se charge pas Vérifiez le paramétrage de l URL MyPudo dans la configuration du module ICI relais en back-office. L'extension PHP SOAP doit être active pour que l'appel au webservice se réalise. 11