Mondial Relay
Доставляйте заказы с Mondial Relay
medusa-mondialrelay
A Medusa v2 fulfillment provider plugin for Mondial Relay shipping services. Supports both Point Relais (pickup point) and Home Delivery options with real-time pricing via @frontboi/mondial-relay.
Features
- 🏪 Point Relais - Pickup point delivery with interactive selector
- 🏠 Home Delivery - Door-to-door delivery (+3€ surcharge)
- 💰 Real Pricing - Uses official Mondial Relay pricing via
- 🌍 Multi-country - FR, BE, LU, NL, ES, PT, DE, IT, AT
- 🏷️ Label Generation - PDF shipping label creation
- 📦 Shipment Tracking - Tracking number generation
- 🖨️ Admin Widget - Print labels directly from order details
Requirements
- Medusa v2.0+
- Node.js 18+
- Mondial Relay API credentials (contact Mondial Relay for API access)
Installation
Configuration
1. Add the plugin to medusa-config.ts
Important: You need to register the plugin in both (for admin extensions) and (for the fulfillment provider).
2. Environment Variables
Create or update your file:
3. Create Shipping Options
In the Medusa Admin, create shipping options:
Point Relais Option
- Go to Settings → Locations & Shipping
- Select your location and add a shipping option
- Set:
- Name:
- Price Type:
- Fulfillment Provider:
Home Delivery Option
- Create another shipping option
- Set:
- Name:
- Price Type:
- Fulfillment Provider:
Note: The plugin automatically applies +3€ surcharge for home delivery options.
Free Shipping
Configuration
You can configure a cart total threshold above which shipping becomes free:
Options
| Option | Type | Default | Description |
|---|---|---|---|
| Cart total (in euros) above which shipping is free | |||
| Which delivery types get free shipping |
Free Shipping Modes
- (default): Free shipping applies to both Point Relais and Home Delivery
- : Free shipping only for Point Relais (Home Delivery still charged)
- : Free shipping only for Home Delivery (Point Relais still charged)
Examples
Storefront Integration
Pass the cart total when setting the shipping method:
When and the delivery type matches , the shipping cost will be 0€.
Pricing
Real-time Pricing via @frontboi/mondial-relay
The plugin uses for official Mondial Relay pricing based on:
- Package weight (250g to 30kg)
- Destination country (FR, BE, LU, NL, ES, PT, DE, IT, AT)
Home Delivery Surcharge
Home delivery options automatically add a +3€ surcharge to the base Point Relais price.
Example Prices (France)
| Weight | Point Relais | Home Delivery |
|---|---|---|
| 500g | ~3.99€ | ~6.99€ |
| 1kg | ~4.49€ | ~7.49€ |
| 2kg | ~5.49€ | ~8.49€ |
| 5kg | ~7.99€ | ~10.99€ |
Prices are fetched in real-time from Mondial Relay's official pricing grid.
Storefront Integration
Point Relais Selector
For Point Relais delivery, integrate a pickup point selector. The plugin expects:
Recommended: @frontboi/mondial-relay
Home Delivery
Admin Features
Label Printing Widget
The plugin adds a widget to the order details page for:
- ✅ Tracking number display
- ✅ Pickup point info (if applicable)
- 🖨️ "Print Label" button for PDF download
Supported Countries
| Code | Country |
|---|---|
| FR | France |
| BE | Belgium |
| LU | Luxembourg |
| NL | Netherlands |
| ES | Spain |
| PT | Portugal |
| DE | Germany |
| IT | Italy |
| AT | Austria |
License
MIT © Théo Daguier
Links
- � NPM Package
- � GitHub Repository
- 📧 Contact: theo.daguier@icloud.com

