OSF Integrator for Demandware and Canada Post - Guide d'intégration

La page est créée Denis Briand
 
CONTINUER À LIRE
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                             Québec (Québec) G2K 1M1 – Canada
                                                                     Téléphone : +1 888 548-4344
                                                                               www.osf-global.com

         OSF Integrator for Demandware and
                    Canada Post

                                     Guide d’intégration

© OSF Global Services, 2015. Tous droits réservés.                                        Page 1
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

        Table des matières
        TOC

            1. Résumé

                 OSF Integrator for Demandware and Canada Post permet aux commerçants
        d’ajouter les services d’expédition de Postes Canada à leurs propres options de livraison.
        En choisissant les services d’expédition de Postes Canada, les commerçants offrent à
        leurs clients plusieurs options de livraison, dont la cueillette au bureau de poste le plus
        proche.
        Les clients inscrits comme les clients invités peuvent choisir et utiliser ces services.
        OSF Integrator for Demandware and Canada Post est un module d’extension autonome
        qui s’intègre facilement à tout projet.

            2. Survol du système

        2.1 Survol des fonctions
        OSF Integrator for Demandware and Canada Post est doté des caractéristiques
        suivantes.

            1. Le module d’extension intègre les services d’expédition de Postes Canada à la
               boutique en ligne Demandware.
            2. Le service « tout-en-un » est offert – les services d’expédition de Postes Canada
               figurent dans une fenêtre de configuration et se choisissent par un simple clic
               dans une case à cocher.
            3. Les frais de livraison sont calculés directement par un service Web en fonction
               des renseignements fournis par le client (adresse) et le commerçant (poids du
               colis, adresse de la boutique). Le prix total est exact et comprend les frais
               d’expédition et les taxes; aucune configuration supplémentaire n’est requise.
            4. L’option de livraison au bureau de poste est incluse – le client peut choisir de
               ramasser son colis à un bureau de Postes Canada (option offerte avec les
               services Xpresspost et Expedited Parcel). Tous les bureaux de poste d’une région
               donnée s’affichent sur une carte, et le client peut sélectionner celui qui lui
               convient (sur la carte ou dans la liste des bureaux de poste adjacente).
            5. Les fonctionnalités du module permettent de fournir au client une date de
               livraison précise afin qu’il sache à quoi s’attendre.

© OSF Global Services, 2015. Tous droits réservés.                                                Page 2
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                         Québec (Québec) G2K 1M1 – Canada
                                                                                 Téléphone : +1 888 548-4344
                                                                                           www.osf-global.com

            6. Les tarifs des services d’expédition offerts aux clients s’établissent comme
                requis :
                a. taux haussés ou abaissés – les taux d’expédition standard de Postes Canada
                    peuvent être modifiés en fonction des besoins de l’entreprise;
                b. taux fixes – des taux fixes peuvent être offerts aux clients pour des services
                    précis;
                c. livraison gratuite – la livraison gratuite peut être offerte dans le cas de
                    commandes dépassant un montant donné.
            7. Grâce à l’option relative à la période de gestion des commandes, le commerçant
                peut indiquer le nombre de jours requis pour que le colis passe de l’entrepôt aux
                installations de Postes Canada aux fins de livraison. Il est ainsi possible de
                donner au client la date de livraison prévue la plus exacte possible.
            8. Le client peut faire le suivi de sa commande et en consulter l’état directement
                depuis le site Web du commerçant.
            9. Le poids d’un colis en livres est automatiquement converti en kilogrammes afin
                d’assurer l’exactitude des frais de livraison.
            10. Le commerçant peut sélectionner comme il lui convient les options
                accompagnant les services d’expédition de Postes Canada. Ces options peuvent
                ou non être applicables, selon les produits vendus par le commerçant.
            11. L’utilisateur peut modifier l’adresse du bureau de poste sur une page de
                commande et sélectionner au besoin un autre bureau de poste sur la carte.

        2.2 Éléments d’intégration
                Veuillez consulter la liste des éléments ci-dessous.

                        Nom du module d’extension
                            int_canadapost
                        Formulaires
                            canadapostmerchantpanel.xml
                            canadapostnpoaddresses.xml
                        Pipelines
                            CPAdministrativePanel.xml
                            CPNearestPO.xml
                            CPOpenReturnLabel.xml
                            CPOriginPostCode.xml
                            CPRating.xml
                            CPShippingMethods.xml
                            CPTracking.xml
                        Scripts
                            bm/install/AssignOptionsToService.ds

© OSF Global Services, 2015. Tous droits réservés.                                                    Page 3
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                               Québec (Québec) G2K 1M1 – Canada
                                                                       Téléphone : +1 888 548-4344
                                                                                 www.osf-global.com

                           bm/install/CreateCPOption.ds
                           bm/install/CreateCPService.ds
                           bm/pricing_rules/CPAddPricingRule.ds
                           bm/pricing_rules/CPDeletePricingRule.ds
                           bm/pricing_rules/CPEditPricingRule.ds
                           bm/pricing_rules/CPUpdatePricingRule.ds
                           bm/pricing_rules/CPUpdateRuleProperty.ds
                           bm/CPGetMerchantRegistrationInfo.ds
                           bm/CPGetMerchantRegistrationToken.ds
                           bm/CPMerchantFormObject.ds
                           bm/CPProcessToCustomObjects.ds
                           bm/CPUpdateShippingMethods.ds
                           canadapost/callCPShippingServices.ds
                           lib/libCPUtils.ds
                           lib/libCPWSUtils.ds
                           returnlabels/CPCreateOpenReturnTemplate.ds
                           returnlabels/CPGetOpenReturnTemplate.ds
                           returnlabels/CPGetOpenReturnTemplateDetails.ds
                           returnlabels/CPGetOpenReturnTemplates.ds
                           returnlabels/CPRetrieveNextOpenReturnArtifact.ds
                           storefront/CPCreateShippingAddress.ds
                           storefront/CPDiscoverServices.ds
                           storefront/CPGetCurrencyConvertionRate.ds
                           storefront/CPGetExchangeRate.ds
                           storefront/CPGetNearestPostOffice.ds
                           storefront/CPGetOption.ds
                           storefront/CPGetOriginPostalCode.ds
                           storefront/CPGetPostOfficeDetail.ds
                           storefront/CPGetPostOfficeFeedback.ds
                           storefront/CPGetRates.ds
                           storefront/CPGetSelectedShippingMethod.ds
                           storefront/CPGetService.ds
                           storefront/CPGetTrackingDetails.ds
                           storefront/CPGetTrackingSummary.ds
                           storefront/CPSaveNearestPOAddress.ds
                           storefront/CPSaveNearestPOAddress1.ds
                        Données statiques
                           css/cp_main.css
                           css/cp_lang_switch.css
                           bm/js/cp.app.js
                           bm/js/jquery.cookie.js
                           bm/lib/jquery/jquery-1.9.1.min.js
                           bm/lib/jquery/jquery-ui-1.10.1.custom.js
                           js/cp.main.js
                           js/cp.main_sg1.js

