2016/02 Page 1 of 20

Tutorial

DPD OpenCart

16-02-2015 Versiunea 1.1 Bussiness Development Manager Dragos Buzea

16-02-2015 Versiunea 1.1 Support Specialist Alexandru Martin

15-01-2016 Versiunea 2 Support Specialist Alexandru Martin

2016/02 Page 2 of 20

Contents

DPD’s Delivery Service ..................................................................................................................................................3 Integration with Opencart 1.5 ...............................................................................................................................3 Recommendations: ...................................................................................................................................................3 Install ............................................................................................................................................................................... 4 Setup ............................................................................................................................................................................... 4

Shipping settings .............................................................................................................................................................5 PREDICT Service .........................................................................................................................................................5 Tool debbug ................................................................................................................................................................. 6 COD configuration (Cash on delivery) ............................................................................................................. 6 Configurating the Taxation Chart ....................................................................................................................... 7 Processing orders ..................................................................................................................................................... 8

General aspects ..................................................................................................................................................... 8 Creating the delivery........................................................................................................................................... 9 Printing documents ............................................................................................................................................ 12 Tracking the order ............................................................................................................................................... 13

Processing without communication with DPD ......................................................................................... 13 Using the Front-end extension ......................................................................................................................... 13 Common issues........................................................................................................................................................ 14 Updating the validator for postal codes ...................................................................................................... 19

2016/02 Page 3 of 20

DPD’s Delivery Service

Integration with Opencart 1.5

The DPD extension allows a flexible way of processing and managing delivery costs by integrating with the company’s core systems. The steps needed are detailed in the following paragraphs. The main features of the extension are:

● Defining the flexible pricing, using the toll chart

● Managing the sent packages

● Automatic correction for the postal code

● Auto-complete the postal code front-end section on the customer registration address site

● Printing the shipping labels for both normal and cash on delivery expeditions

● Tracking deliveries

● Communication with the DPD service

● Generating and printing tally-sheets and delivery labels

● Profit report, depending on the delivery method

● Delivery status

● The PREDICT service

● The Debbug method

Recommendations:

● The extension is compatible with Opencart 1.5.x,

● According to the Opencart recommendations, we recommend creating a backup of the

database and files, before any new installation

● Optimum use of the extension requires the installation of the PHP mbstring extension

● The minimum PHP version is 5.3

● Also PHP SOAP needs to be installed

● It is mandatory that the products have a defined weight, as DPD charges based on weight. If

the weight of the product is not mentioned, then the DPD method will not be available on

checkout.

2016/02 Page 4 of 20

Install

Requirements for installation: ● OpenCart 1.5.x ● Extension vQMod previously installed

● PHP mbstring ● PHP 5.2 ● PHP SOAP ● Product weight set in admin Integration OpenCart uses DPD platform vQMod order to change the the basic behavior of plaformei OpenCart. More details about implementation vQMod found at the following link https://github.com/vqmod/vqmod/wiki We recommend installing the module before vQMod DPD. After loading the DPD server extension can navigate in the main menu Extensions -> Shipping. It will identify the extension DPD DPD Shipping Carrier and clicking on button instance. Warning: installing the extension may take several seconds. Once run the installation script can proceed to configure the extension.

Setup

To configure the extension following steps are shown below (accessed from Carrier DPD)

● Set Delivery

● Payment settings, if desired and activate a payment method

● Filling the Table of Taxation to define how clients are charged

2016/02 Page 5 of 20

Shipping settings

Setting up the shipping methods can be set up in : System / Configuration / Shipping methods The following fields will be filled in, in the DPD GeoPost By Zitec section:

● Activ/Enabled: To activate or deactivate the payment method

● Correct/automatically completes the postal code: Yes, to activate the correction and

automatic generation of the postal code in checkout. If the system fails to precisely identify

the postal code, based on the address filled in by the customer (country, region,

street/address), then the site administrator will have to manually validate the postal code

(chosing from a list of possible postal codes) before processing the shipment (press the

Livreaza/Ship from the command interface).

● Selecteaza Tara/DPD Country Select: To select the country where the DPD contract is

signed

● Modul Productie/Production Mode: To activate the testing extension – select Nu/No.

● Debug Mode: YES/NO

● Titlul metodei de livrare/Method Title: Title of the extension

● Numele metodei de livrare/Method Name: The name of the shipping method that will be

visible in checkout.

● Utilizator DPD/Web Service Username: It is the user name provided by DPD to connect to

the web service

● Parola DPD/Web Service Password

● Web Service Connection Timeout: Time, in seconds, in which the application is waiting for a

request made towards the DPD web service

● Id-ul adresei de expeditie/Sender Address Id: Obtained at the signing of the contract

● Id-ul platitorului/Payer Id: Obtained at the signing of the contract

