Returns Manager: setup and help
Quick start
- Install “MPR Returns and Right of Withdrawal”. Open “Returns” > “Configuration” with one shop selected.
- Fill “Trader name on the withdrawal form”, “Return address” and “Staff e-mail address”. Check the details and click “Save”.
- Review “Withdrawal country rules” and “Possession states”. Use only state IDs that mean the customer has the goods. Review “Cancel whole orders before shipping”, which starts with eligible unshipped states selected.
- For a delivered, paid test order, sign in as its customer. Open “My returns”, choose “Start a return”, select products and quantities, then click “Continue”. An eligible order opens the withdrawal function.
- Choose “I will send the goods myself”, check the name, confirmation address and statement, then click “Confirm withdrawal”. Check the case page and acknowledgement email.
- In “Returns” > “Return requests”, open that case. Choose “Approve” and use “Approve the return”. A “Decision note” is optional for approval.
- When the whole parcel arrives, use “The goods arrived”. Use “Open the order” to handle the refund and create its PrestaShop credit slip, then select that slip on the case and click “Record the credit slip”. Complete repayment through your usual payment process.
Setup manual
Returns Manager records withdrawal statements and return requests, follows goods coming back, and keeps refund records with the case. Customers can use their account or the public withdrawal function, while staff handle decisions, receipt and settlement in the back office.
Features
- Delivery evidence and country rules determine the withdrawal deadline; the order page shows the remaining days.
- The public withdrawal function accepts statements without an account. Customers with account access can choose individual products and quantities.
- Customers can send goods themselves or request collection. Staff record pickup offers, agreements and collection details.
- Return cases keep statements, items, tracking, notes, events and credit-slip references together.
- The module generates a model withdrawal form and supplies it with order confirmations when enabled and available.
- Native merchandise returns can remain disabled. When enabled, both forms feed the module's return list; existing native records are imported during reconciliation.
- Eligible self-send returns show a send-back deadline 14 days after the request or withdrawal; an optional email reminds the customer to send the goods back.
Configuration options
These are fresh-install defaults. Use “Configuration” and click “Save” after changes. Country settings belong to “Withdrawal country rules”; pickup availability belongs to “Pickup cost rules”.
| Setting | Default | What it does |
|---|---|---|
| “Enable returns” | “Yes” | Enables customer return pages and links. |
| “Show the countdown” | “Yes” | Shows remaining days on the order panel. |
| “Warn when days left drop below” | 3 | Highlights the order panel at three days remaining or fewer. |
| “Require a reason” | “No” | Requires a valid reason on goodwill requests when enabled; statutory withdrawal keeps reasons optional. |
| “Allow photo uploads” | “Yes” | Allows customer images and PDF documents. |
| “Maximum photos” | 4 | Limits total customer attachments per case. |
| “Maximum photo size (MB)” | 5 | Limits each attachment's size. |
| “Approve withdrawals automatically” | “No” | Automatically approves eligible withdrawal cases when enabled. |
| “Possession states” | Empty | Uses the core delivered-state ID unless you enter other IDs. |
| “Cheapest standard delivery” | Empty | Empty uses paid delivery; enter an amount to cap full-withdrawal delivery estimates. |
| “Return costs disclosed before ordering” | “No” | While off, the estimate puts return postage on the merchant. |
| “Record refunds here” | “Yes” | Allows recording refunds made elsewhere; off uses settlement through the order. |
| “Staff e-mail address” | Empty | Falls back to the shop email. |
| “Reminder to send the goods back” under “Customer mails for” | Selected | Sends one reminder for approved self-send returns awaiting goods, with no dispatch, tracking or receipt recorded and no pending request to keep the goods. |
| “Send-back reminder: days before the deadline” | 3 | Choose 1 to 13 days before the send-back date, 14 days after the request or withdrawal. Due reminders are checked once per shop per day when staff open “Return requests”, up to 50 cases per pass. |
| “Attach to order confirmation” | “Yes” | Supplies the model withdrawal form with confirmation mail. |
| “Online function open since” | Empty | All order dates qualify; setting a date routes older orders to email. |
| “Cancel whole orders before shipping” | Eligible unshipped states | Allows automatic whole-order cancellation; clear the selection to disable it. |
| “Default transit days” | 3 | Estimates return arrival in working days, excluding Saturday and Sunday. |
| “Keep closed returns for (years)” | 6 | Sets the age threshold for anonymising closed cases. |
| “Days” | 14 | Sets the country window; statutory rules cannot fall below 14 days. |
| “Roll over weekends and holidays” | “No” | Moves an ending over weekends and listed holidays, up to 30 days. |
| “Holidays” | Empty | Accepts comma-separated YYYY-MM-DD dates. |
| “Pickup is offered for” | “All products” | Can restrict collection to “Selected products and categories”. |
Customization examples
A longer window. In “Withdrawal country rules”, edit the relevant country rule, set “Days” to 30 and click “Save”. Enable “Roll over weekends and holidays” and enter “Holidays” when you want those dates included in the rollover calculation.
Collection for selected goods. In “Pickup cost rules”, change “Pickup is offered for” to “Selected products and categories” and save your selection. Add cost rules with “Currency” and “Customer charge including tax”. Rule priority chooses the applicable rule for each product; the highest resulting charge applies once per return, regardless of quantity. Collection charges stay separate from the refund.
Refunds handled on the order. Turn “Record refunds here” off. After handling the order, complete “Settled through the order” with the operation, reference and note, then use “Record the settlement and close the case”.
Installation
PrestaShop compatibility: PS 1.6 – 9.x. PHP 7.1 or newer is declared in the module requirements. Installation creates the returns tables, settings, hooks and back-office menu. It seeds a 14-day default country rule.
Check the trader details and preview the model withdrawal form before relying on confirmation mail. PDF generation uses TCPDF; older cores receive the form in the email body instead of an attachment. Customer files need writable private storage. Uninstalling retains the returns tables and settings.
How it works
For physical goods, recorded delivery lots take precedence, followed by delivered shipment records from the shared warehouse integration, then the first history entry in a configured possession state. The order's delivery-date field and carrier record dates do not start the clock. Without usable evidence, the window remains pending and the customer can already withdraw.
For recorded split deliveries, the window stays pending until every line's ordered quantity is covered; the latest recorded delivery then sets the deadline. Any order-level record in the selected delivery evidence covers the whole order, even alongside line records. Country-specific rules take precedence over the shop default.
Submission records the withdrawal statement and attempts an acknowledgement. Approval accepts an empty note. Declining requires “Reason for declining”; “Other” also requires a “Decision note”, limited to 500 characters. Customers see the decline reason and any note.
The refund estimate includes outbound delivery for a full statutory withdrawal, limited to the lower of paid delivery and the configured cap. Partial withdrawals exclude it; faulty, wrong or missing-goods cases include paid delivery in full. An estimate does not transfer money. Recording an existing credit slip links the order's refund record to the case.
Honest limits
- An order-level record in the selected delivery evidence covers the whole order, even alongside line records, so incomplete line quantities do not keep the window pending.
- Remaining days are calculated when the page renders. Order-history links need JavaScript and a recognised order-list layout.
- A pickup request does not book a carrier. Arrange collection through your carrier channel and record it on the case.
- Refund recording does not repay a payment gateway. Complete the actual repayment separately.
- A virtual-product flag alone does not remove withdrawal rights. The module does not collect checkout consent for digital-content exclusions.
- “The goods arrived” records all returned items as received in full; use it only when that is accurate.
Troubleshooting
- Missing order panel: check “Enable returns” and the theme's
displayOrderDetailhook. Use “Perform Integrity Check” in “Integrity” to check registered hooks. - Window never starts: check recorded delivery evidence and “Possession states”; dispatch dates do not establish customer possession.
- Delivery estimate too high: check “Cheapest standard delivery”. Empty uses the delivery amount paid.
- Upload refused: check “Allow photo uploads”, attachment count, size and writable private storage. Supported formats are JPEG, PNG, GIF, WebP and PDF.
- Confirmation missing: inspect the case's mail outcome. Use “Send the confirmation now” for a pending or failed acknowledgement, or “Resend acknowledgement” after an earlier send.
Questions
6
Which date does Returns Manager use to start the return window?
The module uses recorded delivery lots first, then delivered shipment dates from Warehouse Revolution. Otherwise it uses the first order history entry in a configured possession state, by default the core delivered state; the order's delivery date and carrier dates are not used. With no usable date, the window has not started yet and the customer can already withdraw.
How does Returns Manager handle an order delivered in separate parcels?
The window stays pending until every line's ordered quantity is delivered. It then uses the latest recorded delivery date. Any order-level record in that delivery evidence covers the whole order, even alongside line records.
Is a reason required on the Returns Manager form?
No. Require a reason defaults to No. Enabling it requires a valid reason only for goodwill returns; statutory withdrawal always allows no reason.
How does Returns Manager calculate the delivery part of a refund quote?
A full withdrawal includes the lower of paid delivery and Cheapest standard delivery, or paid delivery if that setting is empty. Partial withdrawals exclude outbound delivery; faulty, wrong or missing-goods cases include all paid delivery. A quote does not move money.
Can I use Returns Manager when native PrestaShop merchandise returns are disabled?
Yes. Native merchandise returns can stay disabled. Returns Manager imports existing native requests during reconciliation and mirrors applicable module cases to native merchandise returns.
Does marking a product as virtual automatically remove withdrawal rights?
No. The digital-content exclusion requires a recorded PrestaShop download for the line and the stored consent setting enabled. That setting is off by default and represents consent and acknowledgement of losing withdrawal rights, which the module does not collect at checkout.
Known Issues
No known issues
There are currently no open or resolved issues registered for this module.
Feature Requests
No feature requests for this module yet
Missing something? Suggest it, and follow its progress here.