© OSF Global Services, 2015. Tous droits réservés.                                          Page 4
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                               Québec (Québec) G2K 1M1 – Canada
                                                                       Téléphone : +1 888 548-4344
                                                                                 www.osf-global.com

                           js/handlebars-1.0.rc.1.min.js
                           js/jquery.storelocator.js
                           js/jquery.storelocator_sg1.js
                           storelocatortemplates/infowindow-description.isml
                           storelocatortemplates/location-list-description.isml
                           bm/images/cplogo.jpg
                           images/ajax-loader.gif
                           images/close-icon.png
                           images/cp-info-ok.png
                           images/cp-marker-blank.png
                           images/cp-marker.png
                           images/help_ico.gif
                           images/overlay-bg.png
                        Modèles
                           bm/cp_administrative_panel.isml
                           bm/cp_services.isml
                           bm/pricing_rules/cp_flatrate.isml
                           bm/pricing_rules/cp_free.isml
                           bm/pricing_rules/cp_inflatedeflate.isml
                           bm/pricing_rules/cp_json_response.isml
                           checkout/shipping/cp_discoverservices.isml
                           checkout/shipping/cp_get_basket_status.isml
                           checkout/shipping/cp_locations_error.isml
                           checkout/shipping/cp_locations_feedback.isml
                           checkout/shipping/cp_locations.isml
                           checkout/shipping/cp_nearestpo.isml
                           checkout/shipping/cp_office_detail.isml
                           checkout/shipping/cp_origin_post_code.isml
                           checkout/shipping/cp_right_column_sg1.isml
                           checkout/shipping/cp_right_column.isml
                           checkout/shipping/cp_save_cp_shipping_details.isml
                           checkout/shipping/cp_save_po_shipping_address.isml
                           checkout/shipping/cp_selected_shipping_method_json.isml
                           checkout/shipping/cp_serviceoption.isml
                           checkout/shipping/cp_serviceoptions.isml
                           checkout/shipping/cp_servicerates.isml
                           checkout/shipping/cp_shippingmethods.isml
                           checkout/tracking/cp_trackingsummary.isml
                           components/footer/canadapost_footer_sg1.isml
                           components/footer/canadapost_footer.isml
                           components/order/cp_orderdetails.isml
                           components/order/cp_orderdetailsemail.isml
                           resources/cp_appresources_sg1.isml
                           resources/cp_appresources.isml
                           resources/cp_bmresources.isml

© OSF Global Services, 2015. Tous droits réservés.                                          Page 5
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                            util/canadapost_errormessage.isml
                            util/canadapost_inputfield.isml
                            util/canadapost_modules.isml
                        Ressources
                            resources/canadapost_fr_CA.properties
                            resources/canadapost.properties
                        Références Web
                            artifact.xsd
                            authreturn.wsdl
                            authreturn.xsd
                            common.xsd
                            converter.wsdl
                            customerinfo.xsd
                            merchantregistration.wsdl
                            merchantregistration.xsd
                            openreturn.xsd
                            openreturn.wsdl
                            postoffice.wsdl
                            postoffice.xsd
                            rating.xsd
                            rating.wsdl
                            tracking.wsdl
                            tracking.xsd
                        Extensions personnalisées
                            bm_extensions.xml
                        Métadonnées
                            geolocations/Geolocations-ca.zip
                            meta/site-pref_CPConfigs.xml
                            meta/site-pref_CPOptions.xml
                            meta/site-pref_CPParcelCharacteristics.xml
                            meta/site-pref_CPPricingRules.xml
                            meta/site-pref_CPServices.xml

        2.3 Cas d’utilisation
        Le processus de livraison par Postes Canada est très facile à suivre pour les clients.

        Le module a modifié les avis de commande par courriel afin qu’ils affichent une section
        spéciale contenant les détails d’expédition que le client peut vouloir consulter au sujet
        de sa commande.

        Les cas d’utilisation ci-dessous décrivent le processus de livraison avec Postes Canada.

            1. Le client choisit un service d’expédition en fonction de son adresse
               personnelle.

© OSF Global Services, 2015. Tous droits réservés.                                                  Page 6
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                       Québec (Québec) G2K 1M1 – Canada
                                                                               Téléphone : +1 888 548-4344
                                                                                         www.osf-global.com

               a. Le client inscrit ou invité sélectionne des produits et passe à la page de
                  commande.
               b. Lorsque les détails d’expédition s’affichent, l’utilisateur peut sélectionner une
                  adresse déjà enregistrée ou fournir une nouvelle adresse.
               c. L’utilisateur choisit l’option de livraison par Postes Canada.
               d. Tous les services connexes apparaîtront dans une liste déroulante.
               e. L’utilisateur choisit un ou plusieurs services dans la liste affichée, générée par
                  les options sélectionnées par le commerçant dans Business Manager pour les
                  services en question.
               f. L’utilisateur peut cliquer sur Calculate Shipping Price pour afficher les frais de
                  livraison; il peut aussi plutôt cliquer directement sur Continue.
               g. Le client est redirigé vers la page de facturation, où il peut sélectionner le
                  mode de paiement qui lui convient.
               h. Le client transmet sa commande et les détails d’expédition (prix, adresse de
                  livraison, services sélectionnés).

            2. Le client transmet sa commande en ayant choisi l’option Free shipping
               service.
               a. Le commerçant crée une nouvelle règle de livraison gratuite pour un des
                  services d’expédition.
               b. L’utilisateur sélectionne des produits et passe à la page de commande.
               c. Lorsque les détails d’expédition s’affichent, l’utilisateur peut sélectionner une
                  adresse déjà enregistrée ou fournir une nouvelle adresse.
               d. L’utilisateur choisit Postes Canada dans la section d’expédition.
               e. Dans la liste des services, l’utilisateur voit s’afficher le service de livraison
                  gratuite établi par le commerçant par l’intermédiaire de la règle.
               f. Pour consulter les frais de livraison, il suffit de cliquer sur Calculate Shipping
                  Price, qui affichera 0.
               g. Le client est redirigé vers la page de facturation, où il peut sélectionner le
                  mode de paiement qui lui convient.
               h. Le client transmet sa commande et les détails d’expédition (prix, adresse de
                  livraison, services sélectionnés).

            3. Le client transmet la commande en ayant choisi l’option Deliver to
               Post Office.
               a. Le client sélectionne des produits et passe à la page de commande.
               b. Lorsque les détails d’expédition s’affichent, l’utilisateur peut sélectionner une
                  adresse déjà enregistrée ou fournir une nouvelle adresse.