● Serviciu/Service: The type of delivery service available in the contract

● Service PREDICT: It’s an additional service and it is available only if it’s active in the contract,

along side the product. For Romania Product DPD B2C + PREDICT is active.

You can view the picture in Annex 1.1

Attention!!!

Activate only the delivery services available in the DPD contract, to eliminate the unnecessary data processing (calls towards the DPD’s API).

PREDICT Service

It is the pre-checking service of the recipient, through SMS or email, on scheduling the delivery that is to be made towards him. The range is within the margin of 3-4 hours for the day of the delivery – range coverage available for Zone 0.

2016/02 Page 6 of 20

Tool debbug

DPD Magento module offers, upon its activation, aid in verifying some problems that could appear in the DPD module.

The debug folder should be in the default system folder (if the settings are modified). Everything is reported to the project’s root: - Opencart - system/logs/zitec_dpd.log

COD configuration (Cash on delivery)

This feature allows customers of the Opencart store to pay to pay for the order on delivery.The delivery method will have its own associated fee (that can be defined by the store’s administrator) and will be active in the checkout only if DPD delivery method was chosen previously.

To view these settings, access System / Configuration / Payment Method / Plata la livrare prin DPD - COD or you can visualize a print screen in Annex 1.2.

Caution: The charge details in this section (payment type and value payment type) will be used only if there won’t be any rules selected, from the toll chart for the delivery system.

Available settings for the delivery method:

● Activ/Enabled: The method of payment is acivated/deactivated in any context for the selected

website

● Titlu/Title

● Nume taxa/Method Name: Number visible in the checkout

● Statusul noii comenzi/New oreder status: The status of a new order placed using the DPD

payment method

● Serviciu/Service: Select the delivery service for the active payment method

● Tip plata/Payment Type: generally, the chosen option will be Cash

● Tip valoare plata/Payment amount type: Chose the type of charge applied for the method of

payment, in case they are not defined any entries in the taxation chart. The type of the charged

can be a predefined amount or a percentage of the value of the package. If there are any entries

2016/02 Page 7 of 20

in the taxation chart for a certain DPD delivery service, then the value set in

System/Configuration will not be used.

● Valoare plata/Payment amount: Depending on the value selected in the previous field, the

value of the Payment Amount will be used as a percentage or a predefined amount.

Metoda de plata activa pentru tarile/Payment from Applicable Countries

Configurating the Taxation Chart

The taxation chart represents particular configurations for each delivery service that allow the store administrators to control the shipping costs more accurately.

Thus, using the shippig chart can define a large variation of charging rules, depending on:

● the recipient’s postal code

● country of destination

● region of destination

● the store that the order is placed on

● the weight / destination ratio

● the price / destination ratio

With the help of the aforementioned conditions, we can define special prices for deliveries and pricing:

● payment of a fixed amount

● added percentage of the value of the delivery, as seen by DPD

● adding an exact value over the value of the delivery, as seen by DPD

● equivalent payment to cash on delivery - free

● equivalent payment to cash on delivery – exact amount

● equivalent payment to cash on delivery - the sum of the percentage values of all products

More details on Annex 1.3

The filled fields in the Table Chart are:

● Tara dest./Country: The country for which the taxation rule is applied

● Regiunea/Statul dest./Dest Region/State: The state/region for which the taxation rule is

applied

● Cod postal dest./Destination Zip/Postal Code: The postal code which the taxation rule is

applied. It will be left blank and * will be set, for any postal code.l

● Serviciu/Service: Type of DPD delivery service

● Conditie/Condition: Represents the particular condition imposed by the rule : the ratio weight

/ destination or price / destination

● Greutate (si mai mare) /Weight (and above): This occurs if the selected condition is weight. It

will be filled in with the weight in Kg from which the rule applies

● Pret (si mai mare)/Price (and above): This occurs if the condition is price vs destination. The price

filled in will be the one for which the delivery rule applies

2016/02 Page 8 of 20

● Activeaza Metoda Livrare/Enable Shipping Method

● Calcularea pretului de livrare/Shipping Price Calculation: Type of calculation of the delivery

method. It can be a fixed amount or a fixed percentage.

● Pret livrare/Shipping Price

● Adaos valoare procentuala la valoarea DPD/Shipping Percentage

● Adaos valoare fixa la valoare DPD/Add fixed amount to price

● Taxa plata la livrare/Cash On Delivery Surcharge Calculation: Represents the type of charge for

the cash on delivery method. It can be a fixed amount, zero or a percentage of the order’s value.

● Taxa valoare fixa pentru Plata la livrare/Fixed tax value for cash on delivery

● Taxa minima COD (plata la livrare)/Minimum COD Surcharge

Processing orders

General aspects

In the process of delivering orders from the Opencart interface, the following actions will be available:

