Child pages
  • Orders
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »


The "Orders" page under the "Orders" menu enables you to see all of the information about all the purchases from your shop. All of your shop's transactions are available there, organized by date (by default, it is set to sort from newest to oldest).

You can filter the results and easily find the orders you're looking for by using the fields above. For instance, to identify Mr. Doe's orders, type "Doe" into the "Customer" field and then click "Filter".

YOU CANNOT DELETE AN ORDER. It is illegal to be able to remove payment or ordering information and/or invoice information from a business in Europe. Therefore, implementing a "Delete" button for orders would render PrestaShop illegal in Europe.

To safely delete the default order (and thus be able to delete the iPod from your catalog), install the "PrestaShop cleaner" module (which is available in the default installation since v1.5.4), open its configuration screen and check the "Orders and customers" box before you click on the "Check & fix" button.

You can export a list of your orders by clicking on the "Export" button at the top.
You cannot import orders.

Creating an Order

One of the great features of PrestaShop is the ability to create an order directly from the back-office. For instance, this is tremendously useful when a customer wants to buy a product but does not succeed, and you need to take the hand and make the order while on the phone or during an e-mail conversation with the customer.

Clicking "Add new" opens a new page with a single text field, labeled "Search customers". When creating a new order through the back-office, your first task is to associate that order with a customer. Type the first letters of the customer first name, last name or e-mail address, and PrestaShop will display the matching accounts.

If the customer you are creating this order for does not even have a user account already, you can create one on the fly: click the "Add a new customer" button to open a window with the main account details ready to fill. Once the account is saved, it becomes the chosen account for the order.

Note that you will also have to register the customer's address – a "Add new address" button is available at the bottom of the page, in the "Addresses" section.

Click the "Choose" button for the correct customer, and the whole order form appears. Its main section, "Cart", is where you will make all the necessary product decisions for this order.

The "Search a product" field enables you to dynamically find products to add: type the first letters of its name and PrestaShop will fill a drop-down list with matching products. Choose a product, select a quantity, and click "Add to cart" button. You can of course choose among the many combinations of a product, if any, in the "Combination" drop-down list that appears in that case.
Note that PrestaShop gives you an indication of the remaining stock for a given product, which enables you to tell the customer that you are out of stock for said product right from the order form.

The page also enables you to see the previous carts and orders from that customer, if any. If it turns out you are dealing with a cart that a customer somehow cannot validate, you can use that cart for this order by clicking on the "Use this cart" action button (the "two windows" icon).

If needed, you can also grant that order a voucher/cart rule, and even create one on the fly by clicking on the "Add new voucher" button.

Finally, you need to specify to which address the order should be delivery (and possibly billed). Here, again, you can create new addresses on the fly using the "Add new addresses" button.

Viewing an Order's Details

In order to process the orders you receive, you have to view the information they contain.
Click on the line containing the order, or click on the button to the right of the order.

The order detail sheet fills a full page.

This summary of the order gives you access to:

  • The status and history of the order.
  • The carrier information: total weight of order and carrier chosen by the customer.
  • The method of payment that was used, the cost of the products, and the shipping costs.
  • Various details on the ordered products.

In the "Shipping address" section of the page, you can see a "G" icon: the enables you to use Google Maps to locate the address on a map.

Changing the order

Orders are not unalterable. There are many reasons why you would need to change an order before its products are gathered, packed and sent to their new owner: one of the product is out of stock, the customer changed his or her mind, etc.

Adding a product

At the top of the page, you can find the "Add a product" button, which triggers two actions upon clicking:

  1. Scrolls down the page to the "Products" section.
  2. Adds a field to the order.

When adding a product, the products table gets a new row added with a handful of fields. The first text field is actually a small search engine: type the first letters of a product to see a list of corresponding products. Select the one you want to add, and the grayed-out field of the row becomes available.
If the product has combinations, you can select it in a drop-down list that appears below the name: the unit price update accordingly.
Set the quantity of products, and then click the "Add product" button: the product is added

Note that the "Add a product" button from the "Products" section triggers the same action the button of the same name in the top bat.

You cannot add more product quantity than there is of available product.

Removing products

To cancel a product, go to the product list, and either delete the product by clicking on the "Delete" action (the "trashcan" icon), or by clicking on the "Edit" action if all you need is to remove some quantity of a product.