© OSF Global Services, 2015. Tous droits réservés.                                                     Page 7
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                       Québec (Québec) G2K 1M1 – Canada
                                                                               Téléphone : +1 888 548-4344
                                                                                         www.osf-global.com

               c. L’utilisateur choisit l’option de livraison par Postes Canada dans la section
                  d’expédition.
               d. Il sélectionne le service qui lui convient dans la liste déroulante.
               e. Tous les services connexes s’affichent, et l’utilisateur sélectionne l’option
                  Deliver to Post Office s’il souhaite ramasser son colis à son bureau de poste.
               f. Le champ du code postal affiche le code postal de l’adresse fournie;
                  l’utilisateur peut sélectionner ou modifier ce code postal. Il suffit de cliquer sur
                  Show the Map pour afficher sur une carte et dans une liste les bureaux de
                  poste les plus proches du code postal entré.
               g. Le code postal entré sera considéré comme le lieu de livraison.
               h. L’utilisateur peut cliquer sur Calculate Shipping Price pour afficher les frais de
                  livraison; il peut aussi plutôt cliquer directement sur Continue.
               i. Le client est redirigé vers la page de facturation, où il peut sélectionner le
                  mode de paiement qui lui convient.
               j. Le client transmet sa commande et les détails d’expédition (prix, adresse de
                  livraison, services sélectionnés).
            4. Le client transmet sa commande en ayant choisi l’option Flat rate
               shipping.
               a. Le client sélectionne des produits et passe à la page de commande.
               b. Lorsque les détails d’expédition s’affichent, l’utilisateur peut sélectionner une
                    adresse déjà enregistrée ou fournir une nouvelle adresse.
               c. L’utilisateur choisit l’option de livraison par Postes Canada dans la section
                    d’expédition.
               d. Il sélectionne le service qui lui convient dans la liste déroulante.
               e. Le service choisi par l’utilisateur est assorti d’une règle attribuant un taux
                    fixe, établie et activée par le commerçant.
               f. Les frais qui s’affichent après avoir cliqué sur Calculate Shipping Price sont
                    ceux établis par le commerçant dans Business Manager.
               g. Le client est redirigé vers la page de facturation, où il peut sélectionner le
                    mode de paiement qui lui convient.
               h. Le client transmet sa commande et les détails d’expédition (prix, adresse de
                    livraison, services sélectionnés).

            5. Le client transmet sa commande en ayant choisi l’option Flexible rate
               shipping.
               a. Le client sélectionne des produits et passe à la page de commande.
               b. Lorsque les détails d’expédition s’affichent, l’utilisateur peut sélectionner une
                  adresse déjà enregistrée ou fournir une nouvelle adresse.

© OSF Global Services, 2015. Tous droits réservés.                                                    Page 8
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

               c. L’utilisateur choisit l’option de livraison par Postes Canada dans la section
                  d’expédition.
               d. Il sélectionne le service qui lui convient dans la liste déroulante.
               e. Le service choisi par l’utilisateur est assorti d’une règle de taux variable,
                  établie et activée par le commerçant.
               f. Les frais qui s’affichent après avoir cliqué sur Calculate Shipping Price sont
                  haussés ou abaissés, selon la règle établie par le commerçant.
               g. Le client est redirigé vers la page de facturation, où il peut sélectionner le
                  mode de paiement qui lui convient.
               h. Le client transmet sa commande et les détails d’expédition (prix, adresse de
                  livraison, services sélectionnés).
               Remarque : le client ne pourra pas voir que le taux a été haussé ou abaissé.

            6. Le client inscrit fait le suivi de sa commande.
               a. Le client se connecte sur le site Web du commerçant.
               b. Il a déjà soumis au moins UNE commande.
               c. Il clique sur Check Order pour faire le suivi d’une commande soumise.
               d. Une nouvelle page s’ouvre dans Order History, où toutes les commandes sont
                  affichées.
               e. Le client clique sur Order Details.
               f. Il entre le numéro de suivi et clique sur Track.
               g. Les détails d’expédition de la commande s’affichent.

            7. Le client invité fait le suivi de sa commande.
               a. Le client se connecte sur le site Web du commerçant.
               b. Il a déjà soumis au moins une commande.
               c. Il entre le numéro de la commande et le code postal de facturation et clique
                  sur Check Status.
               d. Une nouvelle page affiche les détails de la commande, et l’utilisateur peut y
                  saisir un numéro de suivi.
               e. Il entre le numéro de suivi et clique sur Track.

        2.4 Compatibilité

                Système fondé sur la version 13.5 de Demandware et mis à l’essai avec cette
                version. (Site Genesis 1 et 2)

        2.5 Limites et contraintes

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 9
OSF Integrator for Demandware and Canada Post - Guide d'intégration
6655, boul. Pierre Bertrand, bureau 240
                                                                        Québec (Québec) G2K 1M1 – Canada
                                                                                Téléphone : +1 888 548-4344
                                                                                          www.osf-global.com

              1. La liste d’inventaire des produits n’est pas liée aux magasins; les produits ne
                  sont pas nécessairement tous disponibles au magasin le plus près, et c’est
                  pourquoi le code postal du centre de distribution aux fins d’expédition peut
                  être utilisé s’il s’avère que la plupart des produits s’y trouvent (la fonction
                  permettant de lier la liste d’inventaire aux magasins pourrait être intégrée à
                  une version ultérieure).
              2. La liste des bureaux de poste les plus près n’est fondée que sur le code postal
                  fourni (l’adresse complète n’est pas encore prise en considération dans la
                  recherche des bureaux de poste à proximité).
              3. Le mode d’expéditions multiples offert avec la version SG 13.3 n’est pas pris en
                  charge par la version actuelle du module.
              4. Date de livraison prévue – dans le cas d’une commande comptant des articles
                  dont la disponibilité diffère (p. ex., commande avec article en stock et article
                  en rupture de stock), une seule date de livraison (la plus éloignée) est fournie.
              5. Date de livraison prévue – cette fonction s’applique presque exclusivement aux
                  livraisons au Canada.
              6. Options inactives dans la fenêtre d’administration du commerçant – ces
                  options peuvent être personnalisées, compte tenu de leur moindre incidence
                  dans le commerce électronique.
              7. Les options de signature et de confirmation de l’identité (signature et preuve
                  d’âge – 18 ans ou 19 ans) peuvent être assorties de frais supplémentaires, et il
                  faut que le commerçant en tienne compte dans le taux, s’il applique une
                  politique de livraison au taux réel. Ces options ne devraient pas être utilisées si
                  le commerçant applique des règles d’application de tarifs spéciaux (p. ex., taux
                  fixe, livraison gratuite).
              8. Tarifs spéciaux – on ne peut appliquer à un service qu’une seule règle à la fois
                  (soit un taux fixe, une livraison gratuite ou un taux variable).
              9. Tarifs spéciaux – on ne peut appliquer aux services multiples qu’un seul taux
                  fixe à la fois, ou encore la livraison gratuite (p. ex., si le taux fixe Priority est
                  activé, il est impossible d’activer aussi le taux fixe Xpresspost).
              10. Taux fixes – cette option est actuellement offerte pour les livraisons au
                  Canada. Cette option est modifiable pour les livraisons aux États-Unis et
                  ailleurs dans le monde.
              11. Livraison gratuite – cette option est actuellement offerte pour les livraisons au
                  Canada. Cette option est modifiable pour les livraisons aux États-Unis et
                  ailleurs dans le monde.
              12. L’option Delivery to Post office n’est offerte que pour les livraisons au Canada.

