Home

Here

1. eeeee eere eere 27 Positioning of the field RR 27 Making the field Mandatory ccccccsssccccccssseccccceesecccccueseccesseusececsaueeecessueueceesseeueeeessuaneeeessaaaeees 28 Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 2 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 1 Module modifications The following modifications have been introduced into the module Version Change BUGFIX Weight parameter is now correctly transferred BUGFIX removal of space in front of lt php tag BUGFIX An issue with CDN and resource URL s is fixed BUGFIX In case no shipping method is required virtual B th ipt pop up is not shown Magento exceptions is altered settings e g free shipping coupon codes or free shipping COMPABILITY the bpost Shipping manager is now compatible with the one step checkout module CHANGE It is now possible to toggle to show or don t show the bpost logo in the address fields step CHANGE Added description to adapt the address fields in order to correctly send through address fields to the pop up COMPABILITY The module is now compatible with Magento 1 7 Confidential Copyright 2011 by bpost All rights reserved Version 4
2. 5 3 6 Shippingcost rules The shipping costs can be calculated and configured in both Magento and the bpost Shipping Manager back end Because this can lead to misunderstandings we will leave the option to the administrator which environment will calculate the shipment cost Configuring the shipping rules within Magento has the advantage that you can give a quote to customers before they have selected a shipping method Adding the business logic for the calculation of the shipping costs is based on the generation of a specific string Please use following rules when creating the string e Open and close with curly braces 4 e There are 2 parameters enclosed by double quotes and divided by a semi column e The first parameter is the name of the shipping method The correct name can be found in the selection box of the shipping method parameter e The second parameter is the configuration of the price for this shipping method e The shipping methods are divided by a comma Allowed bpost shipping methods STORE VIE H Select the shipping options that you would like to appear to the customer as an option Shippingcost rules BPACK bpost 12 BPACK home 0 STORE VIEW BPACK 24 7 0 2 90 0 5 4 50 5 8 1 j 4 4 Image 10 Shippingcost rules The following configuration settings for the cost calculation are available e Shipping Manager decides the shipping quote e Magento
3. bpost shipping manager Magento module User manual Version 4 1 0 Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 1 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost Table of Contents 1 Module modifications useesissasexeueksaue usa XyE xxu FERAM Rd iE SE EE VERE ER ER FEEEF EE PAR 3 2 GIOSSOIY Of ENTIRE 4 3 o eoe 5 3 1 Required KHOWIledge scisco ree SexE eva EXE VE FEN FEPAR ER Vo Sa VO REIN E SPA EsEA EVEN E PATCH E MEN VENE CERES 5 A2 CODDAOUDDI D aera e aE mye en TIONEM FEIN eT a er ry errr 5 3 3 When upgrading from earlier versions ccscscsccscssessccscscecsccscsceccccscscsceccccsces 6 3 4 Recommended Magento code modifications eee eee eren 6 bpost Shipping Manager solution eee eene eene eene nennen nete eere teen un 7 4 1 1 On i en r 7 4 1 2 Bo E E m 7 Magento module seesesessesesoesesoscesoscesescesosceoesoecesoeoesoscoesosoesosoesosoesesoeseeoesee 9 5 1 Before installation oesesesesessececesesescscececesescececesesesoecececesescececesesesoscecessseeee 9 MEN ile RETE E EAT 9 5 3 Configuration eseseseseseecececesescecececesesoscececeseecececesesesoscececesescececeseseseececesseeeee 9
4. 5 Coniguration ofthe Mod le erasokorrean aaa iaa a 9 5 3 2 account ID and passphrase sseesssssssssseeeseeeennn nennen nennen nnne nnns sna nnns nnns 12 5 3 3 RECUR 13 5 3 4 Error COE METCRRNEONK RE MTMTMAM 13 5 3 5 Available shipping methodsS sssessssseresssseressreerssssecesssrcrossareresssrcesssseceeserecosssreressseereso 14 5 3 6 Shippingcost rules sscccscdavcsaiadeiessindesasascdaacecindsdndcdedasasacciateesiedssavasedatabetsdeaaseasanineaisdenesiae s 15 5 3 7 Exclude shipping method on product sexi oi teet reti xar Ea SUE PUE CH reg rud EHI PN REPE ERES 17 5 4 Front end integration ccscscscscscscscsccccccccccccccecececscscscscscscscecesscscescscsceceees 19 DONNEES Net 19 5 4 2 Consumer selects delivery method sees eene nnne nnns 19 5 4 3 Order CONTIFOIEUON TT TK 21 5 5 Adding track amp trace to orders eee eee eee eee eene eene enero nnns 22 D ADDOHUDO un sissiveqiinRUFUMRSEIVERFEREERKARAPIEFIA EE aE T IX RP EM FI CRIT DIEPIIM RIPE 26 6 1 Roles ANG Access FIP ls osse i rExXESa Vu Exe s Sh E Vos En A E I QUI E VUDL OF INI Dr S VERE ME Yd 26 O2 earum 26 SAMEDI 26 6 4 Supported versions of MAaGentO ccccsccccccscsceccccscscsccccccscsceccccscsceccccscscesess 26 6 5 Installation upgrades via Magento Connect esee eene nnn nnns 26 6 6 Sending full address fields to bpost
5. Add the label for the street number field 5 Surround each field and its according label with a div which has the field class 6 Change the string in the label and the title of the number field to print out Number this can be translated later to your language 7 Change the id s of the field to billing street2 8 Change the value of the field to fetch the value of the 2d street line lt php echo this gt htmlEscape this gt getAddress gt getStreet 2 Repeat these steps in the template checkout onepage shipping phtml file for the shipping address The finetuning in positioning and width of the fields depends on your theme and needs to be done via CSS Making the field mandatory To make the field mandatory we will add the required entry CSS class to the field 60 61 62 63 zhp echo S this htmlEscape 5this getAddress getStreet 1 class input text required entry 64 65 66 67 68 69 Sthis gt htmlEscape this gt getAddress gt getStreet 2 class inpat text required entry i gt 70 ay Hereby you can find the above changes in a txt format allowing code snippet magen you to copy paste to_addressfields php Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 28 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE9
6. De Brouck re 12 brussel 1000 Belgium T 432477123456 Items Ordered Track your order Product Name Sony VAIO VGN TXN27NIB 11 1 Notebook PC Shipping Method bpost amp shop Payment Method Check Money order SKU Price VGN TXN27N B 2 699 99 c bpost Reorder Print Order Qty Subtotal Ordered 1 2 699 99 Shipped 1 Subtotal 2 699 99 Shipping amp Handling 12 00 Grand Total 2 711 99 Image 25 My orders gt Order overview Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 25 28 bpost shipping manager Integration Manual o f bpost 6 Appendix 6 1 Roles and Access rights Access rights are integrated in the default Magento Roles and Rights functionality An administrator can be granted access to a set of modules When installing the module a new user role will be introduced bpost administrator With this extra role the administrator of the Magento installation will be able to grant access to certain users to manage the bpost module configuration Deep links on the order page will be always available for all users who can view an order and or a shipment 6 2 Reporting The module was integrated in Magento in such a way that the reporting functi
7. 1 0 9 11 2012 7 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual P f bpost bpost shipping manager Back End Solution Shipping Information Manage shipments information storage and options 7m CL eiue Label printing Bpost shipping systems Back office order lt management Image 3 bpost Shipping Manager Back End solution In Fout Verwijzingsbron niet gevonden we show you the process in which the Back End is placed The following steps show how the process works The shipping information which is returned either by an integrated Front End or by REST web services can be stored in your Back office or ERP system and is automatically stored in the systems of bpost This covers information such as shipping address product client name etc It is possible to manage the information through the Shipping Manager Back End which is hosted by bpost E tailers can access it via the bpost portal to manage orders select options and generate labels Generated labels can be printed by the Shipping Manager and can be used to launch the logistic flow It is possible to follow the shipped parcels with the integrated Track amp Trace tool Apart from this solution the bpost Shipping Manager allows the deep integration of its
8. 3 Introduction This document describes the installation procedure of the bpost Shipping Manager Magento Plugin Please note that the Shipping Manager Integration Manual does not explain how to use the Back End of the Shipping Manager used for the management of orders and the generation of labels Please refer to the bpost Shipping Manager user guide if you want to work with the Back End interface The plugin has been developed by PHPro commissioned by bpost Parcels Europe in September 2011 For contact details PHPro bpost Parcels Europe 32 3 871 99 66 32 2 276 28 12 Business Park King Square Muntcentrum Veldkant 35 B B 2550 Kontich 1000 Brussel http www phpro be http www bpost be shippingmanager 3 1 Required knowledge In order to use this manual you need knowledge of the following topics e Magento framework e HTTPS The bpost Shipping Manager is an application that is created for any framework or e Commerce solution For Magento a specific plugin has been created The bpost Shipping Manager runs in an HTTPS environment in order to safeguard the communication of private data bpost strongly recommends using https and is not responsible for issue due to integrations in http environments A 3 2 Compatibility Compatibility with Magento versions The bpost Shipping Manager Magento plugin is tested following Magento version e Community Edition o 1 4 2 0 o 1 5 x o 1 6 x o 1 7 0 e Enterprise Edition
9. T 32477123456 Payment Information Shipping amp Handling Information Check Money order bpost shop 12 00 Order was placed using EUR items Ordered Product Item Status Original Price Price Qty Subtotal Tax Amount TaxPercent Discount Amount Row Total Sony VAIO VGN TXN27NIB 11 1 Notebook PC Ordered 2 699 99 2 699 99 Ordered 1 2 699 99 0 00 0 0 00 2 699 99 SKU VGN TXN27N B Image 19 Order overview In the Shipping and Handling Information tab you will see the selected bpost shipping method In our example this is bpost shop In the bpost Shipping Manager platform you can find an order with the same id in the screenshot this is 100000001 bpost Open X lw 3 Pakket 1 Retour pakket f Markeren als verwerkt f Heropenen X Annuleren M In wacht zetten Vernieuwen Zoeken ka SELECTIE VERZENDINGSMETHODE NAAM ONTVANGER ADRES STATUS PAKKETTEN DATUM E SHOP Ci 109 4 0 100000001 shop Txp Pugo Jan Janssens Boulevard de l Imp ratrice 3 1000 Bruxelles Open 0 25 08 2011 Upsell Image 20 bpost Shipping Manager back end To create a shipment simply click the ship button on top of the screen Following screen will appear For more information on how to use the bpost Shipping Manager please refer to the user manual document Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 22 28 bpost limited company under public law Centre Monnaie 1000 Brussels
10. Tracker bpost NL FR DE EN Klantendienst Hulp CSV Nieuwe zoek opdracht Zoekresultaten Barcode s Geadresseerde In netwerk Stad land bestemming Laatste Status Klanten referentie 323210570458300000046037 JAN JANSSENS BRUXELLES Aankondiging van een zending 100000001 ce d gt gt gt Een overzicht van de zending Taxipost Pick up Nummer zending 323210570459900000046037 Stad land vertrek KONTICH Datum in ontvangstname Stad land bestemming BRUXELLES Naam bestemming JAN JANSSENS Afleveringsdatum Afleveringsuur Klanten referentie 100000001 Overzicht van de status Datum Tijdstip Laatste Status Plaats 25 08 2011 09 26 Aankondiging van een zending LCI CSV Nieuwe zoek opdracht Image 24 bpost Track amp Trace application The consumer can either receive the Track amp Trace Info by mail or can check it by logging in to his account Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 24 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual Order 100000001 Processing About This Order Order Information Shipments Order Date August 25 2011 Shipping Address Jan Janssens Boulevard de l Imp ratrice 3 Bruxelles 1000 Belgium T 32477123456 Billing Address Jan Janssens
11. automatically be filled with the string bpost e enter the barcode previously created on the bpost Shipping Manager Platform in the field number This will result in the following screen shipping Information bpost shop Total Shipping Charges 12 00 Carrier Title Action bpost EET 3210570459900000046037 Delete Add Tracking Number Image 22 Add tracking number to shipment You can add multiple barcodes depending on the number of packages you created on the bpost Shipping Manager back end When done save the shipment and you will be redirected back to the order detail page You will now see a link Track Order in the Shipping and Handling Information tab Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 234 20 bpost shipping manager Integration Manual o f bpost This link leads to a popup page with the tracking information of the order Tracking Information Shipment 4100000001 Tracking Number 323210570459900000046037 Carrier bpost Status Track this Parcel Close Window Image 23 Order overview The link Track this Parcel will open the bpost Track amp Trace application and shows the tracking information for the parcel linked to this barcode r E
12. defines the shipping quote based on flat rate e Magento defines the shipping quote based on weight of the basket e Free delivery Shipping Manager decides the shipping quote Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 157 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost Please refer to the user manual that has been provided after signing the bpost Shipping Manager License Agreement In this document it is clearly explained how the price setting of the shipping costs can be managed By leaving the field Shippingcost rules empty the default configuration as set up in the bpost Shipping Manager is maintained At the end of the procedure to select the delivery method on the bpost platform the bpost platform will do a back post to the Magento platform This data will contain the new shipping address and the shipping cost which will be updated in the order on the Magento platform Magento defines the shipping quote based on flat rate For every available shipping method it is possible to define a flat rate This rate will overwrite any bpost defined configuration The following delivery methods are available BPACK home BPACK bpost BPACK 24 7 BPACK WORLD EXPRESS BPACK WORLD In order
13. functionalities into ERP or other back office systems This deep integration is thoroughly explained throughout the following sections and in the chapter Web Services For Magento a plug in solution has been build in order to facilitate the integration of the bpost Shipping Manager into the framework The module may not reflect all your requirements As the code is written based on the Open Source model you and or any certified partner are free to alter the module at any time Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 8 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual o f bpost 5 Magento module 5 1 Before installation In order to have access to the bpost Shipping Manager you must have a bpost contract sign the bpost Shipping Manager License Agreement and obtain an account ID password to configure the application Please contact the bpost parcels sales team at 32 2 211 11 11 or send an email to shippingmanager bpost be 5 2 Installation 1 Install the module from Magento Connect http www magentocommerce com magento connect or copy files directly from the archive into the directory of your Magento installation e Magento connect v1 magento community Bpost Shippingmanager e Magento co
14. o 1 9 1 0 o 1 10 0 0 Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 57 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual o f bpost Compatibility with other modules e One step checkout Supported e Multiple shipping addresses not supported 3 3 When upgrading from earlier versions Before you make any changes to your Magento installation you should always disable compilation Once the changes are made run the compilation process and then enable it 3 4 Recommended Magento code modifications c bpost Order Currently selected delivery method BPACK HOME A BPACK HOME BPACKQbpost BPACK 24 7 Select options and address E Laeken Shipping info w Nearby gt l ur icu ay N T Jette E M z T Options ALS RSS t SAMPLE12345 cz io f j M ea Info Next Da 0 15 Nets P O gi Ganshoren d M Order total 135 00 Type Shipping cost 4 00 BPACK HOME Delivery address Total 139 00 e bpost First name John Lastname Doe lel T AS x NS Aj AW c mem T a nderlecht Tare MAL Ixelles T STEVIA Number 3 Box number P oF Saint Gilles Elsene EE ek 2 Ts P Sint Gillis NUES City 1000
15. php echo this gt Address lal 62 lt div class input bor 63 lt input type text title lt php echa this Stre t Address gt name billing street 64 lt div gt 65 lt div gt 66 gt div class field 67 label for billing street class reqnuired gt lt em gt lt e 7php echo Sthis gt Number c lab 66 lt div clazss input bor 69 lt input type text title lt php echo this Numb r name billing street id l 70 lt div gt 71 lt div gt 72 lt 1i gt 7T3l lt li class fields gt Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 27 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual o f bpost so E 61 z label a 62 63 street id billing streeti value lt php echo Sthis gt htmlEscape this gt getAddress gt getStreet 1 64 65 66 67 P gt lt label gt 66 69 id billing street value lt php echo Sthis htmlEscape S this getAddress getStreet 2 7 gt cla 70 71 Changes made are 1 Remove the PHP for loop 2 Change the two li items to one containing both fields 3 Change the class of the li item from wide to fields 4
16. 1 0 9 11 2012 3 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 2 Glossary of Terms Throughout this document the following terms and abbreviations are used They are explained in this table Term Definition ERP Enterprise Resource Planning The technology solutions for EE large companies or other organizations to manage their resources including customers supplies accounting and other back office activities It is easy to setup and works on all modern browsers Pick up amp Go bpost delivery method For more information please visit www bpost be Bpack 24 7 bpost delivery method For more information please visit www bpost be The new name of PUGO a delivery method of bpost End user customer of a webshop Magento pages available when the shopw owner is logged on Person responsible for sending the parcels Magento back end for administrator bpost Shipping Manager platform Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 4 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost
17. 4 0000 0000 1414 BIC BPOTBEB1
18. BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost When the customer clicks the bpost logo a modal box including an iFrame with the bpost Shipping Manager loaded will appear on top of the page disabling all the fields on the underlying page The customer has to complete the process in the modal box in order to return to the Magento checkout process The customer can close the modal box by clicking the close icon in the top right corner of the iFrame canvas This will also deselect bpost as shipping method Select your delivery method 9 OG BPACK HOME BPACK bpost BPACK 24 7 doorstep or at Home i CK Home is Image 16 bpost Shipping Manager When the process in the modal box is finished successfully the bpost platform will be closed automatically The bpost platform sends the details from the selection back to the Magento platform which will trigger an update of the shipping method cost and address The customer will automatically continue to the next step without having to click the button continue It is important that the environments bpost and Magento work within the https protocol If not some browsers may report unsecure content on the page because there is a mix of secure and unsecure content on the page bpost does not support the http protocol Confidential Copyright 2011 by bpos
19. Brussel X LM i immu imme Country Belgium IERA A RIS Forest if i A i Back to shopping E mail john doe mail be f Vorst Mobile phone 0032499123456 n Ue it WERED EY j View full map le i Image 1 Standard integration not sending through address fields Within Magento the street name and number are entered in the same default address field As there exists no clear logic to retrieve the number from this field and because the bpost application requires both fields to be correctly filled they are cleared if Magento does not send the fields separately In Apendix the code change required in the template is described in detail Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 6 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost 4 bpost Shipping Manager solution The bpost Shipping Manager is a plug and play solution that is available for national and international shipping It allows your business to manage shipping and returns and to print labels The bpost Shipping Manager solution contains a Front End and a Back End solution 4 1 1 Front End The bpost Shipping Manager Front End is an online solution for your webshop e Solution to offer bpost delivery opti
20. EV Ship to Specific Countries Afghanistan STORE VIEW Albania Algeria American Samoa Andorra Angola Anguilla Antarctica Antigua and Barbuda Argentina x Sorteer volgorde WEBSITE This field should not be changed unless absolutely sure Front end URL https shippingmanager bpost be ShmF rontEnd s STORE VIE This field should not be changed unless absolutely sure Api Uri https api bpostbe services shm STORE VIEW This field should not be changed unless absolutely sure Proxy host STORE VIEW This field should not be changed unless absolutely sure Proxy port STORE VIE This field should not be changed unless absolutely sure Carrier name bpost STORE VIEW Image 6 example of configuration panel Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 10 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost In order for the module to work a number of parameters need to be set These parameters are described below Parameter Possible values Default Description Enabled Yes No No Turns the Shipping Manager on or off bpost AccountId String i Fill in your bpost account ID bpost passphrase String shown as Fill in the pass
21. VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual New Shipment for Order 4100000001 Order 100000001 the order confirmation email was sent Order Date Aug 25 2011 10 05 35 AM Order Status Pending c bpost gt sack GERE Account Information Customer Name Jan Janssens Email janjanssens hotmail com Purchased From Main Website Customer Group General Main Store English Placed from IP 192 168 2 1 Billing Address Edit Shipping Address Jan Janssens Jan Janssens De Brouck re 12 Boulevard de l Imp ratrice 3 brussel 1000 Bruxelles 1000 Belgium Belgium T 32477123456 T 32477123456 Payment Information Check Money order The order was placed using EUR Shipping Information bpost shop Total Shipping Charges 12 00 Carrier Title Number Add Tracking Number Items to Ship Image 21 Order gt Shipment overview In order to use the track and trace options first create a barcode for your shipment in the bpost Shipping Manager back end application This is currently not supported in the Magento backend For more information on creating barcodes please consult the bpost Shipping Manager back end user manual When the barcode is created e click the button Add Tracking Number in the tab Shipping Information e select bpost as carrier in the dropdown e the field title will
22. by bpost All rights reserved Version 4 1 0 9 11 2012 177 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost Once added to the attribute set the attribute will be available on the product edit page The attribute will be shown on this page as a multi select box with the shipping methods you configured for the Shipping Manager module Keep in mind that selecting one of the methods on the product will exclude the selected shipping method when the product is placed in the shopping cart Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 18 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 5 4 Front end integration In this part we will point out what changes to expect during the checkout process when the Shipping Manager shipping method is enabled You can also watch the movie on http youtu be q5epShhFfs4 for a visual representation 5 4 1 Layout design Magento is distributed with a default look amp feel which can be customized per installation Therefore the module will be integrated in the o
23. ed If however an amount is set the cart will be checked if the total cost of the cart is more than the amount specified If so Magento will force the bpost platform to offer a free shipment setting all available shipping methods to 0 00 Free delivery from in STORE VIEW Leave blank to not offering free delivery Image 11 Configuration Free delivery 5 3 7 Exclude shipping method on product In case a certain product is not illegible for a specific bpost shipping method it is possible to add this to the product attributes For example You do not want your consumers to be able to ship a big and heavy couch with BPACK 24 7 The Shipping Manager module introduces a new product attribute excluded bpost shippingmethods which is located in the list of attributes Catalog Attributes 3 Manage attributes In order to use this feature please add this attribute to the desired attribute sets enable gaoadgiecneckaut IS product available Tor purchase with Google Checkout Mo Yes excluded bpost_shippingmethods Exclude bpost shippingmethod Mo Mo Image 12 List of attributes General Create New Attribute Name Couch STORE VIEW Model 4113 GLOBAL SKU 1113 GLOBAL Weight 200 0000 GLOBAL Dimensions GLOBAL Exclude bpost shippingmethod BPACK home GLOBAL BPACK bpost BPACK 24 7 BPACK WORLD EXPRESS BPACK WORLD Image 13 Product edit page Confidential Copyright 2011
24. have an account with us please log in Email Address pi mic Password M Required Fiekis Forgot Your Password Image 18 Login for customer in Magento Once logged in the customer can follow the status of his order When he views the order details page and the shipment has been created by the administrator in the Magento Admin Panel see next chapter the Track amp Trace URL will appear on the screen with a deeplink to the bpost Track amp Trace application Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 21 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 5 5 Adding track amp trace to orders Once an order is placed via the Magento front end it will be available in the Magento back end by following Sales gt Orders 4 Order 100000001 Aug 25 2011 10 05 35 AM Back Order Date Aug 25 2011 10 05 35 AM Customer Name Jan Janssens Order Status Pending Email janjanssens hotmail com Purchased From Main Website Customer Group General Main Store English Placed from IP 192 168 2 1 Billing Address Edit Shipping Address Edit Jan Janssens Jan Janssens De Brouck re 12 Boulevard de l Imp ratrice 3 brussel 1000 Bruxelles 1000 Belgium Belgium T 32477123456
25. iled Most likely you do not have access to the application Please ensure that you are using the correct account ID and passphrase which are shown in 5 3 5 Available shipping methods All shipping methods in the portfolio of bpost are available in the back end of Magento as a multi select field There is no synchronization between the shipping methods configured in the bpost platform and these in Magento The user is responsible to synchronize the shipping methods configured in the bpost platform to the Magento module 999009 Marketing Demoshop Algemene instellingen Yerzend adressen Yerzendingsmethodes Layout VERZENDINGSMETHODE VISIBILITEIT Q BPACK24 7 Zichtbaar BPACKWORLD Zichtbaar Q BPACKWORLD express Zichtbaar Q BPACK HOME Zichtbaar Q BPACK bpost Zichtbaar Configuratie opslaan Terug naar shop overzicht Image 9 Available shipping methods within bpost portal application Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 14 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost After the bpost Shipping Manager License Agreement was signed you received a user manual In this document more information on how to use and configure the back end is explained
26. l rights reserved Version 4 1 0 9 11 2012 11 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual o f bpost 5 3 2 account ID and passphrase In order to use the module in Magento a bpost account ID is required The administrator is able to set a passphrase in the bpost Shipping Manager back end which can be found after login into the bpost portal at https www bpost be portal goLogin After Login go to Shipping Manager Admin edit shop Enter the name of your webshop in the Name field and add a Passphrase Be sure to use a Passphrase that follows the password security best practices 105704 New Shop Algemene instellingen Verzend adressen Verzendingsmethodes Layout Accountid 105704 Name New Shop Confirm url http test bpostlocal bpost confirm f Errorurl http test bpost local bpost error ph A Cancel url http test bpostlocal bpost cancel p Passphrase secret Terug naar shop overzicht Image 7 Credentials in bpost Shipping Manager back end The administrator will have to enter the account ID and Passphrase manually in the configuration of the Magento backend After the bpost Shipping Manager License Agreement was signed you received a user manual In this document more information on how to use and configu
27. m shippingmanager postback cancel 105704 New Shop Algemene instellingen Verzend adressen Verzendingsmethodes Layout Accountid 105704 Name New Shop Confirm url http ttestbpostlocal bpost confirm Errorur http test bpost local bpost error ph x Cancelurl htip testbpostlocal bpost cancel Passphrase secret Terug naar shop overzicht Image 8 Return URL s in bpost Shipping Manager 5 3 4 Error codes It is possible that one of the following error codes appears The description explains what the possible solution to this error could be Error Code Refers to Type Description 1110 orderReference Required Order reference is required but it hasn t been supplied 1210 Order reference is too long 1211 orderTotalPrice Order total prince contains invalid integer must be in eurocent 1212 Order cost center is too long Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 13728 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 1220 Order line has invalid format 1221 orderLine Format error Order line contains invalid price must be in eurocent 1252 Street name is too long correctly configured in back end 2000 N A Security error Access denied authentication fa
28. mber The following steps describe how to make the necessary changes which eventually result in the below screen capture LaDy Address Humber street 1234 City State Clty Zip Code Country am al 3c 1 Positioning of the field In order to position the field and show the correct label a modification in the files template checkout onepage billing phtml and shipping phtml file of your theme is required In these files find the lines where the address fields are added A an 57 lt php endif gt 58 lt 1i gt 58 E li class wide gt 60 label for billing streeti class required gt lt em gt lt em gt lt p echo Sthis gt Address 22 amp 1 div class input box 62 input type text title php echo S this Street Address name billing stre 63 lt div gt 64 lt li gt 65 lt php for i 2 n Sthis helper customer address getStreetLines i lt _m itt gt 66 E li class wide gt 67 div class input box 68 input type text title lt Fphp echo Sthis gt Street dress ts i name bill 69 lt div gt 70 lt 1i gt 71 lt php endfor 72 TA zli class fields Change the code to reflect the following images changes are described below 5 ndif 58 z li 55 li class fields 60 lt div class field 61 label for billing streeti class reqnired gt lt em gt lt e
29. nnect v2 http connect20 magentocommerce com community Bpost Shippingmanager 2 Purge the cache storage of Magento flush cache storage 3 Done 5 3 Configuration 5 3 1 Configuration of the module Maintenance of the module can be done in the Administrator back end once the module has been installed via Magento Connect The configuration of the module will be made accessible via Admin System Configuration Shipping Methods Moneybookers Image 4 Configuration menu Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 9 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s bpost Shipping Methods Flat Rate Table Rates Free Shipping DHL bpost Shipping Manager Image 5 Shipping method options bpost Shipping Manager Enabled Yes gt STORE VIEW bpost Accountld 105810 STORE VIE bpost passphrase coocoo STORE VIEW Allowed bpost shipping methods STORE VIE mA Select the shipping options that you would like to appear to the customer as an option Shippingcost rules STORE VIEVY Free delivery from in 1000 STORE VIEW Leave blank to not offering free delivery Ship to Applicable Countries All Allowed Countries xj STORE VI
30. onality of Magento can still be used in comparison to some other shipping methods which overwrite the default Magento functionality and standard principals behind the shipping address implementation 6 3 Testing The module has been tested with both unit and functional testing The unit tests are included in the distribution package 6 4 Supported versions of Magento The minimal supported version is set to Magento Community edition 1 4 x and Magento Enterprise edition 1 10 x The module will be compatible from these versions onwards By respecting the standards concerning Magento development the chance for incompatibility problems has been reduced Compatibility with Major releases like for example Magento 1 x x to 2 x x may lead to incompatibility off the module 6 5 Installation upgrades via Magento Connect The module is available as Magento Connect extension Magento connect will handle the installation of the module and can also handle upgrades Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 26 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost 6 6 Sending full address fields to bpost The Bpost Shipping Manager module supports using the 2 address line field as the street nu
31. ons to consumers bpost shipping manager Front End Solution Select products Check out Select delivery options Payment Confirmation Image 2 bpost Shipping Manager Front End solution The Front End fits seamlessly into the order process which is shown in Fout Verwijzingsbron niet gevonden The following steps show how the process works First the consumer selects his desired product s in the web shop Next the consumer enters his credentials and performs a check out During the checkout process when selecting the delivery method address the consumer is redirected via URL POST parameters to the Shipping Manager Front End In the Front End he selects the appropriate delivery method and options All the information is automatically sent to the bpost systems and all the information is also returned via URL redirect POST parameters to the web shop The consumer then comes back to the web shop to validate and pays the order Afterwards the web shop can send a confirmation to bpost in order to validate the sale after payment via another POST URL redirection or via a REST web service 4 1 2 Back End The bpost Shipping Manager Back End is a web based solution that allows your e business to e Manage shipments e Select additional options e Generate labels e Link web orders to parcel shipping e Access Track amp Trace information e Manage returns Confidential Copyright 2011 by bpost All rights reserved Version 4
32. re the back end is explained If you did not receive this document please request it via shippingmanager bpost be The passphrase can be changed in the bpost platform by the administrator Once done the Magento module will not be able to connect to the bpost platform anymore unless the password is likewise modified in the Magento back end A The password used is not the password that is used to login into the bpost portal application It is a manually set configuration When entering the password linked to your portal account the link with Magento will not function Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 127 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 5 3 3 Return URL s In the bpost Shipping Manager back end a number of return URL s need to be entered They should be created based on the following structure http BASE URL shippingmanager postback 41action The following actions are available Confirm url confirm Error url error Cancel url cancel If your shop would be available at http www shopname com this would give http www shopname com shippingmanager postback confirm http www shopname com shippingmanager postback error http www shopname co
33. t All rights reserved Version 4 1 0 9 11 2012 20 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual 9s f bpost 5 4 3 Order confirmation On the order confirmation page the selected delivery method and costs associated with it will be available Order 100000002 Pending Reorder Print Order Account Dashboard Account Information About This Order Order Information Adds Gack Order Date 8 July 2011 Billing Agreements Shipping Address Shipping Method Recurring Profiles supr pps Bpost shop Cronos My Product Reviews Mechelsesteenweg 85 Kontich 2500 My Tags Belgium My Wishlist T 033139920 My Downloadable Products Newsletter Subscriptions Billing Address Payment Method developer phpro Check Money order Cronos Did you know veldkant 33B quee Kontich 2500 Our customer service is Belgium available 24 7 T 033139920 555 555 0123 Hold elet is Items Ordered SKU Price Qty Subtotal we Akio Dresser 384822 399 99 Ordered 1 399 99 Subtotal 399 99 i n Grand Total 404 99 Image 17 Order confirmation page in Magento MY CART When the customer created an account during the checkout procedure he can access this page by logging in to his Magento account REGISTERED CUSTOMERS If you
34. to overwrite the default value please use the following mask Delivery method price Delivery method price for example BPACK home 5 BPACKQbpost 4 50 BPACK 24 7 5 will set the price of the delivery methods to the value provided Magento defines shipping quote based on weight of basket Similar to the previous price configuration it is possible to set prices based on the weight of all the products in the basket In order to do so please use the following mask 1 Delivery method kg price kg price Delivery method nu 1 kg price kg price For example 1 BPACKQhome 0 4 50 2 75 50 5 8 10 14 BPACKQbpost 1 0 74 2 5 57 77 50 10 13 50 which would give following pricing matrix BPACK home BPACK bpost 0 2 4 50 4 00 2 5 5 50 5 00 5 10 8 00 7 50 gt 10 14 00 13 50 Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 16 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT BE 0214 596 464 Legal Entities Register Brussels Postal Current Account IBAN BE94 0000 0000 1414 BIC BPOTBEB1 bpost shipping manager Integration Manual e f bpost Free delivery A common practice for web shops is to give free shipping starting from a certain amount in the shopping cart If the field Free delivery from in is left blank free delivery is not configur
35. ut of the box Magento theme template and is customisable by following the standardized Magento template mechanism For the bpost platform shown in an iFrame inside the Magento one page checkout the styling can be done through the bpost platform administration pages This allows the adaptation of colours and logo s Please refer to the User Manual which was received after the bpost Shipping Manager License Agreement was signed 5 4 2 Consumer selects delivery method The bpost module is seamlessly integrated with the default Magento checkout page If activated in the second step Billing Information the following field is added allowing your customer to choose his delivery address via the bpost Shipping Manager If the checkbox is selected the consumer is automatically sent to step 4 and the iFrame as shown in image 16 is opened iv Ship to this address Ship to different address Select your delivery address via bpost s bpost Image 14 Checkout workflow In the 4 step shipping method the shipping methods are listed per carrier Each carrier can have a single or multiple shipping methods Shipping Method handled g0 with care by bpost Click here to ship with bpost Image 15 Default Magento way to show shipping methods Confidential Copyright 2011 by bpost All rights reserved Version 4 1 0 9 11 2012 19 28 bpost limited company under public law Centre Monnaie 1000 Brussels VAT
36. word which is set in password the bpost Shipping Manager back end read more Allowed bpost shipping Selection Select the shipping methods that you methods wish to include in the bpost Shipping Manager Multiple selections are possible with CTRL click Shippingcost rules Build in your own business logic to define the price setting of the bpost Shipping Manager read more Free delivery from in Float rf From this amount on all available Shipping costs will be set to 0 read more Ship to Applicable Selection All Allowed Enable all countries or just a Countries Countries selection of countries Make sure that the list is identical to the list configured in the bpost Shipping Manager Ship to Specific List of countries Multiple selection of all countries that Countries are available to send parcels to Sort order integer Determines order of the shipping methods presented in shipping method section of checkout page Front end URL URL https shippin The unique link to the bpost Shipping gmanager bpos Manager t be ShmFrontE nd start RL Api uri U https api bpo Link to the webservice api of the st be services s bpost Shipping Manager hm p i you can enter the proxy server iun doa settings here This is only needed to make the api features work When your Magento installation runs on a server behind a proxy server Confidential Copyright 2011 by bpost Al

Here

Contents

Download Pdf Manuals

Related Search

Related Contents