x 
Votre panier - 0,00 €
Votre panier
Panier Vide

Socolissimo pour Joomla 1.5 et VirtueMart 1.1

La poste a mis récemment en place le service So Colissimo. Ce service propose 5 modes de livraison:

  • à domicile,
  • sur rendez-vous,
  • en espace cityssimo,
  • en bureau de poste
  • chez un commerçant.

Cette solution a été intégrée pour VirtueMart.

Installation des fichiers du module de so colissimo pour VirtueMart 1.1

Télécharger le module socolissimo pour Joomla 1.5 et VirtueMart 1.1

Copier l’ensemble du dossier vers votre site. Les fichiers sont déjà dans les bons dossiers. Deux fichiers sont à transférer à la racine (c'est normal), et d'autres sont transférés dans le dossier /administrator/components/com_virtuemart.

Le module est en version beta.

Si vous avez des questions, merci de les poser ici: http://forum.joomla.fr/showthread.php?131640-So-Colissimo

Vous ne pouvez utiliser cette méthode que si vous avez un contrat pour cette offre So Colissimo, et si vous avez reçu les informations suivantes:

  • Clé de cryptage
  • Identifiant FO

Pour souscrire à l'offre So Colissimo, contactez votre interlocuteur La Poste habituel, ou le 36 34.

Comment configurer le BO ColiPoste pour le module So Colissimo?

Modification de votre thème VirtueMart

VirtueMart impose que les adresses de livraison soient enregistrées dans la base de données. Mais le client ne doit pas pouvoir disposer de ces adresses dans le cas d'une deuxième commande: un point de livraison peut etre fermé, ou ne plus proposer ce service lors de la deuxième commande.

Il faut donc apporter une modification dans le thème de VirtueMart:

Dans le fichier components/com_virtuemart/theme/mmontheme/pages/checkout.thankyou.tlp.php ajouter les lignes suivantes: (entre global $VM_LANG; et ?> )

global $VM_LANG;

$user_id=vmGet( $_REQUEST, 'user_id');
$dbso = new ps_DB();
$query ="DELETE FROM #__{vm}_user_info WHERE ";
$query .="  (user_id='".$user_id."'";
$query .=" AND address_type='ST'";
$query .=" AND address_type_name='SOCOLISSIMO')";
$dbso->query($query);
?>

Configuration du back Office de ColiPoste

Le back office de la poste doit être paramétré avec les URLs suivantes:

  • L'URL de retour échec pour les cas de retour KO de la page. Cette info est obligatoire.
    http://votresite.com/socolissimo_failed.php
  • l'URL de retour validation pour les cas de retour OK de la page. Cette info est obligatoire.
    http://votresite.com/socolissimo_success.php
  • Le montant souhaité du surcoût de la livraison sur Rendez-vous. Cette info est facultative. Par défaut, la valeur sera positionnée à 3,60€.
  • Le délai de préparation de commande. Cette info est facultative. Par défaut, la valeur sera positionnée à 3 jours ouvrables.

Configuration du module de So colissimo

1. Rendez vous dans l’administration de VirtueMart, et aller dans Configuration
2. Dans l'onglet Expédition, cocher la case Socolissimo La poste Shipping module

expedition-config

3. Sauvegarder
4. Aller dans le menu Boutique/ Lister les modules d'expeditions
5. Cliquer sur Configurer la méthode d'expédition

lister-les-expeditions

6. Remplissez les champs

    • Nom du transporteur
    • Nom du mode de livraison
    • Identifiant Front Office: Identifiant unique transmis par la solution SO Livraison. 14 caractères numériques. Obligatoire. Cette information est disponible dans le back office ColiPoste.
    • Cle de cryptage: Clé unique transmise par la solution SO Livraison. Obligatoire. 12 caractères numériques. Cette information est disponible dans le back office ColiPoste.
    • URLs Page SO Modes de livraison: http://ws.colissimo.fr/pudo-fo/storeCall.do ou https://ws.colissimo.fr/pudo-fo/storeCall.do
    • Activer la vérification de la disponibilité: Oui : une vérification de la disponibilité de la plateforme So Colissimo est effectuée. Non : aucune vérification. A FAIRE.
    • Délai de préparation de commande: La valeur par défaut est de 3 jours ouvrables. Obligatoire. 2 caractères numériques
    • Cout Livraison: Cout de la livraison TTC
    • Surcout Livraison sur rendez-vous: Le surcoût livraison sur rendez-vous est le montant que le chargeur souhaite appliquer à ses clients lorsqu’ils choisissent ce mode de livraison. Jusqu'à 5 caractères numériques
    • Classe de Taxes: sélectionner le taux de taxes de la livraison

 

      7.Sauvegarder


socolissimo

Ajouter des champs utilisateurs

1. Aller dans Configuration / Gérer les champs utilisateurs

2. Ajouter les champs suivants:champs-utilisateurs

Configurer ces champs avec:

  • champ obligatoire: non
  • Afficher dans le formulaire d'inscription?:non
  • Afficher dans les informations de compte?:non
  • Afficher dans le formulaire Expédition? OUI
  • Publier:Oui

Le nom des champs utilisateurs (colonne Nom du champ dans l'image) doit être identique à ceux de l'image.

Le formulaire proposé par Socolissimo est beaucoup plus complet que le formulaire d'adresse de livrasion proposé par défaut de VirtueMart. La création des champs est obligatoire et permet de garder toutes les informations transmises par Socolissimo à VirtueMart.

Comment marche So Colissimo avec Joomla 1.5 et VirtueMart 1.1

1. Lorsque le client arrive à la page, la méthode Socolissimo est proposée avec le bouton radio désactivé. Un lien vers socolissimo permet d'accéder à la page du service.

Mettez en valeur grâce aux CSS, le lien vers So Colissimo, de façon à ce qu'il soit bien visible.

choixexpedition

3.Sur la page de So Colissimo, le choix du mode de livraison s’effectue en 3 étapes :
• Etape 1 :les modes de livraisons sont proposés en fonction de l’adresse transmise dans les paramètres d’appel. Si l’internaute est reconnu (via cookie), le dernier mode de livraison choisi est coché par défaut
• Etape 2 :l’internaute a la possibilité de modifier son adresse afin de disposer d’autres modes de livraison ou d’autres points de retrait
• Etape 3 :l’internaute choisi son mode de livraison

Une fois le mode de livraison choisi, l’internaute est redirigé vers l’URL retour « Validation » définit dans le back office de ColisPoste, les informations saisies ou sélectionnées sur la Page SO « Modes de livraison » sont transmises à votre site.

3. Au retour de So Colissimo, VirtueMart enregistre les informations fournises dans la liste des adresses de livraisons du client, si celle ci n'existe pas encore. Ensuite, le client poursuit son processus d'achat en validant son paiement.

Pour la version beta, il est nécessaire de faire une petite correction afin que si l'adresse existe déjà, elle ne soit pas ajoutée.

Fichier /administrator/components/com_virtuemart/classes/ps_user_address.php , fonction add(), ligne 126, modifié le code avec :

foreach( $shippingFields as $userField ) {
            if( !in_array($userField->name, $skip_fields )) {           
                $fields[$userField->name] = ps_userfield::prepareFieldDataSave(
$userField->type, $userField->name, vmGet( $d, $userField->name,  ""));               
             
            }
        }

Je vous conseille de ne pas modifier  le code de VirtueMart directement, mais d'utiliser les user_class de VirtueMart pour effectuer cette modification.

4. Dans le cas d'un retour Echec de la part de So Colissimo, le client est renvoyé au début du processus de passage en caisse, et l'erreur transmise par SoColissimo est affichée.codepostalinvalide

Liste des erreurs possibles retournées par So Colissimo:

  • Identifiant FO manquant
  • Identifiant FO incorrect
  • Client non autorisé
  • Champs obligatoire manquant
  • Signature manquante
  • Signature invalide
  • Code postal invalide
  • Format url retour Validation incorrect
  • Format url retour Echec incorrect
  • Numéro de transaction non valide
  • Format des frais d’expédition incorrect
  • Serveur applicatif non disponible
  • SGBD non disponible
alatak·net
Agence Web
Expert Joomla
Basé sur Sophia Antipolis
Spécialisée dans le développement web
alatak.net, Joomla Certified Administrator

© alatak·net, tous droits réservés.
Le site alatak.net n'est ni affilié à Open Source Matters ou au projet Joomla ni approuvé par eux. Le nom Joomla!® est utilisé sous license limitée de Open Source Matters, le propriétaire mondial de la marque de commerce.