PHPackages                             ecommercegeeks/myparcel-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. [Utility & Helpers](/categories/utility)
4. /
5. ecommercegeeks/myparcel-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

ecommercegeeks/myparcel-sdk
===========================

MyParcel SDK

1.4.0(1mo ago)13.3k↓66.7%LGPL-3.0-or-laterPHPCI failing

Since Dec 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/ecommercegeeks/myparcelnl-sdk)[ Packagist](https://packagist.org/packages/ecommercegeeks/myparcel-sdk)[ RSS](/packages/ecommercegeeks-myparcel-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (22)Used By (0)

A Saloon based PHP SDK for MyParcel
===================================

[](#a-saloon-based-php-sdk-for-myparcel)

The official SDK for MyParcel contains many smart features that in practice get in the way more than help. So we developed this dumb SDK.

This SDK stays close to the [API documentation](https://developer.myparcel.nl/api-reference/). DTOs and Enums are used where it makes sense. This SDK is light on documentation, because autocomplete will show you the way.

Usage
-----

[](#usage)

Installation

```
composer require ecommercegeeks/myparcel-sdk
```

### Creating a label

[](#creating-a-label)

```
// Creating a connector doesn't make a network request yet, so can be initialized safely at application init.
$connector = new Connector($apiKey);

// Fill the DTOs
$shipment = new Shipment(recipient: new Recipient(...), ...);

// Create the request
$shipmentRequest = new AddShipments([$shipment]);

// Send the request
$response = $connector->send($shipmentRequest);

// Convert the request to an array of Shipment ids
$ids = $response->dtoOrFail();
```

For more usage examples, have a look at the tests in the `tests/Feature` folder.

Be careful
----------

[](#be-careful)

This is a dumb SDK, so this SDK doesn't check correctness of the data. You have to take into account that the MyParcel service is also lenient on data errors. You can easily create a label for a non-existent address. When you delete non-existing shipments, MyParcel doesn't respond with an error.

Implemented requests
--------------------

[](#implemented-requests)

RequestEndpointdto()DescriptionAddShipmentPOST /shipmentsGetShipmentsGET /shipmentsUpdateShipmentPATCH /shipmentsDeleteShipmentDELETE /shipmentsGetLocationsGET /locationsarray of locationsEndpoint is limited to NLMatchLocationsGET /locations/match-GetShipmentLabelsGET /shipment\_labelsTesting
-------

[](#testing)

Testing is performed against the actual API. Copy `test.example.env` to `test.env` and enter your API key. Then execute the test suite by running `./vendor/bin/pest`. Because the tests are executed against the actual API, no CI/CD is in place.

### Feature tests

[](#feature-tests)

The feature tests in the `tests/Feature` folder go through a cycle where a shipment is created and then either updated or deleted. All feature tests either delete or hide the shipments after the cycle.

Contributing
------------

[](#contributing)

When you find an endpoint which is not implemented yet you are invited to add the required classes to this SDK through a pull request. Take the following in order:

### Request classes

[](#request-classes)

All DTO arguments are provided through the constructor. We use one class for both the request and the response, when arguments are not required for a request, or not always present in responses, these arguments are default null so should be last in the argument list of the constructor.

### Tests

[](#tests)

Because tests are performed against the production API, make sure that tests delete or hide all created shipments.

When you are working in the test suite, you can display the sent request and response by setting `$this->debug = true`within the test.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance98

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 52.2% 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

Every ~45 days

Recently: every ~58 days

Total

11

Last Release

44d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5a90ad6ae14b191f15986ccfe84996d1de1b6fa6a328589c15cc2f2f37ae0fa2?d=identicon)[kenaths](/maintainers/kenaths)

---

Top Contributors

[![kenaths](https://avatars.githubusercontent.com/u/21273080?v=4)](https://github.com/kenaths "kenaths (12 commits)")[![mdejong10](https://avatars.githubusercontent.com/u/22601776?v=4)](https://github.com/mdejong10 "mdejong10 (7 commits)")[![iamniels](https://avatars.githubusercontent.com/u/717126?v=4)](https://github.com/iamniels "iamniels (4 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/ecommercegeeks-myparcel-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ecommercegeeks-myparcel-sdk/health.svg)](https://phpackages.com/packages/ecommercegeeks-myparcel-sdk)
```

###  Alternatives

[crescat-io/saloon-sdk-generator

Simplified SDK Scaffolding for Saloon

13130.9k7](/packages/crescat-io-saloon-sdk-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)