© OSF Global Services, 2015. Tous droits réservés.                                                    Page 10
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

            3. Guide d’implémentation

        3.1 Installation
        3.1.1 Survol
               Trois fichiers seront fournis au commerçant.

                               Le module d’extension sera installé en format archivé et configuré
                                à partir d’UX Studio (Eclipse).
                               Le fichier de configuration en format XML sera importé et installé
                                dans l’interface Business Manager.
                               La documentation (renseignements sur l’intégration) en format
                                PDF/Word décrit les étapes d’installation et d’intégration du
                                module et du fichier de configuration.

        3.1.2 Importation des métadonnées pour le module de Postes Canada
            1. Allez à « Business Manager -> Administration ->Site Development -> Import &
               Export » et sélectionnez « Upload » dans la section « Import & Export Files ».

            2. Dans « Upload Import Files », choisissez le fichier « site-pref_CPConfigs.xml »
               qui accompagne le module.

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 11
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

            3.   Téléchargez le fichier.

            4.   Répétez les étapes 2 et 3 pour les fichiers « site-pref_CPOptions.xml », « site-
                 pref_CPPricingRules.xml », « site-pref_CPServices.xml » et « Geolocations-
                 ca.zip » qui viennent avec le module.

            5. Une fois les fichiers téléchargés et prêts à être utilisés, retournez à « Business
               Manager -> Administration -> Site Development -> Import & Export » et
               sélectionnez « Import » dans la section « Meta Data ».

            6.   Sélectionnez « site-pref_CPConfigs.xml » et cliquez sur Next.

© OSF Global Services, 2015. Tous droits réservés.                                                  Page 12
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

            7.   Le fichier des préférences devra être validé pour pouvoir être importé dans
                 votre système.

            8. Une fois le fichier validé, les préférences peuvent être importées dans le
               système. Cliquez sur Import.

            9. Répétez les étapes 5 à 8 pour les fichiers « site-pref_CPOptions.xml », « site-
               pref_CPPricingRules.xml » et « site-pref_CPServices.xml ».
            10. Une fois les préférences bien installées, retournez à « Business Manager ->
               Administration -> Site Development -> Import & Export » et sélectionnez
               « Import » dans la section « Geolocation ».

© OSF Global Services, 2015. Tous droits réservés.                                               Page 13
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

            11. Sélectionnez « Geolocation-ca.xml » et cliquez sur Next.

            12. Attendez que la validation du schéma XML soit terminée.

            13. Le fichier est maintenant validé, et les données « Geolocations » peuvent être
               importées dans le système. Cliquez sur Import.

                        13. L’installation des données « Geolocations » est réussie.

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 14
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

        3.1.3 Installation du module
               Suivez les étapes ci-dessous pour importer le module.

                  1. Sélectionnez la connexion au serveur DW -> Import.

                 2. Sélectionnez l’option « Existing Project into Workspace ».

                 3. « Import Projects -> Select archive file » (ou « root directory »), si vous
                    avez déjà décompressé le module.

© OSF Global Services, 2015. Tous droits réservés.                                                Page 15
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                 4.    Sélectionnez l’archive depuis votre source locale (ou le module
                      décompressé).

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 16
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                 5.   Cliquez sur Finish et sur Yes pour terminer l’importation.

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 17
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                 6. Une fois ces étapes terminées, le module est ajouté à votre projet et vous
                    devez vous assurer qu’il figure aussi dans Project References.

