Repository navigation
v11.0.0
11.0.0 (2026-10-13)
Summary
The SDK now uses API clients that are generated from the MyParcel OpenAPI specifications. This lets us release new API changes to the SDK more frequently and faster. v11 replaces the consignment stack (MyParcelCollection, the consignment models and the delivery options adapters) with these clients and with service classes on top of them.
- Shipments: create, query, delete, labels, print, track & trace, returns and multi-collo use
Shipment,ShipmentCollectionand theShipment*Serviceclasses. - Webhooks and API keys: use
WebhookServiceandApiKeyService. - New: capabilities, carrier contract definitions, generated clients for the Core API, IAM, Order v2 and the e-commerce API, and MyParcel Connect (OAuth with DPoP).
- Value mapping:
ApiMapperServiceconverts carrier, delivery type and package type values between v1 IDs, v2 names and delivery options names. - Removed: drop-off points. Order v1 (fulfilment) and some legacy web services still work. See "What still works" in UPGRADE.md.
- PHP: the requirement does not change (
^7.4 || ^8.0).
To upgrade, start with UPGRADE.md. It shows each v10 call next to its v11 replacement. The PHP SDK v11 guide on the developer portal explains how to use the SDK.
The list below has every change since v10.7.15. The "update API clients" entries bring the latest API changes into the SDK.
⚠ BREAKING CHANGES
-
openapi: loosen and apply consistent validation for enum values, fix required nullables (#623)
-
remove legacy consignment stack and finalize v11 migration paths (#615)
-
remove dropoff point from maintained code (#589)
-
api: add clients for iam- and order (v2) services (#590)
-
capabilities: add capabilities functionality to the SDK (#551)
-
remove legacy consignment stack and finalize v11 migration paths (#615) (8e7bf22)
✨ New Features
- accept request headers on the shipment api factory and order save (#654) (af37a94)
- add carrier contract definitions service (#619) (4d10df2)
- add pickup support to capabilities request (8968981)
- api: add clients for iam- and order (v2) services (#590) (5dcff2c)
- api: add private coreapi client for shipping rules (#617) (48dbee8)
- api: add the ecommerce api factory (#646) (809863c), closes #645
- api: generate the ecommerce api client (#643) (88a1977)
- api: include API updates in releases (a42b978)
- api: update API clients (658d49f)
- api: update API clients (#594) (dc9addb)
- api: update API clients (#597) (d771ebe)
- api: update API clients (#601) (09a6c99)
- api: update API clients (#603) (e73d7a8)
- api: update API clients (#604) (6e570d3)
- api: update API clients (#608) (11d17cc)
- api: update API clients (#610) (82d9ad9)
- api: update API clients (#621) (e944f0f)
- api: update API clients (#622) (ee94860)
- api: update API clients (#633) (cccc3e3)
- api: update API clients (#637) (4e1e58b)
- api: update API clients (#655) (092e81f)
- capabilities from shipments (#584) (3c5a6bc)
- capabilities: add capabilities functionality to the SDK (#551) (41d76e0)
- connect: add connect config, state and storage contract (#639) (9f93d1a)
- connect: add DPoP crypto primitives (#638) (fd4a30f)
- connect: add the connect proof of concept (#649) (7b1843a)
- connect: add the connect service and its transport (#641) (85ccefc)
- connect: sign ecommerce requests with DPoP (#645) (8214bfe)
- derive API mappings from generated definitions (#642) (7573721)
- introduce label- and track & trace services for shipment domain (#588) (22b97fa)
- introduce shipment query, delete, return and multi-collo services (#596) (a0773b3)
- openapi: loosen and apply consistent validation for enum values, fix required nullables (#623) (9d20c57), closes OpenAPITools/openapi-generator#22292 OpenAPITools/openapi-generator#22292
- remove dropoff point from maintained code (#589) (d7d9f0c)
- Shipment-first create flow (generated Core API client) (#587) (4bff98a)
🐛 Bug Fixes
- accept tracktrace sender email values (83dcb2a)
- add Italian carriers to legacy factory (9f2e75d)
- align service calls with regenerated user-agent parameter (35be807)
- api: fix
isBusinessdefaulting totruerathern thannullin capabilities requests (#631) (847d86f) - ci: correct phpunit coverage exclude path to ./src/Client/Generated (1335e9d), closes #590
- conform to json standard in composer (e4faff5)
- consumer portal link mapping (#620) (a38d977)
- harden v11 shipment service wrappers against spec/client drift (#614) (1a43a87)
- openapi: fix monetary amounts not being serialized (#598) (8fe3148)
- override iam principal deserialization (#611) (d190cbf)
- pass tracktrace user agent correctly (bcabf79)
- replace deprecated JSON encoding (#635) (04d81e2)
- v11: security fix tar vulnerability and update @myparcel-dev/semantic-release-config (#600) (a82c1bb)
- v11: Shipment extends correct generated class (5510e6b)
⏪ Reverts
- Revert "ci: block broken release action" (36352e0)