PHPackages smart-dato/mondial-relay-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. smart-dato/mondial-relay-sdk ActiveLibrary smart-dato/mondial-relay-sdk ============================ Laravel SDK for Mondial Relay: pickup point search and tracking (API V1) 0.0.1(today)010↑2900%MITPHPPHP ^8.4CI passing Since Jul 23Pushed todayCompare [ Source](https://github.com/smart-dato/mondial-relay-sdk)[ Packagist](https://packagist.org/packages/smart-dato/mondial-relay-sdk)[ Docs](https://github.com/smart-dato/mondial-relay-sdk)[ GitHub Sponsors](https://github.com/SmartDato)[ RSS](/packages/smart-dato-mondial-relay-sdk/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (14)Versions (2)Used By (0) Mondial Relay Shipping SDK for Laravel ====================================== [](#mondial-relay-shipping-sdk-for-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/4fa977ac160b8dd713d6666c4142ce572d2c5d1f85e6aafe8ad1063adf7b4b52/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736d6172742d6461746f2f6d6f6e6469616c2d72656c61792d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/smart-dato/mondial-relay-sdk)[![GitHub Tests Action Status](https://github.com/smart-dato/mondial-relay-sdk/actions/workflows/run-tests.yml/badge.svg)](https://github.com/smart-dato/mondial-relay-sdk/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://github.com/smart-dato/mondial-relay-sdk/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/smart-dato/mondial-relay-sdk/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/bedeee3ec7eded5d2f51822c28e15197727a1e5429afbc2b45c25c0f5be713c3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736d6172742d6461746f2f6d6f6e6469616c2d72656c61792d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/smart-dato/mondial-relay-sdk) A Laravel SDK for the [Mondial Relay](https://www.mondialrelay.fr) shipping APIs. Currently implemented — **API V1 (SOAP)**: - Pickup point search (`WSI4_PointRelais_Recherche`) - Parcel tracking (`WSI2_TracingColisDetaille`) Planned — **API V2 (Dual Carrier)**: shipment and label creation. Installation ------------ [](#installation) Install the package via composer: ``` composer require smart-dato/mondial-relay-sdk ``` Optionally publish the config file: ``` php artisan vendor:publish --tag="mondial-relay-sdk-config" ``` Configure your credentials in `.env`: ``` MONDIAL_RELAY_ENSEIGNE=M1ITTEST MONDIAL_RELAY_PRIVATE_KEY=your-private-key ``` Usage ----- [](#usage) ### Search pickup points [](#search-pickup-points) ``` use SmartDato\MondialRelay\Facades\MondialRelay; use SmartDato\MondialRelay\V1\Queries\PickupPointSearchQuery; $pickupPoints = MondialRelay::searchPickupPoints(new PickupPointSearchQuery( country: 'FR', postCode: '59000', maxResults: 10, )); foreach ($pickupPoints as $pickupPoint) { $pickupPoint->number; // "005720" $pickupPoint->name; // "CARREFOUR EXPRESS" $pickupPoint->street; // "102 RUE NATIONALE" $pickupPoint->latitude; // 50.62925 $pickupPoint->openingHours['monday']->ranges; // ["08:00-12:30", "14:00-19:00"] $pickupPoint->openingHours['sunday']->isClosed(); // true $pickupPoint->distanceInMeters; // 250 } ``` Searches can also be filtered by `city`, `latitude`/`longitude`, `weightInGrams` and `searchRadiusInKm`. ### Get a single pickup point [](#get-a-single-pickup-point) ``` $pickupPoint = MondialRelay::pickupPoint('FR', '005720'); ``` ### Track a parcel [](#track-a-parcel) ``` $tracking = MondialRelay::trackParcel('12345678'); $tracking->status; // TrackingStatus::Delivered $tracking->isDelivered(); // true $tracking->statusLabel; // "Votre colis a été livré" foreach ($tracking->events as $event) { $event->label; // "Colis enregistré" $event->happenedAt; // CarbonImmutable instance $event->location; // "LILLE" } ``` The tracking language defaults to `mondial-relay-sdk.default_language` (`FR`); pass a second argument to override it: `trackParcel('12345678', 'EN')`. ### Multiple accounts [](#multiple-accounts) The facade uses the account configured in `.env`. To use other accounts on the fly, construct the SDK with your own client: ``` use SmartDato\MondialRelay\MondialRelay; use SmartDato\MondialRelay\V1\Client; $sdk = new MondialRelay(new Client( enseigne: 'OTHERACC', privateKey: 'other-private-key', )); $sdk->searchPickupPoints(/* ... */); ``` The client defaults to the production API URL; pass a third `url` argument to override it. ### Raw request and response [](#raw-request-and-response) The raw SOAP exchange is always available — also when a request fails: ``` use SmartDato\MondialRelay\Exceptions\MondialRelayException; try { $pickupPoints = MondialRelay::searchPickupPoints($query); } catch (MondialRelayException $exception) { $exception->rawRequest; // raw SOAP envelope that was sent $exception->rawResponse; // raw response body (null if the connection failed) } // After any call (successful or not): MondialRelay::lastRawRequest(); MondialRelay::lastRawResponse(); ``` ### Error handling [](#error-handling) All exceptions extend `SmartDato\MondialRelay\Exceptions\MondialRelayException`: - `MondialRelayConnectionException` — network errors, HTTP errors, unparseable responses - `MondialRelayWebServiceException` — error status codes returned by the API, with the code available as `$exception->statusCode` Testing ------- [](#testing) ``` composer test ``` Live integration tests against the Mondial Relay test environment are skipped by default. Run them with: ``` MONDIAL_RELAY_LIVE=1 vendor/bin/pest --group=integration ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - [SmartDato](https://github.com/smart-dato) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 40 — FairBetter than 86% of packages Maintenance100 Actively maintained with recent releases Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c3006db55caec62526937fa2d941da32fc5e69e2ca86a52e87c8046da5958d82?d=identicon)[smart-dato](/maintainers/smart-dato) --- Top Contributors [![michael-tscholl](https://avatars.githubusercontent.com/u/178569346?v=4)](https://github.com/michael-tscholl "michael-tscholl (4 commits)") --- Tags laravelSmartDatomondial-relay-sdk ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/smart-dato-mondial-relay-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/smart-dato-mondial-relay-sdk/health.svg)](https://phpackages.com/packages/smart-dato-mondial-relay-sdk) ``` ### Alternatives [spatie/laravel-health Monitor the health of a Laravel application 87912.0M177](/packages/spatie-laravel-health)[spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M48](/packages/spatie-laravel-pdf)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.6k](/packages/simplestats-io-laravel-client)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.8k](/packages/rawilk-profile-filament-plugin)[codebar-ag/laravel-docuware DocuWare integration with Laravel 1123.7k](/packages/codebar-ag-laravel-docuware) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)