http://www.bysoft.fr «ICI relais» Module pour OsCommerce V1.0
VERSION FRANÇAISE Ce document explique comment installer, configurer et utiliser le module «ICI Relais» sur votre site OsCommerce. Compatibilité et pré-requis : Ce module est basé sur la version 2.2 d OsCommerce. Il nécessite un support Webservice SOAP pour pouvoir se connecter au webservice Exapaq de récupération des points ICI relais. Il nécessite également un support FTP permettant de se connecter via FTP à un serveur distant, pour récupération des fichiers contenant les Espaces ICI relais.
Installation : 1) Placez-vous dans le répertoire «catalog» de votre site OsCommerce. 2) Renommez les fichiers ci-dessous sous la forme «nomdufichier_ladate.php» ; ils constitueront une sauvegarde dans le cas où vous voudriez désinstaller le module : account_history_info.php checkout_shipping.php admin/modules.php admin/orders.php admin/includes/application_top.php admin/includes/languages/english/orders.php admin/includes/languages/french/orders.php includes/application_top.php includes/classes/order.php includes/languages/english/checkout_shipping.php includes/languages/french/checkout_shipping.php Pour obtenir le détail des modifications apportées à ces fichiers, reportez-vous au document «ICI-Relais-OCS-Modifications et créations». 3) Ouvrez le répertoire «icirelais_shipping_module» et copiez les fichiers ci-dessous en respectant l arborescence du module qui est le reflet de celle du répertoire d OsCommerce : Attention : prenez garde aux répertoires de copie car plusieurs fichiers ont le même nom ; il est possible d en écraser par mégarde. account_history_info.php checkout_shipping.php admin/call_icirelais_file_synchronize.php admin/modules.php admin/orders.php admin/includes/application_top.php admin/includes/icirelais.js admin/includes/classes/icirelais_file_synchronize_v1.php admin/includes/classes/icirelais_file_synchronize_v2.php admin/includes/functions/icirelais_functions.php admin/includes/languages/english/orders.php admin/includes/languages/english/icirelais_file_synchronize.php admin/includes/languages/french/orders.php Admin/includes/languages/french/icirelais_file_synchronize.php images/icirelais/
includes/application_top.php includes/icirelais.css includes/icirelais.js includes/classes/icirelais_get_point.php includes/classes/icirelais_get_point_php5.php includes/classes/nusoap/ includes/classes/order.php includes/functions/icirelais_function.php includes/languages/english/checkout_shipping.php includes/languages/english/modules/shipping/icirelais.php includes/languages/french/checkout_shipping.php includes/languages/french/modules/shipping/icirelais.php includes/modules/shipping/icirelais.php includes/prototype Mise à jour de la base de données Le module ICI relais possède deux tables propres. Il faut donc les importer grâce au fichier icirelais.sql se trouvant à la racine du répertoire du module. Comme le fichier est volumineux, il est recommandé de l intégrer en mode console. Pour cela : 1) Ouvrez une console MySQL 2) Tapez la ligne de commande «use [nom_base_de_données]» 3) Taper la ligne de commande «source [le_chemin_vers_le_fichier]/icirelais.sql 4) Si vous le souhaitez, vous pouvez remplir les deux nouvelles tables avec les fichiers icirelais_content.sql et icibackup_content.sql avec la même ligne de commande.
Configuration : 1) Connectez-vous au Back Office de votre OsCommerce. 2) Créez une nouvelle zone de livraison spécifique à ICI relais et ne comportant que la France métropolitaine. Pour cela, placez-vous dans le menu «Lieux / Taxes», «Zones fiscales». Faites «Insérer» puis créez la zone comme décrit ci-dessous : La zone de livraison est créée mais elle ne comporte aucun pays.
Il suffit donc de lui ajouter la France comme pays. A noter que, pour OsCommerce, les DOM- TOM ne sont pas considérés comme faisant partie de la France, donc, il est inutile d ajouter les départements un à un. Dans le champ «Zone», vous pouvez sélectionnez «Toutes les zones». La zone de livraison est créée. 3) Placez-vous dans le menu «Modules», «Expédition». Un nouveau mode de livraison «Livraison en Espace ICI relais» apparait alors dans la liste des modes de livraisons installés sur votre OsCommerce. Sélectionnez-le et cliquez sur «Installer». Attention : le paramétrage du module ICI relais en back office apparaitra toujours dans la langue dans laquelle il a été installé. 4) Une fois les champs créés, cliquez sur «Editer» pour les configurer:
Utiliser le mode de livraison Activer ou désactiver le module Doit être à «Oui» pour que le module puisse fonctionner. Titre Titre du module Ce titre sera affiché en front office URL MyPudo URL du webservice ICI relais Par défaut : http://exapaq.pickupservices. com/mpservicev2/exapaq.asmx?wsdl ID Marchand Numéro d identifiant marchand Ce numéro vous est fourni par Exapaq Clé de sécurité Clé de sécurité Cette clé vous est fournie par Exapaq Serveur FTP Hôte FTP Par défaut :«ftpd.ils-consult.fr» Utilisateur FTP Nom d utilisateur FTP Cet identifiant vous est fourni par Exapaq Mot de passe FTP Mot de passe FTP Ce mot de passe vous est fourni par Exapaq Dossier FTP Dossier de récupération des fichiers des points ICI relais Par défaut «/out» Temps additionnel de Délai supplémentaire de traitement lié à votre activité (en jours). Ce traitement (plus de 12 jours) délai s ajoute au délai de traitement par défaut de 12 jours ICI relais Prix Montant à facturer au client pour ce mode de livraison. Par exemple 5.50 pour 5 50 URL de tracking URL de tracking colis ICI relais Par défaut : http://e-trace.ils-consult.fr/ici-webtrace/ webclients.aspx?sdg_landnr=$1 &sdg_mandnr=$2&sdg_lfdnr=$3&cmd=sdg_search_exact Classe de taxe TVA à appliquer Par défaut, il n y en a pas Zone de livraison Zone de livraison à laquelle s applique ce mode de livraison Par défaut, «France», la zone créée précédemment Order d affichage Ordre d affichage de ce mode de livraison Par défaut, «0» (le mode de livraison sera affiché à la suite des autres.
Mise à jour des points ICI relais dans les tables «icirelais» et «icibackup» Le module comporte deux tables de la base de données spécifiques à ICI relais : Icirelais : contient le détail de chaque point relais (nom, adresse, horaires d ouverture, période de congés, etc.). Icibackup : contient la liste des identifiants des points relais les plus proches d un code postal. Cette table est utilisée en cas d indisponibilité éventuelle du web service d ICI relais nommé MyPudo. Ces tables sont mises à jour grâce à deux fichiers mis à disposition quotidiennement sur le serveur FTP d ICI relais. Pour effectuer la mise à jour, cliquez sur le bouton «Synchroniser les fichiers». Pour pouvoir fonctionner, les paramètres FTP doivent être correctement paramétrés (Hôte FTP, Utilisateur FTP, Mot de passe FTP). Pour lancer ce traitement de façon automatique, une tâche doit être paramétrée en cron au niveau du serveur. Cette tâche doit appeler le fichier suivant : call_icirelais_file_synchronize.php. Si la mise à jour échoue, c est peut-être parce que le programme n est pas autorisé à donner les permissions d écriture (777) au répertoire «download» situé dans la répertoire «catalog».
Utilisation du mode de livraison ICI relais dans OsCommerce 1) Connectez-vous à votre boutique en ligne OsCommerce. 2) Lorsque vous passez une commande, sur l écran contenant les informations de livraison apparait le mode de livraison «Livraison en espace ICI relais» avec les cinq points relais les plus proches de l adresse de livraison saisie. Cette recherche s effectue par un appel vers le web service MyPudo. Pour que cet appel s effectue, il faut que les paramètres sur le Back Office soient correctement renseignés et que votre serveur accepte les appels web services via SOAP. Dans le cas où le web service MyPudo ne peut être contacté, la recherche s effectuera dans le fichier des suggestions (icibackup) mis à jour lors de la synchronisation des fichiers (cf. point précédent). Si vous changez d adresse d expédition, les points ICI relais se mettront à jour automatiquement. Un clic sur «Plus de détail» ouvre une popup 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 ) :
Sélectionnez le point relais désiré et poursuivez votre commande. Lors de la confirmation de la commande, l adresse de l espace ICI relais remplace l adresse de livraison initialement saisie.
Tracing colis Après l enregistrement de la commande, OsCommerce permet à l administrateur du site de créer un tracking pour le colis expédié via ICI relais. Cela permet au client de suivre, d un simple clic, la livraison. 1) En back office, choisissez le menu «Clients / Commandes», «Commandes». Sélectionnez la commande voulue et faites «Editer». 2) Entrez le numéro du colis dans le champ «ICIPASS ICI relais». Ce numéro doit faire au minimum 13 caractères. 3) Cliquez sur le bouton «Créer le tracking», qui rempli le champ commentaire juste au dessus, puis sur «Mise à jour». Un nouvel événement s est ajouté. Il permet, d un clic, d accéder à la page de suivi du colis sur le site de ICI relais.
En front office, le client a le même lien dans le suivi de sa commande : En cliquant sur le lien, une redirection vers le site ICI relais permet d obtenir le suivi détaillé du colis :