© OSF Global Services, 2015. Tous droits réservés.                                               Page 18
6655, boul. Pierre Bertrand, bureau 240
                                                                       Québec (Québec) G2K 1M1 – Canada
                                                                               Téléphone : +1 888 548-4344
                                                                                         www.osf-global.com

                 7. Ensuite, allez à « Business Manager -> Manage Sites -> Your Site ->
                    Settings » et ajoutez le module « int_canadapost » au chemin d’accès des
                    modules, devant le module de votre vitrine virtuelle.

                 8. Afin de vérifier si le module a été ajouté à la version active à jour, allez à
                    « Business Manager -> Administration -> Code Deployment ».

        Une fois toutes ces étapes terminées, le module est bien installé et est prêt à être
        utilisé.

        3.1.4 Configuration de la tâche « Update Shipping Methods »
               Afin de créer et de configurer correctement la tâche « Update Shipping
        Methods », vous devez aller à « Business Manager -> Administration -> Operations ->
        Job Schedules -> New » (pour créer une nouvelle tâche) et suivre les étapes suivantes.

                       Dans l’onglet général, saisissez le nom de la tâche – Update Shipping
                        Methods – et activez-la.
                       Sélectionnez Sites dans le champ Execution Scope.
                       Choisissez le pipeline CPSShipping Methods, qui exécutera une tâche.
                       Sélectionnez UpdateShippinMethods comme nœud de départ.
                       Exécutez la tâche.

© OSF Global Services, 2015. Tous droits réservés.                                                   Page 19
6655, boul. Pierre Bertrand, bureau 240
                                                                       Québec (Québec) G2K 1M1 – Canada
                                                                               Téléphone : +1 888 548-4344
                                                                                         www.osf-global.com

                    Allez à « Business Manager ->  -> Custom Objects ->
                    Custom Object Editor ».

              Sélectionnez CPServices for Object Type et cliquez sur Find : Vous devriez voir 20
        éléments.

                Si vous en voyez moins que 20 dans la liste (p. ex., seulement 17) :

                1. cliquez sur le lien « Show All itmes » dans la barre de pagination;
                2. cliquez sur le lien « Select All » dans l’en-tête afin que les 17 cases soient
                   cochées;
                3. cliquez sur « Delete »;
                4. cliquez sur « Yes » lorsqu’on vous demande « Are you sure that you want to
                   delete these items? »;
                5. relancez la tâche « Update Shipping Methods ».

                Sélectionnez CPOptions et cliquez sur Find. Vous devriez voir 122 éléments.

                Si vous en voyez moins que 122 dans la liste (p. ex., seulement 120) :

                1. cliquez sur le lien « Show All itmes » dans la barre de pagination;
                2. cliquez sur le lien « Select All » dans l’en-tête afin que les 120 cases soient
                   cochées;
                3. cliquez sur « Delete »;
                4. cliquez sur « Yes » lorsqu’on vous demande « Are you sure that you want to
                   delete these items? »;
                5. relancez la tâche « Update Shipping Methods ».

© OSF Global Services, 2015. Tous droits réservés.                                                   Page 20
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                       Dans l’onglet Sites, sélectionnez le site pour lequel vous voulez exécuter
                        la tâche.

        3.2 Configuration

               Afin que la configuration soit adéquate, vous devez suivre les étapes suivantes.
            1. Allez à « Business Manager ->Ordering -> Shipping Methods -> New-> Canada
               Post Shipping ». Postes Canada est ajouté comme nouveau service d’expédition,
               et aucune configuration supplémentaire n’est requise.

© OSF Global Services, 2015. Tous droits réservés.                                                   Page 21
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

            2. Allez à « Business Manager->User Profile » pour choisir la langue de préférence.

                   Le module comprend les fichiers correspondant aux langues anglaise et
                    française.
                   Les étiquettes et les messages du module changeront en fonction de la
                    langue de préférence du commerçant.

            3. Allez à « Business Manager ->Administration ->Organization ->Roles &
               Permissions ».
               a) Choisissez le rôle Administrator.
               b) Sélectionnez l’onglet Business Manager Modules.
               c) Choisissez le site de Postes Canada dans la liste déroulante Select Context.
               d) Cliquez sur Apply.

© OSF Global Services, 2015. Tous droits réservés.                                                Page 22
6655, boul. Pierre Bertrand, bureau 240
                                                                 Québec (Québec) G2K 1M1 – Canada
                                                                         Téléphone : +1 888 548-4344
                                                                                   www.osf-global.com

                e) Cochez la case du module Canada Post Shipping ->Merchant Administrative
                   Panel et cliquez sur Update.

            4. Allez à Business Manager -> Canada Post site -> Canada Post Shipping ->
               Merchant Administrative Panel.

© OSF Global Services, 2015. Tous droits réservés.                                            Page 23
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

        La plateforme est divisée en sept sections pour optimaliser la structuration.

            a. S’il clique sur le bouton Register, le commerçant est inscrit au nom de la
               plateforme (OSF), et le champ « Merchant Registration Data » est
               automatiquement rempli.
                o Dans « Shipping Method ID », on retrouve les renseignements généraux
                      fournis dans la section « Business Manager -> Ordering -> Shipping
                      Methods », qui peuvent différer d’un site à l’autre; le commerçant les
                      ajoutera manuellement, et le module s’en servira comme identifiant.
                o « GUI Shipping Method List ID » est l’identifiant de l’élément HTML de la
                      page de commande dans laquelle les services d’expédition sont affichés.
                      Remarque importante
                    - Dans le cas de SiteGenesis 1, la chaîne doit être « shippingmethodform ».

