Manuel d'installation du module TNT Express pour Magento Version 3.0.13
SOMMAIRE DU DOCUMENT 1. OBJECTIF DE CE DOCUMENT...3 2. COMPATIBILITÉ ET PRÉ-REQUIS...3 2.1 Compatibilité... 3 2.2 Compte TNT Express OBLIGATOIRE... 3 2.3 Configuration du Back Office... 3 2.4 Désinstallation des éventuels modules TNT existants... 3 3. INSTALLATION ET CONFIGURATION...4 3.1 Installation automatique du module via Magento Connect (RECOMMANDE)... 4 3.2 Installation manuelle... 5 3.3 Configuration du module TNT Express... 5 4. TEST DU MODULE...111 4.1 Test du module sur votre boutique (front-office)... 111 4.2 Débogage... 13 5. CRÉATION D UNE EXPEDITION EN BACK-OFFICE...13 6. IMPRESSION DES BONS DE TRANSPORT TNT...16 7. ESPACE «MON COMPTE» - SUIVI DE COLIS DE VOTRE CLIENT...16 8. INSTALLATION MULTI-MODULES «TRANSPORTEUR»...19 Page 2 / 20
1. OBJECTIF DE CE DOCUMENT Le présent document a pour objectif de vous aider à installer et à paramétrer le module d expédition TNT Express France dans Magento. Grâce à lui, vous pourrez proposer une livraison en France de vos produits en express à tous vos clients. 2. COMPATIBILITÉ ET PRÉ-REQUIS 2.1 Compatibilité Le module a été testé et validé sur les versions suivantes de magento : CE 1.7 & 1.8 P ATTENTION : Le module TNT Express est compatible avec la solution «Website Payments Standard» UNIQUEMENT. Pour une utilisation avec le module «Paypal Express Checkout» une adaptation technique manuelle devra être entreprise par vos soins. 2.2 Compte TNT Express OBLIGATOIRE Ce module nécessite au préalable une souscription à un contrat TNT Express France. Pour ouvrir un compte TNT Express, c est très simple : a. Rendez-vous directement à l adresse suivante : http://www.tnt.fr/public/contact/accueilcontact.do b. Dans le formulaire de contact, choisissez comme objet : «Devenir Client», et spécifiez comme message «Ouverture de compte via Magento» 2.3 Configuration du Back Office Le Back Office du module TNT Express doit avoir été paramétré (voir documentation «Paramétrage dans le Back Office TNT Express») en indiquant notamment les urls de tracking et du webservice TNT. Ces URLs vous seront fournies sur votre demande après la création de votre compte TNT Express. Ce module n'est actuellement pas compatible avec l'option «multi-shipping» 2.4 Désinstallation des éventuels modules TNT existants Pour assurer le bon fonctionnement du module TNT Express officiel et éviter tout conflit matériel et/ou logiciel, vous devez désinstaller tous les modules TNT (y compris la version 1 officielle du module) que vous auriez pu installer au fil du temps sur votre instance Magento. Page 3 / 20
Pour cela, vous avez la possibilité de passer soit : par votre espace de gestion Magento Connect et de choisir «Uninstall» pour le(s) module(s) TNT installés. par une désinstallation manuelle en supprimant tous les fichiers se rapportant au(x) module(s) non-officiel(s) dans les répertoires de votre instance Magento et en éliminant les éventuelles entrées de la base de données (notamment dans les tables «core_confi_data», «core_resource» et les entrées «tnt_infos_comp» dans les tables «sales_flat_order_address» et «sales_flat_quote_address»). 3. INSTALLATION ET CONFIGURATION IMPORTANT : Il est fortement déconseillé d installer un module directement sur une boutique en production. Il est conseillé de le faire d abord dans un environnement de tests 3.1 Installation automatique du module via Magento Connect (RECOMMANDE) a. Allez dans «Système» - «Magento Connect» - «Magento Connect Manager». b. Connectez-vous avec les mêmes identifiants que votre interface d administration. c. Rendez-vous sur le site internet Magento Connect en cliquant sur le bouton correspondant OU en vous rendant directement à l adresse suivante, après vous être connecté avec les mêmes identifiants que votre interface d administration : http://www.magentocommerce.com/magento-connect/tnt-express-france.html Votre version de Magento est supérieure ou égale à la 1.7 - Cliquez sur le bouton bleu «Install Now» - Sélectionnez «Magento Connect 2.0» - Cochez la case «I agree to the extension» - Cliquez sur «Get Extension Key» - Un lien URL va apparaître - Cliquez sur «Select Key» pour copier le lien - Retournez sous «Magento Connect Manager» (point a. ci-dessus puis d.). Votre version de Magento est inférieure ou égale à la 1.6 - Cliquez sur l onglet «Release Notes» en bas de l écran - Sélectionnez la dernière version 2.0.x. compatible avec la 1.4.2, 1.5 et 1.6, - Cliquez sur le bouton bleu «Install Now» - Cochez la case «I agree to the extension» - Cliquez sur «Get Extension Key» - Un lien URL va apparaître - Cliquez sur «Select Key» pour copier le lien - Retournez sous «Magento Connect Manager» (point a. ci-dessus puis d.). Page 4 / 20
d. Collez la clé d extension dans le champ correspondant. e. Donnez les droits en écriture au répertoire /media/pdf_bt/ pour que les bons de transport puissent y être copiés sans problème. f. Videz votre cache, déconnectez-vous de votre backoffice et reconnectez-vous. 3.2 Installation manuelle a. Ouvrez une fenêtre SSH b. Rendez vous à la racine de votre site et tapez la commande : "./pear install TNTFrance-3.0.13.tgz" c. Vider votre cache, déconnectez-vous de votre backoffice et reconnectez-vous. 3.3 Configuration du module TNT Express a. Connectez-vous au Back-Office Magento et allez dans «Système» - «Configuration». b. Allez sur la gauche de l écran, dans l onglet «Ventes» et sélectionnez «Modes de Livraison». Vous constaterez sur la partie droite de l écran qu un nouveau mode de livraison intitulé «TNT Express» est disponible. (Si ce n'est pas le cas, videz les caches, déconnectez-vous du Back Office puis reconnectez-vous). Page 5 / 20
c. Informations techniques Activé URL de tracking TNT * URL de Passerelle * Numéro de compte client TNT * Identifiant MyTNT * Mot de passe MyTNT * Activer / Désactiver le mode de livraison TNT Express. Choisir «Oui» pour que le mode de livraison TNT Express soit activé. URL permettant le suivi des expéditions TNT Express. Cet URL est utilisée : - dans l envoi de mail d expédition de commande au client - dans l interface de suivi des commandes dans le compte du client - dans l interface de suivi des commandes dans le panel d administration URL de connexion avec le webservice TNT Express. Votre numéro de compte TNT Express National à 8 chiffres Identifiant de votre accès MyTNT - TNT Express National Mot de passe de accès MyTNT - TNT Express National IMPORTANT : - Toutes ces informations vous seront fournies au moment de la création de votre compte TNT Express. - Elles sont toutes nécessaires pour faire fonctionner le module. Pour démarrer et utiliser le module TNT Express, vous avez besoin : 1. De votre numéro de compte TNT Express (il faut déjà être client TNT Express) 2. De l'accès à MyTNT TNT Express National avec vos codes d accès (Login / Mot de passe). (Si nous ne l'avez pas déjà, vous pouvez le demander via le formulaire en ligne : https://www.tnt.fr/public/utilisateurs/adminext/new.do) Page 6 / 20
3. D'une inscription aux liens de connexion webservices Pour fonctionner le module e-commerce TNT a besoin de liens de connexion aux webservices nécessaires à son paramétrage. C'est à vous client/développeur de faire directement la demande par mail via l'adresse : inscription.webservices@tnt.fr en prenant bien soin de transmettre dans celui-ci toutes les informations demandées. A savoir obligatoirement : Préciser le motif suivant en OBJET du mail : Inscription Code Site La Raison Sociale : (La raison sociale de votre Société) Le numéro de compte TNT Express : (votre n de compte TNT Express ) L adresse du site marchand : (l adresse www de votre site) L adresse mail du contact : (votre adresse email) La solution e-commerce choisie : Magento (suivi de la version) Un agent automatique confirmera la prise en compte de la demande et vous indiquera les liens de connexion aux webservices. Sous 48 heures maximum, votre compte TNT Express devrait être paramétré pour pouvoir utiliser le module TNT. Une fois que vous possédez ces 3 éléments (compte / accès / liens de connexion) et que les paramétrages sont effectués, le module fonctionnera correctement. d. Informations de votre entreprise Informations Expéditeur Format d étiquette Poids maximum TNT - Ces informations sont utilisées uniquement pour l impression des étiquettes TNT Express dans le panel d administration. - Vous devez remplir les champs pour identifier l expéditeur des colis TNT Express, c'est-à-dire, soit à l e-commerçant soit un prestataire logistique. - Le code postal et la ville expéditeur doivent être indiqués sans cedex et ne pas être une boite postale - Si vous imprimez vos étiquettes sur une imprimante «classique», choisissez «Imprimante A4 Standard». - Si vous imprimez vos étiquettes sur une imprimante thermique, choisissez «Imprimante thermique générique». - Si vous imprimez vos étiquettes sur une imprimante thermique TNT, choisissez «Imprimante thermique TNT» - Poids max d une commande en livraison TNT. Si le poids de la commande est supérieur, les offres TNT ne sont pas proposées. Page 7 / 20
e. Les offres TNT Express Grâce au module TNT Express, vous pourrez proposer par défaut trois services de livraison express qui sont intégrés au module : TNT 24h à Domicile : Le colis est livré au domicile de votre client (ou à l adresse de son choix) le lendemain matin de la remise du colis à TNT Express. La livraison s effectue en main propre contre signature, en 24h après expédition de la commande, et avant 13h, du lundi au samedi* de 8H à 13H** en France continentale. En cas d'absence ou d'impossibilité de livraison, le colis est déposé dans le Relais Colis le plus proche, et votre client peut le retirer le jour même dès 14h. * Livraison le samedi uniquement dans les principales agglomérations. Pas de livraison les dimanches et jours fériés.** ou en début d'après-midi dans les zones rurales. TNT 24h en Entreprise : Ce mode de livraison n est disponible pour votre client que s il a rempli le champ «Raison Sociale» dans l écran de saisie de «l adresse de livraison» de sa commande. La livraison s effectue au bureau en main propre contre signature, en 24h après expédition de la commande, et avant 13h, du lundi au vendredi* de 8H à 13H** en France continentale. * Pas de livraison les samedis, dimanches et jours fériés. ** ou en début d'après-midi en zones rurales TNT 24h en Relais Colis : Le colis est livré le lendemain matin dans le Relais Colis choisi par votre client. La livraison est effectuée en 24h, après expédition de la commande, dans l un des 4200 Relais Colis partout en France métropolitaine. Le retrait est possible dés 14h et la distribution se fait après vérification d une pièce d identité et contre signature. - Si, sur l écran front-office permettant de renseigner les informations de livraison, votre client renseigne le champ «Raison sociale», il aura le choix entre les services «TNT 24h en Entreprise» et «TNT 24h en Relais Colis». - Si par contre le champ ««Raison sociale» est vide, il pourra choisir entre les services «TNT 24h à Domicile» et «TNT 24h en Relais Colis». IMPORTANT : LES DÉLAIS DE LIVRAISON ANNONCÉS NE SONT VALABLES QU A PARTIR DU MOMENT OU LE COLIS SERA REMIS A TNT EXPRESS. IL EST DONC CONSEILLÉ A LA PERSONNE OU AU PRESTATAIRE EN CHARGE DE L EXPEDITION DE VOS COMMANDES DE TRAITER LES ENVOIS TNT EXPRESS EN PRIORITÉ. Page 8 / 20
f. Tarifs Renseignez les tarifs TTC (en euros) de chaque offre TNT Express. Vous avez trois options possibles pour fixer vos tarifs de livraison : 1. Faire payer les frais de livraison en fonction du poids de la commande. Dans ce cas, vous devez saisir pour chaque palier de poids un montant TTC sans devise suivant le format {poids en kg:tarif1, poids en kg:tarif2,...} Exemple : (2,5:5,5:10,10:15,1000:20) Dans l'exemple : 5 euros pour un poids inférieur à 2,5 kg, 10 euros pour un poids inférieur à 5 kg, 15 euros pour un poids inférieur à 10 kg, 20 euros au delà. Pour la dernière tranche de poids, utilisez une borne maximum élevée (1000 pour 1000 kgs). Le tarif est appliqué pour un poids supérieur ou égal au poids correspondant. 2. Faire payer les frais de livraison en fonction du montant de la commande. Dans ce cas, vous devez saisir pour chaque palier de prix un montant TTC sans devise suivant le format {montant de la commande:frais de port1, montant de la commande:tarif2,...} Exemple : (20 :8.90,50 :10.90,150 :14.90,19.90) Dans l'exemple : les frais de port sont paramétrés à 8.90 jusqu'à 20 de panier, puis 10.90 jusqu'à 50, 14.90 jusqu à 150, et 19.90 au delà Page 9 / 20
3. Faire payer les frais de livraison au forfait. Dans ce cas là, saisissez simplement le montant TTC du forfait unique que vous souhaitez facturer pour chaque service, par exemple «15» pour 15 euros. IMPORTANT : Le poids maximum de chaque colis est de 20 Kgs à destination d un particulier (BtoC), 30 Kgs à destination d un professionnel (BtoB), l'arête développée doit être inférieure ou égale à 170 cms (longueur + largeur + hauteur) et la longueur maximum de 130 cms. L envoi de colis vers la Corse entraîne un coût supplémentaire. Vous pouvez utiliser le champ «Supplément pour les envois vers la Corse» pour répercuter ce supplément sur les frais de livraison de vos clients. Si vous valorisez ce champ à «0», vos clients ne paieront pas de supplément pour leurs expéditions en Corse, sinon le montant renseigné sera automatiquement rajouté aux frais de livraison. Utilisez le champ «Minimum d achat» pour indiquer le montant de commande à partir duquel la livraison via TNT Express est offerte au client. Si la valeur de ce champ est égale à 0, la livraison n est jamais offerte. g. Message d erreur Vous pouvez changer le message d erreur par défaut qui s affiche si le module est en disfonctionnement ou si les liaisons avec le webservice TNT Express ont échoué. h. Sauvegarde Lorsque tous les paramètres sont renseignés / modifiés, sauvegardez votre configuration en cliquant sur le bouton «Sauvegarder la configuration» en haut à droite de la page. Page 10 / 20
4. TEST DU MODULE 4.1 Test du module sur votre boutique (front-office) Rendez-vous sur votre boutique et passez une commande. A l étape du choix du mode de livraison, vous pourrez sélectionner une des offres TNT Express que vous avez décidée de proposer en Back-Office : En cliquant sur le bouton «+ d infos», vous pourrez visualiser les spécificités de chaque service TNT Express proposées. Si vous choisissez la livraison TNT 24h en Relais Colis, une fenêtre s ouvre en popup : Vous devrez alors renseigner votre code postal pour accéder à la liste des Relais Colis les plus proches (par défaut, le code postal est celui que vous avez renseigné dans votre adresse de livraison). Page 11 / 20
Pour consulter toutes les informations sur un Relais Colis, vous pouvez cliquer sur le logo du Relais Colis présent sur la carte. Vous pourrez ainsi : Géolocaliser le Relais Colis Consulter ses horaires d ouverture Déterminer un itinéraire pour vous y rendre (redirection vers une page du site tnt.fr). Lorsque vous aurez choisi un Relais Colis «Continuer», et que vous aurez cliqué sur le bouton Vous pourrez constater que l adresse de livraison présente sur votre page de Magento a été modifiée. Finalisez votre commande pour vérifier que l intégralité du processus de commande est fonctionnel et pour débuter le test de création de l expédition en Back-office. Page 12 / 20
4.2 Débogage Si vous ne voyez pas le service TNT Express dans les modes de livraison proposés, effectuez les actions suivantes : 1. Déconnectez vous du Front-office et du Back-office et videz tous les caches avant repasser une commande. 2. Vérifiez bien toutes les informations de connexion TNT qui vous ont été fournies lors de votre ouverture de compte (URL webservice, Numéro de compte, login et mot de passe). 5. CRÉATION D UNE EXPEDITION EN BACK-OFFICE a. Connectez-vous au Back-Office de votre boutique Magento, puis allez dans l onglet «Ventes» et cliquez sur le bouton «Commandes». b. Sélection de la commande à expédier Choisissez dans la liste des commandes celle que vous souhaitez expédier et cliquez sur le bouton à droite : «voir». c. Créer l expédition de votre commande Une fois sur la page du détail de la commande, cliquez sur le bouton en haut à droite de l écran : «Expédier». Page 13 / 20
d. Choix de la date d expédition S affiche alors un tableau «Information de livraison» dans lequel est indiqué le nombre de colis estimé, et le poids global de la commande : Vérifiez la date d expédition (ou modifiez-là si nécessaire) Si les informations affichées sont correctes, vous pouvez cliquer sur Dans le cas d une commande dépassant 20Kgs à destination d un particulier (à Domicile ou en Relais Colis) ou 30Kgs à destination d un professionnel (au Bureau) la commande est divisée en nombre de colis par tranche du poids maximum autorisé. Vous pouvez alors spécifier un nombre de colis supérieur et/ou le poids de chacun d entre eux sans dépasser le maximum autorisé. Précisez le nombre de colis via la liste de choix. Indiquez pour chaque colis le poids de celui-ci. Comme dans l exemple ci-dessous : Vous pouvez ensuite cliquer sur e. Validation de votre expédition Une fois votre expédition «validée», vous constaterez que la partie «Informations de livraison» a été modifiée et qu un nouveau bouton «suivre la commande» est disponible. Page 14 / 20
En cliquant sur ce bouton, vous pouvez accéder à la page de suivi colis du site TNT Express qui vous donne le statut de livraison de votre expédition. Sur la page «Commandes», vous constaterez également que le statut de votre commande a changé, passant de «En attente» à «En cours de traitement». INFORMATIONS IMPORTANTES RELATIVES A VOS EXPEDITIONS : TNT Express ne ramasse pas vos colis le samedi, le Dimanche et les jours fériés. Par conséquent, si la date d expédition que vous renseignez correspond à un samedi, un dimanche, ou un jour férié, vous ne pourrez pas enregistrer votre expédition. Un message d erreur s affichera en haut de la page vous demandant de choisir une autre date d expédition. Pour les services «TNT 24h à Domicile» et «TNT 24h en Relais Colis» (BtoC), TNT Express ne peut expédier que des colis dont le poids est inférieur ou égal à 20 kgs. Si votre commande contient plusieurs articles et est supérieure à 20kgs, vous devez «dispatcher» les articles en plusieurs colis pour que ces derniers aient un poids unitaire inférieur à 20 kgs. Vous devez alors renseigner le bon nombre de colis dans le champ «Nombre de colis à expédier». Pour une même expédition et une même commande, le système créera autant de Bon de Transport qu il y a de colis. Les colis dont le poids est supérieur à 20kgs (et inférieur à 30) ne peuvent être expédiés que via le service «TNT 24h au Bureau» (BtoB). Pour pouvoir sélectionner ce service, l utilisateur devra avoir renseigné le champ «raison sociale» dans l adresse de livraison indiquée. Page 15 / 20
6. IMPRESSION DES BONS DE TRANSPORT TNT a. Dans le back-office de votre boutique Magento, allez dans l onglet «Ventes» et cliquez sur le bouton «Suivi des expéditions TNT». b. Sélectionnez la commande pour laquelle vous souhaitez imprimer vos bons de transport. Cochez la case correspondant à la commande pour laquelle vous souhaitez imprimer vos bons de transport. Dans la partie «Actions», choisissez «Imprimer les étiquettes» puis «Valider» pour afficher l étiquette. Exemple d Etiquette : Selon votre système d exploitation et votre navigateur web, une nouvelle fenêtre va s ouvrir ou le téléchargement d un fichier PDF va se lancer. Ce document correspond à l étiquette que vous devrez apposer sur le colis correspondant. Il contient toutes les informations TNT requises à la bonne expédition de la commande. Pour vous aider à préparer vos commandes, toutes les informations utiles sont reprises sur cette étiquette et notamment le n de la commande Magento correspondant à ce Bon de Transport TNT Express. Si votre expédition comporte plusieurs colis, le fichier PDF correspondant contiendra plusieurs pages. Chaque étiquette indique le numéro du colis par rapport au total de colis de la commande (ex. colis 1/4 si il y a 4 colis dans la commande) Page 16 / 20
c. Impression de Bons de transport pour plusieurs commandes Pour une gestion plus facile de vos envois, le module Magento TNT Express vous donne la possibilité d imprimer les bons de transport de plusieurs commandes sur un seule et même fichier PDF. Pour cela, il vous suffit de cocher toutes les commandes pour lesquelles vous souhaiter imprimer vos étiquettes dans la partie «Suivi des expéditions TNT» et de valider l action «Imprimer les étiquettes». Page 17 / 20
7. ESPACE «MON COMPTE» - SUIVI DE COLIS DE VOTRE CLIENT Dès que vous aurez expédié un colis, votre client pourra le suivre via «son compte». Une fois connecté à son compte, votre client accédera à son «tableau de bord». Il doit alors cliquer sur «Visualiser» pour accéder au détail de sa commande. En bas de sa page, dans la partie «Expédition», il doit cliquer sur le numéro de suivi. En cliquant sur ce numéro, il accèdera directement au suivi de son colis. Exemple de suivi de colis : Page 18 / 20
8. INSTALLATION MULTI-MODULES «TRANSPORTEUR» Si vous installez plusieurs extensions de livraison (installation de module(s) d autres transporteurs), il se peut que les templates de ces modules rentrent en conflits les uns avec les autres, Magento ne gérant pas nativement le multi-templating De fait, il se peut que les extensions pour lesquelles Magento n'affiche pas les templates (exemple : la gestion des Relais Colis ) ne fonctionnent pas correctement. Dans le cas où vous souhaiteriez utiliser différents modules de livraison (Chronopost, Mondial Relais, ), en même temps que le module TNT Express, Vous devrez adapter une partie du code Pour les exemples ci-dessous, nous considérons que c'est le template TNT Express qui est affiché. Lorsque vous installez un module de livraison, il créé un nouveau dossier dans le chemin suivant : /app/design/frontend/default/default/template/ Lorsque vous aurez installé le module TNT Express, vous aurez donc un nouveau dossier : /app/design/frontend/default/default/template/tnt/ Dans la plupart des cas, les modules de livraison utilisent deux fichiers pour gérer le templating de la page de choix du mode de livraison dans le tunnel de vente Magento : onepage/shipping_method.phtml onepage/shipping_method/available.phtml Dans le fichier «available.phtml», vous allez pouvoir intégrer l'affichage de vos autres modules de livraison. Pour cela, vous devrez : 1. Vous rendre dans le dossier du module de livraison que vous souhaitez intégrer : Exemple pour Chronopost : /app/design/frontend/default/default/template/chronopost/ 2. Ouvrir le fichier «available.phtml» Exemple pour Chronopost : /app/design/frontend/default/default/template/chronopost/onepage/shipping_met hod/available.phml Page 19 / 20
3. Sélectionner dans ce fichier la partie du code correspondant à l'affichage des offres du module de livraison concerné et le copier. 4. Intégrer le code copié dans le fichier «available.phtml» du module TNT Express disponible dans le chemin suivant : /app/design/frontend/default/default/template/tnt/onepage/shipping_method/available.ph tml = = = = = = = = = = = = = = = = Le bouton «continuer» de la page de livraison peut également avoir des actions différentes selon les extensions il faut donc gérer ces actions. Pour cela, vous devrez : 1. Vous rendre dans le dossier du module de livraison que vous souhaitez intégrer Exemple pour Chronopost : /app/design/frontend/default/default/template/chronopost/ 2. Ouvrir le fichier "shipping_method.phtml" Exemple pour Chronopost : /app/design/frontend/default/default/template/chronopost/onepage/shipping_met hod.phtml 3. Sélectionner dans ce fichier la partie du code correspondant à l'action du bouton du module de livraison concerné et le copier. 4. Intégrer le code copié dans le fichier "shipping_method.phtml" du module tnt disponible dans le chemin suivant : /app/design/frontend/default/default/template/tnt/onepage/shipping_method.phtml Si des conflits persistent, vérifiez les fichiers «layout» qui peuvent être impactés par certaines modifications : /app/design/frontend/default/default/layout/ = = = = = = = = = = = = = = = = Page 20 / 20