Documente Academic
Documente Profesional
Documente Cultură
DPD OpenCart
2016/02 Page 1 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 2 of 20
DPD’s Delivery Service
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 3 of 20
Install
● 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
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 4 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:
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 5 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
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.
● 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 6 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
Thus, using the shippig chart can define a large variation of charging rules, depending on:
With the help of the aforementioned conditions, we can define special prices for deliveries and
pricing:
● 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 7 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
2016/02 Page 8 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.
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 9 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 10 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 11 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.
2016/02 Page 12 of 20
A link for tracking the shipment is also shown.
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.
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.
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 13 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
2016/02 Page 14 of 20
Anexa 1.1
2016/02 Page 15 of 20
Anexa 1.2
2016/02 Page 16 of 20
Anexa 1.3
2016/02 Page 17 of 20
Anexa 1.4
2016/02 Page 18 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 19 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.
For more information, please contact us at the following email address: eshop@dpd.ro
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.
2016/02 Page 20 of 20