© OSF Global Services, 2015. Tous droits réservés.                                                Page 24
6655, boul. Pierre Bertrand, bureau 240
                                                                       Québec (Québec) G2K 1M1 – Canada
                                                                               Téléphone : +1 888 548-4344
                                                                                         www.osf-global.com

                    -   Dans le cas de SiteGenesis 2, la chaîne doit être « shipping-method-list ».

                 o La période de gestion des commandes renvoie au nombre de jours requis
                   pour que le colis passe de l’entrepôt aux installations de Postes Canada aux
                   fins de livraison.

            b. La section « Shipping Services » comprend tous les services de livraison offerts,
               par destination (Canada, États-Unis, ailleurs dans le monde).
                   o Le commerçant peut choisir parmi les services offerts en fonction des
                       exigences de chaque site en cochant ou en décochant une case.
                   o Il peut également choisir les services de livraison qui seront offerts aux
                       clients.
                   o Une seule des options Proof of Age Required – 18 et Proof of Age
                       Required – 19 doit être sélectionnée.
                   o Certains services offerts par Postes Canada sont gratuits, tandis que
                       d’autres comportent un supplément. Actuellement, les services gratuits
                       sont les suivants. Livrer au bureau de poste, Laisser à la porte (pas
                       d’avis), Ne pas laisser en lieu sûr et Carte Retenue pour ramassage. Le
                       commerçant peut choisir d’afficher ces services en tout temps dans la
                       vitrine virtuelle. Les autres services avec supplément devraient être
                       activés lorsqu’il s’agit de frais de livraison standard. Veuillez communiquer
                       avec Postes Canada pour obtenir de plus amples renseignements sur les
                       tarifs des services payants.
                   o Certaines règles de compatibilité s’appliquent aux options de service
                       (p. ex., si l’option Signature est sélectionnée, le service Laisser à la porte
                       (pas d’avis) ne peut être sélectionné). Ces règles sont régies par les
                       politiques de Postes Canada.
            c. La section « Parcel Characteristics » comprend une série d’options pour les colis.
               o Le poids du colis (par défaut) peut être utilisé dans les cas suivants :
                        le commerçant vend un ensemble de produits de faible poids (p. ex.,
                            vitamines, médicaments), et le poids du colis peut être prévu à
                            l’avance ou risque peu de dépasser une certaine valeur;
                        le commerçant utilise ce module aux fins d’essais seulement; il n’est
                            pas nécessaire de configurer le poids de chaque produit;
                        situation d’urgence – le poids du produit ne peut être connu
                            rapidement en raison de circonstances inattendues.

© OSF Global Services, 2015. Tous droits réservés.                                                  Page 25
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                        Remarque : si le poids du produit n’est pas établi dans Business
                        Manager, les frais de livraison seront calculés en fonction du poids du
                        colis.

                o  Attribut du poids du produit :
                        Demandware n’a pas d’attribut intégré pour le poids des produits.
                        En raison du cas susmentionné, cet attribut peut être différent d’un
                            commerçant à l’autre.
                        Notre application doit connaître les attributs utilisés par chaque
                            commerçant pour le poids des produits.
               o Unité de mesure pour le poids du colis et unité de mesure pour le poids du
                   produit :
                        choisissez les kilogrammes (kg) ou les livres (lb).
            d. La section « Shipping Config Data » comprend les paramètres suivants :
               o « Shipping Method Id » – numéro du service d’expédition de Postes Canada
                   configuré par le commerçant;
               o « Shipping Distribution Center » – magasin utilisée par défaut pour calculer
                   les frais de livraison, dans le cas où le système ne parvient pas fournir le
                   magasin du commerçant le plus près;
               o « Fulfilment Days » – période de gestion des commandes, soit le nombre de
                   jours requis pour que le colis passe du magasin du commerçant aux
                   installations de Postes Canada;
               o « GUI Shipping MEthod List ID » – identifiant de l’élément HTML de la page
                   de commande où s’affichent les modes d’expédition.
            e. La section « Deliver to Post Office » ressemble au service du même nom et
               comprend les paramètres suivants :
               o « Maximum Number of Retrieved Offices » – nombre maximal de bureaux de
                   poste retenus dans la région demandée par le client;
               o « Google Map Zoom Level » – paramètre servant à établir le zoom par
                   défaut de la carte Google montrant les bureaux de poste les plus près.
            f. La section « Pricing » est l’espace de gestion des taux fixes, des taux variables
               et de la livraison gratuite.
               o « Flat rates »
                        Le commerçant peut offrir un taux fixe pour chacun des services de
                          Postes Canada.
               o « Flexible rates »
                        Le commerçant peut hausser ou abaisser le taux de Postes Canada, par
                          pourcentage ou par montant fixe.
               o « Free shipping »

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 26
6655, boul. Pierre Bertrand, bureau 240
                                                                   Québec (Québec) G2K 1M1 – Canada
                                                                           Téléphone : +1 888 548-4344
                                                                                     www.osf-global.com

                         Le commerçant peut offrir la livraison gratuite pour les commandes
                          dépassant un montant donné.
            g. La section « Tracking » compte ce qui suit.
               o « Tracking Summary » – espace de suivi des commandes qui affiche l’état de
                   la livraison directement sur le site Web du commerçant.

        3.3 Code de personnalisation

        3.3.1 Code de personnalisation pour SiteGenesis 1

        3.3.1.1 Code de personnalisation ajouté au noyau de la vitrine virtuelle
        Formulaires

                   o Formulaire pour livraison unique : singleshipping.xml. Ajoutez le code
                     suivant :
                        
                        après
                        
© OSF Global Services, 2015. Tous droits réservés.                                              Page 27
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

         o   Formulaire pour suivi de commande : ordertrack.xml.
                Les utilisateurs non inscrits qui veulent voir les détails d’une commande doivent
                inscrire le numéro de la commande et le code postal (fonction Demandware par
                défaut). Pour que cela fonctionne avec un code postal canadien,vous devez
                remplacer l’attribut regexp de l’objet formfield « postalCode » du formulaire
                ordertrack.xml par :
                        (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVWXYZabc
                        eghjklmnprstvxy](
                        )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                        \d{4})?$)

         o   Formulaire pour adresse de livraison : billingaddress.xml.
                         Pour que cela fonctionne avec un code postal canadien,vous devez
                         remplacer l’attribut regexp de l’objet formfield « zip » du formulaire
                         shippingaddress.xml par :
                               (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVW
                               XYZabceghjklmnprstvxy](
                               )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                               \d{4})?$)

         o   Formulaire pour adresse de facturation : billingaddress.xml.

© OSF Global Services, 2015. Tous droits réservés.                                                Page 28
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                           Pour que cela fonctionne avec un code postal canadien,vous devez
                           remplacer regexp de l’objet formfield « zip » du formulaire
                           billingaddress.xml par :
                               (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVW
                               XYZabceghjklmnprstvxy](
                               )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                               \d{4})?$)

        Pipelines

         o   Ajoutez le pipeline Resources.xml :
                  Ajoutez un fichier Resources.xml dans cartridge/pipelines et ajoutez le
                  contenu ci-dessous au fichier :

© OSF Global Services, 2015. Tous droits réservés.                                               Page 29
6655, boul. Pierre Bertrand, bureau 240
                                                                   Québec (Québec) G2K 1M1 – Canada
                                                                           Téléphone : +1 888 548-4344
                                                                                     www.osf-global.com