● Manual verification of the postal code or using a a postal code automatically identified for the

user’s address

● Dividing the products in packages

● Adding description for boxes

● Obtaining a delivery price report, if the used pricing is fixed or filled

● Calculating the final price, after the boxes were divided or other administrative changes

(address or orders).

● Creating a tally-sheet

● Generating the tally-sheet labels in PDF format

Self-validation of the postal code

The need to process the deliveries as efficient as possible, implies using the postal codes in the DPD delivery system. The Magendo extension comes in the support of the online shop administrators, by implementing an automatic validation of the postal code for the customer’s complete address. The delivery extension allows the validation of the postal code from the address, automatically (in the moment of communication with the service – when the order is placed) but also offers some notifications if the postal code could not have been properly setup. If the postal code could not be generated with a satisfying precision, the extension will notify the site administrator (in the order visualization interface or the order visualization) the fact that an automatically generated postal code was used for generating the delivery fee, but he will be prompted to manually validate it, before shipping the package.

2016/02 Page 9 of 20

Looking up the postal code is done by selecting one of the suggestions found in the DPD database, for the address already filled in by the customer or updated by the site administrator. Once the shipping address is edited, all the notifications vanish, and the postal code is considered valid. From this point on the processing of the order can continue. Creating the delivery

You can view below a new command that has the “DPD Pending Cash On Delivery” status. This status signals that this order has been made using a DPD delivery and payment method.

2016/02 Page 10 of 20

In the order visualization interface you can see the payment details. It can be noted that the method of payment implies a specific tax for cash on delivery, that also affects the order total, that will be billed.

2016/02 Page 11 of 20

In the delivery processing interface (press the Create Shipment or Shipment management) you can choose the number of boxes in which the delivery is done, but also if it will communicate with DPD for obtaining the updated price.

After generating the shipping in the DPD system, the administrator will get a message similar to the one illustrated bellow and can monitor the shipping in real time, by clicking the the link : Urmareste comanda (Follow the order).

2016/02 Page 12 of 20

Printing documents

Printing the labels is available from both the visualization of the order and from Sales / Shipments.

The buttons for printing the labels, generating and printing manifest can be found in the delivery list, for simultaneous shippings

Printing the delivery lables means generating a PDF file that will contain a page for each shipping ticked on the list. Each page will contain, of course, a label for each package.

The manifest is a mandatory document that will be requested by the DPD agent when the packages are picked up. The tally-sheet must contain the deliveries for the entire day, and must be printed out in two copies.

Also, each delivery section can be chosen at a time, to obtain more information.

Exemples of these documents can be found in Annex 1.4

2016/02 Page 13 of 20

A link for tracking the shipment is also shown.

Tracking the order

Upon placing the delivery, in the order and shipping visualization interface or on the customer’s account, there is an available tracking link that opens a new window with more information regarding the actual delivery, but also a link towards the DPD system, with the exact location of the parcel.

Processing without communication with DPD

As shown above, in the administrative section you can also process orders without communicating with the DPD service, that shows the exact shipping price. You may need this option in certain situations. For example, if the DPD system is unavailable.

Using the Front-end extension

Once the extension is installed and configured as previously mentioned, the DPD payment method will be available in checkout, similar to any other delivery.

2016/02 Page 14 of 20

If some addresses are invalid (for example addresses that DPD does not ship), the method of delivery will not be available.

In addition, the DPD delivery method can activate a method of payment on delivery, that unlike other payment methods, can charge the customer extra, depending on the shop administrator’s settings.

Common issues

1. PHP SOAP is not active on the server

2. The PVP version is under 5.3

3. The DPD delivery services activated in the System / Configuration / Shipping methods section

are not available in the DPD contract

4. Some products do not have the “weight“ attribute configured or it is equal to 0.

2016/02 Page 15 of 20

Anexa 1.1

2016/02 Page 16 of 20

Anexa 1.2

2016/02 Page 17 of 20

Anexa 1.3

2016/02 Page 18 of 20

Anexa 1.4

2016/02 Page 19 of 20

Updating the validator for postal codes

You can update the valid postal codes by importing the CSV file shown on the DPD site, in the installed extension DPD_ZITEC. It can be downloaded form http://www.dpd.com/ro/home/e_commerce The last version is coduri_postale.csv

2016/02 Page 20 of 20

Se intra in meniul extensiei:

Click on the Postcode update manager for locate the import section.

> Select the downloaded file from dpd.ro and press the import button.

The update was successful. For more information, please contact us at the following email address: eshop@dpd.ro The application is free. To modify the extension, DPD Romania is not responsible for its errors. The DPD extension works under standard requirements of its platform, any modification brought to the platform can lead to odd behavior/module failure. The support (setup / installation) is guaranteed only to DPD Romania customers.