Skip to main content

Connect MyParcel to Nevuto

What is MyParcel?

MyParcel is a Netherlands-based multi-carrier shipping aggregator. From a single API you can ship via PostNL, DPD and bpost both within NL/BE and across the EU. Instead of managing a separate contract with each carrier, you connect MyParcel once and print labels from one place.

How Nevuto handles MyParcel

  • The moment you paste your API key and hit Submit, Nevuto auto-creates the webhook subscription inside MyParcel — there's no manual step.
  • The sender address is pulled from your MyParcel account (Nevuto can't override the sender — MyParcel's API doesn't allow it).
  • You print MyParcel labels straight from the order row with Print label; the PDF opens in a new tab.
  • On post-payment accounts the label is generated instantly and billed at the period end. On pre-payment accounts the cost is drawn from your MyParcel wallet.
  • When the carrier scans the parcel, the webhook updates shipping_status and replaces the temporary reference with the real carrier barcode automatically.

1. Prerequisites

  • An active MyParcel account. If you don't have one, sign up at myparcel.nl (NL business registration is required).
  • A sender address saved in your MyParcel account. Account → Settings → Sender address. This address is used for every shipment (Nevuto can't override the sender per order — MyParcel's API doesn't allow it).
  • The sender address must be in NL or BE. MyParcel only ships from the Netherlands and Belgium.
  • Your store currency must be EUR. MyParcel only accepts EUR for customs item values; stores in other currencies show "Not available" in the provider list.
  • A funded wallet (mandatory on pre-payment accounts). Post-payment accounts are billed afterwards.

2. MyParcel API key

  1. Sign in to your MyParcel account.
  2. Open Account → Settings → API.
  3. Click Generate API key to create a new token.
  4. Copy the token — you'll paste it into Nevuto in the next step.

⚠️ Pasting the token as-is is enough — Nevuto handles MyParcel's specific auth format for you.

3. Connecting MyParcel in Nevuto

  1. From the Nevuto admin panel go to Settings → Shipping → Shipping providers.
  2. Pick MyParcel from the list.
  3. Paste the token you copied from MyParcel into the API key field.
  4. Turn on the Enable shipping method toggle.
  5. Click Submit.

When you hit Submit, Nevuto:

  • saves the API key securely,
  • auto-creates the webhook subscription in your MyParcel account — no manual step,
  • starts receiving order status updates from MyParcel.

4. Preferred carrier

After saving, a Settings card opens below the form:

  1. From the Preferred carrier dropdown pick one or several carriers (PostNL / DPD / bpost).
  2. Submit.

Behaviour:

  • When a shipment is created Nevuto uses the first carrier in your preference list (MyParcel accepts only one carrier per shipment).
  • If you select several, the one at the top of your order is used.
  • If you pick none, PostNL is used by default (NL's local carrier with the broadest coverage).

5. Sender address

MyParcel doesn't allow per-order sender overrides — set your sender address inside the MyParcel panel:

  1. MyParcel account → Account → Settings → Sender address.
  2. The address must be in NL or BE (required).
  3. Phone, email and company name should be complete (the carrier won't reject the shipment, but some edge cases trip on missing fields).

Nevuto uses this address on every shipment automatically.

6. Shipping packages

MyParcel asks for package dimensions and weight on every shipment. Nevuto picks them up in this order:

  1. Variant LWH — if you filled it in on the product variant (most accurate).
  2. ShippingPackage reference.
  3. Store default package.
  4. Last resort: dimensions are skipped → MyParcel uses its own estimate (which usually under-prices the parcel).

Steps:

  1. Go to Settings → Shipping → Packages.
  2. Add package → name, type, L/W/H/unit, weight.
  3. Set as default → store-wide fallback.

7. Variant LWH

We recommend entering real dimensions on every variant:

  1. Products → edit product → Variants tab.
  2. Fill in Length / Width / Height / Weight.
  3. Use cm or in for length; g or kg for weight.

8. Customs declaration (international)

For NL/BE → non-EU shipments Nevuto attaches a customs declaration automatically:

  • Items: order lines (description, quantity, weight, country of origin)
  • Item value: line unit price
  • Currency: always sent as EUR

⚠️ MyParcel only accepts EUR on customs declarations. Even if your store currency is USD/GBP the value is sent as EUR (the numeric value is preserved, no FX conversion is applied). Be careful around exemption thresholds like €22 for low-value items.

HS code: not stored per product in Nevuto → sent empty. You can add it manually inside the MyParcel panel.

9. Shipping an order

Once the customer has paid, the order shows up in your admin panel with the "Mark as shipped" button.

  1. Open the order detail page.
  2. Click Mark as shipped.
  3. In the modal pick MyParcel as the provider and Submit.
  4. Within a few seconds a temporary tracking reference and a "Print label" button appear on the order row. The shipment is created in MyParcel as "concept" (draft) status first.
  5. Click Print label:
    • Post-payment account: the PDF opens instantly and the cost is billed at the period end.
    • Pre-payment account: the wallet is charged and the PDF opens. If the wallet is empty you'll see "Label not available yet — wallet may need funding". Top up the wallet and click the button again.
  6. Print the label, stick it on the parcel and hand it to the carrier you selected.

💡 Once the label is printed the temporary tracking reference is replaced with the real carrier barcode automatically. Customers can also follow the parcel from the tracking link.

10. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← concept status, shipment_id is the temporary tracking
    │
    ▼   MyParcel generates the label (status ≥2)
[tracking_number = barcode]        ← webhook delivers the real carrier barcode, tracking number is updated
    │
    ▼   Carrier scans the parcel (status ≥3)
[shipping_status: SHIPPED]         ← webhook
    │
    ▼   Delivered to the customer (status ≥7)
[shipping_status: DELIVERED]       ← webhook

MyParcel status mapping (Nevuto):

  • Draft / registered → Processing (no change)
  • Handed to carrier, sorting, distribution, customs → Shipped
  • Delivered, ready for pickup, picked up, return steps → Delivered
  • Printed, cancelled, etc. → ignored

Nevuto sets up the webhook subscription for you — no manual intervention required.

11. Label download

When you click "Print label" Nevuto downloads the label from MyParcel and opens it in a new tab:

  • Post-payment account: the PDF opens instantly.
  • Pre-payment account (empty wallet): you'll see a "Label not available yet — your shipping wallet may need funding" notification.

In that case fund the wallet inside your MyParcel account and try again.

12. Test mode

MyParcel doesn't offer a real sandbox/test environment. Strategies you can use:

  • Stay at concept stage: the shipment is created but no label is printed → zero cost. You can then delete the shipment from the panel.
  • Low-cost real test: a €4-5 PostNL Pakketten Buitenland shipment or a domestic test.

13. Common issues

A. "Label not available yet — wallet may need funding"

  • Your account is on the pre-payment model and the wallet is empty. Sign in to MyParcel, fund the wallet and click "Print label" again.

B. The tracking number changed

  • Expected behaviour. Nevuto shows a temporary identifier first; once the carrier prints the label the real tracking barcode is updated automatically.

C. The provider doesn't show in the list

  • Your store currency isn't EUR → "Not available in your store currency. Supports: EUR".
  • Your store address country isn't NL/BE → "Doesn't ship from your shop location".
  • Adjust Settings → General → Currency or Settings → Locations → Country to a supported value.

D. Webhook isn't arriving / statuses aren't updating

  • Check Webhook subscriptions inside your MyParcel account. Inside Nevuto, open the MyParcel settings and click Submit again — the webhook subscription is recreated.

14. Next steps

  • Watch production orders during the first week.
  • Add HS codes inside the MyParcel panel for non-EU shipments.
  • Add a margin to your shipping rates so you don't absorb carrier surcharges.

Help

Related articles