© OSF Global Services, 2015. Tous droits réservés.                                              Page 30
6655, boul. Pierre Bertrand, bureau 240
                                                                        Québec (Québec) G2K 1M1 – Canada
                                                                                Téléphone : +1 888 548-4344
                                                                                          www.osf-global.com

                                           Resource Template

                            Le pipeline devrait ressembler à l’illustration ci-dessous.

         o   Pipeline OnSession.xml.
                      Ajoutez le nœud de script (non transactionnel) ci-dessous.
                     Fichier script : int_canadapost:canadapost/callCPShippingServices.ds.

© OSF Global Services, 2015. Tous droits réservés.                                                   Page 31
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

               o    Pipeline Ordre-History dans Order.xml
                       Pour les utilisateurs inscrits, ajoutez le nœud d’appel juste après le
                          modèle orderdetails.isml.

               o    Pipeline Ordre-Find dans Order.xml

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 32
6655, boul. Pierre Bertrand, bureau 240
                                                                         Québec (Québec) G2K 1M1 – Canada
                                                                                 Téléphone : +1 888 548-4344
                                                                                           www.osf-global.com

                           Pour les utilisateurs non inscrits, ajoutez le nœud d’appel juste avant le
                            nœud d’extrémité « ok ».

        Scripts

               o    Script Calculate Cart : cart\CalculateCart.ds
                       Ajoutez le code ci-dessous après la fin des données d’importation du
                          cadre de DW.
                           importScript( "int_canadapost:lib/libCPUtils.ds" );

                          Ajoutez le code suivant :
                          var cpShippingSrv = new CPShippingServices();

© OSF Global Services, 2015. Tous droits réservés.                                                       Page 33
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                        cpShippingSrv.SetCPShippingPrice(basket);

                        Après le bloc de code CALCULATE SHIPPING COSTS
                        ShippingMgr.applyShippingCost(basket);

               o    Obtenez le script « applicable shipping methods » :
                    checkout\GetApplicableShippingMethods.ds
                    o Ajoutez le code ci-dessous après la fin des données d’importation du
                       cadre de DW.
                        importScript( "int_canadapost:lib/libCPUtils.ds" );

                    o   Ajoutez le code suivant :
                        var cpShippingSrv = new CPShippingServices();

                        cpShippingSrv.CheckCPApplicable(countryCode, ret, basket);

                        Après le bloc de code
                        // Retrieve the list of applicabnle shipping methods for the given
                        shipment and address.

                        var shippingModel : ShipmentShippingModel =
                        ShippingMgr.getShipmentShippingModel(shipment);

                        var ret : Collection = new ArrayList();

