PrestaShop

Quickstart — your first parcel in 15 minutes

Enough to ship your first real order today. For deeper configuration, see Looking for… below.

1. Account. Don't have a MyParcel account yet? Create one at myparcel.nl/register.
2. Copy the API key. Log in to backoffice.myparcel.nl → Shop settings → Integration → copy the API key.
3. Install the plugin. Download the release ZIP from github.com/myparcelnl/prestashop/releases. In PrestaShop: Modules → Module manager → Upload a module → drag the ZIP.
4. Connect the plugin. After installation, search for myparcel, click Configure, paste your API key under Change API key and click Save. The status badge at the top should show Connected to MyParcel.
5. First label. Open a paid order, go to the MyParcel block at the bottom, click Export and then Print label. Your PDF rolls out.

Looking for…

1 · Preparing your MyParcel account

Before you start in PrestaShop, take care of four things in your MyParcel backoffice:

1. Billing and return address — Shop settings → General. This appears on every label.
2. Activate carriers — Shop settings → Carriers. Only enabled carriers appear in the plugin later.
3. Generate an API key — Shop settings → Integration.
4. Import order information (optional) — turn on if you want to use order mode.

2 · Installing the plugin

1. Download the release ZIP from github.com/myparcelnl/prestashop/releases.
2. Modules → Module manager → Upload a module → drag the ZIP.
3. Wait for the install to finish, search for myparcel and click Configure.

3 · Connecting the plugin (API key)

Open Modules → Module manager → MyParcelNL → Configure. At the top you'll see three buttons — Change API key, Change webhooks, Debug options — plus the status badge.

The connection bar appears on every plugin page.

1. Click Change API key.
2. Paste the key from your MyParcel backoffice.
3. Click Save — within seconds the status switches to Connected to MyParcel.

4 · Which shop profile are you?

Three typical profiles with recommended settings. Pick one, copy the settings, then fine-tune via 5 · Settings.

Small — 1–10 orders/day, NL only

Medium — 10–50 orders/day, NL + BE

Mailbox-only — coffee, cards, cosmetics

5 · Settings · Orders

The first tab — this is where you set how orders flow through your shop.

General

• Order mode — On: full order (customer data, line items, notes) to MyParcel. Off: only a label. Recommended on, provided Import order information is also on in your MyParcel account.
• Concept shipments — On: shipment stays as concept in MyParcel, you can still adjust. Off: registered with the carrier directly. On during setup, off once everything runs steadily.
• Auto-process — Which PrestaShop order status triggers an export? None / Pending payment / Processing / Shipped. Start with None.
• Send return email — The customer automatically receives a return link.
• Save customer address to address book — Addresses end up in your MyParcel address book.
• Share customer information — Email + phone number to MyParcel. Required for Track & Trace email from MyParcel and for international shipments. Recommended on.

Order status automation

Link MyParcel events to PrestaShop statuses — parcel status stays in sync without manual work.

• Order status when label is created — often Shipment in preparation.
• Order status when label is scanned — often Shipped.
• Order status on delivery — often Delivered.
• Send notification after — from which status a customer email is sent. Set to Shipped so customers receive their Track & Trace immediately.

Track & Trace

• Track & Trace in email — link in PrestaShop order emails. Recommended on.
• Track & Trace in account — also visible in the customer account on the webshop.

Default weights

A safety net for products without a weight in the catalogue.

Order notes

• Barcode in note — Track & Trace barcode added to the order note automatically. Handy for warehouse pickers.
• Barcode in note title — heading above the barcode, e.g. Track & Trace.

6 · Settings · Labels

How shipping labels look and how they are printed.

Description on the label

• Description — free text, e.g. order number or internal reference.

Print behaviour

• Print immediately — label sent straight to your printer group as soon as you export a shipment. Recommended on with a label printer.
• Ask label position — prompt for format, output and position per label. On for flexibility; off for speed with a fixed format.

Defaults

• Label output — Open in new tab (fastest for manual) or Download label.
• Label format — A4 (4 per page) or A6 (label printer).
• Label position(s) on A4 — multi-select Top left/Top right/Bottom left/Bottom right to use sheets fully.

7 · Settings · Customs

Required for shipments outside the EU. Can be overridden per product — see 10 · Product settings.

• Package contents — Goods (default for webshops), Documents, Gift, Commercial sample, Return shipment.
• HS code — harmonised customs code. Look up at tarief.douane.nl. Examples: 6109.10 (T-shirts), 9503.00 (toys), 3304.99 (make-up).
• Country of origin — where the product comes from (not where you store it).

8 · Settings · Checkout

What your customer sees in the checkout — or rather doesn't see.

Delivery options

• Show delivery options — main toggle for the MyParcel checkout widget. Recommended on.
• Show delivery options for backorders — off: for out-of-stock products the plugin hides the delivery options. On if lead times are reliable.
• Price type — Included (in total price) or Separate (shown apart). Included avoids surprises.
• Delivery options title — heading above the MyParcel block. E.g. How would you like your parcel?
• Show tax fields at checkout — VAT fields for business orders.
• Closed days — date picker for holidays. On these days the checkout hides delivery options.

Pickup points

• Default view — List (clearer) or Map (more visual).
• Users can switch between list and map — Recommended on.
• Exclude parcel lockers — hide parcel lockers as a delivery option. On if products are too big.

9 · Settings · Carriers