You can edit the quantity of many products at the same time.
If a product's quantity reaches 0, it is removed from the order altogether.
You cannot remove more than the quantity of product.
Click the "red cross" icon to cancel your edit.

Editing the order details

Many sections of the order sheet can be edited, enabling you to update or correct some of the data provided by the customer.

Order Status

The first drop-down list in the order page enables you to change its status. It is a very important part of the whole order monitoring process, as with each status change, new functionalities and documentation will be made available for the order.

You can choose between the following statuses:

  • Awaiting bank wire payment.
  • Awaiting cheque payment.
  • Awaiting PayPal payment.
  • Canceled.
  • Delivered.
  • On backorder.
  • Payment accepted.
  • Payment error.
  • Payment remotely accepted.
  • Preparation in progress.
  • Refund.
  • Shipped.

In order to get a better view of the order's activity, every status change is recorded, and the log appears right below the status change drop-down list. Therefore, you should only change a status if it has been clearly confirmed: do not mark an order as "Delivered" when you have sent the package, use "Shipped"; do not use "Preparation in progress" when in fact you have only taken a quick glance at the order, etc.

Actions Buttons

The action buttons change depending on the order's status. For instance, once the order is in the "Delivered" state, the "Add a product" and "Remove products" turn into two new buttons: "Return products" and "Partial refund".

Product return is not activated by default. To activate it, go to the "Product returns" page under the "Orders" menu, and activate the option in the option at the bottom of the page. This will apply to all products and all orders.

  • Return products. To be used only when the customer has effectively returned products: once the returned product has been received, you can mark it as returned directly in the order form. Click the "Return products" button and a new column will appear in the product list, titled "Return". Check the box of the affected products, indicate the quantity of items that were returned, and click the "Return products" at the bottom of the table.
  • Partial refund. To be used when you need to refund only part of the order and not the whole order, either because the customer returned the ordered product, or simply as a sign of goodwill for a damaged product that the customer chose to keep anyway. Click the "Partial refund" button and a new column will appear in the product list, titled "Partial refund". Set the amount and quantity for each of the affected products, choose one of the option at the bottom of the list (see below), and click the "Partial refund" button at the bottom of the table.

When you set a product as returned or to be refunded, four options are available below the list of products:

  • Re-stock products. When checked, PrestaShop will consider that the returned product as available for sale again, and will therefore increase the stock for this product. You should not click this when a product is returned due to it being broken...
  • Generate a credit slip. When checked, a credit slip will be created for the selected items. A credit slip is an acknowledgment from your shop that merchandise has been returned and that a refund has been issued. The customer can then use it as a credit slip for his or her next purchase.
  • Generate a voucher. When checked, a voucher will be created for the amount of the selected items. A voucher takes the form of a discount code that the customer can enter during the checkout process.
    You can edit the customer's existing vouchers by viewing the customer's page: from the current order's page, click on the link under the customer's name in the "Customer information" section; once in the customer's page, reach the "Vouchers" section. You can edit each voucher by clicking on the "Edit" icon.

    In PrestaShop, vouchers are part of a special kind of discount feature: "cart rules". They can be created and edited from the "Cart Rules" page, under the "Price rules" menu. The cart rules creation process in the next chapter, "Creating Price rules And Vouchers".

  • Repay shipping cost. You can also choose to refund the shipping cost of the returned product, which is always an appreciated gesture.