© OSF Global Services, 2015. Tous droits réservés.                                               Page 34
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                        ret = shippingModel.getApplicableShippingMethods(addressObj);

        Afin de mettre à l’essai la fonction Tracking Summary, vous devez changer les clés de
        l’API. Pour ce faire, changez la valeur du drapeau « productionEnvironment » pour faux
        dans libCPWSUtils.ds, ligne 13. Assurez-vous de remettre la valeur du drapeau
        « productionEnvironment » à vrai après la mise à l’essai.

        Modèles

                    o   Modèle pour en-tête : components/header/htmlhead.isml
                        Ajoutez le code suivant :
                                [DW#CanadaPostShipping#HtmlHead] 

                                [Demo@CanadaPostDemo@HtmlHead] 

                        après l’élément
                               THIRD PARTY STYLESHEETS STYLING

                    o   Modèle pour bas de page : components/footer/footer.isml
                        Ajoutez les lignes suivantes à la fin :

                                [DW#CanadaPostShipping#Footer] Include Canada
                               Post Footer

                    o   Modèle pour livraison unique : checkout\shipping\singleshipping.isml

© OSF Global Services, 2015. Tous droits réservés.                                               Page 35
6655, boul. Pierre Bertrand, bureau 240
                                                                   Québec (Québec) G2K 1M1 – Canada
                                                                           Téléphone : +1 888 548-4344
                                                                                     www.osf-global.com

                        Ajoutez le code suivant :
                        [#CanadaPostShipping#] Add Canada Post Shipping Methods
                        Content

                        après l’élément
                        
                        Ajoutez aussi le code suivant :
                        $("#dwfrm_singleshipping_shippingAddress
                        input[name$=‘_addressFields_zip’]").trigger(‘cpcustomchange’);

                        après le code autour de la ligne 370 :

                                // activate the tooltips in the newly loaded AJAX section
                                app.tooltipDefault();

                    o   Modèle pour détails de commande : components\order\orderdetails.isml
                        Insérez le code suivant :
                        [DW#CanadaPostShipping#OrderDetails] Display Canada
                        Post shipment details

                        après répétition en boucle du code shipment.productLineItems

© OSF Global Services, 2015. Tous droits réservés.                                              Page 36
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                    o   Modèle pour mini-résumé : checkout/minisummary.isml
                        Supprimez les lignes :

                                et

                        près du code de la ligne 51 :

                    o   Modèle pour mini-info de facturation : checkout/billing/minibillinginfo.isml
                        Ajoutez le code suivant :
                                [DW#CanadaPostShipping#Checkout] Display Post
                                Office Address on right sidebar of checkout
                                pages

                        avant
                                
                        vers la ligne 10

        3.3.2 Code de personnalisation pour SiteGenesis 2

        3.3.2.1 Code de personnalisation ajouté au noyau de la vitrine virtuelle
        Formulaires

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 37
6655, boul. Pierre Bertrand, bureau 240
                                                                   Québec (Québec) G2K 1M1 – Canada
                                                                           Téléphone : +1 888 548-4344
                                                                                     www.osf-global.com

                   o Formulaire pour livraison unique : singleshipping.xml. Ajoutez le code
                     suivant :
                        
                        après
                        
         o   Formulaire pour suivi de commande : ordertrack.xml.

© OSF Global Services, 2015. Tous droits réservés.                                              Page 38
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

                           Les utilisateurs non inscrits qui veulent voir les détails d’une
                           commande doivent inscrire le numéro de la commande et le code
                           postal (fonction Demandware par défaut). Pour que cela fonctionne
                           avec un code postal canadien,vous devez remplacer l’attribut regexp
                           de l’objet formfield « postalCode » du formulaire ordertrack.xml par :
                               (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVW
                               XYZabceghjklmnprstvxy](
                               )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                               \d{4})?$)

         o   Formulaire pour adresse de livraison : shippingaddress.xml.
                         Pour que cela fonctionne avec un code postal canadien,vous devez
                         remplacer l’attribut regexp de l’objet formfield « zip » du formulaire
                         shippingaddress.xml par :
                           (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVWXYZ
                           abceghjklmnprstvxy](
                           )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                           \d{4})?$)

         o   Formulaire pour adresse de facturation : billingaddress.xml.
                         Pour que cela fonctionne avec un code postal canadien,vous devez
                         remplacer regexp de l’objet formfield « zip » du formulaire
                         billingaddress.xml par :
                               (^[ABCEGHJKLMNPRSTVXYabceghjklmnprstvxy]\d[ABCEGHJKLMNPRSTVW
                               XYZabceghjklmnprstvxy](
                               )?\d[ABCEGHJKLMNPRSTVWXYZabceghjklmnprstvxy]\d$)|(^\d{5}(-
                               \d{4})?$)

        Pipelines

               o    Pipeline OnSession.xml.
                       Ajoutez le nœud de script (non transactionnel) ci-dessous.
                        Fichier script : int_canadapost:canadapost/callCPShippingServices.ds.

© OSF Global Services, 2015. Tous droits réservés.                                                  Page 39
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

               o    Pipeline Ordre-History dans Order.xml
                       Pour les utilisateurs inscrits, ajoutez le nœud d’appel juste après le
                          modèle orderdetails.isml dans le pipeline History.

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 40
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

               o    Pipeline Ordre-Find dans Order.xml
                       Pour les utilisateurs non inscrits, ajoutez le nœud d’appel juste avant le
                          nœud d’extrémité « ok ».

        Scripts

               o    Script Calculate Cart : cart\CalculateCart.ds
                       Ajoutez le code ci-dessous après la fin des données d’importation du
                          cadre de DW.
                        importScript( "int_canadapost:lib/libCPUtils.ds" );

                        Ajoutez le code suivant :
                        var cpShippingSrv = new CPShippingServices();

© OSF Global Services, 2015. Tous droits réservés.                                                   Page 41
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                        cpShippingSrv.SetCPShippingPrice(basket);

                        Après le bloc de code CALCULATE SHIPPING COSTS
                        ShippingMgr.applyShippingCost(basket);

               o    Obtenez le script « applicable shipping methods » :
                    checkout\GetApplicableShippingMethods.ds
                    o Ajoutez le code ci-dessous après la fin des données d’importation du
                       cadre de DW.
                        importScript( "int_canadapost:lib/libCPUtils.ds" );

                    o   Ajoutez le code suivant :
                        var cpShippingSrv = new CPShippingServices();

                        cpShippingSrv.CheckCPApplicable(countryCode, ret, basket);

                        Après le bloc de code
                        // Retrieve the list of applicabnle shipping methods for the given
                        shipment and address.

                        var shippingModel : ShipmentShippingModel =
                        ShippingMgr.getShipmentShippingModel(shipment);

                        var ret : Collection = new ArrayList();

© OSF Global Services, 2015. Tous droits réservés.                                               Page 42
6655, boul. Pierre Bertrand, bureau 240
                                                                     Québec (Québec) G2K 1M1 – Canada
                                                                             Téléphone : +1 888 548-4344
                                                                                       www.osf-global.com

                        ret = shippingModel.getApplicableShippingMethods(addressObj);

                    o   Afin de mettre à l’essai la fonction Tracking Summary, vous devez
                        changer les clés de l’API. Pour ce faire, changez la valeur du drapeau
                        « productionEnvironment » pour faux dans libCPWSUtils.ds, ligne 13.
                        Assurez-vous de remettre la valeur du drapeau
                        « productionEnvironment » à vrai après la mise à l’essai. Omettez cette
                        étape si vous installez le module d’extension pour la première fois.

        Modèles

                    o   Modèle pour en-tête : components/header/htmlhead.isml
                        Ajoutez le code suivant :
                                [DW#CanadaPostShipping#HtmlHead] 

                                [Demo@CanadaPostDemo@HtmlHead] 

                        après l’élément
                               STYLE SHEETS ARE PLACED HERE SO THAT jQuery,
                               Power Review and other RichUI styles do not overwrite the
                               definitions below.

                    o   Modèle pour livraison unique : checkout\shipping\singleshipping.isml
                        Ajoutez le code suivant :
                        [#CanadaPostShipping#] Add Canada Post Shipping Methods
                        Content

© OSF Global Services, 2015. Tous droits réservés.                                                Page 43
6655, boul. Pierre Bertrand, bureau 240
                                                                    Québec (Québec) G2K 1M1 – Canada
                                                                            Téléphone : +1 888 548-4344
                                                                                      www.osf-global.com

                        après le bloc
                                
                    o   Modèle pour détails de commande : components\order\orderdetails.isml
                        Insérez le code suivant :
                        [DW#CanadaPostShipping#OrderDetails] Display Canada
                        Post shipment details

                        après répétition en boucle du code shipment.productLineItems
                        
© OSF Global Services, 2015. Tous droits réservés.                                               Page 44
6655, boul. Pierre Bertrand, bureau 240
                                                                      Québec (Québec) G2K 1M1 – Canada
                                                                              Téléphone : +1 888 548-4344
                                                                                        www.osf-global.com

                    o   Modèle pour courriel de détails de commande :
                        components\order\orderdetailsemail.isml
                        Insérez le code suivant :
                        [DW#CanadaPostShipping#OrderDetails] Display Canada
                        Post shipment details

                        après répétition en boucle du code shipment.productLineItems
                        
                    o   Modèle pour mini-info de facturation : checkout/billing/minibillinginfo.isml
                        Ajoutez le code suivant :
                                 [DW#CanadaPostShipping#Checkout] Display Post
                                 Office Address on right sidebar of checkout
                                 pages

                        avant
                                 
                        vers la ligne 10

        3.3.2.2 Code de personnalisation ajouté à storefront_richUI
        Modèles

© OSF Global Services, 2015. Tous droits réservés.                                                 Page 45
Vous pouvez aussi lire