Package Tracking

Time to read: 5 minutes


With the parcel tracking module you can specify the tracking code for sent parcels and the shop makes it available to the customer.

Save support costs and inform your customers about the whereabouts of their shipments.

The link for parcel tracking of the respective logistics provider is provided directly with the order sent e-mail, so that your customer does not have to contact you first. The tracking link is also available in his customer account. In this way one saves oneself as a Shopbetreiber some at support and telephone expenditure with ‘where is my package’ inquiries. Various logistics partners are supported.

This module is optionally available for the PepperShop and must be purchased separately.

Display for the customer

In the overview of orders placed, which are displayed in the customer area under Orders, the customer sees a link Track shipment if a tracking number has been entered for a shipment and the period defined for tracking has not yet expired. A click on the link opens a new window and sends a tracking request to the stored logistics partner.

On the following page you will see an example e-mail with tracking information:

Hello Mrs. Marianne Muster,

we are pleased to inform you, that we will process your order with the order reference number 184491 have shipped today.

Track shipment: 06085004412455

Thank you very much for your confidence

Friendly greetings

Your webshop team

Here is an example display of the customer account with tracking information.

Here is an example of Swiss Post when you click on the tracking link.

Figure 1: Shipment tracking in customer account

Here is an example display of the customer account with tracking information. Figure 2: Shipment tracking in the customer account

Enter tracking numbers

The allocation of tracking numbers is called up via ‘Shop Administration’ > ‘Customer/Orders’ > ‘Order Tracking’. The list of orders to which a tracking number has not yet been assigned is displayed. For each order, the sender (logistics partner) is selected and the tracking number (or the last digits of the tracking number) is entered.

In the top line of the editing mask, the list display can be changed so that orders with an assigned tracking number are displayed. The maximum number of displayed data records can be defined in the input field ‘Number’.

Figure 3: Enter a tracking number manually. Only the relevant part must be specified

There is also a direct input option in the order view in customer management. Here you can see either the button to enter the tracking data:

…or the entered data and the button to display the shipment tracking at the same location:

Manage senders

In order to access the processing mask for managing the senders, you must click on ‘Customer/Orders’ > Order Tracking’ > ‘Manage senders’ in the Tracking Numbers entry mask. The list of existing senders is then displayed. If a new sender is to be entered, an entry in the database as well as a basic configuration in the file tracking_filter.def.php is necessary. This is usually done by a programmer.

Each of the displayed senders can be activated individually and assigned a priority. This has the advantage that only those senders are displayed in the entry mask for the tracking numbers that are actually used. So that the entire tracking number does not have to be entered, the constant part of the tracking number as well as the length (in number of characters) can be stored. Only the part that is different for each shipment must be entered for each shipment. The tracking number is automatically padded with the pad character defined under Padding.

  • ID: Internal ID of sender, required for connection to ERP software
  • Designation: Designation of the sender (e.g. Post, DHL, UPS,..)
  • Tracking-Nr-Prefix: Constant part of the tracking number (at the beginning). empty → do not complete the order, the complete tracking number is stored with the order
  • Auff.: Fill character for automatic completion of the tracking number
  • Length: Number of characters to which the tracking number is added
  • Tracking duration: number of days after shipment when a tracking request is possible. 0 -> no time limit for tracking requests.
  • Priority: Display priority for the selection list (1 → highest)

Figure 4: Mask for managing logistics partners (shipper)

Illustration Tracking No. Structure

(1) Tracking No prefix = 99.60.003129.
(2) Length = 21 (number of characters)
(3) Ref.= 0 (Refill character)
(4) Tracking-No = 806 (different for each order)

                 ____(1)____ (4)
Example / \ / \
Tracking number: 99.60.003129.00000806
                | \___/ |
                | (3) |

Tracking number import

Shop operators of the Enterprise version can automatically import tracking numbers via the interface set_delivery status under ‘Import/Export-Tool’ > ‘Caller-Navigator’ > ‘Delivery status’.

Mail sent Customize text

In the following file the text of the e-mail ‘Order sent’ can be adapted ({xy} = language):



System requirements

To use the package tracking module a PepperShop v.3.0 Professional or Enterprise is required.

Copy and upload files

The module essentially consists of three files, which you have to copy into your installed PepperShop. First unzip the included ZIP archive. The following module files are contained, shown here with the target directories:


The files can be easily uploaded via FTP or SCP to the web server. The placeholder {shopdir} stands for the shop directory on the web server, where the file index.php can be found together with the file README.txt.

Now the module is recognized and integrated by the shop. It is listed in the ‘Shop Configuration’ menu at the bottom of the internal module info.

If the tracking module is installed, in the main menu of the shop administration the item ‘Customers/Orders’ > ‘Order Tracking’ appears.