PHPackages shubo/module-shipping-core - 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. [Framework](/categories/framework) 4. / 5. shubo/module-shipping-core ActiveMagento2-module[Framework](/categories/framework) shubo/module-shipping-core ========================== Carrier-agnostic shipping orchestration framework for Magento 2 marketplaces and multi-vendor stores v0.12.0(2mo ago)013911Apache-2.0PHPPHP >=8.1CI passing Since Apr 26Pushed 2mo agoCompare [ Source](https://github.com/nshubitidze/module-shipping-core)[ Packagist](https://packagist.org/packages/shubo/module-shipping-core)[ Docs](https://github.com/nshubitidze/module-shipping-core)[ RSS](/packages/shubo-module-shipping-core/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (11)Versions (6)Used By (1) Shubo\_ShippingCore =================== [](#shubo_shippingcore) [![CI](https://github.com/nshubitidze/module-shipping-core/actions/workflows/ci.yml/badge.svg)](https://github.com/nshubitidze/module-shipping-core/actions/workflows/ci.yml)[![Packagist](https://camo.githubusercontent.com/d7c0a6612ff437047d59b119630441c5bc5eff8948513f932c6758ef165fcd49/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d736875626f2532466d6f64756c652d2d7368697070696e672d2d636f72652d6f72616e67652e737667)](https://packagist.org/packages/shubo/module-shipping-core)[![License: Apache 2.0](https://camo.githubusercontent.com/a549a7a30bacba7bfceebdc207a8e86c3f2c02995a2527640dca30048fd2b64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d417061636865253230322e302d626c75652e737667)](./LICENSE) Carrier-agnostic shipping orchestration framework for Magento 2 marketplaces and multi-vendor stores. `Shubo_ShippingCore` is the foundation module that provides common abstractions — a pluggable carrier-adapter interface, shipment orchestration, resilience primitives (circuit breaker, retry, rate limiting, idempotency), a polling scheduler for carriers without webhooks, a webhook dispatcher for carriers that have them, and an invoice reconciliation framework. Per-carrier adapters (e.g. `Shubo_ShippingTrackings`, `Shubo_ShippingWoltDrive`, `Shubo_ShippingDelivo`) are shipped as separate modules that plug into Core. Development ----------- [](#development) The module ships a standalone composer setup so the three quality gates can run outside of a full Magento install. From a clean checkout: ``` composer install composer phpunit # or vendor/bin/phpunit composer phpstan # or vendor/bin/phpstan analyse composer phpcs # or vendor/bin/phpcs ``` `composer install` pulls `magento/framework` from the open-source [Mage-OS mirror](https://mirror.mage-os.org/) — no Adobe Commerce credentials required. PHP is pinned to `8.4.0` via `config.platform.php`to match the runtime; the CI matrix exercises 8.1 through 8.4. Status ------ [](#status) **Early development.** APIs are not yet stable. This README will be fleshed out in the v1.0.0 release. See `docs/design/shipping-core.md` in the downstream integration project for the current design document. Installation ------------ [](#installation) ``` composer require shubo/module-shipping-core bin/magento module:enable Shubo_ShippingCore bin/magento setup:upgrade bin/magento setup:di:compile ``` Requirements ------------ [](#requirements) - Magento 2.4.8 or later - PHP 8.1 or later - `phpoffice/phpspreadsheet` ^2.0 or ^3.0 (for carrier invoice import) Architecture overview --------------------- [](#architecture-overview) ``` ┌────────────────────────────────────┐ │ Shubo_ShippingCore │ │ │ │ CarrierRegistry │ │ ShipmentOrchestrator │ │ TrackingPoller WebhookDispatcher│ │ RateQuoteService ReconciliationSvc│ │ CircuitBreaker RetryPolicy │ │ RateLimiter IdempotencyStore│ └───────┬────────────────────────────┘ │ CarrierGatewayInterface │ CarrierCapabilitiesInterface │ WebhookHandlerInterface │ InvoiceImporterInterface │ ┌────────────┼────────────┬──────────────┐ ▼ ▼ ▼ ▼ TrackingsAdapter WoltDrive DelivoAdapter (your adapter) ``` Writing a carrier adapter ------------------------- [](#writing-a-carrier-adapter) A carrier adapter module implements: 1. `CarrierGatewayInterface` — `quote`, `createShipment`, `cancelShipment`, `getShipmentStatus`, `fetchLabel`, `listCities`, `listPudos` 2. `CarrierCapabilitiesInterface` — declares what the carrier supports (webhooks, sandbox, COD reconciliation API, PUDO, express, etc.) 3. Optional `WebhookHandlerInterface` — if the carrier pushes status updates 4. Optional `InvoiceImporterInterface` — if the carrier settles fees/COD via downloadable invoices A full adapter-authoring guide ships with v1.0.0. Available adapters ------------------ [](#available-adapters) ModuleStatusScopeLink[`shubo/module-shipping-shippo`](https://github.com/nshubitidze/module-shipping-shippo)**Live (first real adapter)**International — aggregates USPS, UPS, FedEx, DHL, and regional carriers through the Shippo API. Rate quote, label purchase, webhook signature verification, poller fallback. Test-mode is the default.[repo](https://github.com/nshubitidze/module-shipping-shippo)`shubo/module-shipping-wolt-drive`DeferredTbilisi same-day + on-demand delivery via Wolt Drive. Blocked on Wolt sales-led credential signup (3–10 days); no shipping-core changes needed when the adapter lands.—`shubo/module-shipping-trackings`PlannedGeorgia-domestic courier aggregator; poll-only (no webhooks).—License ------- [](#license) Apache-2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE). Author ------ [](#author) [Nikoloz Shubitidze](https://github.com/nshubitidze) (Shubo) ### Health Score 37 — LowBetter than 81% of packages Maintenance83 Actively maintained with recent releases Popularity12 Limited adoption so far Community13 Small or concentrated contributor base Maturity36 Early-stage or recently created project Bus Factor1 Top contributor holds 73.5% 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 ~1 days Total 5 Last Release 85d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/25e03e1c788be1ce1b2067241fb98d4b40e916fb9e9ea61d257a06ce871db916?d=identicon)[shubodev](/maintainers/shubodev) --- Top Contributors [![GS-Workspace](https://avatars.githubusercontent.com/u/162041121?v=4)](https://github.com/GS-Workspace "GS-Workspace (25 commits)")[![fl0px](https://avatars.githubusercontent.com/u/87697481?v=4)](https://github.com/fl0px "fl0px (8 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (1 commits)") --- Tags georgiashippingmagento2logisticsmarketplacecarriercod ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/shubo-module-shipping-core/health.svg) ``` [![Health](https://phpackages.com/badges/shubo-module-shipping-core/health.svg)](https://phpackages.com/packages/shubo-module-shipping-core) ``` ### Alternatives [mollie/magento2 Mollie Payment Module for Magento 2 1131.9M16](/packages/mollie-magento2)[run-as-root/magento2-prometheus-exporter Magento2 Prometheus Exporter 68357.9k](/packages/run-as-root-magento2-prometheus-exporter)[buckaroo/magento2 Buckaroo Magento 2 extension 32420.3k8](/packages/buckaroo-magento2)[loki/magento2-components Core module for defining Alpine.js components with advanced AJAX features 1011.8k26](/packages/loki-magento2-components)[opengento/module-category-import-export This module add the capability to import and export the categories from the back-office. 1310.9k2](/packages/opengento-module-category-import-export) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)