If the customer paid the order using a credit card, the payment system should refund the cart automatically. If the order was paid using a check or a bank transfer, you have to issue the refund yourself, then mark the order as having been refunded manually in the back-office (in the order's page).

Difference between a credit slip, a voucher and a cart rule

A credit slip is first and foremost a written proof that a product has been returned. Most of the time, the customer can use it as a voucher.

A voucher is a discount code which does not have to be tied to a merchandise return or a refund, and which can take more forms than a simple credit slip:

  • A discount on an order (percentage).
  • A discount on an order (amount).
  • Free shipping.

You can apply a voucher to all customers, or a group of customers, or a single customer; you can set its expiration date;

A cart rule is basically an advanced version of a voucher: in addition to what a voucher could do in PrestaShop 1.4, the cart rules system introduced in PrestaShop 1.5 enables you to:

  • Name the discount.
  • Allow the customer to use only a portion of the discount.
  • Assign priorities between cart rules.
  • Set the compatibility between cart rules.
  • Have the discount only work with some carriers.
  • Have the discount only work with a selection of products and/or categories and/or manufacturers and/or suppliers and/or attributes... or all of these at the same time if necessary!
  • Have the discount be applicable for free shipping and/or a discount on an order and/or a free gift... or all of these at the same time if necessary!


You can get many PDF documents out of the order page. When available, they are listed in the "Documents" section of the page.

By default, you can download the order itself as a PDF, by clicking on the "Print order" button on right.

You can get an invoice for the order by clicking on the "Generate invoice" button from the "Documents" section. The invoice is also generated once you put the order in the "Payment accepted" status.
Once it is generated, the "View invoice" button below gets activated the top-bar.

You can customize the invoice layout easily: the PDF template files are located in the /pdf folder. These .tpl files are actually HTML files with Smarty tags for dynamic data. You can change the invoice's layout by editing the file named invoice.tpl.


When you put the order in the "Preparation in progress" state, a delivery slip PDF is generated, which you can then download from the "Documents" section.


The shipping details of the current order can be partly edited. More specifically, you can change the tracking number: in the "Shipping" section, click on the "Edit" icon in the "Tracking number" column, and enter the new number.

Shipping Address

The "Shipping address" section enables you to edit the destination address of the package your team is about to send. You can either use the drop-down list to choose another of the addresses that the customers has already registered on your shop, or you can use the "Edit" icon to edit the currently chosen address.

If you need to send the package to an address that is not already registered in PrestaShop, you must first create it. To do this, go to the "Customers" menu, open the "Addresses" page, and click in the "Add new" button. Do not forget to put the correct e-mail of the customer, as this is the way PrestaShop will know to associate that new address with your existing customer! Once done, go back to the order's page, and change the address using the drop-down list.

Note that a small "G" icon enables you to visualize the destination of the package on Google Maps.

Invoice Address

The "Invoice address" section enables you to edit the payment address of the order. Just as for the shipping address, you can either choose the drop-down menu to choose another of the addresses that the customers has already registered on your shop, or you can use the "Edit" icon to edit the currently chosen address.

If you need the payment to be tied to an address that is not already registered in PrestaShop, you must first create it. To do this, go to the "Customers" menu, open the "Addresses" page, and click in the "Add new" button. Do not forget to put the correct e-mail of the customer, as this is the way PrestaShop will know to associate that new address with your existing customer! Once done, go back to the order's page, and change the address using the drop-down menu.


In the "Products" section, at the bottom of the products listing, you can find an empty table with an "Add new discount" button. This creates a simple discount, not as advanced as the vouchers/cart rules system but still useful.

Clicking it will open a new form, with the following items:

  • Name. Give the discount a short name. This will be public to the customer.
  • Type. Choose the discount type: "percent", "amount" or "free shipping".
  • Value. For the "percent" or "amount" types, set the value of the discount.
  • Invoice. Select to which invoice from this order this discount should be applied. When there is more than one invoice, you can check the box to apply the discount to all the invoices.

The discount will be applied to the total before the shipping costs.

Attaching a message to the order

In the "New Message" section, at the bottom of the page, you can attach a comment on the order for your team.

You can also have this comment be sent to the customer, in order to give him or her information concerning the order, a delay, a surprise, or keep him or her informed on offers and specials. This is a key point of customer relationship.

There are two links available:

  • Click here to add a comment or send a message to the customer.
    • You can add a message simply by writing in the message box and clicking "Send". The message will be stored in the client's profile in your Customer Service database, which you can access either by going to the client's page, or to the Customer Service page. The message can also be sent to the client's e-mail address should you choose to.
    • Pre-written messages can be saved and used multiple times, saving you the hassle of writing them over and over again. If you would like to send one of these messages, select it from the drop-down list. You can then add further details to the pre-written message if needed.
      You can create more pre-written messages using the tool in the "Order messages" page, under the "Orders" page.
  • Click here to see all messages. This link will take you to the "Customer service" page of the "Customers" menu. This is fully explained in the "Managing Customers" chapter of this guide.
  • No labels