The biggest tab. Sub-tabs for every carrier your MyParcel account supports: PostNL, DHL Parcel Connect, DHL Europlus, UPS Standard, UPS Express Saver, plus optionally DHL For You / DPD / Bol Parcel Carrier depending on your contract.

Default export settings

The options applied automatically to every new shipment.

• Enable age check (18+) — for alcohol/tobacco/knives.
• Enable signature — for valuable shipments.
• Enable only recipient — no neighbours.
• Enable receipt code — extra certainty.
• Enable larger than 100 × 70 × 58 cm — flag oversized; carrier surcharge possible.
• Enable direct return — automatic return label for clothing/electronics.
• Enable insurance — turns insurance on.

Insurance

• Insure from (€) — threshold amount.
• Insure up to / (NL) / (EU) / (EU + Rest of World) — maximums per region.
• Insure for percentage — e.g. 100% of the order value.

Default export settings for returns

• Default package type — Parcel / Small package / Mailbox parcel / Digital stamp.
• Enable larger than 100 × 70 × 58 cm — for oversized returns.

Delivery options (main toggle)

• Enable delivery options — without this toggle the carrier doesn't appear in the checkout at all.

10 · Product settings

Open a product, go to Modules and click Configure at MyParcelNL. Here you override the global Carriers and Customs settings per product.

MyParcel options

• Package type — Default or force a type for this product.
• in mailbox — how many of this product fit in one mailbox parcel. 5 = five fit. -1 = use default. If a customer orders more than fits, the order automatically becomes a Parcel.

Product delivery options

• Delay shipping — extra working days for made-to-order / dropship products.
• Disable shipping options — hides the entire MyParcel delivery widget when this product is in the cart. For gift cards or digital products.
• Exclude parcel lockers — exclude parcel lockers for this product.

Product customs options

• Country of origin — overrides §7. E.g. globally Netherlands, dropship product China.
• Customs code — product-specific HS code.

Product export options

• Enable age check (18+), Enable insurance, Enable larger than 100 × 70 × 58 cm, Enable only recipient, Enable signature, Enable direct return — force per product.

11 · The order detail page

Open an individual order. Below the standard PrestaShop details you see a MyParcel block with:

• Carrier and package type for this shipment
• Insurance on/off + insured amount
• Selected delivery options (evening delivery, signature, only recipient…)
• Buttons: Export · Print label · View Track & Trace

12 · The checkout experience

The MyParcel checkout widget appears once the delivery address is filled in, as soon as at least one carrier is enabled and PrestaShop carriers are linked to the right shipping zone — see diagnostics.

Above the widget the customer picks a carrier + service (e.g. PostNL — Super fast delivery — €9.95 incl. VAT). Below it, Home or work delivery unfolds with:

• Date carousel with the next available working days.
• Time slot offered (e.g. 10:45–13:15).
• Extra options like Signature (€2.00) or Only recipient with separate surcharges.

Below home delivery sits a second block Pickup at a pickup location, marked Most sustainable. When opened, an interactive map appears with PostNL/DHL points nearby, with opening hours per day. The customer can switch between List and Map (if enabled in §8).

13 · Daily use

Workflow 1 — per order

1. Open the order detail page.
2. Check package type and delivery options in the MyParcel block.
3. Click Export (concept) → check in MyParcel → click Print label.

Workflow 2 — bulk (10+ orders/day)

1. On Orders filter a time window (e.g. Paid today).
2. Per order, choose Export from the action menu.
3. Process shipments in MyParcel (manually or with Auto-process from §5).
4. Print labels in bulk via MyParcel.

Returns

• Enable direct return (§9) or the product override → automatic return label with every shipment.
• Send return email (§5) → customer can request a return label themselves.

14 · Something's not working — diagnostics

Something not behaving as expected? Run through this table top to bottom — three out of four issues are fixed within 5 minutes.

15 · FAQ

Does the plugin work on PrestaShop 9?

Not yet. Version 5.0.x supports PrestaShop 1.7.8 through 8.x. PrestaShop 9 support is on the roadmap; follow issue #415.

Can I use multiple carriers at once?

Yes. Activate per carrier under Carriers → [Carrier name] → Delivery options → Enable delivery options.

How do I change the sender address on the label?

The sender address comes from your MyParcel backoffice (Shop settings → General), not from PrestaShop.

Which statuses for "Auto-process"?

Processing or Pending payment works for most shops. Start at None during setup; activate when the workflow runs steadily.

Customer picks a pickup point — how do I see it on the label?

The pickup point appears as the delivery address on the MyParcel label and in the MyParcel block on the order detail page (§11). In some PrestaShop themes the pickup point doesn't show on the PDF invoice — theme issue, not a plugin bug (issue #390).

I updated the plugin and now something isn't working

Open the plugin again, check the status badge and run through §14. Update issues are often fixed by signing out/in or clearing the browser cache.

Does the plugin cost money?

No. The plugin is free. You only pay for the shipments via your MyParcel rate.

Resources & support

• github.com/myparcelnl/prestashop ↗ — source code, releases, issues.
• github.com/myparcelnl/prestashop/releases ↗ — changelog & ZIP downloads.
• backoffice.myparcel.nl ↗ — account, API key, billing.
• Contact MyParcel support — 023 - 30 30 315 · info@myparcel.nl.

This manual is written for plugin version 5.0.x. In newer versions field names or order may shift slightly; the overall plugin layout stays the same.