Вышел Модуль интеграций 2.0 для MedusaЧитать анонс
Mondial Relay logo

Mondial Relay

Доставляйте заказы с Mondial Relay

npm install medusa-mondialrelay
Категория
Создано
Регионы
Сервис
Версия
1.0.14
Последнее обновление
11 месяцев назад
Ежемесячные загрузки
Загрузка данных

medusa-mondialrelay

npm version License: MIT

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

  1. Go to Settings → Locations & Shipping
  2. Select your location and add a shipping option
  3. Set:
    • Name:
    • Price Type:
    • Fulfillment Provider:

Home Delivery Option

  1. Create another shipping option
  2. 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

OptionTypeDefaultDescription
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)

WeightPoint RelaisHome 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:

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

CodeCountry
FRFrance
BEBelgium
LULuxembourg
NLNetherlands
ESSpain
PTPortugal
DEGermany
ITItaly
ATAustria

License

MIT © Théo Daguier